HU/dxDrawImageSection

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

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...


[[{{{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 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

Fordította