普贤教程 › 包参考

gfx 包

纯语言 2D 游戏内圈（M61-S2，第 5 个 stdlib）

画布 = [w, h, pixels]；pixels = list[int]，每像素 0xRRGGBB（0 = 黑）

项	值
包名	`gfx`
版本	`0.1.0`
入口	`gfx.px`
分类	`图形与媒体`
文件数 / 行数	`1 / 162`

安装与引入

bash

pxpkg init          # 首次
pxpkg add gfx@0.1.0
pxpkg install

import gfx

所属分类教程：图形与媒体

公开接口

函数	参数
`canvas_create`	`w, h`
`canvas_w`	`c`
`canvas_h`	`c`
`canvas_pixels`	`c`
`set_px`	`c, x, y, color`
`get_px`	`c, x, y`
`line`	`c, x0, y0, x1, y1, color`
`rect`	`c, x, y, w, h, color`
`fill_rect`	`c, x, y, w, h, color`
`circle`	`c, cx, cy, r, color`
`fill_circle`	`c, cx, cy, r, color`
`blit`	`c, dx, dy, spr`
`text_size`	`s`
`text`	`c, x, y, s, color`

包内说明（源码头注释）

text

============================================================
普贤标准库：std.gfx —— 纯语言 2D 游戏内圈（M61-S2，第 5 个 stdlib）
用法：import std.gfx
画布 = [w, h, pixels]；pixels = list[int]，每像素 0xRRGGBB（0 = 黑）
原语：canvas_create/canvas_w/canvas_h/canvas_pixels/set_px/get_px/
line/rect/fill_rect/circle/fill_circle/blit/text/text_size
字形：内置 5x7 位图（0-9 A-Z . - 空格 ?；compact 编码 bit(x+5y)，x=0 最左）
小写字母自动转大写；未知字符 → '?'
依赖 builtin：bytes/bytes_get/bytes_len/sqrt/int/len —— 零新 C、零 FFI
精灵 = [sw, sh, colors]，colors 中 0 = 透明（blit 跳过）
性能注记：set_px 逐点带边界裁剪（正确优先）；密集像素直写 canvas_pixels
============================================================