sim3d.graphics.Text
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
creates a
default text actor object in the 3D environment.text
= sim3d.graphics.Text()
specifies options using one or more name-value arguments. For example, to create a text
actor at the position [0,1,1], set text
= sim3d.graphics.Text(Name=Value
)Translation
to
[0,1,1]
.
Input 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.
ActorName
— Name of actor
autogenerated name (default) | character array | string
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.
Translation
— Relative translation
[0,0,0]
(default) | real N-by-3 array
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
Rotation
— Relative rotation
[0,0,0]
(default) | real N-by-3 array
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
Color
— Base color of actor
[1,0,0]
(default) | real N-by-3 array
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
String
— Text to display
" " (default) | string N-by-1 vector
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
FontSize
— Horizontal and vertical scale of text
1
(default) | real positive N-by-1 vector
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
Hidden
— Option to hide actor
0
or false
(default) | 1
or true
| logical N-by-1 vector
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
Parent
— Parent of actor
handle to parent actor object
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.
Children
— Children of actor
structure
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.
ParentWorld
— Parent world
handle to parent world 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.
CoordinateSystem
— Actor orientation
'Default'
(default) | 'MATLAB'
| 'ISO8855'
| 'AERO'
| 'VRML'
| 'SAE'
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
Rotation
|
|
'MATLAB' | The MATLAB® coordinate system, in m and rad. Axes
Rotation
|
|
'ISO8855' | The ISO 8855 standard coordinate system, in m and deg. For more information, see ISO Standards. Axes
Rotation
|
|
'AERO' | The coordinate system for aerospace applications, in m and rad. For more information, see Body Coordinates (Aerospace Blockset). Axes
Rotation
|
|
'VRML' | The X3D ISO standard coordinate system, in m and rad. Axes
Rotation
|
|
'SAE' | The SAE J670 standard coordinate system, in m and rad. For more information, see SAE International Standards. Axes
Rotation
|
|
Data Types: string
Translation
— Relative translation
[0,0,0]
(default) | real N-by-3 array
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]
Rotation
— Relative rotation
[0,0,0]
(default) | real N-by-3 array
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]
Color
— Base color of actor
[1,0,0]
(default) | real N-by-3 array
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
String
— Text to display
" " (default) | string N-by-1 vector
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
FontSize
— Horizontal and vertical scale of text
1
(default) | real positive N-by-1 vector
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
Hidden
— Option to hide actor
0
or false
(default) | 1
or true
| logical N-by-1 vector
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
See Also
sim3d.graphics.Arrow
| sim3d.Actor
| sim3d.World
| add
| run
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)