LOADFILEOPTION

类型定义结构体_LOADFILEOPTION｛L_UINTuStructSize;L_INTXResolution;L_INTYResolution;L_UINT国旗;L_INT通过;L_INTPageNumber;L_UINTGlobalLoop;L_IFDTYPEIFD;L_UINTuRedScan;L_UINTuGreenScan;L_UINTuBlueScan;L_UINTFlags2;L_VOID* pFilterData;L_SIZE_TuFilterDataSize;L_INTnFilter;L_INTnAttachment;} LOADFILEOPTION， * pLOADFILEOPTION;

的LOADFILEOPTION结构指定用于读取映像文件的额外选项。

成员

uStructSize

LOADFILEOPTION结构的大小。这应该是sizeof(LOADFILEOPTION)。你必须填充这个成员。

XResolution

水平点每英寸。

YResolution

垂直点每英寸。

旗帜

下列标志之一。(使用位或指定多个值。)

价值 意义
ELO_REVERSEBITS [0x00000001]当写入CCITT组3和组4文件时，反转位顺序，使最低有效位(LSB)在前面。
ELO_GLOBALBACKGROUND [0x00000002]保存全局背景色的GIF文件，全局背景色由GlobalBackground字段指定。
ELO_GLOBALPALETTE [0x00000004]使用GlobalPalette字段指定的全局调色板保存一个GIF文件。
ELO_GLOBALLOOP [0x00000008]加载动画文件时启用循环要使用GlobalLoop字段，该标志必须打开。
ELO_ROTATED [0x00000010]不旋转加载文件。这会影响可以用旋转视图保存的文件。有关更多信息，请参阅视图视图．
ELO_IGNOREVIEWTRANSFORMS [0x00000020]加载一个Flash-Pix文件，而不被查看转换修改。
ELO_IGNORECOLORTRANSFORMS [0x00000040]加载一个Flash-Pix文件而不被颜色变换修改。
ELO_SIGNED [0x00000080]位图可以包含负像素值。
ELO_DISABLEMMX [0x00000100]不要使用MMX优化代码
ELO_DISABLEP3 [0x00000200]不要使用p3特定的优化代码。
ELO_USEIFD [0x00000400]使用IFD偏移量。
ELO_FORCECIELAB [0x00000800](仅限JPEG)文件具有CIELAB颜色空间
ELO_USEBADJPEGPREDICTOR [0x00001000](仅限JPEG)使用不正确的预测器加载无损JPEG文件
ELO_IGNOREPHOTOMETRICINTERP [0x00002000](仅限TIFF)使用RGB colorspace代替存储在文件中的PhotometricInterpretation。在加载过程中禁用颜色转换为RGB。
ELO_FORCERGBFILE [0x00004000](仅限JPEG)文件具有RGB色彩空间。
ELO_MULTISPECTRALSCAN [0x00008000]加载NITF文件时使用uXXXScan值信息
ELO_NOPALETTE [0x00010000]使用新的调色板机制不要使用GDI内存来存储调色板。
ELO_IGNOREVIEWPERSPECTIVE [0x00200000](仅限TIF和Exif)忽略存储在文件中的视图透视图，并将文件加载为TOP_LEFT。如果您正在加载一个看起来旋转或翻转的TIF或Exif文件，请在加载文件之前尝试设置此标志。
ELO_USEFASTCONVERSION [0x00400000](仅限TIF和JPEG)加载CMYK或CIELab文件时使用快速颜色转换。设置这个标志将大大加快CMYK和CIELab文件的加载速度，但会降低图像质量。
ELO_ALPHAINIT [0x01000000]将32位或64位彩色图像的alpha通道初始化为所有通道(8位alpha通道为0xFF, 16位alpha通道为0xFFFF)。
如果未指定此标志，则:
—如果源位图有alpha值，加载的位图中alpha值将保持不变。
—如果源位图没有alpha值，加载位图中的alpha值将被初始化为所有alpha值(8位alpha通道为0xFF, 16位alpha通道为0xFFFF)。
LOADFILEOPTION的默认值。Flags包含此标志。
当加载以下格式时，该标志将被忽略:
——FILE_TIF
——FILE_TIFLZW
——FILE_TIF_CMYK
——FILE_TIFLZW_CMYK
——FILE_TIF_PACKBITS
——FILE_TIF_PACKBITS_CMYK
——FILE_TIF_YCC
——FILE_TIFLZW_YCC
——FILE_TIF_PACKBITS_YCC
——FILE_TIF_J2K
——FILE_TIF_ZIP
——FILE_PNG
——FILE_PNG_ICO
——FILE_PSD
ELO_PREMULTIPLY_ALPHA [0x40000000]加载图像数据时预乘alpha值仅在加载有alpha信息的PNG和PSD文件时使用。
ELO_LOADCORRUPTED [0x00010000]尝试加载损坏的文件
ELO_NITF_USE_MAX [0x00040000](仅限NITF)使用最大宽度和高度。
ELO_NITF_USE_MONODARK [0x00080000](仅限NITF)使用单色暗进程(使结果位图变亮)。
ELO_NITF_SHOW_OBJECT [0x00100000](仅限NITF)如果对象CGM存在，则使该对象可用。
ELO_IGNORE_ADOBE_COLOR_TRANSFORM [0x04000000]忽略包含颜色转换的Adobe标记。设置此标志可加载带有错误APPE标记且颜色不正确的损坏文件。
ELO_ALLOW13BITLZWCODE [0x08000000]尝试解码包含13位LZW代码的有bug的LZW TIF文件。
ELO_VECTOR_CONVERTED_UNITS [0x10000000]使用转换后的单位，而不是输入文件的默认单位
ELO_LOADOLDJBIG2FILES [0x20000000]加载由LEAD JBIG2过滤器生成的旧JBIG2文件。

