Libraries.Data.Formats.ScalableVectorGraphics.Label Documentation

The Label class is an implementation of text in the SVG standard. Like other ScalableVectorGraphicsObjects the Label class inherits global attributes but it also has its own attributes.

Example Code

Libraries.Data.Formats.ScalableVectorGraphics.all

// make text
Label label

label:SetPosition(50, 50)
label:SetText("words words words")
label:SetTextAnchor("middle")
label:SetFontSize("12pt")

Inherits from: Libraries.Language.Object, Libraries.Data.Formats.ScalableVectorGraphics.ScalableVectorGraphicsObject

Actions Documentation

Compare(Libraries.Language.Object object)

This action compares two object hash codes and returns an integer. The result is larger if this hash code is larger than the object passed as a parameter, smaller, or equal. In this case, -1 means smaller, 0 means equal, and 1 means larger. This action was changed in Quorum 7 to return an integer, instead of a CompareResult object, because the previous implementation was causing efficiency issues.

Parameters

Return

integer: The Compare result, Smaller, Equal, or Larger.

Example

Object o
Object t
integer result = o:Compare(t) //1 (larger), 0 (equal), or -1 (smaller)

ConvertReservedCharacters(text value)

This action returns a new string that automatically converts any characters that are reserved in the HTML specification before placing them into the vector graphic. This prevents the graphic from not compiling in circumstances where a DataFrame created a graphic that used a reserved character.

Parameters

  • text value: the text to be converted

Return

text: A new text value with converted reserved characters.

Equals(Libraries.Language.Object object)

This action determines if two objects are equal based on their hash code values.

Parameters

Return

boolean: True if the hash codes are equal and false if they are not equal.

Example

use Libraries.Language.Object
use Libraries.Language.Types.Text
Object o
Text t
boolean result = o:Equals(t)

GetAriaDescribedBy()

This action will give a aria-describedby attribute to the SVG element. This aria-describedby can be for general use by a web browser.

Return

text:

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetAriaDescribedBy("This is a blue circle with a radius of 5.0")

GetAriaDescription()

This action will give a aria-description attribute to the SVG element. This aria-description can be for general use by a web browser.

Return

text:

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetAriaDescription("This is a blue circle with a radius of 5.0")

GetAriaHidden()

This action will give a aria-hidden attribute to the SVG element. This aria-hideen can be for general use by a web browser.

Return

text:

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetAriaHidden("true")

GetAriaLabel()

This action will give a aria-label attribute to the SVG element. This aria-label can be for general use by a web browser.

Return

text:

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetAriaLabel("My Circle")

GetAriaLabelledBy()

This action will give a aria-labelledby attribute to the SVG element. This aria-labelledby can be for general use by a web browser.

Return

text:

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetAriaLabelledBy("id")

GetAriaRoleDescription()

This action will give a aria-roledescription attribute to the SVG element. This aria-roledescription can be for general use by a web browser.

Return

text:

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetAriaRoleDescription("This is a blue circle with a radius of 5.0")

GetCloseTag(text name, boolean container)

This is an interal action that allows the ScalableVectorGraphicsObject generate the correct closing tag.

Parameters

  • text name
  • boolean container

Return

text:

GetColor()

This action returns the color of the object.

Return

text: the color of the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetColor("navy")
output circle:GetColor()

GetDescription()

This action will return the currently set description to a ScalableVectorGraphicsObject.

Return

text: The current text description of the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetDescription("This is my circle and it will be blue")
text myDescpription = circle:GetDescription()

GetFill()

This action returns the fill of the object.

Return

text: the fill of the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetFill("navy")
output circle:GetFill()

GetFillOpacity()

This action returns the fill opacity of the object.

Return

text: the fill opacity of the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetFill("navy")
circle:SetFillOpacity(0.7)
output circle:GetFillOpacity()

GetFontFamily()

This action returns the current font-family to the list of fonts give (can list multiple with comma-delimited list).

Return

text: the value for the current font family

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetFontFamily("Arial")
myLabel:SetFontFamily("Arial, Halvetica, sans-serif")

output myLabel:GetFontSize()

GetFontSize()

This action returns the current font size with the unit appended.

Return

text: The current font size

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetFontSize("12pt")

output myLabel:GetFontSize()

GetHashCode()

This action gets the hash code for an object.

Return

integer: The integer hash code of the object.

Example

Object o
integer hash = o:GetHashCode()

GetHorizontalShift()

This action returns the shift the text on the x axis from its position with the unit appended.

Return

