VGA Font Editor

VGA字体编辑器

这是VGA ROM字体的跨平台编辑器和库。这具有用于使用加载字体渲染文本的代码。源代码用QB64-PE编写，并在本地工作而无需使用任何第三方库。

特征

• 对第三方库不依赖
• 一切都是静态链接的（没有共享库依赖关系）
• 易于插件 - ＆ - 播放针对演示和游戏优化的API
• 跨平台（在Windows，Linux和MacOS上工作）
• 编辑器支持使用鼠标选择和编辑

用法

• 克隆存储库到您选择的目录
• 开放终端并使用适当的OS命令更改为目录
• 运行git submodule update --init --recursive以初始化，获取和结帐git子模块
• 在QB64-PE IDE中打开vgafonteditor.bas ，然后按F5进行编译和运行
• 要在项目中使用库，将工具箱64 repositiory添加为git子模块

API

 ' For rendering
FUNCTION PSF1_LoadFontFromMemory% % (buffer AS STRING , psf AS PSF1Type)
FUNCTION PSF1_LoadFontFromFile% % (fileName AS STRING , psf AS PSF1Type)
SUB PSF1_SetCurrentFont (psf AS PSF1Type)
FUNCTION PSF1_GetFontWidth ~%%
FUNCTION PSF1_GetFontHeight ~%%
FUNCTION PSF1_GetDrawStringWidth& (text AS STRING )
SUB PSF1_DrawCharacter (cp AS _UNSIGNED _BYTE, x AS LONG , y AS LONG )
SUB PSF1_DrawString (text AS STRING , x AS LONG , y AS LONG )

' Used by the editor
SUB PSF1_SetFontHeight (h AS _UNSIGNED _BYTE)
FUNCTION PSF1_GetFont$
FUNCTION PSF1_SetFont% % (buffer AS STRING )
FUNCTION PSF1_GetGlyphBitmap$ (cp AS _UNSIGNED _BYTE)
SUB PSF1_SetGlyphBitmap (cp AS _UNSIGNED _BYTE, bmp AS STRING )
FUNCTION PSF1_GetGlyphPixel% % (cp AS _UNSIGNED _BYTE, x AS LONG , y AS LONG )
SUB PSF1_SetGlyphPixel (cp AS _UNSIGNED _BYTE, x AS LONG , y AS LONG , b AS _BYTE)
SUB PSF1_SetGlyphDefaultBitmap (cp AS _UNSIGNED _BYTE)
FUNCTION PSF1_SaveFont% % (fileName AS STRING ) 

常问问题

我该怎么办？

• 您想要的任何东西！您可以将文件格式或Sourcecode用于嵌入式，复古，游戏项目等。这不需要您拥有DOS或任何旧的PC硬件。这里的所有代码都是为现代硬件编写的。字体文件格式非常简单，文本渲染代码简单明了。几乎没有努力，渲染代码可以移植到您喜欢的编程语言和库中。 fonts目录中有许多示例字体。老实说，我不知道其中的原始象牙，强烈建议您使用此工具为您的项目创建自己的字体。

什么是VGA ROM字体？

• 这些是嵌入VGA ROM BIOS中的字体。要了解有关VGA ROM字体的更多信息，请参见：
  • VGA字体
  • VGA ROM字体
  • 罗姆方

角色如何存储在内存中？

• 这很简单，0编码背景，1编码前景颜色。 VGA字体总是宽8位，因此每个字节完全包含一行。对于典型的8x16字体中的字母“ a”，它将（以二进制）：

   00000000b  byte  0
  00000000b  byte  1
  00000000b  byte  2
  00010000b  byte  3
  00111000b  byte  4
  01101100b  byte  5
  11000110b  byte  6
  11000110b  byte  7
  11111110b  byte  8
  11000110b  byte  9
  11000110b  byte 10
  11000110b  byte 11
  11000110b  byte 12
  00000000b  byte 13
  00000000b  byte 14
  00000000b  byte 15
  

  完整的位图包含每个字符的位图，因此是256*16字节，4096字节长（用于8x16字体）。如果要获取特定字符的位图，则必须将ASCII代码乘以16（字符中的行中的行数为8x16字体）。

这些PSF文件是什么？

• 这些PSF（PC屏幕字体）是使用来自各种来源的RAW VGA ROM字体转储的BIN2PSF转换工具创建的。这些文件非常小，适用于嵌入式，内存有限或复古项目。这些文件几乎是VGA ROM字体的原始转储，标头只有几个字节。

   +--------------------------------------------+
  | PSF1_MAGIC0 0x36 (1 byte)                  |
  +--------------------------------------------+
  | PSF1_MAGIC1 0x04 (1 byte)                  |
  +--------------------------------------------+
  | MODE (1 byte; set to 0)                    |
  +--------------------------------------------+
  | FONT HEIGHT (1 byte)                       |
  +--------------------------------------------+
  | CHAR 1 SCAN LINE 1 (1 byte)                |
  | CHAR 1 SCAN LINE 2 (1 byte)                |
  | CHAR 1 SCAN LINE 3 (1 byte)                |
  | CHAR 1 SCAN LINE 4 (1 byte)                |
  | CHAR 1 SCAN LINE 5 (1 byte)                |
  |                    ..                      |
  |                    ..                      |
  |                    ..                      |
  | CHAR 1 SCAN LINE <FONT HEIGHT>  (1 byte)   |
  +--------------------------------------------+
  | CHAR 2 SCAN LINE 1 (1 byte)                |
  | CHAR 2 SCAN LINE 2 (1 byte)                |
  | CHAR 2 SCAN LINE 3 (1 byte)                |
  | CHAR 2 SCAN LINE 4 (1 byte)                |
  | CHAR 2 SCAN LINE 5 (1 byte)                |
  |                    ..                      |
  |                    ..                      |
  |                    ..                      |
  | CHAR 2 SCAN LINE <FONT HEIGHT>  (1 byte)   |
  +--------------------------------------------+
  |                    ..                      |
  |                    ..                      |
  |                    ..                      |
  +--------------------------------------------+
  |                    ..                      |
  |                    ..                      |
  |                    ..                      |
  +--------------------------------------------+
  |                    ..                      |
  |                    ..                      |
  |                    ..                      |
  +--------------------------------------------+
  | CHAR 256 SCAN LINE 1 (1 byte)              |
  | CHAR 256 SCAN LINE 2 (1 byte)              |
  | CHAR 256 SCAN LINE 3 (1 byte)              |
  | CHAR 256 SCAN LINE 4 (1 byte)              |
  | CHAR 256 SCAN LINE 5 (1 byte)              |
  |                    ..                      |
  |                    ..                      |
  |                    ..                      |
  | CHAR 256 SCAN LINE <FONT HEIGHT>  (1 byte) |
  +--------------------------------------------+
  

笔记

• 这需要最新版本的QB64-PE
• 当您克隆包含子模块的存储库时，默认情况下不会自动克隆子模型
• 您将需要使用git submodule update --init --recursive初始化，获取和结帐git子模块

资产

• Rick Christy的Ansi Art
• Umut Pulat的图标