From 9a371b64e7dbbfebedefcfecb4bb7f2cf670f169 Mon Sep 17 00:00:00 2001 From: Freddy <33939455+freedy69@users.noreply.github.com> Date: Sat, 12 Aug 2023 21:08:16 +0400 Subject: [PATCH 1/5] Document N_0x45f35c0edc33b03b Added this native's purpose and an example on how to use it --- NETWORK/N_0x45f35c0edc33b03b.md | 29 ------------ .../NetworkAddMapObjectToSynchronisedScene.md | 45 +++++++++++++++++++ 2 files changed, 45 insertions(+), 29 deletions(-) delete mode 100644 NETWORK/N_0x45f35c0edc33b03b.md create mode 100644 NETWORK/NetworkAddMapObjectToSynchronisedScene.md diff --git a/NETWORK/N_0x45f35c0edc33b03b.md b/NETWORK/N_0x45f35c0edc33b03b.md deleted file mode 100644 index fbce11b88..000000000 --- a/NETWORK/N_0x45f35c0edc33b03b.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -ns: NETWORK ---- -## _0x45F35C0EDC33B03B - -```c -// 0x45F35C0EDC33B03B -void _0x45F35C0EDC33B03B(int netScene, Hash modelHash, float x, float y, float z, float p5, char* p6, float p7, float p8, int flags); -``` - -NETWORK_A* -Similar structure as NETWORK_ADD_ENTITY_TO_SYNCHRONISED_SCENE but it includes this time a hash. -In casino_slots it is used one time in a synced scene involving a ped and the slot machine? - -``` -NativeDB Introduced: v1734 -``` - -## Parameters -* **netScene**: -* **modelHash**: -* **x**: -* **y**: -* **z**: -* **p5**: -* **p6**: -* **p7**: -* **p8**: -* **flags**: diff --git a/NETWORK/NetworkAddMapObjectToSynchronisedScene.md b/NETWORK/NetworkAddMapObjectToSynchronisedScene.md new file mode 100644 index 000000000..d44dbf21d --- /dev/null +++ b/NETWORK/NetworkAddMapObjectToSynchronisedScene.md @@ -0,0 +1,45 @@ +--- +ns: NETWORK +aliases: ["0x45F35C0EDC33B03B"] +--- +## _NETWORK_ADD_MAP_OBJECT_TO_SYNCHRONISED_SCENE + +```c +// 0x45F35C0EDC33B03B +void _NETWORK_ADD_MAP_OBJECT_TO_SYNCHRONISED_SCENE(int netScene, Hash modelHash, float x, float y, float z, float p5, char* p6, float p7, float p8, int flags); +``` + +Adds a map object/entity to a synchronised scene, by specifying it's hash. + +## Parameters +* **netScene**: +* **modelHash**: +* **x**: +* **y**: +* **z**: +* **p5**: +* **p6**: +* **p7**: +* **p8**: +* **flags**: + +## Examples +```lua +local slotMachineCoords = vector3(1106.67, 230.59, -50.09) -- Where to look for the slot machine +local slotMachineObjectHash = `vw_prop_casino_slot_02a` -- Which slot machine to look for +local slotMachineObjectID = GetClosestObjectOfType(slotMachineCoords, 1.0, slotMachineObjectHash, false, false, false) -- ID of the found slot machine +local slotMachineObjectCoords = GetEntityCoords(slotMachineObjectID, false) -- Coords of the slot machine, this is where we'll create a synchronized scene +local animDict = 'anim_casino_a@amb@casino@games@slots@male' -- Animation dictionary to use + +-- Create the synchronised scene +local netSceneID = NetworkCreateSynchronisedScene(slotMachineObjectCoords, 0.0, 0.0, GetEntityHeading(slotMachineObjectID), 2, true, false, 1.0, 0.0, 1.0) +-- Play the pull_spin_a_slotmachine animation on the slot machine object +NetworkAddMapObjectToSynchronisedScene(netSceneID, slotMachineObjectHash, slotMachineObjectCoords, animDict, 'pull_spin_a_slotmachine', 2.0, -1.5, 13) +NetworkStartSynchronisedScene(netSceneID) -- Start the synchronised scene + +print('Lever pull animation started!') + +while GetSynchronizedScenePhase(NetworkGetLocalSceneFromNetworkId(netSceneID)) < 1.0 do Wait(0) end -- Wait for the lever pull animation to finish + +print('Lever pull animation finished!') +``` From 3d9019ba8da8a59159b386bf1e736f4fb1dc16b6 Mon Sep 17 00:00:00 2001 From: Freddy <33939455+freedy69@users.noreply.github.com> Date: Tue, 15 Aug 2023 23:31:20 +0400 Subject: [PATCH 2/5] Document parameters --- .../NetworkAddMapObjectToSynchronisedScene.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/NETWORK/NetworkAddMapObjectToSynchronisedScene.md b/NETWORK/NetworkAddMapObjectToSynchronisedScene.md index d44dbf21d..02c942507 100644 --- a/NETWORK/NetworkAddMapObjectToSynchronisedScene.md +++ b/NETWORK/NetworkAddMapObjectToSynchronisedScene.md @@ -6,22 +6,22 @@ aliases: ["0x45F35C0EDC33B03B"] ```c // 0x45F35C0EDC33B03B -void _NETWORK_ADD_MAP_OBJECT_TO_SYNCHRONISED_SCENE(int netScene, Hash modelHash, float x, float y, float z, float p5, char* p6, float p7, float p8, int flags); +void _NETWORK_ADD_MAP_OBJECT_TO_SYNCHRONISED_SCENE(int netScene, Hash modelHash, float x, float y, float z, cs_type(float) char* animDict, char* animName, float p7, float p8, int flags); ``` Adds a map object/entity to a synchronised scene, by specifying it's hash. ## Parameters -* **netScene**: -* **modelHash**: -* **x**: -* **y**: -* **z**: -* **p5**: -* **p6**: +* **netScene**: net scene id, returned by NetworkCreateSynchronisedScene +* **modelHash**: Object model hash +* **x**: x coord +* **y**: y coord +* **z**: z coord +* **animDict**: anim dictionary to play on this object +* **animName**: anim name to play on this object * **p7**: * **p8**: -* **flags**: +* **flags**: Animation flags (See TaskPlayAnim) ## Examples ```lua From aed2b4d00662fcb02ccff1e331e6f59bd7e6e37c Mon Sep 17 00:00:00 2001 From: Freddy <33939455+freedy69@users.noreply.github.com> Date: Wed, 30 Aug 2023 19:47:37 +0400 Subject: [PATCH 3/5] Update params and spelling Added changes suggested by Z3rio --- .../NetworkAddMapObjectToSynchronisedScene.md | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/NETWORK/NetworkAddMapObjectToSynchronisedScene.md b/NETWORK/NetworkAddMapObjectToSynchronisedScene.md index 02c942507..931a60466 100644 --- a/NETWORK/NetworkAddMapObjectToSynchronisedScene.md +++ b/NETWORK/NetworkAddMapObjectToSynchronisedScene.md @@ -9,18 +9,18 @@ aliases: ["0x45F35C0EDC33B03B"] void _NETWORK_ADD_MAP_OBJECT_TO_SYNCHRONISED_SCENE(int netScene, Hash modelHash, float x, float y, float z, cs_type(float) char* animDict, char* animName, float p7, float p8, int flags); ``` -Adds a map object/entity to a synchronised scene, by specifying it's hash. +Adds a map object/entity to a synchronised scene. ## Parameters -* **netScene**: net scene id, returned by NetworkCreateSynchronisedScene -* **modelHash**: Object model hash -* **x**: x coord -* **y**: y coord -* **z**: z coord -* **animDict**: anim dictionary to play on this object -* **animName**: anim name to play on this object -* **p7**: -* **p8**: +* **netScene**: The net scene's ID, which is returned by NetworkCreateSynchronisedScene +* **modelHash**: The object model's hash +* **x**: x coordinate +* **y**: y coordinate +* **z**: z coordinate +* **animDict**: The animation dictionary to play on this object +* **animName**: The animation name to play on this object +* **p7**: unknown, although gta seems to use 2.0 +* **p8**: unknown, although gta seems to use -1.5 * **flags**: Animation flags (See TaskPlayAnim) ## Examples From b316d2e8f9d14181cb693174eb4d07f31fe82ca9 Mon Sep 17 00:00:00 2001 From: Freddy <33939455+freedy69@users.noreply.github.com> Date: Sat, 14 Oct 2023 22:40:10 +0400 Subject: [PATCH 4/5] Update NetworkAddMapObjectToSynchronisedScene.md Updated p7 and p8 --- NETWORK/NetworkAddMapObjectToSynchronisedScene.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/NETWORK/NetworkAddMapObjectToSynchronisedScene.md b/NETWORK/NetworkAddMapObjectToSynchronisedScene.md index 931a60466..d8c082553 100644 --- a/NETWORK/NetworkAddMapObjectToSynchronisedScene.md +++ b/NETWORK/NetworkAddMapObjectToSynchronisedScene.md @@ -6,7 +6,7 @@ aliases: ["0x45F35C0EDC33B03B"] ```c // 0x45F35C0EDC33B03B -void _NETWORK_ADD_MAP_OBJECT_TO_SYNCHRONISED_SCENE(int netScene, Hash modelHash, float x, float y, float z, cs_type(float) char* animDict, char* animName, float p7, float p8, int flags); +void _NETWORK_ADD_MAP_OBJECT_TO_SYNCHRONISED_SCENE(int netScene, Hash modelHash, float x, float y, float z, cs_type(float) char* animDict, char* animName, float blendInSpeed, float blendOutSpeed, int flags); ``` Adds a map object/entity to a synchronised scene. @@ -19,8 +19,8 @@ Adds a map object/entity to a synchronised scene. * **z**: z coordinate * **animDict**: The animation dictionary to play on this object * **animName**: The animation name to play on this object -* **p7**: unknown, although gta seems to use 2.0 -* **p8**: unknown, although gta seems to use -1.5 +* **blendInSpeed**: How quickly the object blends into the animation (default is 8.0) +* **blendOutSpeed**: How quickly the object blends out of the animation (default is 8.0) * **flags**: Animation flags (See TaskPlayAnim) ## Examples From 2e837754e09b4c173b915887208db6da2f5b94e0 Mon Sep 17 00:00:00 2001 From: Freddy <33939455+freedy69@users.noreply.github.com> Date: Sat, 25 Nov 2023 16:55:48 +0400 Subject: [PATCH 5/5] Use the actual native name --- ...sedScene.md => NetworkAddMapEntityToSynchronisedScene.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) rename NETWORK/NetworkAddMapObjectToSynchronisedScene.md => NetworkAddMapEntityToSynchronisedScene.md (85%) diff --git a/NETWORK/NetworkAddMapObjectToSynchronisedScene.md b/NetworkAddMapEntityToSynchronisedScene.md similarity index 85% rename from NETWORK/NetworkAddMapObjectToSynchronisedScene.md rename to NetworkAddMapEntityToSynchronisedScene.md index d8c082553..b6783cafb 100644 --- a/NETWORK/NetworkAddMapObjectToSynchronisedScene.md +++ b/NetworkAddMapEntityToSynchronisedScene.md @@ -2,11 +2,11 @@ ns: NETWORK aliases: ["0x45F35C0EDC33B03B"] --- -## _NETWORK_ADD_MAP_OBJECT_TO_SYNCHRONISED_SCENE +## NETWORK_ADD_MAP_ENTITY_TO_SYNCHRONISED_SCENE ```c // 0x45F35C0EDC33B03B -void _NETWORK_ADD_MAP_OBJECT_TO_SYNCHRONISED_SCENE(int netScene, Hash modelHash, float x, float y, float z, cs_type(float) char* animDict, char* animName, float blendInSpeed, float blendOutSpeed, int flags); +void NETWORK_ADD_MAP_ENTITY_TO_SYNCHRONISED_SCENE(int netScene, Hash modelHash, float x, float y, float z, cs_type(float) char* animDict, char* animName, float blendInSpeed, float blendOutSpeed, int flags); ``` Adds a map object/entity to a synchronised scene. @@ -34,7 +34,7 @@ local animDict = 'anim_casino_a@amb@casino@games@slots@male' -- Animation dictio -- Create the synchronised scene local netSceneID = NetworkCreateSynchronisedScene(slotMachineObjectCoords, 0.0, 0.0, GetEntityHeading(slotMachineObjectID), 2, true, false, 1.0, 0.0, 1.0) -- Play the pull_spin_a_slotmachine animation on the slot machine object -NetworkAddMapObjectToSynchronisedScene(netSceneID, slotMachineObjectHash, slotMachineObjectCoords, animDict, 'pull_spin_a_slotmachine', 2.0, -1.5, 13) +NetworkAddMapEntityToSynchronisedScene(netSceneID, slotMachineObjectHash, slotMachineObjectCoords, animDict, 'pull_spin_a_slotmachine', 2.0, -1.5, 13) NetworkStartSynchronisedScene(netSceneID) -- Start the synchronised scene print('Lever pull animation started!')