TRSCubeLight Class

CUBE_ASSEMBLY_ID

Represents constant CUBE_ASSEMBLY_ID.

CUBE_LIGHT_FRAME_ID

Represents constant CUBE_LIGHT_FRAME_ID.

CUBE_LIGHT_ID

Represents constant CUBE_LIGHT_ID.

CUBE_LIGHT_SHINE_ID

Represents constant CUBE_LIGHT_SHINE_ID.

DECORATIONS_ID

Represents constant DECORATIONS_ID.

DECORATION_ID

Represents constant DECORATION_ID.

DefaultFormatStr

Represents constant DefaultFormatStr. (Inherited from RS.Impact.Instruments.TRSSVGCustomInstrument.)

FRAME_ID

Represents constant FRAME_ID.

FRONT_HOUSING_ID

Represents constant FRONT_HOUSING_ID.

FRONT_ID

Represents constant FRONT_ID.

GRADIENT_DIM_ID

Represents constant GRADIENT_DIM_ID.

GRADIENT_FRAME_ID

Represents constant GRADIENT_FRAME_ID.

GRADIENT_HOUSING_ID

Represents constant GRADIENT_HOUSING_ID.

GRADIENT_LIGHT_FRAME_ID

Represents constant GRADIENT_LIGHT_FRAME_ID.

GRADIENT_SHINE_ID

Represents constant GRADIENT_SHINE_ID.

LIGHTS_ID

Represents constant LIGHTS_ID.

SVG_RESOURCE_NAME

Represents constant SVG_RESOURCE_NAME.

Create(TComponent)

Initializes a new instance of the TRSCubeLight class. (Overrides RS.Impact.Instruments.TRSSVGCustomInstrument.Create(TComponent).)

AbsoluteMatrix

Returns the combined transformation matrix for the control. This is the control's transformation matrix multiplied by all parent IRSGPControl control's transformation matrices. (Inherited from RSSVGControl.TRSSVGControl.)

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.

AutoSize

Represents property AutoSize.

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

Represents property Buffered.

Checked

Turns the light on (checked) or off (checked=false). The user can also click on the light to turn it on or off if the RS.Impact.Lights.TRSCubeLight.EnableActions property is true.

Constraints

Represents property Constraints.

Decoration

Represents property Decoration.

DecorationFillColor

Represents property DecorationFillColor.

DecorationID

Specifies the ID of the element in the SVG that contains the   Decoration for the instrument. (Inherited from RS.Impact.Instruments.TRSSVGCustomInstrument.)

DecorationPath

Represents property DecorationPath.

DecorationStrokeColor

Represents property DecorationStrokeColor.

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.

DragCursor

Represents property DragCursor.

DragKind

Represents property DragKind.

DragMode

Represents property DragMode.

EnableActions

Controls whether the user can click on the light to turn it on and off

Enabled

Represents property Enabled.

EnableGradients

Represents property EnableGradients.

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) (Inherited from RS.Impact.Instruments.TRSSVGCustomInstrument.)

FrameColor

Specifies the color to use for the frame of the light. Use this property to change the frame color. To change the housing around each light, use the   HousingColor property.

Height

Represents property Height.

HousingColor

Specifies the color to use for the housing around the light. To change the larger frame, use the   FrameColor property. Use this property to change the housing color.

LightColor

Represents property LightColor.

Matrix

Returns the transformation matrix of the control (Inherited from RSSVGControl.TRSSVGControl.)

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 RSSVGControl.TRSSVGControl.)

OffColor

Specifies the color to use when a light is off. The light is off if checked is false. Use this property to change the off color for the light.

OnChange

Represents property OnChange.

OnClick

Represents property OnClick.

OnColor

Specifies the color to use when a light is on. The light is on if checked is true. Use this property to change the on color for the light.

OnContextPopup

Represents property OnContextPopup.

OnDblClick

Represents property OnDblClick.

OnDragDrop

Represents property OnDragDrop.

OnDragOver

Represents property OnDragOver.

OnDrawing

Represents property OnDrawing.

OnDrawn

Represents property OnDrawn.

OnEndDock

Represents property OnEndDock.

OnEndDrag

Represents property OnEndDrag.

OnGesture

Represents property OnGesture.

OnMouseActivate

Represents property OnMouseActivate.

OnMouseDown

Represents property OnMouseDown.

OnMouseEnter

Represents property OnMouseEnter.

OnMouseLeave

Represents property OnMouseLeave.

OnMouseMove

Represents property OnMouseMove.

OnMouseUp

Represents property OnMouseUp.

OnPaint

Represents property OnPaint.

OnPainting

Represents property OnPainting.

OnStartDock

Represents property OnStartDock.

OnStartDrag

Represents property OnStartDrag.

Opacity

Represents property Opacity.

ParentShowHint

Represents property ParentShowHint.

Parts

Specifies the visible parts of the light. Use the Parts property to configure which parts of the instrument that IMPACT should draw.

PopupMenu

Represents property PopupMenu.

Quality

Represents property Quality.

