Dgs-dxwindow: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
 
(14 intermediate revisions by 2 users not shown)
Line 8: Line 8:


==Properties==
==Properties==
===image===
===alignment===
The texture element(texture/render target/screen source/shader etc) of the background of the window.
Alignment of the title text of the window.
<syntaxhighlight lang="lua">dgsSetProperty(window,"image",image)</syntaxhighlight>
*'''image:''' A texture element of the background of the window.


===color===
The functions as follows are based on this property.
The color which can be translated by [[tocolor]] of the background of the window.
<syntaxhighlight lang="lua">dgsSetProperty(window,"color",color)</syntaxhighlight>
*'''color:''' An integer of the color of the background of the window.


===textColor===
[[dgsWindowSetHorizontalAlign]]/[[dgsWindowGetHorizontalAlign]]
The color which can be translated by [[tocolor]] of the title text of the window.
<syntaxhighlight lang="lua">dgsSetProperty(window,"textColor",textColor)</syntaxhighlight>
*'''textColor:''' An integer of the color of the title text of the window.


===titleColorBlur===
[[dgsWindowSetVerticalAlign]]/[[dgsWindowGetVerticalAlign]]
The color which can be translated by [[tocolor]] of the title of the window when the window is blurred.
<syntaxhighlight lang="lua">dgsSetProperty(window,"alignment",{alignX,alignY})</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(window,"titleColorBlur",titleColorBlur)</syntaxhighlight>
*'''alignX:''' Horizontal alignment of the title text of the windowl. Can be "left", "center" or "right".
*'''titleColorBlur:''' An integer of the color of the title of the blurred window.
*'''alignY:''' Vertical alignment of the title text of the window. Can be "top", "center" or "bottom".


===titleColor===
===borderSize===
The color which can be translated by [[tocolor]] of the title of the window when the window is focused.
This property determines the border size in pixels which is used to resize the window.
<syntaxhighlight lang="lua">dgsSetProperty(window,"titleColor",titleColor)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(window,"borderSize",borderSize)</syntaxhighlight>
*'''titleColor:''' An integer of the color of the title of the focused window.
*'''borderSize:''' An integer of the size of the border of the window in pixels.
 
===titleImage===
The texture element(texture/render target/screen source/shader etc) of the title background of the window.
<syntaxhighlight lang="lua">dgsSetProperty(window,"titleImage",titleImage)</syntaxhighlight>
*'''titleImage:''' A texture element of the title background of the window.


===text===
===closeButtonEnabled===
This is equivalent to [[dgsSetText]]/[[dgsGetText]].
This property determines whether the close button of window is enabled or not.
<syntaxhighlight lang="lua">dgsSetProperty(window,"text",text)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(window,"closeButtonEnabled",closeButtonEnabled)</syntaxhighlight>
*'''text:''' A string of the title text of the window.
*'''closeButtonEnabled:''' A bool of whether close button is enabled or not.


===textColor===
===color===
The color which can be translated by [[tocolor]] of the text of the window.
The color which can be translated by [[tocolor]] of the background of the window.
<syntaxhighlight lang="lua">dgsSetProperty(window,"textColor",textColor)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(window,"color",color)</syntaxhighlight>
*'''textColor:''' An integer of the color of the title text of the window.
*'''color:''' An integer of the color of the background of the window.


===textSize===
===colorCoded===
The scale of the text of the window. ''Learn More [[dxDrawText]]''
Whether the color code in the title text is enabled or not. ''Learn More [[dxDrawText]]''
<syntaxhighlight lang="lua">dgsSetProperty(window,"textSize",{scaleX,scaleY})</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(window,"colorCoded",colorCoded)</syntaxhighlight>
*'''scaleX:''' A float of the 2D X scale of the title text of the window.
*'''colorCoded:''' Set to true to enable embedded #FFFFFF color codes.
*'''scaleY:''' A float of the 2D Y scale of the title text of the window.


===font===
===font===
Line 59: Line 45:
*'''font:''' A [[Element/DX_font|dx font element]] of the title text font of the window.
*'''font:''' A [[Element/DX_font|dx font element]] of the title text font of the window.


===colorcoded===
===ignoreTitle===
Whether the color code in the title text is enabled or not. ''Learn More [[dxDrawText]]''
This property determines whether to ignore the window title when calculating window's child elements (useful for gui to dgs).
<syntaxhighlight lang="lua">dgsSetProperty(window,"colorcoded",colorcoded)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(window,"ignoreTitle",ignoreTitle)</syntaxhighlight>
*'''colorcoded:''' Set to true to enable embedded #FFFFFF color codes.
*'''ignoreTitle:''' A bool of the state of whether to ignore the window title.
 
===image===
The texture element(texture/render target/screen source/shader etc) of the background of the window.
<syntaxhighlight lang="lua">dgsSetProperty(window,"image",image)</syntaxhighlight>
*'''image:''' A texture element of the background of the window.
 
