Main Content

exportScene

使用 MATLAB 导出 RoadRunner 场景

自 R2022a 起

全页折叠

    语法

    exportScene(rrApp,filename,formatname)
    exportScene(rrApp,filename,formatname,exportoptions)

    说明

    exportScene(rrApp,filename,formatname) 将 RoadRunner 场景文件导出为 RoadRunner 支持的文件格式之一。

    exportScene(rrApp,filename,formatname,exportoptions) 指定导出选项配置 exportoptions。

    示例

    示例

    全部折叠

    此示例使用:

    打开实时脚本

    使用 MATLAB® 将场景从 RoadRunner 项目导出为 ASAM OpenDRIVE 格式。

    通过指定创建项目的位置，使用 roadrunner 函数在 RoadRunner 中打开项目。此示例假设 RoadRunner 安装在 Windows 中的默认位置。

    指定现有项目的路径。例如，此代码显示位于 C:\RR\MyProject 的项目的路径。该函数返回 roadrunner 对象，rrApp, 提供执行基本工作流任务（例如打开、关闭和保存场景和项目）的函数。

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

    使用 openScene 函数以及 roadrunner 对象和要打开的 RoadRunner 场景作为输入参数，在项目中打开一个场景。本示例使用 FourWaySignal.rrscene 场景，该场景是 RoadRunner 项目中默认包含的场景之一，and 位于 Scenes 中项目的文件夹。

    sceneName = "FourWaySignal.rrscene";
openScene(rrApp,sceneName);

    通过创建 openDriveExportOptions 对象来设置导出选项，以启用从文件中导出信号和对象。

    options = openDriveExportOptions(OpenDriveVersion=1.5,ExportSignals=true,ExportObjects=true);

    使用 exportScene 函数将场景导出到 ASAM OpenDRIVE。指定 roadrunner 对象、要将场景导出到的文件的名称、导出格式和导出选项作为 exportScene 函数的输入参数。

    filename = "FourWaySignal.xodr";
