Method

GeglBuffersample

Declaration [src]

void
gegl_buffer_sample (
  GeglBuffer* buffer,
  gdouble x,
  gdouble y,
  GeglBufferMatrix2* scale,
  gpointer dest,
  const Babl* format,
  GeglSamplerType sampler_type,
  GeglAbyssPolicy repeat_mode
)

Description [src]

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

If you intend to take multiple samples, consider using gegl_buffer_sampler_new() to create a sampler object instead, which is more efficient.

This method is not directly available to language bindings.

Parameters

x gdouble
 

X coordinate to sample in buffer coordinates.

y gdouble
 

Y coordinate to sample in buffer coordinates.

scale GeglBufferMatrix2
 

A matrix that indicates scaling factors, see gegl_sampler_compute_scale the same.

 The data is owned by the caller of the function.
dest gpointer
 

Buffer capable of storing one pixel in format.

 The argument can be NULL.
 The data is owned by the caller of the function.
format Babl
 

The format to store the sampled color in.

 The data is owned by the caller of the function.
sampler_type GeglSamplerType
 

The sampler type to use, to be ported from working code. Valid values: GEGL_SAMPLER_NEAREST, GEGL_SAMPLER_LINEAR, GEGL_SAMPLER_CUBIC, GEGL_SAMPLER_NOHALO and GEGL_SAMPLER_LOHALO.

repeat_mode GeglAbyssPolicy
 

How requests outside the buffer extent are handled. Valid values: GEGL_ABYSS_NONE (abyss pixels are zeroed), GEGL_ABYSS_WHITE (abyss pixels are white), GEGL_ABYSS_BLACK (abyss pixels are black), GEGL_ABYSS_CLAMP (coordinates are clamped to the abyss rectangle), GEGL_ABYSS_LOOP (buffer contents are tiled if outside of the abyss rectangle).