GetGarageSize: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Tip and note)
 
Line 13: Line 13:
===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.}}
{{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==

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