New iteration with new jpt pics and first draft on 4 wheeled vehicles

Docs/core_map.md

@@ -215,37 +215,37 @@ So far there are seven different maps available. Each one has unique features an
 <div class="townslider-container">
   <!-- Town slide images -->
   <div class="townslide fade">
-  <img src="../img/Town01.png">
+  <img src="../img/Town01.jpg">
     <div class="text">Town01</div>
   </div>
 
   <div class="townslide fade">
-  <img src="../img/Town02.png">
+  <img src="../img/Town02.jpg">
     <div class="text">Town02</div>
   </div>
 
   <div class="townslide fade">
-    <img src="../img/Town03.png">
+    <img src="../img/Town03.jpg">
     <div class="text">Town03</div>
   </div>
 
   <div class="townslide fade">
-    <img src="../img/Town04.png">
+    <img src="../img/Town04.jpg">
     <div class="text">Town04</div>
   </div>
 
   <div class="townslide fade">
-    <img src="../img/Town05.png">
+    <img src="../img/Town05.jpg">
     <div class="text">Town05</div>
   </div>
 
   <div class="townslide fade">
-    <img src="../img/Town06.png">
+    <img src="../img/Town06.jpg">
     <div class="text">Town06</div>
   </div>
 
   <div class="townslide fade">
-    <img src="../img/Town07.png">
+    <img src="../img/Town07.jpg">
     <div class="text">Town07</div>
   </div>
 

Docs/tuto_A_add_vehicle.md

@@ -1,46 +1,101 @@
 # Add a new vehicle
 
