index.htmlMain Page    classes.htmlAlphabetical List    annotated.htmlData Structures    files.htmlFile List    functions.htmlData Fields    globals.htmlGlobals    wmf.c File Reference
Functions
types_8h.html#a5wmf_error_t  wmf_8c.html#a2wmf_api_create  ( types_8h.html#a22wmfAPI  **API_return, unsigned long flags, types_8h.html#a21wmfAPI_Options  *options) types_8h.html#a5wmf_error_t  wmf_8c.html#a3wmf_api_destroy  ( types_8h.html#a22wmfAPI  *API) char * wmf_8c.html#a4wmf_help  () Function Documentation
  
    
      
        
          
 types_8h.html#a5wmf_error_t  wmf_api_create           
(           
types_8h.html#a22wmfAPI  **           
  API_return,         
        
          
          
          
unsigned long           
  flags,         
        
          
          
          
types_8h.html#a21wmfAPI_Options  *           
  options         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Creates and initializes an instance of the 
libwmf library for a specified device layer.Parameters: API_return pointer to a wmfAPI* (the API handle use henceforth) 
flags bitwise OR of WMF_OPT_ options 
options pointer to wmfAPI_Options structure
This is the first and necessary step when using libwmf. Options are passed via the wmfAPI_Options structure and flags. wmf_api_create allocates the wmfAPI structure and initializes the color and font tables, the metafile player, and the device layer. If successful then the pointer to the wmfAPI structure is returned via API_return, otherwise all allocated memory is released and the library exits with an appropriate error.
Returns: The error state of the library: 
wmf_E_None indicates successful creation and initialization of the library, and *API_return will be non-zero. For any other error value *API_return will be zero.       
  
    
      
        
          
 types_8h.html#a5wmf_error_t  wmf_api_destroy           
(           
types_8h.html#a22wmfAPI  *           
  API                    
)           
        
      
    
  
  
    
       
    
    
Close the device layer, if open, and release all allocated memory attached to the memory manager.
Parameters: API the API handle
Returns: The final error state of the library. 
      
  
    
      
        
          
 char* wmf_help           
(           
void           
                     
)           
        
      
    
  
  
    
       
    
    
 
Additional wmf-related options:
  --wmf-error[=yes|no]            switch for error reports.
  --wmf-debug[=yes|no]            switch for debug reports, if any.
  --wmf-ignore-nonfatal[=yes|no]  switch to ignore (some) non-fatal errors.
  --wmf-diagnostics               emit diagnostic information.
  --wmf-fontdir=<path>            add <path> to list of font directories.
  --wmf-sys-fonts                 use system fonts, if any found.
  --wmf-sys-fontmap=<file>        use system xml-fontmap file <file>.
  --wmf-xtra-fonts                use non-system fonts, if any found.
  --wmf-xtra-fontmap=<file>       use non-system xml-fontmap file <file>.
  --wmf-gs-fontmap=<file>         use ghostscript file <file>.
  --wmf-write=<file>              write metafile to <file>.
Report bugs to <http://www.wvware.com/>.
Returns: Returns the above as a string. 
      
Generated on Tue Dec 10 19:53:52 2002 for libwmf by
http://www.doxygen.org/index.htmldoxygen 1.2.18 