DgsMoveTo: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with "__NOTOC__ {{Client function}} This function allow us to add animation to dgs elements. ==Syntax== <syntaxhighlight lang="lua"> bool dgsMoveTo ( element dgsElement, float x,...")
 
No edit summary
 
(14 intermediate revisions by 3 users not shown)
Line 2: Line 2:
{{Client function}}
{{Client function}}
This function allow us to add animation to dgs elements.
This function allow us to add animation to dgs elements.
Change position of dgs elements with animation effect.
==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool dgsMoveTo ( element dgsElement, float x, float y, bool relative, bool movetype, string easing = "Linear", float torvx [, float vy = torvx, table settings ])
number/table dgsMoveTo ( element/table dgsElement, float x, float y, bool relative, string easing = "Linear", float duration [, int delay = 0 ])
</syntaxhighlight>
</syntaxhighlight>


===Required Arguments===  
===Required Arguments===  
*'''dgsElement:''' The DGS element to set animation to.
*'''dgsElement:''' The DGS element or a list of DGS elements to set animation to.
*'''x:''' Position over the X axis.
*'''x:''' Position over the X axis.
*'''y:''' Position over the Y axis.
*'''y:''' Position over the Y axis.
*'''relative:''' Bool that indicates if the x/y positions are relative to the screen size.
*'''relative:''' Bool that indicates if the x/y positions are relative to the screen size.
*'''movetype:''' A bool that indicates whether the move type is based on Time or Speed.( For stable and easy, we always pass '''false''' to this argument)
*'''easing:''' The easing function to use for the interpolation (For More Detail :[[Easing]]), or your own easing function created by [[dgsAddEasingFunction]].
*'''easing:''' The easing function to use for the interpolation (For More Detail :[[Easing]]), or your own easing function created by [[addEasingFunction]].
*'''duration:''' An integer of the time(ms) to finish the animation.
*'''torvx:''' This is depends on '''movetype'''. If '''movetype''' sets to false, the torvx will be the time(ms) to finish the animation, or it will be a static speed to finish the animation.
 
*'''vy:''' This is depends on '''movetype'''. If '''movetype''' sets to true, this argument will be the Y speed to finish the animation, only need to pass a nil value to it otherwise.
===Optional Arguments===
*'''delay:''' The delay time before the animation starts, can decrease the using of timer.
*'''settings:''' A table will be passed to your own easing function.
*'''settings:''' A table will be passed to your own easing function.


===Returns===
===Returns===
Returns true if succeed, ''false'' otherwise.
Returns an ''integer''/''table'' indicates the animation ID or a list of animation IDs if succeed, ''false'' otherwise.


==Example==
==Example==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
DGS = exports.dgs
loadstring(exports.dgs:dgsImportFunction())()


parent = DGS:dgsDxCreateWindow(200,100,400,400,"DGS Parent Window",false) --Create a window
parent = dgsCreateWindow(200,100,400,400,"DGS Parent Window",false) --Create a window


DGS:dgsMoveTo(parent,400,200,false,false,"OutQuad",2000) --Set Animation
dgsMoveTo(parent,400,200,false,"OutQuad",2000) --Set Animation
</syntaxhighlight>
</syntaxhighlight>


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

Latest revision as of 17:05, 2 March 2023

This function allow us to add animation to dgs elements.

Change position of dgs elements with animation effect.

Syntax

number/table dgsMoveTo ( element/table dgsElement, float x, float y, bool relative, string easing = "Linear", float duration [, int delay = 0 ])

Required Arguments

  • dgsElement: The DGS element or a list of DGS elements to set animation to.
  • x: Position over the X axis.
  • y: Position over the Y axis.
  • relative: Bool that indicates if the x/y positions are relative to the screen size.
  • easing: The easing function to use for the interpolation (For More Detail :Easing), or your own easing function created by dgsAddEasingFunction.
  • duration: An integer of the time(ms) to finish the animation.

Optional Arguments

  • delay: The delay time before the animation starts, can decrease the using of timer.
  • settings: A table will be passed to your own easing function.

Returns

Returns an integer/table indicates the animation ID or a list of animation IDs if succeed, false otherwise.

Example

loadstring(exports.dgs:dgsImportFunction())()

parent = dgsCreateWindow(200,100,400,400,"DGS Parent Window",false)	--Create a window

dgsMoveTo(parent,400,200,false,"OutQuad",2000) --Set Animation

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