index.html
Main Page
classes.html
Alphabetical List
annotated.html
Data Structures
files.html
File List
functions.html
Data Fields
globals.html
Globals
wmf.c File Reference
Functions
types_8h.html#a5
wmf_error_t
wmf_8c.html#a2
wmf_api_create
(
types_8h.html#a22
wmfAPI
**API_return, unsigned long flags,
types_8h.html#a21
wmfAPI_Options
*options)
types_8h.html#a5
wmf_error_t
wmf_8c.html#a3
wmf_api_destroy
(
types_8h.html#a22
wmfAPI
*API)
char *
wmf_8c.html#a4
wmf_help
()
Function Documentation
types_8h.html#a5
wmf_error_t
wmf_api_create
(
types_8h.html#a22
wmfAPI
**
API_return
,
unsigned long
flags
,
types_8h.html#a21
wmfAPI_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#a5
wmf_error_t
wmf_api_destroy
(
types_8h.html#a22
wmfAPI
*
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.html
doxygen
1.2.18
