How to add automotive materials

Docs/how_to_add_automotive_materials.md

@@ -0,0 +1,42 @@
+How to add the automotive materials
+===================================
+
+CARLA uses Epic Game's Automotive Materials package for a realistic car paint
+look. Due to license restrictions we are not allowed to redistribute this
+package. In this document we explain how to download and link these materials to
+our vehicles.
+
+Download from Marketplace
+-------------------------
+
+Epic Games' [Automotive Materials][automatlink] package can be downloaded for
+free from the Unreal Engine Marketplace.
+
+NOTE: Unfortunately, Unreal's Marketplace is only available on Windows, so you
+need a Windows machine to download this package.
+
+  1. Install Epic Games Launcher from [www.unrealengine.com](https://www.unrealengine.com).
+  2. Buy the [Automotive Materials][automatlink] package for $0.
+  3. Create a new dummy project and add the Automotive Materials package to it.
+  4. Inside the "Content" folder of the newly created project, you can find the "AutomotiveMaterials" folder. Copy this folder to the CARLA project
+    - `{NewProject}/Content/AutomotiveMaterials` --> `{CARLA}/Unreal/CarlaUE4/Content/AutomotiveMaterials`
+
+[automatlink]: https://www.unrealengine.com/marketplace/automotive-material-pack
+
+Manually link the materials
+---------------------------
+
+Right after opening the project, you should link the automotive materials you
+just downloaded.
+
+In the content browser, go to "Content/Static/Vehicles/MaterialRedirectors" and
+open "RedirectorInstance".
+
+![Unreal Engine Screenshot 1](img/materials_screenshot_00.png)
+
+Under the "Details" pane, search for the "Parent" material, and replace
+"DummyCar" material by "M_Carpaint" material.
+
+![Unreal Engine Screenshot 2](img/materials_screenshot_01.png)
+
+Now save "RedirectorInstance", and you are ready to go.

Docs/how_to_build_on_linux.md

@@ -51,7 +51,10 @@ takes a while
 
 Download Epic Games' Automotive Materials package and install it under
 "Unreal/CarlaUE4/Content/AutomotiveMaterials".
-[How to download automotive materials](how_to_download_automotive_materials.md).
+[How to download automotive materials](how_to_add_automotive_materials.md).
+
+IMPORTANT: Do not forget to link the automotive materials after opening the
+project.
 
 NOTE: Due to license restrictions, pedestrians are not include in the CARLA open
 source project (only in the compiled binaries). Some warnings may appear when
@@ -66,6 +69,10 @@ clean rebuild of CARLA
 It looks at the environment variable `UE4_ROOT` to find the right version of
 Unreal Engine. You can also add this variable to your "~/.bashrc" or similar.
 
+Once the project is opened, it is required to manually link Epic's Automotive
+Material to our vehicles.
+[How to link automotive materials](how_to_add_automotive_materials.md).
+
 Test (Optional)
 ---------------
 

Docs/how_to_download_automotive_materials.md

@@ -1,16 +0,0 @@
-How to download automotive materials
-====================================
-
-Epic Games' [Automotive Materials][automatlink] package can be downloaded for
-free from the Unreal Engine Marketplace.
-
-NOTE: Unfortunately, Unreal's Marketplace is only available on Windows, so you
-need a Windows machine to download this package.
-
-  1. Install Epic Games Launcher from [www.unrealengine.com](https://www.unrealengine.com).
-  2. Buy the [Automotive Materials][automatlink] package for $0.
-  3. Create a new dummy project and add the Automotive Materials package to it.
-  4. Inside the "Content" folder of the newly created project, you can find the "AutomotiveMaterials" folder. Copy this folder to the CARLA project
-    - `{NewProject}/Content/AutomotiveMaterials` --> `{CARLA}/Unreal/CarlaUE4/Content/AutomotiveMaterials`
-
-[automatlink]: https://www.unrealengine.com/marketplace/automotive-material-pack