dxSetAspectRatioAdjustmentEnabled | Multi Theft Auto: Wiki Skip to content
Multi Theft Auto: Wiki

dxSetAspectRatioAdjustmentEnabled

Client-side
Server-side
Shared

Pair: dxIsAspectRatioAdjustmentEnabled

This function allows for the positioning of dxDraw calls to be automatically adjusted according to the client's aspect ratio setting. This lasts for a single execution of an event handler for one of the following events: onClientRender, onClientPreRender and onClientHUDRender. So the function has to be called every frame, just like dxDraws.

This is particularly useful for draws that must align with the GTA HUD, for which the sizing and positioning can vary for different aspect ratios.

Syntax 

​bool dxSetAspectRatioAdjustmentEnabled ( ​bool bEnabled, [ ​float sourceRatio = 4/3 ] )
Required Arguments
  • bEnabled: Should the adjustment be enabled or disabled.
Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use.

  • sourceRatio (default: 4/3): This should be set to the aspect ratio the dxDraws were originally designed in.

Returns

  • bool: result

Returns true when it was changed successfully, or false otherwise.

Code Examples

client 
local scx, scy = guiGetScreenSize()


addEventHandler("onClientRender", root, function()
    dxDrawText("Hello", 300, 300) -- Text will be drawn at 300,300
    dxSetAspectRatioAdjustmentEnabled(true)
    dxDrawText("Goodbye", 0.78 * scx, 0.22 * scy) -- Text will be drawn just below HUD money, with any aspect ratio
end)

See Also

Drawing Functions
Drawing Elements
Reference