RCWeb 3D Viewer Control App

The RCWeb 3D Viewer Control App (app/3dviewer-control) serves as a precision gyroscopic presenter remote for the 3D Viewer application inside the Asymmetric Pattern.

Icon

Screenshot

What it does

• Absolute Hardware Mirroring: Reads raw 6-axis gyroscopic accelerometer data natively converting precise hand inclination into flawless 1:1 remote rotation commands.
• Takeover Notification: Implements complex multiple-device handshaking. If two phones scan the viewer screen consecutively, the viewer will accept the newest device and transmit a forced eviction payload to the old remote, rendering an "Another controller took over" toast notification.
• Orientation Normalization: Tracks device screen adjustments actively locking native window.screen.orientation and applying an inverted multiplier ensuring the model doesn't wildly snap upside-down when the phone naturally tilts sideways in the user's hand.

How it works

The script heavily offloads mathematical calculations from the primary viewer natively into the client device.

• Euler to Quaternion Math: Rather than forcing the main host server to compute orientation translations, the controller manually unpacks the raw DeviceOrientationEvent variables (alpha, beta, gamma) into deep trigonometric functions natively inside Javascript utilizing heavily optimized quaternionFromEuler and quaternionFromAxisAngle matrix generators.
• Delta Threshold Bandwidth Caps: The loop employs a strict ORIENTATION_EPSILON variable comparing mathematical differentials between the lastOrientationPayload and the current orientation. If the phone is merely resting idly on a desk, literally zero network packets are needlessly transmitted.
• Fallback Polling: If the host is utilizing a VPN router rendering device sensors blocked entirely, the code gracefully strips the complex quaternion math and binds raw hardcoded degree nudges (sendNudge(x, y, z)) to on-screen DOM buttons.

Launch RCWeb App