0136 - Revision history

Seemann at 16:20, 27 May 2019

2019-05-27T16:20:43Z

Spaceeinstein at 00:12, 9 February 2017

2017-02-09T00:12:55Z

Spaceeinstein at 01:22, 18 January 2017

2017-01-18T01:22:40Z

Spaceeinstein at 00:57, 16 January 2017

2017-01-16T00:57:19Z

Spaceeinstein at 15:30, 15 January 2017

2017-01-15T15:30:29Z

Spaceeinstein at 15:10, 15 January 2017

2017-01-15T15:10:55Z

Spaceeinstein: example

2017-01-14T12:17:36Z

example

Spaceeinstein at 14:14, 8 December 2016

2016-12-08T14:14:07Z

Spaceeinstein: highlight

2016-12-07T04:54:44Z

highlight

Spaceeinstein: Created page with "{{OpCode | games = {{Icon|3}} | command = SHAKE_CAM_WITH_POINT | description = Shakes the in-game camera | syntax1 = 0136: shake_camera [''int''] with_point [''f..."

2016-01-03T03:56:59Z

Created page with "{{OpCode | games = {{Icon|3}} | command = SHAKE_CAM_WITH_POINT | description = Shakes the in-game camera | syntax1 = 0136: shake_camera [''int''] with_point [''f..."

New page

{{OpCode
| games = {{Icon|3}}
| command = SHAKE_CAM_WITH_POINT
| description = Shakes the in-game camera
| syntax1 = 0136: shake_camera [''int''] with_point [''flt1''] [''flt2''] [''flt3'']
| p1t = [''int'']
| p1d = Intensity and duration of the shaking
| p2t = [''flt1'']
| p2d = X-coordinate
| p3t = [''flt2'']
| p3d = Y-coordinate
| p4t = [''flt3'']
| p4d = Z-coordinate
}}

This opcode shakes the in-game camera for a while. The higher the integer value is, the more and the longer the camera shakes. The shaking of the camera depends if the camera's location, not the player's location, is within 100 units of the specified coordinates point. The duration and intensity is independent of that point. Leaving or entering the area after the opcode is called does not change the behavior of the shaking. This opcode was never called in the [[Main.scm|original script]] of GTA III.

== For Vice City ==
This opcode does not exist in Vice City but it is possible to recreate this opcode since camera shaking based on location is already featured in the game (like when cars explode). Vice City improved upon this feature in that the initial duration and intensity of the shaking is dependent on the camera's distance from the point. The following example, using Sanny Builder with [[CLEO]] for Vice City in an external script (not the main one) and tested on US v1.0, should work similarly to this opcode. Place this at the end of the file:
<syntaxhighlight lang="scm">
:opcode_0136
// 0@ - input param (intensity/duration)
// 1@ - input param (x-coordinate)
// 2@ - input param (y-coordinate)
// 3@ - input param (z-coordinate)
0093: 0@ = integer_to_float 0@
0@ *= 0.001
05E3: call_method 0x46FF21 0x7E4688 num_params 4 pop 0 z 3@ y 2@ x 1@ time 0@
05F6: ret 0
</syntaxhighlight>

Use this line as a substitute for opcode 0136. This can be placed anywhere within the external script:
<syntaxhighlight lang="scm">
05F5: call_scm_func @opcode_0136 inputs 4 time [int] x [flt1] y [flt2] z [flt3]
</syntaxhighlight>

== Keywords ==
shake, jostle, cam, camera, point

== See also ==
* {{Icon|t}} [[0003]], shake camera without point

[[Category:Code Snippets]]

@@ Line 15: / Line 15: @@
 }}