通过

加载或保存渐进式JPEG或LEAD CMP文件时(扫描图像)的次数。(此值也用于加载交错的PNG文件)(此值也用于加载JBIG文件，以确定加载的分辨率数量，以创建累进加载效果。)

加载累进文件时可能的值:

任何正数 调用FILEREADCALLBACK函数指定的次数。
CALLBACK_ONCE [0]呼叫FILEREADCALLBACK函数只在最后执行一次。
CALLBACK_WHEN_MEANINGFUL [-1]打电话给FILEREADCALLBACK仅在重要扫描时生效。(这通常是最好的选择。)
CALLBACK_ALWAYS [-2]打电话给FILEREADCALLBACK函数获取默认扫描次数。

PageNumber

多页文件的页码，该文件可以包含多张图像。加载文件时，这是确切的页码。有关多页文件的更多信息，请参阅多页文件格式．

GlobalLoop

播放动画时的循环计数。使用0表示连续循环。如果没有循环，请关闭Flags字段中的ELO_GLOBALLOOP标志。

IFD

页开始位置的TIFF文件中的偏移量。这作为将页面加载到大型TIFF文件的参考页。

uRedScan

(仅限NITF)红色组件要加载的扫描索引。仅当设置ELO_MULTISPECTRALSCAN时使用。

uGreenScan

(仅限NITF)绿色组件要加载的扫描索引。仅当设置ELO_MULTISPECTRALSCAN时使用。

uBlueScan

(仅限NITF)蓝色组件要加载的扫描索引。仅当设置ELO_MULTISPECTRALSCAN时使用。

Flags2

下列标志之一。(您可以使用位或来指定多个值。)

