Spaceeinstein: Created page with "{{This|For CLEO for GTA III and Vice City prior to v2.0.0.0, use opcode 05E3.}} {{OpCode | games = {{Icon|t}} (with CLEO) | description = Calls a method | syntax1..."

2017-02-09T00:12:12Z

Created page with "{{This|For CLEO for GTA III and Vice City prior to v2.0.0.0, use opcode 05E3.}} {{OpCode | games = {{Icon|t}} (with CLEO) | description = Calls a method | syntax1..."

New page

{{This|For CLEO for GTA III and Vice City prior to v2.0.0.0, use opcode 05E3.}}
{{OpCode
| games = {{Icon|t}} (with [[CLEO]])
| description = Calls a method
| syntax1 = 0AA6: call_method [''int1''] struct [''int2''] num_params [''int3''] pop [''int4''] ( [''any''] ... )
| p1t = [''int1'']
| p1d = [[:Category:Memory Addresses|Memory address]]
| p2t = [''int2'']
| p2d = Structure
| p3t = [''int3'']
| p3d = Number of parameters
| p4t = [''int4'']
| p4d = Size to pop
| p5t = [''any'']
| p5d = Any values to push (optional)
}}

This [[CLEO]] opcode calls a method (also known as a non-static member function in C++) located at the memory address. These functions use the [[wikipedia:X86 calling conventions#thiscall|thiscall calling convention]]. When they are called, a "this" pointer referencing the object's structure is passed to the function. The number of parameters determines the number of arguments to pass onto the call stack. The size to pop depends if the caller or callee cleans the call stack. If the callee cleans the stack (which generally happens for the thiscall calling convention), the size to pop should be ''0''. The order to pass the arguments is reversed from the function's parameter order.

For example, a method call in C++ in Vice City can look like this:
<syntaxhighlight lang="cpp">
TheCamera.CCamera::CamShake(1.0, 10.0, 20.0, 30.0);
</syntaxhighlight>
<code>TheCamera</code> is the structure for the game's camera object located at 0x7E4688. <code>[[Function Memory Addresses (VC)#CCamera|CCamera::CamShake]]</code> is a member function located at 0x46FF21 with four parameters all accepting floating-point values: intensity, x-coordinate, y-coordinate, and z-coordinate. To call this function using this opcode in Vice City, it should look like this:
{{Pre|class=sb-code|1=
0AA6: call_method 0x46FF21 struct 0x7E4688 num_params 4 pop 0 z 30.0 y 20.0 x 10.0 intensity 1.0
}}

== Example ==
:''See [[0136#For Vice City]], [[0ADC#Example]]''

== Keywords ==
call, method, member, function

[[Category:CLEO Opcodes]]

0AA6 - Revision history

Spaceeinstein: Created page with "{{This|For CLEO for GTA III and Vice City prior to v2.0.0.0, use opcode 05E3.}} {{OpCode | games = {{Icon|t}} (with CLEO) | description = Calls a method | syntax1..."