p71924506
/
carla
mirror of https://github.com/carla-simulator/carla.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Spellchecked MapCustomization ducumentation

This commit is contained in:
FPerez 2018-01-24 14:38:32 +01:00
parent bb69a3a0a6
commit 8ebe65070d
1 changed files with 25 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

50
Docs/map_customization.md
View File

@ -3,28 +3,28 @@
## Creating a new map
!!! Bug
- Creating a map from scratch with the Carla tools causes a crash with UE4.17.2 (Issue [#99](https://github.com/carla-simulator/carla/issues/99)),
this guide will suggest dupplicating an existing level instead of creating one from scratch.
this guide will suggest duplicating an existing level instead of creating one from scratch.
### Requirements
- Checkout and build carla from source on [Linux](how_to_build_on_linux.md) or [Windows](how_to_build_on_windows.md)
- Checkout and build Carla from source on [Linux](how_to_build_on_linux.md) or [Windows](how_to_build_on_windows.md)
### Creating
- Duplicate an existing map
- Remove everything you don't need from the map
- Keep the folder "Lighting", "AtmosphericFog", "PostProcessVol" and "CarlaMapGenerator" this will keep the climate working as intended and the post process saved.
- It might be interesting to keep the empty level as a template and dupplicate it before starting to populate it.
- It might be interesting to keep the empty level as a template and duplicate it before starting to populate it.
- In the CarlaMapGenerator, there is a field "seed". You can change the map by altering that seed and clicking "Trigger Road Map Generation". "Save Road Map To Disk" should also be checked.
- You can change the seed until you have a map you are satisfied with.
- After that you can place new PlayerStarts at the places you want the cars to be spawned.
- The AI already works, but the cars won't act randomly. Vehicles will follow the instructions given by the RoadMapGenerator. They will follow the road easily while in straight roads but wont so much when entering Intersections:
![Road_Instructions_Example.png](img/Road_Instructions_Example.png)
> (This is a debug view of the instructions the road gives to the Vehicle. They will allways follow the green arrows, the white points are shared points between one or more routes, by default they order the vehicle to continue straight; Black points are off the road, the vehicle gets no instructions and drives to the left, trying to get back to the road)
> (This is a debug view of the instructions the road gives to the Vehicle. They will always follow the green arrows, the white points are shared points between one or more routes, by default they order the vehicle to continue straight; Black points are off the road, the vehicle gets no instructions and drives to the left, trying to get back to the road)
- To get a random behavior, you have to place IntersectionEntrances, this will let you redefine the directoion the vehicle will take overwriting the directions given by the roadmap (until they finish their given order).
(See the two example towns how it exactly works).
- Before version 0.7.1: For every entrance you'll have to create a series of empty actors that will be the waypoints to guide the car through the intersection; Then you'll have to asign the corresponding actors to every Path
- After version 0.7.1: Every IntersectionEntrance has an array called routes, adding an element to this creates an editable spline in the world with the first point on the IntersectionEntrance (You might have to select another object before you can see it) This spline defines the possible routes any car will take when entering the intersection (as the Empty actors did before) you might configure this routes as you would edit any Unreal spline. Each route will create an element in the field bellow: "Probabilities" every number in this array defines the chances of any vehicle to take the corresponding route.
- To get a random behavior, you have to place IntersectionEntrances, this will let you redefine the direction the vehicle will take overwriting the directions given by the road map (until they finish their given order).
(See the two example towns how it exactly works).
- Before version 0.7.1: For every entrance you'll have to create a series of empty actors that will be the waypoints to guide the car through the intersection; Then you'll have to assign the corresponding actors to every Path
- After version 0.7.1: Every IntersectionEntrance has an array called routes, adding an element to this creates an editable spline in the world with the first point on the IntersectionEntrance (You might have to select another object before you can see it) This spline defines the possible routes any car will take when entering the intersection (as the Empty actors did before) you might configure this routes as you would edit any Unreal spline. Each route will create an element in the field bellow: "Probabilities" every number in this array defines the chances of any vehicle to take the corresponding route.
- To change the speed of the car, use the SpeedLimiters. They are straightforward to use. (Make sure you limit the speed for the corners, otherwise the cars will try and fail to take them at full speed)
- Traffic lights need to be scripted to avoid traffic accidents.
Every street at a crossing should have its own turn at green without the other streets having green.
@ -36,7 +36,7 @@ This are the specific blueprint assets created to help building the environment.
## MultipleFloorBuilding:
The purpose of this blueprint is to make repeating and varying tall buildings a bit easier. Provided a Base, a MiddleFloor and a roof; this blueprint repeats the middle floor to the desired number of stores and tops it whith the last floor given some conditions:
The purpose of this blueprint is to make repeating and varying tall buildings a bit easier. Provided a Base, a MiddleFloor and a roof; this blueprint repeats the middle floor to the desired number of stores and tops it with the last floor given some conditions:
- All model pivots should be in the bottom center of the Specific mesh.
- Al models must start and end exactly where the repetition happen.
@ -46,8 +46,8 @@ This blueprint is controlled by this 6 specific Parameters:
- Floor: The mesh to be repeated along the building.
- Roof: Final mesh to top the building.
- FloorNumber: Number of stores of the building.
- FloorHeightOffset: Adjust The placement of every floor verticaly.
- RoofOffset: Adjust the placement of the roof verticaly.
- FloorHeightOffset: Adjust The placement of every floor vertically.
- RoofOffset: Adjust the placement of the roof vertically.
All of This parameters can be modified once this blueprint is placed in the world.
@ -55,36 +55,36 @@ All of This parameters can be modified once this blueprint is placed in the worl
!!! Bug
See [#35 SplineMeshRepeater loses its collider mesh](https://github.com/carla-simulator/carla/issues/35)
### Standard use:
SplineMeshRepeater "Content/Blueprints/SplineMeshRepeater" is a tool included in the Carla Project to help building urban environments; It repeats and aligns a specific choosen mesh along a [Spline](https://docs.unrealengine.com/latest/INT/Engine/BlueprintSplines/Reference/SplineEditorTool/index.html) (Unreal Component). Its principal function is to build Tipicaly tiled and repetitive structures as Walls, Roads, Bridges, Fences... Once the actor is placed into the world the spline can be modified so the object gets the desired form. Each Point Defining the spline Generates a new tile so that as more points the Spline has, the more defined it will be, but also heavyer on the world. This actor is defined by the following parameters:
SplineMeshRepeater "Content/Blueprints/SplineMeshRepeater" is a tool included in the Carla Project to help building urban environments; It repeats and aligns a specific choosen mesh along a [Spline](https://docs.unrealengine.com/latest/INT/Engine/BlueprintSplines/Reference/SplineEditorTool/index.html) (Unreal Component). Its principal function is to build Tipicaly tiled and repetitive structures as Walls, Roads, Bridges, Fences... Once the actor is placed into the world the spline can be modified so the object gets the desired form. Each Point Defining the spline Generates a new tile so that as more points the Spline has, the more defined it will be, but also heavier on the world. This actor is defined by the following parameters:
- StaticMesh: The mesh to be repeated along the spline.
- ForWardAxis: Changes the mesh axis to be alingned with the spline.
- ForWardAxis: Changes the mesh axis to be aligned with the spline.
- Material: Overrides the mesh' default material.
- Colission Enabled: Chooses the tipe of colission to use.
- Collision Enabled: Chooses the type of collision to use.
- Gap distance: Places a Gap between each repeated mesh, for repetitive non continuous walls: bush chains, bollards...
(Last three variables are specific for some particular assets to be defined in the next point) A requisite to create assets compatibles with this componenis is that all the meshes have their pivot placed wherever the repetition starts in the lower point possible with the rest of the mesh pointing positive (Preferably by the X axis)
(Last three variables are specific for some particular assets to be defined in the next point) A requisite to create assets compatibles with this component is that all the meshes have their pivot placed wherever the repetition starts in the lower point possible with the rest of the mesh pointing positive (Preferably by the X axis)
### Specific Walls (Dynamic material)
In the project folder "Content/Static/Walls" are included some specific assets to be used with this SplineMeshRepeater with a series of special caracteristics. The uv space of this meshes and their materials are the same for all of them, making them excangeable. each material is composed of three different surfaces the last three parameters slightly modify the color of this surfaces:
In the project folder "Content/Static/Walls" are included some specific assets to be used with this SplineMeshRepeater with a series of special characteristics. The uv space of this meshes and their materials are the same for all of them, making them exchangeable. each material is composed of three different surfaces the last three parameters slightly modify the color of this surfaces:
- MainMaterialColor: Change the main material of the Wall
- DetailsColor: Change the color of the details (if any)
- TopWallColor: Cambia el color de la cubierta del muro (if any)
- TopWallColor: Change the color of the wall cover (if any)
To add elements that profit from this functions exist in the (Carpeta) folder the GardenWallMask File that defines the uv space to place the materials: (Blue space: MainMaterial; green space: Details; red space TopWall).
To add elements that profit from this functions exist the GardenWallMask File that defines the uv space to place the materials: (Blue space: MainMaterial; green space: Details; red space TopWall).
Between the material masters is WallMaster which is going to be the master of the materials using this function. An instance of this material will be created and the correspondent textures will be added. This material includes the following parameters to be modified by the material to use:
- Normal Flattener: Slightly modifies the normal map values to exagerate it or flatten it.
- RoughnessCorrection: Para corregir El valor de rugosidad dado por la textura.
- Normal Flattener: Slightly modifies the normal map values to exaggerate it or flatten it.
- RoughnessCorrection: Changes the Roughness value given by the texture.
The rest of the parameters are the mask the textures and the color corrections that won't be modified in this instance but in the blueprint that will be launched into the world.
@ -92,7 +92,7 @@ Between the material masters is WallMaster which is going to be the master of th
## Weather
This is the actor in charge of modifying all the lighting, environmental actors an anything that affects the impression of the climate. It runs automaticaly with the game when is not specified otherwise In the Config.Ini but has Its own actor to launch in editor mode to configure the climatic conditions. To fuly work It will need One of each of the folowing actors: SkySphere, Skylight, Postprocess Volume (Boundless) And Light Source to exist in the world.
This is the actor in charge of modifying all the lighting, environmental actors an anything that affects the impression of the climate. It runs automatically with the game when is not specified otherwise In the Config.Ini but has Its own actor to launch in editor mode to configure the climatic conditions. To fully work It will need One of each of the following actors: SkySphere, Skylight, Postprocess Volume (Boundless) And Light Source to exist in the world.
- SunPolarAngle: polar angle of the sun, determines time of the day
- SunAzimuthAngle: adds to the location of the sun in the current level
@ -100,7 +100,7 @@ This is the actor in charge of modifying all the lighting, environmental actors
- SunDirectionalLightIntensity: Intensity of the sunlight
- SunDirectionalLightColor: Color of the sunlight
- SunIndirectLightIntensity: intensity of the bounces of the main light
- CloudOpacity: visivility of the cloud rendering on the skybox
- CloudOpacity: visibility of the cloud rendering on the skybox
- HorizontFalloff: determines the height of the gradient between the zenith and horizon color
- ZenithColor: Defines the color of the zenith.
- HorizonColor: Defines the color of the horizon.
@ -111,7 +111,7 @@ This is the actor in charge of modifying all the lighting, environmental actors
- Precipitation: Defines if any precipitation is active.
- PrecipitationType: the type of precipitation to active.
- PrecipitationAmount: the quantity of the chosen precipitation.
- PrecipitationAccumulation: the acumulation of the chosen precipitation.
- PrecipitationAccumulation: the accumulation of the chosen precipitation.
- bWind: defines if there is any wind.
- WindIntensity: defines the wind intensity.
- WindAngle: defines the wind direction.
@ -122,4 +122,4 @@ This is the actor in charge of modifying all the lighting, environmental actors
- CameraPostProcessParameters.AutoExposureBias: Darkens or brightens the final image towards a defined bias.
You can have as many different configurations saved in the proyect as you want and choose the configuration to aply while on the build, through the [settings file](carla_settings.md); or in the editor while building the level or testing.
You can have as many different configurations saved in the project as you want and choose the configuration to aply while on the build, through the [settings file](carla_settings.md); or in the editor while building the level or testing.