在这个话题▼

L_ReadFileCommentExt

# include“l_bitmap.h”

L_LTFIL_APIL_INTL_ReadFileCommentExt (pszFile、uType pComments, pbuf uLength, pLoadOptions)

得到一个评论,一群评论或几组从文件的评论。

参数

L_TCHAR* pszFile

字符串包含FlashPix文件名。

L_UINTuType

评论的类型。指类型的文件的评论。一群评论可以获得如CMNT_FPXSUMMARYINFORMATION,或者超过一组的评论可能被使用或在检索CMNT_FPXSUMMARYINFORMATION | CMNT_FPXFILESOURCEGROUP,或全部使用CMNT_ALL评论可以获得。看到下面列出的例子。为更多的信息关于FlashPix文件评论,看到FlashPix文件注释。

pFILECOMMENTSpComments

指针指向一个结构,包含一个数据值指示注释存储的数量,一个指向数组的指针反过来指向个人评论,和一个整数数组指针指示每个评论存储的大小。

L_UCHAR* pbuf

指向缓冲区的指针,将所有的评论

L_UINT* uLength

指向缓冲区的大小,将所有的评论。

pLOADFILEOPTIONpLoadOptions

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

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

目前这个功能仅适用于FlashPix格式文件。

函数调用来检索的基本秩序的评论如下:

得到评论的大小L_GetFileCommentSize。
分配相应的缓冲区大小。
与L_ReadFileCommentExt阅读注释。
免费的缓冲区。

写评论一个文件,所有的评论你想增加一个新的文件必须设置。L_SetComment单独设置每个评论,但不保存对文件的评论,它准备下保存的值。一旦设置所有评论,评论是使用任何函数保存文件,保存等L_SaveFile或L_SaveBitmap当创建一个新文件。如果你想改变一个评论在现有文件,使用L_WriteFileCommentExt。

必需的dll和库

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

平台

Win32 x64, Linux。

另请参阅

功能

主题

光栅图像功能:保持文件的评论
加载和保存图像
列表的函数,利用LOADFILEOPTION或SAVEFILEOPTION结构,参考函数利用LOADFILEOPTION或SAVEFILEOPTION结构。

例子

