TRSSVGCustomInstrument Class

DefaultFormatStr

Represents constant DefaultFormatStr.

Create(TComponent)

Initializes a new instance of the TRSSVGCustomInstrument class. (Overrides FMX.RS.SVGControl.TRSSVGControl.Create(TComponent).)

ActiveSVGElement

Specifies the dynamic element in the SVG, the part that will be changing often. The ActiveSVGElement is not buffered when painting as it is assumed it will be changing. Set the ActiveSVGElement to tell the control which element or group of elements need to be redrawn every paint event.

The non-active svg elements are rendered either to the     Background or     Foreground Buffer.

Align

Represents property Align.

Anchors

Represents property Anchors.

Background

Contains the static background of the SVG compared to the   ActiveSVGElement, i.e. the SVG elements that are rendered behind the ActiveSVGElement. The Background and Foreground are painted once from the SVG. When elements in the ActiveSVGElement group change, the Background and Foreground are not rendered again, significantly speeding up painting of the entire SVG.

Buffered

Specifies whether to draw the SVG to a backbuffer and then copy that image to the canvas (default) or to draw directly on the canvas

Set the Buffered property to false to draw directly on the image canvas. This is generally not recommended, however, it may look better on mobile devices

ClipChildren

Represents property ClipChildren.

ClipParent

Represents property ClipParent.

Cursor

Represents property Cursor.

Decoration

Defines the shape to use as a decoration for the instrument. The decoration can be pre-defined paths or a custom path. Use   DecorationFillColor and   DecorationStrokeColor to customize the colors of the decoration.

DecorationFillColor

Specifies the fill color for the decoration

DecorationID

Specifies the ID of the element in the SVG that contains the   Decoration for the instrument.

DecorationPath

Provides access to the path data for the decoration. If the Decoration element does not exist in the SVG, this property does nothing and returns nil.

DecorationStrokeColor

Specifies the stroke or pen color of the decoration

Design

Use the Design property to quickly switch between detailed and simpler versions of the instrument. The simple option removes extra detail (such as bevels, glass look, shadows, bolts or screws, etc) in the gauge to provide a more basic and faster to draw version of the gauge.

The Design and EnableGradients properties are holistic-type properties which rapidly change the entire look of the instrument.

DragMode

Represents property DragMode.

Enabled

Represents property Enabled.

EnableDragHighlight

Represents property EnableDragHighlight.

EnableGradients

Use the EnableGradients property to remove gradients from the gauge and use solid colors instead. This option improves speed when drawing the component, and gives gauges a generally flatter look.

The Design and EnableGradients properties are holistic-type properties which rapidly change the entire look of the instrument.

Foreground

Contains the static foreground of the SVG compared to the   ActiveSVGElement, i.e. the SVG elements that are rendered in front of the ActiveSVGElement. The Background and Foreground are painted once from the SVG. When elements in the ActiveSVGElement group change, the Background and Foreground are not rendered again, significantly speeding up painting of the entire SVG.

FormatStr

Defines the format of floating point numbers that are displayed in text elements within the gauge. Change this property to change how numbers are displayed (e.g., significant digits)

Height

Represents property Height.

HitTest

Represents property HitTest.

LightColor

Specifies the color of the light for the instrument. Change the light color to give the instrument a slight color cast.

Locked

Represents property Locked.

Margins

Represents property Margins.

NeedBuffers

Controls whether the Background and Foreground need to be rendered again in the Buffered paint process. Set the NeedBuffers property to True to force the buffers to be redrawn at the next paint event. (Inherited from FMX.RS.SVGControl.TRSSVGControl.)

OnChange

Occurs when the instrument has been modified. Use the OnChange event to respond to changes. Note that BeginUpdate/EndUpdate can delay change events until the last matching EndUpdate method is called.

OnClick

Represents property OnClick.

OnDblClick

Represents property OnDblClick.

OnDragDrop

Represents property OnDragDrop.

OnDragEnd

Represents property OnDragEnd.

OnDragEnter

Represents property OnDragEnter.

OnDragLeave

Represents property OnDragLeave.

OnDragOver

Represents property OnDragOver.

OnDrawing

