createAsset

新しいアセットの作成

R2025a 以降

ページ内をすべて折りたたむ

    構文

    asset = createAsset(project,assetPath,assetType)

    説明

    asset = createAsset(project,assetPath,assetType) は、指定したプロジェクトの指定した Asset フォルダーへの相対パスに、指定したアセット タイプのアセットを作成します。たとえば、customCar = createAsset(prj,"Vehicles/CustomCar.rrvehicle","VehicleAsset") は、プロジェクト prj のアセット CustomCar.rrvehicle にオブジェクト customCar を作成し、アセット タイプ "VehicleAsset" を割り当てます。アセット オブジェクトを使用すると、道路に車線区分線テクスチャを追加したり、シナリオでアクターを表現したり、シミュレーション中にアクターの動作を変更したりできます。

    createAsset を使用して VehicleAsset または CharacterAsset を作成すると、RoadRunner により、シナリオで使用できるプレースホルダー 3D モデルが作成されます。車両およびキャラクター用のプレースホルダー モデルの詳細については、Vehicle Assets および Character Assets をそれぞれ参照してください。

    例

    すべて折りたたむ

    RoadRunner プロジェクトに新しい VehicleAsset オブジェクトを作成するには、createAsset 関数を使用します。

    既存のプロジェクトのパスを指定して、roadrunner オブジェクトを作成します。たとえば、次のコードは、Windows® マシン上の "C:\RR\MyProject" にあるプロジェクトへのパスを示しています。このコードでは、RoadRunner が既定の場所にインストールされていると仮定しており、rrApp オブジェクトが返されます。このオブジェクトは、シーンやプロジェクトの開閉や保存などの基本的なタスクを実行する関数を提供します。

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

    メモ

    MATLAB® から初めて RoadRunner を開く場合、または前回 MATLAB から RoadRunner を開いた後にそのインストール場所を変更した場合は、roadrunnerSetup 関数を使用して、RoadRunner を開くときに使用する新しい既定のプロジェクト フォルダーとインストール フォルダーを指定できます。対応するドロップ ダウンから [すべての MATLAB セッション] オプションを選択すると、MATLAB セッション間でこれらのフォルダーを保存できます。

    roadrunner オブジェクト rrApp および開こうとしている特定のシーンのファイル名を指定して openScene 関数を使用し、RoadRunner で既存のシーンを開きます。次に、newScenario 関数を使用して新しいシナリオを作成します。

    openScene(rrApp,"ScenarioBasic.rrscene")
newScenario(rrApp)

    現在の RoadRunner インスタンス rrApp のオブジェクトを参照する、RoadRunner オーサリング API のオブジェクト rrApi を作成します。rrApi オブジェクトを使用すると、MATLAB を使用して道路、アクター、ロジック コンポーネントを追加および変更することで、シーンやシナリオをプログラムで作成できます。

    rrApi = roadrunnerAPI(rrApp);
    オーサリング API オブジェクト rrApi の Scene プロパティと Scenario プロパティから、シーン オブジェクトとシナリオ オブジェクトをそれぞれ抽出します。抽出した Scene オブジェクトを使用すると、道路や車線などのシーン コンポーネントを追加するシーンを指定できます。抽出した Scenario オブジェクトを使用すると、アクターやロジックなどのシナリオ コンポーネントを追加するシナリオを指定できます。
    scn = rrApi.Scene;
scnro = rrApi.Scenario;
    オーサリング API オブジェクト rrApi の Project プロパティから、RoadRunner プロジェクトのオブジェクトを抽出します。抽出した Project オブジェクトにより、アセット オブジェクトの取得元として、現在の RoadRunner セッションのプロジェクト フォルダーを指定できます。アセット オブジェクトを使用すると、シーンの道路やシナリオのアクターにアセットを割り当てることができます。
    prj = rrApi.Project;

    createAsset 関数を使用し、新しいアセットへの相対パスを "Vehicles/CustomCar.rrvehicle" として指定し、アセット タイプを "VehicleAsset" として指定することで、プロジェクト prj に新しい VehicleAsset オブジェクト customCar を作成します。アセット オブジェクトを使用すると、道路に車線区分線テクスチャを追加したり、シナリオでアクターを表現したり、シミュレーション中にアクターの動作を変更したりできます。

    customCar = createAsset(prj,"Vehicles/CustomCar.rrvehicle","VehicleAsset");

    入力引数

    すべて折りたたむ

    現在の RoadRunner セッションのプロジェクト フォルダー。Project オブジェクトとして指定します。

    例: prj = rrApi.Project (ここで、rrApi は RoadRunner オーサリング API オブジェクト) は、現在の RoadRunner セッションの Project オブジェクト prj を返します。

    アセットの相対パス。string スカラーまたは文字ベクトルとして指定します。createAsset は、新しいアセット用に、ファイル拡張子 .rrvehicle、.rrchar、.rrbehavior、および .rrlms を受け入れます。指定する拡張子は、assetType で指定されたアセットのタイプに対応していなければなりません。

    • .rrvehicle 拡張子 — assetType は "VehicleAsset" でなければなりません。

    • .rrchar 拡張子 — assetType は "CharacterAsset" でなければなりません。

    • .rrbehavior 拡張子 — assetType は "BehaviorAsset" でなければなりません。

    • .rrlms 拡張子 — assetType は "LaneMarkingStyle" でなければなりません。

    メモ

    既定では、アセットの相対パスを指定すると、RoadRunner は RoadRunner プロジェクトの Assets フォルダーを検索します。RoadRunner プロジェクトの Assets フォルダーの外部にあるアセットを追加する場合は、新しいパスを指定する前に、<PROJECT> 接頭辞を使用して現在のプロジェクト フォルダーを指定します。たとえば、createAsset(prj,"<PROJECT>/CustomFiles/CustomVehicles/CustomSedan.rrvehicle","VehicleAsset") のようにします。

    作成されるアセットのタイプ。次のいずれかのオプションとして指定します。

    • "VehicleAsset" — 作成されるアセットのタイプを [Vehicle] として指定します。

    • "CharacterAsset" — 作成されるアセットのタイプを [Character] として指定します。

    • "BehaviorAsset" — 作成されるアセットのタイプを [Behavior] として指定します。RoadRunner は動作アセットのデータを .rrbehavior ファイルに保存します。

    • "LaneMarkingStyle" — 作成されるアセットのタイプを [Lane Marking] として指定します。

    出力引数

    すべて折りたたむ

    アセット オブジェクト。次のいずれかのオブジェクトとして返されます。

    • VehicleAsset — [Vehicle] アセット タイプのアセットを表します。

    • CharacterAsset — [Character] アセット タイプのアセットを表します。

    • BehaviorAsset — [Behavior] アセット タイプのアセットを表します。RoadRunner は動作アセットのデータを .rrbehavior ファイルに保存します。

    • LaneMarkingStyle — [Lane Marking] アセット タイプのアセットを表します。

    制限

    バージョン履歴

    R2025a で導入

    参考

    | | | |

    トピック