/* Tables.
-. A table is a rectangular grid of cells. Cells can be joined to form larger
+ A table is a rectangular grid of cells. Cells can be joined to form larger
cells. Rows and columns can be separated by rules of various types. Rows
at the top and bottom of a table and columns at the left and right edges of
a table can be designated as headers, which means that if the table must be
broken across more than one page, those rows or columns are repeated on each
page.
- Every table is an instance of a particular table class that is responsible
- for keeping track of cell data. By far the most common table class is
- struct tab_table (see output/tab.h). This header also declares some other
- kinds of table classes, near the end of the file.
-
- A table is not itself an output_item, and thus a table cannot by itself be
- used for output, but they can be embedded inside struct table_item (see
- table-item.h) for that purpose. */
+ Some drivers use tables as an implementation detail of rendering pivot
+ tables.
+*/
#include <stdbool.h>
#include <stdint.h>
#include <stddef.h>
+#include "libpspp/compiler.h"
struct casereader;
struct fmt_spec;
+struct pivot_footnote;
+struct pivot_value;
struct pool;
struct table_item;
struct variable;
#define CELL_COLOR_WHITE CELL_COLOR (255, 255, 255)
static inline bool
-cell_color_equal (const struct cell_color *a, const struct cell_color *b)
+cell_color_equal (const struct cell_color a, const struct cell_color b)
{
- return a->alpha == b->alpha && a->r == b->r && a->g == b->g && a->b == b->b;
+ return a.alpha == b.alpha && a.r == b.r && a.g == b.g && a.b == b.b;
}
void cell_color_dump (const struct cell_color *);
enum table_stroke
{
- TABLE_STROKE_NONE,
+ TABLE_STROKE_NONE = 0, /* Must be zero. */
TABLE_STROKE_SOLID,
TABLE_STROKE_DASHED,
TABLE_STROKE_THICK,
const char *table_stroke_to_string (enum table_stroke);
+/* Given strokes A and B, returns a stroke that "combines" them, that is, that
+ gives a reasonable stroke choice for a rule for different reasons should
+ have both styles A and B. */
+static inline int
+table_stroke_combine (enum table_stroke a, enum table_stroke b)
+{
+ return a > b ? a : b;
+}
+
struct table_border_style
{
enum table_stroke stroke;
bool bold, italic, underline, markup;
struct cell_color fg[2], bg[2];
char *typeface;
- int size;
+ int size; /* In 1/72" units. */
};
#define FONT_STYLE_INITIALIZER { FONT_STYLE_INITIALIZER__ }
.fg = { [0] = CELL_COLOR_BLACK, [1] = CELL_COLOR_BLACK}, \
.bg = { [0] = CELL_COLOR_WHITE, [1] = CELL_COLOR_WHITE},
-void font_style_copy (struct font_style *, const struct font_style *);
+void font_style_copy (struct pool *,
+ struct font_style *, const struct font_style *);
void font_style_uninit (struct font_style *);
void font_style_dump (const struct font_style *);
+bool font_style_equal (const struct font_style *, const struct font_style *);
-struct area_style
+struct table_area_style
{
struct cell_style cell_style;
struct font_style font_style;
};
-#define AREA_STYLE_INITIALIZER { AREA_STYLE_INITIALIZER__ }
-#define AREA_STYLE_INITIALIZER__ \
+#define TABLE_AREA_STYLE_INITIALIZER { TABLE_AREA_STYLE_INITIALIZER__ }
+#define TABLE_AREA_STYLE_INITIALIZER__ \
.cell_style = CELL_STYLE_INITIALIZER, \
.font_style = FONT_STYLE_INITIALIZER
-struct area_style *area_style_clone (struct pool *, const struct area_style *);
-void area_style_copy (struct area_style *, const struct area_style *);
-void area_style_uninit (struct area_style *);
-void area_style_free (struct area_style *);
-
-/* Properties of a table cell. */
-enum
- {
- TAB_NONE = 0,
- TAB_FIX = 1 << 1, /* Use fixed font. */
- TAB_MARKUP = 1 << 2, /* Text contains Pango markup. */
- TAB_NUMERIC = 1 << 3, /* Cell contents are numeric. */
- TAB_ROTATE = 1 << 4, /* Rotate cell contents 90 degrees. */
-
- /* Bits with values (1 << TAB_FIRST_AVAILABLE) and higher are
- not used, so they are available for subclasses to use as
- they wish. */
- TAB_FIRST_AVAILABLE = 5
- };
+struct table_area_style *table_area_style_clone (
+ struct pool *, const struct table_area_style *);
+void table_area_style_copy (struct pool *, struct table_area_style *,
+ const struct table_area_style *);
+void table_area_style_uninit (struct table_area_style *);
+void table_area_style_free (struct table_area_style *);
-/* Styles for the rules around table cells. */
+/* Cell properties. */
enum
{
- TAL_NONE = TABLE_STROKE_NONE,
-#define TAL_0 TAL_NONE
- TAL_SOLID = TABLE_STROKE_SOLID,
-#define TAL_1 TAL_SOLID
- TAL_DASHED = TABLE_STROKE_DASHED,
- TAL_THICK = TABLE_STROKE_THICK,
- TAL_THIN = TABLE_STROKE_THIN,
- TAL_DOUBLE = TABLE_STROKE_DOUBLE,
-#define TAL_2 TAL_DOUBLE
+ TABLE_CELL_ROTATE = 1 << 0, /* Rotate cell contents 90 degrees. */
+ TABLE_CELL_JOIN = 1 << 1, /* Joined cell (internal use only). */
+ TABLE_CELL_STYLE_SHIFT = 2,
+ TABLE_CELL_STYLE_MASK = 7 << TABLE_CELL_STYLE_SHIFT,
};
-/* Given line styles A and B (each one of the TAL_* enumeration constants
- above), returns a line style that "combines" them, that is, that gives a
- reasonable line style choice for a rule for different reasons should have
- both styles A and B. */
-static inline int table_rule_combine (int a, int b)
-{
- return a > b ? a : b;
-}
-
/* A table. */
struct table
{
- const struct table_class *klass;
+ struct pool *container;
/* Table size.
indicated by a reference count greater than 1. When this is the case,
the table must not be modified. */
int ref_cnt;
+
+ /* Table contents.
+
+ Each array element in cc[] is ordinarily a "struct pivot_value *". If
+ TABLE_CELL_JOIN is set in cp[] for the element, however, it is a joined
+ cell and the corresponding element of cc[] points to a struct
+ table_cell. */
+ void **cc; /* Cell contents; void *[nr][nc]. */
+ unsigned char *cp; /* Cell properties; unsigned char[nr][nc]. */
+ struct table_area_style *styles[8];
+
+ /* Rules. */
+ unsigned char *rh; /* Horiz rules; unsigned char[nr+1][nc]. */
+ unsigned char *rv; /* Vert rules; unsigned char[nr][nc+1]. */
+ struct table_border_style *borders;
+ size_t n_borders;
};
/* Reference counting. */
void table_unref (struct table *);
bool table_is_shared (const struct table *);
-/* Returns the number of columns or rows, respectively, in T. */
-static inline int table_nc (const struct table *t)
- { return t->n[TABLE_HORZ]; }
-static inline int table_nr (const struct table *t)
- { return t->n[TABLE_VERT]; }
-
-/* Returns the number of left, right, top, or bottom headers, respectively, in
- T. */
-static inline int table_hl (const struct table *t)
- { return t->h[TABLE_HORZ][0]; }
-static inline int table_hr (const struct table *t)
- { return t->h[TABLE_HORZ][1]; }
-static inline int table_ht (const struct table *t)
- { return t->h[TABLE_VERT][0]; }
-static inline int table_hb (const struct table *t)
- { return t->h[TABLE_VERT][1]; }
-
-/* Set headers. */
-void table_set_hl (struct table *, int hl);
-void table_set_hr (struct table *, int hr);
-void table_set_ht (struct table *, int ht);
-void table_set_hb (struct table *, int hb);
-\f
-/* Table classes. */
-
-/* Simple kinds of tables. */
-struct table *table_from_string (const char *);
+/* Tables. */
+struct table *table_create (int nc, int nr, int hl, int hr, int ht, int hb);
+
+/* Rules. */
+void table_hline (struct table *, int style, int x1, int x2, int y);
+void table_vline (struct table *, int style, int x, int y1, int y2);
+
+/* Cells. */
+void table_put (struct table *, int x1, int y1, int x2, int y2,
+ unsigned opt, const struct pivot_value *);
+void table_put_owned (struct table *, int x1, int y1, int x2, int y2,
+ unsigned opt, struct pivot_value *);
+
+bool table_cell_is_empty (const struct table *, int c, int r);
#endif /* output/table.h */