addSegmentedRoad

Add road with segmented curve type to RoadRunner scene

Since R2025a

collapse all in page

    Syntax

    rrRoad = addSegmentedRoad(scn,startPoint,roadStartDirection)

    Description

    rrRoad = addSegmentedRoad(scn,startPoint,roadStartDirection) creates a new segmented curve type road and adds it to the specified RoadRunner scene, scn. To create a segmented curve type road, specify the starting point for the road and the forward direction for the road. Segmented curves in RoadRunner support line, arc, spiral, and parametric cube road segments.

    example

    Examples

    collapse all

    Create a roadrunner object, specifying the path to an existing project. For example, this code shows the path to a project, on a Windows® machine, located at "C:\RR\MyProject". This code assumes that RoadRunner is installed in the default location, and returns an object, rrApp, that provides functions for performing basic tasks such as opening, closing, and saving scenes and projects. 

    rrApp = roadrunner(ProjectFolder="C:\RR\MyProject");

    Note

    If you are opening RoadRunner from MATLAB® for the first time, or if you have changed the RoadRunner installation location since you last opened it from MATLAB, you can use the roadrunnerSetup function to specify new default project and installation folders to use when opening RoadRunner. You can save these folders between MATLAB sessions by selecting the Across MATLAB sessions option from the corresponding drop down.

    Create a new scene in RoadRunner by using the newScene function, specifying the roadrunner object rrApp. 

    newScene(rrApp)

    Create a RoadRunner authoring API object, rrAPI, that references the object for the current RoadRunner instance rrApp. The rrApi object enables you to programmatically author scenes, such as by adding and modifying road and lane components, using MATLAB.

    rrApi = roadrunnerAPI(rrApp);
    Extract the object for your scene from the Scene property of the authoring API object rrApi. The extracted Scene object enables you to specify the scene in which to add scene components, such as roads and lanes. 
    scn = rrApi.Scene;

    Use the addSegmentedRoad function to add a segmented curve type road to the scene. Specify the starting point of the road as a control point. Next, indicate the forward direction of the road by specifying a second control point. You must specify the positions of these control points along the X- and Y- axes of the RoadRunner local coordinate system.

    startPoint = [-100 0];
startRoadDirection = [1 0];
rrRoad = addSegmentedRoad(scn,startPoint,startRoadDirection);

    Extract the horizontal curve of the segmented road. Then, use the addLine function to create a road segment and add it to the horizontal curve. Specify the length of the line segment as 50 m.

    horizontalCurve = rrRoad.HorizontalCurve;
addLine(horizontalCurve,50)

    Use the addArc function to create an arc segment and add it to the road. Specify the length of the arc segment as 30 m and its curvature as 1/20 m.

    addArc(horizontalCurve,30,1/20)

    Use the addLine function to create another horizontal segment and add it to the road. Specify the length of the line segment as 40 m. 

    addLine(horizontalCurve,40)

    Input Arguments

    collapse all

    Scene to which to add the road, specified as a Scene object.

    Example: rrRoad = addSegmentedRoad(scn,startPoint,roadStartDirection); adds a new segmented curve type road, rrRoad, to the scene scn.

    XY- coordinates of the starting point of the road, specified as a two-element row vector. You must specify the coordinates along the X- and Y- axes of the RoadRunner local coordinate system.

    XY-coordinates of the forward direction of the road, specified as a two-element row vector. You must specify the coordinates along the X- and Y- axes of the RoadRunner local coordinate system.

    Output Arguments

    collapse all

    Segmented curve type road, returned as a Road object.

    Version History

    Introduced in R2025a

    See Also

    | | |