DgsCreateRoundRect: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
Line 20: Line 20:
*'''background''': A texture element of the background 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.
*'''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.
*'''isBorderOnlyOrColor''': A bool of whether this round rectangle is '''not filled''' or An int of the color of the rounded rectangle border.
*'''isBorderOnlyOrBorderColor''': A bool of whether this round rectangle is '''not filled''' or An int of the color of the rounded rectangle border.
*'''borderHorizontalThickness''': A float of the horizontal thickness, only works when '''isBorderOnly''' set to true.
*'''borderHorizontalThickness''': A float of the horizontal thickness, only works when '''isBorderOnlyOrBorderColor''' is not set to false.
*'''borderVerticalThickness''': A float of the vertical thickness, only works when '''isBorderOnly''' set to true.
*'''borderVerticalThickness''': A float of the vertical thickness, only works when '''isBorderOnlyOrBorderColor''' is not set to false.


===Returns===
===Returns===

Revision as of 07:58, 1 March 2023

>>>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 isBorderOnlyOrBorderColor, 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.
  • isBorderOnlyOrBorderColor: A bool of whether this round rectangle is not filled or An int of the color of the rounded rectangle border.
  • borderHorizontalThickness: A float of the horizontal thickness, only works when isBorderOnlyOrBorderColor is not set to false.
  • borderVerticalThickness: A float of the vertical thickness, only works when isBorderOnlyOrBorderColor 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 isBorderOnlyOrBorderColor, 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.
  • isBorderOnlyOrColor: A bool of whether this round rectangle is not filled or An int of the color of the rounded rectangle border.
  • 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

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