diff options
author | Enrico Weigelt, metux IT consult <enrico.weigelt@gr13.net> | 2015-12-29 10:16:45 +0100 |
---|---|---|
committer | Bryce Harrington <bryce@osg.samsung.com> | 2016-01-13 17:14:51 -0800 |
commit | 968f8c70aac8cde9bc622644dcab9a6548734d59 (patch) | |
tree | 7504eeeb89c4713747b7fdba849869cde417bd9a | |
parent | 047ba66519b18b7fe0167108307d741cdc816935 (diff) |
core: some in-code documentation
Signed-off-by: Enrico Weigelt, metux IT consult <enrico.weigelt@gr13.net>
-rw-r--r-- | src/cairo-boxes.c | 26 |
1 files changed, 26 insertions, 0 deletions
diff --git a/src/cairo-boxes.c b/src/cairo-boxes.c index 63b68ddfb..db002efa4 100644 --- a/src/cairo-boxes.c +++ b/src/cairo-boxes.c @@ -102,6 +102,16 @@ _cairo_boxes_init_for_array (cairo_boxes_t *boxes, boxes->is_pixel_aligned = n == num_boxes; } +/** + * Computes the minimum bounding box of the given list of boxes and assign + * it to the given boxes set. It also assigns that list as the list of + * limiting boxes in the box set. + * + * @param boxes the box set to be filled (return buffer) + * @param limits array of the limiting boxes to compute the bounding + * box from + * @param num_limits length of the limits array + */ void _cairo_boxes_limit (cairo_boxes_t *boxes, const cairo_box_t *limits, @@ -265,6 +275,13 @@ _cairo_boxes_add (cairo_boxes_t *boxes, return boxes->status; } +/** + * Computes the minimum bounding box of the given box set and stores + * it in the given box. + * + * @param boxes the box set whose minimum bounding is computed + * @param box return buffer for the computed result + */ void _cairo_boxes_extents (const cairo_boxes_t *boxes, cairo_box_t *box) @@ -317,6 +334,15 @@ _cairo_boxes_clear (cairo_boxes_t *boxes) boxes->is_pixel_aligned = TRUE; } +/** + * Linearize a box set of possibly multiple chunks into one big chunk + * and returns an array of boxes + * + * @param boxes the box set to be converted + * @param num_boxes return buffer for the number of boxes (array count) + * @return pointer to the newly allocated array of boxes + * (the number o elements is given in num_boxes) + * */ cairo_box_t * _cairo_boxes_to_array (const cairo_boxes_t *boxes, int *num_boxes, |