DxDrawCircle - Revision history

Quiret: /* Remarks */

2021-12-08T19:07:18Z

Remarks

← Older revision		Revision as of 19:07, 8 December 2021
Line 31:		Line 31:
	By documentation this function does perform a '''triangle approximation of the cicle'''. This is important for when there is no shader support on the end-user hardware. If there is shader support then you can instead use shaders with euler-based math (sin/cos/asin) to create a smoother circle. The performance does scale much better than increasing the segment count of this function because drawing using shader would take up only one draw-call. Take look at [https://forum.mtasa.com/topic/133045-dxdrawcircle-chart/?do=findComment&comment=1002953 this post] for more details.		By documentation this function does perform a '''triangle approximation of the cicle'''. This is important for when there is no shader support on the end-user hardware. If there is shader support then you can instead use shaders with euler-based math (sin/cos/asin) to create a smoother circle. The performance does scale much better than increasing the segment count of this function because drawing using shader would take up only one draw-call. Take look at [https://forum.mtasa.com/topic/133045-dxdrawcircle-chart/?do=findComment&comment=1002953 this post] for more details.

	The above remark is about drawing ~~cirles~~ on modern end-user hardware with angle-interval support, as necessary by example for pie-charts. '''Drawing full circles''' is easier because the math can be simplified to a euler distance calculation from the texcoord (0.5, 0.5) to the currently drawing pixel. Then the HLSL clip function can be used to not render any pixels outside of the circle. Read more about it in [https://forum.mtasa.com/topic/133453-round-render-target/#comment-1004102 this post].		The above remark is about drawing circles on modern end-user hardware with angle-interval support, as necessary by example for pie-charts. '''Drawing full circles''' is easier because the math can be simplified to a euler distance calculation from the texcoord (0.5, 0.5) to the currently drawing pixel. Then the HLSL clip function can be used to not render any pixels outside of the circle. Read more about it in [https://forum.mtasa.com/topic/133453-round-render-target/#comment-1004102 this post].

	==Example==		==Example==

Quiret: /* Remarks */

2021-12-08T19:06:49Z

Remarks

← Older revision		Revision as of 19:06, 8 December 2021
Line 30:		Line 30:
	==Remarks==		==Remarks==
	By documentation this function does perform a '''triangle approximation of the cicle'''. This is important for when there is no shader support on the end-user hardware. If there is shader support then you can instead use shaders with euler-based math (sin/cos/asin) to create a smoother circle. The performance does scale much better than increasing the segment count of this function because drawing using shader would take up only one draw-call. Take look at [https://forum.mtasa.com/topic/133045-dxdrawcircle-chart/?do=findComment&comment=1002953 this post] for more details.		By documentation this function does perform a '''triangle approximation of the cicle'''. This is important for when there is no shader support on the end-user hardware. If there is shader support then you can instead use shaders with euler-based math (sin/cos/asin) to create a smoother circle. The performance does scale much better than increasing the segment count of this function because drawing using shader would take up only one draw-call. Take look at [https://forum.mtasa.com/topic/133045-dxdrawcircle-chart/?do=findComment&comment=1002953 this post] for more details.

			The above remark is about drawing cirles on modern end-user hardware with angle-interval support, as necessary by example for pie-charts. '''Drawing full circles''' is easier because the math can be simplified to a euler distance calculation from the texcoord (0.5, 0.5) to the currently drawing pixel. Then the HLSL clip function can be used to not render any pixels outside of the circle. Read more about it in [https://forum.mtasa.com/topic/133453-round-render-target/#comment-1004102 this post].

	==Example==		==Example==

Quiret at 19:14, 2 November 2021

2021-11-02T19:14:28Z

← Older revision		Revision as of 19:14, 2 November 2021
Line 27:		Line 27:
	===Returns===		===Returns===
	Returns ''true'' if the creation of the 2D circle was successful, ''false'' otherwise.		Returns ''true'' if the creation of the 2D circle was successful, ''false'' otherwise.

			==Remarks==
			By documentation this function does perform a '''triangle approximation of the cicle'''. This is important for when there is no shader support on the end-user hardware. If there is shader support then you can instead use shaders with euler-based math (sin/cos/asin) to create a smoother circle. The performance does scale much better than increasing the segment count of this function because drawing using shader would take up only one draw-call. Take look at [https://forum.mtasa.com/topic/133045-dxdrawcircle-chart/?do=findComment&comment=1002953 this post] for more details.

	==Example==		==Example==

DezZolation at 20:32, 26 March 2019

2019-03-26T20:32:46Z

← Older revision		Revision as of 20:32, 26 March 2019
Line 5:		Line 5:

	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">bool dxDrawCircle ( float posX, float posY, float radius [, float startAngle = 0.0, float stopAngle = 360.0, ~~color~~ theColor = white,		<syntaxhighlight lang="lua">bool dxDrawCircle ( float posX, float posY, float radius [, float startAngle = 0.0, float stopAngle = 360.0, int theColor = white,
	~~color~~ theCenterColor = theColor, int segments = 32, int ratio = 1, bool postGUI = false ] )</syntaxhighlight>		int theCenterColor = theColor, int segments = 32, int ratio = 1, bool postGUI = false ] )</syntaxhighlight>

	===Required Arguments===		===Required Arguments===

NanoBob: /* Syntax */

2019-03-06T12:14:16Z

Syntax

← Older revision		Revision as of 12:14, 6 March 2019
Line 6:		Line 6:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">bool dxDrawCircle ( float posX, float posY, float radius [, float startAngle = 0.0, float stopAngle = 360.0, color theColor = white,		<syntaxhighlight lang="lua">bool dxDrawCircle ( float posX, float posY, float radius [, float startAngle = 0.0, float stopAngle = 360.0, color theColor = white,
	color theCenterColor = theColor, int segments = 32, int ratio = 1, postGUI = false ] )</syntaxhighlight>		color theCenterColor = theColor, int segments = 32, int ratio = 1, bool postGUI = false ] )</syntaxhighlight>

	===Required Arguments===		===Required Arguments===

