API 参考
正在准备搜索索引…

ImGui.ImFontAtlas_AddCustomRectRegular

  • 在字体图集中预留自定义矩形。

    参数

    self

    此方法操作的 ImFontAtlas 句柄。

    width
    number

    自定义图集矩形的像素宽度。

    height
    number

    自定义图集矩形的像素高度。

    返回值

    number

    供 ImFontAtlas_GetCustomRectByIndex(self, index) 使用的零基自定义矩形索引;图集构建后才能获得打包坐标。

    可请求将任意矩形打包进图集,供自定义用途。

    • 调用 ImFontAtlas_Build(self) 后可查询矩形位置并绘制自己的像素。

    • 对于彩色输出,原生后端可能参考图集的 TexPixelsUseColors 标志来选择纹理格式。JS 图集视图未暴露此标志。

    • 也可将矩形映射为字体字形(指定字体 + Unicode 码点),从而绘制自定义彩色图标等,并像普通字形一样使用。

    • 使用彩色图标的详情见 docs/FONTS.md。

    • 注意:此 API 未来可能重新设计,以支持多显示器不同 DPI 设置。

    源码与继承

Icons made by Lorc, Delapouite & Skoll · game-icons.net · CC BY 3.0