added docs derived from a patch from Cai Qian (bug #156271).

2004-11-08  Michael Natterer  <mitch@gimp.org>

	* libgimp/gimppixelfetcher.c: added docs derived from a patch from
	Cai Qian (bug #156271).
This commit is contained in:
Michael Natterer 2004-11-08 14:36:15 +00:00 committed by Michael Natterer
parent d9075fb76d
commit d90d7c5cb1
2 changed files with 53 additions and 0 deletions

View File

@ -1,3 +1,8 @@
2004-11-08 Michael Natterer <mitch@gimp.org>
* libgimp/gimppixelfetcher.c: added docs derived from a patch from
Cai Qian (bug #156271).
2004-11-08 Sven Neumann <sven@gimp.org>
* plug-ins/common/screenshot.c: changed label of default action

View File

@ -56,6 +56,16 @@ static guchar * gimp_pixel_fetcher_provide_tile (GimpPixelFetcher *pf,
/* public functions */
/**
* gimp_pixel_fetcher_new:
* @drawable: the #GimpDrawable the new region will be attached to.
* @shadow: a #gboolean indicating whether the region is attached to
* the shadow tiles or the real %drawable tiles.
*
* Initialize a pixel region from the drawable.
*
* Return value: a pointer to a #GimpPixelRgn structure (or NULL).
**/
GimpPixelFetcher *
gimp_pixel_fetcher_new (GimpDrawable *drawable,
gboolean shadow)
@ -99,6 +109,12 @@ gimp_pixel_fetcher_new (GimpDrawable *drawable,
return pf;
}
/**
* gimp_pixel_fetcher_destroy:
* @pf: a pointer to a previously initialized #GimpPixelFetcher.
*
* Close a previously initializd pixel region.
**/
void
gimp_pixel_fetcher_destroy (GimpPixelFetcher *pf)
{
@ -110,6 +126,13 @@ gimp_pixel_fetcher_destroy (GimpPixelFetcher *pf)
g_free (pf);
}
/**
* gimp_pixel_fetcher_set_edge_mode:
* @pf: a pointer to a previously initialized #GimpPixelFetcher.
* @mode: the new edge mode from #GimpPixelFetcherEdgeMode.
*
* Change the edage mode of a previously initialized pixel region.
**/
void
gimp_pixel_fetcher_set_edge_mode (GimpPixelFetcher *pf,
GimpPixelFetcherEdgeMode mode)
@ -119,6 +142,13 @@ gimp_pixel_fetcher_set_edge_mode (GimpPixelFetcher *pf,
pf->mode = mode;
}
/**
* gimp_pixel_fetcher_set_bg_color:
* @pf: a pointer to a previously initialized #GimpPixelFetcher.
* @color: the color to be used as bg color.
*
* Change the background color of a previously initialized pixel region.
**/
void
gimp_pixel_fetcher_set_bg_color (GimpPixelFetcher *pf,
const GimpRGB *color)
@ -141,6 +171,15 @@ gimp_pixel_fetcher_set_bg_color (GimpPixelFetcher *pf,
}
}
/**
* gimp_pixel_fetcher_get_pixel:
* @pf: a pointer to a previously initialized #GimpPixelFetcher.
* @x: the x coordinate of the pixel to get.
* @y: the y coordinate of the pixel to get.
* @pixel: the memory location where to return the pixel.
*
* Get a pixel from the pixel region.
**/
void
gimp_pixel_fetcher_get_pixel (GimpPixelFetcher *pf,
gint x,
@ -214,6 +253,15 @@ gimp_pixel_fetcher_get_pixel (GimpPixelFetcher *pf,
while (--i);
}
/**
* gimp_pixel_fetcher_put_pixel:
* @pf: a pointer to a previously initialized #GimpPixelFetcher.
* @x: the x coordinate of the pixel to set.
* @y: the y coordinate of the pixel to set.
* @pixel: the pixel to set.
*
* Set a pixel in the pixel region.
**/
void
gimp_pixel_fetcher_put_pixel (GimpPixelFetcher *pf,
gint x,