-This opcode shakes the in-game camera for a while. The higher the integer value is, the more and the longer the camera shakes. The shaking of the camera depends if the camera's location, not the player's location, is within 100 units of the specified coordinates point. The duration and intensity is independent of that point. Leaving or entering the area after the opcode is called does not change the behavior of the shaking. This opcode was never called in the [[Main.scm|original script]] of GTA III.
+This opcode shakes the in-game camera for a while. The higher the integer value is, the more intense and the longer the camera shakes. The shaking of the camera depends if the camera's location, not the player's location, is within 100 [[unit]]s of the specified coordinates point. The duration and intensity is independent of that point. Leaving or entering the area after the opcode is called does not change the behavior of the shaking. This opcode was never called in the [[Main.scm|original script]] of GTA III.
 == Example ==

@@ Line 96: / Line 96: @@
 [[0093]]: <span class="nv">0@</span> = integer_to_float <span class="nv">0@</span>
 <span class="nv">0@</span> *= <span class="m">0.001</span>
-E3: call_method <span class="m">0x46FF21</span> <span class="m">0x7E4688</span> num_params <span class="m">4</span> pop <span class="m">0</span> z <span class="nv">3@</span> y <span class="nv">2@</span> x <span class="nv">1@</span> intensity <span class="nv">0@</span>  <span class="c1">// CCamera::CamShake</span>
+[[0AA6|05E3]]: call_method <span class="m">0x46FF21</span> <span class="m">0x7E4688</span> num_params <span class="m">4</span> pop <span class="m">0</span> z <span class="nv">3@</span> y <span class="nv">2@</span> x <span class="nv">1@</span> intensity <span class="nv">0@</span>  <span class="c1">// CCamera::CamShake</span>
 [[0AB2|05F6]]: ret <span class="m">0</span>
 }}

@@ Line 108: / Line 108: @@
      push    4                                 ; push 4 for four parameters to collect
      push    eax                               ; push address of script's current instruction pointer
-     call    CRunningScript::CollectParameters ; call CRunningScript::CollectParameters
+     call    CRunningScript::CollectParameters ; call CRunningScript::CollectParameters(uint *,short)
      fild    ds:ScriptParams[0]                ; get value of first parameter, the intensity, and push onto floating-point stack
      push    ds:ScriptParams[3]                ; push value of fourth parameter, the z-coordinate
@@ Line 117: / Line 117: @@
      mov     ecx, offset TheCamera             ; get address of TheCamera for thiscall
      fstp    [esp]                             ; store the intensity and pop floating-point stack
-     call    CCamera::CamShake                 ; call CCamera::CamShake
+     call    CCamera::CamShake                 ; call CCamera::CamShake(float,float,float,float)
      xor     al, al                            ; return 0
 </syntaxhighlight>

@@ Line 49: / Line 49: @@
      <span class="k">end</span>
 <span class="k">end</span>
-[[01C3]]: remove_references_to_car CAR_HANDLE
+[[01C3]]: mark_car_as_no_longer_needed CAR_HANDLE
 }}
@@ Line 86: / Line 86: @@
      <span class="k">end</span>
 <span class="k">end</span>
-[[01C3]]: remove_references_to_car CAR_HANDLE
+[[01C3]]: mark_car_as_no_longer_needed CAR_HANDLE
 DC: end_custom_thread
@@ Line 96: / Line 96: @@
 [[0093]]: <span class="nv">0@</span> = integer_to_float <span class="nv">0@</span>
 <span class="nv">0@</span> *= <span class="m">0.001</span>
-E3: call_method <span class="m">0x46FF21</span> <span class="m">0x7E4688</span> num_params <span class="m">4</span> pop <span class="m">0</span> z <span class="nv">3@</span> y <span class="nv">2@</span> x <span class="nv">1@</span> time <span class="nv">0@</span>  <span class="c1">// CCamera::CamShake</span>
+E3: call_method <span class="m">0x46FF21</span> <span class="m">0x7E4688</span> num_params <span class="m">4</span> pop <span class="m">0</span> z <span class="nv">3@</span> y <span class="nv">2@</span> x <span class="nv">1@</span> intensity <span class="nv">0@</span>  <span class="c1">// CCamera::CamShake</span>
 [[0AB2|05F6]]: ret <span class="m">0</span>
 }}
 == Keywords ==

