View source for CreateBuilding

__NOTOC__ 
{{Client function}}
{{New feature/item|3.0161|1.6.0|22410|Creates a [[building]] [[element]] at a given position and rotation.}}

==Syntax==
<syntaxhighlight lang="lua">building createBuilding ( int modelId, float x, float y, float z, float rx, float ry, float rz, [ int interior = 0 ] )</syntaxhighlight> 
{{OOP||[[Building]]||}}

===Required Arguments===
*'''modelId:''' A whole integer specifying the GTA:SA object model ID.
*'''x:''' A floating point number representing the X coordinate on the map.
*'''y:''' A floating point number representing the Y coordinate on the map.
*'''z:''' A floating point number representing the Z coordinate on the map.
*'''rx:''' A floating point number representing the rotation about the X axis in degrees.
*'''ry:''' A floating point number representing the rotation about the Y axis in degrees.
*'''rz:''' A floating point number representing the rotation about the Z axis in degrees.

===Optional Arguments===
{{OptionalArg}} 
*'''interior:''' The interior you want to set the building to. Valid values are 0 to 255.


===Returns===
* Returns the [[building]] element if the creation was successful, throws an error otherwise.

==Example==
<section name="Simple example" class="client" show="true">
This example creates a building when the resource starts:
<syntaxhighlight lang="lua">
function loadMap()
   -- create a *building* at a specified position with a specified rotation
   createBuilding(4550, 1985, -2544, 94, 0,0,0) -- Maze Bank Tower in LS airport
end
addEventHandler("onClientResourceStart", resourceRoot, loadMap)
</syntaxhighlight>
</section>


==See Also==
{{Building functions}}