Texpack 项目使用教程

Texpack 项目使用教程

texpack Simple cross-platform command line texture packer based on the MaxRects algorithm by Jukka Jylänki (https://github.com/juj/RectangleBinPack). 项目地址: https://gitcode.com/gh_mirrors/te/texpack

1. 项目目录结构及介绍

Texpack 是一个基于 MaxRects 算法的跨平台命令行纹理打包工具。以下是项目的目录结构及其介绍：

texpack/
├── bin/
├── src/
│   ├── main.c
│   ├── ...
├── test/
│   ├── test_cases.c
│   ├── ...
├── .gitignore
├── CMakeLists.txt
├── LICENSE
├── README.md
├── help.txt
└── makefile

• bin/: 存放编译生成的二进制文件。
• src/: 项目的主要源代码文件，包括 main.c 和其他相关源文件。
• test/: 包含项目的测试用例文件。
• .gitignore: Git 忽略文件配置。
• CMakeLists.txt: CMake 构建配置文件。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文件。
• help.txt: 帮助文档文件。
• makefile: 项目的 Makefile 文件，用于编译项目。

2. 项目的启动文件介绍

项目的启动文件是 src/main.c。这个文件包含了程序的主入口函数 main()，负责解析命令行参数、调用纹理打包算法并生成输出文件。

// src/main.c

#include <stdio.h>
#include <stdlib.h>
#include "texpack.h"

int main(int argc, char *argv[]) {
    // 解析命令行参数
    // 调用纹理打包算法
    // 生成输出文件
    return 0;
}

3. 项目的配置文件介绍

Texpack 项目没有传统的配置文件，但可以通过命令行参数进行配置。以下是一些常用的命令行参数及其介绍：

• -o, --output: 指定生成的文件前缀。
• -p, --padding: 设置纹理之间的填充像素。
• -s, --size: 设置纹理图集的固定大小。
• -S, --max-size: 将大小参数视为最大尺寸。
• -P, --POT: 保持纹理图集大小为2的幂。
• -r, --allow-rotate: 允许旋转纹理以更好地打包。
• -m, --metadata: 输入元数据文件，格式为 JSON。
• -e, --pretty: 生成的 JSON 文件将更易读。
• -t, --trim: 裁剪输入图像。
• -i, --indentation: 设置 JSON 文件的缩进。
• -u, --premultiplied: 生成的纹理图集将使用预乘 alpha。
• -b, --alpha-bleeding: 对纹理图集进行 alpha 出血处理。
• -M, --mode: 指定打包启发式算法。
• -f, --format: 指定 JSON 文件的输出格式。

例如，使用以下命令可以生成一个纹理图集：

texpack -o output/atlas -p 2 -s 512x512 input.txt

这个命令将生成一个名为 atlas.png 的纹理图集文件和一个名为 atlas.json 的元数据文件，纹理之间的填充像素为2，纹理图集的大小为 512x512 像素。

texpack Simple cross-platform command line texture packer based on the MaxRects algorithm by Jukka Jylänki (https://github.com/juj/RectangleBinPack). 项目地址: https://gitcode.com/gh_mirrors/te/texpack