formatname = "OpenDRIVE";
exportScene(rrApp,filename,formatname,options);

    输入参数

    全部折叠

    与项目相关的 RoadRunner 应用程序，指定为 roadrunner 对象。该对象提供执行常见工作流任务（如打开、关闭和保存场景和项目）的功能。rrApp 提供支持从文件导入数据和从 RoadRunner 将场景导出为其他格式的功能。

    导出的 RoadRunner 场景的文件路径，指定为字符向量或字符串标量。此参数指定从 RoadRunner 项目导出场景的文件的绝对或相对文件路径。如果指定相对路径，则该路径相对于当前项目的 Exports 文件夹。如果指定绝对路径，那么 RoadRunner 会将场景导出到指定的精确位置的文件。如果路径中缺少任何文件夹，RoadRunner 会尝试创建它们。filename 可以包含导出文件的扩展名，也可以没有扩展名。如果没有扩展名，则 RoadRunner 会在导出场景之前将 formatname 指定格式的扩展名附加到文件名中。

    示例: exportScene(rrApp,"FourWaySignal.xodr","OpenDRIVE",options)、"FourWaySignal.xodr" 表示导出文件的文件名，相对于当前工程的 Exports 文件夹。

    数据类型: char | string

    导出格式名称，指定为字符向量或字符串标量。此参数指定与有效的 RoadRunner 格式相对应的格式名称。格式名称选项不区分大小写。支持的格式为：AutoCAD®、Filmbox、glTF™、OpenFlight、OpenSceneGraph、ASAM OpenDRIVE®、USD、Apollo、CARLA、Metamoto®、Unity®、Unreal®、GeoJSON 和 VTD。

    示例: 调用 exportScene(rrApp,"FourWaySignal.xodr","OpenDRIVE",options) 时，"OpenDRIVE" 指定文件将导出为 ASAM OpenDRIVE 格式。

    数据类型: char | string

    导出选项配置，指定为与指定格式 formatname 兼容的导出选项对象之一。该参数指定导出指定场景时使用的选项。

    导出格式描述 属性
    apolloExportOptions

    将 RoadRunner 场景导出到 Apollo 的选项。

    apolloExportOptions(Name=Value) 为 Apollo 格式创建一个导出选项配置对象，其属性指定为一个或多个名称值参数。

    如果默认属性值为 "auto"，则 RoadRunner 应用程序将确定要使用的值并将属性设置为该值。

    ApolloVersion

    要导出到的 Apollo 版本，分别指定为 3 或 5。

    默认： "auto"

    DatabaseVersion

    导出场景的标识符，指定为数字标量。此属性对于同一场景的导出版本很有用。

    默认值： "auto"

    DatabaseName

    导出场景的名称，指定为字符串标量或字符向量。

    默认："auto"

    DrivingSide

    导出场景的驱动端，指定为："Unspecified"、"Left" 或 "Right"。

    默认： "auto"

    ExportSignals

    将映射到交叉口的所有信号和标志导出为 <signal> 条目，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    ExportObjects

    将所有道具导出为 <object> 条目，指定为逻辑 1（true）或 0（false）。

    默认值： "auto"

    ClampDistances

    将 RoadRunner 场景中的距离限制为 1 厘米的倍数，指定为逻辑 1 (true) 或 0 (false)。将此属性指定为 true 可以阻止 RoadRunner 导出非常短的道路。

    默认： "auto"

    示例： options = apolloExportOptions(DrivingSide="Right");

    autocadExportOptions

    将 RoadRunner 场景导出到 AutoCAD 的选项。

    autocadExportOptions(Name=Value) 创建 AutoCAD 格式的导出选项配置对象，并将属性指定为一个或多个名称-值参数。

    如果默认属性值为 "auto"，则 RoadRunner 应用程序将确定要使用的值并将属性设置为该值。

    SplitMeshes

    根据分割类型分割网格，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    ResizeTextureDimensions

    通过将导出纹理的尺寸向上舍入到下一个最高的 2 的幂来调整其尺寸大小，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    ExportOnlyHighestLOD

    仅导出最高级别的细节，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    TilesExportOptions

    用于按图块分割网格的选项，指定为 tilesExportOptions 对象。

    默认值： "auto"

    示例： options = autocadExportOptions(SplitMeshes=true);

    tilesExportOptions

    用于导出图块的选项。

    tilesExportOptions(Name=Value) 创建一个用于导出图块的选项配置对象，其属性指定为一个或多个名称-值参数。这些字段对应于 AutoCAD、Filmbox、glTF、OpenFlight、OpenSceneGraph 和 USD 导出选项中的选项。

    如果默认属性值为 "auto"，则 RoadRunner 应用程序将确定要使用的值并将属性设置为该值。

    TileSize

    导出的图块的大小，指定为二元素双向量。

    默认： "auto"

    TileCenter

    导出图块的中心位置，指定为二元素双向量。

    默认值： "auto"

    ExportIndividualTiles

    将每个图块导出为单独的文件，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    示例： options = tilesExportOptions(TileSize=[100 100]);

    carlaExportOptions

    将 RoadRunner 场景导出到 CARLA 的选项。

    carlaExportOptions(Name=Value) 为 CARLA 格式创建一个导出选项配置对象，其属性指定为一个或多个名称值参数。

    如果默认属性值为 "auto"，则 RoadRunner 应用程序将确定要使用的值并将属性设置为该值。

    UnrealDatasmithOptions

    用于导出 UnrealDatasmith 文件的选项，指定为 unrealDatasmithExportOptions 对象。

    默认值： "auto"

    OpenDriveOptions

    用于导出 ASAM OpenDRIVE 文件的选项，指定为 openDriveExportOptions 对象。

    默认： "auto"

    示例：options = carlaExportOptions(UnrealDatasmithOptions=unrealDatasmithExportOptions(SplitMeshes=true));

    carlaFilmboxExportOptions

    将 RoadRunner 场景导出到 CARLA 的选项。

    carlaFilmboxExportOptions(Name=Value) 为 CARLA 格式创建一个导出选项配置对象，其属性指定为一个或多个名称值参数。

    如果默认属性值为 "auto"，则 RoadRunner 应用程序将确定要使用的值并将属性设置为该值。

    OpenDriveOptions

    用于导出 ASAM OpenDRIVE 文件的选项，指定为 openDriveExportOptions 对象。

    默认： "auto"

    FilmboxOptions

    用于导出 Filmbox 文件的选项，指定为 filmboxExportOptions 对象。

    默认： "auto"

    示例：options = carlaFilmboxExportOptions(FilmboxOptions=filmboxExportOptions(SplitMeshes=true));

    datasmithRoadExportOptions

    将 RoadRunner 场景导出至 DatasmithRoad 的选项。

    datasmithRoadExportOptions(Name=Value) 为 DatasmithRoad 格式创建一个导出选项配置对象，其属性指定为一个或多个名称值参数。

    如果默认属性值为 "auto"，则 RoadRunner 应用程序将确定要使用的值并将属性设置为该值。

    UnrealDatasmithOptions

    用于导出 Unreal Datasmith 文件的选项，指定为 unrealDatasmithExportOptions 对象。

    默认值： "auto"

    OpenDriveOptions

    用于导出 ASAM OpenDRIVE 文件的选项，指定为 openDriveExportOptions 对象。

    默认： "auto"

    示例：options = datasmithRoadExportOptions(UnrealDatasmithOptions=unrealDatasmithExportOptions(SplitMeshes=true));

    filmboxExportOptions

    将 RoadRunner 场景导出至 Filmbox 的选项。

    filmboxExportOptions(Name=Value) 为 Filmbox 格式创建一个导出选项配置对象，其属性指定为一个或多个名称值参数。

    如果默认属性值为 "auto"，则 RoadRunner 应用程序将确定要使用的值并将属性设置为该值。

    SplitMeshes

    根据分割类型分割网格，指定为逻辑 1 (true) 或 0 (false)。

    默认值： "auto"

    ResizeTextureDimensions

    通过将导出纹理的尺寸向上舍入到下一个最高的 2 的幂来调整其尺寸大小，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    EmbedTextures

    将导出的纹理嵌入导出的文件中，指定为逻辑 1 (true) 或 0 (false)。

    默认值： "auto"

    ExportOnlyHighestLOD

    仅导出最高级别的细节，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    TilesExportOptions

    用于按图块分割网格的选项，指定为 tilesExportOptions 对象。

    默认： "auto"

    示例： options = filmboxExportOptions(ResizeTextureDimensions=true);

    geoJSONExportOptions

    将 RoadRunner 场景导出到 GeoJSON 的选项。

    geoJSONExportOptions(Name=Value) 创建一个 GeoJSON 格式的导出选项配置对象，并将属性指定为一个或多个名称-值参数。

    如果默认属性值为 "auto"，则 RoadRunner 应用程序将确定要使用的值并将属性设置为该值。

    ReduceFileSize

    从导出的 GeoJSON 文件中删除新行并减小其大小，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    示例：options = geoJSONExportOptions(ReduceFileSize=true);

    gltfExportOptions

    将 RoadRunner 场景导出到 glTF 的选项。

    gltfExportOptions(Name=Value) 创建 glTF 格式的导出选项配置对象，并将属性指定为一个或多个名称-值参数。

    如果默认属性值为 "auto"，则 RoadRunner 应用程序将确定要使用的值并将属性设置为该值。

    SplitMeshes

    根据分割类型分割网格，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    ResizeTextureDimensions

    通过将导出纹理的尺寸向上舍入到下一个最高的 2 的幂来调整其尺寸大小，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    ExportOnlyHighestLOD

    仅导出最高级别的细节，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    EmbedTextures (自 R2024a 起)

    将导出的纹理嵌入导出文件中的选项，指定为逻辑 1 (true) 或 0 (false)。

    默认："auto"

    TilesExportOptions

    用于按图块分割网格的选项，指定为 tilesExportOptions 对象。

    默认： "auto"

    示例： options = gltfExportOptions(SplitMeshes=true);

    metamotoExportOptions

    将 RoadRunner 场景导出到 Metamoto 的选项。

    metamotoExportOptions(Name=Value) 创建 Metamoto 格式的导出选项配置对象，并将属性指定为一个或多个名称-值参数。

    如果默认属性值为 "auto"，则 RoadRunner 应用程序将确定要使用的值并将属性设置为该值。

    FilmboxOptions

    用于导出 Filmbox 文件的选项，指定为 filmboxExportOptions 对象。

    默认： "auto"

    OpenDriveOptions

    用于导出 ASAM OpenDRIVE 文件的选项，指定为 openDriveExportOptions 对象。

    默认："auto"

    GeoJSONOptions

    用于导出 GeoJSON 文件的选项，指定为 geoJSONExportOptions 对象。

    默认： "auto"

    示例： options = metamotoExportOptions(GeoJSONOptions=geoJSONExportOptions(ReduceFileSize=true));

    openDriveExportOptions

    将 RoadRunner 场景导出到 ASAM OpenDRIVE 的选项。

    openDriveExportOptions(Name=Value) 创建 ASAM OpenDRIVE 格式的导出选项配置对象，并将属性指定为一个或多个名称-值参数。

    如果默认属性值为 "auto"，则 RoadRunner 应用程序将确定要使用的值并将属性设置为该值。

    OpenDriveVersion

    ASAM OpenDRIVE 要导出到的版本，指定为 1.4、1.5 或 1.6，指定为双精度标量。

    默认：1.6

    DatabaseVersion

    导出场景的标识符，指定为数字标量。此属性对于同一场景的导出版本很有用。

    默认：0.

    DatabaseName

    导出场景的名称，指定为字符串标量或字符向量。

    默认： "auto"

    DrivingSide

    导出场景的驱动端，指定为："Unspecified"、"Left" 或 "Right"。

    默认值： "auto"

    EnforceConnectedRoadContinuity (自 R2024a 起)

    强制端到端连接的道路参考线之间的连续性的选项，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    ExportMarkingsAsLine

    使用 ASAM OpenDRIVE 中的 <line> 定义导出额外的车道标记数据（间距、划线长度和单个油漆条宽度），指定为逻辑 1 (true) 或 0 (false)。

    默认："auto"

    ExportSignals

    将映射到交叉口的所有信号和标志导出为 <signal> 条目，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    ExportOpenCRG

    导出到 ASAM OpenCRG® 文件，指定为逻辑 1（true）或 0（false）。

    默认： "auto"

    ExportObjects

    将所有道具导出为 <object> 条目，指定为逻辑 1（true）或 0（false）。

    默认："auto"

    ExportHeadingOffsetRelativeToOrientation

    将 <signal> 条目的 <hOffset>（航向偏移）值导出为相对于 <orientation> 的值，后者是信号适用的道路的行驶方向，指定为逻辑 1（true）或 0（false）。

    默认： "auto"

    ExportConflictPoints

    为两条道路相交的交叉口的每个点导出一个 <object> 条目，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    ExportSceneOriginReference

    导出场景中 0,0 处的参考点原点，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    ClampDistances

    将 RoadRunner 场景中的距离限制为 1 厘米的倍数，指定为逻辑 1 (true) 或 0 (false)。将此属性指定为 true 可以阻止 RoadRunner 导出非常短的道路。

    默认："auto"

    SyntheticOpenCRGOptions (自 R2024a 起)

    合成 ASAM OpenCRG 文件选项，指定为 syntheticOpenCRGOptions 对象。设置此选项以导出 ASAM OpenCRG 文件。

    默认： "auto"

    ApplyParkingSlope (自 R2024a 起)

    应用停车坡度的选项，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    示例： options = openDriveExportOptions(ExportSignals=true);

    openFlightExportOptions

    将 RoadRunner 场景导出到 OpenFlight 的选项。

    openFlightExportOptions(Name=Value) 为 OpenFlight 格式创建一个导出选项配置对象，其属性指定为一个或多个名称值参数。

    如果默认属性值为 "auto"，则 RoadRunner 应用程序将确定要使用的值并将属性设置为该值。

    SplitMeshes

    根据分割类型分割网格，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    ResizeTextureDimensions

    通过将导出纹理的尺寸向上舍入到下一个最高的 2 的幂来调整其尺寸大小，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    ExportOnlyHighestLOD

    仅导出最高级别的细节，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    TilesExportOptions

    用于按图块分割网格的选项，指定为 tilesExportOptions 对象。

    默认： "auto"

    示例： options = openFlightExportOptions(SplitMeshes=true);

    openSceneGraphExportOptions

    将 RoadRunner 场景导出到 OpenSceneGraph 的选项。

    openSceneGraphExportOptions(Name=Value) 为 OpenSceneGraph 格式创建一个导出选项配置对象，其属性指定为一个或多个名称值参数。

    如果默认属性值为 "auto"，则 RoadRunner 应用程序将确定要使用的值并将属性设置为该值。

    SplitMeshes

    根据分割类型分割网格，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    ResizeTextureDimensions

    通过将导出纹理的尺寸向上舍入到下一个最高的 2 的幂来调整其尺寸大小，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    EmbedTextures

    将导出的纹理嵌入导出的文件中，指定为逻辑 1 (true) 或 0 (false)。

    默认："auto"

    ExportOnlyHighestLOD

    仅导出最高级别的细节，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    TilesExportOptions

    用于按图块分割网格的选项，指定为 tilesExportOptions 对象。

    默认： "auto"

    示例： options = openSceneGraphExportOptions(SplitMeshes=true);

    unityExportOptions

    将 RoadRunner 场景导出到 Unity 的选项。

    unityExportOptions(Name=Value) 创建 Unity 格式的导出选项配置对象，并将属性指定为一个或多个名称-值参数。

    如果默认属性值为 "auto"，则 RoadRunner 应用程序将确定要使用的值并将属性设置为该值。

    FilmboxOptions

    用于导出 Filmbox 文件的选项，指定为 filmboxExportOptions 对象。

    默认： "auto"

    OpenDriveOptions

    用于导出 ASAM OpenDRIVE 文件的选项，指定为 openDriveExportOptions 对象。

    默认： "auto"

    示例： options = unityExportOptions(FilmboxOptions=filmboxExportOptions(EmbedTextures=true));

    unrealExportOptions

    将 RoadRunner 场景导出到 Unreal 的选项。

    unrealExportOptions(Name=Value) 创建 Unreal 格式的导出选项配置对象，并将属性指定为一个或多个名称-值参数。

    如果默认属性值为 "auto"，则 RoadRunner 应用程序将确定要使用的值并将属性设置为该值。

    FilmboxOptions

    用于导出 Filmbox 文件的选项，指定为 filmboxExportOptions 对象。

    默认： "auto"

    OpenDriveOptions

    用于导出 ASAM OpenDRIVE 文件的选项，指定为 openDriveExportOptions 对象。

    默认： "auto"

    示例： options = unrealExportOptions(FilmboxOptions=filmboxExportOptions(EmbedTextures=true));

    unrealDatasmithExportOptions

    将 RoadRunner 场景导出到 UnrealDatasmith 的选项。

    unrealDatasmithExportOptions(Name=Value) 为 UnrealDatasmith 格式创建一个导出选项配置对象，其属性指定为一个或多个名称值参数。

    如果默认属性值为 "auto"，则 RoadRunner 应用程序将确定要使用的值并将属性设置为该值。

    SplitMeshes

    根据分割类型分割网格，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    ResizeTextureDimensions

    通过将导出纹理的尺寸向上舍入到下一个最高的 2 的幂来调整其尺寸大小，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    ExportOnlyHighestLOD

    仅导出最高级别的细节，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    TilesExportOptions

    用于按图块分割网格的选项，指定为 tilesExportOptions 对象。

    默认： "auto"

    示例： options = unrealDatasmithExportOptions(ResizeTextureDimensions=true);

    usdExportOptions

    将 RoadRunner 场景导出到 USD 的选项。

    usdExportOptions(Name=Value) 创建 USD 格式的导出选项配置对象，并将属性指定为一个或多个名称-值参数。

    如果默认属性值为 "auto"，则 RoadRunner 应用程序将确定要使用的值并将属性设置为该值。

    SplitMeshes

    根据分割类型分割网格，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    ResizeTextureDimensions

    通过将导出纹理的尺寸向上舍入到下一个最高的 2 的幂来调整其尺寸大小，指定为逻辑 1 (true) 或 0 (false)。

    默认值： "auto"

    ExportOnlyHighestLOD

    仅导出最高级别的细节，指定为逻辑 1 (true) 或 0 (false)。

    默认： "auto"

    TilesExportOptions

    用于按图块分割网格的选项，指定为 tilesExportOptions 对象。

    默认："auto"

    示例： options = usdExportOptions(SplitMeshes=true);

    vtdExportOptions

    将 RoadRunner 场景导出到 VTD 的选项。

    vtdExportOptions(Name=Value) 为 VTD 格式创建一个导出选项配置对象，其属性指定为一个或多个名称值参数。

    如果默认属性值为 "auto"，则 RoadRunner 应用程序将确定要使用的值并将属性设置为该值。

    OpenSceneGraphOptions

    用于导出 OpenSceneGraph 文件的选项，指定为 openSceneGraphExportOptions 对象。

    默认： "auto"

    OpenDriveOptions

    用于导出 ASAM OpenDRIVE 文件的选项，指定为 openDriveExportOptions 对象。

    默认： "auto"

    示例： options = vtdExportOptions(OpenDriveOptions=openDriveExportOptions(ExportObjects=true));

    rfproExportOptions

    将 RoadRunner 场景导出到 rFpro 的选项。

    rfproExportOptions(Name=Value) 创建 rFpro 格式的导出选项配置对象，并将属性指定为一个或多个名称-值参数。

    如果默认属性值为 "auto"，则 RoadRunner 应用程序将确定要使用的值并将属性设置为该值。

    FilmboxOptions

    用于导出 Filmbox 文件的选项，指定为 filmboxExportOptions 对象。

    默认： "auto"

    OpenDriveOptions

    用于导出 ASAM OpenDRIVE 文件的选项，指定为 openDriveExportOptions 对象。

    默认： "auto"

    示例： options = rfproExportOptions(OpenDriveOptions=openDriveExportOptions(ExportSignals=true));

    syntheticOpenCRGOptions (自 R2024a 起)

    合成 ASAM OpenCRG 文件的选项。

    syntheticOpenCRGOptions(Name=Value) 为合成 ASAM OpenCRG 文件创建一个选项配置对象。

    如果默认属性值为 "auto"，则 RoadRunner 应用程序将确定要使用的值并将属性设置为该值。

    RoadDataFormat

    合成 ASAM OpenCRG 文件的道路数据格式，指定为以下值之一：

    • "Unspecified"

    • "LRFI"

    • "LDFI"

    默认： "auto"

    示例： options = syntheticOpenCRGOptions(RoadDataFormat="LRFI");

    数据类型: char | string

    版本历史记录

    在 R2022a 中推出

    全部展开

    另请参阅

    | | | |

    主题