carla/Docs/tuto_M_custom_layers.md

90 lines
3.5 KiB
Markdown

# Customizing Maps: Layered Maps
Utilizing levels in your custom map enables multiple people to work on a single map concurrently. It also allows you to use the Python API to load and unload layers on your map during a simulation, just like the [layered CARLA maps](core_map.md#layered-maps).
This guide will explain how to add a new level, how to add assets to a level, and how to configure a level to be always loaded or not.
- [__Add a new level__](#add-a-new-level)
- [__Add assets to a level__](#add-assets-to-a-level)
- [__Configure level loading options__](#configure-level-loading-options)
- [__Next steps__](#next-steps)
---
## Add a new level
All new levels in your map will be nested within the parent level, known as the _Persistent Level_. To create a new level:
__1. Open the levels panel.__
1. In the Unreal Engine editor, open _Window_ from the menu bar.
2. Click on _Levels_.
__2. Create a new level.__
1. In the _Levels_ panel, click on _Levels_ and select _Create New..._.
2. Choose _Empty Level_.
3. Save the level in `Content/Carla/Maps/Sublevels/<map_name>/`. To integrate the level with the CARLA Python API, use the naming convention `<map_name>_<layer_name>`, e.g., `TutorialMap_Buildings`. For a list of available layers, check [here](core_map.md#carla-maps).
>>>>>>![create new level](../img/new_level.png)
---
## Add assets to a level
__1. Select the level to which you want to add assets__.
In the _Levels_ panel, double-click the level to which you would like to add assets. Make sure the level is unlocked by toggling the lock icon.
__2. Select the assets to add.__
1. Select all the assets you would like to add to the level.
2. Right-click and go to _Level_.
3. Click on _Move Selection to Current Level_.
__3. Save the level.__
If a level has pending changes to save, you will see a pencil icon next to it in the _Levels_ panel. Click this to save the changes.
![moving assets](../img/move_assets.png)
---
## Configure level loading options
Levels can be configured to be able to be toggled or to be always loaded. To configure the level for either option:
1. Right-click the level in the _Levels_ panel and go to _Change Streaming Method_.
2. Choose the desired setting:
1. _Always Loaded_: The level __will not be able__ to be toggled via the Python API.
2. _Blueprint_: The level __will be able__ to be toggled via the Python API. A blue dot will appear beside the level name.
Regardless of the setting, you will still be able to toggle the level in the editor by pressing the eye icon.
>>>>>>![levels](../img/levels.png)
---
## Next steps
Continue customizing your map using the tools and guides below:
- [Add and configure traffic lights and signs.](tuto_M_custom_add_tl.md)
- [Add buildings with the procedural building tool.](tuto_M_custom_buildings.md)
- [Customize the road with the road painter tool.](tuto_M_custom_road_painter.md)
- [Customize the weather](tuto_M_custom_weather_landscape.md#weather-customization)
- [Customize the landscape with serial meshes.](tuto_M_custom_weather_landscape.md#add-serial-meshes)
Once you have finished with the customization, you can [generate the pedestrian navigation information](tuto_M_generate_pedestrian_navigation.md).
---
If you have any questions about the process, then you can ask in the [forum](https://github.com/carla-simulator/carla/discussions).
<div class="build-buttons">
<p>
<a href="https://github.com/carla-simulator/carla/discussions" target="_blank" class="btn btn-neutral" title="Go to the CARLA forum">
CARLA forum</a>
</p>
</div>