Actions

Difference between revisions of "Formats information"

From XnView Wiki

m (Reverted edits by Akajavim (Talk) to last revision by WikiSysop)
 
(5 intermediate revisions by 3 users not shown)
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>(
&nbsp;void
  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>(
&nbsp;const char* name
  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>(
&nbsp;GFL_INT32 index
  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>(
&nbsp;const char* name
  const char* name
  );
  );


Line 62: Line 62:
'''Return value'''
'''Return value'''


:Pointer to a null-terminated string that contains the name of the format. NULL if there is an error.  
:Index of the format. -1 if the format string does not exist.
 


== gflFormatIsReadableByIndex ==
== gflFormatIsReadableByIndex ==
Line 69: Line 68:
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>(
&nbsp;GFL_INT32 index
  GFL_INT32 index
  );
  );


Line 86: Line 85:
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>(
&nbsp;const char * name
  const char* name
  );
  );


Line 97: Line 96:
'''Return value'''
'''Return value'''
:GFL_FALSE or GFL_TRUE.
:GFL_FALSE or GFL_TRUE.


== gflFormatIsWritableByIndex ==
== gflFormatIsWritableByIndex ==
Line 103: Line 101:
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>(
&nbsp;GFL_INT32 index
  GFL_INT32 index
  );
  );


Line 120: Line 118:
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>(
&nbsp;const char* name
  const char* name
  );
  );


Line 137: Line 135:
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>(
&nbsp;GFL_INT32 index
  GFL_INT32 index
  );
  );


Line 154: Line 152:
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>(
&nbsp;const char* name
  const char* name
  );
  );


Line 171: Line 169:
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>(
&nbsp;GFL_INT32 index
  GFL_INT32 index
  );
  );


Line 188: Line 186:
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>(
&nbsp;const char* name
  const char* name
  );
  );


Line 205: Line 203:
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>(
&nbsp;GFL_INT32 index,   
  GFL_INT32 index,   
&nbsp;GFL_FORMAT_INFORMATION* informations
  GFL_FORMAT_INFORMATION* informations
  );
  );


Line 225: Line 223:
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>(
&nbsp;const char* name,   
  const char* name,   
&nbsp;GFL_FORMAT_INFORMATION* informations
  GFL_FORMAT_INFORMATION* informations
  );
  );


Line 239: Line 237:
'''Return value'''
'''Return value'''
:The function returns GFL_NO_ERROR if it is successful or a value of [[Error|GFL_ERROR]].
:The function returns GFL_NO_ERROR if it is successful or a value of [[Error|GFL_ERROR]].
[[Category: GFLSDK Reference Manual]]

Latest revision as of 15:26, 22 November 2010

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

Index of the format. -1 if the format string does not exist.

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.