DxSetPixelColor: Difference between revisions

Latest revision as of 17:32, 1 December 2018

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.

Example

Click to collapse [-]

Client

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=0,63 do
             for j=0,63 do
                 dxSetPixelColor (pixels, j, i, math.random (255), math.random (255), math.random (255), 255)
             end;
         end;
         dxSetTexturePixels (texture, pixels)
    end)

addEventHandler ("onClientRender", root,
    function ()
         dxDrawImage (300, 300, 64, 64, texture)
    end)

@@ Line 22: / Line 22: @@
 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.
-<syntaxhighlight lang="lua">
-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 (),
+==Example==
-    function ()
+<section name="Client" class="client" show="true">
-         dxDrawImage (300, 300, 64, 64, texture);
-    end);
-</syntaxhighlight>
-=EXAMPLE=
 This example creates a 64x64 texture with random pixel colors, and draw it on the screen.
 <syntaxhighlight lang="lua">
 addEventHandler ("onClientResourceStart", resourceRoot,
      function ()
-          texture = dxCreateTexture (64, 64);
+          texture = dxCreateTexture (64, 64)
-          local pixels = dxGetTexturePixels (texture);
+          local pixels = dxGetTexturePixels (texture)
-          for i=1,63,1 do
+          for i=0,63 do
-              for j=1,63,1 do
+              for j=0,63 do
-                  dxSetPixelColor (pixels, j, i, math.random (255), math.random (255), math.random (255), 255);
+                  dxSetPixelColor (pixels, j, i, math.random (255), math.random (255), math.random (255), 255)
               end;
           end;
-          dxSetTexturePixels (texture, pixels);
+          dxSetTexturePixels (texture, pixels)
-     end);
+     end)
-addEventHandler ("onClientRender", getRootElement (),
+addEventHandler ("onClientRender", root,
      function ()
-          dxDrawImage (300, 300, 64, 64, texture);
+          dxDrawImage (300, 300, 64, 64, texture)
-     end);
+     end)
 </syntaxhighlight>
+</section>
 ==See Also==
 {{Drawing_functions}}
-[[Category:Needs Example]]
+[[hu:dxSetPixelColor]]