Objects.inc

a_objects.inc

Description:

Include a_objects.inc allows you to add, delete, modify, move objects on your server.

This inclusion comes in the standard windows serer build

/*  SA-MP Object Functions
 *
 *  (c) Copyright 2005-2015, SA-MP Team
 *
 */

#if defined _objects_included
	#endinput
#endif
#define _objects_included
#pragma library objects

// Objects

native CreateObject(modelid, Float:X, Float:Y, Float:Z, Float:rX, Float:rY, Float:rZ, Float:DrawDistance = 0.0);
native AttachObjectToVehicle(objectid, vehicleid, Float:OffsetX, Float:OffsetY, Float:OffsetZ, Float:RotX, Float:RotY, Float:RotZ);
native AttachObjectToObject(objectid, attachtoid, Float:OffsetX, Float:OffsetY, Float:OffsetZ, Float:RotX, Float:RotY, Float:RotZ, SyncRotation = 1);
native AttachObjectToPlayer(objectid, playerid, Float:OffsetX, Float:OffsetY, Float:OffsetZ, Float:RotX, Float:RotY, Float:RotZ);
native SetObjectPos(objectid, Float:X, Float:Y, Float:Z);
native GetObjectPos(objectid, &Float:X, &Float:Y, &Float:Z);
native SetObjectRot(objectid, Float:RotX, Float:RotY, Float:RotZ);
native GetObjectRot(objectid, &Float:RotX, &Float:RotY, &Float:RotZ);
native GetObjectModel(objectid);
native SetObjectNoCameraCol(objectid);
native IsValidObject(objectid);
native DestroyObject(objectid);
native MoveObject(objectid, Float:X, Float:Y, Float:Z, Float:Speed, Float:RotX = -1000.0, Float:RotY = -1000.0, Float:RotZ = -1000.0);
native StopObject(objectid);
native IsObjectMoving(objectid);
native EditObject(playerid, objectid);
native EditPlayerObject(playerid, objectid);
native SelectObject(playerid);
native CancelEdit(playerid);
native CreatePlayerObject(playerid, modelid, Float:X, Float:Y, Float:Z, Float:rX, Float:rY, Float:rZ, Float:DrawDistance = 0.0);
native AttachPlayerObjectToVehicle(playerid, objectid, vehicleid, Float:fOffsetX, Float:fOffsetY, Float:fOffsetZ, Float:fRotX, Float:fRotY, Float:RotZ);
native SetPlayerObjectPos(playerid, objectid, Float:X, Float:Y, Float:Z);
native GetPlayerObjectPos(playerid, objectid, &Float:X, &Float:Y, &Float:Z);
native SetPlayerObjectRot(playerid, objectid, Float:RotX, Float:RotY, Float:RotZ);
native GetPlayerObjectRot(playerid, objectid, &Float:RotX, &Float:RotY, &Float:RotZ);
native GetPlayerObjectModel(playerid, objectid);
native SetPlayerObjectNoCameraCol(playerid, objectid);
native IsValidPlayerObject(playerid, objectid);
native DestroyPlayerObject(playerid, objectid);
native MovePlayerObject(playerid, objectid, Float:X, Float:Y, Float:Z, Float:Speed, Float:RotX = -1000.0, Float:RotY = -1000.0, Float:RotZ = -1000.0);
native StopPlayerObject(playerid, objectid);
native IsPlayerObjectMoving(playerid, objectid);
native AttachPlayerObjectToPlayer(objectplayer, objectid, attachplayer, Float:OffsetX, Float:OffsetY, Float:OffsetZ, Float:rX, Float:rY, Float:rZ);

#define OBJECT_MATERIAL_SIZE_32x32		10
#define OBJECT_MATERIAL_SIZE_64x32		20
#define OBJECT_MATERIAL_SIZE_64x64		30
#define OBJECT_MATERIAL_SIZE_128x32		40
#define OBJECT_MATERIAL_SIZE_128x64		50
#define OBJECT_MATERIAL_SIZE_128x128	60
#define OBJECT_MATERIAL_SIZE_256x32		70
#define OBJECT_MATERIAL_SIZE_256x64		80
#define OBJECT_MATERIAL_SIZE_256x128	90
#define OBJECT_MATERIAL_SIZE_256x256	100
#define OBJECT_MATERIAL_SIZE_512x64		110
#define OBJECT_MATERIAL_SIZE_512x128	120
#define OBJECT_MATERIAL_SIZE_512x256	130
#define OBJECT_MATERIAL_SIZE_512x512	140

