/usr/include/gegl-0.3/gegl-buffer-iterator.h is in libgegl-dev 0.3.4-1ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 | /* This file is part of GEGL.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 3 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, see <http://www.gnu.org/licenses/>.
*
* Copyright 2008 Øyvind Kolås <pippin@gimp.org>
* 2013 Daniel Sabo
*/
#ifndef __GEGL_BUFFER_ITERATOR_H__
#define __GEGL_BUFFER_ITERATOR_H__
#include "gegl-buffer.h"
#define GEGL_BUFFER_MAX_ITERATORS 6
#define GEGL_BUFFER_READ GEGL_ACCESS_READ
#define GEGL_BUFFER_WRITE GEGL_ACCESS_WRITE
#define GEGL_BUFFER_READWRITE GEGL_ACCESS_READWRITE
typedef struct _GeglBufferIteratorPriv GeglBufferIteratorPriv;
/***
* GeglBufferIterator:
*
* GeglBufferIterator allows to iterate over one or more GeglBuffers.
* In each iteration the new data is available as a linear chunk of
* memory. See gegl_buffer_iterator_new() and gegl_buffer_iterator_next()
*/
typedef struct GeglBufferIterator
{
gint length;
gpointer data[GEGL_BUFFER_MAX_ITERATORS];
GeglRectangle roi[GEGL_BUFFER_MAX_ITERATORS];
/* Private */
GeglBufferIteratorPriv *priv;
} GeglBufferIterator;
/**
* gegl_buffer_iterator_empty_new: (skip)
* Create a new buffer iterator without adding any buffers.
*
* Returns: a new buffer iterator.
*/
GeglBufferIterator *gegl_buffer_iterator_empty_new (void);
/**
* gegl_buffer_iterator_new: (skip)
* @buffer: a #GeglBuffer
* @roi: the rectangle to iterate over
* @level: the level at which we are iterating, the roi will indicate the
* extent at 1:1, x,y,width and height are/(2^level)
* @format: the format we want to process this buffers data in, pass 0 to use the buffers format.
* @access_mode: whether we need reading or writing to this buffer one of GEGL_BUFFER_READ, GEGL_BUFFER_WRITE and GEGL_BUFFER_READWRITE.
* @abyss_policy: how request outside the buffer extent are handled.
*
* Create a new buffer iterator, this buffer will be iterated through
* in linear chunks, some chunks might be full tiles the coordinates, see
* the documentation of gegl_buffer_iterator_next for how to use it and
* destroy it.
*
* Returns: a new buffer iterator that can be used to iterate through the
* buffers pixels.
*/
GeglBufferIterator * gegl_buffer_iterator_new (GeglBuffer *buffer,
const GeglRectangle *roi,
gint level,
const Babl *format,
GeglAccessMode access_mode,
GeglAbyssPolicy abyss_policy);
/**
* gegl_buffer_iterator_add: (skip)
* @iterator: a #GeglBufferIterator
* @buffer: a #GeglBuffer
* @roi: the rectangle to iterate over
* @level: the level at which we are iterating, the roi will indicate the
* extent at 1:1, x,y,width and height are/(2^level)
* @format: the format we want to process this buffers data in, pass 0 to use the buffers format.
* @access_mode: whether we need reading or writing to this buffer.
* @abyss_policy: how request outside the buffer extent are handled.
*
* Adds an additional buffer iterator that will be processed in sync with
* the original one, if the buffer doesn't align with the other for tile access
* the corresponding scans and regions will be serialized automatically using
* gegl_buffer_get.
*
* Returns: an integer handle refering to the indice in the iterator structure
* of the added buffer.
*/
gint gegl_buffer_iterator_add (GeglBufferIterator *iterator,
GeglBuffer *buffer,
const GeglRectangle *roi,
gint level,
const Babl *format,
GeglAccessMode access_mode,
GeglAbyssPolicy abyss_policy);
/**
* gegl_buffer_iterator_stop: (skip)
* @iterator: a GeglBufferIterator
*
* Cancels the current iteration, freeing up any temporary resources. The
* iterator handle is no longer valid after invoking this function.
*/
void gegl_buffer_iterator_stop (GeglBufferIterator *iterator);
/**
* gegl_buffer_iterator_next: (skip)
* @iterator: a #GeglBufferIterator
*
* Do an iteration, this causes a new set of iterator->data[] to become
* available if there is more data to process. Changed data from a previous
* iteration step will also be saved now. When there is no more data to
* be processed FALSE will be returned (and the iterator handle is no longer
* valid).
*
* Returns: TRUE if there is more work FALSE if iteration is complete.
*/
gboolean gegl_buffer_iterator_next (GeglBufferIterator *iterator);
#endif
|