GetGarageSize: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
 
(2 intermediate revisions by the same user not shown)
Line 2: Line 2:
{{client function}}
{{client function}}
This function outputs the size of garage.
This function outputs the size of garage.
 
{{Tip|You can use the useful function [[CreateGarageColShape]] to create the garage colshape.}}
==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
Line 12: Line 12:


===Returns===
===Returns===
Returns three ''float''s indicating the size of the garage, false if an invalid garageID has been provided
Returns three ''float''s indicating the size of the garage, false if an invalid garageID has been provided.
{{Note|The values returned by this function are sizeZ, sizeX and sizeY respectively.<br>Also, sizeZ considers the garage Z position equal to 0.}}


==Example==
==Example==
Line 23: Line 24:
if ( garageID ) then -- We check if garage ID is valid.
if ( garageID ) then -- We check if garage ID is valid.
if ( garageID >= 0 and garageID < 50 ) then -- We check if the garage ID is 0 and lower than 50 ( there's only 49 garages ).
if ( garageID >= 0 and garageID < 50 ) then -- We check if the garage ID is 0 and lower than 50 ( there's only 49 garages ).
local x, y, z = getGarageSize ( garageID )
local z, x, y = getGarageSize ( garageID )
if ( x and y and z ) then -- If x and y and z is valid.
if ( x and y and z ) then -- If x and y and z is valid.
-- We output the returned values.
-- We output the returned values.

Latest revision as of 06:04, 3 March 2023

This function outputs the size of garage.

[[{{{image}}}|link=|]] Tip: You can use the useful function CreateGarageColShape to create the garage colshape.

Syntax

float, float, float getGarageSize ( int garageID )

Required Arguments

  • garageID: The garage ID that represents the garage door that is being checked.

Returns

Returns three floats indicating the size of the garage, false if an invalid garageID has been provided.

[[{{{image}}}|link=|]] Note: The values returned by this function are sizeZ, sizeX and sizeY respectively.
Also, sizeZ considers the garage Z position equal to 0.

Example

Click to collapse [-]
Client

This example adds the command /garagesize <garage ID>

addCommandHandler ( "garagesize",
	function ( commandName, garageID )
		local garageID = tonumber ( garageID ) -- We convert the garage ID string to a number.
		if ( garageID ) then -- We check if garage ID is valid.
			if ( garageID >= 0 and garageID < 50 ) then -- We check if the garage ID is 0 and lower than 50 ( there's only 49 garages ).
				local z, x, y = getGarageSize ( garageID )
				if ( x and y and z ) then -- If x and y and z is valid.
					-- We output the returned values.
					outputChatBox (	"X: ".. x )
					outputChatBox (	"Y: ".. y )
					outputChatBox (	"Z: ".. z )
				else
					outputChatBox (	"X, Y, Z values not valid" )
				end
			else
				outputChatBox (	"Garage ID must be from 0 to 49." )
			end
		else
			outputChatBox (	"You must write a garage ID" )
		end
	end
)

See Also