Difference between revisions of "Formats information"
From XnView Wiki
Line 3: | Line 3: | ||
The gflGetNumberOfFormat function gets the number of formats available in GFL. | The gflGetNumberOfFormat function gets the number of formats available in GFL. | ||
GFL_INT32 gflGetNumberOfFormat( | GFL_INT32 <b>gflGetNumberOfFormat</b>( | ||
void | |||
); | ); | ||
Line 16: | Line 16: | ||
The gflFormatIsSupported function determines if a format is available in GFL. | The gflFormatIsSupported function determines if a format is available in GFL. | ||
GFL_BOOL gflFormatIsSupported( | GFL_BOOL <b>gflFormatIsSupported</b>( | ||
const char* name | |||
); | ); | ||
Line 34: | Line 34: | ||
The gflGetFormatNameByIndex function returns name of a format's index. | The gflGetFormatNameByIndex function returns name of a format's index. | ||
const char* gflGetFormatNameByIndex( | const char* <b>gflGetFormatNameByIndex</b>( | ||
GFL_INT32 index | |||
); | ); | ||
Line 51: | Line 51: | ||
The gflGetFormatIndexByName function returns index of a format's name. | The gflGetFormatIndexByName function returns index of a format's name. | ||
GFL_INT32 gflGetFormatIndexByName( | GFL_INT32 <b>gflGetFormatIndexByName</b>( | ||
const char* name | |||
); | ); | ||
Line 69: | Line 69: | ||
The gflFormatIsReadableByIndex function determines if a format is readable with its index. | The gflFormatIsReadableByIndex function determines if a format is readable with its index. | ||
GFL_BOOL gflFormatIsReadableByIndex( | GFL_BOOL <b>gflFormatIsReadableByIndex</b>( | ||
GFL_INT32 index | |||
); | ); | ||
Line 86: | Line 86: | ||
The gflFormatIsReadableByName function determines if a format is readable with its name. | The gflFormatIsReadableByName function determines if a format is readable with its name. | ||
GFL_BOOL gflFormatIsReadableByName( | GFL_BOOL <b>gflFormatIsReadableByName</b>( | ||
const char * name | |||
); | ); | ||
Line 103: | Line 103: | ||
The gflFormatIsWritableByIndex function determines if a format is writable with its index. | The gflFormatIsWritableByIndex function determines if a format is writable with its index. | ||
GFL_BOOL gflFormatIsWritableByIndex( | GFL_BOOL <b>gflFormatIsWritableByIndex</b>( | ||
GFL_INT32 index | |||
); | ); | ||
Line 120: | Line 120: | ||
The gflFormatIsWritableByName function determines if a format is writable with its name. | The gflFormatIsWritableByName function determines if a format is writable with its name. | ||
GFL_BOOL gflFormatIsWritableByName( | GFL_BOOL <b>gflFormatIsWritableByName</b>( | ||
const char* name | |||
); | ); | ||
Line 137: | Line 137: | ||
The gflGetFormatDescriptionByIndex function returns the label of a format's index. | The gflGetFormatDescriptionByIndex function returns the label of a format's index. | ||
const char* gflGetFormatDescriptionByIndex( | const char* <b>gflGetFormatDescriptionByIndex</b>( | ||
GFL_INT32 index | |||
); | ); | ||
Line 154: | Line 154: | ||
The gflGetFormatDescriptionByName function returns the label of a format's name. | The gflGetFormatDescriptionByName function returns the label of a format's name. | ||
const char* gflGetFormatDescriptionByName( | const char* <b>gflGetFormatDescriptionByName</b>( | ||
const char* name | |||
); | ); | ||
Line 171: | Line 171: | ||
The gflGetDefaultFormatSuffixByIndex function returns the default extension of a format's index. | The gflGetDefaultFormatSuffixByIndex function returns the default extension of a format's index. | ||
const char* gflGetDefaultFormatSuffixByIndex( | const char* <b>gflGetDefaultFormatSuffixByIndex</b>( | ||
GFL_INT32 index | |||
); | ); | ||
Line 188: | Line 188: | ||
The gflGetDefaultFormatSuffixByName function returns the default extension of a format's name. | The gflGetDefaultFormatSuffixByName function returns the default extension of a format's name. | ||
const char* gflGetDefaultFormatSuffixByName( | const char* <b>gflGetDefaultFormatSuffixByName</b>( | ||
const char* name | |||
); | ); | ||
Line 205: | Line 205: | ||
The gflGetFormatInformationByIndex function retrieves all informations of a format's index. | The gflGetFormatInformationByIndex function retrieves all informations of a format's index. | ||
GFL_ERROR gflGetFormatInformationByIndex( | GFL_ERROR <b>gflGetFormatInformationByIndex</b>( | ||
GFL_INT32 index, | |||
GFL_FORMAT_INFORMATION* informations | |||
); | ); | ||
Line 225: | Line 225: | ||
The gflGetFormatInformationByName function retrieves all informations of a format's name. | The gflGetFormatInformationByName function retrieves all informations of a format's name. | ||
GFL_ERROR gflGetFormatInformationByName( | GFL_ERROR <b>gflGetFormatInformationByName</b>( | ||
const char* name, | |||
GFL_FORMAT_INFORMATION* informations | |||
); | ); | ||
Revision as of 13:13, 23 September 2009
gflGetNumberOfFormat
The gflGetNumberOfFormat function gets the number of formats available in GFL.
GFL_INT32 gflGetNumberOfFormat( void );
Return value
- Number of formats.
gflFormatIsSupported
The gflFormatIsSupported function determines if a format is available in GFL.
GFL_BOOL gflFormatIsSupported( const char* name );
Parameters
- name
- Pointer to a null-terminated string that contains the name of the format.
Return value
- GFL_FALSE or GFL_TRUE.
gflGetFormatNameByIndex
The gflGetFormatNameByIndex function returns name of a format's index.
const char* gflGetFormatNameByIndex( GFL_INT32 index );
Parameters
- index
- Index of the format.
Return value
- Pointer to a null-terminated string that contains name of the format. NULL if there is an error.
gflGetFormatIndexByName
The gflGetFormatIndexByName function returns index of a format's name.
GFL_INT32 gflGetFormatIndexByName( const char* name );
Parameters
- name
- Pointer to a null-terminated string that contains the name of the format.
Return value
- Pointer to a null-terminated string that contains the name of the format. NULL if there is an error.
gflFormatIsReadableByIndex
The gflFormatIsReadableByIndex function determines if a format is readable with its index.
GFL_BOOL gflFormatIsReadableByIndex( GFL_INT32 index );
Parameters
- index
- Index of format.
Return value
- GFL_FALSE or GFL_TRUE.
gflFormatIsReadableByName
The gflFormatIsReadableByName function determines if a format is readable with its name.
GFL_BOOL gflFormatIsReadableByName( const char * name );
Parameters
- name
- Pointer to a null-terminated string that contains the name of the format.
Return value
- GFL_FALSE or GFL_TRUE.
gflFormatIsWritableByIndex
The gflFormatIsWritableByIndex function determines if a format is writable with its index.
GFL_BOOL gflFormatIsWritableByIndex( GFL_INT32 index );
Parameters
- index
- Index of the format.
Return value
- GFL_FALSE or GFL_TRUE.
gflFormatIsWritableByName
The gflFormatIsWritableByName function determines if a format is writable with its name.
GFL_BOOL gflFormatIsWritableByName( const char* name );
Parameters
- name
- Pointer to a null-terminated string that contains the name of the format.
Return value
- GFL_FALSE or GFL_TRUE.
gflGetFormatDescriptionByIndex
The gflGetFormatDescriptionByIndex function returns the label of a format's index.
const char* gflGetFormatDescriptionByIndex( GFL_INT32 index );
Parameters
- index
- Index of the format.
Return value
- Pointer to a null-terminated string that contains the label. NULL if there is an error.
gflGetFormatDescriptionByName
The gflGetFormatDescriptionByName function returns the label of a format's name.
const char* gflGetFormatDescriptionByName( const char* name );
Parameters
- name
- Pointer to a null-terminated string that contains the name of the format.
Return value
- Pointer to a null-terminated string that contains the label. NULL if there is an error.
gflGetDefaultFormatSuffixByIndex
The gflGetDefaultFormatSuffixByIndex function returns the default extension of a format's index.
const char* gflGetDefaultFormatSuffixByIndex( GFL_INT32 index );
Parameters
- index
- Index of the format.
Return value
- Pointer to a null-terminated string that contains the default extension. NULL if there is an error.
gflGetDefaultFormatSuffixByName
The gflGetDefaultFormatSuffixByName function returns the default extension of a format's name.
const char* gflGetDefaultFormatSuffixByName( const char* name );
Parameters
- name
- Pointer to a null-terminated string that contains the name of the format.
Return value
- Pointer to a null-terminated string that contains the default extension. NULL if there is an error.
gflGetFormatInformationByIndex
The gflGetFormatInformationByIndex function retrieves all informations of a format's index.
GFL_ERROR gflGetFormatInformationByIndex( GFL_INT32 index, GFL_FORMAT_INFORMATION* informations );
Parameters
- index
- Index of the format.
- informations
- Pointer to a GFL_FORMAT_INFORMATION structure.
Return value
- The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.
gflGetFormatInformationByName
The gflGetFormatInformationByName function retrieves all informations of a format's name.
GFL_ERROR gflGetFormatInformationByName( const char* name, GFL_FORMAT_INFORMATION* informations );
Parameters
- name
- Pointer to a null-terminated string that contains the name of the format.
- informations
- Pointer to a GFL_FORMAT_INFORMATION structure.
Return value
- The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.