New
b = BitMap.New(NX, NY, Options) returns a new BitMap object of NX by NY pixels, all of one color, by default opaque white. The options set the color and the rectangle of the page the bitmap fills when it is put on a Graphics object with Graphics.Add().
Input
-
NX : Integer, the number of pixels in a row, the width of the bitmap.
-
NY : Integer, the number of pixels in a column, the height of the bitmap.
-
Options : (optional) A table of options. Possible options are:
-
“Canvas.Origin.X”, “Canvas.Origin.Y” : Reals, the lower left corner of the bitmap on the page, as a fraction of the width and of the height of the page. Default values 0 and 0
-
“Canvas.Size.X”, “Canvas.Size.Y” : Reals, the width and the height of the bitmap on the page, as a fraction of the width and of the height of the page. Default values 1 and 1, the whole page
-
“Color” : 32 bit integer 0xAARRGGBB, the color of all pixels. Default value 0xFFFFFF (opaque white)
-
“alpha” : 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
-
b : a BitMap object.
Example
Three bitmaps on one page: an opaque white one that fills the page, a half transparent red one and a blue one made half transparent by “alpha”. The script prints where each bitmap lies on the page and the color of its first pixel, as Graphics.ToTable gives them.
Input
- Example.Quanty
-- a bitmap of 200 by 100 pixels, opaque white, that fills the whole page it is put on b1 = BitMap.New(200, 100) -- a bitmap of 20 by 20 pixels, half transparent red, from (0.1, 0.2) to (0.5, 0.8) of the page b2 = BitMap.New(20, 20, {{"Canvas.Origin.X",0.1}, {"Canvas.Origin.Y",0.2}, {"Canvas.Size.X",0.4}, {"Canvas.Size.Y",0.6}, {"Color",0x80FF0000}}) -- the same in blue, made half transparent by the opacity alpha, from (0.3, 0.1) to (0.9, 0.5) b3 = BitMap.New(20, 20, {{"Canvas.Origin.X",0.3}, {"Canvas.Origin.Y",0.1}, {"Canvas.Size.X",0.6}, {"Canvas.Size.Y",0.4}, {"Color",0x0000FF}, {"alpha",128}}) -- put them on a page and look at what is there: the corners and the color of the first pixel pl = Graphics.New() pl.Add(b1) pl.Add(b2) pl.Add(b3) for k, B in ipairs(Graphics.ToTable(pl).BitMap) do print(string.format("bitmap %d: %3d by %3d pixels from (%.1f, %.1f) to (%.1f, %.1f), first pixel 0x%s", k, B.NpointsX, B.NpointsY, B.LB[1], B.LB[2], B.RT[1], B.RT[2], string.sub(B.Pixels, 1, 8))) end file = io.open("BitMap_New.svg", "w") file:write(Graphics.ToSVG(pl, {{"RelativeSize",true}})) file:close()
Result
bitmap 1: 200 by 100 pixels from (0.0, 0.0) to (1.0, 1.0), first pixel 0x00FFFFFF bitmap 2: 20 by 20 pixels from (0.1, 0.2) to (0.5, 0.8), first pixel 0x80FF0000 bitmap 3: 20 by 20 pixels from (0.3, 0.1) to (0.9, 0.5), first pixel 0x7F0000FF
The opacity 128 of “alpha” gives the transparency 0x7F. The script writes BitMap_New.svg; the white bitmap is the white background of the page:
Table of contents
-