Roadrunner Asset Mapping

RoadRunner Asset Mapping

Consolidated lookup tables for mapping source map format elements to RoadRunner project asset paths. All paths are relative to the project Assets/ folder.

When to Use

• Resolving lane marking subtypes to RoadRunner .rrlms asset paths
• Mapping sign codes (US MUTCD, German StVO, Japanese) to sign asset SVGs
• Looking up barrier/extrusion asset paths for fence, guard rail, jersey barrier, wall
• Finding prop/static object asset paths for placement in RRHD
• Determining region-specific sign paths based on geoReference coordinates
• Assigning lane type enums from source format lane classifications

When NOT to Use

• Building RRHD objects from scratch — use roadrunner-rrhd-authoring
• Performing the full Lanelet2 conversion pipeline — use roadrunner-convert-lanelet2-to-rrhd
• Importing maps into RoadRunner — use roadrunner-import-scene

Key Rules

• All asset paths start with Assets/ — always prefix when constructing RelativeAssetPath objects.
• Extension matters. .rrlms = lane marking style, .rrcws = crosswalk style, .rrpms = polygon marking style, .svg_rrx = sign. Using wrong extension causes "Asset file is missing" on import.
• Signs use .svg_rrx extension (NOT .svg). The .svg paths in XML configs are internal references only.
• Sign naming: descriptive English names with region suffix (e.g., Stop_JP_01.svg_rrx, MaxSpeedLimit_30_DE.svg_rrx). The old Sign_<code>.svg naming is obsolete.
• Region detection from geoReference. Use lat/lon to determine Japan/Germany/US for sign and marking paths.
• Runtime asset discovery is MANDATORY for signs. Asset names vary by version — always verify file exists before assigning.

Source Data

Asset mappings are derived from the official RoadRunner project configuration XMLs:

• DefaultAssets.xml — default materials and markings
• ApolloAssetData.xml — Apollo/Baidu HD Map format
• OpenDriveAssetData.xml — OpenDRIVE format
• HEREAssetData_NA.xml / HEREAssetData_WE.xml — HERE HD Map (NA/EU)
• TomTomAssetData.xml — TomTom HD Map format

These XML files are located in the RoadRunner project's configuration directory (typically <RoadRunner Project>/Configuration/).

Lane Markings

See references/laneMarkings.md for full mapping table.

Key patterns:

• All marking assets are in Assets/Markings/ with .rrlms extension
• Markings are keyed by type (solid/dashed/double) + color (white/yellow)
• Default road center marking: SolidDoubleYellow.rrlms
• Default outer boundary: SolidSingleWhite.rrlms

Signs

See references/signs.md for full mapping table.

CRITICAL: Asset File Extension

• RoadRunner sign assets use .svg_rrx extension on disk (NOT .svg)
• The .svg paths in project XML configs are internal references only
• Always use .svg_rrx in RelativeAssetPath objects — using .svg causes "Could not find asset" errors

MANDATORY: Runtime Asset Discovery

• Sign asset names vary by RoadRunner version and installed asset libraries
• Always verify at runtime that the target asset exists before assigning it
• Use dir(fullfile(projFolder, 'Assets', 'Signs', region, category, '*.svg_rrx')) to discover available signs

Key patterns:

• US signs: Assets/Signs/US/Regulatory Signs/ or Assets/Signs/US/Warning Signs/
• German signs: Assets/Signs/Germany/Regulatory Signs/
• Japan signs: Assets/Signs/Japan/Regulatory Signs/ or Assets/Signs/Japan/Warning Signs/
• Sign geometry uses GeoOrientedBoundingBox (Center + Dimension + GeoOrientation)

Naming convention: Signs use descriptive English names with region suffix:

• Pattern: <Description>_<Region>.svg_rrx (e.g., Stop_JP_01.svg_rrx, MaxSpeedLimit_30_JP.svg_rrx)
• The old Sign_<code>.svg naming is obsolete — files do NOT exist on disk

