在这个话题▼

L_FileInfo

# include“l_bitmap.h”

L_LTFIL_APIL_INTL_FileInfo (pszFile、pFileInfo uStructSize、uFlags pLoadOptions)

被指定的文件和填充指定的信息FILEINFO结构的信息。

参数

L_TCHAR* pszFile

查询字符串包含输入文件名称。

pFILEINFOpFileInfo

指针FILEINFO结构。

请注意

从来没有通过未初始化FILEINFOL_FileInfo结构。

L_UINTuStructSize

结构大小的字节,指向pFileInfo版本控制。使用sizeof (FILEINFO)。

L_UINTuFlags

标志指示成员更新的FILEINFO结构,如果任何。FILEINFO_TOTALPAGES和FILEINFO_USEFILTERDATA值可以或者艾德在一起,在这种情况下,两个值检索。可能的值是:

价值	意义
FILEINFO_TOTALPAGES	[0 x0001]更新pFileInfo - > TotalPages领域总页数的文件。
FILEINFO_USEFILTERDATA	[0 x0002]使用过滤数据信息来加速加载。
0	不更新`pFileInfo`- > TotalPages字段。

pLOADFILEOPTIONpLoadOptions

指针可选的扩展加载选项。通过零使用默认加载选项。

价值	意义
成功	函数是成功的。
< 1	一个错误发生。指返回代码。

要使用该功能,请执行以下步骤:

FILEINFO声明一个变量的数据类型。
声明和分配一个字符串变量的文件名。
如果你越来越多页文件信息(可以包含多个图像),使用LOADFILEOPTION结构指定页码。你得到的信息将图像上指定的页面。L_FileInfo把整个页面作为一个图像(尽管一个页面可以包含多个嵌入式图像)。
初始化FILEINFO结构为零值和设置结构大小sizeof (FILEINFO)。
如果你知道文件格式,设置FILEINFO。旗帜FILEINFO_FORMATVALID FILEINFO。格式的文件格式。这可以加快L_FileInfo因为LEADTOOLS不会尝试各种过滤器来找出哪些过滤器可以处理文件。
如果你不知道文件格式,但知道原始文件名设置FILEINFO。旗帜FILEINFO_NAMEVALID和设置在FILEINFO.Name原始文件的名字。LEADTOOLS将使用这个作为一个提示,文件格式通常与特定的有关文件扩展名。
调用L_FileInfo函数,传递文件名称,地址的FILEINFO变量,FILEINFO结构作为参数的大小。
从描述的领域获得图像信息FILEINFO结构。

如果传递给FILEINFO_USEFILTERDATA的旗帜L_FileInfo是可能的,函数将返回值过滤数据,可用于加快其他负载或转换功能。看到使用过滤数据加速加载大文件为更多的信息。

FILEINFO_TOTALPAGES和FILEINFO_USEFILTERDATA旗帜可以一起或者艾德。通过两个国旗表明总页数和过滤检索数据。

笔记:

更多的选项可用LOADFILEOPTION结构。
信息加载和保存大型TIFF文件更快,请参考大型TIFF / BigTIFF文件加载和保存。
功能的概要文件的信息,请参考获取和设置文件的信息。
从来没有一个未初始化的FILEINFO结构传递给这个函数。初始化至少FILEINFO是很重要的。uStructSize FILEINFO.Flags。如果FILEINFO。国旗是零,其他结构成员将被忽略。但如果FILEINFO。旗帜不为零,其他成员的一个或多个FILEINFO结构必须正确初始化。

必需的dll和库

LTFIL
上市需要的dll和库,基于工具箱版本,请参考文件包含在您的应用程序。

平台

Win32 x64, Linux。

另请参阅

功能

主题

一个功能列表,使用LOADFILEOPTION或SAVEFILEOPTION结构,参考函数利用LOADFILEOPTION或SAVEFILEOPTION结构。

例子

为完整的示例代码,参考信息的例子。
这个例子得到文件信息并显示在一个消息框。

L_INT FileInfoExample (L_VOID){L_INT nRet;FILEINFO FILEINFO;/ *文件信息结构。* /L_TCHAR szMessage [1024];/ *缓冲区来保存信息为显示。* // * * /获取文件信息memset (&FileInfo 0运算符(FILEINFO));FileInfo。uStructSize =运算符(FileInfo);/ /快速文件信息,使用以下:L_EnableFastFileInfo(真正的);nRet = L_FileInfo (MAKE_IMAGE_PATH(文本(“ImageProcessingDemo \ \ Image3.cmp”&FileInfo)),运算符(FILEINFO), 0, NULL);如果(nRet ! =成功)返回nRet;/ *从FILEINFO格式的消息字符串数据结构* /wsprintf (szMessage文本(“文件名:% s \ n \ n”)文本(“格式:% d \ n \ n”)文本(“宽度:% d \ n \ n”)文本(“高度:% d \ n \ n”)文本(“BitsPerPixel: % d \ n \ n”)文本(“磁盘上的大小:% ld \ n \ n”)文本(“内存大小:% ld \ n \ n”)文本(“压缩:% s”),(L_TCHAR *) FileInfo.Name,FileInfo.Format,FileInfo.Width,FileInfo.Height,FileInfo.BitsPerPixel,(长)FileInfo.SizeDisk,(长)FileInfo.SizeMem,FileInfo (L_TCHAR *)。压缩);/ *显示消息字符串* /对话框(NULL, szMessage文本(“文件信息”),MB_OK);返回成功;}

下载我们的免费评估

帮助21.0.2021.7.5版本

LEADTOOLS光栅成像C API的帮助

介绍

版本历史

开始

文件包含在您的应用程序

文档作者——文件包含您的应用程序

LEADTOOLS光栅成像特性

快速参考

教程

函数引用

回调函数

总结的特性

附录