#define OBJECT_MATERIAL_TEXT_ALIGN_LEFT		0
#define OBJECT_MATERIAL_TEXT_ALIGN_CENTER	1
#define OBJECT_MATERIAL_TEXT_ALIGN_RIGHT	2

native SetObjectMaterial(objectid, materialindex, modelid, txdname[], texturename[], materialcolor=0);
native SetPlayerObjectMaterial(playerid, objectid, materialindex, modelid, txdname[], texturename[], materialcolor=0);

native SetObjectMaterialText(objectid, text[], materialindex = 0, materialsize = OBJECT_MATERIAL_SIZE_256x128, fontface[] = "Arial", fontsize = 24, bold = 1, fontcolor = 0xFFFFFFFF, backcolor = 0, textalignment = 0);
native SetPlayerObjectMaterialText(playerid, objectid, text[], materialindex = 0, materialsize = OBJECT_MATERIAL_SIZE_256x128, fontface[] = "Arial", fontsize = 24, bold = 1, fontcolor = 0xFFFFFFFF, backcolor = 0, textalignment = 0);

native SetObjectsDefaultCameraCol(disable);

List of functions:

• CreateObject: Creates an object at specified coordinates in the game world.
• AttachObjectToVehicle: Attach an object to a vehicle.
• AttachObjectToObject: Attach objects to other objects.
• AttachObjectToPlayer: Attach an object to a player.
• SetObjectPos: Change the position of an object.
• GetObjectPos: Get the position of an object.
• SetObjectRot: Set the rotation of an object on the three axes (X, Y and Z).
• GetObjectRot: Get the objects current rotation.
• GetObjectModel: Get the model ID of an object.
• SetObjectNoCameraCol: Disable collisions between players' cameras and the specified object.
• IsValidObject: Checks if an object with the ID provided exists.
• DestroyObject: Destroys (removes) an object that was created using CreateObject.
• MoveObject: Move an object to a new position with a set speed.
• StopObject: Stop a moving object after MoveObject has been used.
• IsObjectMoving: Checks if the given objectid is moving.
• EditObject: Allows a player to edit an object (position and rotation) using their mouse on a GUI (Graphical User Interface).
• EditPlayerObject: Allows players to edit a player-object (position and rotation) with a GUI and their mouse.
• SelectObject: Display the cursor and allow the player to select an object.
• CancelEdit: Cancel object edition mode for a player.
• CreatePlayerObject: Creates an object which will be visible to only one player.
• AttachPlayerObjectToVehicle: Attach a player object to a vehicle.
• SetPlayerObjectPos: Sets the position of a player-object to the specified coordinates.
• GetPlayerObjectPos: Get the position of a player object (CreatePlayerObject).
• SetPlayerObjectRot: Set the rotation of an object on the X, Y and Z axis.
• GetPlayerObjectRot: Get the object's current rotation.
• GetPlayerObjectModel: Retrieve the model ID of a player-object.
• SetPlayerObjectNoCameraCol: Toggles a player object camera collision.
• IsValidPlayerObject: Checks if the given object ID is valid for the given player.
• DestroyPlayerObject: Destroy a player-object created using CreatePlayerObject.
• MovePlayerObject: Move a player object with a set speed.
• StopPlayerObject: Stop a moving player-object after MovePlayerObject has been used.
• IsPlayerObjectMoving: Checks if the given player objectid is moving.
• AttachPlayerObjectToPlayer: The same as AttachObjectToPlayer but for objects which were created for player.
• SetObjectMaterial: Replace the texture of an object with the texture from another model in the game.
• SetPlayerObjectMaterial: Replace the texture of a player-object with the texture from another model in the game.
• SetObjectMaterialText: Replace the texture of an object with text.
• SetPlayerObjectMaterialText: Replace the texture of a player object with text.
• SetObjectsDefaultCameraCol: Allows camera collisions with newly created objects to be disabled by default.