Main Content

sim3d.graphics.Text

Create text actor

Since R2024a

    Description

    Use the sim3d.graphics.Text object to create a text object in the 3D environment for displaying relevant information data during simulation. After you create a sim3d.graphics.Text object, you can modify the aspects of the text actor by setting property values. You can create N number of text actors in the 3D environment.

    Creation

    Description

    text = sim3d.graphics.Text() creates a default text actor object in the 3D environment.

    text = sim3d.graphics.Text(Name=Value) specifies options using one or more name-value arguments. For example, to create a text actor at the position [0,1,1], set Translation to [0,1,1].

    Input Arguments

    expand all

    Name-Value Arguments

    Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

    Example: text = sim3d.graphics.Text(ActorName='Text',Translation=[0,1,1],Color=[1,1,0],String="Hello") creates a text actor with the specified actor name, position, color, and string.

    Example: texts = sim3d.graphics.Text(ActorName='Texts',Translation=[0,-1,1; 0,0,1; 0,1,1],Color=[1,1,0; 1,0,0; 0,1,0],String=["Hello"; "3D"; "World"]) creates three text actors with the specified actor name, positions, colors, and strings.

    Name of actor, specified as a character array or string. If you do not specify an actor name, then the software assigns the actor an autogenerated name. Use this argument to set the name of the sim3d.graphics.Text object.

    Note

    If you specify the same name as an actor that already exists, then the software appends actor name you specify with a unique identifier.

    Relative translation (x,y,z) of the actor object to its parent actor, specified as a real N-by-3 array, in m. N specifies the number of actors. When you add an actor to the 3D environment, the default parent actor is the Scene Origin at (0,0,0).

    Example: Translation=[3,4,3]

    Example: Translation=[3,2,3; 3,5,3; 3,3,3]

    Data Types: double

    Relative rotation (roll, pitch, yaw) of the actor object to its parent actor, specified as a real N-by-3 array, in rad.

    Example: Rotation=[0,pi/2,-pi/4]

    Example: Rotation=[0,pi/2,-pi/4; 0,pi/2,-pi/4; 0,pi/2,-pi/4]

    Data Types: double

    Base color of actor, specified as real N-by-3 array of RGB triplet values. An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green and blue components of the color. The intensities must be in the range [0, 1].

    Example: Color=[0,1,0]

    Example: Color=[1,0,0; 0,0,1; 1,1,0]

    Data Types: double

    Text to display in 3D environment, specified as string N-by-1 vector. The default value is an empty string "".

    Example: String="Hello"

    Example: String=["Hello"; "3D"; "World"]

    Data Types: string

    Horizontal and vertical scale of text, specified as real positive N-by-1 vector. The default value 1 represents the original size of the text. A value greater than or less than 1 increases or decreases the size of the text, respectively.

    Example: FontSize=2

    Example: FontSize=[1.5; 1.5; 1.5]

    Data Types: double

    Option to hide the actor from the 3D environment scene, specified as 0 (false) if the actor is visible in the scene or 1 (true) if the actor is hidden in the scene. For N number of actors, specify as a logical N-by-1 vector.

    Example: Hidden=1

    Example: Hidden=[1; 0; 1]

    Properties

    expand all

    Parent of actor, specified as a handle to the parent actor object. After you add an actor to the sim3d.World object, the default parent actor is the Scene Origin at [0,0,0]. Use this property to set any actor in the 3D environment as the parent actor of a sim3d.graphics.Text object.

    This property is read-only.

    Children of actor, specified as a structure. Each field of the structure contains a handle to the child of a sim3d.graphics.Text object.

    Parent world, specified as a handle to the parent sim3d.World object. You can use this property only if the sim3d.graphics.Text object is added to the parent sim3d.World object.

    Actor orientation representation in the 3D environment, specified as 'Default', 'MATLAB', 'ISO8855', 'AERO', 'VRML', or 'SAE'. The values are not case-sensitive. To display the actor transformation in the specified coordinate system, set this property first, and then set the transform properties Translation, Rotation, and Scale.

    Coordinate System Description
    'Default'

    The default coordinate system, in m and rad.

    Axes

    • X-axis points away from the viewer.

    • Y-axis points toward right.

    • Z-axis points upward.

    Rotation

    • Roll — Clockwise rotation about X-axis

    • Pitch — Clockwise rotation about Y-axis

    • Yaw — Counterclockwise rotation about Z-axis

    Three dimensional default coordinate system with X,Y,Z, Roll, Pitch, and Yaw labelled

    'MATLAB'

    The MATLAB® coordinate system, in m and rad.

    Axes

    • X-axis points away from the viewer.

    • Y-axis points toward left.

    • Z-axis points upward.

    Rotation

    • Roll — Clockwise rotation about X-axis

    • Pitch — Clockwise rotation about Y-axis

    • Yaw — Clockwise rotation about Z-axis

    Three dimensional MATLAB coordinate system with X,Y,Z, Roll, Pitch, and Yaw labelled

    'ISO8855'

    The ISO 8855 standard coordinate system, in m and deg. For more information, see ISO Standards.

    Axes

    • X-axis points away from the viewer.

    • Y-axis points toward left.

    • Z-axis points upward.

    Rotation

    • Roll — Clockwise rotation about X-axis

    • Pitch — Clockwise rotation about Y-axis

    • Yaw — Clockwise rotation about Z-axis

    Three dimensional ISO8855 coordinate system with X,Y,Z, Roll, Pitch, and Yaw labelled

    'AERO'

    The coordinate system for aerospace applications, in m and rad. For more information, see Body Coordinates (Aerospace Blockset).

    Axes

    • X-axis points away from the viewer.

    • Y-axis points toward right.

    • Z-axis points downward.

    Rotation

    • Roll — Clockwise rotation about X-axis

    • Pitch — Clockwise rotation about Y-axis

    • Yaw — Clockwise rotation about Z-axis

    Three dimensional aero coordinate system with X,Y,Z, Roll, Pitch, and Yaw labelled

    'VRML'

    The X3D ISO standard coordinate system, in m and rad.

    Axes

    • X-axis points away from the viewer.

    • Y-axis points upward.

    • Z-axis points toward right.

    Rotation

    • Roll — Clockwise rotation about X-axis

    • Pitch — Counterclockwise rotation about Y-axis

    • Yaw — Counterclockwise rotation about Z-axis

    Three dimensional VRML coordinate system with X,Y,Z, Roll, Pitch, and Yaw labelled

    'SAE'

    The SAE J670 standard coordinate system, in m and rad. For more information, see SAE International Standards.

    Axes

    • X-axis points away from the viewer.

    • Y-axis points toward right.

    • Z-axis points downward.

    Rotation

    • Roll — Clockwise rotation about X-axis

    • Pitch — Clockwise rotation about Y-axis

    • Yaw — Clockwise rotation about Z-axis

    Three dimensional SAE coordinate system with X,Y,Z, Roll, Pitch, and Yaw labelled

    Data Types: string

    Relative translation (x,y,z) of the actor object to its parent actor, specified as a real N-by-3 array, in m. N specifies the number of actors. When you add an actor to the 3D environment, the default parent actor is the Scene Origin at (0,0,0).

    Example: text.Translation = [1,2,1]

    Example: texts.Translation = [1,4,2; 1,3,2; 1,2,2]

    Relative rotation (roll, pitch, yaw) of the actor object to its parent actor, specified as a real N-by-3 array, in rad.

    Example: text.Rotation = [0,pi/2,pi/8]

    Example: texts.Rotation = [pi/2,pi/4,pi/2; 0,pi/4,pi/2; pi,pi/2,0]

    Base color of actor, specified as real N-by-3 array of RGB triplet values. An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green and blue components of the color. The intensities must be in the range [0, 1].

    Example: text.Color = [0,1,0]

    Example: texts.Color = [1,0,0; 0,0,1; 1,1,0]

    Data Types: double

    Text to display in 3D environment, specified as string N-by-1 vector. The default value is an empty string "".

    Example: text.String = "Hello"

    Example: texts.String = ["Hello"; "3D"; "World"]

    Data Types: string

    Horizontal and vertical scale of text, specified as real positive N-by-1 vector. The default value 1 represents the original size of the text. A value greater than or less than 1 increases or decreases the size of the text, respectively.

    Example: text.FontSize = 2

    Example: texts.FontSize = [3; 3; 3]

    Data Types: double

    Option to hide the actor from the 3D environment scene, specified as 0 (false) if the actor is visible in the scene or 1 (true) if the actor is hidden in the scene. For N number of actors, specify as a logical N-by-1 vector.

    Example: text.Hidden = 1

    Example: texts.Hidden = [1; 0; 1]

    Version History

    Introduced in R2024a