View source for HU/dxGetTexturePixels

{{Client function hu}}
__NOTOC__
This function fetches the [[Texture_pixels|pixels]] from a [[texture]] element. It can be used with a standard texture, render target or screen source.
{{Important Note_hu|dxGetTexturePixels will not work on a screen source or render target if the player has disabled screen upload.}}
{{Note_hu|
*This function is slow and not something you want to be doing once a frame.
*It is slower when reading pixels from a render target or screen source.
*And is very slow indeed if the texture format is not ''' 'argb' '''.
}}

==Szintaxis== 
<syntaxhighlight lang="lua">
string dxGetTexturePixels ( [ int surfaceIndex = 0, ] element texture [, int x = 0, int y = 0, int width = 0, int height = 0 ] )
</syntaxhighlight> 
{{OOP||[[texture]]:getPixels}}
===Kötelező paraméterek===
*'''texture :''' The texture element to get the pixels from

===Tetszőleges paraméterek===
*'''surfaceIndex:''' Desired slice to get if the texture is a volume texture, or desired face to get if the texture is a cube map. <nowiki>(Cube map faces: 0=+X 1=-X 2=+Y 3=-Y 4=+Z 5=-Z)</nowiki>
By default the pixels from the whole texture is returned. To get only a portion of the texture, define a rectangular area using all four of these optional arguments:
*'''x:''' Rectangle left position
*'''y:''' Rectangle top position
*'''width:''' Rectangle width
*'''height :''' Rectangle height

==Visszatérési érték==
Returns a ''''plain'''' format pixels string if successful, ''false'' if invalid arguments were passed to the function.

==Példa== 
<syntaxhighlight lang="lua">
local mtaLogo = dxCreateTexture("mta-logo.png")
outputChatBox("MTA logo pixels is: "..dxGetTexturePixels(mtaLogo))
</syntaxhighlight>

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.3.0-9.04021|Added surfaceIndex argument}}

==Lásd még==
{{Drawing_functions hu}}

[[en:dxGetTexturePixels]]