ShadowColor

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

ShowHint

Represents property ShowHint.

Stretch

Represents property Stretch.

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 RSSVGControl.TRSSVGControl.)

Touch

Represents property Touch.

Transform

Represents property Transform.

UpdateCount

Tracks the number of BeginUpdate calls with unmatching EndUpdate calls, i.e., if UpdateCount is greater than 0, the code is between BeginUpdate and EndUpdate and should not signal a change event. (Inherited from RS.Impact.Instruments.TRSSVGCustomInstrument.)

Visible

Represents property Visible.

Width

Represents property Width.

AfterConstruction

Represents method AfterConstruction. (Inherited from RS.Impact.Instruments.TRSSVGCustomInstrument.)

BeginUpdate

Prevents the updating of the instrument until the   EndUpdate method is called.
 
BeginUpdate prevents the screen from being repainted and OnChange events being triggered when instrument properties are changed. Use BeginUpdate to prevent screen repaints and to speed processing time while modifying the instrument.
 
Note: Calls to BeginUpdate are cumulative; for every call to BeginUpdate there must be a corresponding call to EndUpdate. (Inherited from RS.Impact.Instruments.TRSSVGCustomInstrument.)

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 (Inherited from RS.Impact.Instruments.TRSSVGCustomInstrument.)

DoPaint

Represents method DoPaint. (Inherited from RSSVGControl.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.

EnabledChanged

This method is called when the Enabled property changes. The SVG colors are rendered in grayscale when the control is disabled. (Inherited from RSSVGControl.TRSSVGControl.)

EndUpdate

Re-enables screen repainting and change events that were turned off with the   BeginUpdate method.
 
Use the EndUpdate method to enable screen updating after BeginUpdate has been called. Calls to BeginUpdate are cumulative, so calling EndUpdate will only update the instrument if every other call to BeginUpdate has already been matched by a call to EndUpdate.
 
 (Inherited from RS.Impact.Instruments.TRSSVGCustomInstrument.)

GetAbsoluteMatrix

Returns the combined transformation matrix for the control. This is the control's transformation matrix multiplied by all parent IRSGPControl control's transformation matrices. (Inherited from RSSVGControl.TRSSVGControl.)

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 RSSVGControl.TRSSVGControl.)

GetMatrix

Returns the transformation matrix of the control (Inherited from RSSVGControl.TRSSVGControl.)

GetOpacity

Returns the Opacity of the control (Inherited from RSSVGControl.TRSSVGControl.)

GetShapeRect(TObject,TRSRect)

Returns the rectangle for the control (Inherited from RSSVGControl.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. (Overrides RS.Impact.Instruments.TRSSVGCustomInstrument.GetSVGResourceName.)

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.

IsBuffered

Returns True if the instrument should be drawn to a offscreen bitmap (Inherited from RSSVGControl.TRSSVGControl.)

IsUpdating

Returns true if the instrument is being updated (Inherited from RS.Impact.Instruments.TRSSVGCustomInstrument.)

LoadSVGProperties

Initializes local properties from the SVG. Descendant classes override this method to initialize their properties (such as FrameColor) from elements in the SVG. (Overrides RS.Impact.Instruments.TRSSVGCustomInstrument.LoadSVGProperties.)

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. (Overrides RSSVGControl.TRSSVGControl.LoadSVGResource(String).)

MouseUp(TMouseButton,TShiftState,Integer,Integer)

Represents method MouseUp(TMouseButton,TShiftState,Integer,Integer).

ObjectChanged(TObject)

This method is called when an object property (such as Font) has changed and the control needs to respond to the change. (Inherited from RSSVGControl.TRSSVGControl.)

Resize

Represents method Resize. (Inherited from RSSVGControl.TRSSVGControl.)

RestoreGradientColor(TSVGCustomGradient)

Restores the gradient stop colors from the tags of the SVG elements, previously saved using   SaveGradientColor. (Inherited from RS.Impact.Instruments.TRSSVGCustomInstrument.)

SaveGradientColor(TSVGCustomGradient)

Stores gradient stop colors in the tags of the SVG elements. This allows restoring the gradient stop colors without reloading the svg (Inherited from RS.Impact.Instruments.TRSSVGCustomInstrument.)

SetOpacity(Single)

Sets the opacity of the control. If Opacity is less than 1, then the SVG is displayed semi- transparent. If Opacity is 0, then the SVG is not displayed.
 (Inherited from RSSVGControl.TRSSVGControl.)

UpdateBuffers

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

UpdateDecoration

Updates the shape of the decoration (   DecorationPath) based on changes to the   Decoration property. (Inherited from RS.Impact.Instruments.TRSSVGCustomInstrument.)

UpdateDecorationFill

Updates the   Decoration fill color in the gauge (Inherited from RS.Impact.Instruments.TRSSVGCustomInstrument.)

UpdateDecorationStroke

Updates the   Decoration stroke color in the gauge (Inherited from RS.Impact.Instruments.TRSSVGCustomInstrument.)

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.

UpdateState

Represents method UpdateState.