@@ Line 27: / Line 27: @@
 Y_POS = <span class="nv">2@</span>
 Z_POS = <span class="nv">3@</span>
 <span class="k">end</span>
@@ Line 36: / Line 35: @@
 X_POS += <span class="m">4.0</span>
 [[00A5]]: CAR_HANDLE = create_car CAR_MODEL at X_POS Y_POS Z_POS
-HAS_EXPLODED = <span class="k">false</span>
+<span class="k">while</span> [[0119|8119]]:   <span class="k">not</span> car CAR_HANDLE wrecked
      <span class="k">wait</span> <span class="m">10</span>
      <span class="k">if</span>
-         HAS_EXPLODED == <span class="k">false</span>
+:   <span class="k">not</span> car CAR_HANDLE health >= <span class="m">900</span>
      <span class="k">then</span>
-         <span class="k">if</span>
+         <span class="c1">// generate larger car explosion</span>
-            [[0119|8119]]:   <span class="k">not</span> car CAR_HANDLE wrecked
+        [[00AA]]: store_car CAR_HANDLE position_to X_POS Y_POS Z_POS
-        <span class="k">then</span>
+        [[020C]]: create_explosion <span class="m">5</span> at X_POS Y_POS Z_POS  <span class="c1">// EXPLOSION_HELI</span>
-            <span class="k">if</span>
+: <span class="k">shake_camera</span> <span class="m">1600</span> with_point X_POS Y_POS Z_POS
-:   <span class="k">not</span> car CAR_HANDLE health >= <span class="m">900</span>
+B: explode_car CAR_HANDLE
      <span class="k">end</span>
 <span class="k">end</span>
 }}
@@ Line 73: / Line 64: @@
 Y_POS = <span class="nv">2@</span>
 Z_POS = <span class="nv">3@</span>
 <span class="k">end</span>
@@ Line 82: / Line 72: @@
 X_POS += <span class="m">4.0</span>
 [[00A5]]: CAR_HANDLE = create_car CAR_MODEL at X_POS Y_POS Z_POS
-HAS_EXPLODED = <span class="k">false</span>
+<span class="k">while</span> [[0119|8119]]:   <span class="k">not</span> car CAR_HANDLE wrecked
      <span class="k">wait</span> <span class="m">10</span>
      <span class="k">if</span>
-         HAS_EXPLODED == <span class="k">false</span>
+:   <span class="k">not</span> car CAR_HANDLE health >= <span class="m">900</span>
      <span class="k">then</span>
-         <span class="k">if</span>
+         <span class="c1">// generate larger car explosion</span>
-            [[0119|8119]]:   <span class="k">not</span> car CAR_HANDLE wrecked
+        [[00AA]]: store_car CAR_HANDLE position_to X_POS Y_POS Z_POS
-        <span class="k">then</span>
+        [[020C]]: create_explosion <span class="m">6</span> at X_POS Y_POS Z_POS  <span class="c1">// EXPLOSION_HELI</span>
-            <span class="k">if</span>
+F5: call_scm_func <span class="nl">@opcode_0136</span> inputs <span class="m">4</span> -- <span class="k">shake_camera</span> <span class="m">1600</span> with_point X_POS Y_POS Z_POS  <span class="c1">// 0136 substitute</span>
-:   <span class="k">not</span> car CAR_HANDLE health >= <span class="m">900</span>
+B: explode_car CAR_HANDLE
      <span class="k">end</span>
 <span class="k">end</span>
 <span class="nl">:opcode_0136</span>

