DxGetPixelColor: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
 
(8 intermediate revisions by 4 users not shown)
Line 5: Line 5:
==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
int r,g,b,a dxGetPixelColor( string pixels, int x, int y )
int, int, int, int dxGetPixelColor( string pixels, int x, int y )
</syntaxhighlight>  
</syntaxhighlight>  


Line 14: Line 14:


==Returns==
==Returns==
Returns the color of pixel if successful, or ''false'' if invalid arguments were passed to the function.
Returns 4 ''int''s representing the rgba color value of the pixel if succesful, or ''false'' if invalid arguments were passed to the function.


==Example==  
==Example==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
TODO
local texture = dxCreateTexture(4,4)        --Create a texture
local pixel = dxGetTexturePixels(texture)  --Get pixel element
local sx,sy = dxGetPixelsSize(pixel)            --Get pixel size
local tab = {}                                          --Define a table
for i=0,sx-1 do                                        --From 0th pixel to 3th pixel in width
    tab[i+1] = {}                                        --Define a table
    for j=0,sy-1 do                                    --From 0th pixel to 3th pixel in height
        local r,g,b,a = dxGetPixelColor(pixel,i,j) --Get pixel color
        tab[i+1][j+1] = {r,g,b,a}                      --Save the color in the table
    end
end
</syntaxhighlight>
</syntaxhighlight>


Line 26: Line 36:
==See Also==
==See Also==
{{Drawing_functions}}
{{Drawing_functions}}
[[Category:Needs Example]]
 
[[hu:dxGetPixelColor]]

Latest revision as of 12:18, 6 March 2019

This function gets the color of a single pixel from pixels contained in a string. It only works with 'plain' format pixels.

Syntax

int, int, int, int dxGetPixelColor( string pixels, int x, int y )

Required Arguments

  • pixels : The pixels to use
  • x: The X coordinate for the pixel
  • y: The Y coordinate for the pixel

Returns

Returns 4 ints representing the rgba color value of the pixel if succesful, or false if invalid arguments were passed to the function.

Example

local texture = dxCreateTexture(4,4)        --Create a texture
local pixel = dxGetTexturePixels(texture)  --Get pixel element
local sx,sy = dxGetPixelsSize(pixel)             --Get pixel size
local tab = {}                                           --Define a table
for i=0,sx-1 do                                         --From 0th pixel to 3th pixel in width
    tab[i+1] = {}                                         --Define a table
    for j=0,sy-1 do                                     --From 0th pixel to 3th pixel in height
        local r,g,b,a = dxGetPixelColor(pixel,i,j) --Get pixel color
        tab[i+1][j+1] = {r,g,b,a}                      --Save the color in the table
    end
end

Requirements

Minimum server version n/a
Minimum client version 1.3

Note: Using this feature requires the resource to have the above minimum version declared in the meta.xml <min_mta_version> section. e.g. <min_mta_version client="1.3" />

See Also