DxSetAspectRatioAdjustmentEnabled: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 26: Line 26:
==Example==
==Example==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
addEventHandler("onClientRender",root,
scx,scy = guiGetScreenSize()
 
addEventHandler( "onClientRender", root,
     function()
     function()
         dxDrawText("Hello", 100, 100 )            -- Text will be drawn at 100,100
         dxDrawText( "Hello", 300, 300 )            -- Text will be drawn at 300,300
         dxSetAspectRatioAdjustmentEnabled( true )
         dxSetAspectRatioAdjustmentEnabled( true )
         dxDrawText("Goodbye", 100, 100 )           -- Text will be drawn at some adjusted position
         dxDrawText( "Goodbye", 0.78*scx, 0.22*scy ) -- Text will be drawn just below HUD money, with any aspect ratio
     end
     end
)
)

Revision as of 20:45, 26 June 2013

This function is used to aligning the output of dxDraw calls with GTA HUD components. It can only be called during these events: onClientRender, onClientPreRender and onClientHUDRender, and is automatically disabled when these events return. So the function has to be called every frame, just like dxDraws.

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. For more information on optional arguments, see optional arguments.

  • sourceRatio : This should be set to the aspect ratio the dxDraw were originally designed in.

Returns

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

Requirements

This template will be deleted.

Example

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