diff --git a/Docs/how_to_add_automotive_materials.md b/Docs/how_to_add_automotive_materials.md new file mode 100644 index 000000000..1d74d78a2 --- /dev/null +++ b/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. diff --git a/Docs/how_to_build_on_linux.md b/Docs/how_to_build_on_linux.md index dde52ee54..254c8b9af 100644 --- a/Docs/how_to_build_on_linux.md +++ b/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) --------------- diff --git a/Docs/how_to_download_automotive_materials.md b/Docs/how_to_download_automotive_materials.md deleted file mode 100644 index 3cc8b0207..000000000 --- a/Docs/how_to_download_automotive_materials.md +++ /dev/null @@ -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 diff --git a/Docs/img/materials_screenshot_00.png b/Docs/img/materials_screenshot_00.png new file mode 100644 index 000000000..e21daac43 Binary files /dev/null and b/Docs/img/materials_screenshot_00.png differ diff --git a/Docs/img/materials_screenshot_01.png b/Docs/img/materials_screenshot_01.png new file mode 100644 index 000000000..2f97dfe14 Binary files /dev/null and b/Docs/img/materials_screenshot_01.png differ