View source for CreateRectangle3D

{{Useful Function}}
__NOTOC__
This function draws a 3d rectangle on the player screen.

* '''NOTE:''' only CLIENT-SIDE.

==Syntax==
<syntaxhighlight lang="lua">bool createRectangle3D ( float x, float y, float width, float height, int color, float rx, float ry, float rz )</syntaxhighlight>

===Required Arguments=== 
* '''X:''' Screen X position.
* '''Y:''' Screen Y position.
* '''WIDTH:''' The width of the rectangle.
* '''HEIGHT:''' The height of the rectangle.

===Optional Arguments===
* '''COLOR:''' The color of the rectangle. color in RGBA format tocolor(red, green, blue, alpha)
* '''RX:''' The x rotation of the rectangle.
* '''RY:''' The y rotation of the rectangle.
* '''RZ:''' The z rotation of the rectangle.

===Returns===
Returns a ''true'' if the operation was successful, ''false'' otherwise.

==Code==
<section name="Clientside script" class="client" show="true">
<syntaxhighlight lang="lua">

local resx, resy = guiGetScreenSize()

local rawShader = [[
    texture tex;
    technique replace {
        pass P0 {
            Texture[0] = tex;
        }
    }
]]

local renderRectangle = dxCreateRenderTarget(resx, resy, true)
local theRectangleShader = dxCreateShader(rawShader)

function createRectangle3D(x, y, w, h, color, rx, ry, rz)
   local color = color or tocolor(255, 255, 255, 255)
   local rx, ry, rz = rx, ry, rz or 0, 0, 0
   if renderRectangle then
      dxSetRenderTarget(renderRectangle, true)
      dxDrawRectangle(x, y, w, h, color, false)
      dxSetRenderTarget()
      dxSetShaderValue(theRectangleShader, "texture", renderRectangle)
      dxSetShaderTransform(theRectangleShader, rx, ry, rz)
      dxDrawImage(x, y, w, h, theRectangleShader, 0, 0, 0, color, false)
   end
end
</syntaxhighlight>
</section>

==Example==
This draws a white rectangle in the middle of the GTA world for no reason
<syntaxhighlight lang="lua">
local resx, resy = guiGetScreenSize()
local sx, sy = resx/1920, resy/1080

function TestDraw()
   local cx, cy = getCursorPosition()
   createRectangle3D(200 * sx, 300 * sy, 300 * sx, 120 * sy, tocolor(255, 0, 0, 255), cx, cy, 0)
end
addEventHandler("onClientRender", root, TestDraw)
</syntaxhighlight>


Author: Hydra45

==See Also==
{{Useful_Functions}}