Surge at 18:13, 21 October 2018

2018-10-21T18:13:50Z

← Older revision		Revision as of 18:13, 21 October 2018
Line 55:		Line 55:
	==See Also==		==See Also==
	{{Drawing_functions}}		{{Drawing_functions}}

			[[hu:dxDrawCircle]]

Saml1er: fixed postGUI parameter name

2018-08-10T20:05:44Z

fixed postGUI parameter name

← Older revision		Revision as of 20:05, 10 August 2018
Line 6:		Line 6:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">bool dxDrawCircle ( float posX, float posY, float radius [, float startAngle = 0.0, float stopAngle = 360.0, color theColor = white,		<syntaxhighlight lang="lua">bool dxDrawCircle ( float posX, float posY, float radius [, float startAngle = 0.0, float stopAngle = 360.0, color theColor = white,
	color theCenterColor = theColor, int segments = 32, int ratio = 1, ~~bPostGUI~~ = false ] )</syntaxhighlight>		color theCenterColor = theColor, int segments = 32, int ratio = 1, postGUI = false ] )</syntaxhighlight>

	===Required Arguments===		===Required Arguments===

Myonlake at 20:10, 7 August 2018

2018-08-07T20:10:51Z

← Older revision		Revision as of 20:10, 7 August 2018
Line 2:		Line 2:
	<lowercasetitle/>		<lowercasetitle/>
	__NOTOC__		__NOTOC__
	{{New feature/item\|3.0156\|1.5.6\|13977\|This function draws a circle shape on the screen - rendered for '''one''' frame. This should be used in conjunction with [[onClientRender]] in order to be display continuously.}}		{{New feature/item\|3.0156\|1.5.5\|13977\|This function draws a circle shape on the screen - rendered for '''one''' frame. This should be used in conjunction with [[onClientRender]] in order to be display continuously.}}

	==Syntax==		==Syntax==

Pirulax: Added revision number to the 'New feature/item' template

2018-08-07T20:10:06Z

Added revision number to the 'New feature/item' template

← Older revision		Revision as of 20:10, 7 August 2018
Line 2:		Line 2:
	<lowercasetitle/>		<lowercasetitle/>
	__NOTOC__		__NOTOC__
	{{New feature/item\|3.0156\|1.5.6\|\|This function draws a circle shape on the screen - rendered for '''one''' frame. This should be used in conjunction with [[onClientRender]] in order to be display continuously.}}		{{New feature/item\|3.0156\|1.5.6\|13977\|This function draws a circle shape on the screen - rendered for '''one''' frame. This should be used in conjunction with [[onClientRender]] in order to be display continuously.}}

	==Syntax==		==Syntax==

Saml1er: Changed example image.

2018-08-04T18:07:13Z

Changed example image.

← Older revision		Revision as of 18:07, 4 August 2018
Line 9:		Line 9:

	===Required Arguments===		===Required Arguments===
	[[Image:~~DxDrawCircle_howworking~~.png\|thumb\|An example of how dxDrawCircle function works in practice.]]		[[Image:DxDrawCircle_Saml1er.png\|thumb\|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.		* '''posX''': An integer representing the '''absolute''' X position of the circle center, represented by pixels on the screen.