Main Content

Character Assets

R2026b

Define 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.

Menu option to create a new character in the Library Browser

Cuboid character with name New Character..rrchar.rrmeta in asset browser

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.

AttributeDescription
CategoryCategory of character, such as Pedestrian, Animal, or Wheelchair.
SkinFBX file containing the mesh and skeletal rig.
SkeletonFBX file containing the mesh and skeletal rig.
Idle AnimationFBX file containing an idle animation generated from the skeletal rig in the Skeleton attribute.
Walk AnimationFBX file containing a walking animation generated from the skeletal rig in the Skeleton attribute.
Run AnimationFBX 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.

AttributeDescription
Width

Width of the character, in meters, specified as a scalar in the range [0.1, 20].

Sample character width changes

Default: 0.50 meters

Length

Length of the character, in meters, specified as a scalar in the range [0.1, 20].

Sample character length changes

Default: 0.50 meters

Height

Height of the character, in meters, specified as a scalar in the range [0.1, 20].

Sample character with height changes

Default: 1.70 meters

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

AttributeDescription
Type

Actor type, such as Vehicle, Character, Movable Object, or Traffic Signal.

This value is read-only

NameName of the character. In the Logic editor, this name displays in the action phases that apply to that character.
Actor IdUnique ID for the actor. You can modify the actor ID by changing its value in the Attributes pane.
ColorColor 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 AssetAsset 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.

AttributeDescription
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.

AttributeDescription
Enable AnchoringEnable 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 AnchorLock 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 OffsetDistance, 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 Front, Middle, or Back. These images show the different reference lines, where the character has a Forward Offset of 0 meters from the road anchor.

  • Front

    Character with front reference line

  • Middle

    Character with middle reference line

  • Back

    Character with back reference line

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.

AttributesDescription

Relative To — Road Edge

Offset From — Left Lane

Lane Offset — 0 lane(s)

Travel Direction — With Road Anchor

Lateral Offset — 1.5 meters

Direction — To the right

Set character traveling in the same direction as the road anchor. Offset the character 1.5 meters to the right from the lane.

Character offset within lane and traveling in same direction as anchor

Relative To — Road Edge

Offset From — Right Lane

Lane Offset — 0 lane(s)

Travel Direction — Against Road Anchor

Lateral Offset — -1.5 meters

Direction — To the right

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.

Character offset within lane and traveling in opposite direction of anchor

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.

Connection Attributes

Use these attributes to connect actors together.

AttributeDescription
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 trailer to allow the actor to move and use independent dynamics relative to the parent actor. Select fixed to lock the child actor rotation to the dynamics of the parent actor.

Child Contact Point

Use these attributes to edit the attachment point with respect to the selected child actor, and the Parent Attachment point.

AttributeDescription
Source

To generate an attachment point from the bounding box geometry of the character, select Computed from Geometry. To use an attachment point defined in the FBX file, select Imported from File.

Point Name

When the Source attribute value is Imported from File, this attribute specifies the label of the point in the FBX file. The name of the node in the FBX file must either be hitch or start with attach to appear as an option for the Point Name attribute.

When the Source attribute value is Computed from Geometry, this attribute specifies the point in bounding box geometry.

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.

Parent Contact Point
AttributeDescription
Source

Specify the attachment point on the parent actor. To generate an attachment point from the bounding box geometry of the character, select Computed from Geometry. To use an attachment point defined in the FBX file, select Imported from File.

Point Name

When the Source attribute value is Imported from File, this attribute specifies the label of the point in the FBX file. The name of the node in the FBX file must either be hitch or start with attach to appear as an option for the Point Name attribute.

When the Source attribute value is Computed from Geometry, this attribute specifies the point in bounding box geometry.

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.

AttributeDescription
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: 0.0 meters

Offset Forward

Forward offset, in meters, of the actor relative to the parent contact point.

Default: 0.0 meters

Offset Up

Vertical offset, in meters, of the actor relative to the parent contact point.

Default: 0.0 meters

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.

Trailer heading widget

Default: 0.0 degrees

Slope

Slope or pitch, in degrees, of the actor relative to the parent contact point.

Version History

Introduced in R2022b

expand all