From 1ae92bb15ff5eed7f8aa33f7148e6ba9b7a800ef Mon Sep 17 00:00:00 2001 From: John Cupitt Date: Mon, 2 May 2016 10:12:37 +0100 Subject: [PATCH] make optional args into bullets make docs easier to read --- libvips/arithmetic/hist_find.c | 2 +- libvips/arithmetic/hist_find_ndim.c | 2 +- libvips/arithmetic/hough_circle.c | 6 +- libvips/arithmetic/hough_line.c | 4 +- libvips/arithmetic/linear.c | 4 +- libvips/arithmetic/max.c | 12 +- libvips/arithmetic/measure.c | 8 +- libvips/arithmetic/min.c | 12 +- libvips/colour/colourspace.c | 2 +- libvips/colour/icc_transform.c | 24 ++-- libvips/colour/scRGB2BW.c | 2 +- libvips/colour/scRGB2sRGB.c | 2 +- libvips/conversion/arrayjoin.c | 14 +- libvips/conversion/autorot.c | 2 +- libvips/conversion/bandfold.c | 2 +- libvips/conversion/bandrank.c | 2 +- libvips/conversion/bandunfold.c | 2 +- libvips/conversion/cache.c | 6 +- libvips/conversion/cast.c | 2 +- libvips/conversion/copy.c | 20 +-- libvips/conversion/embed.c | 4 +- libvips/conversion/extract.c | 2 +- libvips/conversion/flatten.c | 4 +- libvips/conversion/gamma.c | 2 +- libvips/conversion/ifthenelse.c | 2 +- libvips/conversion/insert.c | 4 +- libvips/conversion/join.c | 8 +- libvips/conversion/msb.c | 2 +- libvips/conversion/premultiply.c | 2 +- libvips/conversion/rot45.c | 2 +- libvips/conversion/scale.c | 4 +- libvips/conversion/sequential.c | 6 +- libvips/conversion/subsample.c | 2 +- libvips/conversion/tilecache.c | 18 +-- libvips/conversion/unpremultiply.c | 2 +- libvips/conversion/wrap.c | 4 +- libvips/convolution/conv.c | 6 +- libvips/convolution/convsep.c | 6 +- libvips/convolution/gaussblur.c | 4 +- libvips/convolution/sharpen.c | 12 +- libvips/create/black.c | 2 +- libvips/create/eye.c | 4 +- libvips/create/gaussmat.c | 4 +- libvips/create/gaussnoise.c | 4 +- libvips/create/grey.c | 2 +- libvips/create/identity.c | 6 +- libvips/create/invertlut.c | 2 +- libvips/create/logmat.c | 4 +- libvips/create/mask_butterworth.c | 8 +- libvips/create/mask_butterworth_band.c | 8 +- libvips/create/mask_butterworth_ring.c | 8 +- libvips/create/mask_fractal.c | 8 +- libvips/create/mask_gaussian.c | 8 +- libvips/create/mask_gaussian_band.c | 8 +- libvips/create/mask_gaussian_ring.c | 8 +- libvips/create/mask_ideal.c | 8 +- libvips/create/mask_ideal_band.c | 8 +- libvips/create/mask_ideal_ring.c | 8 +- libvips/create/sines.c | 6 +- libvips/create/text.c | 10 +- libvips/create/tonelut.c | 20 +-- libvips/create/xyz.c | 6 +- libvips/create/zone.c | 2 +- libvips/draw/draw_circle.c | 4 +- libvips/draw/draw_flood.c | 24 ++-- libvips/draw/draw_image.c | 2 +- libvips/draw/draw_rect.c | 4 +- libvips/foreign/csvload.c | 8 +- libvips/foreign/csvsave.c | 2 +- libvips/foreign/dzsave.c | 20 +-- libvips/foreign/foreign.c | 178 ++++++++++++------------- libvips/foreign/ppmsave.c | 4 +- libvips/foreign/rawload.c | 2 +- libvips/freqfilt/invfft.c | 2 +- libvips/histogram/hist_equal.c | 2 +- libvips/histogram/maplut.c | 2 +- libvips/histogram/stdif.c | 8 +- libvips/iofuncs/image.c | 4 +- libvips/iofuncs/system.c | 10 +- libvips/morphology/labelregions.c | 2 +- libvips/mosaicing/global_balance.c | 4 +- libvips/mosaicing/match.c | 8 +- libvips/mosaicing/merge.c | 2 +- libvips/mosaicing/mosaic.c | 8 +- libvips/mosaicing/mosaic1.c | 12 +- libvips/resample/affine.c | 12 +- libvips/resample/mapim.c | 2 +- libvips/resample/quadratic.c | 2 +- libvips/resample/reduce.c | 2 +- libvips/resample/resize.c | 4 +- libvips/resample/similarity.c | 14 +- 91 files changed, 362 insertions(+), 364 deletions(-) diff --git a/libvips/arithmetic/hist_find.c b/libvips/arithmetic/hist_find.c index 465d3452..35227c4a 100644 --- a/libvips/arithmetic/hist_find.c +++ b/libvips/arithmetic/hist_find.c @@ -475,7 +475,7 @@ vips_hist_find_init( VipsHistFind *hist_find ) * * Optional arguments: * - * @band: band to equalise + * * @band: band to equalise * * Find the histogram of @in. Find the histogram for band @band (producing a * one-band histogram), or for all bands (producing an n-band histogram) if diff --git a/libvips/arithmetic/hist_find_ndim.c b/libvips/arithmetic/hist_find_ndim.c index e0d930d8..b0b3ce5f 100644 --- a/libvips/arithmetic/hist_find_ndim.c +++ b/libvips/arithmetic/hist_find_ndim.c @@ -323,7 +323,7 @@ vips_hist_find_ndim_init( VipsHistFindNDim *ndim ) * * Optional arguments: * - * @bins: number of bins to make on each axis + * * @bins: number of bins to make on each axis * * Make a one, two or three dimensional histogram of a 1, 2 or * 3 band image. Divide each axis into @bins bins .. ie. diff --git a/libvips/arithmetic/hough_circle.c b/libvips/arithmetic/hough_circle.c index 620345e1..fd3fd248 100644 --- a/libvips/arithmetic/hough_circle.c +++ b/libvips/arithmetic/hough_circle.c @@ -275,9 +275,9 @@ vips_hough_circle_init( VipsHoughCircle *hough_circle ) * * Optional arguments: * - * @scale: scale down dimensions by this much - * @min_radius: smallest radius to search for - * @max_radius: largest radius to search for + * * @scale: scale down dimensions by this much + * * @min_radius: smallest radius to search for + * * @max_radius: largest radius to search for * * Find the circular Hough transform of an image. @in must be one band, with * non-zero pixels for image edges. @out is three-band, with the third channel diff --git a/libvips/arithmetic/hough_line.c b/libvips/arithmetic/hough_line.c index eaa5b8bd..e32e4be4 100644 --- a/libvips/arithmetic/hough_line.c +++ b/libvips/arithmetic/hough_line.c @@ -169,8 +169,8 @@ vips_hough_line_init( VipsHoughLine *hough_line ) * * Optional arguments: * - * @width: horizontal size of parameter space - * @height: vertical size of parameter space + * * @width: horizontal size of parameter space + * * @height: vertical size of parameter space * * Find the line Hough transform for @in. @in must have one band. @out has one * band, with pixels being the number of votes for that line. The X dimension diff --git a/libvips/arithmetic/linear.c b/libvips/arithmetic/linear.c index 9aba5054..cad7751d 100644 --- a/libvips/arithmetic/linear.c +++ b/libvips/arithmetic/linear.c @@ -448,7 +448,7 @@ vips_linearv( VipsImage *in, VipsImage **out, * * Optional arguments: * - * @uchar: output uchar pixels + * * @uchar: output uchar pixels * * Pass an image through a linear transform, ie. (@out = @in * @a + @b). Output * is float for integer input, double for double input, complex for @@ -489,7 +489,7 @@ vips_linear( VipsImage *in, VipsImage **out, double *a, double *b, int n, ... ) * * Optional arguments: * - * @uchar: output uchar pixels + * * @uchar: output uchar pixels * * Run vips_linear() with a single constant. * diff --git a/libvips/arithmetic/max.c b/libvips/arithmetic/max.c index f5fefc1b..14ba6e0f 100644 --- a/libvips/arithmetic/max.c +++ b/libvips/arithmetic/max.c @@ -486,12 +486,12 @@ vips_max_init( VipsMax *max ) * * Optional arguments: * - * @x: horizontal position of maximum - * @y: vertical position of maximum - * @size: number of maxima to find - * @out_array: return array of maximum values - * @x_array: corresponding horizontal positions - * @y_array: corresponding vertical positions + * * @x: horizontal position of maximum + * * @y: vertical position of maximum + * * @size: number of maxima to find + * * @out_array: return array of maximum values + * * @x_array: corresponding horizontal positions + * * @y_array: corresponding vertical positions * * This operation finds the maximum value in an image. * diff --git a/libvips/arithmetic/measure.c b/libvips/arithmetic/measure.c index 67d6feb6..9e7c881e 100644 --- a/libvips/arithmetic/measure.c +++ b/libvips/arithmetic/measure.c @@ -269,10 +269,10 @@ vips_measure_init( VipsMeasure *measure ) * * Optional arguments: * - * @left: area of image containing chart - * @top: area of image containing chart - * @width: area of image containing chart - * @height: area of image containing chart + * * @left: area of image containing chart + * * @top: area of image containing chart + * * @width: area of image containing chart + * * @height: area of image containing chart * * Analyse a grid of colour patches, producing an array of patch averages. * The mask has a row for each measured patch and a column for each image diff --git a/libvips/arithmetic/min.c b/libvips/arithmetic/min.c index 0c58145e..f2c24e55 100644 --- a/libvips/arithmetic/min.c +++ b/libvips/arithmetic/min.c @@ -489,12 +489,12 @@ vips_min_init( VipsMin *min ) * * Optional arguments: * - * @x: horizontal position of minimum - * @y: vertical position of minimum - * @size: number of minima to find - * @out_array: return array of minimum values - * @x_array: corresponding horizontal positions - * @y_array: corresponding vertical positions + * * @x: horizontal position of minimum + * * @y: vertical position of minimum + * * @size: number of minima to find + * * @out_array: return array of minimum values + * * @x_array: corresponding horizontal positions + * * @y_array: corresponding vertical positions * * This operation finds the minimum value in an image. * diff --git a/libvips/colour/colourspace.c b/libvips/colour/colourspace.c index 298ecc2e..1221c3c2 100644 --- a/libvips/colour/colourspace.c +++ b/libvips/colour/colourspace.c @@ -625,7 +625,7 @@ vips_colourspace_init( VipsColourspace *colourspace ) * * Optional arguments: * - * @source_space: input colour space + * * @source_space: input colour space * * This operation looks at the interpretation field of @in (or uses * @source_space, if set) and runs diff --git a/libvips/colour/icc_transform.c b/libvips/colour/icc_transform.c index b9fbdab7..92c29785 100644 --- a/libvips/colour/icc_transform.c +++ b/libvips/colour/icc_transform.c @@ -1255,10 +1255,10 @@ vips_icc_ac2rc( VipsImage *in, VipsImage **out, const char *profile_filename ) * * Optional arguments: * - * @input_profile: get the input profile from here - * @intent: transform with this intent - * @embedded: use profile embedded in input image - * @pcs: use XYZ or LAB PCS + * * @input_profile: get the input profile from here + * * @intent: transform with this intent + * * @embedded: use profile embedded in input image + * * @pcs: use XYZ or LAB PCS * * Import an image from device space to D65 LAB with an ICC profile. If @pcs is * set to #VIPS_PCS_XYZ, use CIE XYZ PCS instead. @@ -1294,10 +1294,10 @@ vips_icc_import( VipsImage *in, VipsImage **out, ... ) * * Optional arguments: * - * @intent: transform with this intent - * @depth: depth of output image in bits - * @output_profile: get the output profile from here - * @pcs: use XYZ or LAB PCS + * * @intent: transform with this intent + * * @depth: depth of output image in bits + * * @output_profile: get the output profile from here + * * @pcs: use XYZ or LAB PCS * * Export an image from D65 LAB to device space with an ICC profile. * If @pcs is @@ -1330,10 +1330,10 @@ vips_icc_export( VipsImage *in, VipsImage **out, ... ) * * Optional arguments: * - * @input_profile: get the input profile from here - * @intent: transform with this intent - * @depth: depth of output image in bits - * @embedded: use profile embedded in input image + * * @input_profile: get the input profile from here + * * @intent: transform with this intent + * * @depth: depth of output image in bits + * * @embedded: use profile embedded in input image * * Transform an image with a pair of ICC profiles. The input image is moved to * profile-connection space with the input profile and then to the output diff --git a/libvips/colour/scRGB2BW.c b/libvips/colour/scRGB2BW.c index 3d5803a7..19ee0411 100644 --- a/libvips/colour/scRGB2BW.c +++ b/libvips/colour/scRGB2BW.c @@ -268,7 +268,7 @@ vips_scRGB2BW_init( VipsscRGB2BW *scRGB2BW ) * * Optional arguments: * - * @depth: depth of output image in bits + * * @depth: depth of output image in bits * * Convert an scRGB image to greyscale. Set @depth to 16 to get 16-bit output. * diff --git a/libvips/colour/scRGB2sRGB.c b/libvips/colour/scRGB2sRGB.c index 6e3f2a78..83702485 100644 --- a/libvips/colour/scRGB2sRGB.c +++ b/libvips/colour/scRGB2sRGB.c @@ -296,7 +296,7 @@ vips_scRGB2sRGB_init( VipsscRGB2sRGB *scRGB2sRGB ) * * Optional arguments: * - * @depth: depth of output image in bits + * * @depth: depth of output image in bits * * Convert an scRGB image to sRGB. Set @depth to 16 to get 16-bit output. * diff --git a/libvips/conversion/arrayjoin.c b/libvips/conversion/arrayjoin.c index 712791c2..227c28b4 100644 --- a/libvips/conversion/arrayjoin.c +++ b/libvips/conversion/arrayjoin.c @@ -397,13 +397,13 @@ vips_arrayjoinv( VipsImage **in, VipsImage **out, int n, va_list ap ) * * Optional arguments: * - * @across: number of images per row - * @shim: space between images, in pixels - * @background: background ink colour - * @halign: low, centre or high alignment - * @valign: low, centre or high alignment - * @hspacing: horizontal distance between images - * @vspacing: vertical distance between images + * * @across: number of images per row + * * @shim: space between images, in pixels + * * @background: background ink colour + * * @halign: low, centre or high alignment + * * @valign: low, centre or high alignment + * * @hspacing: horizontal distance between images + * * @vspacing: vertical distance between images * * Lay out the images in @in in a grid. The grid is @across images across and * however high is necessary to use up all of @in. Images are set down diff --git a/libvips/conversion/autorot.c b/libvips/conversion/autorot.c index 17ccb120..f25994ee 100644 --- a/libvips/conversion/autorot.c +++ b/libvips/conversion/autorot.c @@ -214,7 +214,7 @@ vips_autorot_init( VipsAutorot *autorot ) * * Optional arguments: * - * @angle: output #VipsAngle the image was rotated by + * * @angle: output #VipsAngle the image was rotated by * * Look at the exif tags and rotate the image to make it upright. The * orientation tag is removed from @out to prevent accidental double rotation. diff --git a/libvips/conversion/bandfold.c b/libvips/conversion/bandfold.c index 81635784..b5a1d309 100644 --- a/libvips/conversion/bandfold.c +++ b/libvips/conversion/bandfold.c @@ -186,7 +186,7 @@ vips_bandfold_init( VipsBandfold *bandfold ) * * Optional arguments: * - * @factor: fold by this factor + * * @factor: fold by this factor * * Fold up an image horizontally: width is collapsed into bands. * Use @factor to set how much to fold by: @factor 3, for example, will make diff --git a/libvips/conversion/bandrank.c b/libvips/conversion/bandrank.c index 8f25f501..06ceb969 100644 --- a/libvips/conversion/bandrank.c +++ b/libvips/conversion/bandrank.c @@ -286,7 +286,7 @@ vips_bandrankv( VipsImage **in, VipsImage **out, int n, va_list ap ) * * Optional arguments: * - * @index: pick this index from list of sorted values + * * @index: pick this index from list of sorted values * * Sorts the images @in band-element-wise, then outputs an * image in which each band element is selected from the sorted list by the diff --git a/libvips/conversion/bandunfold.c b/libvips/conversion/bandunfold.c index ebfb5d53..c0491031 100644 --- a/libvips/conversion/bandunfold.c +++ b/libvips/conversion/bandunfold.c @@ -189,7 +189,7 @@ vips_bandunfold_init( VipsBandunfold *bandunfold ) * * Optional arguments: * - * @factor: unfold by this factor + * * @factor: unfold by this factor * * Unfold image bands into x axis. * Use @factor to set how much to unfold by: @factor 3, for example, will make diff --git a/libvips/conversion/cache.c b/libvips/conversion/cache.c index 52f31790..a7243030 100644 --- a/libvips/conversion/cache.c +++ b/libvips/conversion/cache.c @@ -144,9 +144,9 @@ vips_cache_init( VipsCache *cache ) * * Optional arguments: * - * @tile_width: width of tiles in cache - * @tile_height: height of tiles in cache - * @max_tiles: maximum number of tiles to cache + * * @tile_width: width of tiles in cache + * * @tile_height: height of tiles in cache + * * @max_tiles: maximum number of tiles to cache * * This operation behaves rather like vips_copy() between images * @in and @out, except that it keeps a cache of computed pixels. diff --git a/libvips/conversion/cast.c b/libvips/conversion/cast.c index 4650f1db..f9197478 100644 --- a/libvips/conversion/cast.c +++ b/libvips/conversion/cast.c @@ -587,7 +587,7 @@ vips_castv( VipsImage *in, VipsImage **out, VipsBandFormat format, va_list ap ) * * Optional arguments: * - * @shift: integer values are shifted + * * @shift: integer values are shifted * * Convert @in to @format. You can convert between any pair of formats. * Floats are truncated (not rounded). Out of range values are clipped. diff --git a/libvips/conversion/copy.c b/libvips/conversion/copy.c index b02359bc..eecf9ef5 100644 --- a/libvips/conversion/copy.c +++ b/libvips/conversion/copy.c @@ -366,16 +366,16 @@ vips_copy_init( VipsCopy *copy ) * * Optional arguments: * - * @width: set image width - * @height: set image height - * @bands: set image bands - * @format: set image format - * @coding: set image coding - * @interpretation: set image interpretation - * @xres: set image xres - * @yres: set image yres - * @xoffset: set image xoffset - * @yoffset: set image yoffset + * * @width: set image width + * * @height: set image height + * * @bands: set image bands + * * @format: set image format + * * @coding: set image coding + * * @interpretation: set image interpretation + * * @xres: set image xres + * * @yres: set image yres + * * @xoffset: set image xoffset + * * @yoffset: set image yoffset * * Copy an image, optionally modifying the header. VIPS copies images by * copying pointers, so this operation is instant, even for very large images. diff --git a/libvips/conversion/embed.c b/libvips/conversion/embed.c index 9e77dc85..14c1071d 100644 --- a/libvips/conversion/embed.c +++ b/libvips/conversion/embed.c @@ -627,8 +627,8 @@ vips_embed_init( VipsEmbed *embed ) * * Optional arguments: * - * @extend: #VipsExtend to generate the edge pixels (default: black) - * @background: #VipsArrayDouble colour for edge pixels + * * @extend: #VipsExtend to generate the edge pixels (default: black) + * * @background: #VipsArrayDouble colour for edge pixels * * The opposite of vips_extract_area(): embed @in within an image of size * @width by @height at position @x, @y. diff --git a/libvips/conversion/extract.c b/libvips/conversion/extract.c index 052ea5f5..879efae1 100644 --- a/libvips/conversion/extract.c +++ b/libvips/conversion/extract.c @@ -455,7 +455,7 @@ vips_extract_band_init( VipsExtractBand *extract ) * * Optional arguments: * - * @n: number of bands to extract + * * @n: number of bands to extract * * Extract a band or bands from an image. Extracting out of range is an error. * diff --git a/libvips/conversion/flatten.c b/libvips/conversion/flatten.c index b95e0237..486515d3 100644 --- a/libvips/conversion/flatten.c +++ b/libvips/conversion/flatten.c @@ -409,8 +409,8 @@ vips_flatten_init( VipsFlatten *flatten ) * * Optional arguments: * - * @background: #VipsArrayDouble colour for new pixels - * @max_alpha: %gdouble, maximum value for alpha + * * @background: #VipsArrayDouble colour for new pixels + * * @max_alpha: %gdouble, maximum value for alpha * * Take the last band of @in as an alpha and use it to blend the * remaining channels with @background. diff --git a/libvips/conversion/gamma.c b/libvips/conversion/gamma.c index 4fe6549f..91fe63af 100644 --- a/libvips/conversion/gamma.c +++ b/libvips/conversion/gamma.c @@ -168,7 +168,7 @@ vips_gamma_init( VipsGamma *gamma ) * * Optional arguments: * - * @exponent: gamma, default 1.0 / 2.4 + * * @exponent: gamma, default 1.0 / 2.4 * * Calculate @in ** (1 / @exponent), normalising to the maximum range of the * input type. For float types use 1.0 as the maximum. diff --git a/libvips/conversion/ifthenelse.c b/libvips/conversion/ifthenelse.c index 4b056b2c..eb5bb2b7 100644 --- a/libvips/conversion/ifthenelse.c +++ b/libvips/conversion/ifthenelse.c @@ -517,7 +517,7 @@ vips_ifthenelse_init( VipsIfthenelse *ifthenelse ) * * Optional arguments: * - * @blend: blend smoothly between @in1 and @in2 + * * @blend: blend smoothly between @in1 and @in2 * * This operation scans the condition image @cond * and uses it to select pixels from either the then image @in1 or the else diff --git a/libvips/conversion/insert.c b/libvips/conversion/insert.c index f37dbd68..872c71d4 100644 --- a/libvips/conversion/insert.c +++ b/libvips/conversion/insert.c @@ -573,8 +573,8 @@ vips_insert_init( VipsInsert *insert ) * * Optional arguments: * - * @expand: expand output to hold whole of both images - * @background: colour for new pixels + * * @expand: expand output to hold whole of both images + * * @background: colour for new pixels * * Insert @sub into @main at position @x, @y. * diff --git a/libvips/conversion/join.c b/libvips/conversion/join.c index 8229fbca..7c2ccc57 100644 --- a/libvips/conversion/join.c +++ b/libvips/conversion/join.c @@ -296,10 +296,10 @@ vips_join_init( VipsJoin *join ) * * Optional arguments: * - * @expand: %TRUE to expand the output image to hold all of the input pixels - * @shim: space between images, in pixels - * @background: background ink colour - * @align: low, centre or high alignment + * * @expand: %TRUE to expand the output image to hold all of the input pixels + * * @shim: space between images, in pixels + * * @background: background ink colour + * * @align: low, centre or high alignment * * Join @in1 and @in2 together, left-right or up-down depending on the value * of @direction. diff --git a/libvips/conversion/msb.c b/libvips/conversion/msb.c index 33f931c8..9aeae360 100644 --- a/libvips/conversion/msb.c +++ b/libvips/conversion/msb.c @@ -269,7 +269,7 @@ vips_msb_init( VipsMsb *msb ) * * Optional arguments: * - * @band: msb just this band + * * @band: msb just this band * * Turn any integer image to 8-bit unsigned char by discarding all but the most * significant byte. Signed values are converted to unsigned by adding 128. diff --git a/libvips/conversion/premultiply.c b/libvips/conversion/premultiply.c index 4d842de3..7923100e 100644 --- a/libvips/conversion/premultiply.c +++ b/libvips/conversion/premultiply.c @@ -273,7 +273,7 @@ vips_premultiply_init( VipsPremultiply *premultiply ) * * Optional arguments: * - * @max_alpha: %gdouble, maximum value for alpha + * * @max_alpha: %gdouble, maximum value for alpha * * Premultiplies any alpha channel. * The final band is taken to be the alpha diff --git a/libvips/conversion/rot45.c b/libvips/conversion/rot45.c index c049a5aa..dc0b1be7 100644 --- a/libvips/conversion/rot45.c +++ b/libvips/conversion/rot45.c @@ -291,7 +291,7 @@ vips_rot45_init( VipsRot45 *rot45 ) * * Optional arguments: * - * @angle: rotation angle + * * @angle: rotation angle * * Rotate @in by a multiple of 45 degrees. Odd-length sides and square images * only. diff --git a/libvips/conversion/scale.c b/libvips/conversion/scale.c index af9980a9..492e80a7 100644 --- a/libvips/conversion/scale.c +++ b/libvips/conversion/scale.c @@ -183,8 +183,8 @@ vips_scale_init( VipsScale *scale ) * * Optional arguments: * - * @log: log scale pixels - * @exp: exponent for log scale + * * @log: log scale pixels + * * @exp: exponent for log scale * * Search the image for the maximum and minimum value, then return the image * as unsigned 8-bit, scaled so that the maximum value is 255 and the diff --git a/libvips/conversion/sequential.c b/libvips/conversion/sequential.c index 5db03b3a..c6a6bbfc 100644 --- a/libvips/conversion/sequential.c +++ b/libvips/conversion/sequential.c @@ -364,9 +364,9 @@ vips_sequential_init( VipsSequential *sequential ) * * Optional arguments: * - * @trace: trace requests - * @strip_height: height of cache strips - * @access: access pattern + * * @trace: trace requests + * * @strip_height: height of cache strips + * * @access: access pattern * * This operation behaves rather like vips_copy() between images * @in and @out, except that it checks that pixels are only requested diff --git a/libvips/conversion/subsample.c b/libvips/conversion/subsample.c index bcf1234c..0f5029ac 100644 --- a/libvips/conversion/subsample.c +++ b/libvips/conversion/subsample.c @@ -314,7 +314,7 @@ vips_subsample_init( VipsSubsample *subsample ) * * Optional arguments: * - * @point: turn on point sample mode + * * @point: turn on point sample mode * * Subsample an image by an integer fraction. This is fast, nearest-neighbour * shrink. diff --git a/libvips/conversion/tilecache.c b/libvips/conversion/tilecache.c index c6c6702d..75873485 100644 --- a/libvips/conversion/tilecache.c +++ b/libvips/conversion/tilecache.c @@ -824,12 +824,12 @@ vips_tile_cache_init( VipsTileCache *cache ) * * Optional arguments: * - * @tile_width: width of tiles in cache - * @tile_height: height of tiles in cache - * @max_tiles: maximum number of tiles to cache - * @access: hint expected access pattern #VipsAccess - * @threaded: allow many threads - * @persistent: don't drop cache at end of computation + * * @tile_width: width of tiles in cache + * * @tile_height: height of tiles in cache + * * @max_tiles: maximum number of tiles to cache + * * @access: hint expected access pattern #VipsAccess + * * @threaded: allow many threads + * * @persistent: don't drop cache at end of computation * * This operation behaves rather like vips_copy() between images * @in and @out, except that it keeps a cache of computed pixels. @@ -1018,9 +1018,9 @@ vips_line_cache_init( VipsLineCache *cache ) * * Optional arguments: * - * @access: hint expected access pattern #VipsAccess - * @tile_height: height of tiles in cache - * @threaded: allow many threads + * * @access: hint expected access pattern #VipsAccess + * * @tile_height: height of tiles in cache + * * @threaded: allow many threads * * This operation behaves rather like vips_copy() between images * @in and @out, except that it keeps a cache of computed scanlines. diff --git a/libvips/conversion/unpremultiply.c b/libvips/conversion/unpremultiply.c index 6105d1e5..39f1f86e 100644 --- a/libvips/conversion/unpremultiply.c +++ b/libvips/conversion/unpremultiply.c @@ -283,7 +283,7 @@ vips_unpremultiply_init( VipsUnpremultiply *unpremultiply ) * * Optional arguments: * - * @max_alpha: %gdouble, maximum value for alpha + * * @max_alpha: %gdouble, maximum value for alpha * * Unpremultiplies any alpha channel. * The final band is taken to be the alpha diff --git a/libvips/conversion/wrap.c b/libvips/conversion/wrap.c index 7c02f208..e97ef491 100644 --- a/libvips/conversion/wrap.c +++ b/libvips/conversion/wrap.c @@ -150,8 +150,8 @@ vips_wrap_init( VipsWrap *wrap ) * * Optional arguments: * - * @x: horizontal displacement - * @y: vertical displacement + * * @x: horizontal displacement + * * @y: vertical displacement * * Slice an image up and move the segments about so that the pixel that was * at 0, 0 is now at @x, @y. If @x and @y are not set, they default to the diff --git a/libvips/convolution/conv.c b/libvips/convolution/conv.c index 234e275c..ff7dfd51 100644 --- a/libvips/convolution/conv.c +++ b/libvips/convolution/conv.c @@ -175,9 +175,9 @@ vips_conv_init( VipsConv *conv ) * * Optional arguments: * - * @precision: calculation accuracy - * @layers: number of layers for approximation - * @cluster: cluster lines closer than this distance + * * @precision: calculation accuracy + * * @layers: number of layers for approximation + * * @cluster: cluster lines closer than this distance * * Convolution. * diff --git a/libvips/convolution/convsep.c b/libvips/convolution/convsep.c index dc3ceea2..7838ec41 100644 --- a/libvips/convolution/convsep.c +++ b/libvips/convolution/convsep.c @@ -143,9 +143,9 @@ vips_convsep_init( VipsConvsep *convsep ) * * Optional arguments: * - * @precision: calculation accuracy - * @layers: number of layers for approximation - * @cluster: cluster lines closer than this distance + * * @precision: calculation accuracy + * * @layers: number of layers for approximation + * * @cluster: cluster lines closer than this distance * * Perform a separable convolution of @in with @mask. * See vips_conv() for a detailed description. diff --git a/libvips/convolution/gaussblur.c b/libvips/convolution/gaussblur.c index ccb8c1d9..41800097 100644 --- a/libvips/convolution/gaussblur.c +++ b/libvips/convolution/gaussblur.c @@ -168,8 +168,8 @@ vips_gaussblur_init( VipsGaussblur *gaussblur ) * * Optional arguments: * - * @precision: #VipsPrecision for blur, default VIPS_PRECISION_INTEGER - * @min_ampl: minimum amplitude, default 0.2 + * * @precision: #VipsPrecision for blur, default VIPS_PRECISION_INTEGER + * * @min_ampl: minimum amplitude, default 0.2 * * This operator runs vips_gaussmat() and vips_convsep() for you on an image. * Set @min_ampl smaller to generate a larger, more accurate mask. Set @sigma diff --git a/libvips/convolution/sharpen.c b/libvips/convolution/sharpen.c index 05e6abff..6a260fbe 100644 --- a/libvips/convolution/sharpen.c +++ b/libvips/convolution/sharpen.c @@ -394,12 +394,12 @@ vips_sharpen_init( VipsSharpen *sharpen ) * * Optional arguments: * - * @sigma: sigma of gaussian - * @x1: flat/jaggy threshold - * @y2: maximum amount of brightening - * @y3: maximum amount of darkening - * @m1: slope for flat areas - * @m2: slope for jaggy areas + * * @sigma: sigma of gaussian + * * @x1: flat/jaggy threshold + * * @y2: maximum amount of brightening + * * @y3: maximum amount of darkening + * * @m1: slope for flat areas + * * @m2: slope for jaggy areas * * Selectively sharpen the L channel of a LAB image. The input image is * transformed to #VIPS_INTERPRETATION_LABS. diff --git a/libvips/create/black.c b/libvips/create/black.c index dfa2ede2..65b567ac 100644 --- a/libvips/create/black.c +++ b/libvips/create/black.c @@ -162,7 +162,7 @@ vips_black_init( VipsBlack *black ) * * Optional arguments: * - * @bands: output bands + * * @bands: output bands * * Make a black unsigned char image of a specified size. * diff --git a/libvips/create/eye.c b/libvips/create/eye.c index c429b68e..edac0d3a 100644 --- a/libvips/create/eye.c +++ b/libvips/create/eye.c @@ -123,8 +123,8 @@ vips_eye_init( VipsEye *eye ) * * Optional arguments: * - * @factor: maximum spatial frequency - * @uchar: output a uchar image + * * @factor: maximum spatial frequency + * * @uchar: output a uchar image * * Create a test pattern with increasing spatial frequence in X and * amplitude in Y. @factor should be between 0 and 1 and determines the diff --git a/libvips/create/gaussmat.c b/libvips/create/gaussmat.c index 93623d12..ba41013b 100644 --- a/libvips/create/gaussmat.c +++ b/libvips/create/gaussmat.c @@ -234,8 +234,8 @@ vips_gaussmat_init( VipsGaussmat *gaussmat ) * * Optional arguments: * - * @separable: generate a separable gaussian - * @precision: #VipsPrecision for @out + * * @separable: generate a separable gaussian + * * @precision: #VipsPrecision for @out * * Creates a circularly symmetric Gaussian image of radius * @sigma. The size of the mask is determined by the variable @min_ampl; diff --git a/libvips/create/gaussnoise.c b/libvips/create/gaussnoise.c index 5fee656e..1530905e 100644 --- a/libvips/create/gaussnoise.c +++ b/libvips/create/gaussnoise.c @@ -195,8 +195,8 @@ vips_gaussnoise_init( VipsGaussnoise *gaussnoise ) * * Optional arguments: * - * @mean: mean of generated pixels - * @sigma: standard deviation of generated pixels + * * @mean: mean of generated pixels + * * @sigma: standard deviation of generated pixels * * Make a one band float image of gaussian noise with the specified * distribution. The noise distribution is created by averaging 12 random diff --git a/libvips/create/grey.c b/libvips/create/grey.c index 2c602833..1ec5c58c 100644 --- a/libvips/create/grey.c +++ b/libvips/create/grey.c @@ -107,7 +107,7 @@ vips_grey_init( VipsGrey *grey ) * * Optional arguments: * - * @uchar: output a uchar image + * * @uchar: output a uchar image * * Create a one-band float image with the left-most column zero and the * right-most 1. Intermediate pixels are a linear ramp. diff --git a/libvips/create/identity.c b/libvips/create/identity.c index d596bd12..90241667 100644 --- a/libvips/create/identity.c +++ b/libvips/create/identity.c @@ -178,9 +178,9 @@ vips_identity_init( VipsIdentity *identity ) * * Optional arguments: * - * @bands: number of bands to create - * @ushort: %TRUE for an unsigned short identity - * @size: number of LUT elements for a ushort image + * * @bands: number of bands to create + * * @ushort: %TRUE for an unsigned short identity + * * @size: number of LUT elements for a ushort image * * Creates an identity lookup table, ie. one which will leave an image * unchanged when applied with vips_maplut(). Each entry in the table has a diff --git a/libvips/create/invertlut.c b/libvips/create/invertlut.c index e9c9b2b0..d2e99795 100644 --- a/libvips/create/invertlut.c +++ b/libvips/create/invertlut.c @@ -314,7 +314,7 @@ vips_invertlut_init( VipsInvertlut *lut ) * * Optional arguments: * - * @size: generate this much + * * @size: generate this much * * Given a mask of target values and real values, generate a LUT which * will map reals to targets. Handy for linearising images from diff --git a/libvips/create/logmat.c b/libvips/create/logmat.c index 64520504..db4384eb 100644 --- a/libvips/create/logmat.c +++ b/libvips/create/logmat.c @@ -251,8 +251,8 @@ vips_logmat_init( VipsLogmat *logmat ) * * Optional arguments: * - * @separable: generate a separable mask - * @precision: #VipsPrecision for @out + * * @separable: generate a separable mask + * * @precision: #VipsPrecision for @out * * Creates a circularly symmetric Laplacian of Gaussian mask * of radius diff --git a/libvips/create/mask_butterworth.c b/libvips/create/mask_butterworth.c index 3e6c7f0a..35a75316 100644 --- a/libvips/create/mask_butterworth.c +++ b/libvips/create/mask_butterworth.c @@ -127,10 +127,10 @@ vips_mask_butterworth_init( VipsMaskButterworth *butterworth ) * * Optional arguments: * - * @nodc: don't set the DC pixel - * @reject: invert the filter sense - * @optical: coordinates in optical space - * @uchar: output a uchar image + * * @nodc: don't set the DC pixel + * * @reject: invert the filter sense + * * @optical: coordinates in optical space + * * @uchar: output a uchar image * * Make an butterworth high- or low-pass filter, that is, one with a variable, * smooth transition diff --git a/libvips/create/mask_butterworth_band.c b/libvips/create/mask_butterworth_band.c index e29347d9..dd3e8865 100644 --- a/libvips/create/mask_butterworth_band.c +++ b/libvips/create/mask_butterworth_band.c @@ -171,10 +171,10 @@ vips_mask_butterworth_band_init( * * Optional arguments: * - * @nodc: don't set the DC pixel - * @reject: invert the filter sense - * @optical: coordinates in optical space - * @uchar: output a uchar image + * * @nodc: don't set the DC pixel + * * @reject: invert the filter sense + * * @optical: coordinates in optical space + * * @uchar: output a uchar image * * Make an butterworth band-pass or band-reject filter, that is, one with a * variable, smooth transition positioned at @frequency_cutoff_x, diff --git a/libvips/create/mask_butterworth_ring.c b/libvips/create/mask_butterworth_ring.c index cd3e7ec9..b5b252de 100644 --- a/libvips/create/mask_butterworth_ring.c +++ b/libvips/create/mask_butterworth_ring.c @@ -131,10 +131,10 @@ vips_mask_butterworth_ring_init( * * Optional arguments: * - * @nodc: don't set the DC pixel - * @reject: invert the filter sense - * @optical: coordinates in optical space - * @uchar: output a uchar image + * * @nodc: don't set the DC pixel + * * @reject: invert the filter sense + * * @optical: coordinates in optical space + * * @uchar: output a uchar image * * Make a butterworth ring-pass or ring-reject filter, that is, one with a * variable, diff --git a/libvips/create/mask_fractal.c b/libvips/create/mask_fractal.c index 48b08b96..9031a415 100644 --- a/libvips/create/mask_fractal.c +++ b/libvips/create/mask_fractal.c @@ -114,10 +114,10 @@ vips_mask_fractal_init( VipsMaskFractal *fractal ) * * Optional arguments: * - * @nodc: don't set the DC pixel - * @reject: invert the filter sense - * @optical: coordinates in optical space - * @uchar: output a uchar image + * * @nodc: don't set the DC pixel + * * @reject: invert the filter sense + * * @optical: coordinates in optical space + * * @uchar: output a uchar image * * This operation should be used to create fractal images by filtering the * power spectrum of Gaussian white noise. See vips_gaussnoise(). diff --git a/libvips/create/mask_gaussian.c b/libvips/create/mask_gaussian.c index d59f5fc8..6dcf7372 100644 --- a/libvips/create/mask_gaussian.c +++ b/libvips/create/mask_gaussian.c @@ -116,10 +116,10 @@ vips_mask_gaussian_init( VipsMaskGaussian *gaussian ) * * Optional arguments: * - * @nodc: don't set the DC pixel - * @reject: invert the filter sense - * @optical: coordinates in optical space - * @uchar: output a uchar image + * * @nodc: don't set the DC pixel + * * @reject: invert the filter sense + * * @optical: coordinates in optical space + * * @uchar: output a uchar image * * Make a gaussian high- or low-pass filter, that is, one with a variable, * smooth transition positioned at @frequency_cutoff. diff --git a/libvips/create/mask_gaussian_band.c b/libvips/create/mask_gaussian_band.c index 22dda78c..7218affd 100644 --- a/libvips/create/mask_gaussian_band.c +++ b/libvips/create/mask_gaussian_band.c @@ -155,10 +155,10 @@ vips_mask_gaussian_band_init( VipsMaskGaussianBand *gaussian_band ) * * Optional arguments: * - * @nodc: don't set the DC pixel - * @reject: invert the filter sense - * @optical: coordinates in optical space - * @uchar: output a uchar image + * * @nodc: don't set the DC pixel + * * @reject: invert the filter sense + * * @optical: coordinates in optical space + * * @uchar: output a uchar image * * Make a gaussian band-pass or band-reject filter, that is, one with a * variable, smooth transition positioned at @frequency_cutoff_x, diff --git a/libvips/create/mask_gaussian_ring.c b/libvips/create/mask_gaussian_ring.c index c99a0b18..8afcf5d2 100644 --- a/libvips/create/mask_gaussian_ring.c +++ b/libvips/create/mask_gaussian_ring.c @@ -124,10 +124,10 @@ vips_mask_gaussian_ring_init( VipsMaskGaussianRing *gaussian_ring ) * * Optional arguments: * - * @nodc: don't set the DC pixel - * @reject: invert the filter sense - * @optical: coordinates in optical space - * @uchar: output a uchar image + * * @nodc: don't set the DC pixel + * * @reject: invert the filter sense + * * @optical: coordinates in optical space + * * @uchar: output a uchar image * * Make a gaussian ring-pass or ring-reject filter, that is, one with a * variable, smooth transition positioned at @frequency_cutoff of width diff --git a/libvips/create/mask_ideal.c b/libvips/create/mask_ideal.c index d8c5fc92..cce19192 100644 --- a/libvips/create/mask_ideal.c +++ b/libvips/create/mask_ideal.c @@ -105,10 +105,10 @@ vips_mask_ideal_init( VipsMaskIdeal *ideal ) * * Optional arguments: * - * @nodc: don't set the DC pixel - * @reject: invert the filter sense - * @optical: coordinates in optical space - * @uchar: output a uchar image + * * @nodc: don't set the DC pixel + * * @reject: invert the filter sense + * * @optical: coordinates in optical space + * * @uchar: output a uchar image * * Make an ideal high- or low-pass filter, that is, one with a sharp cutoff * positioned at @frequency_cutoff, where @frequency_cutoff is in diff --git a/libvips/create/mask_ideal_band.c b/libvips/create/mask_ideal_band.c index 365712f0..6675b44e 100644 --- a/libvips/create/mask_ideal_band.c +++ b/libvips/create/mask_ideal_band.c @@ -137,10 +137,10 @@ vips_mask_ideal_band_init( VipsMaskIdealBand *ideal_band ) * * Optional arguments: * - * @nodc: don't set the DC pixel - * @reject: invert the filter sense - * @optical: coordinates in optical space - * @uchar: output a uchar image + * * @nodc: don't set the DC pixel + * * @reject: invert the filter sense + * * @optical: coordinates in optical space + * * @uchar: output a uchar image * * Make an ideal band-pass or band-reject filter, that is, one with a * sharp cutoff around the point @frequency_cutoff_x, @frequency_cutoff_y, diff --git a/libvips/create/mask_ideal_ring.c b/libvips/create/mask_ideal_ring.c index 32e5b4ee..20e3831b 100644 --- a/libvips/create/mask_ideal_ring.c +++ b/libvips/create/mask_ideal_ring.c @@ -120,10 +120,10 @@ vips_mask_ideal_ring_init( VipsMaskIdealRing *ideal_ring ) * * Optional arguments: * - * @nodc: don't set the DC pixel - * @reject: invert the filter sense - * @optical: coordinates in optical space - * @uchar: output a uchar image + * * @nodc: don't set the DC pixel + * * @reject: invert the filter sense + * * @optical: coordinates in optical space + * * @uchar: output a uchar image * * Make an ideal ring-pass or ring-reject filter, that is, one with a sharp * ring positioned at @frequency_cutoff of width @width, where diff --git a/libvips/create/sines.c b/libvips/create/sines.c index 5511b984..8a60cfb8 100644 --- a/libvips/create/sines.c +++ b/libvips/create/sines.c @@ -154,9 +154,9 @@ vips_sines_init( VipsSines *sines ) * * Optional arguments: * - * @hfreq: horizontal frequency - * @vreq: vertical frequency - * @uchar: output a uchar image + * * @hfreq: horizontal frequency + * * @vreq: vertical frequency + * * @uchar: output a uchar image * * Creates a float one band image of the a sine waveform in two * dimensions. diff --git a/libvips/create/text.c b/libvips/create/text.c index 4ca4e000..90344c6c 100644 --- a/libvips/create/text.c +++ b/libvips/create/text.c @@ -341,11 +341,11 @@ vips_text_init( VipsText *text ) * * Optional arguments: * - * @font: font to render with - * @width: render within this many pixels across - * @alignment: left/centre/right alignment - * @dpi: render at this resolution - * @spacing: space lines by this in points + * * @font: font to render with + * * @width: render within this many pixels across + * * @alignment: left/centre/right alignment + * * @dpi: render at this resolution + * * @spacing: space lines by this in points * * Draw the string @text to an image. @out is a one-band 8-bit * unsigned char image, with 0 for no text and 255 for text. Values inbetween diff --git a/libvips/create/tonelut.c b/libvips/create/tonelut.c index 096221ae..b0e724c2 100644 --- a/libvips/create/tonelut.c +++ b/libvips/create/tonelut.c @@ -315,16 +315,16 @@ vips_tonelut_init( VipsTonelut *lut ) * * Optional arguments: * - * @in_max: input range - * @out_max: output range - * @Lb: black-point [0-100] - * @Lw: white-point [0-100] - * @Ps: shadow point (eg. 0.2) - * @Pm: mid-tone point (eg. 0.5) - * @Ph: highlight point (eg. 0.8) - * @S: shadow adjustment (+/- 30) - * @M: mid-tone adjustment (+/- 30) - * @H: highlight adjustment (+/- 30) + * * @in_max: input range + * * @out_max: output range + * * @Lb: black-point [0-100] + * * @Lw: white-point [0-100] + * * @Ps: shadow point (eg. 0.2) + * * @Pm: mid-tone point (eg. 0.5) + * * @Ph: highlight point (eg. 0.8) + * * @S: shadow adjustment (+/- 30) + * * @M: mid-tone adjustment (+/- 30) + * * @H: highlight adjustment (+/- 30) * * vips_tonelut() generates a tone curve for the adjustment of image * levels. It is mostly designed for adjusting the L* part of a LAB image in diff --git a/libvips/create/xyz.c b/libvips/create/xyz.c index 852de729..e00b5b22 100644 --- a/libvips/create/xyz.c +++ b/libvips/create/xyz.c @@ -246,9 +246,9 @@ vips_xyz_init( VipsXyz *xyz ) * * Optional arguments: * - * @csize: size for third dimension - * @dsize: size for fourth dimension - * @esize: size for fifth dimension + * * @csize: size for third dimension + * * @dsize: size for fourth dimension + * * @esize: size for fifth dimension * * Create a two-band uint32 image where the elements in the first band have the * value of their x coordinate and elements in the second band have their y diff --git a/libvips/create/zone.c b/libvips/create/zone.c index 53f90494..1f44afdb 100644 --- a/libvips/create/zone.c +++ b/libvips/create/zone.c @@ -106,7 +106,7 @@ vips_zone_init( VipsZone *zone ) * * Optional arguments: * - * @uchar: output a uchar image + * * @uchar: output a uchar image * * Create a one-band image of a zone plate. * diff --git a/libvips/draw/draw_circle.c b/libvips/draw/draw_circle.c index a772e753..dee81e6f 100644 --- a/libvips/draw/draw_circle.c +++ b/libvips/draw/draw_circle.c @@ -294,7 +294,7 @@ vips_draw_circlev( VipsImage *image, * * Optional arguments: * - * @fill: fill the draw_circle + * * @fill: fill the draw_circle * * Draws a circle on @image. If @fill is %TRUE then the circle is filled, * otherwise a 1-pixel-wide perimeter is drawn. @@ -330,7 +330,7 @@ vips_draw_circle( VipsImage *image, * * Optional arguments: * - * @fill: fill the draw_circle + * * @fill: fill the draw_circle * * As vips_draw_circle(), but just takes a single double for @ink. * diff --git a/libvips/draw/draw_flood.c b/libvips/draw/draw_flood.c index 8f5f5029..7c1bf36f 100644 --- a/libvips/draw/draw_flood.c +++ b/libvips/draw/draw_flood.c @@ -685,12 +685,12 @@ vips_draw_floodv( VipsImage *image, * * Optional arguments: * - * @test: test this image - * @equal: fill while equal to edge - * @left: output left edge of bounding box of modified area - * @top: output top edge of bounding box of modified area - * @width: output width of bounding box of modified area - * @height: output height of bounding box of modified area + * * @test: test this image + * * @equal: fill while equal to edge + * * @left: output left edge of bounding box of modified area + * * @top: output top edge of bounding box of modified area + * * @width: output width of bounding box of modified area + * * @height: output height of bounding box of modified area * * Flood-fill @image with @ink, starting at position @x, @y. The filled area is * bounded by pixels that are equal to the ink colour, in other words, it @@ -736,12 +736,12 @@ vips_draw_flood( VipsImage *image, * * Optional arguments: * - * @test: test this image - * @equal: fill while equal to edge - * @left: output left edge of bounding box of modified area - * @top: output top edge of bounding box of modified area - * @width: output width of bounding box of modified area - * @height: output height of bounding box of modified area + * * @test: test this image + * * @equal: fill while equal to edge + * * @left: output left edge of bounding box of modified area + * * @top: output top edge of bounding box of modified area + * * @width: output width of bounding box of modified area + * * @height: output height of bounding box of modified area * * As vips_draw_flood(), but just takes a single double for @ink. * diff --git a/libvips/draw/draw_image.c b/libvips/draw/draw_image.c index c56bd486..3f9aa053 100644 --- a/libvips/draw/draw_image.c +++ b/libvips/draw/draw_image.c @@ -300,7 +300,7 @@ vips_draw_image_init( VipsDrawImage *draw_image ) * * Optional arguments: * - * @mode: how to combine pixels + * * @mode: how to combine pixels * * Draw @sub on top of @image at position @x, @y. The two images must have the * same Coding. If @sub has 1 band, the bands will be duplicated to match the diff --git a/libvips/draw/draw_rect.c b/libvips/draw/draw_rect.c index decb1cc5..261c6517 100644 --- a/libvips/draw/draw_rect.c +++ b/libvips/draw/draw_rect.c @@ -240,7 +240,7 @@ vips_draw_rectv( VipsImage *image, * * Optional arguments: * - * @fill: fill the rect + * * @fill: fill the rect * * Paint pixels within @left, @top, @width, @height in @image with @ink. If * @fill is zero, just paint a 1-pixel-wide outline. @@ -276,7 +276,7 @@ vips_draw_rect( VipsImage *image, * * Optional arguments: * - * @fill: fill the rect + * * @fill: fill the rect * * As vips_draw_rect(), but just take a single double for @ink. * diff --git a/libvips/foreign/csvload.c b/libvips/foreign/csvload.c index ad1b3646..d4deed4b 100644 --- a/libvips/foreign/csvload.c +++ b/libvips/foreign/csvload.c @@ -187,10 +187,10 @@ vips_foreign_load_csv_init( VipsForeignLoadCsv *csv ) * * Optional arguments: * - * @skip: skip this many lines at start of file - * @lines: read this many lines from file - * @whitespace: set of whitespace characters - * @separator: set of separator characters + * * @skip: skip this many lines at start of file + * * @lines: read this many lines from file + * * @whitespace: set of whitespace characters + * * @separator: set of separator characters * * Load a CSV (comma-separated values) file. The output image is always 1 * band (monochrome), #VIPS_FORMAT_DOUBLE. Use vips_bandfold() to turn diff --git a/libvips/foreign/csvsave.c b/libvips/foreign/csvsave.c index 11aa2ae6..483d2fb3 100644 --- a/libvips/foreign/csvsave.c +++ b/libvips/foreign/csvsave.c @@ -128,7 +128,7 @@ vips_foreign_save_csv_init( VipsForeignSaveCsv *csv ) * * Optional arguments: * - * @separator: separator string + * * @separator: separator string * * Writes the pixels in @in to the @filename as CSV (comma-separated values). * The image is written diff --git a/libvips/foreign/dzsave.c b/libvips/foreign/dzsave.c index 44b321e3..c4eee553 100644 --- a/libvips/foreign/dzsave.c +++ b/libvips/foreign/dzsave.c @@ -2047,16 +2047,16 @@ vips_foreign_save_dz_init( VipsForeignSaveDz *dz ) * * Optional arguments: * - * @layout; directory layout convention - * @suffix: suffix for tile tiles - * @overlap; set tile overlap - * @tile_size; set tile size - * @background: background colour - * @depth: how deep to make the pyramid - * @centre: centre the tiles - * @angle: rotate the image by this much - * @container: set container type - * @properties: write a properties file + * * @layout; directory layout convention + * * @suffix: suffix for tile tiles + * * @overlap; set tile overlap + * * @tile_size; set tile size + * * @background: background colour + * * @depth: how deep to make the pyramid + * * @centre: centre the tiles + * * @angle: rotate the image by this much + * * @container: set container type + * * @properties: write a properties file * * Save an image as a set of tiles at various resolutions. By default dzsave * uses DeepZoom layout -- use @layout to pick other conventions. diff --git a/libvips/foreign/foreign.c b/libvips/foreign/foreign.c index 2b7cffdc..2a92516b 100644 --- a/libvips/foreign/foreign.c +++ b/libvips/foreign/foreign.c @@ -1823,8 +1823,8 @@ vips_vipssave( VipsImage *in, const char *filename, ... ) * * Optional arguments: * - * @all_frames: %gboolean, load all frames in sequence - * @density: string, canvas resolution for rendering vector formats like SVG + * * @all_frames: %gboolean, load all frames in sequence + * * @density: string, canvas resolution for rendering vector formats like SVG * * Read in an image using libMagick, the ImageMagick library. This library can * read more than 80 file formats, including SVG, BMP, EPS, DICOM and many @@ -1870,8 +1870,8 @@ vips_magickload( const char *filename, VipsImage **out, ... ) * * Optional arguments: * - * @all_frames: %gboolean, load all frames in sequence - * @density: string, canvas resolution for rendering vector formats like SVG + * * @all_frames: %gboolean, load all frames in sequence + * * @density: string, canvas resolution for rendering vector formats like SVG * * Read an image memory block using libMagick into a VIPS image. Exactly as * vips_magickload(), but read from a memory source. @@ -1911,7 +1911,7 @@ vips_magickload_buffer( void *buf, size_t len, VipsImage **out, ... ) * * Optional arguments: * - * @page: int, load this page + * * @page: int, load this page * * Read a TIFF file into a VIPS image. It is a full baseline TIFF 6 reader, * with extensions for tiled images, multipage images, LAB colour space, @@ -1949,7 +1949,7 @@ vips_tiffload( const char *filename, VipsImage **out, ... ) * * Optional arguments: * - * @page: %gint, load this page + * * @page: %gint, load this page * * Read a TIFF-formatted memory block into a VIPS image. Exactly as * vips_tiffload(), but read from a memory source. @@ -1989,20 +1989,20 @@ vips_tiffload_buffer( void *buf, size_t len, VipsImage **out, ... ) * * Optional arguments: * - * @compression: use this #VipsForeignTiffCompression - * @Q: %gint quality factor - * @predictor: use this #VipsForeignTiffPredictor - * @profile: filename of ICC profile to attach - * @tile: set %TRUE to write a tiled tiff - * @tile_width: %gint for tile size - * @tile_height: %gint for tile size - * @pyramid: set %TRUE to write an image pyramid - * @squash: set %TRUE to squash 8-bit images down to 1 bit - * @miniswhite: set %TRUE to write 1-bit images as MINISWHITE - * @resunit: #VipsForeignTiffResunit for resolution unit - * @xres: %gdouble horizontal resolution in pixels/mm - * @yres: %gdouble vertical resolution in pixels/mm - * @bigtiff: set %TRUE to write a BigTiff file + * * @compression: use this #VipsForeignTiffCompression + * * @Q: %gint quality factor + * * @predictor: use this #VipsForeignTiffPredictor + * * @profile: filename of ICC profile to attach + * * @tile: set %TRUE to write a tiled tiff + * * @tile_width: %gint for tile size + * * @tile_height: %gint for tile size + * * @pyramid: set %TRUE to write an image pyramid + * * @squash: set %TRUE to squash 8-bit images down to 1 bit + * * @miniswhite: set %TRUE to write 1-bit images as MINISWHITE + * * @resunit: #VipsForeignTiffResunit for resolution unit + * * @xres: %gdouble horizontal resolution in pixels/mm + * * @yres: %gdouble vertical resolution in pixels/mm + * * @bigtiff: set %TRUE to write a BigTiff file * * Write a VIPS image to a file as TIFF. * @@ -2089,9 +2089,9 @@ vips_tiffsave( VipsImage *in, const char *filename, ... ) * * Optional arguments: * - * @shrink: %gint, shrink by this much on load - * @fail: %gboolean, fail on warnings - * @autorotate: %gboolean, use exif Orientation tag to rotate the image during load + * * @shrink: %gint, shrink by this much on load + * * @fail: %gboolean, fail on warnings + * * @autorotate: %gboolean, use exif Orientation tag to rotate the image during load * * Read a JPEG file into a VIPS image. It can read most 8-bit JPEG images, * including CMYK and YCbCr. @@ -2167,8 +2167,8 @@ vips_jpegload( const char *filename, VipsImage **out, ... ) * * Optional arguments: * - * @shrink: %gint, shrink by this much on load - * @fail: %gboolean, fail on warnings + * * @shrink: %gint, shrink by this much on load + * * @fail: %gboolean, fail on warnings * * Read a JPEG-formatted memory block into a VIPS image. Exactly as * vips_jpegload(), but read from a memory buffer. @@ -2208,15 +2208,15 @@ vips_jpegload_buffer( void *buf, size_t len, VipsImage **out, ... ) * * Optional arguments: * - * @Q: %gint, quality factor - * @profile: filename of ICC profile to attach - * @optimize_coding: %gboolean, compute optimal Huffman coding tables - * @interlace: %gboolean, write an interlaced (progressive) jpeg - * @strip: %gboolean, remove all metadata from image - * @no-subsample: %gboolean, disable chroma subsampling - * @trellis_quant: %gboolean, apply trellis quantisation to each 8x8 block - * @overshoot_deringing: %gboolean, overshoot samples with extreme values - * @optimize_scans: %gboolean, split DCT coefficients into separate scans + * * @Q: %gint, quality factor + * * @profile: filename of ICC profile to attach + * * @optimize_coding: %gboolean, compute optimal Huffman coding tables + * * @interlace: %gboolean, write an interlaced (progressive) jpeg + * * @strip: %gboolean, remove all metadata from image + * * @no-subsample: %gboolean, disable chroma subsampling + * * @trellis_quant: %gboolean, apply trellis quantisation to each 8x8 block + * * @overshoot_deringing: %gboolean, overshoot samples with extreme values + * * @optimize_scans: %gboolean, split DCT coefficients into separate scans * * Write a VIPS image to a file as JPEG. * @@ -2294,15 +2294,15 @@ vips_jpegsave( VipsImage *in, const char *filename, ... ) * * Optional arguments: * - * @Q: JPEG quality factor - * @profile: attach this ICC profile - * @optimize_coding: compute optimal Huffman coding tables - * @interlace: write an interlaced (progressive) jpeg - * @strip: remove all metadata from image - * @no-subsample: disable chroma subsampling - * @trellis_quant: %gboolean, apply trellis quantisation to each 8x8 block - * @overshoot_deringing: %gboolean, overshoot samples with extreme values - * @optimize_scans: %gboolean, split DCT coefficients into separate scans + * * @Q: JPEG quality factor + * * @profile: attach this ICC profile + * * @optimize_coding: compute optimal Huffman coding tables + * * @interlace: write an interlaced (progressive) jpeg + * * @strip: remove all metadata from image + * * @no-subsample: disable chroma subsampling + * * @trellis_quant: %gboolean, apply trellis quantisation to each 8x8 block + * * @overshoot_deringing: %gboolean, overshoot samples with extreme values + * * @optimize_scans: %gboolean, split DCT coefficients into separate scans * * As vips_jpegsave(), but save to a memory buffer. * @@ -2349,14 +2349,14 @@ vips_jpegsave_buffer( VipsImage *in, void **buf, size_t *len, ... ) * * Optional arguments: * - * @Q: JPEG quality factor - * @profile: attach this ICC profile - * @optimize_coding: compute optimal Huffman coding tables - * @strip: remove all metadata from image - * @no-subsample: disable chroma subsampling - * @trellis_quant: %gboolean, apply trellis quantisation to each 8x8 block - * @overshoot_deringing: %gboolean, overshoot samples with extreme values - * @optimize_scans: %gboolean, split DCT coefficients into separate scans + * * @Q: JPEG quality factor + * * @profile: attach this ICC profile + * * @optimize_coding: compute optimal Huffman coding tables + * * @strip: remove all metadata from image + * * @no-subsample: disable chroma subsampling + * * @trellis_quant: %gboolean, apply trellis quantisation to each 8x8 block + * * @overshoot_deringing: %gboolean, overshoot samples with extreme values + * * @optimize_scans: %gboolean, split DCT coefficients into separate scans * * As vips_jpegsave(), but save as a mime jpeg on stdout. * @@ -2385,7 +2385,7 @@ vips_jpegsave_mime( VipsImage *in, ... ) * * Optional arguments: * - * @shrink: %gint, shrink by this much on load + * * @shrink: %gint, shrink by this much on load * * Read a WebP file into a VIPS image. * @@ -2417,7 +2417,7 @@ vips_webpload( const char *filename, VipsImage **out, ... ) * * Optional arguments: * - * @shrink: %gint, shrink by this much on load + * * @shrink: %gint, shrink by this much on load * * Read a WebP-formatted memory block into a VIPS image. Exactly as * vips_webpload(), but read from a memory buffer. @@ -2505,12 +2505,12 @@ vips_webpsave( VipsImage *in, const char *filename, ... ) * * Optional arguments: * - * @Q: %gint quality factor - * @lossless: %gboolean enables lossless compression - * @preset: #VipsForeignWebpPreset choose lossy compression preset - * @smart_subsample: %gboolean enables high quality chroma subsampling - * @near_lossless: %gboolean use preprocessing in lossless mode (controlled by Q) - * @alpha_q: %gint set alpha quality in lossless mode + * * @Q: %gint quality factor + * * @lossless: %gboolean enables lossless compression + * * @preset: #VipsForeignWebpPreset choose lossy compression preset + * * @smart_subsample: %gboolean enables high quality chroma subsampling + * * @near_lossless: %gboolean use preprocessing in lossless mode (controlled by Q) + * * @alpha_q: %gint set alpha quality in lossless mode * * As vips_webpsave(), but save to a memory buffer. * @@ -2557,12 +2557,12 @@ vips_webpsave_buffer( VipsImage *in, void **buf, size_t *len, ... ) * * Optional arguments: * - * @Q: %gint quality factor - * @lossless: %gboolean enables lossless compression - * @preset: #VipsForeignWebpPreset choose lossy compression preset - * @smart_subsample: %gboolean enables high quality chroma subsampling - * @near_lossless: %gboolean use preprocessing in lossless mode (controlled by Q) - * @alpha_q: %gint set alpha quality in lossless mode + * * @Q: %gint quality factor + * * @lossless: %gboolean enables lossless compression + * * @preset: #VipsForeignWebpPreset choose lossy compression preset + * * @smart_subsample: %gboolean enables high quality chroma subsampling + * * @near_lossless: %gboolean use preprocessing in lossless mode (controlled by Q) + * * @alpha_q: %gint set alpha quality in lossless mode * * As vips_webpsave(), but save as a mime webp on stdout. * @@ -2623,9 +2623,9 @@ vips_openexrload( const char *filename, VipsImage **out, ... ) * * Optional arguments: * - * @level: load this level - * @associated: load this associated image - * @autocrop: crop to image bounds + * * @level: load this level + * * @associated: load this associated image + * * @autocrop: crop to image bounds * * Read a virtual slide supported by the OpenSlide library into a VIPS image. * OpenSlide supports images in Aperio, Hamamatsu, MIRAX, Sakura, Trestle, @@ -2726,8 +2726,6 @@ vips_fitssave( VipsImage *in, const char *filename, ... ) * @out: decompressed image * @...: %NULL-terminated list of optional named arguments * - * Optional arguments: - * * Read a PNG file into a VIPS image. It can read all png images, including 8- * and 16-bit images, 1 and 3 channel, with and without an alpha channel. * @@ -2798,10 +2796,10 @@ vips_pngload_buffer( void *buf, size_t len, VipsImage **out, ... ) * * Optional arguments: * - * @compression: compression level - * @interlace: interlace image - * @profile: ICC profile to embed - * @filter: #VipsForeignPngFilter row filter flag(s) + * * @compression: compression level + * * @interlace: interlace image + * * @profile: ICC profile to embed + * * @filter: #VipsForeignPngFilter row filter flag(s) * * Write a VIPS image to a file as PNG. * @@ -2854,10 +2852,10 @@ vips_pngsave( VipsImage *in, const char *filename, ... ) * * Optional arguments: * - * @compression: compression level - * @interlace: interlace image - * @profile: ICC profile to embed - * @filter: libpng row filter flag(s) + * * @compression: compression level + * * @interlace: interlace image + * * @profile: ICC profile to embed + * * @filter: libpng row filter flag(s) * * As vips_pngsave(), but save to a memory buffer. * @@ -2935,9 +2933,9 @@ vips_matload( const char *filename, VipsImage **out, ... ) * * Optional arguments: * - * @page: %gint, load this page, numbered from zero - * @dpi: %gdouble, render at this DPI - * @scale: %gdouble, scale render by this factor + * * @page: %gint, load this page, numbered from zero + * * @dpi: %gdouble, render at this DPI + * * @scale: %gdouble, scale render by this factor * * Render a PDF file into a VIPS image. Rendering uses the libpoppler library * and should be fast. @@ -2996,9 +2994,9 @@ vips_pdfload( const char *filename, VipsImage **out, ... ) * * Optional arguments: * - * @page: %gint, load this page, numbered from zero - * @dpi: %gdouble, render at this DPI - * @scale: %gdouble, scale render by this factor + * * @page: %gint, load this page, numbered from zero + * * @dpi: %gdouble, render at this DPI + * * @scale: %gdouble, scale render by this factor * * Read a PDF-formatted memory block into a VIPS image. Exactly as * vips_pdfload(), but read from a memory buffer. @@ -3038,8 +3036,8 @@ vips_pdfload_buffer( void *buf, size_t len, VipsImage **out, ... ) * * Optional arguments: * - * @dpi: %gdouble, render at this DPI - * @scale: %gdouble, scale render by this factor + * * @dpi: %gdouble, render at this DPI + * * @scale: %gdouble, scale render by this factor * * Render a SVG file into a VIPS image. Rendering uses the librsvg library * and should be fast. @@ -3076,8 +3074,8 @@ vips_svgload( const char *filename, VipsImage **out, ... ) * * Optional arguments: * - * @dpi: %gdouble, render at this DPI - * @scale: %gdouble, scale render by this factor + * * @dpi: %gdouble, render at this DPI + * * @scale: %gdouble, scale render by this factor * * Read a SVG-formatted memory block into a VIPS image. Exactly as * vips_svgload(), but read from a memory buffer. @@ -3117,7 +3115,7 @@ vips_svgload_buffer( void *buf, size_t len, VipsImage **out, ... ) * * Optional arguments: * - * @page: %ginit, page (frame) to read + * * @page: %ginit, page (frame) to read * * Read a GIF file into a VIPS image. Rendering uses the giflib library. * @@ -3152,7 +3150,7 @@ vips_gifload( const char *filename, VipsImage **out, ... ) * * Optional arguments: * - * @page: %ginit, page (frame) to read + * * @page: %ginit, page (frame) to read * * Read a GIF-formatted memory block into a VIPS image. Exactly as * vips_gifload(), but read from a memory buffer. diff --git a/libvips/foreign/ppmsave.c b/libvips/foreign/ppmsave.c index 178011af..f6ac8988 100644 --- a/libvips/foreign/ppmsave.c +++ b/libvips/foreign/ppmsave.c @@ -156,8 +156,8 @@ vips_foreign_save_ppm_init( VipsForeignSavePpm *ppm ) * * Optional arguments: * - * @ascii: save as ASCII rather than binary - * @squash: squash 8-bit images down to one bit + * * @ascii: save as ASCII rather than binary + * * @squash: squash 8-bit images down to one bit * * Write a VIPS image to a file as PPM. It can write 1, 8, 16 or * 32 bit unsigned integer images, float images, colour or monochrome, diff --git a/libvips/foreign/rawload.c b/libvips/foreign/rawload.c index 98cf4ec5..e6dd73d5 100644 --- a/libvips/foreign/rawload.c +++ b/libvips/foreign/rawload.c @@ -165,7 +165,7 @@ vips_foreign_load_raw_init( VipsForeignLoadRaw *raw ) * * Optional arguments: * - * @offset: offset in bytes from start of file + * * @offset: offset in bytes from start of file * * This operation mmaps the file, setting @out so that access to that * image will read from the file. diff --git a/libvips/freqfilt/invfft.c b/libvips/freqfilt/invfft.c index c3d8c45b..80ebfa30 100644 --- a/libvips/freqfilt/invfft.c +++ b/libvips/freqfilt/invfft.c @@ -276,7 +276,7 @@ vips_invfft_init( VipsInvfft *invfft ) * * Optional arguments: * - * @real: only output the real part + * * @real: only output the real part * * Transform an image from Fourier space to real space. The result is complex. * If you are OK with a real result, set @real, it's quicker. diff --git a/libvips/histogram/hist_equal.c b/libvips/histogram/hist_equal.c index 9c380c54..b6d527dc 100644 --- a/libvips/histogram/hist_equal.c +++ b/libvips/histogram/hist_equal.c @@ -138,7 +138,7 @@ vips_hist_equal_init( VipsHistEqual *equal ) * * Optional arguments: * - * @band: band to equalise + * * @band: band to equalise * * Histogram-equalise @in. Equalise using band @bandno, or if @bandno is -1, * equalise bands independently. diff --git a/libvips/histogram/maplut.c b/libvips/histogram/maplut.c index 14154c35..09631b95 100644 --- a/libvips/histogram/maplut.c +++ b/libvips/histogram/maplut.c @@ -735,7 +735,7 @@ vips_maplut_init( VipsMaplut *maplut ) * * Optional arguments: * - * @band: apply one-band @lut to this band of @in + * * @band: apply one-band @lut to this band of @in * * Map an image through another image acting as a LUT (Look Up Table). * The lut may have any type and the output image will be that type. diff --git a/libvips/histogram/stdif.c b/libvips/histogram/stdif.c index 6f0977b3..da701555 100644 --- a/libvips/histogram/stdif.c +++ b/libvips/histogram/stdif.c @@ -367,10 +367,10 @@ vips_stdif_init( VipsStdif *stdif ) * * Optional arguments: * - * @a: weight of new mean - * @m0: target mean - * @b: weight of new deviation - * @s0: target deviation + * * @a: weight of new mean + * * @m0: target mean + * * @b: weight of new deviation + * * @s0: target deviation * * vips_stdif() preforms statistical differencing according to the formula * given in page 45 of the book "An Introduction to Digital Image diff --git a/libvips/iofuncs/image.c b/libvips/iofuncs/image.c index 3fc640e5..bf33c6cc 100644 --- a/libvips/iofuncs/image.c +++ b/libvips/iofuncs/image.c @@ -1837,8 +1837,8 @@ vips_filename_get_options( const char *vips_filename ) * * Optional arguments: * - * @access: hint #VipsAccess mode to loader - * @disc: load via a temporary disc file + * * @access: hint #VipsAccess mode to loader + * * @disc: load via a temporary disc file * * vips_image_new_from_file() opens @name for reading. It can load files * in many image formats, including VIPS, TIFF, PNG, JPEG, FITS, Matlab, diff --git a/libvips/iofuncs/system.c b/libvips/iofuncs/system.c index 39ddff2d..6357f869 100644 --- a/libvips/iofuncs/system.c +++ b/libvips/iofuncs/system.c @@ -329,11 +329,11 @@ vips_system_init( VipsSystem *system ) * * Optional arguments: * - * @in: array of input images - * @out: output image - * @in_format: write input files like this - * @out_format: write output filename like this - * @log: stdout of command is returned here + * * @in: array of input images + * * @out: output image + * * @in_format: write input files like this + * * @out_format: write output filename like this + * * @log: stdout of command is returned here * * vips_system() runs a command, optionally passing a set of images in and * optionally getting an image back. The command's stdout is returned in @log. diff --git a/libvips/morphology/labelregions.c b/libvips/morphology/labelregions.c index ff9311d2..880b21be 100644 --- a/libvips/morphology/labelregions.c +++ b/libvips/morphology/labelregions.c @@ -149,7 +149,7 @@ vips_labelregions_init( VipsLabelregions *labelregions ) * * Optional arguments: * - * @segments: return number of regions found here + * * @segments: return number of regions found here * * Repeatedly scans @in for regions of 4-connected pixels * with the same pixel value. Every time a region is discovered, those diff --git a/libvips/mosaicing/global_balance.c b/libvips/mosaicing/global_balance.c index f1c4630f..053330b1 100644 --- a/libvips/mosaicing/global_balance.c +++ b/libvips/mosaicing/global_balance.c @@ -1809,8 +1809,8 @@ vips_globalbalance_init( VipsGlobalbalance *globalbalance ) * * Optional arguments: * - * @gamma: gamma of source images - * @int_output: %TRUE for integer image output + * * @gamma: gamma of source images + * * @int_output: %TRUE for integer image output * * vips_globalbalance() can be used to remove contrast differences in * an assembled mosaic. diff --git a/libvips/mosaicing/match.c b/libvips/mosaicing/match.c index 21fa91ca..60b77594 100644 --- a/libvips/mosaicing/match.c +++ b/libvips/mosaicing/match.c @@ -328,10 +328,10 @@ vips_match_init( VipsMatch *match ) * * Optional arguments: * - * @search: search to improve tie-points - * @hwindow: half window size - * @harea: half search size - * @interpolate: interpolate pixels with this + * * @search: search to improve tie-points + * * @hwindow: half window size + * * @harea: half search size + * * @interpolate: interpolate pixels with this * * Scale, rotate and translate @sec so that the tie-points line up. * diff --git a/libvips/mosaicing/merge.c b/libvips/mosaicing/merge.c index bf7b1e9c..3062c760 100644 --- a/libvips/mosaicing/merge.c +++ b/libvips/mosaicing/merge.c @@ -171,7 +171,7 @@ vips_merge_init( VipsMerge *merge ) * * Optional arguments: * - * @mblend: maximum blend size + * * @mblend: maximum blend size * * This operation joins two images left-right (with @ref on the left) or * up-down (with @ref above) with a smooth seam. diff --git a/libvips/mosaicing/mosaic.c b/libvips/mosaicing/mosaic.c index cea6cd90..c8897e50 100644 --- a/libvips/mosaicing/mosaic.c +++ b/libvips/mosaicing/mosaic.c @@ -324,10 +324,10 @@ vips_mosaic_init( VipsMosaic *mosaic ) * * Optional arguments: * - * @bandno: band to search for features - * @hwindow: half window size - * @harea: half search size - * @mblend: maximum blend size + * * @bandno: band to search for features + * * @hwindow: half window size + * * @harea: half search size + * * @mblend: maximum blend size * * This operation joins two images left-right (with @ref on the left) or * top-bottom (with @ref above) given an approximate overlap. diff --git a/libvips/mosaicing/mosaic1.c b/libvips/mosaicing/mosaic1.c index 2fa468f7..651db3c9 100644 --- a/libvips/mosaicing/mosaic1.c +++ b/libvips/mosaicing/mosaic1.c @@ -635,12 +635,12 @@ vips_mosaic1_init( VipsMosaic1 *mosaic1 ) * * Optional arguments: * - * @search: search to improve tie-points - * @hwindow: half window size - * @harea: half search size - * @interpolate: interpolate pixels with this - * @mblend: maximum blend size - * @bandno: band to search for features + * * @search: search to improve tie-points + * * @hwindow: half window size + * * @harea: half search size + * * @interpolate: interpolate pixels with this + * * @mblend: maximum blend size + * * @bandno: band to search for features * * This operation joins two images top-bottom (with @sec on the right) * or left-right (with @sec at the bottom) diff --git a/libvips/resample/affine.c b/libvips/resample/affine.c index de9ded32..d67c184b 100644 --- a/libvips/resample/affine.c +++ b/libvips/resample/affine.c @@ -623,12 +623,12 @@ vips_affine_init( VipsAffine *affine ) * * Optional arguments: * - * @interpolate: interpolate pixels with this - * @oarea: output rectangle - * @idx: input horizontal offset - * @idy: input vertical offset - * @odx: output horizontal offset - * @ody: output vertical offset + * * @interpolate: interpolate pixels with this + * * @oarea: output rectangle + * * @idx: input horizontal offset + * * @idy: input vertical offset + * * @odx: output horizontal offset + * * @ody: output vertical offset * * This operator performs an affine transform on an image using @interpolate. * diff --git a/libvips/resample/mapim.c b/libvips/resample/mapim.c index 9187153a..8592363e 100644 --- a/libvips/resample/mapim.c +++ b/libvips/resample/mapim.c @@ -415,7 +415,7 @@ vips_mapim_init( VipsMapim *mapim ) * * Optional arguments: * - * @interpolate: interpolate pixels with this + * * @interpolate: interpolate pixels with this * * This operator resamples @in using @index to look up pixels. @out is * the same size as @index, with each pixel being fetched from that position in diff --git a/libvips/resample/quadratic.c b/libvips/resample/quadratic.c index e4741af8..8db0fd6a 100644 --- a/libvips/resample/quadratic.c +++ b/libvips/resample/quadratic.c @@ -371,7 +371,7 @@ vips_quadratic_init( VipsQuadratic *quadratic ) * * Optional arguments: * - * @interpolate: use this interpolator (default bilinear) + * * @interpolate: use this interpolator (default bilinear) * * This operation is unfinished and unusable, sorry. * diff --git a/libvips/resample/reduce.c b/libvips/resample/reduce.c index 6f63bcda..1304e609 100644 --- a/libvips/resample/reduce.c +++ b/libvips/resample/reduce.c @@ -146,7 +146,7 @@ vips_reduce_init( VipsReduce *reduce ) * * Optional arguments: * - * @kernel: #VipsKernel to use to interpolate (default: lanczos3) + * * @kernel: #VipsKernel to use to interpolate (default: lanczos3) * * Reduce @in by a pair of factors with a pair of 1D interpolators. This * will not work well for shrink factors greater than two. diff --git a/libvips/resample/resize.c b/libvips/resample/resize.c index bff34d7c..34df769a 100644 --- a/libvips/resample/resize.c +++ b/libvips/resample/resize.c @@ -336,8 +336,8 @@ vips_resize_init( VipsResize *resize ) * * Optional arguments: * - * @vscale: vertical scale factor - * @kernel: #VipsKernel to reduce with + * * @vscale: vertical scale factor + * * @kernel: #VipsKernel to reduce with * * Resize an image. When upsizing (@scale > 1), the image is simply block * upsized. When downsizing, the diff --git a/libvips/resample/similarity.c b/libvips/resample/similarity.c index 9259cbdd..a0e59e86 100644 --- a/libvips/resample/similarity.c +++ b/libvips/resample/similarity.c @@ -236,13 +236,13 @@ vips_similarity_init( VipsSimilarity *similarity ) * * Optional arguments: * - * @scale: scale by this factor - * @angle: rotate by this many degrees anticlockwise - * @interpolate: interpolate pixels with this - * @idx: input horizontal offset - * @idy: input vertical offset - * @odx: output horizontal offset - * @ody: output vertical offset + * * @scale: scale by this factor + * * @angle: rotate by this many degrees anticlockwise + * * @interpolate: interpolate pixels with this + * * @idx: input horizontal offset + * * @idy: input vertical offset + * * @odx: output horizontal offset + * * @ody: output vertical offset * * This operator calls vips_affine() for you, calculating the matrix for the * affine transform from @scale and @angle. Other parameters are passed on to