im_black gtkdoc

This commit is contained in:
John Cupitt 2010-01-18 15:51:09 +00:00
parent 1861c82cf6
commit ea7662658f
1 changed files with 16 additions and 13 deletions

View File

@ -1,14 +1,4 @@
/* @(#) Make a black uchar image of a specified size. Sometimes useful for /* im_black.c
* @(#) building masks.
* @(#) IMAGE out should nhave been set by the calling program
* @(#)
* @(#) int
* @(#) im_black(out, x, y, bands)
* @(#) IMAGE *out;
* @(#) int x, y;
* @(#) int bands;
* @(#)
* @(#) Returns 0 on success and -1 on error.
* *
* Copyright: 1990, J. Cupitt * Copyright: 1990, J. Cupitt
* *
@ -21,6 +11,8 @@
* - memory leaks fixed! * - memory leaks fixed!
* 2/3/98 JC * 2/3/98 JC
* - IM_ANY added * - IM_ANY added
* 18/1/09
* - gtkdoc
*/ */
/* /*
@ -74,7 +66,18 @@ black_gen( REGION *or, void *seq, void *a, void *b )
return( 0 ); return( 0 );
} }
/* Make a one band black uchar image of a specified size. /**
* im_black:
* @out: output #IMAGE
* @x: output width
* @y: output height
* @bands: number of output bands
*
* Make a black unsigned char image of a specified size.
*
* See also: im_make_xy(), im_text().
*
* Returns: 0 on success, -1 on error
*/ */
int int
im_black( IMAGE *out, int x, int y, int bands ) im_black( IMAGE *out, int x, int y, int bands )
@ -83,7 +86,7 @@ im_black( IMAGE *out, int x, int y, int bands )
/* Check parameters. /* Check parameters.
*/ */
if( x < 0 || y < 0 || bands < 0 ) { if( x <= 0 || y <= 0 || bands <= 0 ) {
im_error( "im_black", "%s", _( "bad parameter" ) ); im_error( "im_black", "%s", _( "bad parameter" ) );
return( -1 ); return( -1 );
} }