===maxSize===
This property determines the maximum width and height of the window that users can resize to.
<syntaxhighlight lang="lua">dgsSetProperty(window,"maxSize",{maxWidth,maxHeight})</syntaxhighlight>
*'''maxWidth:''' An integer of the maximum width of the window.
*'''maxHeight:''' An integer of the maximum height of the window.


===movetyp===
===minSize===
This property determines the moving type of the window.
This property determines the minimum width and height of the window that users can resize to.
<syntaxhighlight lang="lua">dgsSetProperty(window,"movetyp",movetyp)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(window,"minSize",{minWidth,minHeight})</syntaxhighlight>
*'''movetyp:''' A boolean value indicating the state of the moving type.
*'''minWidth:''' An integer of the minimum width of the window.
**'''true:''' User can move the window by clicking anywhere of the window.
*'''minHeight:''' An integer of the minimum height of the window.
**'''false:''' User can move the window by only clicking the title of the window.


===movable===
===movable===
Line 81: Line 77:
*'''movable:''' A boolean value indicating whether user can resize the window or not.
*'''movable:''' A boolean value indicating whether user can resize the window or not.


===minSize===
===text===
This property determines the minimum width and height of the window that users can resize to.
This is equivalent to [[dgsSetText]]/[[dgsGetText]].
<syntaxhighlight lang="lua">dgsSetProperty(window,"minSize",{minWidth,minHeight})</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(window,"text",text)</syntaxhighlight>
*'''minWidth:''' An integer of the minimum width of the window.
*'''text:''' A string of the title text of the window.
*'''minHeight:''' An integer of the minimum height of the window.
 
===textColor===
The color which can be translated by [[tocolor]] of the title text of the window.
<syntaxhighlight lang="lua">dgsSetProperty(window,"textColor",textColor)</syntaxhighlight>
*'''textColor:''' An integer of the color of the title text of the window.
 
===textOffset===
The offset of the title text of window.
<syntaxhighlight lang="lua">dgsSetProperty(window,"textOffset",{offsetX,offsetY,relative})</syntaxhighlight>
*'''offsetX''' : A float of the 2D X offset relative to the position of the text of window, depends on '''relative'''.
*'''offsetY''' : A float of the 2D Y offset relative to the position of the text of window, depends on '''relative'''.
*'''relative''' : A bool of whether the offset is relative or absolute.
 
===textSize===
The scale of the '''title''' ''text'' of the window. ''Learn More [[dxDrawText]]''
<syntaxhighlight lang="lua">dgsSetProperty(window,"textSize",{scaleX,scaleY})</syntaxhighlight>
*'''scaleX:''' A float of the 2D X scale of the title text of the window.
*'''scaleY:''' A float of the 2D Y scale of the title text of the window.