+This tutorial covers step by step the process to add a new vehicle model. From the very moment the model is finished, to a simple test in CARLA.  
+
+*   [__Add a 4 wheeled vehicle__](#add-a-4-wheeled-vehicle)  
+	*   [Bind the skeleton](#bind-the-skeleton)  
+	*   [Import and prepare the vehicle](#import-and-prepare-the-vehicle)  
+
+!!! Important
+    This tutorial only applies to users that work with a build from source, and have access to the Unreal Editor. 
+
 ---
 ## Add a 4 wheeled vehicle
 
-Follow [Art Guide][artlink] for creating the Skeletal Mesh and Physics Asset. And [Vehicles User Guide][userguide] for the rest.
+### Bind the skeleton
 
-[artlink]: https://docs.unrealengine.com/en-US/Engine/Physics/Vehicles/VehicleContentCreation/index.html
+CARLA provides a general skeleton for 4-wheeled vehicles that must be used by all of them. The position and orientation of the bones can be changed, but adding new bones or changing he hierarchy will lead to errors.  
-[userguide]: https://docs.unrealengine.com/latest/INT/Engine/Physics/Vehicles/VehicleUserGuide/
 
-!!! important
+__1.   Download the skeleton__ `General4WheeledVehicleSkeleton` from [LINK].  
-    If you want a simpler way you might copy our "General4wheeledSkeleton" from our project,
+<br>
-    either by exporting it and copying it into your model or by creating your skelleton using
+__2.   Import the skeleton__ into the 3D project of the new vehicle. This could be in Maya, Blender or whichever software used for modelling.  
-    the same bone names and orientation.<br>
+<br>
-    Bind it to your vehicle model and choose it when importing your vehicle into the editor.
+__3.   Bind the bones__ to the corresponding bone.  
-    This way you won't need to configure the animation, you might just use
-    "General4wheeledAnimation" (step 4)<br>
-    You also won't need to configure the bone names for your wheels
-    (Step 8. Be carefull, you'll still need to asign the wheel blueprints).
 
-__1.__ Import fbx as Skelletal Mesh to its own folder inside `Content/Carla/Static/Vehicles`. A Physics asset and a Skeleton should be automatically created and linked the three together.  
+*   Bind each wheel to the bone named as `???`. Make sure to center the bone inside the wheel.  
+*   Bind the rest of the mesh to the bone `VehicleBase`.  
+
+!!! Warning
+    Do not add new bones, change their names or the hierarchy.  
+
+__4.   Export the result__. Select all the meshes and the base of the skeleton and export as `.fbx`.  
+
+
+### Import and prepare the vehicle
+
+*   __1. Create a new folder__ named `<vehicle_name>` in `Content/Carla/Static/Vehicle`.  
 <br> 
-__2.__ Delete the automatically created ones and add boxes to the `Vehicle_Base` bone matching the shape, make sure generate hit events is enabled. Add a sphere for each wheel.  
+
+*   __2. Import the `.fbx`__ in its folder. The Skelletal Mesh will appear along with two new files, `<vehicle_name>_PhysicsAssets` and `<vehicle_name>_Skeleton`.  
+	*   __2.1 - *Import Content Type*__ — `Geometry and Skinning Weights`.  
+	*   __2.2 - *Normal Import Method*__ — `Import Normals`.  
+	*   __2.3 - *Material import method*__ — Optionally choose `Do not create materials` and uncheck `Import Textures` to avoid Unreal .  
+
+!!! Note
+    If Unreal does not create the vehicle materials, these will have to be created manually.  
+
+*   __3. Open `<vehicle_name>_PhysicsAssets`__ to set the vehicle colliders.  
+	*   __3.1 - Change the wheels colliders__ — Select a sphere and adjust it to the shape of the wheel.  
+	*   __3.2 - Change the general collider__ — Select a box and adjust it to the shape of the vehicle.  
+	*   __3.3 - *Physics Type*__ — `Kinematic`.  
+	*   __3.4 - *Simulation Generates Hit Event*__ — Enabled.  
 <br>
-__3.__ __Tune the physics.__ In `Details/Physics`, set their "Physics Type" to __`Kinematic`__, and enable the __`Simulation generates hit events`__ option.  
+
+*   __4. Create the Animation Blueprint__. In the new vehicle folder, click right and go to `Create advanced asset/Animation/Animation blueprint`.  
+	*   __4.1 - *Parent Class*__ — `VehicleAnimInstance`.  
+	*   __4.2 - *Skeleton*__ — `<vehicle_name>_Skeleton`.  
+	*   __4.3 - Rename the blueprint__ — `BP_<vehicle_name>_anim`.  
+	*   __4.4 - Copy an existing Animation Blueprint__ — Go to `Content/Carla/Static/Vehicle` and choose any vehicle folder. Open its Animation Blueprint and copy the content.  
+	*   __4.5 - Compile the Animation Blueprint__ — Connect the content in the blueprint and click the button `Compile` on the top left corner.  
 <br>
-__4.__ Inside that folder create an "Animation Blueprint", while creating select "VehicleAnimInstance" as parent class and the skeleton of this car model as the target skeleton. Add the animation graph as shown in the links given above (or look for it in other cars' animation, like Mustang).  
+
+*   __5. Create folder for the vehicle blueprints__. Go to `Content/Carla/Blueprints/Vehicles` and create a new folder `<vehicle_name>`.  
 <br>
-__5.__ Create folder `Content/Carla/Blueprints/Vehicles/<vehicle-model>`  
+
+*   __6. Create blueprints for the wheels__. Inside the folder, right-click and go to `Created advanced assets/Blueprints class`. Create two blueprints derived from `VehicleWheel`, one named `<vehicle_name>_FrontWheel` and the other `<vehicle_name>_RearWheel`.  
+	*   __6.1 - *Shape radius*__ — Exactly the radius, not diameter, of the wheel mesh.  
+	*   __6.2 - *Rig Config*__ — `CommonTireConfig`.  
+	*   __6.3 - On the front wheel__ — Uncheck `Affected by Handbrake`.  
+	*   __6.4 - On the rear wheel__ — Set `Steer Angle` to `0`.  
 <br>
-__6.__ Inside that folder create two blueprint classes derived from "VehicleWheel" class. Call them `<vehicle-model>_FrontWheel` and `<vehicle-model>_RearWheel`. Set their "Shape Radius"
+
-to exactly match the mesh wheel radius (careful, radius not diameter). Set their "Tire Config" to "CommonTireConfig". On the front wheel uncheck "Affected by Handbrake" and on the rear wheel set "Steer Angle" to zero.  
+*   __7. Create a blueprint for the vehicle__. Inside the folder, create another blueprint derived from `BaseVehiclePawn` and named `BP_<vehicle_name>`.  
+	*   __7.1 - *Mesh*__ — Choose the skelletal mesh of the vehicle.  
+	*   __7.2 - *Anim class*__ — ???.  
+	*   __7.3 - *Vehicle bound*__ — Adjust it to include the whole volume of the vehicle.  
 <br>
-__7.__ Inside the same folder __crate a child blueprint class__ derived from `BaseVehiclePawn` call it `<vehicle-model>`. Open it for edit and select component "Mesh", setup the "Skeletal Mesh"
+
-and the "Anim Class" to the corresponding ones. Then select the VehicleBounds component and set the size to cover vehicle's volume as close as possible.  
+*   __8. Pair the wheels with their blueprint__. In `Vehicle Movement/Wheel Setups` expand the menu and prepare each wheel.  
+	*   __8.1 - *Wheel_Front_Left*__ — `<vehicle_model>_FrontWheel`  
+	*   __8.2 - *Wheel_Front_Right*__ — `<vehicle_model>_FrontWheel`  
+	*   __8.3 - *Wheel_Rear_Left*__ — `<vehicle_model>_RearWheel`  
+	*   __8.4 - *Wheel_Rear_Right*__ — `<vehicle_model>_RearWheel`  
 <br>
-__8.__ Select component "VehicleMovement", under "Vehicle Setup" expand "Wheel Setups", setup each wheel  
+
-    - 0: Wheel Class=`<vehicle-model>_FrontWheel`, Bone Name=`Wheel_Front_Left`  
+*   __9 - Compile the blueprint__ — Click the button `Compile` on the top left corner.  
-    - 1: Wheel Class=`<vehicle-model>_FrontWheel`, Bone Name=`Wheel_Front_Right`  
-    - 2: Wheel Class=`<vehicle-model>_RearWheel`, Bone Name=`Wheel_Rear_Left`  
-    - 3: Wheel Class=`<vehicle-model>_RearWheel`, Bone Name=`Wheel_Rear_Right`  
 <br>
-__9.__ Test it, go to CarlaGameMode blueprint and change "Default Pawn Class" to the newly created car blueprint.
+
+*   __10 - Add the vehicle__. In `Content/Carla/Blueprint/Vehicle`, open the `VehicleFactory` and add a new element to the array of vehicles.  
+	*   __10.1 - *Make*__ — Choose a name to be used in Unreal.  
+	*   __10.2 - *Model*__ — Choose the name to be used in the blueprint library in CARLA.  
+	*   __10.3 - *Class*__ — `BP_<vehicle_name>`.  
+	*   __10.4 - *Recommended colours*__ — Optionally, provide a set of recommended colours for the vehicle.  
+<br>
+
+*   __11. Test the vehicle__. Launch CARLA, open a terminal in `PythonAPI/examples` and run the following command.  
+```sh
+python manual_control.py --filter <model_name>
+```
 
 ---
 ## Add a 2 wheeled vehicle

Docs/tuto_A_map_customization.md

@@ -42,15 +42,15 @@ The blueprint __BP_RepSpline__ adds __individual__ elements along the path defin
 *   __Consecutive__ — If selected, ???.  
 *   __Collision enabled__ — Set the type of collisions enabled for the meshes.  
 
-![bp_repspline_pic](img/map_customization/bp_repspline.png)
+![bp_repspline_pic](img/map_customization/bp_repspline.jpg)
 
 ### BP_Spline
 
 The blueprint __BP_Spline__ adds __connected__ elements __strictly__ following the path defined by a Bezier curve. The mesh will be warped to fit the path created.  
 
-*   __Gap distance__ — Set the distance between elements.  
+*   __Gap distance__ — Add a separation between elements.  
 
-![bp_spline_pic](img/map_customization/bp_spline.png)
+![bp_spline_pic](img/map_customization/bp_spline03.jpg)
 
 ### BP_Wall
 
@@ -60,7 +60,7 @@ The blueprint __BP_Wall__ adds __connected__ elements along the path defined by
 *   __Vertically aligned__ — If selected, the elements will be vertically aligned regarding the world axis.  
 *   __Scale offset__ — Scale the length of the mesh to round out the connection between elements.  
 
-![bp_wall_pic](img/map_customization/bp_wall.png)
+![bp_wall_pic](img/map_customization/bp_wall02.jpg)
 
 
 ### BP_SplinePowerLine
@@ -69,7 +69,7 @@ The blueprint __BP_SplinePowerLine__ adds __electricity poles__ along the path d
 
 This blueprint can be found in `Carla/Static/Pole`. This blueprint allows to set an __array of meshes__ to repeat, to provide variety.  
 
-![bp_splinepowerline_pic](img/map_customization/bp_splinepowerline.png)
+![bp_splinepowerline_pic](img/map_customization/bp_splinepowerline.jpg)
 
 The power line that connects the pole meshes can be customized.  
 
@@ -77,15 +77,15 @@ The power line that connects the pole meshes can be customized.
 *   __Edit the tension__ value. If `0`, the power lines will be staight. The bigger the value, the looser the connection.  
 *   __Set the sockets__. Sockets are empty meshes that represent the connection points of the power line. A wire is created form socket to socket between poles. The amount of sockets can be changed inside the pole meshes.  
 
-![bp_powerline_socket_pic](img/map_customization/bp_splinepowerline_sockets.png)
+![bp_powerline_socket_pic](img/map_customization/bp_splinepowerline_sockets02.jpg)
 
 !!! Important
-    If the amount of sockets between poles changes, visualization issues may arise. 
+    The amount of sockets and their names should be consistent between poles. Otherwise, visualization issues may arise. 
 
 ---
 ## Procedural buildings
 
-The blueprint __BP_Procedural_Building__ in `Content/Carla/Blueprints` creates a realistic building using key meshes that are repeated along the structure. For each of them, the user can provide an array of meshes that will be used at random for variety. The meshes are only created once, and the repetitions will be instances of the same to save up costs.  
+The blueprint __BP_Procedural_Building__ in `Content/Carla/Blueprints/LevelDesign` creates a realistic building using key meshes that are repeated along the structure. For each of them, the user can provide an array of meshes that will be used at random for variety. The meshes are only created once, and the repetitions will be instances of the same to save up costs.  
 
 !!! Note
     Blueprints can be used instead of meshes, to allow more variety and customization for the building. Blueprints can use behaviour trees to set illumination inside the building, change the materials used, and much more.  
@@ -110,8 +110,8 @@ The following picture represents the global structure.
 
 The __Base parameters__ set the dimensions of the building.  
 
-*   ___???__ — Floors of the building. Repetitions of the __Body__ meshes.  
+*   ___Num Floors__ — Floors of the building. Repetitions of the __Body__ meshes.  
-*   __??? and ???__ — Area of the building. Repetitions of the central meshes for each side of the building.  
+*   __Length X and Length Y__ — Area of the building. Repetitions of the central meshes for each side of the building.  
 
 > *Picture as above but with more complex structure. With several floors and repetitions. Cube scheme and final result side to side.*  
 
@@ -120,8 +120,8 @@ The __Base parameters__ set the dimensions of the building.
 There are some additional options to modify the general structure of the building.  
 
 *   __Disable corners__ — If selected, no corner meshes will be used.  
-*   __Doors__ — Meshes that appear in the ground floor, right in front of the central meshes. The amount of floors and their location can be set __???__.  
+*   __Doors__ — Meshes that appear in the ground floor, right in front of the central meshes. The amount of dloors and their location can be set. `0` is the initial position, `1` the next base repetition, and so on.  
-*   __Walls__ — Plane meshes that substitute one or more sides of the building.  
+*   __Walls__ — Meshes that substitute one or more sides of the building. For example, a plane mesh can be used to paint one side of the building. 
 
 > *Picture for the three of them side to side?*  
 

Docs/tuto_G_retrieve_data.md

@@ -607,7 +607,6 @@ def rad_callback(radar_data):
         r = int(clamp(0.0, 1.0, 1.0 - norm_velocity) * 255.0)
         g = int(clamp(0.0, 1.0, 1.0 - abs(norm_velocity)) * 255.0)
         b = int(abs(clamp(- 1.0, 0.0, - 1.0 - norm_velocity)) * 255.0)
-        print("I got here")
         world.debug.draw_point(
             radar_data.transform.location + fw_vec,
             size=0.075,