DgsCreateQuad: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with "__NOTOC__ {{Client function}} <span style="color:#FF0000;text-shadow:black 0.1em 0.1em 0.6em;">>>>Warning: This feature requires pixel shader model 2_a<<<</span> This function creates a quadrilateral shader that can be used for dgs elements. ==Syntax== <syntaxhighlight lang="lua"> element dgsCreateQuad( table corners [, int color = 0xFFFFFFFF, texture background = nil, bool colorOverwritten = true ] ) </syntaxhighlight> Image:DGS_Rounded_Rectangle.png|300px|thumb...")
 
No edit summary
Line 10: Line 10:
</syntaxhighlight>  
</syntaxhighlight>  


[[Image:DGS_Rounded_Rectangle.png|300px|thumb|Example Rounded Rectangle]]
[[Image:DGS_Quadrilateral_1.png|300px|thumb|Example Rounded Rectangle]]
===Required Arguments===
===Required Arguments===
*'''corners :''' A table of the corners of the quadrilateral. The structure is as follows:
*'''corners :''' A table of the corners of the quadrilateral. The structure is as follows:
Line 29: Line 29:


===Returns===
===Returns===
Returns a dgs-dxroundrectangle element (dgs Type)/ shader (element Type) if succeed, ''false'' otherwise
Returns a dgs-dxquad element (dgs Type)/ shader (element Type) if succeed, ''false'' otherwise


==Example==  
==Example==  

Revision as of 07:50, 5 May 2024

>>>Warning: This feature requires pixel shader model 2_a<<<

This function creates a quadrilateral shader that can be used for dgs elements.

Syntax

element dgsCreateQuad( table corners [, int color = 0xFFFFFFFF, texture background = nil, bool colorOverwritten = true ] )
Example Rounded Rectangle

Required Arguments

  • corners : A table of the corners of the quadrilateral. The structure is as follows:
{
	{ float LeftTopX, float LeftTopY, bool relative },
	{ float RightTopX, float RightTopY, bool relative },
	{ float RightBottomX, float RightBottomY, bool relative },
	{ float LeftBottomX, float LeftBottomY, bool relative },
}

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.

  • color: An int of the color of the quadrilateral.
  • background: A texture element of the background of the quadrilateral.
  • colorOverwritten: A bool indicates whether the final color will be overwritten by color or the product of render color and color (resultColor = render color * color) when rendering.

Returns

Returns a dgs-dxquad element (dgs Type)/ shader (element Type) if succeed, false otherwise

Example

DGS = exports.dgs --get exported functions from dgs

local rndRect = DGS:dgsCreateRoundRect(50,false,tocolor(0,0,0,150))  --Create Rounded Rectangle with 50 pixels radius 
local image1 = DGS:dgsCreateImage(200,200,400,100,rndRect,false)  --Apply it to the dgs image

Syntax

element dgsCreateRoundRect( table multiArguments [, int color = 0xFFFFFFFF, texture background = nil, bool colorOverwritten = true, bool/int border = false, float borderHorizontalThickness, float borderVerticalThickness ] )

Required Arguments

  • multiArguments : A table contains at least 1 group of the radius of the corner. The structure is as follows:
{
	{ float LeftTopRadius, bool relative },
	{ float RightTopRadius, bool relative },
	{ float RightBottomRadius, bool relative },
	{ float LeftBottomRadius, bool relative },
}

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.

  • color : An int of the color of the rounded rectangle.
  • background: A texture element of the background of the rounded rectangle.
  • colorOverwritten : A bool indicates whether the final color will be overwritten by color or the product of render color and color when rendering.

Returns

Returns a dgs-dxquad element (dgs Type)/ shader (element Type) if succeed, false otherwise

Example

DGS = exports.dgs --get exported functions from dgs

local quad = dgsCreateQuad({
	{20,10,false},
	{80,10,false},
	{90,90,false},
	{10,90,false},
},tocolor(255,255,255,100))
dgsQuadSetColorOverwritten(quad,false)

local btn = dgsCreateButton(500,400,400,50,"Button",false)
dgsSetProperty(btn,"image",quad)

See Also

Custom Cursor Functions

Multi Language Supports

Animation

3D Element

3D Interface

3D Line

3D Image

3D Text

Browser

Button

Check Box

Combo Box

Custom Renderer

Edit

Detect Area

Drag'N Drop

Grid List

Image

Memo

Menu

Label

Layout

Line

Progress Bar

Radio Button

Scale Pane

Scroll Bar

Scroll Pane

Selector

Style

Switch Button

Tab Panel

Window

Basic Shape Plugins

Circle

Quadrilateral

Rounded Rectangle

Other Plugins

Blur Box

Canvas

Chart

Color Picker

Effect 3D

Gradient

Mask

Media Browser

Nine Slice

Object Preview Supports

Paste Handler

QRCode

Remote Image

Screen Source

SVG

Tooltips