IS CPP - Revision history

Flame CZE at 11:24, 14 February 2026

2026-02-14T11:24:42Z

Bokujishin at 17:21, 10 February 2026

2026-02-10T17:21:15Z

Bokujishin: Created page with "== Introduction == The '''C'''amera '''P'''osition '''P'''acket is used to fully control the in-game camera, including standard and free view modes. It can also be requested..."

2026-02-10T17:14:56Z

Created page with "== Introduction == The '''C'''amera '''P'''osition '''P'''acket is used to fully control the in-game camera, including standard and free view modes. It can also be requested..."

New page

== Introduction ==

The '''C'''amera '''P'''osition '''P'''acket is used to fully control the in-game camera, including standard and free view modes. It can also be requested by sending a [[InSim_enumerations#TINY|TINY_SCP]] request.

{| class="wikitable"
|+ IS_SCC packet properties
|-
! 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 [[InSim_enumerations#ISP|ISP_]] enumeration, always ISP_CPP.

=== ReqI ===

ReqI is equal to zero, unless the packet is a reply to a [[InSim_enumerations#TINY|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|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 <code>/cp</code> command uses a different format (heading 0 points to negative Y, roll is a floating point value, positive pitch looks down...).

[[Category:InSim packets]]

@@ Line 1: / Line 1: @@
-== Introduction ==
+{{Infobox InSim packet
 The '''C'''amera '''P'''osition '''P'''acket is used to fully control the in-game camera, including standard and free view modes. It can also be requested by sending a [[InSim_enumerations#TINY|TINY_SCP]] request.
 {| class="wikitable"
@@ Line 34: / Line 44: @@
 | word || Flags || ISS state flags (see below)
 |}
 === Size ===
@@ Line 91: / Line 99: @@
 To convert the heading, pitch, and roll values to angles in degrees:
-* heading (from positive Y axis) = H / 32768 * 180 - 180
+* {{var|heading}} (from positive Y axis) = {{var|H}} / 32768 * 180 - 180
-* pitch = -P / 32768 * 180
+* {{var|pitch}} = {{var|-P}} / 32768 * 180
-* roll = R / 32768 * 180
+* {{var|roll}} = {{var|R}} / 32768 * 180
 To convert angles in degrees to heading, pitch, and roll values:
-* H = (180 + heading) * 32768 / 180
+* {{var|H}} = (180 + {{var|heading}}) * 32768 / 180
-* P = -pitch * 32768 / 180
+* {{var|P}} = {{var|-pitch}} * 32768 / 180
-* R = roll * 32768 / 180
+* {{var|R}} = {{var|roll}} * 32768 / 180
-Note that the <code>/cp</code> command uses a different format (heading 0 points to negative Y, roll is a floating point value, positive pitch looks down...).
+{{InSim packets}}
 [[Category:InSim packets]]

@@ Line 4: / Line 4: @@
 {| class="wikitable"
-|+ IS_SCC packet properties
+|+ IS_CPP packet properties
 |-
 ! Type !! Name !! Description