/ HALion Developer Resource / HALion Macro Page / Controls /

Decor (Control)

(Since HALion 6.4.20)

Description

This control allows you to add rectangular shapes as graphical elements to create background frames, group frames, etc. The rectangular shape can be drawn as an outline, filled, or both. The fill style can either be a solid color, a linear gradient, or a radial gradient. Furthermore, the rectangle can have rounded corners with an adjustable radius.

Properties

PopertyDescription
NameThe name of the element. This name will be displayed in the GUI Tree.
Position/SizePosition X, Position Y, Width, Height: Position and size of the element in pixels. Position X/Y defines the position of the upper left corner.
AttachDefines how an element behaves when its parent element is resized. You can set the following parameters:
  • Left: If the parent element is resized, the element remains attached to left edge, with the specified ratio.
  • Right: If the parent element is resized, the element moves relatively to the right edge, with the specified ratio.
  • Top: If the parent element is resized, the element remains attached to top edge, with the specified ratio.
  • Bottom: If the parent element is resized, the element moves relatively to the bottom edge, with the specified ratio.
  • Left + Right: If the parent element is resized, the element is resized horizontally relatively to the left and right edges, with the specified ratio.
TooltipText that appears as a tooltip when the mouse hovers over the element.
Fill StyleDecors can be filled. You can choose from the following fill styles:
  • No Fill: The inside of the rectangle remains fully transparent. This mode is useful for decors that show only an outline.
  • Solid: The inside of the rectangle will be filled with a color.
  • Linear Gradient: The inside of the rectangle will be filled with a linear gradient. The gradient has a top and a bottom color which refers to the default angle of 0 degree.
  • Radial Gradient: The inside of the rectangle will be filled with a radial gradient.
RadiusSpecifies the roundness of the rectangle corners.
Line WidthSpecifies the width of the outline.
AngleSpecifies the angle of the Linear Gradient fill style in degrees.
StretchAllows you to compress (values < 1.0) or expand (values > 1.0) the Linear Gradient or Radial Gradient.
Center X/YSpecifies the center of the Radial Gradient. Negative values move the center to the left and top, postive values to the right and bottom.
Line ColorDefines the color of the outline.
ColorSpecifies the fill color for the Solid fill style.
Start ColorSpecifies the top fill color for the Linear Gradient fill style.
End ColorSpecifies the bottom fill color for the Linear Gradient fill style.
Inner ColorSpecifies the inner fill color for the Radial Gradient fill style.
Outer ColorSpecifies the outer fill color for the Radial Gradient fill style.