Pixel
BitMap.Pixel(b, i, j, Color, alpha) sets the color of one pixel of the BitMap object b, the pixel in column i and row j. Columns are counted from 1 at the left, rows from 1 at the top. The bitmap is changed; the function returns nothing.
Input
-
b : a BitMap object.
-
i : Integer, the column, from 1 (left) to the width of the bitmap.
-
j : Integer, the row, from 1 (top) to the height of the bitmap.
-
Color : 32 bit integer 0xAARRGGBB, the color of the pixel, AA the transparency (00 opaque).
-
alpha : (optional) Integer from 0 to 255, the opacity, on top of the transparency of Color: 255 keeps the color as it is, 128 makes an opaque color half transparent and 0 fully transparent. Default value 255
Output
None; the pixel of b is changed.
Example
A bitmap of 3 by 2 pixels with three colored pixels. The script prints the colors row by row from the top, as Graphics.ToTable gives them for a page with the bitmap on it.
Input
- Example.Quanty
-- a bitmap of 3 by 2 pixels, opaque white b = BitMap.New(3, 2) BitMap.Pixel(b, 1, 1, 0xFF0000) -- column 1, row 1: the top left pixel, red BitMap.Pixel(b, 3, 1, 0x80FF0000) -- the top right pixel, half transparent red BitMap.Pixel(b, 3, 2, 0x0000FF, 128) -- the bottom right pixel, blue, half transparent by the opacity 128 -- the pixels, row by row from the top, as they are on a page P = Graphics.ToTable(Graphics.Add(Graphics.New(), b)).BitMap[1].Pixels for j = 1, 2 do local row = "" for i = 1, 3 do row = row.." 0x"..string.sub(P, 8*(3*(j-1)+i)-7, 8*(3*(j-1)+i)) end print("row "..j..":"..row) end -- a column or row outside the bitmap is an error print(pcall(BitMap.Pixel, b, 4, 1, 0x000000))
Result
row 1: 0x00FF0000 0x00FFFFFF 0x80FF0000 row 2: 0x00FFFFFF 0x00FFFFFF 0x7F0000FF false Error: can not index column 4 from 3 available
See the example on the BitMap page for a picture made pixel by pixel.