99 lines
2.8 KiB
Plaintext
99 lines
2.8 KiB
Plaintext
[[Category Packet]]
|
|
[[Category Packet 317]]
|
|
{{packet|name=Camera oscillate|description=Begin camera oscillation|opcode=35|type=Fixed|length=4|revision=317}}
|
|
== Camera oscillate ==
|
|
|
|
=== Description ===
|
|
Begins camera oscillation, which is implemented using a configurable sinusoidal oscillator to offset a specific degree of freedom.
|
|
|
|
=== Packet Structure ===
|
|
|
|
{| border=2
|
|
! Data type
|
|
! Description
|
|
|-
|
|
| [[Data Types#Standard data types|Byte]]
|
|
| Parameter (camera X, Z, Y, yaw, pitch)
|
|
|-
|
|
| [[Data Types#Standard data types|Byte]]
|
|
| Jitter - for randomization
|
|
|-
|
|
| [[Data Types#Standard data types|Byte]]
|
|
| Amplitude
|
|
|-
|
|
| [[Data Types#Standard data types|Byte]]
|
|
| Frequency (scaled by 100)
|
|
|-
|
|
|}
|
|
|
|
=== Other Information ===
|
|
The oscillate event enables the client to oscillate one of 5 of it's position parameters, i.e. corresponding to the camera's degrees of freedom; parameters 0, 1, and 2 refer to the location of the camera, while 3 and 4 deal with the camera's orientation. Together, these enable complex effects involving manipulation of the camera position to give rise to simulated earth-quakes and camera shock.
|
|
{| border=2
|
|
! Parameter
|
|
! Description
|
|
|-
|
|
| 0
|
|
| Camera location along world X axis (a horizontal axis, aligned with map grid X)
|
|
|-
|
|
| 1
|
|
| Camera location along world Z axis (vertical axis)
|
|
|-
|
|
| 2
|
|
| Camera location along world Y axis (a horizontal axis, aligned with map grid Y)
|
|
|-
|
|
| 3
|
|
| Camera orientation in world X plane w.r.t. world Z axis, i.e. yaw
|
|
|-
|
|
| 4
|
|
| Camera orientation in world Z plane w.r.t. world X axis, i.e. pitch
|
|
|-
|
|
|}
|
|
Note there is no built-in way to manipulate camera roll, as this is not one of the camera's degrees of freedom.
|
|
|
|
=== What it's doing ===
|
|
Every time the world is rendered, each camera parameter that is enabled for oscillation is offset by a value computed as follows:
|
|
{| border=2
|
|
! Calculation
|
|
! Formula
|
|
|-
|
|
| Delta
|
|
| (int) ((Math.random() * (double) (jitter * 2 + 1) - (double) jitter) + Math.sin((double) phase * ((double) frequency / 100D)) * (double) amplitude);
|
|
|-
|
|
|}
|
|
Each parameter's phase accumulator (phase) is incremented by 1 each logic update.
|
|
|
|
=== Parameter ===
|
|
The offset itself is detailed as follows for each parameter:
|
|
{| border=2
|
|
! Parameter
|
|
! Action
|
|
|-
|
|
| 0
|
|
| camera_x += delta
|
|
|-
|
|
| 1
|
|
| camera_z += delta
|
|
|-
|
|
| 2
|
|
| camera_y += delta
|
|
|-
|
|
| 3
|
|
| camera_yaw = camera_yaw + delta & 0x7ff;
|
|
|-
|
|
| 4
|
|
| camera_pitch += delta
|
|
|-
|
|
|}
|
|
Note that the camera's yaw is corrected modulo 0x7ff, or 2048, which is equivalent to 2{{{pi}}} radians in Jagex's binary angle system.
|
|
This is not done to the camera pitch, which is instead clamped (see below).
|
|
|
|
=== Note ===
|
|
For oscillating the camera pitch, clamping is done to ensure the angle not out of bounds:
|
|
{| border=2
|
|
|-
|
|
|if (camera_pitch < 128) then camera_pitch = 128
|
|
|-
|
|
|if (camera_pitch > 383) then camera_pitch = 383
|
|
|-
|
|
|}
|
|
This is do to Jagex restricting the possible range of orientations the camera may take. |