HU/dxDrawText: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{Client function hu}}  
{{Client function hu}}  
Draws a string of text on the screen for one frame. In order for the text to stay visible continuously, you need to call this function with the same parameters on each frame update (see [[onClientRender]]).
Kirajzol egy szöveget a képernyőre egy képkocka erejéig. Annak érdekében, hogy a szöveg folyamatosan látható maradjon, megkell hívnia ezt a függvényt ugyanazokkal a paraméterekkel minden egyes képfrissítésnél (lásd [[onClientRender]]).


==Szintaxis==
==Szintaxis==
Line 12: Line 12:


===Kötelező paraméterek===  
===Kötelező paraméterek===  
*'''text:''' the text to draw
*'''text:''' a rajzolni kívánt szöveg
*'''left:''' the absolute X coordinate of the top left corner of the text
*'''left:''' a szöveg bal felső sarkának abszolút X koordinátája
*'''top:''' the absolute Y coordinate of the top left corner of the text
*'''top:''' a szöveg bal felső sarkának abszolút Y koordinátája


===Tetszőleges paraméterek===
===Tetszőleges paraméterek===
*'''right:''' the absolute X coordinate of the right side of the text bounding box. Used for text aligning, clipping and word breaking.
*'''right:''' a szövegdoboz jobb oldalának abszolút X koordinátája. Szöveges igazításhoz, vágáshoz és sortöréshéhez használatos.
*'''bottom:''' the absolute Y coordinate of the bottom side of the text bounding box. Used for text aligning, clipping and word breaking.
*'''bottom:''' a szövegdoboz alsó oldalának abszolút Y koordináta. Szöveges igazításhoz, vágáshoz és sortöréshéhez használatos.
*'''color:''' the color of the text, a value produced by [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).
*'''color:''' a szöveg színe, az értéket megadhatja [[tocolor]] vagy 0xAARRGGBB használatával (AA = átlátszóság, RR = red, GG = green, BB = blue).
*'''scale:''' the size of the text.{{New feature|3.0110|1.1|'''scale:''' can (optionally) be specified as two floats. i.e. '''scaleX, scaleY'''}}
*'''scale:''' a szöveg mérete, {{New feature|3.0110|1.1|'''scale:''' (tetszőlegesen) megadható két float értékként is, azaz. '''scaleX, scaleY'''}}
*'''font:''' Either a custom [[DX font]] element or the name of a built-in DX font: '''Note: Some fonts are incompatible with certain languages such as Arabic.'''
*'''font:''' vagy egy egyedi [[DX font]] elem, vagy egy beépített DX betűtípus neve: '''Figyelem: Bizonyos betűtípusok nem kompatibilisek bizonyos nyelvekkel, mint például az arab.'''
{{DxFonts}}
{{DxFonts}}
*'''alignX:''' horizontal alignment of the text within the bounding box. Can be '''"left"''', '''"center"''' or '''"right"'''.
*'''alignX:''' a szöveg vízszintes igazítása a dobozon belül. Ez lehet '''"left"''', '''"center"''' vagy '''"right"'''.
*'''alignY:''' vertical alignment of the text within the bounding box. Can be '''"top"''', '''"center"''' or '''"bottom"'''.
*'''alignY:''' a szöveg függőleges igazítása a dobozon belül. Ez lehet '''"top"''', '''"center"''' vagy '''"bottom"'''.
*'''clip:''' if set to ''true'', the parts of the text that don't fit within the bounding box will be cut off.
*'''clip:''' ha ez ''true''-ra van állítva, akkor az a szövegrész, ami nem fér bele a dobozba le lesz vágva.
*'''wordBreak:''' if set to ''true'', the text will wrap to a new line whenever it reaches the right side of the bounding box. If ''false'', the text will always be completely on one line.
*'''wordBreak:''' ha ez ''true''-ra van állítva, akkor a szöveg egy új sorba kerül, amikor eléri a doboz jobb oldalát. Ha ez ''false'', akkor a szöveg mindig az adott sorban marad.
* '''postGUI:''' A bool representing whether the text should be drawn on top of or behind any ingame GUI (rendered by CEGUI).
* '''postGUI:''' egy igaz/hamis érték mutatja, hogy a szöveget a GUI kép elé, vagy mögé rajzolja-e ki (CEGUI által kirajzolt).
{{New feature/item|3.0130|1.3.0|3986|
{{New feature/item|3.0130|1.3.0|3986|
*'''colorCoded:''' Set to true to enable embedded #FFFFFF color codes. '''Note: clip and wordBreak are forced false if this is set.'''
*'''colorCoded:''' állítsa be a true-ra a beágyazott #FFFFFF színkódok engedélyezéséhez. '''Figyelem: a clip és a wordBreak false-ra vált, ha ez true-ra van állítva.'''
*'''subPixelPositioning:''' A bool representing whether the text can be positioned sub-pixel-ly. Looks nicer for moving/scaling animations.
*'''subPixelPositioning:''' a bool representing whether the text can be positioned sub-pixel-ly. Looks nicer for moving/scaling animations.
}}
}}
{{New feature/item|3.0135|1.3.5|6054|
{{New feature/item|3.0135|1.3.5|6054|
Line 39: Line 39:


===Visszatérési érték===
===Visszatérési érték===
Returns ''true'' if successful, ''false'' otherwise.
Visszatérési értéke ''true'', ha sikeresen ki lett rajzolva, egyébként ''false''.


==Példa==  
==Példa==  
This example code will add the current zone name in the lower left corner of the players' screens.
Ez a példa kiírja az aktuális zóna nevét a játékos képernyőjének a bal alsó sarkában.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
local screenWidth, screenHeight = guiGetScreenSize ( ) -- Get the screen resolution (width and height)
local screenWidth, screenHeight = guiGetScreenSize ( ) -- Get the screen resolution (width and height)
Line 64: Line 64:
</syntaxhighlight>
</syntaxhighlight>


This example shows how to set both horizontal and vertical text size.
Ez a példa megmutatja a vízszintes és a függőleges szövegméret megadását.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
local screenWidth, screenHeight = guiGetScreenSize ( ) -- Get the screen resolution (width and height)
local screenWidth, screenHeight = guiGetScreenSize ( ) -- Get the screen resolution (width and height)
Line 84: Line 84:


[[en:dxDrawText]]
[[en:dxDrawText]]
==Fordította==
'''2018.11.27.''' <font size="3">'''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''</font>

Latest revision as of 10:03, 27 November 2018

Kirajzol egy szöveget a képernyőre egy képkocka erejéig. Annak érdekében, hogy a szöveg folyamatosan látható maradjon, megkell hívnia ezt a függvényt ugyanazokkal a paraméterekkel minden egyes képfrissítésnél (lásd onClientRender).

Szintaxis

bool dxDrawText ( string text, float left, float top [, float right = left, float bottom = top, int color = white, float scaleXY = 1.0 [, float scaleY = 1.0 ],
                  mixed font = "default", string alignX = "left", string alignY = "top", bool clip = false, bool wordBreak = false,
                  bool postGUI = false, bool colorCoded = false, bool subPixelPositioning = false,
                  float fRotation = 0.0, float fRotationCenterX = 0.0, float fRotationCenterY = 0.0 ] )

Kötelező paraméterek

  • text: a rajzolni kívánt szöveg
  • left: a szöveg bal felső sarkának abszolút X koordinátája
  • top: a szöveg bal felső sarkának abszolút Y koordinátája

Tetszőleges paraméterek

  • right: a szövegdoboz jobb oldalának abszolút X koordinátája. Szöveges igazításhoz, vágáshoz és sortöréshéhez használatos.
  • bottom: a szövegdoboz alsó oldalának abszolút Y koordináta. Szöveges igazításhoz, vágáshoz és sortöréshéhez használatos.
  • color: a szöveg színe, az értéket megadhatja tocolor vagy 0xAARRGGBB használatával (AA = átlátszóság, RR = red, GG = green, BB = blue).
  • scale: a szöveg mérete, scale: (tetszőlegesen) megadható két float értékként is, azaz. scaleX, scaleY
  • font: vagy egy egyedi DX font elem, vagy egy beépített DX betűtípus neve: Figyelem: Bizonyos betűtípusok nem kompatibilisek bizonyos nyelvekkel, mint például az arab.
    • "default": Tahoma
    • "default-bold": Tahoma Bold
    • "clear": Verdana
    • "arial": Arial
    • "sans": Microsoft Sans Serif
    • "pricedown": Pricedown (GTA's theme text)
    • "bankgothic": Bank Gothic Medium
    • "diploma": Diploma Regular
    • "beckett": Beckett Regular
    • "unifont": Unifont
  • alignX: a szöveg vízszintes igazítása a dobozon belül. Ez lehet "left", "center" vagy "right".
  • alignY: a szöveg függőleges igazítása a dobozon belül. Ez lehet "top", "center" vagy "bottom".
  • clip: ha ez true-ra van állítva, akkor az a szövegrész, ami nem fér bele a dobozba le lesz vágva.
  • wordBreak: ha ez true-ra van állítva, akkor a szöveg egy új sorba kerül, amikor eléri a doboz jobb oldalát. Ha ez false, akkor a szöveg mindig az adott sorban marad.
  • postGUI: egy igaz/hamis érték mutatja, hogy a szöveget a GUI kép elé, vagy mögé rajzolja-e ki (CEGUI által kirajzolt).
  • colorCoded: állítsa be a true-ra a beágyazott #FFFFFF színkódok engedélyezéséhez. Figyelem: a clip és a wordBreak false-ra vált, ha ez true-ra van állítva.
  • subPixelPositioning: a bool representing whether the text can be positioned sub-pixel-ly. Looks nicer for moving/scaling animations.
  • fRotation: Rotation
  • fRotationCenterX: Rotation Origin X
  • fRotationCenterY: Rotation Origin Y

Visszatérési érték

Visszatérési értéke true, ha sikeresen ki lett rajzolva, egyébként false.

Példa

Ez a példa kiírja az aktuális zóna nevét a játékos képernyőjének a bal alsó sarkában.

local screenWidth, screenHeight = guiGetScreenSize ( ) -- Get the screen resolution (width and height)


function createText ( )
    local playerX, playerY, playerZ = getElementPosition ( localPlayer )       -- Get our player's coordinates.
    local playerZoneName = getZoneName ( playerX, playerY, playerZ )          -- Get name of the zone the player is in.

    -- Draw zone name text's shadow.
    dxDrawText ( playerZoneName, 44, screenHeight - 41, screenWidth, screenHeight, tocolor ( 0, 0, 0, 255 ), 1.02, "pricedown" )
    -- Draw zone name text.
    dxDrawText ( playerZoneName, 44, screenHeight - 43, screenWidth, screenHeight, tocolor ( 255, 255, 255, 255 ), 1, "pricedown" )
end

function HandleTheRendering ( )
    addEventHandler ( "onClientRender", root, createText ) -- keep the text visible with onClientRender.
end

addEventHandler ( "onClientResourceStart", resourceRoot, HandleTheRendering )

Ez a példa megmutatja a vízszintes és a függőleges szövegméret megadását.

local screenWidth, screenHeight = guiGetScreenSize ( ) -- Get the screen resolution (width and height)


function createText ( )
    dxDrawText ( getTickCount(), 44, screenHeight - 43, screenWidth, screenHeight, tocolor ( 255, 255, 255, 255 ), 1, 2, "pricedown" )
end
addEventHandler ( "onClientRender", root, createText )

Changelog

Version Description
1.3.0-9.03986 Added colorCoded and subPixelPositioning arguments
1.3.5-9.06054 Added fRotation, fRotationCenterX and fRotationCenterY arguments

Lásd még

Fordította

2018.11.27. Surge