AddColPolygonPoint: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with "{{Server client function}} __NOTOC__ {{New feature/item|3.0158|1.5.7|20397|This function is used to add a new point to an existing colshape polygon.}} ==...")
 
 
(6 intermediate revisions by 3 users not shown)
Line 7: Line 7:
bool addColPolygonPoint ( colshape shape, float fX, float fY [, int index = 0 ] )   
bool addColPolygonPoint ( colshape shape, float fX, float fY [, int index = 0 ] )   
</syntaxhighlight>  
</syntaxhighlight>  
{{OOP||[[colshape]]:getSize||setColShapeSize|}}
{{OOP||[[colshape]]:addPoint||removeColPolygonPoint|}}


===Required Arguments===  
===Required Arguments===  
Line 16: Line 16:
==Optional Arguments==
==Optional Arguments==
{{OptionalArg}}
{{OptionalArg}}
*'''index:''' The 0-based index where the new point will be inserted in the polygon. The points are indexed in order, with 0 being the first bound point.
*'''index:''' The index where the new point will be inserted in the polygon. The points are indexed in order, with 1 being the first bound point. Passing 0 will insert the point as the last one in the polygon.


===Returns===
===Returns===
Returns ''true'' if the polygon was changed, ''false'' if invalid arguments were passed.
Returns ''true'' if the polygon was changed, ''false'' if invalid arguments were passed.


==Example==
===Example===
<section name="Server" class="server" show="true">
This examples adds a point to an existing polygon shape by a command.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
TODO
local shape = createColPolygon(2, 2, 5, 5, 6, 6, 8, 8) -- Somewhere in the map
function addPointToPolygon(plr, cmd, fX, fY, index)
    if (not fX or not fY) then
        outputChatBox("Correct syntax: /addpoint <fX fY>", plr, 255, 25, 25)
        return false
    end
    if (not index or index == 0) then
        addColPolygonPoint(shape, fX, fY)
    else
        addColPolygonPoint(shape, fX, fY, index)
    end
    outputChatBox("Point added", plr, 0, 255, 0)
end
addCommandHandler("addpoint", addPointToPolygon)
</syntaxhighlight>
</syntaxhighlight>
</section>
==Requirements==
{{Requirements|1.5.7-9.20397|1.5.7-9.20397|}}


==See Also==
==See Also==
{{Collision_shape_functions}}
{{Collision_shape_functions}}

Latest revision as of 02:50, 4 February 2021

This function is used to add a new point to an existing colshape polygon.

Syntax

bool addColPolygonPoint ( colshape shape, float fX, float fY [, int index = 0 ] )  

OOP Syntax Help! I don't understand this!

Method: colshape:addPoint(...)
Counterpart: removeColPolygonPoint


Required Arguments

  • shape: The colshape polygon you wish add a point to.
  • fX: The X position of the new bound point.
  • fY: The Y position of the new bound point.

Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

  • index: The index where the new point will be inserted in the polygon. The points are indexed in order, with 1 being the first bound point. Passing 0 will insert the point as the last one in the polygon.

Returns

Returns true if the polygon was changed, false if invalid arguments were passed.

Example

Click to collapse [-]
Server

This examples adds a point to an existing polygon shape by a command.

local shape = createColPolygon(2, 2, 5, 5, 6, 6, 8, 8) -- Somewhere in the map
function addPointToPolygon(plr, cmd, fX, fY, index)
    if (not fX or not fY) then
        outputChatBox("Correct syntax: /addpoint <fX fY>", plr, 255, 25, 25)
        return false
    end
    if (not index or index == 0) then
        addColPolygonPoint(shape, fX, fY)
    else
        addColPolygonPoint(shape, fX, fY, index)
    end
    outputChatBox("Point added", plr, 0, 255, 0)
end
addCommandHandler("addpoint", addPointToPolygon)

Requirements

Minimum server version 1.5.7-9.20397
Minimum client version 1.5.7-9.20397

Note: Using this feature requires the resource to have the above minimum version declared in the meta.xml <min_mta_version> section. e.g. <min_mta_version server="1.5.7-9.20397" client="1.5.7-9.20397" />

See Also