Difference between revisions of "Initialisation"
From XnView Wiki
| (7 intermediate revisions by 3 users not shown) | |||
| Line 4: | Line 4: | ||
GFL_ERROR <b>gflLibraryInit</b>( | GFL_ERROR <b>gflLibraryInit</b>( | ||
void | |||
); | ); | ||
| Line 21: | Line 21: | ||
GFL_ERROR <b>gflLibraryInitEx</b>( | GFL_ERROR <b>gflLibraryInitEx</b>( | ||
GFL_ALLOC_CALLBACK alloc_callback, | |||
GFL_REALLOC_CALLBACK realloc_callback, | |||
GFL_FREE_CALLBACK free_callback, | |||
void * user_parms | |||
); | ); | ||
| Line 34: | Line 34: | ||
::Pointer to a read user function. (void * (GFLAPI *)( void * ptr, GFL_UINT32 new_size, void * user_parms )) | ::Pointer to a read user function. (void * (GFLAPI *)( void * ptr, GFL_UINT32 new_size, void * user_parms )) | ||
:free_callback | :free_callback | ||
::Pointer to a | ::Pointer to a free user function. (void (GFLAPI *)( void * ptr, void * user_parms )) | ||
:user_parms | :user_parms | ||
::User | ::User parameters used in callback. | ||
'''Return value''' | '''Return value''' | ||
| Line 45: | Line 45: | ||
:[[#gflLibraryExit|gflLibraryExit]], [[#gflSetPluginsPathname|gflSetPluginsPathname]], [[Error|gflGetErrorString]] | :[[#gflLibraryExit|gflLibraryExit]], [[#gflSetPluginsPathname|gflSetPluginsPathname]], [[Error|gflGetErrorString]] | ||
== gflLibraryExit == | == gflLibraryExit == | ||
| Line 52: | Line 51: | ||
void <b>gflLibraryExit</b>( | void <b>gflLibraryExit</b>( | ||
void | |||
); | ); | ||
| Line 65: | Line 64: | ||
const char* <b>gflGetVersion</b>( | const char* <b>gflGetVersion</b>( | ||
void | |||
); | ); | ||
| Line 78: | Line 77: | ||
void <b>gflSetPluginsPathname</b>( | void <b>gflSetPluginsPathname</b>( | ||
const char* pathname | |||
); | |||
'''Parameters''' | '''Parameters''' | ||
| Line 87: | Line 86: | ||
'''See also''' | '''See also''' | ||
:[[#gflLibraryInit|gflLibraryInit]], [[#gflLibraryExit|gflLibraryExit]] | |||
:[[ | '''Remark''' | ||
:gflSetPluginsPathnameW exists for the windows unicode version of GFLSDK | |||
[[Category: GFLSDK Reference Manual]] | |||
Latest revision as of 16:25, 22 November 2010
gflLibraryInit
The gflLibraryInit function initialize the library. Must be used before call of GFL's functions.
GFL_ERROR gflLibraryInit( void );
Return value
- The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.
See also
gflLibraryInitEx
The gflLibraryInitEx function initialize the library. Must be used before call of GFL's functions.
GFL_ERROR gflLibraryInitEx( GFL_ALLOC_CALLBACK alloc_callback, GFL_REALLOC_CALLBACK realloc_callback, GFL_FREE_CALLBACK free_callback, void * user_parms );
Parameters
- alloc_callback
- Pointer to an alloc user function. (void * (GFLAPI *)( GFL_UINT32 size, void * user_parms ))
- realloc_callback
- Pointer to a read user function. (void * (GFLAPI *)( void * ptr, GFL_UINT32 new_size, void * user_parms ))
- free_callback
- Pointer to a free user function. (void (GFLAPI *)( void * ptr, void * user_parms ))
- user_parms
- User parameters used in callback.
Return value
- The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.
See also
gflLibraryExit
The gflLibraryExit function frees the library.
void gflLibraryExit( void );
See also
gflGetVersion
The gflGetVersion function returns the GFL's version.
const char* gflGetVersion( void );
Return value
- Pointer to a null-terminated string that contains version of GFL.
gflSetPluginsPathname
The gflSetPluginsPathname function allows to set a Plugin's folder. Be careful, this function must be called before gflLibraryInit.
void gflSetPluginsPathname( const char* pathname );
Parameters
- pathname
- Pointer to a null-terminated string that contains the pathname of plugins.
See also
Remark
- gflSetPluginsPathnameW exists for the windows unicode version of GFLSDK