Skip to content

README_ZH.md

Latest commit

 

History

History
89 lines (62 loc) · 2.23 KB

README_ZH.md

File metadata and controls

89 lines (62 loc) · 2.23 KB

tinytga

English | 简体中文

tinytga 是一个功能简单的、针对 tga 图像文件的、头文件形式的 C 语言库，用于 tga 文件格式的读取，创建和保存。

支持

对 tga 文件类型支持情况的细节如下

image type value support
No image data included 0 ✅
Uncompressed, color-mapped images 1 ✅
Uncompressed, RGB images 2 ✅
Uncompressed, black and white images 3 ✅
Runlength encoded color-mapped images 9 ❌
Runlength encoded RGB images 10 ❌
Compressed, black and white images 11 ❌
Compressed color-mapped data, using Huffman, Delta, and runlength encoding 32 ❌
Compressed color-mapped data, using Huffman, Delta, and runlength encoding. 4-pass quadtree-type process 33 ❌

其中，对 pixel 深度和 colormap 深度的支持如下

colormap entry size support
15 ❌
16 ✅
24 ✅
32 ✅
imagetype\pixeldepth 32 24 16 8
Uncompressed, color-mapped images ✅ ✅ ✅ ✅
Uncompressed, RGB images ✅ ✅ ❌ ❌
Uncompressed, black and white images - - - ✅

示例

#include "tinytga.h"
#include <assert.h>
#include <stdlib.h>

#define WIDTH 800
#define HEIGHT 600

int main(void) {
    tt_color black = tt_make_color(0xFF000000);
    tt_color white = tt_make_color(0xFFFFFFFF);

    tt_image *image = tt_create(WIDTH, HEIGHT, black);

    assert(image != NULL);

    // w and h starts from 0
    for (int h = 200-1; h <= 400-1; h++) {
        for (int w = 200-1; w <= 600-1; w++) {
            tt_set_color(image, w, h, white);
        }
    }

    const char *filename = "demo.tga";
    tt_save(image, filename);

    tt_destroy(image);

    return 0;
}

效果：

(为了在 README 中显示，我将 tga 文件转码成了 png 文件)

demo.tga

更多例子见 ./examples.

文档

See ./docs.

外部链接

更多 tga 格式细节可以参考