HU/dxGetTexturePixels: Difference between revisions

Latest revision as of 17:16, 7 November 2024

This function fetches the pixels from a texture element. It can be used with a standard texture, render target or screen source.

[[{{{image}}}\|link=\|]]	Fontos megjegyzés: dxGetTexturePixels will not work on a screen source or render target if the player has disabled screen upload.

[[{{{image}}}\|link=\|]]	Megjegyzés: 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

string dxGetTexturePixels ( [ int surfaceIndex = 0, ] element texture [, int x = 0, int y = 0, int width = 0, int height = 0 ] )

OOP Syntax Help! I don't understand this!

Method: 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. (Cube map faces: 0=+X 1=-X 2=+Y 3=-Y 4=+Z 5=-Z)

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

local mtaLogo = dxCreateTexture("mta-logo.png")
outputChatBox("MTA logo pixels is: "..dxGetTexturePixels(mtaLogo))

Changelog

Version	Description

1.3.0-9.04021

Added surfaceIndex argument

Lásd még

@@ Line 33: / Line 33: @@
 outputChatBox("MTA logo pixels is: "..dxGetTexturePixels(mtaLogo))
 </syntaxhighlight>
-==Requirements==
-{{Requirements|n/a|1.3|}}
 ==Changelog==