mirror of
https://gitlab.gnome.org/GNOME/gimp.git
synced 2025-07-03 17:33:25 +00:00
ba9ce34e10
Factor out the region-chunking logic of GimpProjection into a new GimpChunkIterator type, providing a generic mechanism for iterating over a cairo region in discrete chunks. The iterator doesn't perform any processing itself, but rather dispenses rectangular chunks, which the user then processes. Iteration is broken into intervals, the duration of which is configurable. Each iteration begins with a call to gimp_chunk_iterator_next(), after which gimp_chunk_iterator_get_rect() should be called in succession to fetch a rectangle to process, until it returns FALSE, which marks the end of the iteration. Updates to the UI should take place in the interval between iterations, but not during an iteration. The iterator dynamically adjusts the chunk size according to processing speed, in order to match the target iteration interval. The iterator can be given a priority rectangle, which is processed before the rest of the region. It can also be given a representative tile rectangle, defining a regular tile grid; dispensed chunks are aligned to the tile grid as much as possible.
44 lines
1.9 KiB
C
44 lines
1.9 KiB
C
/* GIMP - The GNU Image Manipulation Program
|
|
* Copyright (C) 1995 Spencer Kimball and Peter Mattis
|
|
*
|
|
* gimpchunkiterator.h
|
|
* Copyright (C) 2019 Ell
|
|
*
|
|
* This program is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program 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 General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef __GIMP_CHUNK_ITEARTOR_H__
|
|
#define __GIMP_CHUNK_ITEARTOR_H__
|
|
|
|
|
|
GimpChunkIterator * gimp_chunk_iterator_new (cairo_region_t *region);
|
|
|
|
void gimp_chunk_iterator_set_tile_rect (GimpChunkIterator *iter,
|
|
const GeglRectangle *rect);
|
|
|
|
void gimp_chunk_iterator_set_priority_rect (GimpChunkIterator *iter,
|
|
const GeglRectangle *rect);
|
|
|
|
void gimp_chunk_iterator_set_interval (GimpChunkIterator *iter,
|
|
gdouble interval);
|
|
|
|
gboolean gimp_chunk_iterator_next (GimpChunkIterator *iter);
|
|
gboolean gimp_chunk_iterator_get_rect (GimpChunkIterator *iter,
|
|
GeglRectangle *rect);
|
|
|
|
cairo_region_t * gimp_chunk_iterator_stop (GimpChunkIterator *iter,
|
|
gboolean free_region);
|
|
|
|
|
|
#endif /* __GIMP_CHUNK_ITEARTOR_H__ */
|