HU/dxDrawImageSection: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with "__NOTOC__ {{Client function hu}} Differing from dxDrawImage, this function only draws a part of an image on the screen for a single frame. In order for the image to stay...")
 
No edit summary
Line 3: Line 3:
Differing from [[dxDrawImage]], this function only draws a part of an image on the screen for a single frame. In order for the image to stay visible continuously, you need to call this function with the same parameters on each frame update (see [[onClientRender]]).
Differing from [[dxDrawImage]], this function only draws a part of an image on the screen for a single frame. In order for the image to stay visible continuously, you need to call this function with the same parameters on each frame update (see [[onClientRender]]).


Image files should ideally have dimensions that are a power of two, to prevent possible blurring.<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/>
<b>Power of two: 2px, 4px, 8px, 16px, 32px, 64px, 128px, 256px, 512px, 1024px...</b>
<b>A kettő négyzetei: 2px, 4px, 8px, 16px, 32px, 64px, 128px, 256px, 512px, 1024px, stb...</b>  


{{Tip_hu|Use a texture created with [[dxCreateTexture]] to '''speed up drawing'''.}}
{{Tip_hu|Használd a(z) [[dxCreateTexture]] által létrehozott textúrákat, hogy '''felgyorsítsd a rajzolás'''át a képnek.}}
{{Tip_hu|To help prevent edge artifacts when drawing textures, set '''textureEdge''' to '''"clamp"''' when calling [[dxCreateTexture]]}}
{{Tip_hu|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==
==Szintaxis==
Line 18: Line 18:


===Kötelező paraméterek===
===Kötelező paraméterek===
*'''posX:''' the absolute X coordinate of the top left corner of the image
*'''posX:''' A kép abszolút pozíciója a képernyő bal szélső oldalától számolva.
*'''posY:''' the absolute Y coordinate of the top left corner of the image
*'''posY:''' A kép abszolút pozíciója a képernyő tetejétől számolva.
*'''width:''' the absolute width of the image
*'''width:''' Az abszolút képszélesség
*'''height:''' the absolute height of the image
*'''height:''' Az magasság képszélesség
*'''u:''' the absolute X coordinate of the top left corner of the section which should be drawn from image
*'''u:''' the absolute X coordinate of the top left corner of the section which should be drawn from image
*'''v:''' the absolute Y coordinate of the top left corner of the section which should be drawn from image
*'''v:''' the absolute Y coordinate of the top left corner of the section which should be drawn from image
Line 29: Line 29:


===Tetszőleges paraméterek===
===Tetszőleges paraméterek===
*'''rotation:''' the rotation, in degrees for the image.
*'''rotation:''' A kép tengelyforgása fokokban mérve.
*'''rotationCenterOffsetX:''' the absolute X offset from the image center for which to rotate the image from.
*'''rotationCenterOffsetX:''' Az abszolút X offset a kép közepétől számolva.
*'''rotationCenterOffsetY:''' the absolute Y offset from the image center for which to rotate the image from.
*'''rotationCenterOffsetY:''' Az abszolút Y offset a kép közepétől számolva.
*'''color:''' the color of the image, a value produced by [[tocolor]] or hexadecimal number in format: 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).
*'''color:''' the color of the image, a value produced by [[tocolor]] or hexadecimal number in format: 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).
*'''postgui :''' A bool representing whether the image should be drawn on top of or behind any ingame GUI (rendered by CEGUI).
*'''postgui :''' A bool representing whether the image should be drawn on top of or behind any ingame GUI (rendered by CEGUI).


===Visszatérési érték===
===Visszatérési érték===
Returns ''true'' if successful, ''false'' otherwise.
''True''-t ad vissza ha sikerült, egyébként ''false''.


==Példa==  
==Példa==  
Line 51: Line 51:


[[en:dxDrawImageSection]]
[[en:dxDrawImageSection]]
==Fordította==
* '''''[https://wiki.multitheftauto.com/wiki/User:Surge Surge]'''''

Revision as of 12:52, 23 October 2018

Differing from dxDrawImage, this function only draws a part of an image on the screen for a single frame. In order for the image to stay visible continuously, you need to call this function with the same parameters on each frame update (see 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...


[[{{{image}}}|link=|]] Tipp: Használd a(z) dxCreateTexture által létrehozott textúrákat, hogy felgyorsítsd a rajzolását a képnek.
[[{{{image}}}|link=|]] 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 pozíciója a képernyő bal szélső oldalától számolva.
  • posY: A kép abszolút pozíciója a képernyő tetejétől számolva.
  • width: Az abszolút képszélesség
  • height: Az magasság képszélesség
  • u: the absolute X coordinate of the top left corner of the section which should be drawn from image
  • v: the absolute Y coordinate of the top left corner of the section which should be drawn from image
  • usize: the absolute width of the image section
  • vsize: the absolute height of the image section
  • 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: the color of the image, a value produced by tocolor or hexadecimal number in format: 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).
  • postgui : A bool representing whether the image should be drawn on top of or behind any ingame GUI (rendered by CEGUI).

Visszatérési érték

True-t ad vissza ha sikerült, egyébként false.

Példa

The example draws a section of an image. (You can use this image to test.)

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

Fordította