text: The amount of shift on the x axis.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:GetHorizontalShift(12)

output myLabel:GetHorizontalShift()

GetID()

This action returns the id of the object.

Return

text: the id of the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetID("My Circle")
output circle:GetID()

GetOnBlur()

This action will give a blur event handler attribute to the SVG element. This blur can be for general use by a web browser.

Return

text:

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Group group
group:SetOnBlur("console.log('hello world');")

GetOnFocus()

This action will give a focus event handler attribute to the SVG element. This focus can be for general use by a web browser.

Return

text:

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Group group
group:SetOnFocus("console.log('hello world');")

GetRole()

This action will give a role attribute to the SVG element. This role can be for general use by a web browser.

Return

text:

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetRole("region")

GetRotation()

This action returns how much each individual glyph of the text is being rotated.

Return

integer: The amount of rotation in degrees.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetRotation(270)

output myLabel:GetRotation()

GetStroke()

This action returns the stroke of the object.

Return

text: the stroke of the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetStroke("navy")
output circle:GetStroke()

GetStrokeOpacity()

This action returns the stroke opacity of the object.

Return

text: the stroke opacity of the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetStroke("navy")
circle:SetStrokeOpacity(0.7)
output circle:GetStrokeOpacity()

GetStrokeWidth()

This action returns the stroke width of the object. Since lengths can have varying units in SVG the unit will be appended to the returned length

Return

text: the stroke width with the unit appended if one was given.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetStrokeWidth(5, "%")
text strokeWidth = circle:GetStrokeWidth()

GetStyle()

This action returns the style information of the object.

Return

text: the style information of the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetStyle("fill: skyblue; stroke: navy;")
output circle:GetStyle()

GetStyleClass()

This action will give a class attribute to the SVG element. This class can be for gerneral use by a web browser or for when using a styling sheet on the SVG file.

Return

text:

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetStyleClass("circleClass")

GetTabIndex()

This action returns the tab index of the object.

Return

integer: the tab index of the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetTabIndex(5)
output circle:GetTabIndex()

GetText()

This action returns the text that this object would show.

Return

text: the text that this label shows

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetText("Words Words and more words")

output myLabel:GetText()

GetTextAnchor()

This action returns where the text anchor is set.

Return

text: The current text anchor.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:GetTextAnchor("middle")

output myLabel:GetTextAnchor()

GetTextLength()

This action returns the width that the text of the label will be scaled to fit with the unit appended.

Return

text: The width that the text will be fit to

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetTextLength(50)

output myLabel:GetTextLength()

GetTitle()

This action will return the currently set title of the object.

Return

text: The current title of the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetTitle("My Circle")
text myTitle = circle:GetTitle()

GetTransform()

This action returns the current transform applied on the element

Return

text: The current applied transform.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetTransfrom("rotate(270,100,100)")

output myLabel:GetTransform()

GetVerticalShift()

This action returns the shift the text on the y axis from its position with the unit appended.

Return

text: The amount of shift on the y axis.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:GetVerticalShift(12)

output myLabel:GetVerticalShift()

GlobalAttributesToText()

This is an interal action that allows the ScalableVectorGraphicsObject to write out its global attributes.

Return

text:

IsBold()

This action returns the current transform applied on the element

Return

boolean: The current applied transform.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetTransfrom("rotate(270,100,100)")

output myLabel:GetTransform()

IsContainer()

This action is used internally by the system to designate whether the SVG element is a single tag or contains more objects within it.

Return

boolean:

IsOneLine()

This action is used internally by the system to designate whether the SVG element should print with new lines.

Return

boolean:

SetAriaDescribedBy(text ariaDescribedBy)

This action will give a aria-describedby attribute to the SVG element. This aria-describedby can be for general use by a web browser.

Parameters

  • text ariaDescribedBy: The aria-describedby for the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetAriaDescribedBy("This is a blue circle with a radius of 5.0")

SetAriaDescription(text ariaDescription)

This action will give a aria-description attribute to the SVG element. This aria-description can be for general use by a web browser.

Parameters

  • text ariaDescription: The aria-description for the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetAriaDescription("This is a blue circle with a radius of 5.0")

SetAriaHidden(text ariaHidden)

This action will give a aria-hidden attribute to the SVG element. This aria-hideen can be for general use by a web browser.

Parameters

  • text ariaHidden: The aria-hidden for the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetAriaHidden("true")

SetAriaLabel(text ariaLabel)

This action will give a aria-label attribute to the SVG element. This aria-label can be for general use by a web browser.

