/usr/include/gegl-0.2/gegl-buffer-iterator.h is in libgegl-dev 0.2.0-7+b1.
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 | /* This file is part of GEGL.
* ck
*
* 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>
*/
#ifndef __GEGL_BUFFER_ITERATOR_H__
#define __GEGL_BUFFER_ITERATOR_H__
#include "gegl-buffer.h"
#define GEGL_BUFFER_MAX_ITERATORS 6
#define GEGL_BUFFER_READ 1
#define GEGL_BUFFER_WRITE 2
#define GEGL_BUFFER_READWRITE (GEGL_BUFFER_READ|GEGL_BUFFER_WRITE)
typedef struct GeglBufferIterator
{
gint length;
gpointer data[GEGL_BUFFER_MAX_ITERATORS];
GeglRectangle roi[GEGL_BUFFER_MAX_ITERATORS];
gint level;
} GeglBufferIterator;
/**
* gegl_buffer_iterator_new:
* @buffer: a #GeglBuffer
* @roi: the rectangle to iterate over
* @format: the format we want to process this buffers data in, pass 0 to use the buffers format.
* @flags: whether we need reading or writing to this buffer one of GEGL_BUFFER_READ, GEGL_BUFFER_WRITE and GEGL_BUFFER_READWRITE.
* @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)
*
* 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,
guint flags,
GeglAbyssPolicy abyss_policy);
/**
* gegl_buffer_iterator_add:
* @iterator: a #GeglBufferIterator
* @buffer: a #GeglBuffer
* @roi: the rectangle to iterate over
* @format: the format we want to process this buffers data in, pass 0 to use the buffers format.
* @flags: whether we need reading or writing to this buffer.
*
* 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,
guint flags,
GeglAbyssPolicy abyss_policy);
/**
* gegl_buffer_iterator_stop:
* @iterator: a GeglBufferIterator
*
* Cancels the current iteration, freeing up any temporary resources. You have
* to bail out of any loop you are currently.
*/
void gegl_buffer_iterator_stop (GeglBufferIterator *iterator);
/**
* gegl_buffer_iterator_next:
* @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);
#ifdef EXAMPLE
GeglBufferIterator *gi;
gi = gegl_buffer_iterator_new (buffer, roi,
babl_format("Y' float"), GEGL_BUFFER_WRITE);
while (gegl_buffer_iterator_next (gi))
{
gfloat *buf = gi->data[0];
gint i;
for (i=0; i<gi->length; i++)
{
buf[i]=0.5;
}
}
#endif
#endif
|