Added drive mode animations & API functionality

Author: sbasu107

README.md

@@ -2,6 +2,23 @@
 
 A small demo that shows a 3D car viewer using three.js and a GLTF model (Ferrari F40).
 
+## Screenshots
+
+### Home (Showroom) Mode
+<img src="images/park-mode.png" alt="Showroom Mode" width="50%">
+
+*The car is displayed in a dark showroom with dramatic spotlights, parking brake engaged*
+
+### Drive Mode - Day
+<img src="images/drive-mode-day.png" alt="Drive Mode - Day" width="50%">
+
+*Driving simulation with bright blue sky, animated road, and lane markings*
+
+### Drive Mode - Night
+<img src="images/drive-mode-night.png" alt="Drive Mode - Night" width="50%">
+
+*Night driving with dark sky and ambient lighting*
+
 View online
 
 - The demo is automatically deployed to GitHub Pages:
@@ -34,18 +51,15 @@ Camera Info panel (press 'I')
   - Target: orbit target (x,y,z)
   - Distance: distance from camera to target
   - Azimuth & Polar angles in degrees
+  - **Speed Simulation**: Interactive slider (0-75 mph) to control animation speed in Drive mode
 - Buttons:
   - Copy — copies camera state JSON to clipboard (position, target, distance, azimuthDeg, polarDeg)
-  - Set Home — saves your current view as preset named "Home"
-  - Go Home — moves the camera to the saved Home preset
-- Preset manager inside the panel:
-  - Select a preset, then Go / Set (save current) / Delete
-  - Import — paste a JSON payload like:
-    {
-      "position": [x, y, z],
-      "target": [x, y, z]
-    }
-  - Presets are stored in localStorage under the key: `cameraPresets` (the old `cameraHome` is migrated automatically if present).
+  - Day Mode / Night Mode — toggles between day (bright blue sky) and night (dark sky) lighting
+  - Sim Brake Enable/Release — toggles between Home and Drive camera views
+- Default presets:
+  - Home: `[-4.358857444267401, 1.5797084394163963, 3.222751650234066]`
+  - Drive: `[0.12909591647276278, 2.215759854813773, -5.849405778042717]`
+- Presets are stored in localStorage under the key: `cameraPresets` (the old `cameraHome` is migrated automatically if present).
 
 Park brake simulation & signals
 
@@ -54,6 +68,19 @@ Park brake simulation & signals
 - Edge behavior:
   - 1 -> 0 (released) triggers transition to the Drive preset (if present).
   - 0 -> 1 (engaged) triggers transition to the Home preset (if present).
+- **Speed Control**: 
+  - In Drive mode, the animation speed is controlled by the current speed setting (0-75 mph).
+  - Speed can be set via the slider in the Camera Info panel, or programmatically via the API.
+  - Speeds above 75 mph are automatically clamped to 75 mph for animation purposes.
+  - At 0 mph, the road/environment animation stops (but wheels still rotate slowly).
+  - At 50 mph, the animation runs at base speed.
+  - At 75 mph, the animation runs at 1.5x base speed.
+  - Wheel rotation speed scales proportionally with the set speed.
+- Visual modes:
+  - **Home (Showroom Mode)**: Dark background with spotlights, static environment, car displayed in showroom setting.
+  - **Drive Mode**: Animated road moving toward the car, lane markings and trees moving to create illusion of travel. Animation speed controlled by speed setting.
+    - **Day Mode**: Bright blue sky (#87ceeb), bright ambient lighting (0.6 intensity)
+    - **Night Mode**: Dark night sky (#0a0a2e), dim ambient lighting (0.3 intensity)
 
 Integration API (for parent application)
 
@@ -64,16 +91,27 @@ Integration API (for parent application)
   - goToPreset(name, duration?) — Smoothly move to the preset (duration in ms).
   - animateTo(targetPosition, targetTarget, duration) — Animate to given THREE.Vector3 positions.
   - receiveVehicleSignal(signalName, value) — Forwards signals into the viewer.
+  - setDayMode(isDay) — Set day/night mode. Pass `true` for day, `false` for night.
+  - getDayMode() — Returns current day/night mode state (true = day, false = night).
+  - toggleDayNight() — Toggles between day and night mode, returns new state.
+  - **setSpeed(mph)** — Set the current speed in mph (0-75, clamped at 75). Controls animation speed in Drive mode.
+  - **getSpeed()** — Returns the current speed setting in mph.
+  - **getAnimationSpeed()** — Returns the current animation speed multiplier (calculated from speed).
 
 - Convenience globals:
   - window.receiveVehicleSignal(signalName, value)
     - e.g. window.receiveVehicleSignal('park_brake', 0) — triggers the park_brake handling.
+    - e.g. window.receiveVehicleSignal('speed', 65) — sets speed to 65 mph.
+    - Signal names containing 'speed' or 'velocity' are treated as speed signals (in mph).
   - window.setParkingBrakeState(value)
     - e.g. window.setParkingBrakeState(1)
+  - **window.setCarSpeed(mph)**
+    - e.g. window.setCarSpeed(55) — sets speed to 55 mph (clamped at 75).
 
 Implementation notes
 
 - Built with three.js r128 and uses `OrbitControls` + `GLTFLoader` for the model.
+- **On page load/refresh, the camera ALWAYS starts in Home (showroom) mode** with the default preset position, ensuring a consistent starting view.
 - Presets are stored in localStorage as `{ <name>: { position: [...], target: [...] } }`.
 - The viewer auto-imports an example "Drive" preset (from demo data) on first run if no preset exists.
 - Camera is constrained so it cannot go underneath the ground plane and polar angle is limited to prevent under-floor views.