Parameters

  • text ariaLabel: The aria-label name for the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetAriaLabel("My Circle")

SetAriaLabelledBy(text ariaLabelledBy)

This action will give a aria-labelledby attribute to the SVG element. This aria-labelledby can be for general use by a web browser.

Parameters

  • text ariaLabelledBy: The aria-labelledby name for the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetAriaLabelledBy("id")

SetAriaRoleDescription(text ariaRoleDescription)

This action will give a aria-roledescription attribute to the SVG element. This aria-roledescription can be for general use by a web browser.

Parameters

  • text ariaRoleDescription: The aria-roledescription for the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetAriaRoleDescription("This is a blue circle with a radius of 5.0")

SetBold(boolean isBold)

This action sets a transform on the current element.

Parameters

  • boolean isBold

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetTransform("rotate(270,100,100)")

SetColor(text color)

This action will give a color attribute to the SVG element. This attribute does not directly change an objects color. It provides a color for other attriubtes, such as fill and stroke that may not have a defined color, to inherit a color.

Parameters

  • text color: The color for the object. Color in SVG is defined by the CSS data type so this could be defined a keyword, the RGB cubic-coordinate system, or the HSL cyclindrical-coordinate system.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetColor("green")

SetDescription(text description)

This action will give a description to a ScalableVectorGraphicsObject. When an object has a non-empty description a description tag will be generated when the whole object is written out. A description in SVG functions similarly to the description of an image in HTML.

Parameters

  • text description: The text that will be the description of the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetDescription("This is my circle and it will be blue")

SetFill(Libraries.Game.Graphics.Color fill)

This action will give a fill attribute to the SVG element. This attribute may do different things depending on the type of SVG element. For shapes and text it will define the color used to paint the object

Parameters

  • Libraries.Game.Graphics.Color: The fill attribute for the object. For shapes and text this will be a color and color in SVG is defined by the CSS data type so this could be defined a keyword, the RGB cubic-coordinate system, or the HSL cyclindrical-coordinate system.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

use Libraries.Game.Graphics.Color

Color blue
blue:SetColor(0, 0, 1, 1)

Circle circle
circle:SetFill(blue)

SetFill(text fill)

This action will give a fill attribute to the SVG element. This attribute may do different things depending on the type of SVG element. For shapes and text it will define the color used to paint the object

Parameters

  • text fill: The fill attribute for the object. For shapes and text this will be a color and color in SVG is defined by the CSS data type so this could be defined a keyword, the RGB cubic-coordinate system, or the HSL cyclindrical-coordinate system.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetFill("green")

SetFillOpacity(text opacity)

This action will give a fill attribute to the SVG element. This attribute may do different things depending on the type of SVG element. For shapes and text it will define the color opaqueness used to paint the object

Parameters

  • text opacity: The fill opacity attribute for the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetFill("green")
circle:SetFillOpacity("50%") // alternate: circle:SetFillOpacity("0.5")

SetFillOpacity(number opacity)

This action will give a fill attribute to the SVG element. This attribute may do different things depending on the type of SVG element. For shapes and text it will define the color opaqueness used to paint the object

Parameters

  • number opacity

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

use Libraries.Game.Graphics.Color

Color blue
blue:SetColor(0, 0, 1, 1)

Circle circle
circle:SetFill(blue)
circle:SetFillOpacity(0.7)

SetFillOpacity(Libraries.Game.Graphics.Color opacity)

This action will give a fill attribute to the SVG element. This attribute may do different things depending on the type of SVG element. For shapes and text it will define the color opaqueness used to paint the object

Parameters

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

use Libraries.Game.Graphics.Color

Color blue
blue:SetColor(0, 0, 1, 1)

Circle circle
circle:SetFill(blue)
circle:SetFillOpacity(blue) // alternate: circle:SetFillOpacity("1")

SetFontFamily(text fontFamily)

This action sets the current font-family to the list of fonts give (can list multiple with comma-delimited list).

Parameters

  • text fontFamily

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetFontFamily("Arial")
myLabel:SetFontFamily("Arial, Halvetica, sans-serif")

output myLabel:GetFontSize()

SetFontSize(text fontSize)

This action sets the current font size with the unit appended.

Parameters

  • text fontSize

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetFontSize("12pt")

output myLabel:GetFontSize()

SetHorizontalShift(number dx, text unit)

This action sets how much to shift the text on the x axis from its position.

Parameters

  • number dx: The amount of shift on the x axis.
  • text unit: The unit of the length given.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetHorizontalShift(50, "%")

