GetColPolygonHeight: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Server client function}}
{{Server client function}}
__NOTOC__
__NOTOC__
{{Added feature/item|3.0159|1.5.9|1.5.8|20807|This function is used to get the height of an existing [[createColPolygon|colshape polygon]].
{{Added feature/item|1.5.9|1.5.8|20807|This function is used to get the height of an existing [[createColPolygon|colshape polygon]].
By default, a colshape polygon is infinitely tall.}}
By default, a colshape polygon is infinitely tall.}}


Line 17: Line 17:


==Example==
==Example==
{{Needs_Example}}
<section name="Server" class="server" show="true">
This example creates a polygon colshape and show height of it with command 'getpolyheight'.
<syntaxhighlight lang="lua">
-- Creates polygon colshape at 0, 0, 4
local colPoly = createColPolygon ( -1.08, -0.05, 2.92, -0.05, -1.08, -4.05, -5.08, -0.05, -1.08, 3.95 )
-- Set its height to 4 unit
setColPolygonHeight ( colPoly, 2.32, 7.12 )
function showPolyHeight ( player, command )
    -- Get element position
    local x, y = getElementPosition ( colPoly )
    -- Get table floor and ceil of the colshape height and unpack it
    local z, z1 = unpack ( getColPolygonHeight ( colPoly ) )
    local heights = z1 - z
    -- Output it in his chatbox
    outputChatBox( "The Polygon Colshape at "..x..", "..y.." height is "..heights, player, 255, 255, 0)
end
addCommandHandler ( "getpolyheight", showPolyHeight )
</syntaxhighlight>
</section>


==Requirements==
==Requirements==

Latest revision as of 03:51, 1 June 2022

This function is used to get the height of an existing colshape polygon. By default, a colshape polygon is infinitely tall.

Syntax

float, float getColPolygonHeight ( colshape shape )

OOP Syntax Help! I don't understand this!

Method: colshape:getHeight(...)


Required Arguments

Returns

Returns two floats, indicating the floor and ceiling of the colshape height, false if invalid arguments were passed.

Example

Click to collapse [-]
Server

This example creates a polygon colshape and show height of it with command 'getpolyheight'. 

 -- Creates polygon colshape at 0, 0, 4
 local colPoly = createColPolygon ( -1.08, -0.05, 2.92, -0.05, -1.08, -4.05, -5.08, -0.05, -1.08, 3.95 )
 -- Set its height to 4 unit
 setColPolygonHeight ( colPoly, 2.32, 7.12 )
 
 function showPolyHeight ( player, command )
     -- Get element position
     local x, y = getElementPosition ( colPoly )
     -- Get table floor and ceil of the colshape height and unpack it
     local z, z1 = unpack ( getColPolygonHeight ( colPoly ) )
     local heights = z1 - z
     -- Output it in his chatbox
     outputChatBox( "The Polygon Colshape at "..x..", "..y.." height is "..heights, player, 255, 255, 0)
 end
 addCommandHandler ( "getpolyheight", showPolyHeight )

Requirements

Minimum server version 1.5.8-9.20807
Minimum client version 1.5.8-9.20807

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.8-9.20807" client="1.5.8-9.20807" />

See Also


Retrieved from "https://wiki.multitheftauto.com/wiki/GetColPolygonHeight?oldid=74698"