【LibRaw】原始图像解码库介绍（四）——常量

常量

枚举LibRaw_errors：错误代码

返回整数的所有函数必须返回errno或以下错误代码之一（另请参阅错误代码约定）。

致命错误（返回此类错误代码意味着必须终止文件处理，因为数据结构的状态未知）。

LIBRAW_UNSUFFICIENT_MEMORY: 尝试从系统获取内存失败。
将释放所有已分配的资源，将调用 recycle（），并且“创建后”将立即将LibRaw对象置于状态。
LIBRAW_DATA_ERROR: 数据解包期间出现了致命错误。
将释放所有已分配的资源，将调用 recycle（），并且“创建后”将立即将LibRaw对象置于状态。
LIBRAW_IO_ERROR: 文件读取过程中出现致命错误（遇到文件过早结束或文件损坏）。
将释放所有已分配的资源，将调用 recycle（），并且“创建后”将立即将LibRaw对象置于状态。
LIBRAW_CANCELLED_BY_CALLBACK: 由于调用应用程序需求而导致处理被取消（通过从进程回调返回非零代码）。
将释放所有已分配的资源，将调用 recycle（），并且“创建后”将立即将LibRaw对象置于状态。
LIBRAW_BAD_CROP: 通过params.cropbox []设置不正确的裁剪坐标：裁剪矩形的左上角位于图像外部。处理将被取消，所有已分配的资源将被释放，将调用 recycle（），并且LibRaw对象将在“创建后立即”进入状态。

非致命错误

LIBRAW_SUCCESS = 0: 没有错误; 功能已成功终止。
LIBRAW_UNSPECIFIED_ERROR: 遇到未知错误。永远不应该生成此代码。
LIBRAW_FILE_UNSUPPORTED: 不支持的文件格式（尝试打开程序未知的RAW文件）。
LIBRAW_REQUEST_FOR_NONEXISTENT_IMAGE: 尝试检索数据文件中缺少数字的RAW图像（仅适用于支持在文件中存储多个图像的格式）。
LIBRAW_OUT_OF_ORDER_CALL: 已经以错误的顺序调用API函数（例如，在 open_file （）之前的 unpack（））或者前一个阶段以错误结束（例如，在 open_file（）返回错误之后调用 unpack（））。
LIBRAW_NO_THUMBNAIL: 尝试从不包含预览的文件中检索缩略图时返回。
LIBRAW_UNSUPPORTED_THUMBNAIL: RAW文件包含不支持格式的预览。

enum LibRaw_decoder_flags - RAW数据格式描述

根据给定数据格式的功能，具有RAW数据的缓冲区可能具有不同的布局：

LIBRAW_DECODER_HASCURVE: 如果解码器使用RAW色调曲线并且在调用解码器之前可以修改曲线数据（即，在解码器内不读取或计算曲线值），则设置该标志。
LIBRAW_DECODER_SONYARW2: 如果文件格式为Sony ARW2.3，则设置此标志，因此sony_arw2_options适用。
LIBRAW_DECODER_TRYRAWSPEED: 如果RawSpeed库（可能）支持文件格式，则设置此标志，因此unpack（）将尝试使用它。
LIBRAW_DECODER_FIXEDMAXC: 不要对此数据格式使用自动最大计算。
LIBRAW_DECODER_OWNALLOC: 解码器分配数据，不需要将分配的内存传递给解码器。

枚举LibRaw_progress：LibRaw对象的当前状态

LibRaw :: imgdata.progress_flags包含一个位掩码，用于描述已执行的所有文件处理阶段。

文件打开和RAW数据提取阶段。

LIBRAW_PROGRESS_START = 0: 刚刚创建的对象，没有执行任何处理。
LIBRAW_PROGRESS_OPEN: 要处理的文件已打开。
LIBRAW_PROGRESS_IDENTIFY: 执行数据识别，识别格式，提取元数据。
LIBRAW_PROGRESS_SIZE_ADJUST: 调整了数据大小（对于需要进行此类调整的文件，即来自柯达相机的某些文件）。
LIBRAW_PROGRESS_LOAD_RAW: 已加载RAW数据。

在使用从dcraw中获取的图像处理期间设置以下标志。

LIBRAW_PROGRESS_RAW2_IMAGE: imgdata.image数组已分配并填充数据。
LIBRAW_PROGRESS_REMOVE_ZEROES: 删除需要移除的相机的零值（Panasonic相机）。
LIBRAW_PROGRESS_BAD_PIXELS: 删除了坏（死）像素。
LIBRAW_PROGRESS_DARK_FRAME: 从RAW数据中减去暗帧。
LIBRAW_PROGRESS_FOVEON_INTERPOLATE: 执行带有Foveon传感器的摄像机的插值。
LIBRAW_PROGRESS_SCALE_COLORS: 进行白平衡。
LIBRAW_PROGRESS_PRE_INTERPOLATE: 执行图像尺寸缩小（对于half_size模式），以及在存在第二通道且第一通道不存在的点处将第二绿色通道复制到第一通道。
LIBRAW_PROGRESS_INTERPOLATE: 插值（debayer）执行。
LIBRAW_PROGRESS_MIX_GREEN: 执行绿色通道的平均值。
LIBRAW_PROGRESS_MEDIAN_FILTER: 进行中位数过滤。
LIBRAW_PROGRESS_HIGHLIGHTS: 处理突出显示。
LIBRAW_PROGRESS_FUJI_ROTATE: 对于来自富士相机的图像，执行旋转（或调整adjust_sizes_info_only（））。
LIBRAW_PROGRESS_FLIP: 使用旋转相机拍摄的图像重新计算尺寸（sizes.iwidth / sizes.iheight交换）。
LIBRAW_PROGRESS_CONVERT_RGB: 转换为输出RGB空间执行。
LIBRAW_PROGRESS_STRETCH: 对于具有非方形像素的相机，图像尺寸已更改。
LIBRAW_PROGRESS_STAGE17 - LIBRAW_PROGRESS_STAGE27: 保留可能出现的其他处理阶段。

