FILEINFO
The FILEINFO structure, which is loaded by the LFile::GetInfo function, provides information about the specified file.
Note: The LTFIL.H header file describes the entire FILEINFO structure.
|
Member |
Data Type |
Description |
|
|
Format |
File format. For possible values, refer to Summary of Supported File Formats. |
||
|
Name[_MAX_FNAME+_MAX_EXT] |
A character array containing the null-terminated string that is the file name. The name is truncated if it exceeds _MAX_FNAME + _MAX_EXT characters. |
||
|
Width |
Image width, in pixels. |
||
|
Height |
Image height, in pixels. |
||
|
BitsPerPixel |
Bits per pixel. |
||
|
SizeDisk |
Size of the file on disk (in bytes). |
||
|
SizeMem |
Amount of memory (in bytes) required to load the file. |
||
|
Compression[20] |
A 20-character array containing the null-terminated string that describes the compression method. |
||
|
ViewPerspective |
Where the beginning of the image is stored. Valid values are TOP_LEFT, BOTTOM_LEFT, TOP_RIGHT, BOTTOM_RIGHT, TOP_LEFT90, and TOP_LEFT270. For descriptions, refer to Accounting for View Perspective. |
||
|
Order |
Color order of the bitmap. This field is meaningful if the image does not have a palette. It indicates whether the color values are in red-green-blue or blue-green-red order. Possible values are ORDER_RGB, ORDER_BGR and ORDER_GRAY. |
||
|
PageNumber |
The page number in a multipage file. To determine the total number of pages in a file, call LFile::GetInfo with uFlags set to FILEINFO_TOTALPAGES. |
||
|
TotalPages |
The total number of pages present in a file. To update this field, call LFile::GetInfo with uFlags set to FILEINFO_TOTALPAGES. If you do not want this field updated, call LFile::GetInfo with uFlags set to 0. |
||
|
XResolution |
Horizontal resolution, in dots per inch. Some file formats save this value in the file header. |
||
|
YResolution |
Vertical resolution, in dots per inch. Some file formats save this value in the file header. |
||
|
Flags |
For possible values, refer to FILEINFO Flags. |
||
|
GlobalLoop |
Global animation loop count. 0 = infinity. This field is valid only if the FILEINFO_HAS_GLOBALLOOP flag is set. |
||
|
GlobalWidth |
Global width for animation playback |
||
|
GlobalHeight |
Global height for animation playback |
||
|
GlobalBackground |
COLORREF |
Global background color for animation playback (FILEINFO Flags) |
|
|
GlobalPalette[256] |
RGBQUAD |
Global palette for animation playback (FILEINFO Flags). |
|
|
IFD |
Offset within a TIFF file where a page starts. This member is updated when Lfile::GetInfo is called. |
||
|
Layers |
Number of layers in the file. If this value is 0, then the file does not contain any layers. Only PSD files can have layers. |
||
|
ColorSpace |
Color space of the file. Possible values are: |
||
|
|
|
Value |
Meaning |
|
|
|
COLORSPACE_BGR |
[0] Color space is RGB or BGR |
|
|
|
COLORSPACE_YUV |
[1] Color space is YUV or YCbCr |
|
|
|
COLORSPACE_CMYK |
[2] Color space is CMYK |
|
|
|
COLORSPACE_CIELAB |
[3] Color space is CIELab |
Comments
pFILEINFO is a pointer to a FILEINFO structure. Where the function parameter type is pFILEINFO, you can declare a FILEINFO variable, update the structure's fields, and pass the variable's address in the parameter. Declaring a pFILEINFO variable is necessary only if your program requires a pointer.
Note: For more information about loading and saving large TIFF files faster, refer to Loading and Saving Large TIFF Files.
Please note that if FILEINFO.Format is FILE_JPEG or FILE_TIF_JPEG and FILEINFO.BitsPerPixel is 8, then the image is 4:0:0 color space, not 4:4:4 color space.
Currently only PSD files support layers.