价值 意义
ELO2_MULTITHREADED [0x00000001]使用多线程代码加载JPEG或CMP文件
ELO2_USEFILTERDATA [0x00000004]使用过滤数据信息(pFilterData, uFilterDataSize, nFilter)来加速处理。
看到使用过滤器数据加速加载大文件主题以获取更多信息。
ELO2_PREFERVECTOR [0x00000008]如果支持，使用矢量处理。
ELO2_AUTOFIXBITMAPRESOLUTION [0x00000010]自动修正位图分辨率L_SetAutoFixBitmapResolutionOptions设置。
ELO2_IGNORE_EMBEDDED_ICC_PROFILE [0x00000020]忽略嵌入在文件中的ICC配置文件(如果有的话)-主要用于加载TIFF/JPEG CMYK/LAB文件。
一些包含CMYK或CieLAB数据的文件可能包含嵌入的ICC配置文件。这些文件应该使用这些配置文件来查看，以将CMYK/CieLAB数据转换为BGR。LEADTOOLS v20及更高版本默认使用这些嵌入式ICC配置文件。LEADTOOLS v19和之前的版本忽略了这些配置文件，并使用标准CMYK配置文件转换为BGR。
Exif、JPEG和TIFF文件是包含此类嵌入式ICC配置文件的最常见文件格式。
在加载文件时设置ELO2_IGNORE_EMBEDDED_ICC_PROFILE标志以忽略嵌入的ICC配置文件。这将确保与早期版本的LEADTOOLS向后兼容。

pFilterData

指向用于加速处理(加载、获取文件信息等)的过滤器数据结构的指针。仅当Flags2包含ELO2_USEFILTERDATA标志时使用。通过将FILEINFO_USEFILTERDATA标志传递给L_FileInfo．如果不是NULL，使用释放它L_FreeFilterData当不再需要的时候。

看到使用过滤器数据加速加载大文件主题以获取更多信息。

uFilterDataSize

筛选器数据的大小。仅当Flags2包含ELO2_USEFILTERDATA标志时使用。通过将FILEINFO_USEFILTERDATA标志传递给L_FileInfo．

如果为0，则过滤器数据可能包含仅在当前进程中有效的句柄或指针。此外，如果为0，则过滤器数据一次只能在一个线程中使用。目前，这是大多数过滤器的情况。

如果不是0，则筛选器数据是平坦的，可以保存到磁盘并稍后重新加载。

看到使用过滤器数据加速加载大文件主题以获取更多信息。

nFilter

分配筛选器数据的筛选器。仅当Flags2包含ELO2_USEFILTERDATA标志时使用。通过将FILEINFO_USEFILTERDATA标志传递给L_FileInfo．

看到使用过滤器数据加速加载大文件主题以获取更多信息。

nAttachment

以1为基础的附件编号加载。

评论

pLOADFILEOPTION是指向LOADFILEOPTION结构的指针。其中函数参数类型为pLOADFILEOPTION，您可以声明一个LOADFILEOPTION变量，更新结构的字段，并在参数中传递变量的地址。只有在程序需要指针时才需要声明pLOADFILEOPTION变量。

方法加载邮票图像L_ReadFileStamp函数。

如果设置了ELO_SIGNED，位图可以包含负像素值。这可能导致图像在加载时被错误地绘制。为了正确加载，必须调用L_ClearNegativePixels在加载图像之前。如果没有设置ELO_SIGNED，图像中的任何负像素都将在内部清除。

笔记：

ELO_MULTISPECTRALSCAN由NITF过滤器内部使用。您不需要使用此标志。

当在期望图像数据为预乘alpha格式的平台上加载用于显示目的的图像时，包括ELO_PREMULTIPLY_ALPHA标志以进行适当的图像显示(即，将保留透明度信息)。当为图像处理目的加载图像时不包括ELO_PREMULTIPLY_ALPHA，因此图像数据将被加载，因为它实际上存储在输入文件中(用于适当的像素数据操作)。

该结构用于:

看到L_GetDefaultLoadFileOption有关默认加载选项的信息。

栅格成像C API帮助
简介
版本历史
开始
应用程序中包含的文件
文档编写者-与您的应用程序包含的文件
LEADTOOLS光栅成像功能
快速参考
教程
函数引用
回调函数
特点概述
附录
188金宝搏的网址客服|支持|联系我们|知识产权公告
©1991 - 2021领德科技有限公司版权所有。