@@ Line 1: / Line 1: @@
 {{OpCode
 | games       = {{Icon|3}}
@@ Line 15: / Line 16: @@
 This opcode shakes the in-game camera for a while. The higher the integer value is, the more and the longer the camera shakes. The shaking of the camera depends if the camera's location, not the player's location, is within 100 units of the specified coordinates point. The duration and intensity is independent of that point. Leaving or entering the area after the opcode is called does not change the behavior of the shaking. This opcode was never called in the [[Main.scm|original script]] of GTA III.
 == For Vice City ==
-This opcode does not exist in Vice City but it is possible to recreate this opcode since camera shaking based on location is already featured in the game (like when cars explode). Vice City improved upon this feature in that the initial duration and intensity of the shaking is dependent on the camera's distance from the point. The following example, using Sanny Builder with [[CLEO]] for Vice City in an external script (not the main one) and tested on US v1.0, should work similarly to this opcode. Place this at the end of the file:
+This opcode does not exist in Vice City but it is possible to recreate this opcode since camera shaking based on location is already featured in the game (like when cars explode). Vice City improved upon this feature in that the initial duration and intensity of the shaking is dependent on the camera's distance from the point. The following example is a stand-alone [[CLEO]] script for Vice City tested on US v1.0 and should work similarly to the example above.
 {{Pre|class=sb-code|1=
 <span class="nl">:opcode_0136</span>
 <span class="c1">// 0@ - input param (intensity/duration)</span>
@@ Line 28: / Line 115: @@
 E3: call_method <span class="m">0x46FF21</span> <span class="m">0x7E4688</span> num_params <span class="m">4</span> pop <span class="m">0</span> z <span class="nv">3@</span> y <span class="nv">2@</span> x <span class="nv">1@</span> time <span class="nv">0@</span>  <span class="c1">// CCamera::CamShake</span>
 F6: ret <span class="m">0</span>
 }}

@@ Line 18: / Line 18: @@
 == For Vice City ==
 This opcode does not exist in Vice City but it is possible to recreate this opcode since camera shaking based on location is already featured in the game (like when cars explode). Vice City improved upon this feature in that the initial duration and intensity of the shaking is dependent on the camera's distance from the point. The following example, using Sanny Builder with [[CLEO]] for Vice City in an external script (not the main one) and tested on US v1.0, should work similarly to this opcode. Place this at the end of the file:
-<syntaxhighlight lang="scm">
+{{Pre|class=sb-code|1=
-:opcode_0136
+<span class="nl">:opcode_0136</span>
-// 0@ - input param (intensity/duration)
+<span class="c1">// 0@ - input param (intensity/duration)</span>
-// 1@ - input param (x-coordinate)
+<span class="c1">// 1@ - input param (x-coordinate)</span>
-// 2@ - input param (y-coordinate)
+<span class="c1">// 2@ - input param (y-coordinate)</span>
-// 3@ - input param (z-coordinate)
+<span class="c1">// 3@ - input param (z-coordinate)</span>
-: 0@ = integer_to_float 0@
+: <span class="nv">0@</span> = integer_to_float <span class="nv">0@</span>
-@ *= 0.001
+<span class="nv">0@</span> *= <span class="m">0.001</span>
-E3: call_method 0x46FF21 0x7E4688 num_params 4 pop 0 z 3@ y 2@ x 1@ time 0@
+E3: call_method <span class="m">0x46FF21</span> <span class="m">0x7E4688</span> num_params <span class="m">4</span> pop <span class="m">0</span> z <span class="nv">3@</span> y <span class="nv">2@</span> x <span class="nv">1@</span> time <span class="nv">0@</span>
-F6: ret 0
+F6: ret <span class="m">0</span>
-</syntaxhighlight>
+}}
 Use this line as a substitute for opcode 0136. This can be placed anywhere within the external script:
-<syntaxhighlight lang="scm">
+{{Pre|class=sb-code|1=
-F5: call_scm_func @opcode_0136 inputs 4 time [int] x [flt1] y [flt2] z [flt3]
+F5: call_scm_func <span class="nl">@opcode_0136</span> inputs <span class="m">4</span> time [int] x [flt1] y [flt2] z [flt3]
-</syntaxhighlight>
+}}
 == Keywords ==
@@ Line 40: / Line 40: @@
 == See also ==
 * {{Icon|t}} [[0003]], shake camera without point