RiverSoftAVG Products Help

Attributes

Returns the valid style properties of the svg element

BoundsRect

Specifies the bounding rectangle (X, Y, X+Width, Y+Height) for the SVG element unmodified by any transformations in the current coordinate system.

The X, Y, Width, and Height properties specify coordinates in virtual pixels of the nearest viewbox, or coordinate system. For example, a TSVGDocument may specify a ViewBox of 0, 0, 100, 100. Specifying an element's X and Y as 50, 50 will always position the element to start in the exact center of the view box. If the TSVGDocument is then drawn to a true pixel rectangle of 1000 pixel width and 500 pixel height, the element would draw at 500, 250 pixels.

To retrieve the "true" bounding rectangle which has been modified by any transformations, use the GetBoundsRect method

The BoundsRect and X/Y/Width/Height properties specify coordinates in virtual pixels of the nearest viewbox, or coordinate system. For example, a TSVGDocument may specify a ViewBox of 0, 0, 100, 100. Specifying an element's X and Y as 50, 50 will always position the element to start in the exact center of the view box. If the TSVGDocument is then drawn to a true pixel rectangle of 1000 pixel width and 500 pixel height, the element would draw at 500, 250 pixels.

Classes

Specifies the 'classes' that the SVG element belongs to. The classes property assigns one or more class names to an element. The element may be said to belong to these classes. A class name may be shared by several element instances.

Description

Specifies a non-visual Description for the SVG element. When generating FMX controls, the FMX control's Hint property is set to the Description. If the Description is empty, the Hint is set to the Title

ElementState

Returns the state of the element. Use this property to correctly update the element when it is in a certain state.

Enabled

Specifies whether the element is enabled or disabled. By default, disabled elements are not exported or detected by the FMX.RS.SVG.TSVGElement.ElementAtPos(TSVGCanvas,TSVGPoint,TSVGRect,TSVGFindOptions) method.

Disabled elements are shown using a grayscale version of the element, which may be overridden with the OnDisableAppearance event.

ID

Unique name for the SVG element. The SVG document's   AllItems property uses the ID as the unique hash for returning SVG elements

Items

The child SVG Items of the current element. The Parent and Items properties define the hierarchy of a SVG document fragment.

Language

Specifies the Language of the SVG element

Listeners

Maintains the list of elements that need to be notified when this element changes or is being destroyed

When the current element changes, it will call the FMX.RS.SVG.TSVGElement.NotifyListener(TSVGElement) method of every element on this list

Options

Defines options for reading, displaying, and writing the svg.

The most important option as far as compatibility is the soUseFillText option. When this option is present, the RSCL uses FillText calls to directly render the text to the canvas. When this option is not present (default), the RSCL converts text into paths that are then filled and stroked. Converting text to paths provides the highest compatibility but slower performance. If you use the FMX GPU Canvas (FMX.Types.GlobalUseGPUCanvas), text is always filled and not converted to paths.

The following differences exist between the two text rendering paths:

• Fill Text does not use the Pen and so cannot both fill and stroke text

• Fill Text cannot use gradients for filling (FMX)

•ShapeRendering affects the smoothness of text when filling path-based text (as text are shapes); TextRendering affects the smoothness of text when filling text

• Fill Text uses less memory

• Fill Text generates better text at small sizes

• Path-based text caches its shapes so subsequent draw calls are faster, even faster than fill text calls in many cases

• Path-based text allows pixel level selection of text; Fill Text can only be selected as a text bounding box

• Path-based text renders decorative fonts (underline, overline, and strike-out) using an extra path for the decoration (FMX will not generate paths with the decoration when converting text to paths). Surprisingly, this means that compatibility is higher with path-based text as the decoration gets its rendering configuration from the parent text element (e.g., strike-out text should use the parent text's font size and not vary as the size of child text span's font size changes).