Preset/Mode Settings

The Settings files describe a set of preset-specific parameters and/or overwrite the ones defined in GlobalSettings. Files settings_0-9 correspond to 10 presets available at keys 0-9 on a keyboard/keypad. When touchscreen control is activated, the application loads settings_mode_0-4 files. Those correspond to the five modes of the app.

Files location:
KinectSandboxKinectSandbox_DataStreamingAssetsSettingssettings_0.json-settings_9.json
KinectSandboxKinectSandbox_DataStreamingAssetsSettingssettings_mode_0.json-settings_mode_4.json

Values in bold are recommended ones and can be used as a reference. They are set in the files by default. Values in [brackets] describe the possible range.

Parameters that are by default defined in the GlobalSettings file are described in another article. They will be listed here with a right annotation.

Description:

“UseGlobal”: true, – This line states that the global value of a parameter is used [true, false]; change to ‘false’ to overwrite;

“Value”: 0 – Default when using global values; enter the right value here when overwriting; value range for individual parameters can be found in the previous article;


“Mode”: 0 – Application mode [0 – Interactive Map, 1 – GraviBall (previously AR-Ball Game), 2 – Magic Worlds (previously Paradise Island), 3 – DigQuest (previously AR-Discovery Game), 4 – Sandscape Secrets]; in a setup with touchscreen there will be 5 settings_mode_ files, each for a different mode; in a setup without touchscreen you can freely assing the 4 modes to the 10 available preset settings_ files;


“TargetFPS”:By default in GlobalSettings;

“RefreshRate”:By default in GlobalSettings;

“TerrainBottomLevel”:By default in GlobalSettings;

“TerrainTopLevel”:By default in GlobalSettings;

“TerrainMinLevel”:By default in GlobalSettings;

“TerrainMaxLevel”:By default in GlobalSettings;

“Walls”: {
“Right”: ,
“Left”: ,
“Top”: ,
“Bottom”:
}
By default in GlobalSettings;

“WaterDropOffset”: By default in GlobalSettings;

“SandboxTopLevel”: By default in GlobalSettings;

“SandboxBottomLevel”: By default in GlobalSettings;


Parameters listed below apply to the Interactive Map mode; they should be defined in settings_mode_0 file;

“ColorsPalette”: “1_complex/00_colors_realhipso.txt” – Colour scale palette – name of the file from folder: KinectSandboxKinectSandbox_Data StreamingAssetsColors; the default colour palette ‘1_complex/00_colors_realhipso.txt‘ is the hypsometric scale; you can create your own files according to the pattern;

“TerrainTopoLines”: true – Contour lines on/off [true, false];

“TerrainSmoothColors”: false – Colours blending on/off [true, false]; when set to ‘true’ the transitions between colour regions become smoother – in combination with contour lines switched off this can help achieve a more natural look;

“OverlayImage”: “0_maps/00_castles.png”, – Transparent image projected on top of the map – name of the file from folder: KinectSandbox\KinectSandbox_Data\StreamingAssets\OverlayImages; you can upload your own images – they will be scaled to the size of your sandbox, so try to keep the same resolution (1920×1080 all models except Large Standalone – 1920×1200; your projector native resolution)to avoid quality losses and distortions; mind the naming pattern;

“OverlayImageActiveByDefault”: false – Turns on/off the overlay image visibility [true, false];

“WaterSettings”: {
“DrainMin”: 0.0, – Speed at which liquid is drained into the surface – minimum value available on the touchscreen control;
“DrainMax”: 150, – Speed at which liquid is drained into the surface – maximum value available on the touchscreen control;
“DrainValue”: 0.0, – Actual value of the speed at which liquid is draining into the surface;
“DropSizeMin”: 0.0, – Minimum value available on the touch screen;
“DropSizeMax”: 10.0, – Maximum value available on the touch screen;
“DropSizeValue”: 10.0, – Actual value of the amount of liquid dropped by waving the hand over the sandpit;
“WaterMaterialIndex”: 0, – Type of the fluid [0..6];
“WaterActiveByDefault”: true, – Is water activated by default on application start [true,false];
“WaterStaticLevel”: 4.9, – The amount of water dropped using the flood button [0..10];
“SetStaticLevelOnStart”: false – Flood area on start [true,false];
},


“GameSettings”: Parameters listed below apply to the GraviBall mode (previously AR-Ball Game); they should be defined in settings_mode_1 file;

“ElementsScaleFactor”: 1.0 – Scale models for the best experience

“LevelScaleFactor”: 1.0; – Scale game size to match sandpit size


“ParadiseIslandSettings”: – Parameters listed below apply to the Magic Worlds mode (previously Paradise Island); they should be defined in settings_mode_2 file;

“NormalizedWaterLevel”: 0.50 – Absolute water level [0.00-1.00]; independent from ‘TerrainBottom/TopLevels’; value 0.00 results in no water, value 1.00 results in water all over land;

“WaterSoft”: 0.70 – Water texture visibility [0.00-2.00]; also affects water colour;

“MinWaterColor”: 0.40 – Water clarity, or ‘blueness’ [0.00-2.00]; lower numbers give a more transparent look of shallow waters, higher numbers give an impression of deep abyss;

“WindDirection”: 60.0 – Direction the wind blows in; value is based on a 360 degree scale [0.0-360.0];

“WindPower”: 0.20 – Force of the wind [0.00-2.00];

“VolcanoEnabled”: false – Enable volcano creation [true,false];

“CrabsEnabled”: false – Enable mini crab game [true,false];

“CrabLifetime”: 15.0 – Time the crab moves on the game board (in seconds) [0.0-60.0];

“CrabStoneLifeTime”: 10.0 – Time (in seconds) after which the untouched stone disappears [0.0-60.0];

“CrabStoneDisappearDelay”: 3.0 – Time (in seconds) after which the overturned stone disappears [0.0-60.0];

“ScaleFactor”: 1.0 – Scale all models for the best experience [0.1-3.0];


“ArcheologySettings”: – Parameters listed below apply to the DigQuest mode (previously AR-Discovery Game); they should be defined in settings_mode_3 file;

“LevelingPrecision”: 0.005 – States how precisely the terrain has to be levelled [0.001-0.010]; lower numbers mean higher precision;

“LevelingTarget”: 0.70 – Portion of terrain that has to be levelled to start digging process [0.01-1.00];

“DiggingPrecision”: 0.002 – States how precisely the item has to be excavated [0.001-0.010]; lower numbers mean higher precision;

“DiggingTarget”: 0.80 Portion of item that has to be excavated to finish the task [0.01-1.00];

“ElementsScaleFactor”: 1.00 – Allows for scaling the hidden objects to match the size of the sandpit [0.01-3.00];

“ThicknessScaleFactor”: 1.00 – Allows for changing the thickness or ‘depth’ of the hidden object to match the depth of the sandpit [0.01-3.00];

“DiggingAreaOffset”: 4.00 – The parameter describes the amount of sand above the model (how deep you have to dig to see the model).


“FadeSettings”: – Parameters listed below apply to the Sandscape Secrets mode; they should be defined in settings_mode_4 file;

“DefaultLayers”: “3_Faces” – Default set of images from KinectSandbox\KinectSandbox_Data\StreamingAssets\FadingLayers;

“Size”: 35.0 – Scale of the image, set to match the sandpit size [0.1-100.0];

“OffsetX”: 0.95 – Horizontal alignment of the image [0.01-10.00];

“OffsetY”: 0.5 – Vertical alignment of the image [0.01-10.00];