DgsCreateRoundRect

From Multi Theft Auto: Wiki
Jump to navigation Jump to search

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

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

Syntax

element dgsCreateRoundRect( float radius, bool relative [, int color = 0xFFFFFFFF, texture background = nil, bool colorOverwritten = true, bool/int border = false, float borderHorizontalThickness, float borderVerticalThickness ] )
Example Rounded Rectangle

Required Arguments

  • radius: A float of the relative radius of corner of the rounded rectangle ranges from 0 to 1 if relative is true, or the radius will be absolute pixels.
  • relative: A bool indicates whether the radius is relative to the size of round rectangle or just absolute pixels.

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 (resultColor = render color * color) when rendering.
  • border: set to true to make it border only or an integer of color to apply the border with color. false is set by default to disable border.
  • borderHorizontalThickness: A float of the horizontal thickness, only works when border is not set to false.
  • borderVerticalThickness: A float of the vertical thickness, only works when border is not set to false.

Returns

Returns a dgs-dxroundrectangle 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.
  • border: set to true to make it border only or an integer of color to apply the border with color. false is set by default to disable border.
  • borderHorizontalThickness: A float of the horizontal thickness, only works when border is not set to false.
  • borderVerticalThickness: A float of the vertical thickness, only works when border is not set to false.

Returns

Returns a dgs-dxroundrectangle 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},{40,false},{30,false},{20,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

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

Plugin

Blur Box

Canvas

Chart

Circle

Color Picker

Effect 3D

Gradient

Mask

Media Browser

Nine Slice

Object Preview Supports

Paste Handler

QRCode

Remote Image

Rounded Rectangle

Screen Source

SVG

Tooltips