sim3d.graphics.Arrow
Description
Use the sim3d.graphics.Arrow
object to create an arrow object in the 3D
environment to visualize relevant vector data during simulation. After you create a
sim3d.graphics.Arrow
object, you can modify the aspects of the arrow actor by
setting property values. You can create N number of arrow actors in the 3D
environment using sim3d.graphics.Arrow
object.
Creation
Description
creates a
default arrow actor object in the 3D environment.actor
= sim3d.graphics.Arrow()
specifies options using one or more optional name-value arguments. For example, to create
an arrow actor at the position [0,1,0], set actor
= sim3d.graphics.Arrow(Name=Value
)Translation
to
[0,1,0]
.
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: arrow =
sim3d.graphics.Arrow(ActorName='Arrow',Translation=[3,4,3],Color=[1,1,0])
creates an arrow actor with the specified actor name, position and color.
Example: arrows = sim3d.graphics.Arrow(ActorName='Arrows',Translation=[3,2,3;
3,5,3; 3,3,3],Color=[1,1,0; 1,0,0; 0,1,0])
creates three arrow actors with the
specified actor name, positions and colors.
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.Arrow
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
Scale
— Relative scaling
[1,1,1]
(default) | real N-by-3 array
Relative scaling in x, y, and z coordinates of the actor object to its parent actor, specified as a real N-by-3 array.
Example: Scale=[1,2,1]
Example: Scale=[2,2,2; 2,2,2; 2,2,2]
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
Length
— Total length of arrow
1
(default) | real positive N-by-1 vector
Total length of arrow including the arrow head, specified as real positive N-by-1 vector, in m.
Example: Length=2
Example: Length=[0.5; 0.5; 0.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.Arrow
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.Arrow
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.Arrow
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: arrow.Translation = [1,2,1]
Example: arrows.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: arrow.Rotation = [0,pi/2,pi/8]
Example: arrows.Rotation = [pi/2,pi/4,pi/2; 0,pi/4,pi/2;
pi,pi/2,0]
Scale
— Relative scale
[1,1,1]
(default) | real N-by-3 array
Relative scaling in x, y, and z coordinates of the actor object to its parent actor, specified as a real N-by-3 array.
Example: arrow.Rotation = [0,pi/2,pi/8]
Example: arrows.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: arrow.Color = [0,1,0]
Example: arrows.Color = [1,0,0; 0,0,1; 1,1,0]
Data Types: double
Length
— Total length of arrow
1
(default) | real positive N-by-1 vector
Total length of arrow including the arrow head, specified as real positive N-by-1 vector, in m.
Example: arrow.Length = 2
Example: arrows.Length = [0.5; 0.5; 0.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: arrow.Hidden = 1
Example: arrows.Hidden = [1; 0; 1]
Version History
Introduced in R2024a
See Also
sim3d.graphics.Text
| sim3d.World
| sim3d.Actor
| add
| run
Commande MATLAB
Vous avez cliqué sur un lien qui correspond à cette commande MATLAB :
Pour exécuter la commande, saisissez-la dans la fenêtre de commande de MATLAB. Les navigateurs web ne supportent pas les commandes MATLAB.
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)