note Help Needed

This wiki is the result of an ongoing community effort — thank you all for helping!

If you want to provide changes to this page then please click here.

BeginObjectEditing

warning

This function was added in omp v1.1.0.2612 and will not work in earlier versions!

Description

Allows a player to edit an object (position and rotation) using their mouse on a GUI (Graphical User Interface).

Name	Description
playerid	The ID of the player that should edit the object.
objectid	The ID of the object to be edited by the player.

Returns

true - The function executed successfully. Success is reported when a non-existent object is specified, but nothing will happen.

false - The function failed to execute. The player is not connected.

Examples

new objectid;

public OnGameModeInit()
{
    objectid = CreateObject(1337, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0);
    return 1;
}

public OnPlayerCommandText(playerid, cmdtext[])
{
    if (!strcmp(cmdtext, "/oedit", true))
    {
        BeginObjectEditing(playerid, objectid);
        SendClientMessage(playerid, 0xFFFFFFFF, "SERVER: You can now edit the object!");
        return 1;
    }
    return 0;
}

Notes

tip

You can move the camera while editing by pressing and holding the spacebar (or W in vehicle) and moving your mouse.

Related Functions

CreateObject: Create an object.
DestroyObject: Destroy an object.
MoveObject: Move an object.
BeginPlayerObjectEditing: Edit an object.
EditAttachedObject: Edit an attached object.
BeginObjectSelecting: Select an object.
EndObjectEditing: Cancel the edition of an object.