32Blit 资产准备和上传工具
项目描述
32blit 工具集
此工具集旨在与32Blit控制台一起使用,以准备资产和上传游戏。
运行
32Blit 工具集包含每个工具的子命令,您可以使用以下命令列出它们:
32blit --help
- image - 将图像/精灵转换为32Blit
- font - 将字体转换为32Blit
- map - 将流行的瓦片图格式转换为32Blit
- raw - 将原始/二进制或csv数据转换为32Blit
- pack - 打包32Blit的资产集合
- cmake - 为资产打包器生成CMake配置
- flash - 将二进制文件或保存的游戏/文件闪存到32Blit
- metadata - 使用元数据标记32Blit .blit文件
- relocs - 将重定位地址预置到游戏二进制文件中
- version - 打印当前32blit版本
要运行工具,请在其名称后追加32blit命令,例如
32blit version
工具
元数据
构建元数据,并将其添加到.blit
文件中。
闪存
通过USB串行线闪存和管理您的32Blit上的游戏。
重定位
收集需要修补以使.blit
文件可重定位和位置无关的地址列表。
Cmake
为元数据信息和/或资产管道输入/输出生成CMake文件。
资产
通常,您会使用“资产管道”来创建资产,该管道通过一个assets.yml
文件进行配置,该文件列出了您想要包含的所有文件以及它们在代码中的命名方式。
一个assets.yml
文件可能看起来像这样:
# Define an output target for the asset builder
# in this case we want a CSource (and implicitly also a header file)
# type auto-detection will notice the ".cpp" and act accordingly
assets.cpp:
prefix: asset_
# Include assets/sprites.png
# and place it in a variable named "asset_sprites"
# Since it ends in ".png" the builder will run "sprites_packed" to convert our source file
assets/sprites.png:
name: sprites
palette: assets/sprites.act
strict: true # Fail if a colour does not exist in the palette
transparent: 255,0,255
# Include assets/level.tmx
# and place it in a variable named "asset_level_N_tmx"
# Since it ends in ".tmx" the builder will run "map_tiled" to convert our source file
assets/level*.tmx:
字体
将ttf文件或图像文件转换为32Blit字体。
支持的格式
- 图像 .png, .gif
- 字体 .ttf
图像
所有图像资产都由Pillow处理,因此大多数图像格式都将工作。注意,有损格式可能会向您的调色板添加不需要的颜色,并留下过大的资产。请小心。
支持的格式
- 8位PNG .png
- 24位PNG .png
选项
palette
- 包含资产调色板的图像或调色板文件(Adobe .act,Pro Motion NG .pal,GIMP .gpl)transparent
- 透明颜色(如果调色板不是RGBA图像),可以是十六进制(FFFFFF)或R,G,B(255,255,255)packed
- (默认为true)将输出资产打包到根据调色板大小确定的位中。16色调色板将使用4位/像素。strict
- 只允许调色板图像/文件中存在的颜色
地图/关卡
支持的格式
- Tiled .tmx - https://www.mapeditor.org/(非常初版!)
原始二进制/文本格式
支持的格式
- CSV .csv
- 二进制 .bin, .raw
变更日志
0.7.4
- 修复从闪存删除时的错误 - 感谢 @ali1234
- 修复错误信息中的串行端口 - 感谢 @ali1234
- 修复图像编码 - 感谢 @Daft-Freak
0.7.3
- 验证元数据图像大小 - 感谢 @Daft-Freak
- 支持独立元数据输出 - 感谢 @Daft-Freak
- 支持生成包含Pico (RP2040) 二进制信息的源文件 - 感谢 @Daft-Freak
- 输出略微优化过的C输出 - 感谢 @Daft-Freak
0.7.2
- 为ITCM RAM添加重定位支持 - 感谢 @Daft-Freak
0.7.1
- 添加DFU工具
- 闪烁时现在显示文件名
- 删除不必要的重置到固件代码
- 修复GIMP调色板处理
- 支持更多图像字体布局(多行支持)
- 在处理字体数据时将freetype作为软依赖项
- 一些小的调整和整理
0.7.0
- 重新工作Tiled地图支持(需要更新SDK)- 感谢 @Daft-Freak
- 元数据CMake工具现在转义引号 - 感谢 @Daft-Freak
- 新项目设置工具“32blit setup”,用于下载/配置样板项目 - 感谢 @Daft-Freak
- 修复资产构建器在没有找到有效输入文件时抛出晦涩的错误
0.6.1
- 确保安装了最低要求的click版本 - 感谢 @LordEidi
- 添加独立的启动命令(在SDK v0.1.11及以后版本)和
--launch
标志以安装 - 感谢 @Daft-Freak - 支持16位瓦片索引 - 感谢 @ThePythonator
- 为SDL构建输出URL/类别元数据 - 感谢 @Daft-Freak
0.6.0
- 通过@Ali1234进行重大代码重构和修复
- 工具已移植到Click
- 新
32blit install
命令,智能安装文件/blits
0.5.0
- 通过@Ali1234进行重大代码重构和修复
- 元数据转储修复以支持RL图像
- 修复选择不正确的透明颜色
- 为.tmx地图配置可配置的空瓷砖 - 指定要重映射到未设置/空瓷砖的瓷砖ID
- 为具有宽度、高度、层计数和空瓷砖的.tmx地图添加可选的结构输出类型
- .tmx地图层现在已排序
- 不应该破坏兼容性,但如果你不需要新功能,请使用0.4.x
0.4.0
- 破坏与先前版本的元数据兼容性!
- 为GitHub URL添加URL字段
- 添加类别字段以分类游戏/应用程序
- 添加文件关联字段以识别支持的文件类型
0.3.2
- 如果VID/PID为空,则允许使用用户指定的串行端口
- 支持CMake工具处理多组选项
0.3.1
- 修复了 "32blit game.blit" 的问题,现在使用 保存(到SD卡)而不是再次使用 闪存
0.3.0
- 新增:精灵表支持RLE编码
- 闪存工具:优化了简写 - "32blit flash game.blit" 和 "32blit game.blit" 将会闪存游戏。
- 闪存工具:修复了一个在闪存时重置打开的连接并中断的bug
0.2.0
- 新增:版本工具:32blit版本
- 打包器:支持通配符资源名称格式
0.1.4
- 新增:将PIC重定位工具迁移到工具中
0.1.3
- 打包器:修复了将资源路径处理为相对于工作目录的问题
0.1.2
- 闪存工具:添加了列表/删除命令
- 打包器:修复了资产打包器共享类实例和状态的bug
- 元数据:当从不在工作目录的配置文件构建时查找图像
- 元数据:要求只使用 --file 或 --config 选项中的一个
0.1.1
- 将元数据配置导出到CMake
- 添加支持将元数据启动画面打包为icns格式(适用于macOS)
0.1.0
- 修复调色板以支持256种颜色(计数将为0)
- 使用Construct解析元数据和重定位
- 破坏性更改:打包的图像格式已更改!
0.0.9
- 添加对具有RELO头的PIC重定位二进制文件的支持
- 为cmake工具添加字符串参数对资产文件名的支持
0.0.8
- 在运行
flash save
时从游戏自动重置到固件 - 添加
flash info
以确定是在游戏中还是在固件中 - 从cmake工具添加元数据依赖输出
- 修复资产依赖输出以包括像调色板这样的附加文件
- 将错误重定向到stderr
- 安静!使用 -vvvv 查看信息、警告、错误和调试信息。
0.0.7
- 添加元数据工具 - 使用.yml文件将元数据标记为二进制文件
- 修复打包器调色板文件的相对路径
- 为
32blit flash save
添加对子目录的支持
0.0.6
- 字体工具(感谢 @Daft-Freak)
- 带多目标功能的闪存命令(感谢 @Daft-Freak)
- 修复了调色板处理的bug(感谢 @Daft-Freak)
- 修复了打包识别的bug(似乎影响了Windows上的Python 3.8)
- 当使用0索引的瓷砖的.tmx地图文件时显示友好的错误信息(tmx的有效瓷砖从1索引开始)
0.0.5
- 输出数据长度符号(感谢 @Daft-Freak)
- 再次修复 --packed 为默认,再次(可以使用 --packed no 禁用打包)
- 其他各种调整
- 32blit文件上传支持开始
0.0.4
- 默认图像为打包(打包参数现在接受一个布尔值)
- 修复了精灵有效负载大小的bug(感谢 @Daft-Freak)
0.0.3
- 修复打包错误,使工具真正工作
0.0.2
- 真实的首个发布版本
- 打包、cmake和资产命令正常工作
- 非常测试版!
0.0.1
- 初始发布
项目详情
下载文件
下载适用于您平台的应用程序文件。如果您不确定要选择哪个,请了解更多关于 安装包 的信息。
源代码分发
32blit-0.7.4.tar.gz (43.7 kB 查看哈希值)
构建分发
32blit-0.7.4-py3-none-any.whl (39.8 kB 查看哈希值)
关闭
32blit-0.7.4.tar.gz的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | dd99c71758b1789fe213bca904c06169257159ce283f27405fcaadce4f27652b |
|
MD5 | 27a20e1f1eec3f13c43f246fd611e7b4 |
|
BLAKE2b-256 | e36d5be8c0d57ae80a9084624c3b4150185bb2c6fd71d0341e5804949117fe65 |
关闭
32blit-0.7.4-py3-none-any.whl的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 645af0b5e7b67c43e2927cce5c0e40a96ed22486de75ceaaf6cb4ab8a8da847a |
|
MD5 | 1368b7be69a9159e422700441ee56b36 |
|
BLAKE2b-256 | bc6147789ce9353ece7a4d6382fbef940fdaf1d83fbd39d7a9d04d81e4f7d6be |