Actions

Difference between revisions of "Initialisation"

From XnView Wiki

m (Reverted edits by Akajavim (Talk) to last revision by WikiSysop)
 
(9 intermediate revisions by 3 users not shown)
Line 4: Line 4:


  GFL_ERROR <b>gflLibraryInit</b>(
  GFL_ERROR <b>gflLibraryInit</b>(
&nbsp;&nbsp;void
  void
  );
  );


Line 13: Line 13:
'''See also'''  
'''See also'''  


:[[#gflLibraryExit|gflLibraryExit]], [[Error|gflGetErrorString]]
:[[#gflLibraryExit|gflLibraryExit]], [[#gflSetPluginsPathname|gflSetPluginsPathname]], [[Error|gflGetErrorString]]




Line 21: Line 21:


  GFL_ERROR <b>gflLibraryInitEx</b>(
  GFL_ERROR <b>gflLibraryInitEx</b>(
&nbsp;&nbsp;GFL_ALLOC_CALLBACK alloc_callback,   
  GFL_ALLOC_CALLBACK alloc_callback,   
&nbsp;&nbsp;GFL_REALLOC_CALLBACK realloc_callback,   
  GFL_REALLOC_CALLBACK realloc_callback,   
&nbsp;&nbsp;GFL_FREE_CALLBACK free_callback,   
  GFL_FREE_CALLBACK free_callback,   
&nbsp;&nbsp;void * user_parms
  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 read user function. (void (GFLAPI *)( void * ptr, void * user_parms ))  
::Pointer to a free user function. (void (GFLAPI *)( void * ptr, void * user_parms ))  
:user_parms  
:user_parms  
::User parameter used in callback.  
::User parameters used in callback.  


'''Return value'''  
'''Return value'''  
Line 44: Line 44:
'''See also'''  
'''See also'''  


:[[#gflLibraryExit|gflLibraryExit]], [[Error|gflGetErrorString]]
:[[#gflLibraryExit|gflLibraryExit]], [[#gflSetPluginsPathname|gflSetPluginsPathname]], [[Error|gflGetErrorString]]
 


== gflLibraryExit ==
== gflLibraryExit ==
Line 52: Line 51:


  void <b>gflLibraryExit</b>(
  void <b>gflLibraryExit</b>(
&nbsp;&nbsp;void
  void
  );
  );


Line 64: Line 63:
The gflGetVersion function returns the GFL's version.  
The gflGetVersion function returns the GFL's version.  


  const char* gflGetVersion(
  const char* <b>gflGetVersion</b>(
&nbsp;void
  void
  );
  );


Line 77: Line 76:
The gflSetPluginsPathname function allows to set a Plugin's folder. Be careful, this function must be called before gflLibraryInit.  
The gflSetPluginsPathname function allows to set a Plugin's folder. Be careful, this function must be called before gflLibraryInit.  


  void gflSetPluginsPathname(
  void <b>gflSetPluginsPathname</b>(
&nbsp;const char* pathname
  const char* pathname
  );
);


'''Parameters'''
'''Parameters'''
Line 87: Line 86:


'''See also'''  
'''See also'''  
:[[#gflLibraryInit|gflLibraryInit]], [[#gflLibraryExit|gflLibraryExit]]


:[[#gflLibraryInit|gflLibraryInit]], [[#gflLibraryExit|gflLibraryExit]]
'''Remark'''
:gflSetPluginsPathnameW exists for the windows unicode version of GFLSDK
 
[[Category: GFLSDK Reference Manual]]

Latest revision as of 15: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

gflLibraryExit, gflSetPluginsPathname, gflGetErrorString


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, gflSetPluginsPathname, gflGetErrorString

gflLibraryExit

The gflLibraryExit function frees the library.

void gflLibraryExit(
  void
);

See also

gflLibraryInit, gflGetErrorString


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

gflLibraryInit, gflLibraryExit

Remark

gflSetPluginsPathnameW exists for the windows unicode version of GFLSDK