Region detection from geoReference:

lat = geoRef(1); lon = geoRef(2);
if lat >= 24 && lat <= 46 && lon >= 122 && lon <= 154
    region = "Japan";
elseif lat >= 35 && lat <= 72 && lon >= -10 && lon <= 25
    region = "Germany";
else
    region = "US";
end

Region-specific sign paths (verified R2026a with RoadRunner_Asset_Library):

| Sign | Japan | US | Germany |

|---|---|---|---|

| Stop | Signs/Japan/Regulatory Signs/Stop_JP_01.svg_rrx | Signs/US/Stop_US.svg_rrx | Signs/Germany/Regulatory Signs/Stop_DE.svg_rrx |

| Yield | — | Signs/US/Yield_US.svg_rrx | Signs/Germany/Regulatory Signs/Yield_DE.svg_rrx |

| Speed N | Signs/Japan/Regulatory Signs/MaxSpeedLimit_<N>_JP.svg_rrx | Signs/US/Regulatory Signs/MaxSpeedLimit_<N>_US.svg_rrx | Signs/Germany/Regulatory Signs/MaxSpeedLimit_<N>_DE.svg_rrx |

| Fallback | Signs/Japan/Regulatory Signs/SlowDown_JP_01.svg_rrx | Signs/US/White_Blank_US.svg_rrx | Signs/Germany/Warning Signs/Danger_DE.svg_rrx |

Signals (Traffic Lights)

| Configuration | Asset Path |

|---|---|

| 3-light vertical (post) | Props/Signals/Signal_3Light_Post01.fbx |

| 3-light vertical (bare) | Props/Signals/Signal_3Light_Bare01.fbx_rrx |

Authoring vs Import limitation: You CAN author SignalType objects (add to rrMap.SignalTypes) and Signal instances (add to rrMap.Signals) in MATLAB and write the map to .rrhd — signal data IS written to the file and survives read/write cycles. However, RoadRunner silently ignores signals when importing .rrhd maps — signals will not appear in the RoadRunner scene after import. Show the asset paths and authoring code, but warn the user about this import limitation.

Barriers & Extrusions

See references/barriers.md for full mapping table.

Key patterns:

• All extrusions in Assets/Extrusions/ with .rrext or .rrext.rrmeta extension
• Barriers use roadrunner.hdmap.BarrierType with ExtrusionPath

Props & Static Objects

See references/staticObjects.md for full mapping table.

Key patterns:

• Props in Assets/Props/ subdirectories (Trees, Signals, TrafficControl, etc.)
• Static objects use roadrunner.hdmap.StaticObjectType with AssetPath
• Objects use GeoOrientedBoundingBox for placement

Lane Types

See references/laneTypes.md for full mapping table.

Crosswalks & Curve Markings

Extension rules (commonly confused):

• .rrcws = crosswalk style (only for actual crosswalks)
• .rrlms = lane marking style (stop lines, bike markings, zig-zag)
• .rrpms = polygon marking style (striped regions, chevrons)
• .rrcws_rrx / .rrlms_rrx = region-specific variants (Japan, Germany, etc.)

Base assets (universal):

| Type | Asset Path | Extension |

|---|---|---|

| Simple crosswalk | Markings/SimpleCrosswalk.rrcws | .rrcws |

| Continental crosswalk | Markings/ContinentalCrosswalk.rrcws | .rrcws |

| Ladder crosswalk | Markings/LadderCrosswalk.rrcws | .rrcws |

| Stop line | Markings/StopLine.rrlms | .rrlms |

| Striped region | Markings/StripedRegion.rrpms | .rrpms |

Japan-specific markings (.rrlms_rrx / .rrcws_rrx):

| Type | Asset Path |

|---|---|

| Stop line | Markings/Japan/StopLine_JP.rrlms_rrx |

| Crosswalk | Markings/Japan/SimpleCrosswalk_JP.rrcws_rrx |

| Solid single white | Markings/Japan/SolidSingleWhite_JP.rrlms_rrx |

