L_SvgGetBounds

#include "l_bitmap.h"

L_LTSVG_API L_INT L_SvgGetBounds(flatDocHandle, bounds, structSize)

Gets the physical (pixel) bounds and resolution of the specified SVG document.

Parameters

const L_SvgNodeHandle flatDocHandle

The SVG document handle from which the bounds should be retrieved.

L_SvgBounds* bounds

Pointer to a variable that will be updated with the bounds for the specified SVG document.

L_UINT structSize

Size in bytes, of the structure pointed to by bounds, for versioning. Use sizeof(L_SvgBounds).

Returns

Value	Meaning
SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

Support for SVG is only available in the Document and Medical Imaging toolkits.

For more information on flat SVG documents and bounds and resolution, refer to SVG Size, Bounds and Flat.

Before calling L_SvgCalculateBounds, the value of L_SvgBounds.IsValid will be FALSE and the document does not have its physical (pixel) bounds calculated. The rest of the L_SvgBounds members should not be used.

This function will calculate the physical (pixel) bounds of the document by internally enumerating all the elements and resolving the transformation. When this method returns, the members of L_SvgBounds will be set as follows:

Member	Value
IsValid	TRUE
IsTrimmed	The value of trimmed.
Resolution	A value such as 96 or 300 DPI calculated automatically from the SVG elements. If this value cannot be calculated, it will be set to the default of 0.
Bounds	The document physical boundaries in pixels.

Use L_SvgFlatDocument to flatten the SVG document.

Use L_SvgIsFlatDocument to determine whether the SVG document is flat.

Use L_SvgSetFlatDocument to set or clear the internal flat flag without re-calculating the document bounds.

Required DLLs and Libraries

• LTSVG
• For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64, Linux.