类型定义结构体_FPXCOMMENT_HEADER_ELEMENT{L_UINT32大小;L_UINT32类型;}FPXCOMMENT_HEADER_ELEMENT;类型定义结构体_FPXCOMMENT_HEADER_ARRAY{L_UINT32大小;L_UINT32类型;L_UINT32元素;}FPXCOMMENT_HEADER_ARRAY;L_INT ReadFileCommentExtExample (L_VOID){L_INT nRet;L_UINT32 uLength = 0;L_TCHAR szMessage [80];L_UCHAR * pTextToGet;L_FLOAT * pFloat;L_UINT32 * pLong;L_TCHAR * pString;FPXCOMMENT_HEADER_ARRAY * pArray;FPXCOMMENT_HEADER_ELEMENT * pElement;FILECOMMENTS FILECOMMENTS;L_UCHAR *如此[CMNT_LAST + 1];L_UINT uSize [CMNT_LAST + 1];L_TCHAR szFileName [256] = MAKE_IMAGE_PATH(文本(“IMAGE1.FPX”));/ /读一组评论:/ *确定尺寸,在字节,所需的批评论。* /nRet = L_GetFileCommentSize (szFileName CMNT_FPXTITLE &uLength, NULL);如果(nRet ! =成功)返回nRet;如果(uLength = = 0)返回ERROR_INV_PARAMETER;/ *分配一个缓冲区的大小根据获得的评论nRet = L_GetFileCommentSize和存储在uLength。* /pTextToGet = (L_UCHAR *) malloc (uLength);/ *初始化FileComments结构。* /FileComments。数= CMNT_LAST + 1;FileComments。指针=如此;FileComments。大小= uSize;/ *群评论读到缓冲区。* /nRet = L_ReadFileCommentExt (szFileName CMNT_FPXTITLE、&FileComments pTextToGet, &uLength, NULL);如果(nRet ! =成功){免费(pTextToGet);返回nRet;}/ *从组织中提取所需的个人评论* /pArray = (FPXCOMMENT_HEADER_ARRAY *)如此[CMNT_FPXTITLE];pElement = (FPXCOMMENT_HEADER_ELEMENT *)如此[CMNT_FPXSECURITY];/ *测试存在一定的注释。如果他们存在,打印它们。* /如果((pArray ! = NULL) & & (pElement ! = NULL)){pString = (L_TCHAR *) (pArray + 1);pLong = (L_UINT32 *) (pElement + 1);/ / wsprintf (szMessage、文本(“% hs - % ul”), pString, * pLong);wsprintf (szMessage文本(“% ul”),* pLong);对话框(NULL, szMessage文本(“标题与安全”),MB_OK);}/ *免费的缓冲区。* /免费(pTextToGet);/ /读团体的评论:uLength = 0;nRet = L_GetFileCommentSize (szFileName CMNT_FPXSUMMARYINFORMATION |CMNT_FPXINTELLECTUALPROPERTYGROUP &uLength, NULL);如果(nRet ! =成功)返回nRet;如果(uLength ! = 0){pTextToGet = (L_UCHAR *) malloc (uLength);FileComments。数= CMNT_LAST + 1;FileComments。指针=如此;FileComments。大小= uSize;nRet = L_ReadFileCommentExt (szFileName CMNT_FPXSUMMARYINFORMATION | CMNT_FPXINTELLECTUALPROPERTYGROUP, &FileComments, pTextToGet, &uLength, NULL);如果(nRet ! =成功)返回nRet;pArray = (FPXCOMMENT_HEADER_ARRAY *)如此[CMNT_FPXTITLE];pElement = (FPXCOMMENT_HEADER_ELEMENT *)如此[CMNT_FPXEXPOSURETIME];如果((pArray ! = NULL) & & (pElement ! = NULL)){pString = (L_TCHAR *) (pArray + 1);pFloat = (L_FLOAT *) (pElement + 1);_stprintf_s(80年szMessage文本(“% % f hs -”)、pString * pFloat);对话框(NULL, szMessage文本(“标题和曝光时间”),MB_OK);}免费(pTextToGet);/ /读了所有的评论:uLength = 0;nRet = L_GetFileCommentSize (MAKE_IMAGE_PATH(文本(“IMAGE1.FPX”))、CMNT_ALL &uLength, NULL);如果(nRet ! =成功)返回nRet;如果(uLength ! = 0){pTextToGet = (L_UCHAR *) malloc (uLength);FileComments。数= CMNT_LAST + 1;FileComments。指针=如此;FileComments。大小= uSize;nRet = L_ReadFileCommentExt (szFileName CMNT_ALL、&FileComments pTextToGet, &uLength, NULL);如果(nRet ! =成功){免费(pTextToGet);返回nRet;}pArray = (FPXCOMMENT_HEADER_ARRAY *)如此[CMNT_FPXTITLE];pElement = (FPXCOMMENT_HEADER_ELEMENT *)如此[CMNT_FPXEXPOSURETIME];如果((pArray ! = NULL) & & (pElement ! = NULL)){pString = (L_TCHAR *) (pArray + 1);pFloat = (L_FLOAT *) (pElement + 1);_stprintf_s(80年szMessage文本(“% % f hs -”)、pString * pFloat);对话框(NULL, szMessage文本(“标题和曝光时间”),MB_OK);}免费(pTextToGet);}}返回成功;}

下载我们的免费评估

帮助21.0.2021.7.5版本

LEADTOOLS光栅成像C API的帮助

介绍

版本历史

开始

文件包含在您的应用程序

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

LEADTOOLS光栅成像特性

快速参考

教程

函数引用

回调函数

总结的特性

附录