Occurs just before drawing the current element and its children. The event fires after the canvas brush, pen, font, clipping, etc are set up but before the actual drawing. (Inherited from FMX.RS.SVGControl.TRSSVGControl.)

OnDrawn

Occurs just after a SVG element is drawn. The event fires after drawing the current element and its children but before the canvas is returned to its initial state. (Inherited from FMX.RS.SVGControl.TRSSVGControl.)

OnMouseDown

Represents property OnMouseDown.

OnMouseEnter

Represents property OnMouseEnter.

OnMouseLeave

Represents property OnMouseLeave.

OnMouseMove

Represents property OnMouseMove.

OnMouseUp

Represents property OnMouseUp.

OnMouseWheel

Represents property OnMouseWheel.

OnPaint

Represents property OnPaint.

OnPainting

Represents property OnPainting.

OnResize

Represents property OnResize.

Opacity

Represents property Opacity.

Padding

Represents property Padding.

PopupMenu

Represents property PopupMenu.

Position

Represents property Position.

Quality

Controls the quality of the FMX.RS.SVGControl.TRSSVGControl.Buffered painting of the SVG image. The value of quality can vary between 1 (low quality) to 8 (very high quality).

RotationAngle

Represents property RotationAngle.

RotationCenter

Represents property RotationCenter.

Scale

Represents property Scale.

ShadowColor

Returns the color to use for shadows in the instrument. This color is calculated from the FMX.RS.Impact.Instruments.TRSSVGCustomInstrument.LightColor property.

Stretch

Defines if the control draws the SVG stretched to the complete bounds of the control (True) or draws the SVG to the maximum dimensions while respecting the aspect ratio of the SVG (False). (Inherited from FMX.RS.SVGControl.TRSSVGControl.)

SVG

Contains the SVG that paints the appearance of the control. The control changes the SVG elements based on requirements of the control. For example, a descendant control could change a specific element's fill and stroke based on a Color property change. (Inherited from FMX.RS.SVGControl.TRSSVGControl.)

TabOrder

Represents property TabOrder.

TouchTargetExpansion

Represents property TouchTargetExpansion.

Visible

Represents property Visible.

Width

Represents property Width.

AfterConstruction

Represents method AfterConstruction.

ChangeGradientColor(TSVGCustomGradient,TSVGColor,Boolean)

Overloaded.  Attempts to modify a gradient color scheme to a similar color scheme using NewColor, i.e., if a gradient has 3 gradient stops of dark gray, gray, white and the NewColor is Red, the method will try to change the gradient to red, lighter red, and white.

The FromFirst parameter specifies if the first or the last gradient stop is the base color to replace. The base color is replaced with the NewColor unchanged. All other gradient stops are modified from the base color.

ChangeGradientColor(TSVGCustomGradient,TSVGColor,Integer)

Overloaded.  Attempts to modify a gradient color scheme to a similar color scheme using NewColor, i.e., if a gradient has 3 gradient stops of dark gray, gray, white and the NewColor is Red, the method will try to change the gradient to red, lighter red, and white.

The BaseColorIndex parameter specifies if which gradient stop is the base color to replace. The base color is replaced with the NewColor unchanged. All other gradient stops are modified from the base color.

DoEnableGradient(String,String,Boolean,TSVGColor,Boolean)

Helper method for changing a SVG element's color between a gradient or a solid color.

The IsEnabled parameter specifies whether to set the element to the gradient or the solid color.

The IsBrush parameter specifies whether to change the element's brush or pen properties.

DoEnableGradients(Boolean)

This method enables or disables gradients in the SVG for the instrument.

Descendant classes override this method to respond to     EnableGradients property changes.

DoInitializeGauge

Initializes the SVG gauge or instrument from the class properties, i.e., apply the properties to the SVG.

Descendant classes override this method to initialize the SVG that draws the gauge with their properties.

DoOnChange

Triggers the   OnChange event

DoPaint

Represents method DoPaint. (Inherited from FMX.RS.SVGControl.TRSSVGControl.)

DoUpdateDesign

Updates the SVG design of the instrument to simple or detailed based on Design property.

Descendant classes override this method to modify the SVG in response to     Design property changes. Simple designs usually mean making some extra element's invisible.

