DxSetPixelColor: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 22: Line 22:
Returns true if successful, or ''false'' if invalid arguments were passed to the function.
Returns true if successful, or ''false'' if invalid arguments were passed to the function.


==Example==
This example creates a 64x64 texture with random pixel colors, and draw it on the screen.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
TODO
addEventHandler ("onClientResourceStart", resourceRoot,
    function ()
        texture = dxCreateTexture (64, 64);
        local pixels = dxGetTexturePixels (texture);
        for i=1,63,1 do
            for j=1,63,1 do
                dxSetPixelColor (pixels, j, i, math.random (255), math.random (255), math.random (255), 255);
            end;
        end;
        dxSetTexturePixels (texture, pixels);
    end);
 
addEventHandler ("onClientRender", getRootElement (),
    function ()
        dxDrawImage (300, 300, 64, 64, texture);
    end);
</syntaxhighlight>
</syntaxhighlight>


Revision as of 16:59, 25 May 2013

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

Syntax

bool dxSetPixelColor ( string pixels, int x, int y, int r, int g, int b [, int a = 255 ] )

Required Arguments

  • pixels : The pixels to use
  • x: The X coordinate for the pixel
  • y: The Y coordinate for the pixel
  • r: The red channel for the color (0-255)
  • g: The green channel for the color (0-255)
  • b: The blue channel for the color (0-255)

Optional Arguments

  • a: The alpha channel for the color (0-255)

Returns

Returns true if successful, or false if invalid arguments were passed to the function.

This example creates a 64x64 texture with random pixel colors, and draw it on the screen. 

addEventHandler ("onClientResourceStart", resourceRoot, 
    function () 
         texture = dxCreateTexture (64, 64);
         local pixels = dxGetTexturePixels (texture);
         for i=1,63,1 do 
             for j=1,63,1 do 
                 dxSetPixelColor (pixels, j, i, math.random (255), math.random (255), math.random (255), 255);
             end;
         end;
         dxSetTexturePixels (texture, pixels); 
    end);

addEventHandler ("onClientRender", getRootElement (),
    function ()
         dxDrawImage (300, 300, 64, 64, texture);
    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

Retrieved from "https://wiki.multitheftauto.com/wiki/DxSetPixelColor?oldid=36089"