HU/dxDrawImageSection: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
|||
(11 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
{{Client function hu}} | {{Client function hu}} | ||
A [[dxDrawImage]]-tól eltérően ez a function csak a kép egy részét rajzolja ki a képernyőre. Annak érdekében, hogy a kép folyamatosan látható maradjon, ezt a function-t minden képfrissítésnél ugyan azokkal a paraméterekkel kell meghívni (lásd [[onClientRender]]). | |||
Jobb esetben a képek dimenziója a 2 négyzete, ez azért fontos, hogy elkerüljük a lehetséges elmosodását a képnek.<br/> | Jobb esetben a képek dimenziója a 2 négyzete, ez azért fontos, hogy elkerüljük a lehetséges elmosodását a képnek.<br/> | ||
Line 18: | Line 18: | ||
===Kötelező paraméterek=== | ===Kötelező paraméterek=== | ||
*'''posX:''' A kép abszolút pozíciója a képernyő bal | *'''posX:''' A kép abszolút X pozíciója a képernyő bal szélétől számolva. | ||
*'''posY:''' A kép abszolút pozíciója a képernyő | *'''posY:''' A kép abszolút Y pozíciója a képernyő bal szélétől számolva. | ||
*'''width:''' | *'''width:''' A kép abszolút szélessége | ||
*'''height:''' | *'''height:''' A kép abszolút magassága | ||
*'''u:''' | *'''u:''' A képből kirjazolt rész abszolút X kordinátája a képernyő felső sarkából számolva | ||
*'''v:''' | *'''v:''' A képből kirjazolt rész abszolút Y kordinátája a képernyő felső sarkából számolva | ||
*'''usize:''' | *'''usize:''' A kép részének az abszolút szélessége | ||
*'''vsize:''' | *'''vsize:''' A kép részének az abszolút magassága | ||
*'''image:''' Either a [[material]] element or a [[filepath]] of the image which is going to be drawn. (.dds images are also supported). Image files should ideally have dimensions that are a power of two, to prevent possible blurring. Use a texture created with [[dxCreateTexture]] to '''speed up drawing'''. | *'''image:''' Either a [[material]] element or a [[filepath]] of the image which is going to be drawn. (.dds images are also supported). Image files should ideally have dimensions that are a power of two, to prevent possible blurring. Use a texture created with [[dxCreateTexture]] to '''speed up drawing'''. | ||
Line 32: | Line 32: | ||
*'''rotationCenterOffsetX:''' Az abszolút X offset a kép közepétől számolva. | *'''rotationCenterOffsetX:''' Az abszolút X offset a kép közepétől számolva. | ||
*'''rotationCenterOffsetY:''' Az abszolút Y offset a kép közepétől számolva. | *'''rotationCenterOffsetY:''' Az abszolút Y offset a kép közepétől számolva. | ||
*'''color:''' | *'''color:''' A kép színe, [[tocolor]] által előállított érték, vagy hexadecimális szám: 0xAARRGGBB (AA = átlátszóság, RR = piros, GG = zöld, BB = kék). | ||
*'''postgui :''' | *'''postgui :''' Egy igaz/hamis érték, mely azt képviseli, hogy a vonal bármelyik ingame GUI mögött, vagy fölött legyen-e (CEGUI által rajzolt). | ||
===Visszatérési érték=== | ===Visszatérési érték=== | ||
'' | Visszatérési értéke ''true'', ha sikerült, egyébként ''false''. | ||
==Példa== | ==Példa== | ||
Ez a példa kirajzolja a kép egy részét. (Használhatja [http://i1325.photobucket.com/albums/u630/Tourmalinelisa2/128x128.jpg ezt] a képet a teszteléshez.) | |||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
addEventHandler('onClientRender', root, function() | addEventHandler('onClientRender', root, function() |
Latest revision as of 17:21, 23 October 2018
A dxDrawImage-tól eltérően ez a function csak a kép egy részét rajzolja ki a képernyőre. Annak érdekében, hogy a kép folyamatosan látható maradjon, ezt a function-t minden képfrissítésnél ugyan azokkal a paraméterekkel kell meghívni (lásd onClientRender).
Jobb esetben a képek dimenziója a 2 négyzete, ez azért fontos, hogy elkerüljük a lehetséges elmosodását a képnek.
A kettő négyzetei: 2px, 4px, 8px, 16px, 32px, 64px, 128px, 256px, 512px, 1024px, stb...
Tipp: Használd a(z) dxCreateTexture által létrehozott textúrákat, hogy felgyorsítsd a rajzolását a képnek. |
Tipp: Ahhoz, hogy megelőzd a kép sarkainak hibáját amikor felrajzolsz egy képet, tedd a(z) textureEdge-et "clamp"-ra, amikor meghívod a dxCreateTexture funkciót. |
Szintaxis
bool dxDrawImageSection ( float posX, float posY, float width, float height, float u, float v, float usize, float vsize, mixed image, [ float rotation = 0, float rotationCenterOffsetX = 0, float rotationCenterOffsetY = 0, int color = white, bool postGUI = false ] )
Kötelező paraméterek
- posX: A kép abszolút X pozíciója a képernyő bal szélétől számolva.
- posY: A kép abszolút Y pozíciója a képernyő bal szélétől számolva.
- width: A kép abszolút szélessége
- height: A kép abszolút magassága
- u: A képből kirjazolt rész abszolút X kordinátája a képernyő felső sarkából számolva
- v: A képből kirjazolt rész abszolút Y kordinátája a képernyő felső sarkából számolva
- usize: A kép részének az abszolút szélessége
- vsize: A kép részének az abszolút magassága
- image: Either a material element or a filepath of the image which is going to be drawn. (.dds images are also supported). Image files should ideally have dimensions that are a power of two, to prevent possible blurring. Use a texture created with dxCreateTexture to speed up drawing.
Tetszőleges paraméterek
- rotation: A kép tengelyforgása fokokban mérve.
- rotationCenterOffsetX: Az abszolút X offset a kép közepétől számolva.
- rotationCenterOffsetY: Az abszolút Y offset a kép közepétől számolva.
- color: A kép színe, tocolor által előállított érték, vagy hexadecimális szám: 0xAARRGGBB (AA = átlátszóság, RR = piros, GG = zöld, BB = kék).
- postgui : Egy igaz/hamis érték, mely azt képviseli, hogy a vonal bármelyik ingame GUI mögött, vagy fölött legyen-e (CEGUI által rajzolt).
Visszatérési érték
Visszatérési értéke true, ha sikerült, egyébként false.
Példa
Ez a példa kirajzolja a kép egy részét. (Használhatja ezt a képet a teszteléshez.)
addEventHandler('onClientRender', root, function() dxDrawImageSection(400, 200, 64, 64, 0, 0, 64, 64, 'img.jpg') -- Draw a certain section dxDrawImage(400, 300, 128, 128, 'img.jpg') -- Draw the whole image to be able to identify the difference end)
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