【LibRaw】原始图像解码库介绍（一）——API概述

API概述（C ++）

一般性评论

1. 整个处理由LibRaw类的实例执行，LibRaw类是图像处理器。
2. 一个图像处理器可以同时处理一个数据源文件，但是可以连续处理任意数量的文件。
3. 在软件程序中可能存在若干同时工作的图像处理器（例如，在不同的线程中），但是应该记住每个图像处理器可能需要很多存储器。
4. 从RAW文件中读取源数据几乎不需要自定义（有关此规则的例外，请参阅API注释）。
5. 从RAW文件提取的所有数据都可以通过图像处理器（LibRaw类实例）的数据字段访问。
6. 尽管LibRaw 不适用于RAW数据后处理，但该库包含的调用可以完全模拟dcraw实用程序。
7. 处理的所有自定义都是通过LibRaw类的数据字段执行的。

简要示范

为简洁起见，下面的示例不包含错误处理。

#include“libraw / libraw.h”
int process_image（char * file）
{
        //让我们创建一个图像处理器
        LibRaw iProcessor;

        //打开文件并阅读元数据
        iProcessor.open_file（文件）;

        //可以通过类的数据字段访问元数据
        printf（“图像大小：％dx％d \ n”，iProcessor.imgdata.sizes.width，iProcessor.imgdata.sizes.height）;

        //让我们解压缩图像
        iProcessor.unpack（）;

        //从imgdata.rawdata转换为imgdata.image：
        iProcessor.raw2image（）;

        //让我们打印它的转储; 数据可通过类的数据字段访问
        for（i = 0; i lt; iProcessor.imgdata.sizes.iwidth * iProcessor.imgdata.sizes.iheight; i ++）
           printf（“i =％d R =％d G =％d B =％d G2 =％d \ n”，
                        一世，
                        iProcessor.imgdata.image [I] [0]，
                        iProcessor.imgdata.image [I] [1]，
                        iProcessor.imgdata.image [I] [2]，
                        iProcessor.imgdata.image [I] [3]
                ）;

        //最后，让我们释放图像处理器以使用下一张图像
        iProcessor.recycle（）;
}