IM_INIT_WORLD

Section: C Library Functions (3)
Updated: 11 April 1990
Index Return to Main Contents
 

NAME

im_init_world, im_get_option_group - start up VIPS  

SYNOPSIS

#include <vips/vips.h>

int im_init_world( const char *argv0 )
GOptionGroup *im_get_option_group( void );  

DESCRIPTION

im_init_world(3) starts up the VIPS library. It:


 - initialises any libraries that VIPS is using, including GObject
 - starts up the threading system
 - guesses where the VIPS data files are and sets up i18n
 - loads any plugins from libdir/vips-x.x

The argv0 argument is the value of argv[0] your program was passed by the host operating system. VIPS uses this with im_guess_prefix(3) to try to find the various VIPS data files.

 

EXAMPLE


  int
  main( int argc, char **argv )
  {
    if( im_init_world( argv[0] ) )
      error_exit( "unable to start VIPS" );


    return( 0 );
  }

im_get_option_group(3) returns a GOptionGroup containing various VIPS command-line options. It can be used with GOption to help parse argc/argv.

 

SEE ALSO

im_guess_prefix(3), im_guess_libdir(3), GOption(3)  

COPYRIGHT

Birkbeck College and the National Gallery (c) 1994