St/rocket launch play testing

docs/rocket-launch.md

@@ -1,18 +1,37 @@
 # Rocket Launch
 
-The rocket launch mini-game increases the size of the rocket launch flame based on head movement (pitch or yaw)
-and gaze steadiness.
+The rocket launch mini-game requires the player to hold a steady gaze at a target object whilst 
+either shaking or nodding their head. If the gaze is steady and a minimum head speed is maintained 
+then a timer decrements until launch time is achieved.
 
 ## Main objects / values to edit during play testing
 
-- **LaunchController**: Attached to the rocket object. Varies flame size depending on head motion and contains overall timer.
-  - Launch time: The overall time in seconds that the level takes.
-  - Head Pose Buffer Capacity (n) and speed time (s): head speed is measured as the average change in pitch or yaw over the time period speed time. The buffer will need to be sufficiently large to support the time based on game frame rate.
-  - speed scale: Scales the size of the flame based on head speed. A bigger number means a bigger flame.
-  - acceleration: The acceleration of the rocket when it launches.
+- **LaunchController**: Attached to the rocket object. Controls the overall launch process.
+  - Launch time: The starting launch time in seconds. May be increased by adaptive difficulty features below.
+  - **Head Movement Variables**: Determine the amount of head movement required to decrement the timer.
+    - Head Pose Buffer Capacity (n) and speed time (s): head speed is measured as the average change in pitch or yaw over the time period speed time. The buffer will need to be sufficiently large to support the time based on game frame rate.
+    - Shake Speed Reduction: Because it is possible (for me at least) to shake my head quicker than I can nod, there is a scaling factor between the head speeds required for shaking or nodding. Setting to 0.5 for example means that the player must shake their head twice as fast as nodding to achieve the same effect. 
+  - **Steady Gaze Variables**: Determine how steady the gave must be to decrement the timer.
+    - Timer Duration: How long (in seconds) the player must maintain a steady gaze to increment the count down code display.
+    - Gaze Pose Buffer Capacity (n) and gaze time (s), gaze steadiness is measured as the standard deviation of gaze over gaze time seconds. The buffer will need to be sufficiently large to support the time based on game frame rate.
+    - Gaze Tolerance - the allowable gaze standard deviation to be steady. Smaller number will require steadier gaze. This may be reduced by the adaptive difficulty settings below.
+    - Target Object if this is set you are required to look at that object, if not gaze can be anywhere on screen but must be steady.
+
+  - **User Interface Items**:
+    - Count down sprites: A list of sprites to use for the count down code display.
+    - Instructions Text: A text box to place the instruction text.
+    - Win Screen: Screen to show a successful launch.
+  - **Launch Speed Variables**: Control rocket behaviour at launch.
+    - acceleration: The acceleration of the rocket when it launches.
 
+  - **Debugging Variables**: Intended for debugging only.
+    - Use Mouse For Tracker: Can be used for debugging when no Tobii eye tracker is available.
+    - Gaze and Speed Status Text: Text boxes where we can write debugging information to screen.
+
+- **FlameController**: Attached to the flame object, which is a child of the rocker object.
+  - Flicker Amplitude and frequency. At rest the flame will flicker slightly to match the aesthetics of other levels. Amplitude and frequency can be altered.
+  - Flame Speed Scale: The size of the flame will increase as the head speed increases. Increasing the scale will create a bigger flame.
+  - Flame Speed move: As the flame grows we also need to move it down relative to the rocket in order to prevent the flame appearing to come out of the top of the rocket. Faster head speeds or a larger flame speed scale will require a larger value for flame speed move.
 
-- **LaunchCode**: Controls the random launch code and gaze steadiness
-  - Gaze Pose Buffer Capacity (n) and gaze time (s), gaze steadiness is measured as the standard deviation of gaze over gaze time seconds. The buffer will need to be sufficiently large to support the time based on game frame rate.
-  - Gaze Tolerance - the allowable gaze standard deviation to be steady. Smaller number will require steadier gaze.
-  - Target Object if this is set you are required to look at that object, if not gaze can be anywhere on screen but must be steady.
+- **SmokeController**: Attached to ground left/right emitter.
+  - Smoke Emission Scale: A larger value will increase the amount of smoke emitted for a given head speed.

projects/AstroBalance/Assets/Prefabs/LaunchProgressRing.prefab

@@ -0,0 +1,127 @@
+%YAML 1.1
+%TAG !u! tag:unity3d.com,2011:
+--- !u!1 &4244962871353435670
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 1297730713443137943}
+  - component: {fileID: 4604732697548752065}
+  m_Layer: 5
+  m_Name: LaunchProgressRing
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!224 &1297730713443137943
+RectTransform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 4244962871353435670}
+  m_LocalRotation: {x: -0, y: -0, z: -0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: -5}
+  m_LocalScale: {x: 1, y: 1, z: 1}
+  m_ConstrainProportionsScale: 0
+  m_Children:
+  - {fileID: 4090822809295367550}
+  m_Father: {fileID: 0}
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+  m_AnchorMin: {x: 0.5, y: 0.5}
+  m_AnchorMax: {x: 0.5, y: 0.5}
+  m_AnchoredPosition: {x: -959.9999, y: -539.99994}
+  m_SizeDelta: {x: 1056, y: 1056}
+  m_Pivot: {x: 0.5, y: 0.5}
+--- !u!114 &4604732697548752065
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 4244962871353435670}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: 7c88b2c285f9354de97ead891d715ca4, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  fillColor: {r: 1, g: 0.92156863, b: 0.015686275, a: 1}
+--- !u!1 &5962618897390143818
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 4090822809295367550}
+  - component: {fileID: 7663431619546614956}
+  - component: {fileID: 535554146585448550}
+  m_Layer: 5
+  m_Name: LaunchFill
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!224 &4090822809295367550
+RectTransform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 5962618897390143818}
+  m_LocalRotation: {x: -0, y: -0, z: -1, w: 0.00000058114523}
+  m_LocalPosition: {x: 0, y: 0, z: 5}
+  m_LocalScale: {x: 1, y: 1, z: 1}
+  m_ConstrainProportionsScale: 0
+  m_Children: []
+  m_Father: {fileID: 1297730713443137943}
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: -180}
+  m_AnchorMin: {x: 0.5, y: 0.5}
+  m_AnchorMax: {x: 0.5, y: 0.5}
+  m_AnchoredPosition: {x: 960, y: 730}
+  m_SizeDelta: {x: 210, y: 210}
+  m_Pivot: {x: 0.5, y: 0.5}
+--- !u!222 &7663431619546614956
+CanvasRenderer:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 5962618897390143818}
+  m_CullTransparentMesh: 1
+--- !u!114 &535554146585448550
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 5962618897390143818}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: fe87c0e1cc204ed48ad3b37840f39efc, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_Material: {fileID: 0}
+  m_Color: {r: 0.8962264, g: 0.8383515, b: 0.10568706, a: 1}
+  m_RaycastTarget: 1
+  m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
+  m_Maskable: 1
+  m_OnCullStateChanged:
+    m_PersistentCalls:
+      m_Calls: []
+  m_Sprite: {fileID: -8180895760326893913, guid: 662bfaf6d26b3b448b5d093d156bac16, type: 3}
+  m_Type: 3
+  m_PreserveAspect: 1
+  m_FillCenter: 1
+  m_FillMethod: 4
+  m_FillAmount: 0.693
+  m_FillClockwise: 1
+  m_FillOrigin: 0
+  m_UseSpriteMesh: 0
+  m_PixelsPerUnitMultiplier: 1