DxDrawCircle: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
(Fixed some English mistakes)
Line 20: Line 20:
* '''theColor''': An integer of the hex color, produced using [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).
* '''theColor''': An integer of the hex color, produced using [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).
* '''theCenterColor''': An integer of the hex color, produced using [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).
* '''theCenterColor''': An integer of the hex color, produced using [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).
* '''segments''': An intiger representing from how many triangles is created circle, more = more smoothly.
* '''segments''': An integer representing from how many triangles are used to form the circle, more segments = smoother circle.
* '''ratio''': Ratio between width and height, 2 mean that circle is 2 times widther then higher.
* '''ratio''': Ratio between width and height, e.g: 2 would mean that the circle is 2 times wider than it is high.
* '''postGUI''': A bool representing whether the line should be drawn on top of or behind any ingame GUI (rendered by CEGUI).
* '''postGUI''': A bool representing whether the line should be drawn on top of or behind any ingame GUI (rendered by CEGUI).


Line 29: Line 29:
==Code==
==Code==
<section name="Client" class="client" show="true">
<section name="Client" class="client" show="true">
This function draw a rectangle with rounded corners.
This function draws a rectangle with rounded corners.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function dxDrawRoundedRectangle(x,y,rx,ry,color,radius)
function dxDrawRoundedRectangle(x,y,rx,ry,color,radius)

Revision as of 12:46, 4 August 2018

This function draws a circle shape on the screen - rendered for one frame. This should be used in conjunction with onClientRender in order to display continuously.

Syntax

bool dxDrawCircle( float posX, float posY, float radius [, float startAngle = 0, float stopAngle = 360, color theColor = white, color theCenterColor = theColor, int segments = 32, int ratio = 1, bPostGUI = false ])

Required Arguments

An example of how dxDrawCircle function works in practice.
  • posX: An integer representing the absolute X position of the circle center, represented by pixels on the screen.
  • posY: An integer representing the absolute Y position of the circle center, represented by pixels on the screen.
  • radius: An integer representing the radius scale of the circle that is being drawn.

Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

  • startAngle: An integer representing the angle of the first point of the circle.
  • stopAngle: An integer representing the angle of the last point of the circle.
  • theColor: An integer of the hex color, produced using tocolor or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).
  • theCenterColor: An integer of the hex color, produced using tocolor or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).
  • segments: An integer representing from how many triangles are used to form the circle, more segments = smoother circle.
  • ratio: Ratio between width and height, e.g: 2 would mean that the circle is 2 times wider than it is high.
  • postGUI: A bool representing whether the line should be drawn on top of or behind any ingame GUI (rendered by CEGUI).

Returns

Returns true if the creation of the 2D circle was successful, false otherwise.

Code

Click to collapse [-]
Client

This function draws a rectangle with rounded corners.

function dxDrawRoundedRectangle(x,y,rx,ry,color,radius)
  rx = rx - radius * 2
  ry = ry - radius * 2
  x = x + radius
  y = y + radius
  if(rx >= 0 and ry >= 0)then
    dxDrawRectangle(x,y,rx,ry,color)
    
    dxDrawRectangle(x,y - radius,rx,radius,color)
    dxDrawRectangle(x,y + ry,rx,radius,color)
    dxDrawRectangle(x - radius,y,radius,ry,color)
    dxDrawRectangle(x + rx,y,radius,ry,color)
    
    dxDrawCircle(x,y,radius,180,270,color,color,7);
    dxDrawCircle(x + rx,y,radius,270,360,color,color,7);
    dxDrawCircle(x + rx,y + ry,radius,0,90,color,color,7);
    dxDrawCircle(x,y + ry,radius,90,180,color,color,7);
  end
end
dxDrawRoundedRectangle(350,50,100,100,tocolor(0,255,0,255), 20)

See Also