typedef struct _LOADSVGOPTIONS
{
L_UINT uStructSize; // use sizeof(LOADSVGOPTIONS)
L_UINT32 uFlags; // L_LOADSVGOPTIONS_XXX
L_SvgNodeHandle SvgHandle; // Load into this SVG
L_UINT32 uMaximumElements; // Maximum number of elements, if the SVG has more than this value then load will fail with error ERROR_USER_ABORT
}
LOADSVGOPTIONS, *pLOADSVGOPTIONS;
The LOADSVGOPTIONS structure, which is used by the L_LoadSvg function, allows you to specify options for loading files as SVG and also receives the loaded SVG data.
Size of this structure in bytes, for versioning. Use the sizeof() operator to calculate this value.
Possible values:
Value | Meaning |
---|---|
L_LOADSVGOPTIONS_NONE | [0x00] the created svg file may have text only (No polydraw text, the file still may have images or shapes). |
L_LOADSVGOPTIONS_ALLOWPOLYLINETEXT | [0x01] the created svg file may have text represented as polyline or text. |
L_LOADSVGOPTIONS_DROPSHAPES | [0x02] the created svg will drop all the shapes. |
L_LOADSVGOPTIONS_DROPIMAGES | [0x04] the created svg will drop all the images. |
L_LOADSVGOPTIONS_DROPTEXT | [0x08] the created svg will drop all the text. |
L_LOADSVGOPTIONS_IGNOREXMLPARSINGERRORS | [0x20] Load SVG documents that contain incorrect XML data. |
SVG document representation of the page.
Maximum number of elements, if the SVG has more than this value then load will fail with error ERROR_USER_ABORT
Creating an SVG document with text only is desired in certain scenarios. For example, if the application loads SVG document to parse the text values and store them in an external database for text search purposes, then setting the value of uFlags to L_LOADSVGOPTIONS_DROPIMAGES | L_LOADSVGOPTIONS_DROPSHAPES will speed up the loading operation and elements not required will be discarded. This is especially useful if the original SVG document contains image elements which may use a lot of memory and disk space.
For more information, refer to Working With SVG.