SetHorizontalShift(number dx)

This action sets how much to shift the text on the x axis from its position.

Parameters

  • number dx: The amount of shift on the x axis.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetHorizontalShift(12)

SetID(text id)

This action will give an ID attribute to the SVG element. This is useful in contexts where you need to reference an SVG element by a name such as when using a styling sheet with the SVG file.

Parameters

  • text id: The id of the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetID("circle1")

SetIsContainer(boolean isContainer)

This action is used internally by the system to designate whether the SVG element is a single tag or contains more objects within it.

Parameters

  • boolean isContainer: true if it will contain other objects, false if not

SetIsOneLine(boolean isOneLine)

This action is used internally by the system to designate whether the SVG element should print with new lines.

Parameters

  • boolean isOneLine

SetOnBlur(text onBlur)

This action will give a blur event handler attribute to the SVG element. This blur can be for general use by a web browser.

Parameters

  • text onBlur: The onblur for the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Group group
group:SetOnBlur("console.log('hello world');")

SetOnFocus(text onFocus)

This action will give a focus event handler attribute to the SVG element. This focus can be for general use by a web browser.

Parameters

  • text onFocus: The onfocus for the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Group group
group:SetOnFocus("console.log('hello world');")

SetPosition(number x, number y, text unit)

This action sets the position of the label. Note that text in SVG is positioned based where the text anchor is.

Parameters

  • number x: The x position of the label.
  • number y: The y position of the label.
  • text unit: The unit of the length given.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetPosition(50,50, "em")

SetPosition(number x, number y)

This action sets the position of the label. Note that text in SVG is positioned based where the text anchor is.

Parameters

  • number x: The x position of the label.
  • number y: The y position of the label.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetPosition(60,60)

SetPositionX(number x, text unit)

This action sets the x position of the label. Note that text in SVG is positioned based where the text anchor is.

Parameters

  • number x: The x position of the label.
  • text unit: The unit of the length given.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetPositionX(12,"em")

SetPositionX(number x)

This action sets the x position of the label. Note that text in SVG is positioned based where the text anchor is.

Parameters

  • number x: The x position of the label.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetPositionX(60)

SetPositionY(number y)

This action sets the y position of the label. Note that text in SVG is positioned based where the text anchor is.

Parameters

  • number y: The y position of the label.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetPositionY(60)

SetPositionY(number y, text unit)

This action sets the y position of the label. Note that text in SVG is positioned based where the text anchor is.

Parameters

  • number y: The y position of the rectangle.
  • text unit: The unit of the length given.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetPositionY(12,"em")

SetRole(text role)

This action will give a role attribute to the SVG element. This role can be for general use by a web browser.

Parameters

  • text role: The role name for the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetRole("region")

SetRotation(integer degrees)

This action sets how much to rotate each individual glyph of the text.

Parameters

  • integer degrees: The amount of rotation in degrees.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetRotation(270)

SetStroke(text stroke)

This action will give a stroke attribute to the SVG element. This attribute defines the color used to paint the outline of a shape. For shapes like lines that have no fill a stroke must be set so that the line will be visible.

Parameters

  • text stroke: The stroke attribute for the object. For shapes and text this will be a color and color in SVG is defined by the CSS data type so this could be defined a keyword, the RGB cubic-coordinate system, or the HSL cyclindrical-coordinate system.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetStroke("navy")

SetStroke(Libraries.Game.Graphics.Color stroke)

This action will give a stroke attribute to the SVG element. This attribute defines the color used to paint the outline of a shape. For shapes like lines that have no fill a stroke must be set so that the line will be visible.

Parameters

  • Libraries.Game.Graphics.Color: The stroke attribute for the object. For shapes and text this will be a color and color in SVG is defined by the CSS data type so this could be defined a keyword, the RGB cubic-coordinate system, or the HSL cyclindrical-coordinate system.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

use Libraries.Game.Graphics.Color

Color blue
blue:SetColor(0, 0, 1, 1)

Circle circle
circle:SetStroke(blue)

SetStrokeOpacity(number opacity)

This action will give a stroke opacity attribute to the SVG element. This attribute may do different things depending on the type of SVG element. For shapes and text it will define the color opaqueness used to paint the border of the object

Parameters

  • number opacity

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

use Libraries.Game.Graphics.Color

Color blue
blue:SetColor(0, 0, 1, 1)

Circle circle
circle:SetStroke(blue)
circle:SetStrokeOpacity(0.7)

SetStrokeOpacity(text opacity)