在加载缩略图期间设置以下标志。

LIBRAW_PROGRESS_THUMB_LOAD已加载缩略图数据（对于柯达相机，还进行了必要的转换）。LIBRAW_PROGRESS_TRESERVED1 - LIBRAW_PROGRESS_TRESERVED3保留用于将来可能的处理阶段。

enum LibRaw_whitebalance_code - 标准光源的名称

LIBRAW_WBI_lightsource_name，其中名称和值是标准EXIF光源。

enum LibRaw_camera_mounts - 摄像机支架的代码

常量名称（例如LIBRAW_MOUNT_Leica_SL）不言而喻

枚举LibRaw_runtime_capabilities - 在构建时设置的libraw功能

LIBRAW_CAPS_RAWSPEED - 使用RawSpeed编译
LIBRAW_CAPS_DNGSDK - 使用Adobe DNG SDK编译
LIBRAW_CAPS_DEMOSAICSGPL2 - 使用Demosaic Pack GPL2编译
LIBRAW_CAPS_DEMOSAICSGPL3 - 使用Demosaic Pack GPL3编译

枚举LibRaw_thumbnail_formats：缩略图数据格式

缩略图数据格式写在imgdata.thumbnail.tformat数据字段中。
目前LibRaw知道四种缩略图格式，其中两种是解压缩的：

LIBRAW_THUMBNAIL_UNKNOWN: 格式未知或尚未阅读的缩略图。
LIBRAW_THUMBNAIL_JPEG: 缩略图缓冲区包含一个JPEG文件（按“原样”从RAW文件中读取，不对其执行任何操作）。
LIBRAW_THUMBNAIL_BITMAP: 缩略图缓冲区包含经过伽马调整的RGB位图（对于柯达相机，执行伽马校正时允许最大值，并根据相机设置设置白平衡）。
在这种格式中，图像的每个像素由8位RGB三元组表示。
LIBRAW_THUMBNAIL_LAYER: 数据格式目前在打开RAW文件时被识别但不受支持：未解压缩到LibRaw :: unpack_thumb。
LIBRAW_THUMBNAIL_ROLLEI: 数据格式目前在打开RAW文件时被识别但不受支持：未解压缩到LibRaw :: unpack_thumb。

RAW数据处理期间的非标准情况（警告）

图像处理过程中出现的一些可疑情况并不是致命的，但可能会影响数据检索或后处理的结果。通过在imgdata.process_warnings字段中设置一个位来指示这些状态。

LIBRAW_WARN_FOVEON_NOMATRIX: 仅适用于具有Foveon的相机：提取其中一个数据矩阵失败。
LIBRAW_WARN_FOVEON_INVALIDWB: 仅适用于使用Foveon的相机：白平衡数据的提取失败。
LIBRAW_WARN_BAD_CAMERA_WB: 后处理必须使用相机的白平衡，但此平衡不适合使用。
LIBRAW_WARN_NO_METADATA: 仅适用于从外部JPEG文件中获取元数据的摄像机：元数据提取失败。
LIBRAW_WARN_NO_JPEGLIB: 仅适用于P＆S柯达相机：JPEG格式的数据。同时，open_file（）将返回LIBRAW_FILE_UNSUPPORTED。
LIBRAW_WARN_NO_EMBEDDED_PROFILE: （仅当编译LCMS支持时）。调用者设置嵌入式输入配置文件使用，但RAW中不存在此类配置文件。
LIBRAW_WARN_NO_INPUT_PROFILE: （仅当编译LCMS支持时）。打开输入配置文件ICC文件时出错。
LIBRAW_WARN_BAD_OUTPUT_PROFILE: （仅当编译LCMS支持时）。打开输出配置文件ICC文件时出错。
LIBRAW_WARN_NO_BADPIXELMAP: 打开坏像素映射文件时出错。
LIBRAW_WARN_BAD_DARKFRAME_FILE: 打开暗帧文件时出错。
LIBRAW_WARN_BAD_DARKFRAME_DIM: 暗帧文件的尺寸与处理的RAW文件不同，或格式错误。暗帧应采用16位PGM格式（可以使用simple_dcraw -4 -D生成）。
LIBRAW_WARN_RAWSPEED_PROBLEM: 在RawSpeed解压缩器中检测到问题。LibRaw自己的解码器处理的图像数据。
LIBRAW_WARN_RAWSPEED_UNSUPPORTED: RawSpeed不支持此文件（尽管存在兼容的解码器）。
LIBRAW_WARN_RAWSPEED_PROCESSED: 不是警告，而是信息。该文件由RawSpeed解码。
LIBRAW_WARN_FALLBACK_TO_AHD: 设置了不正确/不支持的user_qual，而是使用AHD demosaic。

enum LibRaw_image_formats - 可能的数据类型，包含在libraw_processed_image_t结构中

libraw_processed_image_t结构的type字段可能具有以下值之一：

LIBRAW_IMAGE_BITMAP: 该结构包含RGB位图，libraw_processed_image_t的其他字段中描述的元数据。
LIBRAW_IMAGE_JPEG: libraw_processed_image_t结构包含JPEG图像（在内存中）。只有data_size字段才有意义。

来源： https://www.libraw.org/docs/API-datastruct-eng.html#libraw_data_t