ToTable
T = Graphics.ToTable(pl) returns the Graphics object pl as a Lua table: the size of the page and every line, curve, arc, text, bitmap and layer on it, with all their properties. The table can be read and changed, and Graphics.New(T) turns it into a Graphics object again.
Input
-
pl : a Graphics object.
Output
-
T : a table with the fields below. A list that would be empty is left out, so T.Curve is nil when pl has no curves.
Points are given as {x, y}, fractions of the width and the height of the page, and lists of points as { {x1, y1}, {x2, y2}, …}. Widths, radii and the sizes of texts are fractions of $\sqrt{\mathrm{width} \cdot \mathrm{height}}$ of the page, angles are in radians, and colors are 32 bit integers 0xAARRGGBB (see colors).
-
CanvasSize : {width, height} of the page in mm.
-
CanvasOrigin : {x, y} of the lower left corner of the page in mm.
-
Line : a list of lines, each a table with
-
Point : the list of points.
-
Color, Width : the color and the width of the line.
-
CloseAndFill, FillColor : Boolean, the line is closed and filled with FillColor.
Curve : a list of curves, each a table with-
Point : the list of points.
-
VL, VR : the lists of control points before and after each point, see Graphics.Add().
-
Color, Width, CloseAndFill, FillColor : as for a line.
Arc : a list of arcs, each a table with-
Point, R : the centre and the radius.
-
ThetaR, ThetaL : the angles where the arc starts and ends, counterclockwise. A full circle runs from 0 to $2\pi$.
-
Color, Width, CloseAndFill, FillColor : as for a line; a closed arc is closed through its centre.
Text : a list of texts, each a table with-
String : the text.
-
Point, Alignment : the point of the text, and whether it is the left end (“l”), the middle (“c”) or the right end (“r”) of the text.
-
Size, Angle, Color, Font : the height, the angle, the color and the PostScript name of the font.
BitMap : a list of bitmaps, each a table with-
LB, RT : the lower left and the upper right corner of the rectangle.
-
NpointsX, NpointsY : the number of pixels in a row and the number of rows.
-
Pixels : a string of hexadecimal digits, eight per pixel (its color 0xAARRGGBB), the rows one after the other from the top, closed by “>”. Spaces and line breaks in it are ignored.
-
Pixelated : true when the bitmap is drawn with sharp pixels; left out otherwise.
-
Angle : the angle by which the rectangle is turned about its middle, see Graphics.Rotate(); left out when it is 0.
Layer : a list of the layers, each a table of this same form.Graphics.New(T) accepts such a table with any of the fields left out; they then take their default values (black, a width of 0.001, a text size of 0.05, a circle of radius 1). It refuses fields it does not know. A Graphics object can also be saved to a file with io.put and read back with io.get.
Example
A page with a line, a circle and a text as a table. The circle is then made red and twice as large in the table, and the table is turned into a new Graphics object.
Input
- Example.Quanty
-- a page of 100 mm by 60 mm with a line, a circle and a text pl = Graphics.New({{"Canvas.Size.X",100}, {"Canvas.Size.Y",60}}) pl.Add({ {0.1,0.1}, {0.9,0.1} }, {{"Color",0x0000FF}}) pl.Add({"Arc", {0.5,0.5}, 0.2}, {{"Line Width",0.01}}) pl.Add("Quanty", 0.5, 0.45, {{"Alignment","c"}}) T = Graphics.ToTable(pl) -- the page and the elements print("CanvasSize ", T.CanvasSize[1], T.CanvasSize[2]) print("CanvasOrigin", T.CanvasOrigin[1], T.CanvasOrigin[2]) for _, Kind in ipairs({"Line", "Curve", "Arc", "Text", "BitMap", "Layer"}) do print(string.format("%-6s %d", Kind, T[Kind] and #T[Kind] or 0)) end -- the fields of the line, sorted by name Names = {} for Name in pairs(T.Line[1]) do Names[#Names+1] = Name end table.sort(Names) for _, Name in ipairs(Names) do local v = T.Line[1][Name] if Name == "Point" then print(Name, "{ {"..v[1][1]..", "..v[1][2].."}, {"..v[2][1]..", "..v[2][2].."} }") elseif Name == "Color" or Name == "FillColor" then print(Name, string.format("0x%08X", v)) else print(Name, v) end end -- change the table and make a new Graphics object of it: the circle red and twice as large T.Arc[1].Color = 0xFF0000 T.Arc[1].R = 2*T.Arc[1].R pl2 = Graphics.New(T) print("radius", Graphics.ToTable(pl).Arc[1].R, Graphics.ToTable(pl2).Arc[1].R)
Result
CanvasSize 100 60 CanvasOrigin 0 0 Line 1 Curve 0 Arc 1 Text 1 BitMap 0 Layer 0 CloseAndFill false Color 0x000000FF FillColor 0x00000000 Point { {0.1, 0.1}, {0.9, 0.1} } Width 0.001 radius 0.2 0.4The page has no curves, bitmaps or layers, so these fields are left out of the table. The original pl is not changed by changing the table.
Table of contents
-