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-3 files. Those correspond to the four modules of the app.
Files location:
KinectSandbox\KinectSandbox_Data\StreamingAssets\Settings\settings_0.json-settings_9.json
KinectSandbox\KinectSandbox_Data\StreamingAssets\Settings\settings_mode_0.json-settings_mode_3.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 the previous article. They will be listed here with a right annotation.
Description:
“UseGlobal”: true, – This lane 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 module [0 – Interactive Map, 1 – AR-Ball Game, 2 – Paradise Island, 3 – AR-Discovery Game]; in a setup with touchscreen there will be 4 settings_mode_ files, each for a different module; in a setup without touchscreen you can freely assing the 4 modules 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 module; 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: KinectSandbox\KinectSandbox_Data\ StreamingAssets\Colors; 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.80000114440918, – 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 AR-Ball game module; 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 Paradise Island module; they should be defined in settings_mode_2 file;
“NormalizedWaterLevel”: 0.40 – 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.47 – Water texture visibility [0.00-2.00]; also affects water colour;
“MinWaterColor”: 0.11 – 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];
“CrabsEnabled”: false, – Enable mini crab game
“CrabLifetime”: 0.0, –
“CrabStoneLifeTime”: 0.0,
“CrabStoneDisappearDelay”: 0.0,
“ScaleFactor”: 1.0 – Scale models for the best experience
“ArcheologySettings”: – Parameters listed below apply to the AR-Discovery Game module; 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).