跳转到主要内容

32Blit 资产准备和上传工具

项目描述

32blit 工具集

Build Status Coverage Status PyPi Package Python Versions

此工具集旨在与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 - 只允许调色板图像/文件中存在的颜色

地图/关卡

支持的格式

原始二进制/文本格式

支持的格式

  • 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 查看哈希值)

上传于 Python 3

由以下支持