# third_party_libtiff

**Repository Path**: wangqi55555/third_party_libtiff

## Basic Information

- **Project Name**: third_party_libtiff
- **Description**: auto-created from manifest diff
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: weekly-20260109
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-01-28
- **Last Updated**: 2026-01-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# libtiff

原始仓来源：https://gitlab.com/libtiff/libtiff


仓库包含第三方开源软件libtiff，libtiff用于读取、写入和操作TIFF（Tagged Image File Format）图像文件。它提供了一套标准化的接口来处理TIFF格式的各种复杂特性，包括多种压缩算法（如 LZW, Deflate, JPEG 等）的支持。在OpenHarmony中，libtiff主要作为媒体子系统的基础组件，提供TIFF图片格式的解码能力。

## 目录结构

```
archive/    过往归档文件
build/      构建辅助脚本
cmake/      CMake构建配置文件
contrib/    社区贡献的非核心代码
doc/        说明文档
libtiff/    libtiff核心库源代码及头文件
port/       平台兼容性接口代码
test/       测试脚本和用例
tools/      tiffcp, tiffdump等二进制工具源码
README.md   README说明
```

## OpenHarmony如何使用libtiff

OpenHarmony的系统部件需要在BUILD.gn中引用libtiff部件以使用libtiff。
```
// BUILD.gn
external_deps += [ "libtiff:libtiff" ]
```

## 使用libtiff库解码步骤

(1) 打开文件

  ```
  TIFF *TIFFOpen(const char *filename, const char *mode);
  filename：文件名
  mode：打开模式（"r"表示读取）
  ```

(2) 读取图片的元数据

  ```
  int TIFFGetField(TIFF *tif, uint32_t tag, ...);
  tif：TIFF文件上下文环境
  tag：要读取的元数据标签
  ...：可变参数，用于接收tag值 

  具体示例如：
  TIFFGetField(tif, TIFFTAG_IMAGEWIDTH, &imgWidth);
  ```

(3) 图片解码

  ```
  int TIFFReadRGBAImage(TIFF *tif, uint32_t width, uint32_t height, uint32_t *raster, int stopOnError);
  tif：TIFF文件上下文环境
  width：图片宽度
  height：图片高度
  raster：接收解码后像素数据的内存首地址
  stopOnError：错误处理策略，设为非0值则遇错立即终止；设为0则尝试跳过错误继续解码。

  具体示例如：
  uint32_t *raster = (uint32_t *)_TIFFmalloc(width * height * sizeof(uint32_t));
  if (raster != NULL) {
    if (TIFFReadRGBAImage(tif, width, height, raster, 0)) {
      // 解码成功，处理 raster 中的数据
    }
    _TIFFfree(raster);
  }
  ```

(4) 关闭文件

  ```
  void TIFFClose(TIFF *tif)；
  tif：TIFF文件上下文环境
  ```

## 功能支持说明

OpenHarmony目前仅集成了libtiff的解码能力，用于读取和显示TIFF图片。暂不支持图片编码及元数据编辑（如修改或添加标签）功能。

## License

libtiff使用LibTIFF License(一种类 BSD 协议)，详见仓库根目录下的LICENSE.md文件。