diff --git a/docs/settings.md b/docs/settings.md index 8059e489c6..cff3115e61 100644 --- a/docs/settings.md +++ b/docs/settings.md @@ -40,8 +40,9 @@ Below are complete list of settings available along with their default values. I "Recording": { "RecordOnMove": false, "RecordInterval": 0.05, + "Folder": "", "Cameras": [ - { "CameraName": "0", "ImageType": 0, "PixelsAsFloat": false, "Compress": true } + { "CameraName": "0", "ImageType": 0, "PixelsAsFloat": false, "VehicleName": "", "Compress": true } ] }, "CameraDefaults": { @@ -198,11 +199,25 @@ This setting determines what is shown in each of 3 subwindows which are visible ] ``` ## Recording -The recording feature allows you to record data such as position, orientation, velocity along with the captured image at specified intervals. You can start recording by pressing red Record button on lower right or the R key. The data is stored in the `Documents\AirSim` folder, in a time stamped subfolder for each recording session, as tab separated file. +The recording feature allows you to record data such as position, orientation, velocity along with the captured image at specified intervals. You can start recording by pressing red Record button on lower right or the R key. The data is stored in the `Documents\AirSim` folder (or the folder specified using `Folder`), in a time stamped subfolder for each recording session, as tab separated file. * `RecordInterval`: specifies minimal interval in seconds between capturing two images. * `RecordOnMove`: specifies that do not record frame if there was vehicle's position or orientation hasn't changed. -* `Cameras`: this element controls which cameras are used to capture images. By default scene image from camera 0 is recorded as compressed png format. This setting is json array so you can specify multiple cameras to capture images, each with potentially different [image types](settings.md#image-capture-settings). When PixelsAsFloat is true, image is saved as [pfm](pfm.md) file instead of png file. +* `Folder`: Parent folder where timestamped subfolder with recordings are created. Absolute path of the directory must be specified. If not used, then `Documents/AirSim` folder will be used. E.g. `"Folder": "/home//Documents"` +* `Cameras`: this element controls which cameras are used to capture images. By default scene image from camera 0 is recorded as compressed png format. This setting is json array so you can specify multiple cameras to capture images, each with potentially different [image types](settings.md#image-capture-settings). + * When `PixelsAsFloat` is true, image is saved as [pfm](pfm.md) file instead of png file. + * `VehicleName` option allows you to specify separate cameras for individual vehicles. If the `Cameras` element isn't present, `Scene` image from the default camera of each vehicle will be recorded. + * If you don't want to record any images and just the vehicle's physics data, then specify the `Cameras` element but leave it empty, like this: `"Cameras": []` + +For example, the `Cameras` element below records scene & segmentation images for `Car1` & scene for `Car2`- + +```json +"Cameras": [ + { "CameraName": "0", "ImageType": 0, "PixelsAsFloat": false, "VehicleName": "Car1", "Compress": true }, + { "CameraName": "0", "ImageType": 5, "PixelsAsFloat": false, "VehicleName": "Car1", "Compress": true }, + { "CameraName": "0", "ImageType": 0, "PixelsAsFloat": false, "VehicleName": "Car2", "Compress": true } +] +``` ## ClockSpeed This setting allows you to set the speed of simulation clock with respect to wall clock. For example, value of 5.0 would mean simulation clock has 5 seconds elapsed when wall clock has 1 second elapsed (i.e. simulation is running faster). The value of 0.1 means that simulation clock is 10X slower than wall clock. The value of 1 means simulation is running in real time. It is important to realize that quality of simulation may decrease as the simulation clock runs faster. You might see artifacts like object moving past obstacles because collision is not detected. However slowing down simulation clock (i.e. values < 1.0) generally improves the quality of simulation.