DoUpdateLight

Updates colors of SVG elements based on changes in the LightColor property.

Descendant classes can override this method to provide a color cast to the SVG based on     LightColor changes.

DoUpdateParts

Update the parts of the SVG based on changes to the Parts property.

Descendant classes override this method to show or hide different elements in the SVG based on Parts property changes.

EndUpdate

Represents method EndUpdate.

GetDrawRect

Returns the rectangle where the SVG should be drawn. This is dependent on the current stretch value, the control's width and height, and the SVG's width and height. (Inherited from FMX.RS.SVGControl.TRSSVGControl.)

GetSVGResourceName

Returns the name of the resource that contains the SVG. The class uses this name to load the embedded SVG from a resource.

InitializeGauge

Initializes the SVG gauge or instrument from the class properties, i.e., apply the properties to the SVG.

This method calls the     DoInitializeGauge method to actually initialize the SVG based on the class properties. It is recommended that descendant classes override that method to respond to initialization requests.

This method ensures that the buffers get updated and the control is repainted.

Invalidate

Represents method Invalidate. (Inherited from FMX.RS.SVGControl.TRSSVGControl.)

LoadSVGProperties

Initializes local properties from the SVG. Descendant classes override this method to initialize their properties (such as FrameColor) from elements in the SVG.

LoadSVGResource(String)

Load the SVG from an embedded resource. This method initializes the   ActiveSVGElement property and should be used to initialize any control fields (such as colors) that are dependant on the values in the SVG. (Inherited from FMX.RS.SVGControl.TRSSVGControl.)

RecalcEnabled

Represents method RecalcEnabled. (Inherited from FMX.RS.SVGControl.TRSSVGControl.)

Resize

Represents method Resize. (Inherited from FMX.RS.SVGControl.TRSSVGControl.)

RestoreGradientColor(TSVGCustomGradient)

Restores the gradient stop colors from the tags of the SVG elements, previously saved using   SaveGradientColor.

SaveGradientColor(TSVGCustomGradient)

Stores gradient stop colors in the tags of the SVG elements. This allows restoring the gradient stop colors without reloading the svg

UpdateBuffers

Updates the   Foreground and   Background buffers with the non active elements of the SVG. (Inherited from FMX.RS.SVGControl.TRSSVGControl.)

UpdateDecoration

Updates the shape of the decoration (   DecorationPath) based on changes to the   Decoration property.

UpdateDecorationFill

Updates the   Decoration fill color in the gauge

UpdateDecorationStroke

Updates the   Decoration stroke color in the gauge

UpdateDesign

Updates the design of the gauge based on the     Design property. Simpler designs hide elements in the SVG while detailed designs show all elements of the SVG.

This method calls the     DoUpdateDesign method to actually change the SVG based on the Design property. It is recommended that descendant classes override DoUpdateDesign method to respond to design changes.

This method ensures that the buffers get updated and the control is repainted.

UpdateGradients

This method enables or disables gradients in the SVG for the instrument based on     EnableGradients property changes.

This method calls the     DoEnableGradients method to actually enable/disable gradients in the SVG. It is recommended that descendant classes override that method to enable/disable the gradients.

This method ensures that the buffers get updated and the control is repainted.

UpdateLight

Updates colors of SVG elements based on changes in the LightColor property.

Descendant classes can override this method to provide a color cast to the SVG based on     LightColor changes.

This method calls the     DoUpdateLight method to actually perform any color changes in the SVG. It is recommended that descendant classes override that method to do the actual changes.

This method ensures that the buffers get updated and the control is repainted.

UpdateNumbers

This method updates any text elements that display numbers in the gauge. This method is called when the     FormatStr property changes so that the class can respond to new formatting for numbers.

Descendant classes should override this method to update any text elements with numbers

UpdateParts

Update the parts of the SVG based on changes to the Parts property.

Descendant classes override this method to show or hide different elements in the SVG based on Parts property changes.

This method calls the     DoUpdateParts method to actually perform any changes to the SVG. It is recommended that descendant classes override that method to do the actual changes.

This method ensures that the buffers get updated and the control is repainted.