Character Assets
R2026bDefine characters or pedestrians to add to driving scenarios
Since R2022b
Description
Character assets are secondary actors used to populate driving scenarios. By dragging
pedestrian assets from the Characters folder of the Library
Browser into the editing canvas, you can create dynamic driving scenarios with
pedestrians.
Characters use the same tools to specify their path behavior within a scene as vehicles. For more information on specifying path behaviors, see Path Editing.
Creation
You can create new character assets either from directly within the Library Browser or by importing character meshes created outside of RoadRunner into the Library Browser
Create Within Library Browser
From the Library Browser, select the Characters
folder. Right-click in the Library Browser and, from the context menu,
select New, then Character to create a new
character asset with the extension .rrchar.rrmeta. The asset browser
displays this new character as a cuboid shape.


You can then customize the attributes of the character from the Attributes pane. For details on the attributes you can customize, see Placeholder Character Dimensions.
Create from Imported Character Meshes
To import character meshes created outside of RoadRunner into the Library Browser, you must define them in such a way as to make them compatible with scenarios. For more details, see Import Custom Character Meshes.
Character Asset Parameters
Character assets in the Library Browser have attributes that are common across all assets of that type. When you select a character from the Library Browser, you can view these attributes in the Attributes pane. These attributes are applied during scenario design and simulation, and they are included in exported ASAM OpenSCENARIO® files. This table describes the attributes. The default value of each attribute depends on the character type.
| Attribute | Description |
|---|---|
| Category | Category of character, such as Pedestrian,
Animal, or Wheelchair. |
| Skin | FBX file containing the mesh and skeletal rig. |
| Skeleton | FBX file containing the mesh and skeletal rig. |
| Idle Animation | FBX file containing an idle animation generated from the
skeletal rig in the Skeleton attribute. |
| Walk Animation | FBX file containing a walking animation generated from the
skeletal rig in the Skeleton attribute. |
| Run Animation | FBX file containing a running animation generated from the
skeletal rig in the Skeleton attribute. |
Placeholder Character Dimensions
If you create new pedestrians within the Library Browser, then you can modify additional attributes for the pedestrian dimensions. To modify these dimensions, select the character you created in the Library Browser and modify the attributes under Placeholder Character Dimensions. RoadRunner Scenario displays the updated dimensions in the asset viewer and in any characters of this type added to the scenario. This table describes the placeholder character dimensions.
| Attribute | Description |
|---|---|
| Width | Width of the character, in meters, specified as a scalar in the range [0.1, 20].
Default: |
| Length | Length of the character, in meters, specified as a scalar in the range [0.1, 20].
Default: |
| Height | Height of the character, in meters, specified as a scalar in the range [0.1, 20].
Default: |
Character Instance Parameters
When you select a single instance of a character asset that has been placed in a scenario, you can use the Attributes pane to view and set attributes that are specific to that character instance.
Actor Attributes
Using these attributes, you can modify the appearance and behavior of character actors in your scenario
| Attribute | Description |
|---|---|
| Type | Actor type, such as Vehicle, Character, Movable Object, or Traffic Signal. This value is read-only |
| Name | Name of the character. In the Logic editor, this name displays in the action phases that apply to that character. |
| Actor Id | Unique ID for the actor. You can modify the actor ID by changing its value in the Attributes pane. |
| Color | Color of character. To change a character color, select the current color from the Color attribute box and set the color in the Set Color dialog box. This applies to only the Placeholder Pedestrian character. |
| Actor Asset | Asset used to display the actor in the scenario. To select a new asset for the selected actor, drag an asset from the Library Browser into the Actor Asset attribute box. |
| Behavior | Behavior of the character. If you do not specify a behavior, then the character either follows its lane or moves along its specified path during simulation. To specify a character behavior, drag a behavior asset from the Library Browser onto the Behavior attribute box. You can specify behaviors defined in RoadRunner, in MATLAB® or Simulink®, or in external simulators such as CARLA. For more details, see Specify and Assign Actor Behaviors. |
Connection Attributes
Use these attributes to connect actors together.
| Attribute | Description |
|---|---|
| Parent Attachment | Parent attachment for the current character. When you assign a parent attachment, the Attributes pane changes to show the Connection Attributes. |
Point Offsets
Using these attributes, you can specify the character relative to a specific point in the scenario, such as a road anchor, path waypoint, vehicle, or another character.
| Attribute | Description |
|---|---|
| Enable Anchoring | Enable character to anchor to another point. By default, this attribute is enabled. |
| Position | Position of character within the scene. Specify the xyz-position of the character by using the X, Y, and Z attributes. Units are in meters. The position is relative to the center of the scene. To enable this attribute, you must clear the Enable Anchoring attribute. |
| Anchor | Anchor point that the character is offset from. An anchor point can be a road anchor, path waypoint, vehicle, or another character. To select an anchor point, first click the
attribute box. Then select an anchor point from the scenario editing canvas or the
Logic editor. RoadRunner outlines these selection areas with blue lines. To frame the camera
around the current anchor point in the scenario, click the Frame object in the
scene button |
| Lock To Anchor | Lock the character to its current anchor no matter where you drag it within the scenario. If you do not select this attribute, then the character locks to new road anchors as you drag it onto different roads. By default, this attribute is not selected. |
| Forward Offset | Distance, in meters, that the character is in front of its anchor point. |
| Reference Line | Reference line from which to measure the forward offset of the character
from its anchor point, specified as
|
Lane Offset
Using these attributes, you can place a character relative to the road edge and relative to the lane they are in.
When specifying lane offsets, keep these points in mind:
Lane offsets can be relative to the road edge only (Relative To attribute value must be
Road Edge) attribute. You cannot offset characters from the lanes that other characters or vehicles are in.Lateral offsets within a lane (Lateral Offset attribute) are positive to the right of the character.
These sample attributes show the key values that you can set.
| Attributes | Description |
|---|---|
Relative To — Offset From —
Lane
Offset — Travel Direction —
Lateral
Offset — Direction — | Set character traveling in the same direction as the road anchor. Offset the character 1.5 meters to the right from the lane.
|
Relative To — Offset From —
Lane
Offset — Travel Direction —
Lateral
Offset — Direction — | Set character in the lane along the left road edge, traveling in the opposite direction of the road anchor. Offset the character 1.5 meters to the left within the lane.
|
Connection Attributes
When you connect a character actor as a child to another actor, you can set attributes that are specific to the child actor from the Attributes pane. These sections describe the attributes you can set.
Note
The connection attributes only become available when the actor gets attached as a child to a parent actor.
Use these attributes to connect actors together.
| Attribute | Description |
|---|---|
| Parent Attachment | Name of the parent actor that the current actor attaches to. |
| Type | Specify the behavior of the child actor relative to the parent. Select
|
Use these attributes to edit the attachment point with respect to the selected child
actor, and the Parent Attachment point.
| Attribute | Description |
|---|---|
| Source | To generate an attachment point from the bounding box geometry of the
character, select |
| Point Name | When the Source attribute value is
When the Source attribute value is
|
| Value | Position, (x,y,z), of the contact point relative to the origin of the child actor. Units are in meters. This value is read-only. |
| Attribute | Description |
|---|---|
| Source | Specify the attachment point on the parent actor. To generate an
attachment point from the bounding box geometry of the character, select
|
| Point Name | When the Source attribute value is
When the Source attribute value is
|
| Value | Position, (x,y,z), of the contact point relative to the origin of the parent actor. Units are in meters. This value is read-only. |
Use these attributes to specify the child actor offset and direction to the parent contact point.
| Attribute | Description |
|---|---|
| Offset Right | Lateral offset, in meters, of the actor relative to the parent contact point. Positive values offset the actor to the right of the parent. Default: |
| Offset Forward | Forward offset, in meters, of the actor relative to the parent contact point. Default: |
| Offset Up | Vertical offset, in meters, of the actor relative to the parent contact point. Default: |
| Heading | Horizontal direction, in degrees, of the actor relative to the parent contact point. When you select an actor, you can also modify the Heading value the editor using the direction widget, shown in this image, when the actor is selected.
Default: |
| Slope | Slope or pitch, in degrees, of the actor relative to the parent contact point. |








