Scripting/SUIText

The SUIText class provides tools to work with the SUIText component, which is a component responsible for displaying text

Properties

AlignByGeometry

bool AlignByGeometry {get;set;}

Use the range of glyph geometry to perform horizontal alignment.

Color

SColor Color {get;set;}

Base color of the Graphic.

--This script dynamically changes the text's color of a GameObject with UIText component.

--For example in a text sign over your shop that you want to make more visually stand out --or perhaps text decoration during a celebration or a text element in your User Interface or HUD.

thisObject = Space.Host.ExecutingObject

--get a reference to our object

thisObjectText = thisObject.UIText

--get a reference to the SUIText component in our object 

colors = {Color.Red, Color.Black, Color.White, Color.Blue, Color.Green, Color.Yellow}

--here we are holding 6 predefined colors in a Lua Table which we will go through

function ColorChanger()

   while true do
   --infinite loop
   
       for i=1,#colors do
       --For Loop to cycle through all the table items
       thisObjectText.color = colors[i] 
       --this will set the color based on which item in the table we are now at
       coroutine.yield(0.1)
       --this will pause for a tenth of a second before we change to the next color
       end

   end

end

thisObjectText.color = Color.Red --this is how to set text color using one of the predefined colors in the SColor class. thisObjectText.color = Color.New(0,0,0,1) --this sets our text color to Black (RGB 000) but also Alpha to 1 (meaning fully opaque, not transparent)

colorOfThisObject = thisObjectText.color thisObjectText.color = colorOfThisObject --The color property also allows you to "get" it, not only "set" it, meaning you can get --your text's current color and save it. In this case, the color of your text wouldn't change.

--The last 4 lines of code above are not important to this color changing script, it's just extra information for you.

Space.Host.StartCoroutine(ColorChanger)

--this coroutine will now call our ColorChanger() function which is infinitely changing our text colors between a select range.

Enabled

bool Enabled {get;set;}

Enabled Behaviours are Updated, disabled Behaviours are not.

FlexibleHeight

float FlexibleHeight {get;}

Called by the layout system.

FlexibleWidth

float FlexibleWidth {get;}

Called by the layout system.

FontSize

int FontSize {get;set;}

The size that the Font should render at.

LayoutPriority

int LayoutPriority {get;}

Called by the layout system.

LineSpacing

float LineSpacing {get;set;}

Line spacing, specified as a factor of font line height. A value of 1 will produce normal line spacing.

MinHeight

float MinHeight {get;}

Called by the layout system.

MinWidth

float MinWidth {get;}

Called by the layout system.

PixelsPerUnit

float PixelsPerUnit {get;}

Provides information about how fonts are scale to the screen.

PreferredHeight

float PreferredHeight {get;}

Called by the layout system.

PreferredWidth

float PreferredWidth {get;}

Called by the layout system.

ResizeTextForBestFit

bool ResizeTextForBestFit {get;set;}

Should the text be allowed to auto resized.

ResizeTextMaxSize

int ResizeTextMaxSize {get;set;}

No documentation

ResizeTextMinSize

int ResizeTextMinSize {get;set;}

The minimum size the text is allowed to be.

SupportRichText

bool SupportRichText {get;set;}

Whether this Text will support rich text.

Text

string Text {get;set;}

The string value this Text displays.