IS CPP
Introduction
The Camera Position Packet is used to fully control the in-game camera, including standard and free view modes. It can also be requested by sending a TINY_SCP request.
| Type | Name | Description |
|---|---|---|
| byte | Size | 32 |
| byte | Type | ISP_CPP |
| byte | ReqI | instruction: 0 / or reply: ReqI as received in the TINY_SCP |
| byte | Zero | |
| Vec | Pos | Position vector |
| word | H | heading - 0 points along Y axis |
| word | P | pitch |
| word | R | roll |
| byte | ViewPLID | Unique ID of viewed player (0 = none) |
| byte | InGameCam | InGameCam (as reported in StatePack) |
| float | FOV | 4-byte float: FOV in degrees |
| word | Time | Time in ms to get there (0 means instant) |
| word | Flags | ISS state flags (see below) |
Packet Details
Size
The size of the packet is always 32 bytes.
Type
The packet type from the ISP_ enumeration, always ISP_CPP.
ReqI
ReqI is equal to zero, unless the packet is a reply to a TINY_SCP request.
Pos
Position vector, 3 signed integers representing the X, Y, and Z coordinates, where 65536 represents 1 metre.
H
The camera heading, a value of 0 points along the Y axis. 32768 represents 180 degrees.
P
The camera pitch, a value of 0 points "forward" horizontally. 32768 represents 180 degrees.
R
The camera roll, a value of 0 means no roll. 32768 represents 180 degrees.
ViewPLID
The unique ID of the player being viewed. A value of 0 means no player is viewed (free view only).
InGameCam
The standard camera view, as reported in IS_STA.
FOV
The field of view of the camera, in degrees.
Time
Time in ms to get to the destination. This allows smooth camera movement. A value of 0 will instantly set the camera.
Flags
A number of ISS_ state flags can be set in this packet:
- ISS_SHIFTU: free view mode
- ISS_SHIFTU_FOLLOW: follow the car designated by ViewPLID
- ISS_VIEW_OVERRIDE: override the user's view
Notes
To convert the heading, pitch, and roll values to angles in degrees:
- heading (from positive Y axis) = H / 32768 * 180 - 180
- pitch = -P / 32768 * 180
- roll = R / 32768 * 180
To convert angles in degrees to heading, pitch, and roll values:
- H = (180 + heading) * 32768 / 180
- P = -pitch * 32768 / 180
- R = roll * 32768 / 180
Note that the /cp command uses a different format (heading 0 points to negative Y, roll is a floating point value, positive pitch looks down...).
