GeglBuffer

Loads an existing GeglBuffer from disk, if it has previously been saved with gegl_buffer_save it should be possible to open through any GIO transport, buffers that have been used as swap needs random access to be opened.

Open an existing on-disk GeglBuffer, this buffer is opened in a monitored state so multiple instances of gegl can share the same buffer. Sets on one buffer are reflected in the other.

Generates a unique filename in the GEGL swap directory, suitable for using as swap space. When the file is no longer needed, it may be removed with gegl_buffer_swap_remove_file(); otherwise, it will be removed when gegl_exit() is called.

Tests if path is a swap file, that is, if it has been created with gegl_buffer_swap_create_file(), and hasn’t been removed yet.

Removes a swap file, generated using gegl_buffer_swap_create_file(), unlinking the file, if exists.

Add a new tile handler in the existing chain of tile handler of a GeglBuffer.

Clears the provided rectangular region by setting all the associated memory to 0.

Copy a region from source buffer to destination buffer.

Create a new sub GeglBuffer, that is a view on a larger buffer.

Duplicate a buffer (internally uses gegl_buffer_copy). Aligned tiles will create copy-on-write clones in the new buffer.

Flushes all unsaved data to disk, this is not necessary for shared geglbuffers opened with gegl_buffer_open since they auto-sync on writes.

Invokes the external flush function, if any is set on the provided buffer - this ensures that data pending - in the current implementation only OpenCL - externally to be synchronized with the buffer. Multi threaded code should call such a synchronization before branching out to avoid each of the threads having an implicit synchronization of its own.

Blocks emission of the “changed” signal for buffer.

Fetch a rectangular linear buffer of pixel data from the GeglBuffer, the data is converted to the desired BablFormat, if the BablFormat stored and fetched is the same this amounts to a series of memcpy’s aligned to demux the tile structure into a linear buffer.

Return the abyss extent of a buffer, this expands out to the parents extent in subbuffers.

Returns a pointer to a GeglRectangle structure defining the geometry of a specific GeglBuffer, this is also the default width/height of buffers passed in to gegl_buffer_set and gegl_buffer_get (with a scale of 1.0 at least).

Get the babl format of the buffer, this might not be the format the buffer was originally created with, you need to use gegl_buffer_set_format (buf, NULL); to retrieve the original format (potentially having saved away the original format of the buffer to re-set it.)

Fetch a rectangular linear buffer of pixel data from the GeglBuffer.

Store a linear raster buffer into the GeglBuffer.

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.

This function makes sure GeglBuffer and underlying code is aware of changes being made to the linear buffer. If the request was not a compatible one it is written back to the buffer. Multiple concurrent users can be handed the same buffer (both raw access and converted).

Raw direct random access to the full data of a buffer in linear memory.

Remove the provided tile handler in the existing chain of tile handler of a GeglBuffer.

Query interpolate pixel values at a given coordinate using a specified form of interpolation.

Query interpolate pixel values at a given coordinate using a specified form of interpolation.

Create a new sampler, when you are done with the sampler, g_object_unref it.

Create a new sampler, when you are done with the sampler, g_object_unref it.

Write a GeglBuffer to a file.

Store a linear raster buffer into the GeglBuffer.

Changes the size and position of the abyss rectangle of a buffer.

Sets the region covered by rect to the specified color.

Sets the region covered by rect to the the provided pixel.

Changes the size and position that is considered active in a buffer, this operation is valid on any buffer, reads on subbuffers outside the master buffer’s extent are at the moment undefined.

Set the babl format of the buffer, setting the babl format of the buffer requires the new format to have exactly the same bytes per pixel as the original format. If NULL is passed in the format of the buffer is reset to the original format.

Fill a region with a repeating pattern. Offsets parameters are relative to the origin (0, 0) and not to the rectangle. So be carefull about the origin of pattern and buffer extents.

Checks if a pair of buffers share the same underlying tile storage.

This function should be used instead of g_signal_connect when connecting to the GeglBuffer::changed signal handler, GeglBuffer contains additional machinery to avoid the overhead of changes when no signal handler have been connected, if regular g_signal_connect is used; then no signals will be emitted.

Unblocks emission of the “changed” signal for buffer.