DgsCreateRoundRect

From Multi Theft Auto: Wiki

>>>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 isBorderOnly, 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 when rendering.
  • isBorderOnly: A bool of whether this round rectangle is not filled.
  • borderHorizontalThickness: A float of the horizontal thickness, only works when isBorderOnly set to true.
  • borderVerticalThickness: A float of the vertical thickness, only works when isBorderOnly set to true.

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 isBorderOnly, 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.
  • isBorderOnly: A bool of whether this round rectangle is not filled.
  • borderHorizontalThickness: A float of the horizontal thickness, only works when isBorderOnly set to true.
  • borderVerticalThickness: A float of the vertical thickness, only works when isBorderOnly set to true.

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

Multi Language Supports

Animation

3D Interface

3D Text

Browser

Button

Check Box

Combo Box

Custom Renderer

Edit

Detect Area

Grid List

Image

Memo

Label

Progress Bar

Radio Button

Scroll Bar

Scroll Pane

Switch Button

Tab Panel

Window

Plugin

Blur Box

Color Picker

Canvas

Effect 3D

Media Browser

Mask

Nine Slice

Object Preview Supports

QRCode

Remote Image

Rounded Rectangle