| Dashed single white | Markings/Japan/DashedSingleWhite_JP.rrlms_rrx |

| Solid double white | Markings/Japan/SolidDoubleWhite_JP.rrlms_rrx |

| Solid double yellow | Markings/Japan/SolidDoubleYellow_JP.rrlms_rrx |

Germany-specific markings:

| Type | Asset Path |

|---|---|

| Stop line | Markings/Germany/StopLine_DE.rrlms_rrx |

| Crosswalk | Markings/Germany/SimpleCrosswalk_DE.rrcws_rrx |

Region selection: Use base (non-regional) assets as default. Use regional variants when the map's geoReference indicates a specific region AND the regional asset exists in the project.

Stencils (Road Surface Markings)

| Type | Asset Path |

|---|---|

| Arrow left | Assets/Stencils/Stencil_ArrowType4L.svg |

| Arrow right | Assets/Stencils/Stencil_ArrowType4R.svg |

| STOP text | Assets/Stencils/Stencil_STOP.svg |

Materials

| Purpose | Asset Path |

|---|---|

| Road surface | Assets/Materials/Asphalt1.rrmtl |

| Sidewalk / concrete | Assets/Materials/Concrete1.rrmtl |

| Ground / grass | Assets/Materials/Grass1.rrmtl |

Default Assets

These are the project-wide defaults (from DefaultAssets.xml):

| Name | Path |

|---|---|

| Island Curb Material | Assets/Materials/Concrete1.rrmtl |

| Blank Sign | Assets/Signs/US/White_Blank_US.svg_rrx |

| Blank Warning Sign | Assets/Signs/US/Yellow_Blank_US.svg_rrx |

| Surface Material | Assets/Materials/Grass1.rrmtl |

| Crosswalk | Assets/Markings/SimpleCrosswalk.rrcws |

| Stop Line | Assets/Markings/StopLine.rrlms |

| Parking Space Marking | Assets/Markings/SolidSingleWhite.rrlms |

| Road Surface Material | Assets/Materials/Asphalt1.rrmtl |

| Road Center Marking | Assets/Markings/SolidDoubleYellow.rrlms |

| Dashed Road Marking | Assets/Markings/DashedSingleWhite.rrlms |

| Road Outer Boundary | Assets/Markings/SolidSingleWhite.rrlms |

| Road Inner Boundary | Assets/Markings/SolidSingleYellow.rrlms |

| One Way Passing | Assets/Markings/DashedSolidYellow.rrlms |

| Vehicle | Assets/Vehicles/Sedan.fbx |

Usage Pattern (MATLAB)

% Example: resolve marking asset path
function assetPath = resolveMarkingAsset(type, color)
    % type: "solid", "dashed", "solid_solid", etc.
    % color: "white", "yellow" (default: white)
    if nargin < 2, color = "white"; end
    % Use lookup from references/laneMarkings.md
end

All asset paths are prefixed with Assets/ when used in RRHD RelativeAssetPath objects.

Conventions

• All marking assets: Assets/Markings/<Name>.<ext> — extension determines type (.rrlms, .rrcws, .rrpms)
• Regional marking variants: Assets/Markings/<Region>/<Name>_<CC>.<ext>_rrx (e.g., _JP.rrlms_rrx)
• All sign assets: Assets/Signs/<Region>/<Category>/<Description>_<CC>.svg_rrx (NOT .svg)
• All extrusion assets: Assets/Extrusions/<Name>.rrext (or .rrext.rrmeta)
• All prop assets: Assets/Props/<Category>/<Name>.fbx (or .fbx_rrx)
• Use RelativeAssetPath(AssetPath="...") for RRHD construction (Name=Value syntax)
• Default road center: SolidDoubleYellow.rrlms; default outer boundary: SolidSingleWhite.rrlms
• Always verify asset exists at runtime before assigning — paths vary by version and installed libraries

----

Copyright 2026 The MathWorks, Inc.