DgsSetSize: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with "{{Client function}} __NOTOC__ This function sets the dimensions (size) of a DGS element. It refers to the bounding box size for DGS elements. It does not make DGS elements sma...")
 
m (DGS OOP Syntax changing)
 
(3 intermediate revisions by 2 users not shown)
Line 6: Line 6:
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool dgsSetSize ( element dgsElement, float width, float height, bool relative )
bool dgsSetSize ( element dgsElement, float width, float height, bool relative )
</syntaxhighlight>  
</syntaxhighlight>
{{DGS/OOP|
    Note = It variables is a conjunction:
*Relative: '''size.relative''' (set Relative property)
*Width: '''size.w'''
*Height: '''size.h'''|
    Method = DGSElement:setSize|
    Variable = size|
    Counterpart = dgsGetSize
}}


===Required Arguments===  
===Required Arguments===  
Line 12: Line 21:
*'''width:''' The desired width setting for the dgs element
*'''width:''' The desired width setting for the dgs element
*'''height:''' The desired height setting for the dgs element
*'''height:''' The desired height setting for the dgs element
*'''relative:''' This is whether sizes and positioning are relative. If this is ''true'', then all x,y,width,height floats must be between 0 and 1, representing sizes relative to the parent.
*'''relative:''' This is whether sizes and positioning are relative. If this is true, then all x,y,width,height floats must be between 0 and 1, representing sizes relative to the parent.


===Returns===
===Returns===
Line 27: Line 36:


--Create a dgs window called 'myWindow'
--Create a dgs window called 'myWindow'
myWindow = DGS:dgsDxCreateWindow ( 0.3, 0.3, 0.5, 0.60, "DGS window title", true )
myWindow = DGS:dgsCreateWindow ( 0.3, 0.3, 0.5, 0.60, "DGS window title", true )
--Set a timer to change the window's size every 2 seconds, infinite times
--Set a timer to change the window's size every 2 seconds, infinite times
setTimer ( changeWindowSize, 2000, 0 )
setTimer ( changeWindowSize, 2000, 0 )
Line 33: Line 42:


==See Also==
==See Also==
{{DGSFUNCTIONS}}
 
===<span style="color:#eb3f00;text-shadow:0.05em 0.05em 0.2em #00000099;">General Functions</span>===
{{DGS General Functions}}
 
===<span style="color:#eb3f00;text-shadow:0.05em 0.05em 0.2em #00000099;">General Events</span>===
{{DGS Events/General}}

Latest revision as of 19:03, 3 May 2021

This function sets the dimensions (size) of a DGS element. It refers to the bounding box size for DGS elements. It does not make DGS elements smaller or larger in appearance.

Syntax

bool dgsSetSize ( element dgsElement, float width, float height, bool relative )

DGS OOP Syntax Help! I don't understand this!

Note: It variables is a conjunction:
  • Relative: size.relative (set Relative property)
  • Width: size.w
  • Height: size.h
Method: DGSElement:setSize(...)
Variable: .size
Counterpart: dgsGetSize

Required Arguments

  • dgsElement: the DGS element whose visibility is to be changed
  • width: The desired width setting for the dgs element
  • height: The desired height setting for the dgs element
  • relative: This is whether sizes and positioning are relative. If this is true, then all x,y,width,height floats must be between 0 and 1, representing sizes relative to the parent.

Returns

Returns true if the dgs element's size was set successfully, false otherwise.

Example

This example creates a dgs window and changes the x and y width of the window every 2 seconds.

DGS = exports.dgs
function changeWindowSize ( )
	--Called by the timer every 2 seconds. It decides an x and y width randomly between .1 and .5
	DGS:dgsSetSize ( myWindow, ( math.random( 10, 50 ) / 100 ), ( math.random( 10, 50 ) / 100 ), true )
end

--Create a dgs window called 'myWindow'
myWindow = DGS:dgsCreateWindow ( 0.3, 0.3, 0.5, 0.60, "DGS window title", true )
--Set a timer to change the window's size every 2 seconds, infinite times
setTimer ( changeWindowSize, 2000, 0 )

See Also

General Functions

General Events