LFile: FileConvert

# include“ltwrappr.h”

静态L_INTLFile::FileConvert(pszFileDst, pszFileSrc, nType, nWidth, nHeight, nBitsPerPixel, nQFactor, pLoadFileOption=NULL, pSaveFileOption=NULL, pFileInfo)

将图像文件从一种格式转换为另一种格式,以新格式创建新文件。

参数

L_TCHAR* pszFileDst

包含输出文件名的字符串。

L_TCHAR* pszFileSrc

包含输入文件名的字符串。

L_INTnType

输出文件格式。有效值请参见应用程序中包含的文件

L_INTnWidth

输出文件的新宽度。如果这个值不为0,那么输出文件将被调整为nWidth值。如果不希望调整输出文件的大小,则使用0值。

L_INTnHeight

输出文件的新高度。如果这个值不为0,那么输出文件将被调整为nHeight值。如果不希望调整输出文件的大小,则使用0值。

L_INTnBitsPerPixel

输出文件像素深度。注意,并不是所有的像素位都适用于所有的文件格式。有效值请参见应用程序中包含的文件

L_INTnQFactor

此参数用于将图像保存为支持质量因子(QFactor)的文件格式。QFactor是一个决定压缩过程中损失程度的数字。

可能的值请参见压缩质量因子

pLOADFILEOPTIONpLoadFileOption

指向可选扩展加载选项的指针。传递NULL以使用默认的加载选项。

pSAVEFILEOPTIONpSaveFileOption

指向可选扩展保存选项的指针。传递NULL以使用默认的保存选项。

pFILEINFOpFileInfo

指向可选扩展加载选项的指针。传递NULL以使用默认的加载选项。

如果对文件一无所知,则为该参数传递NULL,或声明一个类型变量FILEINFO并设置FILEINFO。标记为0,然后在此参数中传递FILEINFO结构的地址。在这种情况下,如果传递了FILEINFO结构的地址,则FILEINFO结构将使用的结果进行更新LFile: GetInfo

如果只知道文件类型,则设置pFileInfo。Format为文件类型,设置pFileInfo。指向FILEINFO_FORMATVALID的标志。如果之前已经调用了LFile::GetInfo,但是影响加载图像大小的值已经更改(例如,通过调用LFileSettings: SetPCDResolutionLFileSettings: SetWMFResolution).在这种情况下,由pFileInfo指向的FILEINFO结构将被LFile::GetInfo的结果更新。

如果在调用此函数之前已经调用了LFile::GetInfo,并且没有对LFile::GetInfo填充的结构的内容进行任何更改,则可以将填充的FILEINFO结构的地址传递给该参数。在本例中,FILEINFO。Flags成员应该设置为FILEINFO_INFOVALID。LFile::GetInfo函数将设置FILEINFO。指向FILEINFO_INFOVALID的标志。在这种情况下,加载会更快,因为这个函数不需要查询文件类型的文件过滤器。

返回

价值 意义
成功 活动很成功。
< 1 发生错误。指返回代码

评论

如果转换为较低的每像素位数格式,此函数将自动优化颜色。例如,当将一个24位文件(1600万种颜色)转换为8位文件(256种颜色)时,该函数选择最好的256种颜色来表示24位图像。

注意,这是一个高级函数,从所有可能的格式转换为所有可能的格式。

若要在执行此函数期间更新状态栏或检测用户中断,请参阅LBase: EnableStatusCallBack

请注意:你不应该传递一个未初始化的FILEINFO结构转换为此函数。

必需的dll和库

平台

x64 Win32。

另请参阅

功能

主题

例子

示例请参见LFile:负载

栅格成像c++类库帮助
188金宝搏的网址客服|支持|联系我们|知识产权公告
©1991 - 2021领德科技有限公司版权所有。