===maxSize===
===titleColor===
This property determines the maximum width and height of the window that users can resize to.
The color which can be translated by [[tocolor]] of the '''title''' of the window when the window is '''focused''' ( For '''blurred''', see [[#titleColorBlur|titleColorBlur]] ).
<syntaxhighlight lang="lua">dgsSetProperty(window,"maxSize",{maxWidth,maxHeight})</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(window,"titleColor",titleColor)</syntaxhighlight>
*'''maxWidth:''' An integer of the maximum width of the window.
*'''titleColor:''' An integer of the color of the title of the focused window.
*'''maxHeight:''' An integer of the maximum height of the window.


===borderSize===
===titleColorBlur===
This property determines the border size in pixels which is used to resize the window.
The color which can be translated by [[tocolor]] of the title of the window when the window is '''blurred'''.
<syntaxhighlight lang="lua">dgsSetProperty(window,"borderSize",borderSize)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(window,"titleColorBlur",titleColorBlur)</syntaxhighlight>
*'''borderSize:''' An integer of the size of the border of the window in pixels.
*'''titleColorBlur:''' An integer of the color of the title of the blurred window. Set to ''nil'' to disable blur color.


===titleHeight===
===titleHeight===
Line 103: Line 115:
*'''titleHeight:''' An integer of the size of the title of the window in pixels.
*'''titleHeight:''' An integer of the size of the title of the window in pixels.


===ignoreTitleSize===
===titleImage===
This property determines whether to ignore the window title when calculating window's child elements (useful for gui to dgs).
The texture element(texture/render target/screen source/shader etc) of the title background of the window.
<syntaxhighlight lang="lua">dgsSetProperty(window,"ignoreTitleSize",ignoreTitleSize)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(window,"titleImage",titleImage)</syntaxhighlight>
*'''ignoreTitleSize:''' A bool of the state of whether to ignore the window title.
*'''titleImage:''' A texture element of the title background of the window.


==See Also==
==See Also==
{{DGSPROPERTIES}}
{{DGSPROPERTIES}}

Latest revision as of 12:01, 11 April 2022

DGS Properties is always used to change the gui style and make it more fantastic.

This page shows the properties of dgs-dxwindow that you could use.

Main Functions

Properties

alignment

Alignment of the title text of the window.

The functions as follows are based on this property.

dgsWindowSetHorizontalAlign/dgsWindowGetHorizontalAlign

dgsWindowSetVerticalAlign/dgsWindowGetVerticalAlign

dgsSetProperty(window,"alignment",{alignX,alignY})
  • alignX: Horizontal alignment of the title text of the windowl. Can be "left", "center" or "right".
  • alignY: Vertical alignment of the title text of the window. Can be "top", "center" or "bottom".

borderSize

This property determines the border size in pixels which is used to resize the window.

dgsSetProperty(window,"borderSize",borderSize)
  • borderSize: An integer of the size of the border of the window in pixels.

closeButtonEnabled

This property determines whether the close button of window is enabled or not.

dgsSetProperty(window,"closeButtonEnabled",closeButtonEnabled)
  • closeButtonEnabled: A bool of whether close button is enabled or not.

color

The color which can be translated by tocolor of the background of the window.

dgsSetProperty(window,"color",color)
  • color: An integer of the color of the background of the window.

colorCoded

Whether the color code in the title text is enabled or not. Learn More dxDrawText

dgsSetProperty(window,"colorCoded",colorCoded)
  • colorCoded: Set to true to enable embedded #FFFFFF color codes.

font

This is equivalent to dgsSetFont/dgsGetFont. Learn More dxDrawText

dgsSetProperty(window,"font",font)

ignoreTitle

This property determines whether to ignore the window title when calculating window's child elements (useful for gui to dgs).

dgsSetProperty(window,"ignoreTitle",ignoreTitle)
  • ignoreTitle: A bool of the state of whether to ignore the window title.

image

The texture element(texture/render target/screen source/shader etc) of the background of the window.

dgsSetProperty(window,"image",image)
  • image: A texture element of the background of the window.

maxSize

This property determines the maximum width and height of the window that users can resize to.

dgsSetProperty(window,"maxSize",{maxWidth,maxHeight})
  • maxWidth: An integer of the maximum width of the window.
  • maxHeight: An integer of the maximum height of the window.

minSize

This property determines the minimum width and height of the window that users can resize to.

dgsSetProperty(window,"minSize",{minWidth,minHeight})
  • minWidth: An integer of the minimum width of the window.
  • minHeight: An integer of the minimum height of the window.

movable

This is equivalent to dgsWindowSetMovable, which allows you to specify whether or not a user can move a DGS window.

dgsSetProperty(window,"movable",movable)
  • movable: A boolean value indicating whether user can move the window or not.

sizable

This is equivalent to dgsWindowSetSizable, which allows you to specify whether or not a user can resize a DGS window.

dgsSetProperty(window,"sizable",sizable)
  • movable: A boolean value indicating whether user can resize the window or not.

text

This is equivalent to dgsSetText/dgsGetText.

dgsSetProperty(window,"text",text)
  • text: A string of the title text of the window.

textColor

The color which can be translated by tocolor of the title text of the window.

dgsSetProperty(window,"textColor",textColor)
  • textColor: An integer of the color of the title text of the window.

textOffset

The offset of the title text of window.

dgsSetProperty(window,"textOffset",{offsetX,offsetY,relative})
  • offsetX : A float of the 2D X offset relative to the position of the text of window, depends on relative.
  • offsetY : A float of the 2D Y offset relative to the position of the text of window, depends on relative.
  • relative : A bool of whether the offset is relative or absolute.

textSize

The scale of the title text of the window. Learn More dxDrawText

dgsSetProperty(window,"textSize",{scaleX,scaleY})
  • scaleX: A float of the 2D X scale of the title text of the window.
  • scaleY: A float of the 2D Y scale of the title text of the window.

titleColor

The color which can be translated by tocolor of the title of the window when the window is focused ( For blurred, see titleColorBlur ).

dgsSetProperty(window,"titleColor",titleColor)
  • titleColor: An integer of the color of the title of the focused window.

titleColorBlur

The color which can be translated by tocolor of the title of the window when the window is blurred.

dgsSetProperty(window,"titleColorBlur",titleColorBlur)
  • titleColorBlur: An integer of the color of the title of the blurred window. Set to nil to disable blur color.

titleHeight

This property determines the title size in pixels which is also used to move the window.

dgsSetProperty(window,"titleHeight",titleHeight)
  • titleHeight: An integer of the size of the title of the window in pixels.

titleImage

The texture element(texture/render target/screen source/shader etc) of the title background of the window.

dgsSetProperty(window,"titleImage",titleImage)
  • titleImage: A texture element of the title background of the window.

See Also

General Properties

Unique Properties For DGS Core Elements

Extra Properties For DGS Plugins