This action will give a stroke opacity attribute to the SVG element. This attribute may do different things depending on the type of SVG element. For shapes and text it will define the color opaqueness used to paint the border of the object

Parameters

  • text opacity: The stroke opacity attribute for the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetStroke("green")
circle:SetStrokeOpacity("50%") // alternate: circle:SetStrokeOpacity("0.5")

SetStrokeOpacity(Libraries.Game.Graphics.Color opacity)

This action will give a stroke opacity attribute to the SVG element. This attribute may do different things depending on the type of SVG element. For shapes and text it will define the color opaqueness used to paint the border of the object

Parameters

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

use Libraries.Game.Graphics.Color

Color blue
blue:SetColor(0, 0, 1, 1)

Circle circle
circle:SetStroke(blue)
circle:SetStrokeOpacity(blue) // alternate: circle:SetStrokeOpacity("1")

SetStrokeWidth(number strokeWidth)

This action sets the width of the stroke of the SVG element. Shapes with an outline have a stroke width.

Parameters

  • number strokeWidth: The width of the stroke

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetStrokeWidth(5)

SetStrokeWidth(number strokeWidth, text unit)

This action sets the width of the stroke of the SVG element along with which unit to use. Shapes with an outline have a stroke width. In SVG, units are defined by unit identifiers giving by the CSS specification along with percentages.

Parameters

  • number strokeWidth: The width of the stroke
  • text unit: The unit of the length given.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetStrokeWidth(5, "%")

SetStyle(text style)

This action will give a style attribute to the SVG element. This attribute also for embedding CSS declarations inline with the SVG element. Use of this attribute requires knowledge of CSS.

Parameters

  • text style: The style information that will be added to the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetStyle("fill: skyblue; stroke: navy;")

SetStyleClass(text styleClass)

This action will give a class attribute to the SVG element. This class can be for gerneral use by a web browser or for when using a styling sheet on the SVG file.

Parameters

  • text styleClass

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetStyleClass("circleClass")

SetTabIndex(integer tabIndex)

This action will give the ScalableVectorGraphicsObject a tab index. A non-negative tab index attribute will allow the element to be focusable and it can define the relative order for sequential navigation with the tab key. If two objects have the same tab index then whichever was added first is first in the naviagation. Default is 0 which means the item is focusable.

Parameters

  • integer tabIndex: The index of the object in the tab navigation.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle1
Circle circle2
Circle circle3
circle1:SetTabIndex(1)
circle2:SetTabIndex(2)
circle3:SetTabIndex(3)

SetText(text labelText)

This action sets the text that this element will render.

Parameters

  • text labelText: the text that this label will show

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetText("Words Words and more words")

SetTextAnchor(text textAnchor)

This action sets where the text anchor is. The text anchor affects how a text chunk is aligned to the point that is the label's position. Possible values are start, middle, and end. By default a label will use start.

Parameters

  • text textAnchor

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetTextAnchor("middle")

SetTextLength(number textLength, text unit)

This action sets the width that the text of the label will be scaled to fit.

Parameters

  • number textLength: the width that the text will be fit to.
  • text unit: The unit of the length given.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetTextLength(10,"%")

SetTextLength(number textLength)

This action sets the width that the text of the label will be scaled to fit.

Parameters

  • number textLength: the width that the text will be fit to.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetTextLength(50)

SetTitle(text title)

This action will give a title to a ScalableVectorGraphicsObject. When an object has a non-empty title a title tag will be generated when the whole object is written out which will show the title as a popup box when hovering over the object in the final SVG file.

Parameters

  • text title: The text that will be the title of the object.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Circle circle
circle:SetTitle("My Circle")

SetTransform(text transform)

This action sets a transform on the current element.

Parameters

  • text transform

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetTransform("rotate(270,100,100)")

SetVerticalShift(number dy, text unit)

This action sets how much to shift the text on the y axis from its position.

Parameters

  • number dy: The amount of shift on the y axis.
  • text unit: The unit of the length given.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetVerticalShift(50, "%")

SetVerticalShift(number dy)

This action sets how much to shift the text on the y axis from its position.

Parameters

  • number dy: The amount of shift on the y axis.

Example

Libraries.Data.Formats.ScalableVectorGraphics.all

Label myLabel
myLabel:SetVerticalShift(12)

ToText()

This action writes out all of the necessary tags and attributes that make up this label. This action will be called automatically by the parent ScalableVectorGraphics, as such this action does not need to be used directly by the user.

Return

text: the formatted string of all tags and attributes for this shape