_stage –舞台上精灵动画的 C 级助手

_stage模块包含用于加速 `stage 库的本机代码 <https://github.com/python-ugame/circuitpython-stage>`_.

在这些板上可用
  • Adafruit 边缘徽章
  • Adafruit PyGamer
  • Adafruit Pybadge
  • Electronut 实验室 Blip
  • MEOWBIT
  • PewPew M4
  • TinyS2
  • uGame10

_stage.render(x0: int, y0: int, x1: int, y1: int, layers: List[Layer], buffer: _typing.WriteableBuffer, display: displayio.Display, scale: int, background: int)None

渲染并将屏幕片段发送到显示器。

参数
  • x0 (int) – 片段的左边缘。

  • y0 (int) – 片段的顶部边缘。

  • x1 (int) – 片段的右边缘。

  • y1 (int) – 片段的底部边缘

  • layers (list[Layer]) – Layer 对象列表。

  • buffer (WriteableBuffer) – 用于渲染的缓冲区。

  • display (Display) – 要使用的显示。

  • scale (int) – 图像应该放大多少次。

  • background (int) – 当什么都没有时显示什么颜色。

除了基本的溢出检查之外,也没有健全性检查。调用者负责使传递的参数有效。

该函数供stage 库内部使用,所有必要的检查都在那里执行。

class _stage.Layer(width: int, height: int, graphic: _typing.ReadableBuffer, palette: _typing.ReadableBuffer, grid: _typing.ReadableBuffer)

保留有关单层图形的信息

以适合函数快速渲染的格式保存有关图形层(a Grid 或 a Sprite)的内部信息render()

参数
  • width (int) – 网格的宽度(以平铺为单位),或 1 表示精灵。

  • height (int) – 网格的高度(以瓷砖为单位),或 1 表示精灵。

  • graphic (ReadableBuffer) – 图块的图形数据。

  • palette (ReadableBuffer) – 要使用的调色板。

  • grid (ReadableBuffer) – 网格地图的内容。

此类旨在供stage库内部使用,不应单独使用。

move(self, x: int, y: int)None

将图层的偏移设置为指定的值。

frame(self, frame: int, rotation: int)None

设置精灵的动画帧,并可选择旋转其图形。

class _stage.Text(width: int, height: int, font: _typing.ReadableBuffer, palette: _typing.ReadableBuffer, chars: _typing.ReadableBuffer)

保留有关单个文本网格的信息

将有关文本网格的内部信息保留为适合使用该render() 函数进行快速渲染的格式。

参数
  • width (int) – 网格的宽度(以平铺为单位),或 1 表示精灵。

  • height (int) – 网格的高度(以瓷砖为单位),或 1 表示精灵。

  • font (ReadableBuffer) – 字符的字体数据。

  • palette (ReadableBuffer) – 要使用的调色板。

  • chars (ReadableBuffer) – 字符网格的内容。

此类旨在供stage库内部使用,不应单独使用。

move(self, x: int, y: int)None

将文本的偏移量设置为指定的值。