Spritemapper 技术文档

1. 安装指南

Spritemapper 是一个 Python 应用，用于将多个图像合并为一张图，并为相应的切片生成 CSS 定位。以下是安装步骤：

• 确保您的系统中已安装 Python。
• 使用 pip 安装 Spritemapper：pip install spritemapper。

2. 项目的使用说明

Spritemapper 包含一个简单的命令行工具和一个 Python 库，其中包括自制的 PNG 和 CSS 解析器。使用方法如下：

spritemapper [options]

选项包括：

• -h, --help：显示帮助信息并退出。
• -c INI, --conf=INI：从 INI 文件中读取基本配置。
• --padding=N：在精灵之间保持 N 个像素的填充。

3. 项目API使用文档

Spritemapper 的配置选项可以通过两种方式指定：内联在 CSS 中，或通过传递一个包含默认设置的 INI 文件。内联在 CSS 中的示例如下：

/* spritemapper.output_css = foofile.css */

使用 INI 文件的示例：

[spritemapper]
output_css = foofile.css

所有路径相对于正在处理的 CSS 文件。

配置选项如下：

• base_url：生成的 CSS 和图像文件可以访问的 URL。默认使用文件相对路径。
• sprite_dirs：允许生成精灵图的目录列表。默认所有目录都可用。
• recursive：如果发现子目录，是否应该生成子精灵图。默认启用。
• output_image：输出精灵图图像的名称。与 sprite_dirs 不兼容。
• output_css：重写的 CSS 文件的名称。默认为 sm_{basename}{extension}。
• padding：两个图像之间的填充空间量。默认为 1。
• anneal_steps：较大数值会使装箱算法尝试更多组合。默认为 9200。

4. 项目安装方式

请遵循以下步骤安装 Spritemapper：

1. 确认您的系统已安装 Python。
2. 打开命令行窗口。
3. 执行以下命令安装 Spritemapper：

pip install spritemapper

安装完成后，您可以使用命令行工具或通过 Python 库来使用 Spritemapper。