本页采用了机器翻译。点击此处可查看最新英文版本。

addControlPoint

在线弧道路曲线上添加控制点

自 R2025a 起

全页折叠

    语法

    controlPoint = addControlPoint(roadCurve,position)

    说明

    controlPoint = addControlPoint(roadCurve,position) 在指定位置为指定的线弧道路曲线添加控制点。

    示例

    示例

    全部折叠

    使用 addControlPoint 函数向线弧道路曲线添加控制点以修改其形状。

    创建一个 roadrunner 对象，指定现有工程的路径。例如，此代码显示 Windows® 计算机上位于 "C:\RR\MyProject" 的工程的路径。此代码假设 RoadRunner 已安装在默认位置，并返回一个名为 rrApp 的对象，该对象提供用于执行基本任务的函数，例如打开、关闭和保存场景及工程。

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

    注意

    若您首次从 MATLAB® 打开 RoadRunner，或自上次从 MATLAB 打开以来更改了 RoadRunner 的安装位置，可使用 roadrunnerSetup 功能指定新的默认工程和安装文件夹，以便在打开 RoadRunner 时使用。您可以在 MATLAB 会话之间通过从对应下拉菜单中选择 Across MATLAB sessions 选项来保存这些文件夹。

    创建一个对象，用于 RoadRunner 创作 API 的 rrApi，该对象引用当前 RoadRunner 实例 rrApp 的对象。rrApi 对象支持通过编程方式创建场景与情境，例如利用 MATLAB 添加和修改道路、交通参与者及逻辑组件。

    rrApi = roadrunnerAPI(rrApp);
    分别从创作 API 对象 rrApi 的 Scene 和 Scenario 属性中提取场景对象和情境对象。提取的 Scene 对象可用于指定添加场景组件（如道路和车道）的场景。提取的 Scenario (RoadRunner Scenario) 对象使您能够指定添加情境组件（如交通参与者和逻辑）的场景。
    scn = rrApi.Scene;
scnro = rrApi.Scenario;
    从创作 API 对象 rrApi 的 Project 属性中提取 RoadRunner 工程的对象。提取的 Project 对象可让您指定当前 RoadRunner 会话的工程文件夹，以便从中检索资源对象。您可以使用素材对象将素材分配给场景中的道路，或分配给情境中的交通参与者。
    prj = rrApi.Project;

    要创建线弧道路，请使用 addLineArcRoad 函数，并指定添加道路的场景以及道路控制点的 xy 坐标位置。然后，从道路 rrRoad 的 HorizontalCurve 属性中提取线弧曲线。

    rrRoad = addLineArcRoad(scn,[-100 0; 100 0]);
lineArc = rrRoad.HorizontalCurve;

    使用 addControlPoint 修改线弧道路曲线

    您可以通过在现有道路曲线上添加额外的控制点，或在场景中调整现有控制点的位置来修改道路曲线。要改变线弧曲线 lineArc 的形状并增加其总长度，请使用 addControlPoint 函数向曲线添加两个新的控制点。指定控制点的位置，使曲线在正 y-方向上平滑延伸。

    newPoint = addControlPoint(lineArc,[200 50]);
newPoint2 = addControlPoint(lineArc,[200 200]);

    默认情况下，道路不包含任何车道，RoadRunner 在场景编辑器中仅显示其参考车道。要为道路 rrRoad 添加车道，首先需从 ReferenceLane 属性中提取参考车道对象。然后，要在参考车道左右两侧添加车道，分别使用 addLaneToLeft 和 addLaneToRight 函数，并指定 ReferenceLane 对象。

    roadRef = rrRoad.ReferenceLane;
leftLane = addLaneToLeft(roadRef);
rightLane = addLaneToRight(roadRef);

    输入参数

    全部折叠

    用于添加控制点的线弧道路曲线，指定为 LineArcRoadCurve 对象。

    示例: controlPoint = addControlPoint(lineArc,[200 50]); 在位置 [200 50] 处为线弧道路曲线 lineArc 添加一个控制点。

    在 RoadRunner 局部坐标系中放置控制点的坐标位置，以两元素向量形式指定.

    输出参量

    全部折叠

    道路弯道上的控制点，以 LineArcRoadCurvePoint 对象形式返回。

    版本历史记录

    在 R2025a 中推出

    另请参阅

    | (RoadRunner Scenario) | (RoadRunner Scenario) | (RoadRunner Scenario) | (RoadRunner Scenario)