DgsCreateBlurBox: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
 
(8 intermediate revisions by 3 users not shown)
Line 7: Line 7:
==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
element dgsCreateBlurBox( )
element dgsCreateBlurBox( int resolutionX, int resolutionY [, texture sourceTexture = nil ] )
</syntaxhighlight>  
</syntaxhighlight>  


[[Image:DGS.png|300px|thumb|Example Rounded Rectangle]]
[[Image:DGS_Blur_Box.png|300px|thumb|Example Blur Box]]
 
===Required Argument===
*'''resolutionX''': A number of the resolution of the blur box in width.
*'''resolutionY''': A number of the resolution of the blur box in height.
 
===Optional Argument===
*'''sourceTexture''': A texture that you want to blur. Set to ''nil'' to blur the screen.


===Returns===
===Returns===
Line 19: Line 26:
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
DGS = exports.dgs --get exported functions from dgs
DGS = exports.dgs --get exported functions from dgs
local x,y,width,height = 200,200,600,500


local blurbox = DGS:dgsCreateBlurBox(600, 500) --Blur Box
local blurbox = DGS:dgsCreateBlurBox(width, height) --Blur Box
local blurArea = DGS:dgsCreateImage(200,200,600,500,blurbox,false) --Blur Box Renderer
local blurArea = DGS:dgsCreateImage(x,y,width,height,blurbox,false) --Blur Box Renderer
local window = DGS:dgsCreateWindow(200,2000,600,500,"Test Window",false) --Window
local window = DGS:dgsCreateWindow(x,y,width,height,"Test Window",false) --Window
DGS;dgsAttachToAutoDestroy(blurbox,window) --Destroy the blurbox with window
DGS:dgsAttachToAutoDestroy(blurbox,window) --Destroy the blurbox with window
DGS;dgsAttachToAutoDestroy(blurArea,window) --Destroy the blurArea with window
DGS:dgsAttachToAutoDestroy(blurArea,window) --Destroy the blurArea with window
DGS:dgsAttachElements(blurArea,window,0,0,1,1,true,true) --Attach Blur Box Renderer to Window
DGS:dgsAttachElements(blurArea,window,0,0,1,1,true,true) --Attach Blur Box Renderer to Window
DGS:dgsSetLayer(blurArea,"bottom") --Make sure the blurArea is always under window
DGS:dgsSetLayer(blurArea,"bottom") --Make sure the blurArea is always under window
Line 36: Line 44:
local blurbox = dgsCreateBlurBox(sW, sH) -- Create a blur Box
local blurbox = dgsCreateBlurBox(sW, sH) -- Create a blur Box
local blurArea = dgsCreateImage(0,0,1,1,blurbox,true) -- --Blur Box Renderer
local blurArea = dgsCreateImage(0,0,1,1,blurbox,true) -- --Blur Box Renderer
</syntaxhighlight>
This example shows that you can blur a dgs element
<syntaxhighlight lang="lua">
loadstring(exports.dgs:dgsImportFunction())()-- load functions
local sW, sH = guiGetScreenSize() -- get the screen size
local blurbox = dgsCreateBlurBox(sW/2, sH/2) -- Create a blur Box
dgsSetProperty(blurbox,"updateScreenSource",true)
dgsBlurBoxSetIntensity(blurbox,1)
dgsBlurBoxSetLevel(blurbox,15)
local blurArea = dgsCreateImage(0,0,0.5,0.5,blurbox,true) -- --Blur Box Renderer
window = dgsCreateWindow(400,200,800,200,"123",false)
dgsSetPostGUI(window,false)
dgsSetLayer(window,"bottom") --This window should be always under the blur box
</syntaxhighlight>
</syntaxhighlight>


==See Also==
==See Also==
{{DGSFUNCTIONS}}
{{DGSFUNCTIONS}}

Latest revision as of 12:40, 7 May 2022

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

This function creates a blur box.

Syntax

element dgsCreateBlurBox( int resolutionX, int resolutionY [, texture sourceTexture = nil ] )
Example Blur Box

Required Argument

  • resolutionX: A number of the resolution of the blur box in width.
  • resolutionY: A number of the resolution of the blur box in height.

Optional Argument

  • sourceTexture: A texture that you want to blur. Set to nil to blur the screen.

Returns

Returns a dgs-dxblurbox element (DGS Plugin Type)[ shader (Element Type) ] if succeed, false otherwise

Example

This example shows creating a blur box on image

DGS = exports.dgs --get exported functions from dgs
local x,y,width,height = 200,200,600,500

local blurbox = DGS:dgsCreateBlurBox(width, height) --Blur Box
local blurArea = DGS:dgsCreateImage(x,y,width,height,blurbox,false) --Blur Box Renderer
local window = DGS:dgsCreateWindow(x,y,width,height,"Test Window",false) --Window
DGS:dgsAttachToAutoDestroy(blurbox,window) --Destroy the blurbox with window
DGS:dgsAttachToAutoDestroy(blurArea,window) --Destroy the blurArea with window
DGS:dgsAttachElements(blurArea,window,0,0,1,1,true,true) --Attach Blur Box Renderer to Window
DGS:dgsSetLayer(blurArea,"bottom") --Make sure the blurArea is always under window

This example adds a blurbox on the full screen

loadstring(exports.dgs:dgsImportFunction())()-- load functions

local sW, sH = guiGetScreenSize() -- get the screen size
local blurbox = dgsCreateBlurBox(sW, sH) -- Create a blur Box
local blurArea = dgsCreateImage(0,0,1,1,blurbox,true) -- --Blur Box Renderer

This example shows that you can blur a dgs element

loadstring(exports.dgs:dgsImportFunction())()-- load functions

local sW, sH = guiGetScreenSize() -- get the screen size
local blurbox = dgsCreateBlurBox(sW/2, sH/2) -- Create a blur Box
dgsSetProperty(blurbox,"updateScreenSource",true)
dgsBlurBoxSetIntensity(blurbox,1)
dgsBlurBoxSetLevel(blurbox,15)
local blurArea = dgsCreateImage(0,0,0.5,0.5,blurbox,true) -- --Blur Box Renderer
window = dgsCreateWindow(400,200,800,200,"123",false)
dgsSetPostGUI(window,false)
dgsSetLayer(window,"bottom") --This window should be always under the blur box

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