HU/dxDrawText
From Multi Theft Auto: Wiki
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
- 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
- HU/dxConvertPixels
- HU/dxCreateFont
- HU/dxCreateRenderTarget
- HU/dxCreateScreenSource
- HU/dxCreateShader
- HU/dxCreateTexture
- HU/dxDrawCircle
- HU/dxDrawImage
- HU/dxDrawImageSection
- HU/dxDrawLine
- HU/dxDrawLine3D
- HU/dxDrawMaterialLine3D
- HU/dxDrawMaterialPrimitive
- HU/dxDrawPrimitive
- HU/dxDrawMaterialSectionLine3D
- HU/dxDrawRectangle
- HU/dxDrawText
- HU/dxGetBlendMode
- HU/dxGetFontHeight
- HU/dxGetMaterialSize
- HU/dxGetPixelColor
- HU/dxGetPixelsSize
- HU/dxGetPixelsFormat
- HU/dxGetStatus
- HU/dxGetTextWidth
- HU/dxGetTexturePixels
- HU/dxSetAspectRatioAdjustmentEnabled
- HU/dxSetBlendMode
- HU/dxSetPixelColor
- HU/dxSetRenderTarget
- HU/dxSetShaderValue
- HU/dxSetShaderTessellation
- HU/dxSetShaderTransform
- HU/dxSetTestMode
- HU/dxSetTextureEdge
- HU/dxSetTexturePixels
- HU/dxUpdateScreenSource
Fordította
2018.11.27. Surge