diff --git a/ChangeLog b/ChangeLog index 227e61c6..e30eddfe 100644 --- a/ChangeLog +++ b/ChangeLog @@ -30,6 +30,7 @@ - gtk-doc for video ... all operators done! amazing argh - set MAP_NOCACHE on OS X, otherwise performance dives off a cliff with files larger than memory +- removed man pages, we are all gtk-doc now 30/11/10 started 7.24.0 - bump for new stable diff --git a/Makefile.am b/Makefile.am index 40658b4a..532a0542 100644 --- a/Makefile.am +++ b/Makefile.am @@ -22,7 +22,6 @@ endif SUBDIRS = \ libvips \ tools \ - man \ po \ doc \ $(C_COMPILE_DIR) \ diff --git a/configure.in b/configure.in index 0c8d522f..7a34a01b 100644 --- a/configure.in +++ b/configure.in @@ -655,7 +655,6 @@ AC_OUTPUT([ swig/Makefile swig/vipsCC/Makefile swig/python/setup.py - man/Makefile doc/Makefile doc/reference/Makefile doc/reference/libvips-docs.sgml diff --git a/man/IM_ARRAY.3 b/man/IM_ARRAY.3 deleted file mode 100644 index 4e3c9942..00000000 --- a/man/IM_ARRAY.3 +++ /dev/null @@ -1,77 +0,0 @@ -.TH IM_ARRAY 3 "11 April 1993" -.SH NAME -IM_ARRAY, IM_NEW, IM_NUMBER \- memory allocation macros -.SH SYNOPSIS - -#include - -type-name *IM_NEW( IMAGE *im, type-name ) -.br -type-name *IM_ARRAY( IMAGE *im, int number, type-name ) -.br -int IM_NUMBER( array ) - -.SH DESCRIPTION - -NEW, NUMBER and ARRAY are macros built on im_malloc(3) which make memory -allocation slightly easier. Given a type name, NEW returns a pointer to a -piece of memory large enough to hold an object of that type. ARRAY works as -NEW, but allocates space for a number of objects. Given an array, NUMBER -returns the number of elements in that array. - - #define IM_NEW(IM,A) ((A *)im_malloc((IM),sizeof(A))) - #define IM_NUMBER(R) (sizeof(R)/sizeof(R[0])) - #define IM_ARRAY(IM,N,T) ((T *)im_malloc((IM),(N) * sizeof(T))) - -Both IM_ARRAY and IM_NEW take an image descriptor as their first -parameter. Memory is allocated local to this descriptor, that is, when the -descriptor is closed, the memory is automatically freed for you. If you -pass NULL instead of an image descriptor, memory is allocated globally and -is not automatically freed. - -(NOTE: in versions of VIPS before 7.3, NEW(3) and ARRAY(3) did not have the -initial IMAGE parameter. If you are converting an old VIPS7.2 program, you -will need to add a NULL parameter to the start of all NEW(3) and ARRAY(3) -parameter lists.) - -Both functions return NULL on error, setting im_errorstring. - -Example: - - #include - - /* A structure we want to carry about. - */ - typedef struct { - ... - } Wombat; - - /* A static array of them. - */ - static Wombat swarm[] = { - { ... }, - { ... }, - { ... } - }; - static int swarm_size = IM_NUMBER( swarm ); - - int - transform_wombat( IMAGE *in, IMAGE *out ) - { - /* Allocate space for a Wombat. - */ - Wombat *mar = IM_NEW( out, Wombat ); - - /* Allocate space for a copy of swarm. - */ - Wombat *mar = IM_ARRAY( out, swarm_size, Wombat ); - - .... - } - -.SH COPYRIGHT -National Gallery, 1993 -.SH SEE ALSO -im_malloc(3), im_open_local(3). -.SH AUTHOR -J. Cupitt \- 23/7/93 diff --git a/man/IM_IMAGE_ADDR.3 b/man/IM_IMAGE_ADDR.3 deleted file mode 100644 index f837ebb5..00000000 --- a/man/IM_IMAGE_ADDR.3 +++ /dev/null @@ -1,66 +0,0 @@ -.TH MACROS 3 "11 April 1990" -.SH NAME -IM_IMAGE_ADDR, IM_IMAGE_SIZEOF_ELEMENT, IM_IMAGE_SIZEOF_PEL, -IM_IMAGE_SIZEOF_LINE, IM_IMAGE_N_ELEMENTS \- -macros for images -.SH SYNOPSIS -.B #include - -int IM_IMAGE_SIZEOF_ELEMENT( im ) -.br -IMAGE *im; - -int IM_IMAGE_SIZEOF_PEL( im ) -.br -IMAGE *im; - -int IM_IMAGE_SIZEOF_LINE( im ) -.br -IMAGE *im; - -int IM_IMAGE_N_ELEMENTS( im ) -.br -IMAGE *im; - -char *IM_IMAGE_ADDR( im, x, y ) -.br -IMAGE *im; -.br -int x; -.br -int y; - -.SH DESCRIPTION -These macros help to simplify address arithmetic for images. - -IM_IMAGE_SIZEOF_ELEMENT(3) returns sizeof( one band element ). - -IM_IMAGE_SIZEOF_PEL(3) returns sizeof( one pel ). - -IM_IMAGE_SIZEOF_LINE(3) returns sizeof( one horizontal line of pels ). - -IM_IMAGE_N_ELEMENTS(3) returns the number of band elements across a horizontal line. - -IM_IMAGE_ADDR(3) returns a pointer to the pixel at position (x,y) in the -image. The point (x,y) should lie within the image. - -If the macro DEBUG has been defined, then IM_IMAGE_ADDR(3) will also -perform bounds checking. If you ask for the address of a pel outside the -image, -then IM_IMAGE_ADDR(3) will print an error message of the form: - - IM_IMAGE_ADDR: point out of bounds, file "test.c", line 18 - (point x=50, y=0 - should have been within Rect left=0, top=0, width=50, height=50) - -and call abort(3). - -DEBUG needs to be defined *before* vips.h is included. Either define DEBUG -with -D in your Makefile, or have a #define DEBUG right at the top of your -file. -.SH COPYRIGHT -National Gallery, 1993 -.SH SEE ALSO -IM_REGION_ADDR(3), im_malloc(3), im_open_local(3). -.SH AUTHOR -J. Cupitt \- 23/7/93 diff --git a/man/IM_IMAGE_N_ELEMENTS.3 b/man/IM_IMAGE_N_ELEMENTS.3 deleted file mode 100644 index 0e4c07b3..00000000 --- a/man/IM_IMAGE_N_ELEMENTS.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/IM_IMAGE_ADDR.3 diff --git a/man/IM_IMAGE_SIZEOF_ELEMENT.3 b/man/IM_IMAGE_SIZEOF_ELEMENT.3 deleted file mode 100644 index 0e4c07b3..00000000 --- a/man/IM_IMAGE_SIZEOF_ELEMENT.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/IM_IMAGE_ADDR.3 diff --git a/man/IM_IMAGE_SIZEOF_LINE.3 b/man/IM_IMAGE_SIZEOF_LINE.3 deleted file mode 100644 index 0e4c07b3..00000000 --- a/man/IM_IMAGE_SIZEOF_LINE.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/IM_IMAGE_ADDR.3 diff --git a/man/IM_IMAGE_SIZEOF_PEL.3 b/man/IM_IMAGE_SIZEOF_PEL.3 deleted file mode 100644 index 0e4c07b3..00000000 --- a/man/IM_IMAGE_SIZEOF_PEL.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/IM_IMAGE_ADDR.3 diff --git a/man/IM_MACROS.3 b/man/IM_MACROS.3 deleted file mode 100644 index 5caa8ec0..00000000 --- a/man/IM_MACROS.3 +++ /dev/null @@ -1,34 +0,0 @@ -.TH MACROS 3 "11 April 1990" -.SH NAME -IM_RINT, IM_MAX, IM_MIN \- misc math macros -.SH SYNOPSIS - -.B #include - -int IM_RINT( float ) -.br -any IM_MAX( any, any ) -.br -any IM_MIN( any, any ) - -.SH DESCRIPTION - -These macros provide some simple but fast math functions --- IM_MAX(3) -returns the maximum of its two arguments, IM_MIN(3) the smallest, and -IM_RINT(3) rounds a float or double to the nearest integer. - -Beware: these macros may evaluate their argument more than once, so you MUST -NOT use ++,--, or a function call in their argument lists. - -They are defined as: - - #define IM_MAX(A,B) ((A)>(B)?(A):(B)) - #define IM_MIN(A,B) ((A)<(B)?(A):(B)) - #define IM_RINT(R) ((int)((R)>0?((R)+0.5):((R)-0.5))) - -.SH COPYRIGHT -National Gallery, 1993 -.SH SEE ALSO -im_malloc(3), im_open_local(3). -.SH AUTHOR -J. Cupitt \- 23/7/93 diff --git a/man/IM_NEW.3 b/man/IM_NEW.3 deleted file mode 100644 index c891c6dd..00000000 --- a/man/IM_NEW.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/IM_ARRAY.3 diff --git a/man/IM_NUMBER.3 b/man/IM_NUMBER.3 deleted file mode 100644 index c891c6dd..00000000 --- a/man/IM_NUMBER.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/IM_ARRAY.3 diff --git a/man/IM_RECT_BOTTOM.3 b/man/IM_RECT_BOTTOM.3 deleted file mode 100644 index 0ad304e6..00000000 --- a/man/IM_RECT_BOTTOM.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_rect_marginadjust.3 diff --git a/man/IM_RECT_HCENTRE.3 b/man/IM_RECT_HCENTRE.3 deleted file mode 100644 index 0ad304e6..00000000 --- a/man/IM_RECT_HCENTRE.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_rect_marginadjust.3 diff --git a/man/IM_RECT_RIGHT.3 b/man/IM_RECT_RIGHT.3 deleted file mode 100644 index 0ad304e6..00000000 --- a/man/IM_RECT_RIGHT.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_rect_marginadjust.3 diff --git a/man/IM_RECT_VCENTRE.3 b/man/IM_RECT_VCENTRE.3 deleted file mode 100644 index 0ad304e6..00000000 --- a/man/IM_RECT_VCENTRE.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_rect_marginadjust.3 diff --git a/man/IM_REGION_ADDR.3 b/man/IM_REGION_ADDR.3 deleted file mode 100644 index b1bf406b..00000000 --- a/man/IM_REGION_ADDR.3 +++ /dev/null @@ -1,63 +0,0 @@ -.TH MACROS 3 "11 April 1990" -.SH NAME -IM_REGION_ADDR, -IM_REGION_LSKIP, -IM_REGION_N_ELEMENTS, IM_REGION_SIZEOF_LINE \- -macros for regions -.SH SYNOPSIS -.B #include - -int IM_REGION_LSKIP( reg ) -.br -REGION *reg; - -int IM_REGION_N_ELEMENTS( reg ) -.br -REGION *reg; - -int IM_REGION_SIZEOF_LINE( reg ) -.br -REGION *reg; - -char *IM_REGION_ADDR( reg, x, y ) -.br -REGION *reg; -.br -int x, y; - -.SH DESCRIPTION -These macros help to simplify address arithmetic for regions. - -IM_REGION_LSKIP(3) returns the number of *bytes* you should add to move -down a scan line. Remember that if your pointer has been cast to the type -of the image pels, this will not be the correct amount to add! The value -lskip returns can be changed by a call to im_prepare(3). - -IM_REGION_N_ELEMENTS(3) returns the number of band elements across the region. - -IM_REGION_SIZEOF_LINE(3) returns sizeof( horizontal line across region ). - -IM_REGION_ADDR(3) returns a pointer to the pixel at position (x,y) in the -image on which reg has been defined. The point (x,y) should lie within the -valid area for this region. - -If the macro DEBUG has been defined, then IM_REGION_ADDR(3) will also -perform bounds checking. If you ask for the address of a pel outside the rect -reg->valid, then IM_REGION_ADDR(3) will print an error message of the form: - - IM_REGION_ADDR: point out of bounds, file "test.c", line 18 - (point x=50, y=0 - should have been within Rect left=0, top=0, width=50, height=50) - -and call abort(3). - -DEBUG needs to be defined *before* region.h is included. Either define DEBUG -with -D in your Makefile, or have a #define DEBUG right at the top of your -file. - -.SH COPYRIGHT -National Gallery, 1993 -.SH SEE ALSO -IM_IMAGE_ADDR(3), im_malloc(3), im_open_local(3). -.SH AUTHOR -J. Cupitt \- 23/7/93 diff --git a/man/IM_REGION_LSKIP.3 b/man/IM_REGION_LSKIP.3 deleted file mode 100644 index 9fc98c69..00000000 --- a/man/IM_REGION_LSKIP.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/IM_REGION_ADDR.3 diff --git a/man/IM_REGION_N_ELEMENTS.3 b/man/IM_REGION_N_ELEMENTS.3 deleted file mode 100644 index 9fc98c69..00000000 --- a/man/IM_REGION_N_ELEMENTS.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/IM_REGION_ADDR.3 diff --git a/man/IM_REGION_SIZEOF_LINE.3 b/man/IM_REGION_SIZEOF_LINE.3 deleted file mode 100644 index 9fc98c69..00000000 --- a/man/IM_REGION_SIZEOF_LINE.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/IM_REGION_ADDR.3 diff --git a/man/Makefile.am b/man/Makefile.am deleted file mode 100644 index 038b0d08..00000000 --- a/man/Makefile.am +++ /dev/null @@ -1,546 +0,0 @@ -man_MANS = \ - batch_crop.1 \ - batch_image_convert.1 \ - batch_rubber_sheet.1 \ - binfile.1 \ - cooc.1 \ - cooc_features.1 \ - debugim.1 \ - edvips.1 \ - glds.1 \ - glds_features.1 \ - header.1 \ - light_correct.1 \ - printlines.1 \ - simcontr.1 \ - sines.1 \ - squares.1 \ - vips.1 \ - vipsthumbnail.1 \ - error_exit.3 \ - im_abs.3 \ - im_acostra.3 \ - im_add.3 \ - im_rad2float.3 \ - im_float2rad.3 \ - im_add_preclose_callback.3 \ - im_add_close_callback.3 \ - im_add_evalstart_callback.3 \ - im_add_eval_callback.3 \ - im_add_evalend_callback.3 \ - im_add_invalidate_callback.3 \ - im_addgnoise.3 \ - im_affine.3 \ - im_affinei.3 \ - im_affinei_all.3 \ - im_allocate_input_array.3 \ - im_amiMSBfirst.3 \ - im_analyze2vips.3 \ - im_andconst.3 \ - im_andimage.3 \ - im_and_vec.3 \ - IM_ARRAY.3 \ - im_asintra.3 \ - im_atantra.3 \ - im_avg.3 \ - im_BandFmt2char.3 \ - im_bandjoin.3 \ - im_bandmean.3 \ - im_benchmark.3 \ - im_binfile.3 \ - im_bits_of_fmt.3 \ - im_black.3 \ - im_blend.3 \ - im_buildlut.3 \ - im_c2amph.3 \ - im_c2imag.3 \ - im_c2ps.3 \ - im_c2real.3 \ - im_c2rect.3 \ - im_cache.3 \ - im_ceil.3 \ - im_char2BandFmt.3 \ - im_char2Coding.3 \ - im_char2Compression.3 \ - im_char2Type.3 \ - im_circle.3 \ - im_clip2c.3 \ - im_clip2cm.3 \ - im_clip2d.3 \ - im_clip2dcm.3 \ - im_clip2f.3 \ - im_clip2fmt.3 \ - im_clip2i.3 \ - im_clip2s.3 \ - im_clip2ui.3 \ - im_clip2us.3 \ - im_clip.3 \ - im_close.3 \ - im_cmulnorm.3 \ - im_cntlines.3 \ - im_Coding2char.3 \ - im_col_ab2Ch.3 \ - im_col_C2Cucs.3 \ - im_col_Ch2ab.3 \ - im_col_Ch2hucs.3 \ - im_col_Chucs2h.3 \ - im_col_Cucs2C.3 \ - im_col_dECMC.3 \ - im_col_display.3 \ - im_col_L2Lucs.3 \ - im_col_Lab2XYZ.3 \ - im_col_Lucs2L.3 \ - im_col_make_tables_RGB.3 \ - im_col_make_tables_UCS.3 \ - im_col_pythagoras.3 \ - im_col_rgb2XYZ.3 \ - im_col_XYZ2Lab.3 \ - im_col_XYZ2rgb.3 \ - im_compass.3 \ - im_Compression2char.3 \ - im_concurrency_get.3 \ - im_concurrency_set.3 \ - im_contrast_surface.3 \ - im_contrast_surface_raw.3 \ - im_conv.3 \ - im_convf.3 \ - im_convf_raw.3 \ - im_conv_raw.3 \ - im_convsep.3 \ - im_convsepf.3 \ - im_convsepf_raw.3 \ - im_convsep_raw.3 \ - im_convsub.3 \ - im_cooc_asm.3 \ - im_cooc_contrast.3 \ - im_cooc_correlation.3 \ - im_cooc_entropy.3 \ - im_cooc_matrix.3 \ - im_copy.3 \ - im_copy_from.3 \ - im_copy_morph.3 \ - im_copy_set.3 \ - im_copy_set_meta.3 \ - im_copy_swap.3 \ - im_correl.3 \ - im_costra.3 \ - im_cp_desc.3 \ - im_cp_desc_array.3 \ - im_cp_descv.3 \ - im_create_dmask.3 \ - im_create_fmask.3 \ - im_create_imask.3 \ - im_csv2vips.3 \ - im_dE00_fromLab.3 \ - im_debugim.3 \ - im_dECMC_fromdisp.3 \ - im_dECMC_fromLab.3 \ - im_dE_fromdisp.3 \ - im_dE_fromLab.3 \ - im_dE_fromXYZ.3 \ - im_demand_hint.3 \ - im_demand_hint_array.3 \ - im_deviate.3 \ - im_diag.3 \ - im_dif_std.3 \ - im_dilate.3 \ - im_dilate_raw.3 \ - im_disp2Lab.3 \ - im_disp2XYZ.3 \ - im_disp_ps.3 \ - im_divide.3 \ - im_dup_dmask.3 \ - im_dup_imask.3 \ - im_embed.3 \ - im_eorconst.3 \ - im_eorimage.3 \ - im_eor_vec.3 \ - im_equal.3 \ - im_equalconst.3 \ - im_equal_vec.3 \ - im_erode.3 \ - im_erode_raw.3 \ - im_error.3 \ - im_error_buffer.3 \ - im_error_clear.3 \ - im_exp10tra.3 \ - im_expntra.3 \ - im_expntra_vec.3 \ - im_exptra.3 \ - im_exr2vips.3 \ - im_extract.3 \ - im_extract_area.3 \ - im_extract_areabands.3 \ - im_extract_bands.3 \ - im_eye.3 \ - im_falsecolour.3 \ - im_fastcor.3 \ - im_fastline.3 \ - im_fastlineuser.3 \ - im_fav4.3 \ - im_feye.3 \ - im_fgrey.3 \ - im_fliphor.3 \ - im_flipver.3 \ - im_flood.3 \ - im_flood_blob.3 \ - im_floor.3 \ - im_flt_imag_freq.3 \ - VipsObject.3 \ - VipsFormat.3 \ - VipsInterpolate.3 \ - vips_format_for_file.3 \ - vips_format_for_name.3 \ - vips_format_map.3 \ - vips_format_read.3 \ - vips_format_write.3 \ - im_fractsurf.3 \ - im_free.3 \ - im_free_dmask.3 \ - im_free_imask.3 \ - im_freqflt.3 \ - im_fwfft.3 \ - im_fzone.3 \ - im_gadd.3 \ - im_gaddim.3 \ - im_gammacorrect.3 \ - im_gauss_dmask.3 \ - im_gauss_imask.3 \ - im_gauss_imask_sep.3 \ - im_gaussnoise.3 \ - im_gbandjoin.3 \ - im_generate.3 \ - im_get_option_group.3 \ - im_gfadd.3 \ - im_glds_asm.3 \ - im_glds_contrast.3 \ - im_glds_entropy.3 \ - im_glds_matrix.3 \ - im_glds_mean.3 \ - im_global_balance.3 \ - im_global_balance_float.3 \ - im_gradcor.3 \ - im_gradient.3 \ - im_grad_x.3 \ - im_grad_y.3 \ - im_grey.3 \ - im_grid.3 \ - im_guess_prefix.3 \ - im_guess_libdir.3 \ - im_header.3 \ - im_header_double.3 \ - im_header_get.3 \ - im_header_get_type.3 \ - im_header_int.3 \ - im_header_map.3 \ - im_header_string.3 \ - im_heq.3 \ - im_hist.3 \ - im_histcum.3 \ - im_histeq.3 \ - im_histgr.3 \ - im_histlin.3 \ - im_histnD.3 \ - im_histnorm.3 \ - im_history_get.3 \ - im_histplot.3 \ - im_histspec.3 \ - im_hsp.3 \ - im_icc_ac2rc.3 \ - im_icc_export.3 \ - im_icc_export_depth.3 \ - im_icc_import.3 \ - im_icc_import_embedded.3 \ - im_icc_present.3 \ - im_icc_transform.3 \ - im_identity.3 \ - im_identity_ushort.3 \ - im_ifthenelse.3 \ - im_image.3 \ - IM_IMAGE_ADDR.3 \ - IM_IMAGE_N_ELEMENTS.3 \ - im_image_sanity.3 \ - IM_IMAGE_SIZEOF_ELEMENT.3 \ - IM_IMAGE_SIZEOF_LINE.3 \ - IM_IMAGE_SIZEOF_PEL.3 \ - im_incheck.3 \ - im_init.3 \ - im_initdesc.3 \ - im_init_world.3 \ - im_insert.3 \ - im_insertplace.3 \ - im_invalidate.3 \ - im_invert.3 \ - im_invertlut.3 \ - im_invfft.3 \ - im_invfftr.3 \ - im_iocheck.3 \ - im_iscomplex.3 \ - im_isfile.3 \ - im_isfloat.3 \ - im_isint.3 \ - im_isMSBfirst.3 \ - im_ispartial.3 \ - im_isscalar.3 \ - im_isuint.3 \ - im_isvips.3 \ - im_iterate.3 \ - im_jpeg2vips.3 \ - im_Lab2disp.3 \ - im_Lab2LabQ.3 \ - im_Lab2LabS.3 \ - im_Lab2LCh.3 \ - im_Lab2UCS.3 \ - im_Lab2XYZ.3 \ - im_lab_morph.3 \ - im_LabQ2disp.3 \ - im_LabQ2disp_build_table.3 \ - im_LabQ2disp_table.3 \ - im_LabQ2Lab.3 \ - im_LabQ2LabS.3 \ - im_LabQ2XYZ.3 \ - im_LabS2Lab.3 \ - im_LabS2LabQ.3 \ - im_LCh2Lab.3 \ - im_LCh2UCS.3 \ - im_less.3 \ - im_lessconst.3 \ - im_lesseq.3 \ - im_lesseqconst.3 \ - im_lesseq_vec.3 \ - im_less_vec.3 \ - im_lhisteq.3 \ - im_lhisteq_raw.3 \ - im_lindetect.3 \ - im_line.3 \ - im_lineset.3 \ - im_lintra.3 \ - im_lintra_vec.3 \ - im_litecor.3 \ - im_log10tra.3 \ - im_log_dmask.3 \ - im_log_imask.3 \ - im_logtra.3 \ - im_lowpass.3 \ - im_lrjoin.3 \ - im_lrmerge.3 \ - im_lrmosaic.3 \ - im_lu_decomp.3 \ - im_lu_solve.3 \ - IM_MACROS.3 \ - im_magick2vips.3 \ - im_makerw.3 \ - im_make_xy.3 \ - im_malloc.3 \ - im_maplut.3 \ - im_mask2vips.3 \ - im_matcat.3 \ - im_match_linear.3 \ - im_match_linear_search.3 \ - im_matinv.3 \ - im_matinv_inplace.3 \ - im_matmul.3 \ - im_mattrn.3 \ - im_max.3 \ - im_maxpos.3 \ - im_maxpos_vec.3 \ - im_maxvalue.3 \ - im_mean_std_double_buffer.3 \ - im_mean_std_int_buffer.3 \ - im_measure.3 \ - im_meta.3 \ - im_meta_get.3 \ - im_meta_get_area.3 \ - im_meta_get_blob.3 \ - im_meta_get_double.3 \ - im_meta_get_int.3 \ - im_meta_get_string.3 \ - im_meta_get_type.3 \ - im_meta_set.3 \ - im_meta_set_area.3 \ - im_meta_set_blob.3 \ - im_meta_set_double.3 \ - im_meta_set_int.3 \ - im_meta_set_string.3 \ - im_min.3 \ - im_minpos.3 \ - im_minpos_vec.3 \ - im_mmapin.3 \ - im_mmapinrw.3 \ - im_more.3 \ - im_moreconst.3 \ - im_moreeq.3 \ - im_moreeqconst.3 \ - im_moreeq_vec.3 \ - im_more_vec.3 \ - im_mpercent.3 \ - im_msb.3 \ - im_msb_band.3 \ - im_multiply.3 \ - IM_NEW.3 \ - im_norm_dmask.3 \ - im_notequal.3 \ - im_notequalconst.3 \ - im_notequal_vec.3 \ - IM_NUMBER.3 \ - im_offsets45.3 \ - im_offsets90.3 \ - im_open.3 \ - im_open_local.3 \ - im_open_local_array.3 \ - im_openout.3 \ - im_orconst.3 \ - im_orimage.3 \ - im_or_vec.3 \ - im_outcheck.3 \ - im_paintrect.3 \ - im_partial.3 \ - im_pincheck.3 \ - im_piocheck.3 \ - im_plotmask.3 \ - im_plotpoint.3 \ - im_png2vips.3 \ - im_poutcheck.3 \ - im_powtra.3 \ - im_powtra_vec.3 \ - im_ppm2vips.3 \ - im_prepare.3 \ - im_prepare_many.3 \ - im_prepare_to.3 \ - im_print.3 \ - im_printdesc.3 \ - im_print_dmask.3 \ - im_print_imask.3 \ - im_printlines.3 \ - im_profile.3 \ - im_project.3 \ - im_quantim.3 \ - im_quantlut.3 \ - im_rank.3 \ - im_rank_image.3 \ - im_raw2vips.3 \ - im_read_dmask.3 \ - im_read_imask.3 \ - im_readpoint.3 \ - im_recomb.3 \ - IM_RECT_BOTTOM.3 \ - im_rect_dup.3 \ - im_rect_equalsrect.3 \ - IM_RECT_HCENTRE.3 \ - im_rect_includespoint.3 \ - im_rect_includesrect.3 \ - im_rect_intersectrect.3 \ - im_rect_isempty.3 \ - im_rect_marginadjust.3 \ - im_rect_normalise.3 \ - IM_RECT_RIGHT.3 \ - im_rect_unionrect.3 \ - IM_RECT_VCENTRE.3 \ - IM_REGION_ADDR.3 \ - im_region_buffer.3 \ - im_region_create.3 \ - im_region_free.3 \ - im_region_image.3 \ - IM_REGION_LSKIP.3 \ - IM_REGION_N_ELEMENTS.3 \ - im_region_position.3 \ - im_region_region.3 \ - IM_REGION_SIZEOF_LINE.3 \ - im_remainder.3 \ - im_remainderconst.3 \ - im_remainderconst_vec.3 \ - im_remosaic.3 \ - im_render.3 \ - im_render_fade.3 \ - im_replicate.3 \ - im_resize_linear.3 \ - im_ri2c.3 \ - im_rightshift_size.3 \ - im_rint.3 \ - im_rot180.3 \ - im_rot270.3 \ - im_rot90.3 \ - im_rotate_dmask45.3 \ - im_rotate_dmask90.3 \ - im_rotate_imask45.3 \ - im_rotate_imask90.3 \ - im_rotquad.3 \ - im_scale.3 \ - im_scale_dmask.3 \ - im_scaleps.3 \ - im_setbuf.3 \ - im_setupout.3 \ - im_sharpen.3 \ - im_shiftleft.3 \ - im_shiftright.3 \ - im_shrink.3 \ - im_sign.3 \ - im_simcontr.3 \ - im_similarity.3 \ - im_similarity_area.3 \ - im_sines.3 \ - im_sintra.3 \ - im_slice.3 \ - im_smear.3 \ - im_smudge.3 \ - im_spatres.3 \ - im_spcor.3 \ - im_sRGB2XYZ.3 \ - im_start_many.3 \ - im_start_one.3 \ - im_stats.3 \ - im_stdif.3 \ - im_stop_many.3 \ - im_stop_one.3 \ - im_stretch3.3 \ - im_subsample.3 \ - im_subtract.3 \ - im_system.3 \ - im_tantra.3 \ - im_tbjoin.3 \ - im_tbmerge.3 \ - im_tbmosaic.3 \ - im_text.3 \ - im_thresh.3 \ - im_tiff2vips.3 \ - im_tile_cache.3 \ - im_tone_analyse.3 \ - im_tone_build.3 \ - im_tone_map.3 \ - im_Type2char.3 \ - im_UCS2Lab.3 \ - im_UCS2LCh.3 \ - im_UCS2XYZ.3 \ - im_updatehist.3 \ - im_verror.3 \ - im_version.3 \ - im_version_string.3 \ - im_video_v4l1.3 \ - im_vips2bufjpeg.3 \ - im_vips2csv.3 \ - im_vips2jpeg.3 \ - im_vips2mask.3 \ - im_vips2mimejpeg.3 \ - im_vips2png.3 \ - im_vips2ppm.3 \ - im_vips2raw.3 \ - im_vips2tiff.3 \ - im_warn.3 \ - im_wrapmany.3 \ - im_wrapone.3 \ - im_write_dmask.3 \ - im_write_dmask_name.3 \ - im_write_imask.3 \ - im_write_imask_name.3 \ - im_writeline.3 \ - im_XYZ2disp.3 \ - im_XYZ2Lab.3 \ - im_XYZ2sRGB.3 \ - im_XYZ2UCS.3 \ - im_XYZ2Yxy.3 \ - im_Yxy2XYZ.3 \ - im_zerox.3 \ - im_zone.3 \ - im_zoom.3 - -EXTRA_DIST = ${man_MANS} diff --git a/man/VipsFormat.3 b/man/VipsFormat.3 deleted file mode 100644 index 85306b4b..00000000 --- a/man/VipsFormat.3 +++ /dev/null @@ -1,179 +0,0 @@ -.TH VIPS_FORMAT 3 "16 August 2008" -.SH NAME -VipsFormat, -vips_format_map, vips_format_for_file, vips_format_for_name, -vips_format_write \- -load and search image formats -.SH SYNOPSIS -#include - -typedef enum { -.br - VIPS_FORMAT_NONE = 0, -.br - VIPS_FORMAT_PARTIAL = 1 -.br -} VipsFormatFlags; - -typedef struct _VipsFormatClass { -.br - VipsObjectClass parent_class; - - gboolean (*is_a)( const char * ); -.br - int (*header)( const char *, IMAGE * ); -.br - int (*load)( const char *, IMAGE * ); -.br - int (*save)( IMAGE *, const char * ); -.br - VipsFormatFlags (*get_flags)( const char * ); -.br - int priority; -.br - const char **suffs; -.br -} VipsFormatClass; - -void *vips_format_map( VSListMap2Fn fn, void *a, void *b ); -.br -VipsFormatClass *vips_format_for_file( const char *filename ); -.br -VipsFormatClass *vips_format_for_name( const char *filename ); - -int vips_format_write( IMAGE *im, const char *filename ); - -int vips_format_read( const char *filename, IMAGE *out ); - -.SH DESCRIPTION -These functions search the -available image formats to find one suitable for loading or saving a file. - -.B im_open(3) -will do something similar, but that returns a descriptor to the file rather -than copying to a descriptor you supply. - -The two APIs are useful in different circumstances: -.B im_open(3) -is good if you want to directly manipulate a file on disc, for example with -the paintbox functions. On the other hand, this format API is useful for -controlling how a image -is unpacked, since you can specify a destination for the copy. - -Image formats are subclasses of -.B VipsFormat -as outlined above. They are expected to implement at least one of the methods. -They should also set values for the -.B nickname -and -.B description -members of -.B VipsObject. - -Other members are: - -.B is_a() -A function which tests whether a file is of the specified format. This is -useful if you can guess a file type from the first few bytes in the file. If -you leave this function NULL, vips will guess from the filename suffix for -you. - -.B header() -Load only the image header, not any of the image pixels. vips will call this -first on -.B im_open(3) -and delay loading pixels until asked. If you leave this NULL, vips will just -use the -.B load() -function. - -.B load() -Load the image from the file into the IMAGE. You can leave this function NULL -if you only have a -.B save() -method implemented. Load options may be embedded in the filename, see the -loaders below. - -.B save() -Write from the IMAGE to the file in this format. You can leave this function -NULL if you only have a load method implemented. Save options may be embedded -in the filename, see the savers below. - -.B get_flags() -A function which examines the file and sets various flags to indicate -properties of the image. The only flag implemented at the moment is -.B VIPS_FORMAT_PARTIAL -which may be set to indicate that the file can be read lazily. - -.B priority -sets a priority for the format. Priorities for formats default to zero: you -mmay set a lower or higher number to set where in the format table your format -is positioned. - -.B suffs -A NULL-terminated array of possible file-name suffixes for this format. This -list is used to filter filenames when they are shown to the user, and to help -select a format to sav a file as. For example, the JPEG format has the -suffixes: -.B { ".jpg", ".jpeg", ".jpe", NULL } - -.B vips_format_map(3) -maps a function over the list of available formats. See -.B im_slist_map(3). - -.B vips_format_for_file(3) -looks at a file on disc and selects the 'best' format to use to load that -file. If no suitable format is found, it returns NULL and sets an error -message. - -.B vips_format_for_name(3) -looks at a filename and picks a format to use to save that file based on the -file extension. If no suitable format is found, it returns NULL and sets an -error message. - -.B vips_format_read(3) -is a convenience function which copies the image from the file into the IMAGE. -error, it returns non-zero and sets an error message. - -.B vips_format_write(3) -is a convenience function which copies the image to the file in the -appropriate format. On error, it returns non-zero and sets an error message. - -.SH SUPPORTED FORMATS - -See the following manpages for details on each of the converters and the -options they implement. - -.B im_analyze2vips(3) -.B im_csv2vips(3) -.B im_exr2vips(3) -.B im_jpeg2vips(3) -.B im_magick2vips(3) -.B im_png2vips(3) -.B im_ppm2vips(3) -.B im_tiff2vips(3) -.B im_vips2csv(3) -.B im_vips2jpeg(3) -.B im_vips2png(3) -.B im_vips2ppm(3) -.B im_vips2tiff(3) - -You can also load Matlab .mat files and load or save Radiance HDR files. See -.B im_binfile(3) -and -.B im_raw2vips(3) -for RAW file read. - -You can list the supported formats with - - $ vips --list classes - -look for subclasses of -.B VipsFormat. - -.SH RETURN VALUE -The functions return 0 success and -1 on error. -.SH SEE ALSO -im_tiff2vips(3), im_open(3), vips(1). -.SH AUTHOR -Jesper Friis and John Cupitt diff --git a/man/VipsInterpolate.3 b/man/VipsInterpolate.3 deleted file mode 100644 index 34747f93..00000000 --- a/man/VipsInterpolate.3 +++ /dev/null @@ -1,100 +0,0 @@ -.TH VIPS_INTERPOLATE 3 "28 March 2009" -.SH NAME -VipsInterpolate, -vips_interpolate, -vips_interpolate_get_method, -vips_interpolate_get_window_size -\- -base class for VIPS interpolators -.SH SYNOPSIS -#include - -typedef void (*VipsInterpolateMethod)( VipsInterpolate *, -.br - PEL *out, REGION *in, double x, double y ); - -typedef struct _VipsInterpolateClass { -.br - VipsObjectClass parent_class; - - VipsInterpolateMethod interpolate; -.br - int (*get_window_size)( VipsInterpolate * ); -.br - int window_size; -.br -} VipsInterpolateClass; - -void vips_interpolate( VipsInterpolate *interpolate, -.br - PEL *out, REGION *in, double x, double y ); -.br -VipsInterpolateMethod vips_interpolate_get_method( VipsInterpolate * ); -.br -int vips_interpolate_get_window_size( VipsInterpolate *interpolate ); - -VipsInterpolate *vips_interpolate_nearest_static( void ); -.br -VipsInterpolate *vips_interpolate_bilinear_static( void ); -.br -VipsInterpolate *vips_interpolate_bicubic_static( void ); - -VipsInterpolate *vips_interpolate_new( const char *nickname ); - -.SH DESCRIPTION -.B VipsInterpolate -is the base class for VIPS interpolators. It provides a simple framework that -subclasses use to implement the various interpolators that VIPS ships with. -You can add new interpolators by subclassing -.B VipsInterpolated -and implementing an -.B interpolate -method. -You can use any interpolator in your code via the methods of -.B VipsInterpolate. - -.B vips_interpolate(3) -looks up the interpolate method for the object and calls it for you. - -.B vips_interpolate_get_method(3) -just does the lookup and returns a pointer to the interpolate function. You -can use this to take the lookup out of an inner loop. - -.B vips_interpolate_get_window_size(3) -either calls -.B get_window_size() -or if it is NULL, returns -.B window_size. - -.B vips_interpolate_nearest_static(3), -.B vips_interpolate_bilinear_static(3) -and -.B vips_interpolate_bicubic_static(3) -are convenience functions which return a pointer to a static instance of a -nearest-neighbour, bilinear and bicubic interpolator. You can pass these to -any function which needs a -.B VipsInterpolator -as an argument. No need to free the result. - -.B vips_interpolate_new(3) -is a convenience function which makes an interpolator from a nickname. Free -the result with -.B g_object_unref(3) -when you're done with it. - -.SH SUPPORTED INTERPOLATORS - -You can list the supported interpolators with - - $ vips --list classes - -look for subclasses of -.B VipsInterpolate. - -.SH RETURN VALUE -Unless otherwise noted, functions return 0 success and -1 on error. -.SH SEE ALSO -VipsObject(3), VipsInterpolate(3), -vips_type_find(3), vips(1). -.SH AUTHOR -John Cupitt diff --git a/man/VipsObject.3 b/man/VipsObject.3 deleted file mode 100644 index 5524fb7c..00000000 --- a/man/VipsObject.3 +++ /dev/null @@ -1,317 +0,0 @@ -.TH VIPS_OBJECT 3 "28 March 2009" -.SH NAME -VipsObject, -vips_object_build, vips_object_print_class, -vips_object_print, -vips_object_class_install_argument, -vips_argument_map, -vips_object_set_property, -vips_object_get_property, -vips_object_new, -vips_object_new_from_string, -vips_object_to_string -\- -VIPS base class -.SH SYNOPSIS -#include - -/* Flags we associate with each argument. -.br - */ -.br -typedef enum _VipsArgumentFlags { -.br - VIPS_ARGUMENT_NONE = 0, - - /* Must be set in the constructor. -.br - */ -.br - VIPS_ARGUMENT_REQUIRED = 1, - - /* Can only be set in the constructor. -.br - */ -.br - VIPS_ARGUMENT_CONSTRUCT = 2, - - /* Can only be set once. -.br - */ -.br - VIPS_ARGUMENT_SET_ONCE = 4, - - /* Have input & output flags. Both set is an error; neither set -.br - * is OK. -.br - */ - - /* Is an input argument (one we depend on) ... if it's a gobject, we -.br - * should ref it. In our _dispose(), we should unref it. -.br - */ -.br - VIPS_ARGUMENT_INPUT = 8, - - /* Is an output argument (one that depends on us) ... if it's a -.br - * gobject, we should ref ourselves. We watch "destroy" on the -.br - * argument: if it goes, we unref ourselves. If we dispose, we -.br - * disconnect the signal. -.br - */ -.br - VIPS_ARGUMENT_OUTPUT = 16 -.br -} VipsArgumentFlags; - -/* Useful flag combinations. User-visible ones are: - -VIPS_ARGUMENT_REQURED_INPUT Eg. the "left" argument for add - -VIPS_ARGUMENT_OPTIONAL_INPUT Eg. the "caption" for an object - -VIPS_ARGUMENT_REQURED_OUTPUT Eg. the "result" of an add operation - -VIPS_ARGUMENT_OPTIONAL_OUTPUT Eg. the "width" of an image - - Other combinations are used internally, eg. supplying the cast-table -.br - for an arithmetic operation - - */ - -#define VIPS_ARGUMENT_REQUIRED_INPUT \ -.br - (VIPS_ARGUMENT_INPUT | VIPS_ARGUMENT_REQUIRED | \ -.br - VIPS_ARGUMENT_CONSTRUCT | VIPS_ARGUMENT_SET_ONCE) - -#define VIPS_ARGUMENT_OPTIONAL_INPUT \ -.br - (VIPS_ARGUMENT_INPUT | \ -.br - VIPS_ARGUMENT_CONSTRUCT | VIPS_ARGUMENT_SET_ONCE) - -#define VIPS_ARGUMENT_REQUIRED_OUTPUT \ -.br - (VIPS_ARGUMENT_OUTPUT | VIPS_ARGUMENT_REQUIRED | \ -.br - VIPS_ARGUMENT_SET_ONCE) - -#define VIPS_ARGUMENT_OPTIONAL_OUTPUT \ -.br - (VIPS_ARGUMENT_OUTPUT | \ -.br - VIPS_ARGUMENT_SET_ONCE) - -/* Keep one of these for every argument. -.br - */ -.br -typedef struct _VipsArgument { -.br - GParamSpec *pspec; /* pspec for this argument */ - - /* More stuff, see below */ -.br -} VipsArgument; - -typedef void *(*VipsArgumentMapFn)( VipsObject *, GParamSpec *, -.br - VipsArgumentClass *, VipsArgumentInstance *, void *a, void *b ); -.br -void *vips_argument_map( VipsObject *object, -.br - VipsArgumentMapFn fn, void *a, void *b ); - -struct _VipsObject { -.br - GObject parent_object; - -}; - -struct _VipsObjectClass { -.br - GObjectClass parent_class; - - /* Build the object ... all argument properties have been set, -.br - * now build the thing. -.br - */ -.br - int (*build)( VipsObject *object ); - - /* Try to print something about the class, handy for help displays. -.br - */ -.br - void (*print_class)( struct _VipsObjectClass *, VipsBuf * ); - - /* Try to print something about the object, handy for debugging. -.br - */ -.br - void (*print)( VipsObject *, VipsBuf * ); - - /* Class nickname, eg. "VipsInterpolateBicubic" has "bicubic" as a -.br - * nickname. Not internationalised. -.br - */ -.br - const char *nickname; - - /* Class description. Used for help messages, so internationalised. -.br - */ -.br - const char *description; - -}; - -void vips_object_set_property( GObject *gobject, -.br - guint property_id, const GValue *value, GParamSpec *pspec ); -.br -void vips_object_get_property( GObject *gobject, -.br - guint property_id, GValue *value, GParamSpec *pspec ); - -int vips_object_build( VipsObject *object ); -.br -void vips_object_print_class( VipsObjectClass *klass ); -.br -void vips_object_print( VipsObject *object ); - -void vips_object_class_install_argument( VipsObjectClass *, -.br - GParamSpec *pspec, VipsArgumentFlags flags, guint offset ); - -typedef void *(*VipsObjectSetArguments)( VipsObject *, -.br - void *, void * ); -.br -VipsObject *vips_object_new( GType type, -.br - VipsObjectSetArguments set, void *a, void *b ); - -VipsObject *vips_object_new_from_string( const char *base, -.br - const char *str ); -.br -void vips_object_to_string( VipsObject *object, VipsBuf *buf ); - -.SH DESCRIPTION -.B VipsObject -is the base class for VIPS. It provides some common features, like class -nicknames, and implements an extension to -.B GObject -for properties to let them be used more like function arguments. - -.B VipsObject -is still being developed, so this documentation only covers enough of the -interface to let you use the classes that have been built on top of -.B VipsObject: -.B VipsInterpolate -and -.B VipsFormat. -Hopefully the next version will be more fleshed out. - -.B VipsObject -adds two properties: -.B nickname -and -.B description. -They are actually class properties, but are available as instance properties -too for convenience. - -.B nickname -is the non-internationalised nickname of the class and is used to simplify -lookup. For example, the -.B VipsInterpolateBicubic -class has the nickname "bicubic". - -.B description -is the internationalised short description of the class. -For example, the -.B VipsInterpolateBicubic -class might have the description "bicubic interpolation (Catmull-Rom)". - -Like the rest of VIPS, -.B VipsObject -is a functional type. You can set -properties during object construction, but not after that point. You may read -properties at any time after construction, but not before. - -To enforce these rules, VIPS extends the standard -.B GObject -property -system and adds a new phase to object creation. - -In class_init, after creating a property, you make it into an argument by -adding a call to -.B vips_object_class_install_argument(3). -This takes a set of flags, used to tell VIPS what sort of argument this is, -and an offset for the data value in the class instance. For example: - - pspec = g_param_spec_string( "description", - _( "Description" ), - _( "Class description" ), - "", - (GParamFlags) G_PARAM_READWRITE ); - g_object_class_install_property( gobject_class, - PROP_DESCRIPTION, pspec ); - vips_object_class_install_argument( object_class, pspec, - VIPS_ARGUMENT_SET_ONCE, - G_STRUCT_OFFSET( VipsObject, description ) ); - -After -.B g_object_new(3) -you can continue to set arguments. After you have set all the ones you want to -set, call -.B vips_object_build(3) -to check that required arguments have been set, no arguments have been set -many times, and so on. - -Once a -.B VipsObject -has been built, you can no longer set arguments, but you can read them. - -Use -.B vips_argument_map(3) -to iterate over the arguments for an object in the correct order. You can use -this to discover the arguments any class takes at runtime. - -.B vips_object_set_property(3) -and -.B vips_object_get_property(3) -are used in subclasses of -.B VipsObject -to get and set object arguments. You don't need to implement your own get/set -methods. - -.B vips_object_new(3) -is a convenience function which encapsulates the new/set/build sequence -outlined above. - -.B vips_object_new_from_string(3) -is a convenience function which builds an object from a set of arguments -encoded as a string. It used used by the VIPS command-line program to generate -operation arguments. - -.B vips_object_to_string(3) -is the exact inverse: it prints the string that would construct an object. - -.SH RETURN VALUE -Unless otherwise noted, functions return 0 success and -1 on error. -.SH SEE ALSO -VipsFormat(3), VipsInterpolate(3), -vips_type_find(3). -.SH AUTHOR -John Cupitt diff --git a/man/batch_crop.1 b/man/batch_crop.1 deleted file mode 100644 index 4546f071..00000000 --- a/man/batch_crop.1 +++ /dev/null @@ -1,22 +0,0 @@ -.TH BATCH_CROP 1 "2 Feb 2002" -.SH NAME -batch_crop \- crop a set of images -.SH SYNOPSIS -.B batch_crop left top width height image1 image2 ... -.SH DESCRIPTION -The area defined by the rectangle left, top, width, height is cropped out of -each of the images and saved in a file of the same name, but prefixed by -"crop_". - -For example: - - batch_crop 10 10 100 100 fred.jpg jim.png - -will make two images, crop_fred.jpg and crop_jim.png, each of 100 by 100 -pixels, taken from the corresponding input images. - -.SH RETURN VALUE -returns 0 on success and non-zero on error. -.SH SEE ALSO -header(1), im_vips2tiff(3), im_vips2jpeg(3), im_vips2png(3), im_vips2ppm(3) - diff --git a/man/batch_image_convert.1 b/man/batch_image_convert.1 deleted file mode 100644 index 1ae6d054..00000000 --- a/man/batch_image_convert.1 +++ /dev/null @@ -1,29 +0,0 @@ -.TH BATCH_IMAGE_CONVERT 1 "2 Feb 2002" -.SH NAME -batch_image_convert \- use VIPS to convert a set of images to a new type -.SH SYNOPSIS -.B batch_image_convert type image1 image2 ... -.SH DESCRIPTION -The first argument is the name of an image type, subsequent arguments are -the names of files to be converted to that type. VIPS can usually read almost -any image type, but it can only write VIPS, PNG, TIFF, PPM/PGM/PBM and JPEG. -You can specify conversion parameters in the type name. - -For example: - - batch_image_convert tiff fred.jpg jim.png - -will convert -.B fred.jpg -and -.B jim.png -to TIFF format. - - batch_image_convert jpeg:95 jim.png - -will write jim.jpeg with a 95% quality factor. -.SH RETURN VALUE -returns 0 on success and non-zero on error. -.SH SEE ALSO -header(1), im_vips2tiff(3), im_vips2jpeg(3), im_vips2png(3), im_vips2ppm(3) - diff --git a/man/batch_rubber_sheet.1 b/man/batch_rubber_sheet.1 deleted file mode 100644 index 976d80e6..00000000 --- a/man/batch_rubber_sheet.1 +++ /dev/null @@ -1,30 +0,0 @@ -.TH BATCH_RUBBER_SHEET 1 "2 Feb 2002" -.SH NAME -batch_rubber_sheet \- warp a set of images with a rubber-sheet transformation -.SH SYNOPSIS -.B batch_rubber_sheet matrix image1 image2 ... -.SH DESCRIPTION -The first argument specifies a file containing the transformation, subsequent -arguments are image files to be transformed. The transformed image is written -to a new file, named as the old file, but with "rsc_" prepended to the file -name. - -For example: - - batch_rubber_sheet lens.mat fred.jpg jim.png - -will read a transform from the file -.B lens.mat -and apply it to -.B fred.jpg -and -.B jim.png, -writing files -.B rsc_fred.jpg -and -.B rsc_jim.png. -.SH RETURN VALUE -returns 0 on success and non-zero on error. -.SH SEE ALSO -The "Image=>Rubber" menu in nip. - diff --git a/man/binfile.1 b/man/binfile.1 deleted file mode 100644 index 81f7c62a..00000000 --- a/man/binfile.1 +++ /dev/null @@ -1,19 +0,0 @@ -.TH BINFILE 1 "11 April 1990" -.SH NAME -im_binfile \- convert raw binary files to VIPS format -.SH SYNOPSIS -.B binfile in out xs ys b -.SH DESCRIPTION -.B binfile -expects as input a raw UNIX file with its filename held by the string in -and writes it to the vasari image file out by filling properly the header -details. It is expected that the file has sizes xs by ys and -has b bands. It is an error if the file in has less than xs*ys*b data. -The program is unable to check whether the supplied xs, ys and b are correct. -.SH SEE\ ALSO -im_binfile(3). -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 11/04/1990 diff --git a/man/cooc.1 b/man/cooc.1 deleted file mode 100644 index 049a7117..00000000 --- a/man/cooc.1 +++ /dev/null @@ -1,41 +0,0 @@ -.TH COOC 1 "27 Jan 1992" -.SH NAME -cooc, cooc_features \- calculate the co-occurrence matrix and features on it -.SH SYNOPSIS -cooc image matrix xpos ypos xsize ysize dx dy flag - -.br -.B cooc_features matrix -.SH DESCRIPTION -.B cooc -creates a 256 by 256 one channel co-occurrence matrix of the box -determined by the parameters (xp, yp; xs, ys) within -the image file. The matrix -is written onto the Vasari image file matrix. The displacement -vector is determined by (dx, dy). The user must ensure that there -is enough border pixels around the box within im dictated by the displacement -vector (dx,dy) or else the program fails. -All entries of the co-occurrence matrix are double normalised to the number -of pairs involved. This function is a direct implementation of the paper: -Haralick R. M., Shanmugan K. and Dinstein I., 'Textural features for -image classification', IEEE Transactions on Systems, Man, and Cybernetics, -Vol. SMC-3, No 6, Nov. 1973, pp 610-621. - -If flag sym is 1, the created co-occurrence matrix is symmetric that is -dispacement vectors (dx, dy), (-dx, -dy) create exactly the same matrix. -If sym is 0, the created co-occurrence matrix is not symmetric that is -dispacement vectors (dx, dy), (-dx, -dy) create different matrices. - -Input image should be one band unsigned char image. - -.B cooc_features -calculates and prints at the standard error output features -of the cooccurrence matrix matrix. -.SH SEE\ ALSO -im_glds_matrix(3X), im_cooc_asm(3X), im_cooc_contrast(3X), -im_cooc_correlation(3X), im_cooc_entropy(3X) -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 27/2/1992 diff --git a/man/cooc_features.1 b/man/cooc_features.1 deleted file mode 100644 index 50459e9e..00000000 --- a/man/cooc_features.1 +++ /dev/null @@ -1 +0,0 @@ -.so man1/cooc.1 diff --git a/man/debugim.1 b/man/debugim.1 deleted file mode 100644 index f1639b5b..00000000 --- a/man/debugim.1 +++ /dev/null @@ -1,21 +0,0 @@ -.TH DEBUGIM 1 "12 July 1990" -.SH NAME -debugim, printlines \- prints the raw image data of a vasari file format -.SH SYNOPSIS -debugim infile - -printlines infile -.SH DESCRIPTION -debugim prints at the standard error output the raw image data of a vasari -format file. This function is useful for debugging when applied on small -image files - -printlines prints at the standard error output the raw image data of a vasari -format together with the line no and the x location and the value(s) of each -pixel. -.SH SEE ALSO -im_intro(3X), im_debugim(3X), im_printlines(3X), vips2mask(1X). -.SH COPYRIGHT -N. Dessipris -.SH AUTHOR -N. Dessipris \- 12/07/1990 diff --git a/man/edvips.1 b/man/edvips.1 deleted file mode 100644 index 73fd861e..00000000 --- a/man/edvips.1 +++ /dev/null @@ -1,49 +0,0 @@ -.TH EDVIPS 1 "30 June 1993" -.SH NAME -edvips \- edit header of a vips image file -.SH SYNOPSIS -.B edvips [OPTION...] vipsfile -.SH DESCRIPTION -.B edvips -alters a VIPS image file's header. This is useful for setting the resolution, -for example. - -The options are: - - -x, --xsize=N set Xsize to N - -y, --ysize=N set Ysize to N - -b, --bands=N set Bands to N - -f, --format=F set BandFmt to F (eg. IM_BANDFMT_UCHAR) - -t, --type=T set Type to T (eg. IM_TYPE_XYZ) - -c, --coding=C set Coding to C (eg. IM_CODING_LABQ) - -X, --xres=R set Xres to R pixels/mm - -Y, --yres=R set Yres to R pixels/mm - -u, --xoffset=N set Xoffset to N - -v, --yoffset=N set Yoffset to N - -e, --setext replace extension block with stdin - -Be very careful when changing Xsize, Ysize, BandFmt or Bands. edvips does no -checking! - -.SH EXAMPLES -To set the Xsize to 512 and Bands to 6: - - edvips --xsize=512 --bands=6 fred.v - -or - - edvips -x 512 -b 6 fred.v - -Extract the XML metadata from an image with -.B header(1), -edit it, and reattach with -.B edvips(1). - - header -f getext fred.v | sed s/banana/pineapple/ | edvips -e fred.v - -.SH RETURN VALUE -returns 0 on success and non-zero on error. -.SH SEE ALSO -header(1) -.SH COPYRIGHT -K. Martinez 1993 diff --git a/man/error_exit.3 b/man/error_exit.3 deleted file mode 100644 index 7db4b63b..00000000 --- a/man/error_exit.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_error.3 diff --git a/man/glds.1 b/man/glds.1 deleted file mode 100644 index e98636d3..00000000 --- a/man/glds.1 +++ /dev/null @@ -1,35 +0,0 @@ -.TH GLDS 1 "27 January 1992" -.SH NAME -glds, glds_features \- calculate the spatial grey level difference matrix and features on it -.SH SYNOPSIS -glds image matrix xpos ypos xsize ysize dx dy - -glds_features matrix -.SH DESCRIPTION -.B glds -creates a 256 by 1 one channel spatial grey level difference -matrix (sglds) of the box -determined by the parameters (xp, yp; xs, ys) within -the vasari image file image. The matrix -is written onto the vasari image file matrix. The displacement -vector is determined by (dx, dy). The user must ensure that there -is enough border pixels around the box within im dictated by the displacement -vector (dx,dy) or else the program fails. -All entries of the sgld matrix are double normalised to the number -of pairs involved. This function is a direct implementation of the paper: -Haralick R. M., Shanmugan K. and Dinstein I., 'Textural features for -image classification', IEEE Transactions on Systems, Man, and Cybernetics, -Vol. SMC-3, No 6, Nov. 1973, pp 610-621. - -Input im should be one band unsigned char image file. - -.B glds_features -calculates features on the spatial grey level difference vasari image -file matrix. The calculated features are printed in the stderr. -.SH SEE\ ALSO -im_glds_matrix(3X), im_glds_asm(3X), im_glds_contrast(3X), -im_glds_correlation(3X), im_glds_entropy(3X). -.SH COPYRIGHT -N. Dessipris -.SH AUTHOR -N. Dessipris \- 27/02/1992 diff --git a/man/glds_features.1 b/man/glds_features.1 deleted file mode 100644 index 0dd971a6..00000000 --- a/man/glds_features.1 +++ /dev/null @@ -1 +0,0 @@ -.so man1/glds.1 diff --git a/man/header.1 b/man/header.1 deleted file mode 100644 index 091da1be..00000000 --- a/man/header.1 +++ /dev/null @@ -1,33 +0,0 @@ -.TH HEADER 1 "12 July 1990" -.SH NAME -header \- prints information about an image file -.SH SYNOPSIS -header [OPTIONS ...] files ... -.SH DESCRIPTION -.B header(1) -prints image header fields to stdout. - -.SH OPTIONS -.TP -.B -f FIELD, --field=FIELD -Print value of -.B FIELD -from image header. The special field name getext prints -the VIPS extension block: the XML defining the image metadata. You can alter -this, then reattach with -.B edvips(1). - -.SH EXAMPLES - pineapple:~/CVS/vips-7.12/src/iofuncs john$ header -f Xsize ~/pics/*.v - 1024 - 1279 - 22865 - 1 - 256 - -.SH SEE ALSO -im_intro(3), edvips(1), im_printdesc(3), im_header_get(3). -.SH COPYRIGHT -N. Dessipris -.SH AUTHOR -N. Dessipris \- 12/07/1990 diff --git a/man/im_BandFmt2char.3 b/man/im_BandFmt2char.3 deleted file mode 100644 index 72471e9c..00000000 --- a/man/im_BandFmt2char.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_printdesc.3 diff --git a/man/im_Coding2char.3 b/man/im_Coding2char.3 deleted file mode 100644 index 72471e9c..00000000 --- a/man/im_Coding2char.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_printdesc.3 diff --git a/man/im_Compression2char.3 b/man/im_Compression2char.3 deleted file mode 100644 index 72471e9c..00000000 --- a/man/im_Compression2char.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_printdesc.3 diff --git a/man/im_LCh2Lab.3 b/man/im_LCh2Lab.3 deleted file mode 100644 index 6866a230..00000000 --- a/man/im_LCh2Lab.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_XYZ2disp.3 diff --git a/man/im_LCh2UCS.3 b/man/im_LCh2UCS.3 deleted file mode 100644 index 6866a230..00000000 --- a/man/im_LCh2UCS.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_XYZ2disp.3 diff --git a/man/im_Lab2LCh.3 b/man/im_Lab2LCh.3 deleted file mode 100644 index 6866a230..00000000 --- a/man/im_Lab2LCh.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_XYZ2disp.3 diff --git a/man/im_Lab2LabQ.3 b/man/im_Lab2LabQ.3 deleted file mode 100644 index 02106cc1..00000000 --- a/man/im_Lab2LabQ.3 +++ /dev/null @@ -1,59 +0,0 @@ -.TH IM_XYZ2disp 3 "2 Decemder 1992" -.SH NAME -im_LabQ2Lab, im_Lab2LabQ, im_LabQ2LabS, im_LabS2LabQ, im_Lab2LabS, im_LabS2Lab \- pack and unpack LABPACK images. -.SH SYNOPSIS -#include - -int im_LabQ2Lab(in, out) -.br -IMAGE *in, *out; - -int im_Lab2LabQ(in, out) -.br -IMAGE *in, *out; - -int im_Lab2LabS(in, out) -.br -IMAGE *in, *out; - -int im_LabS2LabQ(in, out) -.br -IMAGE *in, *out; - -int im_LabS2Lab(in, out) -.br -IMAGE *in, *out; - -int im_LabQ2LabS(in, out) -.br -IMAGE *in, *out; - -.SH DESCRIPTION -These functions pack and unpack LAB images. - -LabQ is Lab packed in to 4 unsigned chars, with the Coding field set to -LABPACK. It counts as a coded type, since most operations will not give the -correct result on an image of this type. This is the MARC image type. Bits -are allocated as 10 for L and 11 for each of a and b. The first three bytes -contain the 8 most significant bits of Lab respectively, the final byte has -2/3/3 bits (MSB on left) of Lab respectively. - -im_LabQ2Lab() and im_Lab2LabQ() convert LABPACK images to three band float -images, scaled to look sensible to humans. This is the most convenient LAB -format for development work, but is rather slow. - -im_LabQ2LabS() and im_LabS2LabQ() convert LABPACK to and from three band -signed short images. L is shifted and masked to be in the range [0,32767], a -and b are shifted and masked to lie in [-32768,32767]. This is the best -computational LAB format, combining precision and speed. Programs such as -conv(1X) and similarity(1X), which can operate directly on LABPACK images, -unpack to LabS for computation. - -.SH RETURN VALUE -The functions return 0 on success and -1 on error. -.SH SEE ALSO -im_col_XYZ2rgb(3), im_dE_fromdisp(3), im_XYZ2disp(3). -.SH COPYRIGHT -National Gallery, 1990 - 1993 -.SH AUTHOR -J. Cupitt \- 21/7/93 diff --git a/man/im_Lab2LabS.3 b/man/im_Lab2LabS.3 deleted file mode 100644 index 9c69e1f5..00000000 --- a/man/im_Lab2LabS.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_Lab2LabQ.3 diff --git a/man/im_Lab2UCS.3 b/man/im_Lab2UCS.3 deleted file mode 100644 index 3972526e..00000000 --- a/man/im_Lab2UCS.3 +++ /dev/null @@ -1,70 +0,0 @@ -.TH IM_LAB2UCS 3 "2 December 1992" -.SH NAME -im_Lab2UCS, im_LabQ2XYZ, im_UCS2Lab, im_Lab2disp, im_disp2Lab, im_UCS2XYZ, -im_XYZ2UCS \- derived colour space conversion functions -.SH SYNOPSIS -#include - -int im_Lab2UCS(in, out) -.br -IMAGE *in, *out; - -int im_LabQ2XYZ(in, out) -.br -IMAGE *in, *out; - -int im_UCS2Lab(in, out) -.br -IMAGE *in, *out; - -int im_Lab2disp(in, out, display) -.br -IMAGE *in, *out; -.br -struct im_col_display *display; - -int im_disp2Lab(in, out, display) -.br -IMAGE *in, *out; -.br -struct im_col_display *display; - -int im_UCS2XYZ(in, out) -.br -IMAGE *in, *out; - -int im_XYZ2UCS(in, out) -.br -IMAGE *in, *out; - -.SH DESCRIPTION -These functions are built on the basic VIPS colour space transformations as a -convenience for the programmer. See im_Lab2XYZ(3) for an explanation of the -colour spaces and the basic conversion functions. - -im_Lab2UCS(3), for example, is defined as: - - int - im_Lab2UCS( IMAGE *in, IMAGE *out ) - { - IMAGE *t1 = im_open_local( out, - "im_Lab2UCS intermediate", "p" ); - - if( !t1 || - im_Lab2LCh( in, t1 ) || - im_LCh2UCS( t1, out ) ) - return( -1 ); - - return( 0 ); - } - -.SH RETURN VALUE -The functions return 0 on success and -1 on error. -.SH SEE ALSO -im_col_XYZ2rgb(3), im_dE_fromLab(3), im_LabQ2Lab(3), im_Lab2disp(3). -.SH COPYRIGHT -National Gallery and Birkbeck College, 1990 - 1993 -.SH AUTHOR -K. Martinez \- 2/12/1992 -.br -J. Cupitt \- 21/7/93 diff --git a/man/im_Lab2XYZ.3 b/man/im_Lab2XYZ.3 deleted file mode 100644 index 6866a230..00000000 --- a/man/im_Lab2XYZ.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_XYZ2disp.3 diff --git a/man/im_Lab2disp.3 b/man/im_Lab2disp.3 deleted file mode 100644 index cb1e992d..00000000 --- a/man/im_Lab2disp.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_Lab2UCS.3 diff --git a/man/im_LabQ2Lab.3 b/man/im_LabQ2Lab.3 deleted file mode 100644 index 9c69e1f5..00000000 --- a/man/im_LabQ2Lab.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_Lab2LabQ.3 diff --git a/man/im_LabQ2LabS.3 b/man/im_LabQ2LabS.3 deleted file mode 100644 index 9c69e1f5..00000000 --- a/man/im_LabQ2LabS.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_Lab2LabQ.3 diff --git a/man/im_LabQ2XYZ.3 b/man/im_LabQ2XYZ.3 deleted file mode 100644 index cb1e992d..00000000 --- a/man/im_LabQ2XYZ.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_Lab2UCS.3 diff --git a/man/im_LabQ2disp.3 b/man/im_LabQ2disp.3 deleted file mode 100644 index 6be15c62..00000000 --- a/man/im_LabQ2disp.3 +++ /dev/null @@ -1,32 +0,0 @@ -.TH IM_LABQ2DISP 3 "2 Decemder 1997" -.SH NAME -im_LabQ2disp, im_LabQ2disp_build_table, im_LabQ2disp_table \- convert LabQ to display rgb quickly and badly -.SH SYNOPSIS -#include - -int im_LabQ2disp( IMAGE *in, IMAGE *out, struct im_col_display *d ); - -void *im_LabQ2disp_build_table( IMAGE *out, struct im_col_display *d ); - -int im_LabQ2disp_table( IMAGE *in, IMAGE *out, void *table ); - -.SH DESCRIPTION -These functions convert LabQ images to displayable RGB as quickly as possible. - -im_LabQ2disp() converts in to out using the display profile d. It has to build -a large lookup table, so takes a while to start. - -im_LabQ2disp_build_table() is just the table-build phase of im_LabQ2disp(). It -returns a handle to the built table (or NULL for error). The memory for the -table is allocated local to out (ie is freed when out is closed). - -im_LabQ2disp_table() converts in to out using the supplied table. - -.SH RETURN VALUE -The functions return 0 on success and -1 on error. -.SH SEE ALSO -im_LabQ2Lab(3), im_Lab2XYZ(3), im_XYZ2disp(3) -.SH COPYRIGHT -National Gallery, 1990 - 1997 -.SH AUTHOR -J. Cupitt \- 21/7/97 diff --git a/man/im_LabQ2disp_build_table.3 b/man/im_LabQ2disp_build_table.3 deleted file mode 100644 index ce04ce4a..00000000 --- a/man/im_LabQ2disp_build_table.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_LabQ2disp.3 diff --git a/man/im_LabQ2disp_table.3 b/man/im_LabQ2disp_table.3 deleted file mode 100644 index ce04ce4a..00000000 --- a/man/im_LabQ2disp_table.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_LabQ2disp.3 diff --git a/man/im_LabS2Lab.3 b/man/im_LabS2Lab.3 deleted file mode 100644 index 9c69e1f5..00000000 --- a/man/im_LabS2Lab.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_Lab2LabQ.3 diff --git a/man/im_LabS2LabQ.3 b/man/im_LabS2LabQ.3 deleted file mode 100644 index 9c69e1f5..00000000 --- a/man/im_LabS2LabQ.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_Lab2LabQ.3 diff --git a/man/im_Type2char.3 b/man/im_Type2char.3 deleted file mode 100644 index 72471e9c..00000000 --- a/man/im_Type2char.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_printdesc.3 diff --git a/man/im_UCS2LCh.3 b/man/im_UCS2LCh.3 deleted file mode 100644 index 6866a230..00000000 --- a/man/im_UCS2LCh.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_XYZ2disp.3 diff --git a/man/im_UCS2Lab.3 b/man/im_UCS2Lab.3 deleted file mode 100644 index cb1e992d..00000000 --- a/man/im_UCS2Lab.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_Lab2UCS.3 diff --git a/man/im_UCS2XYZ.3 b/man/im_UCS2XYZ.3 deleted file mode 100644 index cb1e992d..00000000 --- a/man/im_UCS2XYZ.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_Lab2UCS.3 diff --git a/man/im_XYZ2Lab.3 b/man/im_XYZ2Lab.3 deleted file mode 100644 index 6866a230..00000000 --- a/man/im_XYZ2Lab.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_XYZ2disp.3 diff --git a/man/im_XYZ2UCS.3 b/man/im_XYZ2UCS.3 deleted file mode 100644 index cb1e992d..00000000 --- a/man/im_XYZ2UCS.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_Lab2UCS.3 diff --git a/man/im_XYZ2Yxy.3 b/man/im_XYZ2Yxy.3 deleted file mode 100644 index 6866a230..00000000 --- a/man/im_XYZ2Yxy.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_XYZ2disp.3 diff --git a/man/im_XYZ2disp.3 b/man/im_XYZ2disp.3 deleted file mode 100644 index 409c5ad0..00000000 --- a/man/im_XYZ2disp.3 +++ /dev/null @@ -1,142 +0,0 @@ -.TH IM_XYZ2disp 3 "2 Decemder 1992" -.SH NAME -im_XYZ2disp, im_disp2XYZ, im_Lab2XYZ, im_XYZ2Lab, im_XYZ2Yxy, im_Yxy2XYZ, -im_XYZ2sRGB, im_sRGB2XYZ, -im_Lab2LCh, im_LCh2Lab, im_LCh2UCS, im_UCS2LCh \- convert images between -various colour spaces -.SH SYNOPSIS -#include - -int im_XYZ2disp(in, out, display) -.br -IMAGE *in, *out; -.br -struct im_col_display *display; - -int im_disp2XYZ(in, out, display) -.br -IMAGE *in, *out; -.br -struct im_col_display *display; - -int im_Lab2XYZ(in, out) -.br -IMAGE *in, *out; - -int im_XYZ2Lab(in, out) -.br -IMAGE *in, *out; - -int im_XYZ2Yxy(in, out) -.br -IMAGE *in, *out; - -int im_Yxy2XYZ(in, out) -.br -IMAGE *in, *out; - -int im_XYZ2sRGB(in, out) -.br -IMAGE *in, *out; - -int im_sRGB2XYZ(in, out) -.br -IMAGE *in, *out; - -int im_Lab2LCh(in, out) -.br -IMAGE *in, *out; - -int im_LCh2Lab(in, out) -.br -IMAGE *in, *out; - -int im_LCh2UCS(in, out) -.br -IMAGE *in, *out; - -int im_UCS2LCh(in, out) -.br -IMAGE *in, *out; - -.SH DESCRIPTION -Functions to convert images between the different colour spaces supported by -VIPS: RGB, sRGB, XYZ, Yxy, Lab, LCh and UCS. RGB and sRGB are three band uchar -files. XYZ, Lab, LCh and UCS are three band float files. - -These are the basic conversion routines provided by VIPS. Other conversions, -such as im_Lab2disp(3), are built by composing these functions and are provided -as a convenience to the programmer. - -The VIPS colour spaces inter-convert as follows: - - +------- sRGB - | - LabQ ----- Lab ----- XYZ ----- RGB - | | | - | | +------- Yxy - | | - | +------- LCh ----- UCS - | - +-------- LabS - -The colour spaces are: - -LabQ --- This is the principal VIPS colorimetric storage format. See -im_LabQ2Lab(3) for an explanation. You cannot perform calculations on LabQ -images. They are for storage only. - -LabS --- This format represents coordinates in CIE Lab space as 16-bit -integers. It is the best format for computation, being relatively compact, -quick, and accurate. Colour values expressed in this way are hard to -visualise. See the page for im_LabQ2LabS(). - -Lab --- Coordinates in CIE Lab space are represented as float values in the -usual range. This is the easiest format for general work: adding 50 to the L -channel, for example, has the expected result. - -XYZ --- CIE XYZ colour space. - -Yxy --- CIE Yxy colour space. - -RGB --- This format is compatible with the RGB colour systems used in other -packages. If you want to export your image to a PC, for example, convert your -colorimetric image to RGB, then turn it to TIFF with vips2TIFF(1). You need to -supply a structure which characterises your display. See the manual page for -im_col_XYZ2rgb(3) for hints on these guys. - -sRGB --- This is a standard RGB, as defined by: - - http://www.color.org/contrib/sRGB.html - -it's handy for carrying colour information through JPEG compressors, for -example. - -LCh --- Like Lab, but the rectangular ab coordinates are replaced with the -polar Ch (Chroma and hue) coordinates. Hue angles are expressed in degrees. - -UCS --- A colour space based on the CMC(1:1) colour difference measurement. -This is a highly uniform colour space, much better than Lab for expressing -small differences. Conversions to and from UCS are extremely slow. - -These conversions set the Type field in the image header to LABQ, LABS, LAB, -XYZ, RGB, sRGB, LCH and UCS respectively. The Type field is for user -information only --- no function reads the Type field to determine its -behaviour. Visualisation programs, such as ip(1), use the Type field to help -present the information to the user. - -All VIPS colour spaces are based around D65. - -VIPS has functions for finding colour difference images. See -im_dE_fromLab(3). - -.SH RETURN VALUE -The functions return 0 on success and -1 on error. -.SH SEE ALSO -im_col_XYZ2rgb(3), im_dE_fromLab(3), im_LabQ2Lab(3), im_Lab2disp(3). -.SH COPYRIGHT -National Gallery and Birkbeck College, 1990 - 1993 -.SH AUTHOR -K. Martinez \- 2/12/1992 -.br -J. Cupitt \- 21/7/93 diff --git a/man/im_XYZ2sRGB.3 b/man/im_XYZ2sRGB.3 deleted file mode 100644 index 6866a230..00000000 --- a/man/im_XYZ2sRGB.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_XYZ2disp.3 diff --git a/man/im_Yxy2XYZ.3 b/man/im_Yxy2XYZ.3 deleted file mode 100644 index 6866a230..00000000 --- a/man/im_Yxy2XYZ.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_XYZ2disp.3 diff --git a/man/im_abs.3 b/man/im_abs.3 deleted file mode 100644 index 329746f4..00000000 --- a/man/im_abs.3 +++ /dev/null @@ -1,18 +0,0 @@ -.TH IM_ABS 3 "25 April 1991" -.SH NAME -im_abs \- finds the absolute value or the magnitude of an image -.SH SYNOPSIS -#include - -int im_abs( in, out ) -.br -IMAGE *in, *out; -.SH DESCRIPTION -.B im_abs(3) -finds the absolute value of an image. Copy for UNSIGNED types, negate -for int types, fabs(3) for float types, and calculate modulus for -complex types. Any size, any number of bands. -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_exp10tra(3), im_sign(3) diff --git a/man/im_acostra.3 b/man/im_acostra.3 deleted file mode 100644 index 83ac049e..00000000 --- a/man/im_acostra.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_costra.3 diff --git a/man/im_add.3 b/man/im_add.3 deleted file mode 100644 index 144c589e..00000000 --- a/man/im_add.3 +++ /dev/null @@ -1,102 +0,0 @@ -.TH ADDITION 3 "24 April 1991" -.SH NAME -im_add, im_gadd, im_gaddim, im_gfadd \- add two images -.SH SYNOPSIS -#include - -int im_add(in1, in2, out) -.br -IMAGE *in1, *in2, *out; - -int im_gadd(a, in1, b, in2, c, out) -.br -double a, b, c; -.br -IMAGE *in1, *in2, *out; - -int im_gaddim(a, in1, b, in2, c, out) -.br -double a, b, c; -.br -IMAGE *in1, *in2, *out; - -int im_gfadd(a, in1, b, in2, c, out) -.br -double a, b, c; -.br -IMAGE *in1, *in2, *out; - -.SH DESCRIPTION -These functions operate on two images held by image descriptors in1 and in2 -and write the result to the image descriptor out. Input images in1 and in2 -should have the same channels and the same size; however they can be of -different types. Only the history of the image descriptor pointed by in1 is -copied to out. - -.B im_add(3) - -For two integer images, add the two images and write the output as - - in1 - uchar char ushort short uint int - -------|----------------------------------------- - in2 | - uchar | ushort short ushort short uint int - char | short short short short int int - ushort | ushort short ushort short uint int - short | short short short short int int - uint | uint int uint int uint int - int | int int int int int int - -If one or more of the images is a floating point type, the output is FMTFLOAT, -unless one or more of the inputs is FMTDOUBLE, in which case the output is -also FMTDOUBLE. - -If one or more of the images is a complex type, the output is FMTCOMPLEX, -unless one or more of the inputs is FMTDPCOMPLEX, in which case the output is -also FMTDPCOMPLEX. - -.B im_gadd(3) -performs generalised addition of two images by calling -.B im_gaddim(3) -and -.B im_gfadd(3). -These are very old and tired things, and should not be used. - -Input should be non complex. Output depends on input according to function -called. The result at each point is: a * pel1 + b * pel2 + c, properly -rounded if necessary. Pel1 and pel2 are the -corresponding pixels from in1 and in2 respectively. - -im_gaddim() performs generalised addition of in1 and in2, on the condition -they are neither float nor double nor complex. The format of the resultant -image is given by the table: - - in1 - uchar char ushort short uint int - -------|----------------------------------------- - in2 | - uchar | ushort short ushort short uint int - char | short short short short int int - ushort | ushort short ushort short uint int - short | short short short short int int - uint | uint int uint int uint int - int | int int int int int int - -The result at each point is: a * pel1 + b * pel2 + c, properly rounded. Pel1 -and pel2 are the corresponding pixels from in1 and in2 respectively. - -.B im_gfadd(3) -adds the non-complex images pointed by in1 and in2. Result is -float except if one (or both) inputs is double. In the latter case the result -is double. The result at each point is: a * pel1 + b * pel2 + c. Pel1 and -pel2 are the corresponding pixels from in1 and in2 respectively. - -.SH BUGS -None of the functions checks the result for over/underflow. -.SH RETURN VALUE -All functions return 0 on success and -1 on error. -.SH SEE ALSO -im_subtract(3), im_lintra(3), im_multiply(3). -.SH AUTHOR -N. Dessipris \- 22/04/1991 -.br -J. Cupitt, im_add(), \- 21/7/93 diff --git a/man/im_add_close_callback.3 b/man/im_add_close_callback.3 deleted file mode 100644 index 0be9c41f..00000000 --- a/man/im_add_close_callback.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_malloc.3 diff --git a/man/im_add_eval_callback.3 b/man/im_add_eval_callback.3 deleted file mode 100644 index 0be9c41f..00000000 --- a/man/im_add_eval_callback.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_malloc.3 diff --git a/man/im_add_evalend_callback.3 b/man/im_add_evalend_callback.3 deleted file mode 100644 index 0be9c41f..00000000 --- a/man/im_add_evalend_callback.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_malloc.3 diff --git a/man/im_add_evalstart_callback.3 b/man/im_add_evalstart_callback.3 deleted file mode 100644 index 0be9c41f..00000000 --- a/man/im_add_evalstart_callback.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_malloc.3 diff --git a/man/im_add_invalidate_callback.3 b/man/im_add_invalidate_callback.3 deleted file mode 100644 index 0be9c41f..00000000 --- a/man/im_add_invalidate_callback.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_malloc.3 diff --git a/man/im_add_preclose_callback.3 b/man/im_add_preclose_callback.3 deleted file mode 100644 index 0be9c41f..00000000 --- a/man/im_add_preclose_callback.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_malloc.3 diff --git a/man/im_addgnoise.3 b/man/im_addgnoise.3 deleted file mode 100644 index f41ed39f..00000000 --- a/man/im_addgnoise.3 +++ /dev/null @@ -1,27 +0,0 @@ -.TH IM_ADDGNOISE 3 "14 May 1991" -.SH NAME -im_addgnoise \- add gaussian noise to an image -.SH SYNOPSIS -#include - -int im_addgnoise(in, out, sigma) -.br -IMAGE *in, *out; -.br -double sigma; - -.SH DESCRIPTION -im_addgnoise() adds gaussian noise with mean 0 and standard deviation sigma to -the image held by the image descriptor in and writes the result on the image -descriptor out. The function works on any non-complex input image. -Input can have any no of bands. The noise is generated by adding -12 random numbers. - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_add(3), im_lintra(3), im_multiply(3). -.SH COPYRIGHT -N. Dessipris -.SH AUTHOR -N. Dessipris \- 25/04/1991 diff --git a/man/im_affine.3 b/man/im_affine.3 deleted file mode 100644 index be5b4405..00000000 --- a/man/im_affine.3 +++ /dev/null @@ -1,41 +0,0 @@ -.TH IM_AFFINE 3 "21 December 1999" -.SH NAME -im_affine \- apply an affine transform to an image -.SH SYNOPSIS -.B #include - -int im_affine(in, out, a, b, c, d, dx, dy, x, y, w, h) -.br -.B IMAGE *in, *out; -.br -.B double a, b, c, d, dx, dy; -.br -.B int x, y; -.br -.B int w, h; - -.SH DESCRIPTION -This function is deprecated. See -.B im_affine(3) -for the replacement. - -.B im_affine(3) -applies an affine transformation on the image held by the IMAGE descriptor -in and puts the result at the location pointed by the IMAGE descriptor out. in -many have any number of bands, be any size, and have any non-complex type. - -The transformation is described by a, b, c, d, dx, dy. The point (x,y) in -the input is mapped onto point (X,Y) in the output by - - X = a * x + b * y + dx - Y = c * x + d * y + dy - -The area of the output image given by w, h, x, y is generated. (0,0) is -the position of the transformed top-left-hand corner of the input image. -Function im_affine resamples the transformed image using bilinear -interpolation. - -.SH RETURN VALUE -The functions return 0 on success and -1 on error. -.SH SEE ALSO -im_similarity(3) diff --git a/man/im_affinei.3 b/man/im_affinei.3 deleted file mode 100644 index ee63a8bc..00000000 --- a/man/im_affinei.3 +++ /dev/null @@ -1,58 +0,0 @@ -.TH IM_AFFINEI 3 "8 February 2009" -.SH NAME -im_affinei \- apply an affine transform to an image -.SH SYNOPSIS -.B #include - -int im_affinei(in, out, interpolate, a, b, c, d, dx, dy, x, y, w, h) -.br -.B IMAGE *in, *out; -.br -.B VipsInterpolate *interpolate; -.br -.B double a, b, c, d, dx, dy; -.br -.B int x, y; -.br -.B int w, h; - -int im_affinei_all(in, out, interpolate, a, b, c, d, dx, dy) -.br -.B IMAGE *in, *out; -.br -.B VipsInterpolate *interpolate; -.br -.B double a, b, c, d, dx, dy; - -.SH DESCRIPTION -.B im_affinei(3) -applies an affine transformation on the image held by the IMAGE descriptor -in and puts the result at the location pointed by the IMAGE descriptor out. in -many have any number of bands, be any size, and have any non-complex type. - -The transformation is described by a, b, c, d, dx, dy. The point (x,y) in -the input is mapped onto point (X,Y) in the output by - - X = a * x + b * y + dx - Y = c * x + d * y + dy - -The area of the output image given by w, h, x, y is generated. (0,0) is -the position of the transformed top-left-hand corner of the input image. - -Points are generated using the supplied interpolator. See -.B VipsInterpolate(3) -for a list of the interpolators that come with vips. - -.B im_affinei_all(3) -is a convenience function that transforms the whole of the input image. It -calls -.B im_affine(3) -for you, with x y w h set to exactly enclose the transformed image. - -.SH RETURN VALUE -The functions return 0 on success and -1 on error. -.SH BUGS -As with most resamplers, im_affine(3) performs poorly at the edges of -images. -.SH SEE ALSO -im_similarity(3) diff --git a/man/im_affinei_all.3 b/man/im_affinei_all.3 deleted file mode 100644 index 37d2ee21..00000000 --- a/man/im_affinei_all.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_affinei.3 diff --git a/man/im_allocate_input_array.3 b/man/im_allocate_input_array.3 deleted file mode 100644 index c124af1e..00000000 --- a/man/im_allocate_input_array.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_generate.3 diff --git a/man/im_amiMSBfirst.3 b/man/im_amiMSBfirst.3 deleted file mode 100644 index 31d449ad..00000000 --- a/man/im_amiMSBfirst.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_iscomplex.3 diff --git a/man/im_analyze2vips.3 b/man/im_analyze2vips.3 deleted file mode 100644 index a2c00142..00000000 --- a/man/im_analyze2vips.3 +++ /dev/null @@ -1,33 +0,0 @@ -.TH IM_ANALYZE2VIPS 3 "4 August 2005" -.SH NAME -im_analyze2vips \- convert Analyze 7.5 images to VIPS format -.SH SYNOPSIS -#include - -int im_analyze2vips( const char *filename, IMAGE *out ) - -.SH DESCRIPTION -.B im_analyze2vips(3) -reads the Analyze image in -.B filename, -and writes the image out -in VIPS format. It can read (almost) any Analyze format image. Images with -more than two dimensions simply appear as a very tall, thin strip. Use -.B im_grid(3) -to lay the tiles out as your prefer. - -It reads the old-style 7.5 format, where the header and the image data are -stored in separate files. You can give the name of either the header (for -example, "fred.hdr") the image data (for example, "fred.img"), or neither (eg. -"fred"). - -The fields in the Analyze header appear in the VIPS header with a "dsr-" -prefix. So the Analyze field "patient_id", which is part of data_history, may -be retrieved with - - im_header_string "dsr-data_history.patient_id" fred.v - -.SH SEE ALSO -im_grid(3) -.SH COPYRIGHT -Imperial College 2005 diff --git a/man/im_and_vec.3 b/man/im_and_vec.3 deleted file mode 100644 index dfcd881e..00000000 --- a/man/im_and_vec.3 +++ /dev/null @@ -1,2 +0,0 @@ -.so man3/im_andimage.3 - diff --git a/man/im_andconst.3 b/man/im_andconst.3 deleted file mode 100644 index 46ff7aff..00000000 --- a/man/im_andconst.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_andimage.3 diff --git a/man/im_andimage.3 b/man/im_andimage.3 deleted file mode 100644 index 63ad74d1..00000000 --- a/man/im_andimage.3 +++ /dev/null @@ -1,91 +0,0 @@ -.TH IM_ANDIMAGE 3 "30 October 1992" -.SH NAME -im_andimage, im_andconst, im_and_vec, im_orimage, im_orconst, im_or_vec, -im_eorimage, im_eorconst, im_eor_vec \- boolean -operations on unsigned char images -.SH SYNOPSIS -.B #include - -.B int im_andimage(a, b, out) -.br -.B IMAGE *a, *b, *out; - -.B int im_andconst(a, out, c) -.br -.B IMAGE *a, *out; -.br -.B double c; - -.B int im_and_vec(a, out, n, v) -.br -.B IMAGE *a, *out; -.br -.B int n; -.br -.B double *v; - -.B int im_orimage(a, b, out) -.br -.B IMAGE *a, *b, *out; - -.B int im_orconst(a, out, c) -.br -.B IMAGE *a, *out; -.br -.B double c; - -.B int im_or_vec(a, out, n, v) -.br -.B IMAGE *a, *out; -.br -.B int n; -.br -.B double *v; - -.B int im_eorimage(a, b, out) -.br -.B IMAGE *a, *b, *out; - -.B int im_eorconst(a, out, c) -.br -.B IMAGE *a, *out; -.br -.B double c; - -.B int im_eor_vec(a, out, n, v) -.br -.B IMAGE *a, *out; -.br -.B int n; -.br -.B double *v; - -.SH DESCRIPTION -Perform bitwise logical operations on integer images. - -.B im_andimage(3) -performs bitwise and between corresponding pixels in a and b, writing the -result to out. Both images must be the same size and have the same number -of bands. They can have any integer type. - -.B im_andconst(3) -performs bitwise and between pixels in a and a single -constant value. -.B im_and_vec(3) -lets you specify n constants, one per band. - -.B im_orimage(3) -and -.B im_eorimage(3) -behave similarly. Use im_eorconst( in, out, -1 ) or -.B im_invert(3) -as a not operator. - -.SH RETURN VALUE -All functions return 0 on success and -1 on error. -.SH SEE ALSO -im_ifthenelse(3), im_equal(3). -.SH COPYRIGHT -National Gallery, 1992 -.SH AUTHOR -J. Cupitt diff --git a/man/im_asintra.3 b/man/im_asintra.3 deleted file mode 100644 index 83ac049e..00000000 --- a/man/im_asintra.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_costra.3 diff --git a/man/im_atantra.3 b/man/im_atantra.3 deleted file mode 100644 index 83ac049e..00000000 --- a/man/im_atantra.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_costra.3 diff --git a/man/im_avg.3 b/man/im_avg.3 deleted file mode 100644 index 12e9570b..00000000 --- a/man/im_avg.3 +++ /dev/null @@ -1,101 +0,0 @@ -.TH STATS 3 "24 April 1991" -.SH NAME -im_avg, im_deviate, im_min, im_minpos, im_max, im_maxpos \- find the mean, standard deviation, minimum and maximum of an image -.SH SYNOPSIS -.B #include - -.B int im_avg(im, out) -.br -.B IMAGE *im; -.br -.B double *out; - -.B int im_deviate(im, out) -.br -.B IMAGE *im; -.br -.B double *out; - -.B int im_min(im, out) -.br -.B IMAGE *im; -.br -.B double *out; - -.B int im_minpos(im, xpos, ypos, min) -.br -.B IMAGE *im; -.br -.B int *xpos, *ypos; -.br -.B double *min; - -.B int im_max(im, out) -.br -.B IMAGE *im; -.br -.B double *out; - -.B int im_maxpos(im, xpos, ypos, max) -.br -.B IMAGE *im; -.br -.B int *xpos, *ypos; -.br -.B double *max; - -.SH DESCRIPTION -These functions find the mean, standard deviation, minimum, maximum of an image. -They operate on all bands of the input image. Use -.B im_stats(3) -if you need to calculate on bands separately. -All computations are carried out in -double precision arithmetic. -The standard deviation is calculated using the formula: - - Var{E} = 1 / (N - 1) * (E{X^2} - E{X}^2 / N) - stdev{E} = sqrt(Var{E}). - -.B im_avg(3) -finds the average of an image pointed by im. Takes as input any non-complex -image format and returns a double at the location pointed by out. - -.B im_deviate(3) -finds the standard deviation of an image pointed by im. Takes as -input any non-complex image format and returns -a double at the location pointed by out. - -.B im_min(3) -finds the the minimum value of the image pointed by im and returns it at the -location pointed by out. Takes as -input any image format and returns -a double at the location pointed by out. If input is complex -the min square amplitude (re*re+im*im) is returned. - -.B im_minpos(3) -finds the the minimum value of the image pointed by im and returns it at the -location pointed by out. The coordinates of the last occurrence of -min is returned at locations pointed by xpos, ypos. If input is complex -the min square amplitude (re*re+im*im) is returned. - -.B im_max(3) -finds the the maximum value of the image pointed by im and returns it at the -location pointed by out. If input is complex -the max square amplitude (re*re+im*im) is returned. - -.B im_maxpos(3) -finds the the maximum value of the image pointed by im and returns it at the -location pointed by max. The coordinates of the last occurrence of -max is returned at locations pointed by xpos, ypos. If input is complex -the max square amplitude (re*re+im*im) and its last occurrence is returned. -.SH RETURN VALUE -All functions return 0 on success and -1 on error. -.SH SEE ALSO -im_exptra(3), im_lintra(3), im_abs(3), im_stats(3). -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 24/04/1991 -.br -J. Cupitt \- 21/7/93 diff --git a/man/im_bandjoin.3 b/man/im_bandjoin.3 deleted file mode 100644 index f6d0d5d9..00000000 --- a/man/im_bandjoin.3 +++ /dev/null @@ -1,39 +0,0 @@ -.TH IM_BANDJOIN 3 "28 June 1990" -.SH NAME -im_bandjoin, im_gbandjoin \- join two or more images -.SH SYNOPSIS -.B #include - -.B int im_bandjoin(im1, im2, imout) -.br -.B IMAGE *im1, *im2, *imout; - -.B int im_gbandjoin(imarray, imout, no) -.br -.B IMAGE *imarray[], *imout; -.br -.B int no; -.SH DESCRIPTION -These function perform a band-wise join of two or more images. Input -images should be of the same type and should have the same sizes. - -.B im_bandjoin() -performs a band-wise join of two images. If the two images -have n and m bands respectively, then the output image will have n+m -bands, with the first n coming from the first image and the last m -from the second. - -.B im_gbandjoin() -performs a generalised band-wise join of no images. -Input images can have any number of bands; for instance if imarray[0] has j -bands, imarray[1] has k bands, ...., imarray[no-1] has z bands, output -has j+k+...+z bands. -.SH RETURN VALUE -The functions returns 0 on success and -1 on error. -.SH SEE\ ALSO -im_lrjoin(3), im_lrmerge(3), im_insert(3). -.SH COPYRIGHT -.br -J. Cupitt, N. Dessipris -.SH AUTHOR -J. Cupitt, N. Dessipris \- 25/04/1991 diff --git a/man/im_bandmean.3 b/man/im_bandmean.3 deleted file mode 100644 index 69f234ae..00000000 --- a/man/im_bandmean.3 +++ /dev/null @@ -1,20 +0,0 @@ -.TH IM_BANDMEAN 3 "18 July 2007" -.SH NAME -im_bandmean \- average bands in an image -.SH SYNOPSIS -#include - -int im_bandmean( in, out ) -.br -IMAGE *in, *out; -.SH DESCRIPTION -.B im_bandmean(3) -writes a one-band image where each pixel is the average of the bands for that -pixel in the input image. The output band format is the same as the input -band format. - -Any size, any number of bands, any type. -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_add(3), im_mean(3), im_recomb(3) diff --git a/man/im_benchmark.3 b/man/im_benchmark.3 deleted file mode 100644 index 34707c8e..00000000 --- a/man/im_benchmark.3 +++ /dev/null @@ -1,16 +0,0 @@ -.TH IM_BENCHMARK 3 "6 Oct 2006" -.SH NAME -im_benchmark \- do something complicated -.SH SYNOPSIS -.B #include - -int im_benchmark( IMAGE *in, IMAGE *out ) - -.SH DESCRIPTION -.B im_benchmark(3) -performs a complicated operation (based on a real example of VIPS usage) on a -LABPACK image. It is useful for benchmarking the VIPS threading system. It -should speed up (mostly) linearly with more CPUs. - -.SH RETURNED VALUES -The function returns 0 on success and -1 on error. diff --git a/man/im_binfile.3 b/man/im_binfile.3 deleted file mode 100644 index 1c7d7f93..00000000 --- a/man/im_binfile.3 +++ /dev/null @@ -1,42 +0,0 @@ -.TH IM_BINFILE 3 "11 April 1990" -.SH NAME -im_binfile, im_image \- wrap a raw binary file inside an IMAGE descriptor -.SH SYNOPSIS -.B #include - -IMAGE *im_binfile( name, xs, ys, b, off ) -.br -char *in; -.br -IMAGE *out; -.br -int xs, ys, b, off; - -IMAGE * -.br -im_image( void *buffer, int width, int height, int bands, int format ) - -.SH DESCRIPTION -.B im_binfile(3) -maps the file named, and returns an image descriptor which looks -very like the sort of thing that -.B im_mmapin(3) -returns. - -The parameters specify the image width, height, number of bands and offset -in bytes from the start of the file. - -.B im_image(3) -makes an IMAGE deriptor from an area of pixels in memory. The memory -buffer will not be freed when the IMAGE is closed, use -.B im_add_close_callback() -if you want this. - -.SH RETURN VALUE -The functions return NULL on error. -.SH SEE ALSO -im_mmapin(3), im_openout(3), im_setbuf(3). -.SH COPYRIGHT -N. Dessipris -.SH AUTHOR -N. Dessipris \- 11/04/1990 diff --git a/man/im_bits_of_fmt.3 b/man/im_bits_of_fmt.3 deleted file mode 100644 index f4ee23ed..00000000 --- a/man/im_bits_of_fmt.3 +++ /dev/null @@ -1,16 +0,0 @@ -.TH IM_BITS_OF_FMT 3 "2 June 2005" -.SH NAME -im_bits_of_fmt \- return number of bits of band format -.SH SYNOPSIS -.B #include - -.B int im_bits_of_fmt( int bandfmt ) - -.SH DESCRIPTION -.B im_bits_of_fmt(3) -calculates the number of bits of band format. - -.SH RETURN VALUE -On success this function returns the number of bits of band format and --1 is returned on error. - diff --git a/man/im_black.3 b/man/im_black.3 deleted file mode 100644 index 20a9331f..00000000 --- a/man/im_black.3 +++ /dev/null @@ -1,23 +0,0 @@ -.TH IM_BLACK 3 "11 April 1990" -.SH NAME -im_black \- make a black image -.SH SYNOPSIS -.B #include - -.B int im_black(out, x, y, bands) -.br -.B IMAGE *out; -.br -.B int x, y, bands; -.SH DESCRIPTION -im_black() -makes a black uchar image of the specified size and number of bands. -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE\ ALSO -im_openin(3), im_openout(3), im_setbuf(3). -.SH COPYRIGHT -.br -National Gallery 1990 - 1993 -.SH AUTHOR -J. Cupitt \- 11/04/1990 diff --git a/man/im_blend.3 b/man/im_blend.3 deleted file mode 100644 index fab8f2d5..00000000 --- a/man/im_blend.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_ifthenelse.3 diff --git a/man/im_buildlut.3 b/man/im_buildlut.3 deleted file mode 100644 index 3015fe19..00000000 --- a/man/im_buildlut.3 +++ /dev/null @@ -1,44 +0,0 @@ -.TH IM_BUILDLUT 3 "June 2006" -.SH NAME -im_buildlut \- build a LUT from a set of x/y points -.SH SYNOPSIS -#include - -int -.br -im_buildlut( DOUBLEMASK *input, IMAGE *output ) - -.SH DESCRIPTION -.B im_buildlut(3) -constructs a LUT, interpolating a set of x/y points. Interpolation is strictly -piecewise linear. For example, if the input is: - - 0 0 - 128 20 - 255 100 - -we generate the values: - - index value - - 0 0 - 1 0.01 - .. etc. linear interpolation - 128 20 - 129 20.5 - .. etc. linear interpolation - 255 100 - -(we don't generate the index column, that's just there to show the -position in the table) - -The x/y points don't need to be -sorted: we do that. You can have several Ys: each becomes a band in the -output LUT. X can start at any integer value, including negatives. - -.SH RETURN VALUE --1 on error, otherwise 0 -.SH SEE ALSO -im_invertlut(3), im_identity(3). -.SH COPYRIGHT -2006, Imperial College diff --git a/man/im_c2amph.3 b/man/im_c2amph.3 deleted file mode 100644 index 47bc803a..00000000 --- a/man/im_c2amph.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_clip.3 diff --git a/man/im_c2imag.3 b/man/im_c2imag.3 deleted file mode 100644 index 47bc803a..00000000 --- a/man/im_c2imag.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_clip.3 diff --git a/man/im_c2ps.3 b/man/im_c2ps.3 deleted file mode 100644 index 47bc803a..00000000 --- a/man/im_c2ps.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_clip.3 diff --git a/man/im_c2real.3 b/man/im_c2real.3 deleted file mode 100644 index 47bc803a..00000000 --- a/man/im_c2real.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_clip.3 diff --git a/man/im_c2rect.3 b/man/im_c2rect.3 deleted file mode 100644 index 47bc803a..00000000 --- a/man/im_c2rect.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_clip.3 diff --git a/man/im_cache.3 b/man/im_cache.3 deleted file mode 100644 index b7647daa..00000000 --- a/man/im_cache.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_render.3 diff --git a/man/im_ceil.3 b/man/im_ceil.3 deleted file mode 100644 index 4a52b016..00000000 --- a/man/im_ceil.3 +++ /dev/null @@ -1,17 +0,0 @@ -.TH IM_CEIL 3 "20 June 2002" -.SH NAME -im_ceil \- for each pixel, find the smallest integral value not less than -.SH SYNOPSIS -#include - -int im_ceil( in, out ) -.br -IMAGE *in, *out; -.SH DESCRIPTION -.B im_ceil(3) -finds the smallest integral value not less than. Copy for integer types, -call ceil(3) for float and complex types. Output type == input type. -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_abs(3), im_clip2fmt(3), im_floor(3) diff --git a/man/im_char2BandFmt.3 b/man/im_char2BandFmt.3 deleted file mode 100644 index 72471e9c..00000000 --- a/man/im_char2BandFmt.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_printdesc.3 diff --git a/man/im_char2Coding.3 b/man/im_char2Coding.3 deleted file mode 100644 index 72471e9c..00000000 --- a/man/im_char2Coding.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_printdesc.3 diff --git a/man/im_char2Compression.3 b/man/im_char2Compression.3 deleted file mode 100644 index 72471e9c..00000000 --- a/man/im_char2Compression.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_printdesc.3 diff --git a/man/im_char2Type.3 b/man/im_char2Type.3 deleted file mode 100644 index 72471e9c..00000000 --- a/man/im_char2Type.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_printdesc.3 diff --git a/man/im_circle.3 b/man/im_circle.3 deleted file mode 100644 index 0306aad5..00000000 --- a/man/im_circle.3 +++ /dev/null @@ -1,33 +0,0 @@ -.TH IM_CIRCLE 3 "10 May 1991" -.SH NAME -im_circle \- draws a circle within an image file -.SH SYNOPSIS -.B #include - -.B int im_circle(im, cx, cy, radius, intensity) -.br -.B IMAGE *im; -.br -.B int cx, cy; -.br -.B int radius, intensity; -.SH DESCRIPTION -.B im_circle() -draws a circle on top of an image pointed by the image descriptor im. -Input im should be one band unsigned char image. - -It must be stressed that a call to this function overwrites the content -of the original image at the points corresponding to the drawn circle. -The centre of the circle is at point (cx, cy) and has radius radius and -the intensity of the produced circle is given by the int intensity (between -0 and 255). If the circle does not fit in the original image, an error code -is returned. -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_line(3). -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 10/05/1991 diff --git a/man/im_clip.3 b/man/im_clip.3 deleted file mode 100644 index 6096b537..00000000 --- a/man/im_clip.3 +++ /dev/null @@ -1,90 +0,0 @@ -.TH CONVERSIONS 3 "15 April 1991" -.SH NAME -im_c2amph, im_c2imag, im_c2ps, im_c2real, im_clip2fmt, -im_ri2c \- conversion between image types -.SH SYNOPSIS -#include - -int im_c2amph(in, out) -.br -IMAGE *in, *out; - -int im_c2rect(in, out) -.br -IMAGE *in, *out; - -int im_c2imag(in, out) -.br -IMAGE *in, *out; - -int im_c2ps(in, out) -.br -IMAGE *in, *out; - -int im_c2real(in, out) -.br -IMAGE *in, *out; - -int im_clip2fmt(in, out, ofmt) -.br -IMAGE *in, *out; -.br -int ofmt; - -int im_ri2c(in1, in2, out) -.br -IMAGE *in1, *in2, *out; -.SH DESCRIPTION -Each of the above functions converts the image held by the image descriptor in -to another type image and writes the result on the image descriptor out. -Sizes and the number of channels are identical to those of input. Whenever -required by the conversion, the element values are rounded by calling floor(). - -.B im_c2amph() -converts a complex (float or double) input to (amplitude, phase), with phase -in degrees. Output has the same format as input. - -.B im_c2rect() -converts a complex (float or double) input in (amplitude, phase) form back to -rectangular coordinates. Again, phase should be expressed in degrees. - -.B im_c2ps() -convert a (float or double) complex image to amplitude (float or -double) image. Complex input (a,b) is mapped to sqrt( a*a+b*b ). - -.B im_clip2fmt() -converts the input image to 'ofmt', where ofmt is the new value for -BandFmt. For example, im_clip2fmt(in, out, FMTUSHORT) converts any image to -unsigned short. - -The number of -clipped values (if any), are printed in the standard error output. Before -clipping rounding is carried out if necessary. When converting between real -and complex types with these functions, the imaginary part of the output is -set to zero. When converting from complex to real types, the imaginary part is -ignored. Use im_c2ps(), im_c2real() etc. to get other behaviour. - -Legacy functions are available, called im_clip(), im_clip2c(), im_clip2d(), -im_clip2f(), im_clip2i(), im_clip2s(), im_clip2ui(), im_clip2us(), -im_clip2cm() and im_clip2dcm() which convert the input image to unsigned char, -signed char, double, float, int, short, unsigned int, unsigned short, -complex and double complex respectively. - -.B im_ri2c() -takes as inputs two non-complex images of equal sizes and number of -channels. The output is a complex image with the real part coming from in1 -and the imaginary part coming from in2. Output is float complex (FMTCOMPLEX) -only if none of the inputs is double. If one or both inputs are double the -result is double complex (FMTDPCOMPLEX). - -.B im_c2real() -and -.B im_c2imag() -extract the real or the imaginary part of a -complex image respectively. If input is be float complex or double complex, -then output is float or double respectively. - -.SH RETURN VALUE -The functions returns 0 on success and -1 on error. -.SH SEE ALSO -im_scale(3). diff --git a/man/im_clip2c.3 b/man/im_clip2c.3 deleted file mode 100644 index 47bc803a..00000000 --- a/man/im_clip2c.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_clip.3 diff --git a/man/im_clip2cm.3 b/man/im_clip2cm.3 deleted file mode 100644 index 47bc803a..00000000 --- a/man/im_clip2cm.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_clip.3 diff --git a/man/im_clip2d.3 b/man/im_clip2d.3 deleted file mode 100644 index 47bc803a..00000000 --- a/man/im_clip2d.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_clip.3 diff --git a/man/im_clip2dcm.3 b/man/im_clip2dcm.3 deleted file mode 100644 index 47bc803a..00000000 --- a/man/im_clip2dcm.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_clip.3 diff --git a/man/im_clip2f.3 b/man/im_clip2f.3 deleted file mode 100644 index 47bc803a..00000000 --- a/man/im_clip2f.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_clip.3 diff --git a/man/im_clip2fmt.3 b/man/im_clip2fmt.3 deleted file mode 100644 index 47bc803a..00000000 --- a/man/im_clip2fmt.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_clip.3 diff --git a/man/im_clip2i.3 b/man/im_clip2i.3 deleted file mode 100644 index 47bc803a..00000000 --- a/man/im_clip2i.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_clip.3 diff --git a/man/im_clip2s.3 b/man/im_clip2s.3 deleted file mode 100644 index 47bc803a..00000000 --- a/man/im_clip2s.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_clip.3 diff --git a/man/im_clip2ui.3 b/man/im_clip2ui.3 deleted file mode 100644 index 47bc803a..00000000 --- a/man/im_clip2ui.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_clip.3 diff --git a/man/im_clip2us.3 b/man/im_clip2us.3 deleted file mode 100644 index 47bc803a..00000000 --- a/man/im_clip2us.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_clip.3 diff --git a/man/im_close.3 b/man/im_close.3 deleted file mode 100644 index d7e21787..00000000 --- a/man/im_close.3 +++ /dev/null @@ -1,35 +0,0 @@ -.TH IM_CLOSE 3 "11 April 1990" -.SH NAME -im_close \- close an image descriptor -.SH SYNOPSIS -#include - -int im_close(image) -.br -IMAGE *image; -.SH DESCRIPTION -im_close(3) frees all the resources attached to the image descriptor. This may -involve closing files, freeing memory buffers, triggering close callback -lists, unmapping files, freeing regions, and so on. If all this succeeds, then -the function returns zero. If something goes wrong, the function returns -non-zero and sets im_errormsg(3). If im_close(3) fails, the image descriptor is -left in an undefined state. - -In the case that the image descriptor corresponds to a file opened by -im_openout(3) that has been written to, the function sets an output -description file as follows: If the output image filename is terminated with -".v", the string held by the Hist member of the image descriptor is copied to -a corresponding file ending with ".desc" in the same directory. In all other -cases, an output .desc file is not created. - -If a NULL pointer is passed to im_close(3), it returns successfully -immediately. -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH COPYRIGHT -N. Dessipris, K. Martinez, J. Cupitt -.SH SEE ALSO -im_mmapin(3), im_openin(3), im_openout(3), im_setbuf(3), im_open(3), -im_incheck(3), im_pincheck(3). -.SH AUTHOR -N. Dessipris \- 11/04/1990 diff --git a/man/im_cmulnorm.3 b/man/im_cmulnorm.3 deleted file mode 100644 index 2962752e..00000000 --- a/man/im_cmulnorm.3 +++ /dev/null @@ -1,67 +0,0 @@ -.TH IM_MULTIPLY 3 "24 April 1991" -.SH NAME -im_cmulnorm, im_multiply \- multiply two images -.SH SYNOPSIS -.B #include - -.B int im_cmulnorm(in1, in2, out) -.br -.B IMAGE *in1, *in2, *out; - -.B int im_multiply(in1, in2, out) -.br -.B IMAGE *in1, *in2, *out; - -.SH DESCRIPTION -These functions operate on two images held by image descriptors in1 and in2 -and write the result to the image descriptor out. Input images in1 and in2 -should have the same channels and the same sizes; however they can be of -different types. Only the history of the image descriptor pointed by in1 is -copied to out. - -.B im_multiply(3) -applied to two integer images multiplies the two images and writes the output -as: - - in1 | uchar char ushort short uint int - -------+----------------------------------------- - in2 | - uchar | ushort short ushort short uint int - char | short short short short int int - ushort | ushort short ushort short uint int - short | short short short short int int - uint | uint int uint int uint int - int | int int int int int int - -If one or more of the images is a floating point type, the output is FMTFLOAT, -unless one or more of the inputs is FMTDOUBLE, in which case the output is -also FMTDOUBLE. - -If one or more of the images is a complex type, the output is FMTCOMPLEX, -unless one or more of the inputs is FMTDPCOMPLEX, in which case the output is -also FMTDPCOMPLEX. - -For complex input pels (x1,y1) and (x2,y2), im_multiply() writes -(x1*x2 - y1*y2, x1*y2 + x2*y1). - -.B im_cmulnorm(3) -multiplies two complex images. The complex output is normalised to 1 by -dividing both the real and the imaginary part of each pel with the norm; for -instance if the complex multiplication produces (a,b) then the output written -by this function is (a/norm, b/norm), where norm=a*a+b*b. Result is checked -for norm=0. The function is useful for phase correlation. Both inputs should -be complex. - -Result is float complex if both inputs are float complex. In any other case -the result is double complex. - -.SH BUGS -None of the functions checks the result for over/underflow. -.SH RETURN VALUE -All functions return 0 on success and -1 on error. -.SH SEE ALSO -im_subtract(3), im_lintra(3), im_add(3). -.SH AUTHOR -N. Dessipris \- 22/04/1991 -.br -J. Cupitt (im_multiply) \- 22/04/1991 diff --git a/man/im_cntlines.3 b/man/im_cntlines.3 deleted file mode 100644 index 6fe446b7..00000000 --- a/man/im_cntlines.3 +++ /dev/null @@ -1,57 +0,0 @@ -.TH LINES 3 "14 May 1991" -.SH NAME -im_cntlines, im_profile \- calculate transitions between black and white pels horizontally or vertically -.SH SYNOPSIS -.B #include - -.B int im_profile(in, out, dir) -.br -.B IMAGE *in, *out; -.br -.B int dir; - -.B int im_cntlines(in, nolines, dir) -.br -.B IMAGE *in; -.br -.B double *nolines; -.br -.B int dir; - -.SH DESCRIPTION - -.B im_profile(3) -searches inward from the edge of the image and finds the first non-zero pixel. -It outputs an image containing a list of the offsets for each row or column. - -If -.B dir -==0, then -.B im_profile(3) -searches down from the top edge, writing an image as wide as the input -image, but only 1 pixel high, containing the number of pixels down to the -first non-zero pixel for each column of input pixels. - -If -.B dir -==1, then -.B im_profile(3) -searches across from the left edge, writing an image as high as the input -image, but only 1 pixel wide, containing the number of pixels across to the -first non-zero pixel for each row of input pixels. - -.B im_cntlines(3) -calculates the number of transitions between black and white pixels of -an image. If dir is 1 then all transitions across the -vertical direction are calculated for all Xsize lines of the image. If dir -is 0 then all transitions along the horizontal direction for all Ysize -lines are calculated. The function returns the number of transitions -divided by twice the number of the corresponding Xsize of Ysize lines. -The program is primarily used to calculate the number of unbroken horizontal -(dir=0) or vertical lines (dir=1) that exist within an image. -Input image in can have only one channel. - -.SH RETURN VALUE -All functions returns 0 on success and -1 on error. -.SH SEE ALSO -im_erode(3), im_dilate(3). diff --git a/man/im_col_C2Cucs.3 b/man/im_col_C2Cucs.3 deleted file mode 100644 index 3426e329..00000000 --- a/man/im_col_C2Cucs.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_col_XYZ2rgb.3 diff --git a/man/im_col_Ch2ab.3 b/man/im_col_Ch2ab.3 deleted file mode 100644 index 3426e329..00000000 --- a/man/im_col_Ch2ab.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_col_XYZ2rgb.3 diff --git a/man/im_col_Ch2hucs.3 b/man/im_col_Ch2hucs.3 deleted file mode 100644 index 3426e329..00000000 --- a/man/im_col_Ch2hucs.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_col_XYZ2rgb.3 diff --git a/man/im_col_Chucs2h.3 b/man/im_col_Chucs2h.3 deleted file mode 100644 index 3426e329..00000000 --- a/man/im_col_Chucs2h.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_col_XYZ2rgb.3 diff --git a/man/im_col_Cucs2C.3 b/man/im_col_Cucs2C.3 deleted file mode 100644 index 3426e329..00000000 --- a/man/im_col_Cucs2C.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_col_XYZ2rgb.3 diff --git a/man/im_col_L2Lucs.3 b/man/im_col_L2Lucs.3 deleted file mode 100644 index 3426e329..00000000 --- a/man/im_col_L2Lucs.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_col_XYZ2rgb.3 diff --git a/man/im_col_Lab2XYZ.3 b/man/im_col_Lab2XYZ.3 deleted file mode 100644 index 3426e329..00000000 --- a/man/im_col_Lab2XYZ.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_col_XYZ2rgb.3 diff --git a/man/im_col_Lucs2L.3 b/man/im_col_Lucs2L.3 deleted file mode 100644 index 3426e329..00000000 --- a/man/im_col_Lucs2L.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_col_XYZ2rgb.3 diff --git a/man/im_col_XYZ2Lab.3 b/man/im_col_XYZ2Lab.3 deleted file mode 100644 index 3426e329..00000000 --- a/man/im_col_XYZ2Lab.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_col_XYZ2rgb.3 diff --git a/man/im_col_XYZ2rgb.3 b/man/im_col_XYZ2rgb.3 deleted file mode 100644 index 475c312b..00000000 --- a/man/im_col_XYZ2rgb.3 +++ /dev/null @@ -1,143 +0,0 @@ -.TH IM_COL_XYZ2RGB 3 "2 December 1992" -.SH NAME -im_col_Lab2LCh, im_col_LCh2ab, im_col_Lab2XYZ, im_col_XYZ2Lab, -im_col_pythagoras, im_col_display, im_col_XYZ2rgb, im_col_rgb2XYZ, -im_col_L2Lucs, im_col_Lucs2L, im_col_C2Cucs, im_col_Cucs2C, im_col_Ch2hucs, -im_col_Chucs2h, im_col_make_tables_UCS, im_col_dECMC -\- colour space conversion -.SH SYNOPSIS -#include - - -int im_col_ab2Ch( a, b, C, h ) -.br -float a, b, *C, *h; - - -int im_col_Ch2ab( C, h, a, b ) -.br -float C, h, *a, *b; - -int im_col_Lab2XYZ( L, a, b, X, Y, Z ) -.br -float L, a, b, *X, *Y, *Z; - -int im_col_XYZ2Lab( X, Y, Z, L, a, b ) -.br -float X, Y, Z, *L, *a, *b; - -float im_col_pythagoras( L1, a1, b1, L2, a2, b2 ) -.br -float L1, a1, b1, L2, a2, b2; - -extern struct im_col_display *im_col_displays[]; - -struct im_col_tab_disp *im_col_make_tables_RGB( im, display ) -.br -IMAGE *im; -.br -struct im_col_display *display; - -int im_col_XYZ2rgb( display, table, X, Y, Z, r, g, b, oflow ) -.br -struct im_col_display *display; -.br -struct im_col_tab_disp *table; -.br -float X, Y, Z; -.br -int *r, *g, *b; -.br -int *oflow; - - -int im_col_rgb2XYZ( display, table, r, g, b, X, Y, Z ) -.br -struct im_col_display *display; -.br -struct im_col_tab_disp *table; -.br -int r, g, b; -.br -float *X, *Y, *Z; - -float im_col_L2Lucs( L ) -.br -float L; - -float im_col_Lucs2L( Lucs ) -.br -float Lucs; - -float im_col_C2Cucs( C ) -.br -float C; - -float im_col_Cucs2C( Cucs ) -.br -float Cucs; - -float im_col_Ch2hucs( C, h ) -.br -float h, C; - -float im_col_Chucs2h( C, hucs ) -.br -float hucs, C; - -void im_col_make_tables_UCS( void ) - -float im_col_dECMC( L1, a1, b1, L2, a2, b2 ) -.br -float L1, a1, b1, L2, a2, b2; - -.SH DESCRIPTION -Colour space conversion. -These functions convert colour values between four different formats: XYZ -(float), Lab (float), UCS (float), and RGB (unsigned char) -displayable. Additionally, functions are provided to move from (a,b)-style -rectangular colour coordinates to (C,h)-style coordinates. h is always -in degrees. - -UCS is a colour space derived from the CMC(1:1) equations. There is no easy -analytical conversion from UCS to Lab, so look-up tables are used. These have -to be built with a call to im_col_make_tables_UCS(). Once built, these -tables are shared by all UCS functions. You may call im_col_make_tables_UCS() -many times - tables are only built on the first call. - -im_col_pythagoras() returns the pythagoran distance between two points in a -colour space. It can be used for finding CIELAB delta E's. im_col_dECMC() -returns the colour difference between two LAB points in CMC(1:1). - -An im_col_display structure characterises a CRT screen (see ). -You can make up your own (if you can find a TV analyser), or use one of the -structures provied by VIPS in the NULL-terminated array im_col_displays[]. See -the source for disp2XYZ(1) for ideas on extracting a display struct from this -list. - -im_make_tables_RGB(3) has a display type as argument, and returns a pointer -to the structure im_col_tab_RGB. This latter contains the matrices to go from -XYZ to luminances (and back), and the tables to go from the luminances (in r, -g, b) to the effective signal values to be applied to the monitor input (and -back). The function returns NULL on error. The IMAGE argument is passed on to -im_malloc() to make the space required for the tables. Pass either NULL (if -you need to free the memory yourself) or an IMAGE descriptor (if you want the -memory to be freed automatically when that descriptor is closed). - -im_col_XYZ2rgb() takes a display, a look-up table and an XYZ coordinate are -returns three values in the range 0-255. The extra value oflow is set to 0 if -the specified XYZ position aflls within the display gamut, and to 1 if the -point lies outside the gamut. im_col_rgb2XYZ() is the reverse transformation. -.SH RETURN VALUE -The functions (usually) return 0 on success and -1 on error. -.SH SEE\ ALSO -.nf -im_XYZ2disp(3), im_dE_fromdisp(3). -.SH COPYRIGHT -National Gallery, 1990-1993. -.SH AUTHOR -D. Saunders \- 1988 -.br -J.Ph. Laurent \- 2/12/1992 -.br -J.Cupitt \- 21/7/93 diff --git a/man/im_col_ab2Ch.3 b/man/im_col_ab2Ch.3 deleted file mode 100644 index 3426e329..00000000 --- a/man/im_col_ab2Ch.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_col_XYZ2rgb.3 diff --git a/man/im_col_dECMC.3 b/man/im_col_dECMC.3 deleted file mode 100644 index 3426e329..00000000 --- a/man/im_col_dECMC.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_col_XYZ2rgb.3 diff --git a/man/im_col_display.3 b/man/im_col_display.3 deleted file mode 100644 index 3426e329..00000000 --- a/man/im_col_display.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_col_XYZ2rgb.3 diff --git a/man/im_col_make_tables_RGB.3 b/man/im_col_make_tables_RGB.3 deleted file mode 100644 index 3426e329..00000000 --- a/man/im_col_make_tables_RGB.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_col_XYZ2rgb.3 diff --git a/man/im_col_make_tables_UCS.3 b/man/im_col_make_tables_UCS.3 deleted file mode 100644 index 3426e329..00000000 --- a/man/im_col_make_tables_UCS.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_col_XYZ2rgb.3 diff --git a/man/im_col_pythagoras.3 b/man/im_col_pythagoras.3 deleted file mode 100644 index 3426e329..00000000 --- a/man/im_col_pythagoras.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_col_XYZ2rgb.3 diff --git a/man/im_col_rgb2XYZ.3 b/man/im_col_rgb2XYZ.3 deleted file mode 100644 index 3426e329..00000000 --- a/man/im_col_rgb2XYZ.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_col_XYZ2rgb.3 diff --git a/man/im_compass.3 b/man/im_compass.3 deleted file mode 100644 index 39f44a7d..00000000 --- a/man/im_compass.3 +++ /dev/null @@ -1,106 +0,0 @@ -.TH IM_COMPASS 3 "2 May 1991" -.SH NAME -im_compass, im_rank_image, im_maxvalue, im_lindetect, im_gradient \- extract features from an image with -a rotating input mask -.SH SYNOPSIS -#include - -int im_rank_image(in, out, n, index) -.br -IMAGE **in; -.br -IMAGE *out; -.br -int n; -.br -int index; - -int im_maxvalue(in, out, n) -.br -IMAGE **in; -.br -IMAGE *out; -.br -int n; - -int im_compass(in, out, mask) -.br -IMAGE *in, *out; -.br -INTMASK *mask; - -int im_lindetect(in, out, mask) -.br -IMAGE *in, *out; -.br -INTMASK *mask; - -int im_gradient(in, out, mask) -.br -IMAGE *in, *out; -.br -INTMASK *mask; -.SH DESCRIPTION -.B im_rank_image() -sorts the input images pixel-wise, then outputs an image in which each pixel -is selected from the sorted list by the -.B index -parameter. For example, if -.B index -is zero, then each output pixel will be the minimum of all the corresponding -input pixels. -It works for any uncoded, non-complex -image type. All input images must match in size, format, and number of bands. - -These functions convolve the image pointed by the image descriptor in with the -mask pointed by mask and put the result in the image pointed by out. - -The mask structure INTMASK is returned by the function im_read_imask(3), for -integer mask only. Input should be unsigned char; processing is carried out -using look-up tables. The output is integer. coefficients. The size of the -output image and the number of channels are the same as the corresponding of -the input. - -The output image is the same size as the input. The edge pixels are calculated -by expanding the input image using -.B im_embed(3) -in mode 1 (replicating edge pixels) just enough so that the output can match -the input. - -The output at each point is divided by scale and then the offset is added. -Both offset and scale are held in mask. - -.B im_maxvalue() -is a convenience function: it is simply: - - im_rank_image( in, out, n, n - 1 ) - -.B im_compass() -convolves each point of the input byte image pointed by in with 8 masks. -The first mask is the entered mask and the seven remaining masks are produced -by successive rotations of the entered mask by 45 degrees. The maximum output -of all masks at each point is written to the output integer IMAGE descriptor. -The function expects as input a square mask of odd size. - -.B im_lindetect() -convolves each point of the input byte image pointed by in with 4 masks. -The first mask is the entered mask and the three remaining masks are produced -by successive rotations of the entered mask by 45 degrees. The maximum output -of all masks at each point is written to the output integer IMAGE descriptor. -The function expects as input a square mask of odd size. - -.B im_gradient() -convolves each point of the input byte image pointed by in with 2 masks; -the entered mask and with a 90 degrees rotation of the -entered mask. If g1, g2 are the result of each convolution then for each point -abs(g1) + abs(g2) is written to the output integer IMAGE descriptor. -The function expects as input a square mask of any size. -.SH RETURN VALUE -All functions returns 0 on success and -1 on error. -.SH SEE\ ALSO -im_readmask(3), im_conv(3). -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 02/05/1991 diff --git a/man/im_concurrency_get.3 b/man/im_concurrency_get.3 deleted file mode 100644 index 9c8864dd..00000000 --- a/man/im_concurrency_get.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_concurrency_set.3 diff --git a/man/im_concurrency_set.3 b/man/im_concurrency_set.3 deleted file mode 100644 index 5b9938f6..00000000 --- a/man/im_concurrency_set.3 +++ /dev/null @@ -1,32 +0,0 @@ -.TH IM_CONCURRENCY 3 "8 January 2007" -.SH NAME -im_concurrency_set, im_concurrency_get \- set and get the number of threads to -use for evaluation -.SH SYNOPSIS -.B #include - -void im_concurrency_set( int concurrency ) -.br -int im_concurrency_get( void ) - -.SH DESCRIPTION - -.B im_concurrency_set(3) -and -.B im_concurrency_get(3) -set and get the number of parallel threads VIPS should use to calculate -pixels. - -A value of zero (the default) means to get the number of threads -from the environment variable IM_CONCURRENCY. If that is not set, the number -of threads defaults to one. - -Setting the number of threads only affects image evaluations which start after -that point, it will not change the behaviour of existing evaluations. - -Most command-line vips programs support the --vips-concurrency flag, which can -also be used to set the concurrency. - -.SH SEE ALSO -im_get_option_group(3), -`VIPS manual,' in accompanying documentation. diff --git a/man/im_contrast_surface.3 b/man/im_contrast_surface.3 deleted file mode 100644 index 20d8fe8b..00000000 --- a/man/im_contrast_surface.3 +++ /dev/null @@ -1,40 +0,0 @@ -.TH IM_CONTRAST_SURFACE 3 "01 May 2006" -.SH NAME - im_contrast_surface, im_contrast_surface_raw \- Generate contrast surface -.SH SYNOPSIS -.nf -.B #include -.sp -.BI "int im_contrast_surface( IMAGE " "*in" ", IMAGE " "*out" ", int " "half_win_size" ", int " "spacing" " ); -.br - -.BI "int im_contrast_surface_raw( IMAGE " "*in" ", IMAGE " "*out" ", int " "half_win_size" ", int " "spacing" " ); -.fi -.SH DESCRIPTION -These functions generate an image where the value of each pixel represents the -contrast within a square window of size 2 * half_win_size + 1 centred on the -corresponsing point in the input image. -.PP -The output is sub-sampled by a factor of spacing. -.PP -Input must be single-band uncoded uchar, WIO or PIO. -.PP -Output is single-band uncoded uint, WIO or PIO. -.PP -In -.BR im_contrast_surface(3) , -pixels beyond the edges of the input image are considered to be have the value -of the nearest pixel which is in the image. -.PP -Alternatively, in -.BR im_contrast_surface_raw(3) , -pixels within half_win_size of the edge are not calculated, and output is -smaller accordingly. -.SH RETURN VALUE -The functions returns 0 on success and -1 on error. -.SH COPYRIGHT -.br -Copyright 2006, The Nottingham Trent University. -.SH AUTHOR -Tom Vajzovic - diff --git a/man/im_contrast_surface_raw.3 b/man/im_contrast_surface_raw.3 deleted file mode 100644 index bf67695a..00000000 --- a/man/im_contrast_surface_raw.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_contrast_surface.3 diff --git a/man/im_conv.3 b/man/im_conv.3 deleted file mode 100644 index 71d9f3aa..00000000 --- a/man/im_conv.3 +++ /dev/null @@ -1,143 +0,0 @@ -.TH CONVOLUTION 3 "2 May 1991" -.SH NAME -im_conv, im_conv_raw, im_convf, im_convf_raw, -im_convsep, im_convsep_raw, im_convsepf, im_convsepf_raw, -im_convsub \- convolves an image with a generalised mask -.SH SYNOPSIS -#include - -int im_conv(in, out, mask) -.br -IMAGE *in, *out; -.br -INTMASK *mask; - -int im_conv_raw(in, out, mask) -.br -IMAGE *in, *out; -.br -INTMASK *mask; - -int im_convf(in, out, mask) -.br -IMAGE *in, *out; -.br -DOUBLEMASK *mask; - -int im_convf_raw(in, out, mask) -.br -IMAGE *in, *out; -.br -DOUBLEMASK *mask; - -int im_convsep(in, out, mask) -.br -IMAGE *in, *out; -.br -INTMASK *mask; - -int im_convsep_raw(in, out, mask) -.br -IMAGE *in, *out; -.br -INTMASK *mask; - -int im_convsepf(in, out, mask) -.br -IMAGE *in, *out; -.br -DOUBLEMASK *mask; - -int im_convsepf_raw(in, out, mask) -.br -IMAGE *in, *out; -.br -DOUBLEMASK *mask; - -int im_convsub(in, out, mask, xskip, yskip) -.br -IMAGE *in, *out; -.br -INTMASK *mask; -.br -int xskip, yskip; - -int im_shrink(in, out, xfactor, yfactor) -.br -IMAGE *in, *out; -.br -double xfactor, yfactor; - -.SH DESCRIPTION -These functions -convolve the image -.B in -with the matrix -.B mask -and put the result in the image -.B out. - -Input should be non-complex. The size and type of the output image are -the same as the size of the input. To output a larger type (for example, -to output an int image from convolution of a byte image, avoiding clipping), -cast the input image up with -.B im_clip2fmt(3). - -The output image is the same size as the input. The edge pixels are calculated -by expanding the input image using -.B im_embed(3) -in mode 1 (replicating edge pixels) just enough so that the output can match -the input. - -The output at each point is divided by scale and then the offset is added. -Both offset and scale are held in mask. - -The -.B im_conv*(3) -functions have 'raw' versions which do not add the border: instead the -output image is smaller than the input. - -.B im_conv(3) -and -.B im_conv_raw(3) -convolve any non-complex input image to make an output image of the same -type. Rounding is appropriate to the image type. - -.B im_convf(3) -and -.B im_convf_raw(3) -convolves to float (double if the input is double). -The function expects a double mask. - -.B im_convsep(3) -and -.B im_convsep_raw(3) -carry out convolution using an 1xN or Nx1 separable mask. - -The function scales the output result by dividing it with scale*scale. The -scale factor should therefore be the sqrt of the scale of the square NxN mask. - -Rounding is appropriate to the image type. It works on any non-complex image, -and writes the output in the same format as the input. -The function expects integer mask. - -.B im_convsepf(3) -and -.B im_convsepf_raw(3) -convolves to float (double if the input is double). -The function expects a double mask. - -.B im_convsub(3) -convolves the byte image pointed by in and writes the result as a byte output. -Using this function the input image is subsampled on -both directions by an integer factor of xskip horizontally and -an integer factor of yskip vertically. -During the covolution, values are rounded before division. -Both input and output are bytes. Output is clipped between 0 and 255. -The function expects an integer mask. - -.SH RETURN VALUE -The functions returns 0 on success and -1 on error. -.SH SEE ALSO -im_read_imask(3), im_compass(3), im_fastcor(3), im_log_dmask(3), -im_clip2fmt(3) diff --git a/man/im_conv_raw.3 b/man/im_conv_raw.3 deleted file mode 100644 index 1a31740e..00000000 --- a/man/im_conv_raw.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_conv.3 diff --git a/man/im_convf.3 b/man/im_convf.3 deleted file mode 100644 index 1a31740e..00000000 --- a/man/im_convf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_conv.3 diff --git a/man/im_convf_raw.3 b/man/im_convf_raw.3 deleted file mode 100644 index 1a31740e..00000000 --- a/man/im_convf_raw.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_conv.3 diff --git a/man/im_convsep.3 b/man/im_convsep.3 deleted file mode 100644 index 1a31740e..00000000 --- a/man/im_convsep.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_conv.3 diff --git a/man/im_convsep_raw.3 b/man/im_convsep_raw.3 deleted file mode 100644 index 1a31740e..00000000 --- a/man/im_convsep_raw.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_conv.3 diff --git a/man/im_convsepf.3 b/man/im_convsepf.3 deleted file mode 100644 index 1a31740e..00000000 --- a/man/im_convsepf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_conv.3 diff --git a/man/im_convsepf_raw.3 b/man/im_convsepf_raw.3 deleted file mode 100644 index 1a31740e..00000000 --- a/man/im_convsepf_raw.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_conv.3 diff --git a/man/im_convsub.3 b/man/im_convsub.3 deleted file mode 100644 index 1a31740e..00000000 --- a/man/im_convsub.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_conv.3 diff --git a/man/im_cooc_asm.3 b/man/im_cooc_asm.3 deleted file mode 100644 index 536836b7..00000000 --- a/man/im_cooc_asm.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_cooc_matrix.3 diff --git a/man/im_cooc_contrast.3 b/man/im_cooc_contrast.3 deleted file mode 100644 index 536836b7..00000000 --- a/man/im_cooc_contrast.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_cooc_matrix.3 diff --git a/man/im_cooc_correlation.3 b/man/im_cooc_correlation.3 deleted file mode 100644 index 536836b7..00000000 --- a/man/im_cooc_correlation.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_cooc_matrix.3 diff --git a/man/im_cooc_entropy.3 b/man/im_cooc_entropy.3 deleted file mode 100644 index 536836b7..00000000 --- a/man/im_cooc_entropy.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_cooc_matrix.3 diff --git a/man/im_cooc_matrix.3 b/man/im_cooc_matrix.3 deleted file mode 100644 index 12f70df6..00000000 --- a/man/im_cooc_matrix.3 +++ /dev/null @@ -1,88 +0,0 @@ -.TH IM_COOC_MATRIX 3 "2 Dec 1991" -.SH NAME -im_cooc_matrix, im_cooc_asm, im_cooc_contrast, im_cooc_correlation, -im_cooc_entropy \- calculate the co-occurrence matrix and features on it -.SH SYNOPSIS -.B #include - -int im_cooc_matrix(im, m, xp, yp, xs, ys, dx, dy, sym) -.br -.B IMAGE *im, *m; -.br -.B int xp, yp, xs, ys; -.br -.B int dx, dy; -.br -.B int sym; - -.br -.B int im_cooc_asm(m, asmoment) -.br -.B IMAGE *m; -.br -.B double *asmoment; - -.br -.B int im_cooc_contrast(m, contrast) -.br -.B IMAGE *m; -.br -.B double *contrast; - -.br -.B int im_cooc_correlation(m, correlation) -.br -.B IMAGE *m; -.br -.B double *correlation; - -.br -.B int im_cooc_entropy(m, entropy) -.br -.B IMAGE *m; -.br -.B double *entropy; - -.SH DESCRIPTION -.B im_cooc_matrix() -creates a 256 by 256 one channel co-occurrence matrix of the box determined by -the parameters (xp, yp; xs, ys) within the image pointed by the IMAGE -descriptor im. The matrix is written onto the IMAGE descriptor m. The -displacement vector is determined by (dx, dy). The user must ensure that -there is enough border pixels around the box within im dictated by the -displacement vector (dx,dy) or else the program fails. All entries of the -co-occurrence matrix are double normalised to the number of pairs involved. -This function is a direct implementation of the paper: Haralick R. M., -Shanmugan K. and Dinstein I., 'Textural features for image classification', -IEEE Transactions on Systems, Man, and Cybernetics, Vol. SMC-3, No 6, Nov. -1973, pp 610-621. Input im should be one band unsigned char image. - -If flag sym is 1, the created co-occurrence matrix is symmetric that is -dispacement vectors (dx, dy), (-dx, -dy) create exactly the same matrix. If -sym is 0, the created co-occurrence matrix is not symmetric that is -dispacement vectors (dx, dy), (-dx, -dy) create different matrices. - -.B im_cooc_asm() -calculates the angular second moment of the co-occurrence matrix held by m. -The result is returned into the location pointed by asmoment. - -.B im_cooc_contrast() -calculates the contrast of the co-occurrence matrix held by m. -The result is returned into the location pointed by contrast. - -.B im_cooc_correlation() -calculates the correlation of the co-occurrence matrix held by m. -The result is returned into the location pointed by correlation. - -.B im_cooc_entropy() -calculates the entropy of the co-occurrence matrix held by m. -The result is returned into the location pointed by entropy. -.SH RETURNED VALUES -All functions returns 0 on success and -1 on error. -.SH SEE\ ALSO -im_glds_matrix(3) -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 2/12/1991 diff --git a/man/im_copy.3 b/man/im_copy.3 deleted file mode 100644 index 4e33f68d..00000000 --- a/man/im_copy.3 +++ /dev/null @@ -1,79 +0,0 @@ -.TH IM_COPY 3 "11 April 1990" -.SH NAME -im_copy, im_copy_set, im_copy_swap, im_copy_morph \- copy an image -.SH SYNOPSIS -.B #include - -int im_copy(in, out) -.br -IMAGE *in, *out; - -int im_copy_set( in, out, type, xres, yres ) -.br -IMAGE *in, *out; -.br -int type; -.br -float xres, yres; - -int im_copy_swap( in, out ) -.br -IMAGE *in, *out; - -int im_copy_morph( in, out, Bands, BandFmt, Coding ) -.br -IMAGE *in, *out; -.br -int Bands, BandFmt, Coding; - -typedef enum { -.br - IM_ARCH_NATIVE, -.br - IM_ARCH_BYTE_SWAPPED, -.br - IM_ARCH_LSB_FIRST, -.br - IM_ARCH_MSB_FIRST -.br -} im_arch_type; - -int im_copy_from( in, out, architecture ) -.br -IMAGE *in, *out; -.br -im_arch_type architecture; - -.SH DESCRIPTION -.B im_copy(3) -copies the image held by the image descriptor in -and writes the result to the image descriptor out. The input can be of any -size and have any type. Does LABPACK coded images too! - -.B im_copy_set(3) -behaves exactly as -.B im_copy(3), -but lets you set informational fields in the -header on the way through. - -.B im_copy_swap(3) -copies an uncoded image, swapping between SPARC and Intel byte order on the -way. - -.B im_copy_morph(3) -behaves exactly as -.B im_copy(3), -but lets you set fields which affect pixel format -on the way through. - -.B im_copy_from(3) -calls either -.B im_copy(3) -or -.B im_copy_swap(3) -as necessary to copy from the specified architecture. - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_extract(3), im_open(3) diff --git a/man/im_copy_from.3 b/man/im_copy_from.3 deleted file mode 100644 index 8e0c909e..00000000 --- a/man/im_copy_from.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_copy.3 diff --git a/man/im_copy_morph.3 b/man/im_copy_morph.3 deleted file mode 100644 index 8e0c909e..00000000 --- a/man/im_copy_morph.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_copy.3 diff --git a/man/im_copy_set.3 b/man/im_copy_set.3 deleted file mode 100644 index 8e0c909e..00000000 --- a/man/im_copy_set.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_copy.3 diff --git a/man/im_copy_set_meta.3 b/man/im_copy_set_meta.3 deleted file mode 100644 index 8e0c909e..00000000 --- a/man/im_copy_set_meta.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_copy.3 diff --git a/man/im_copy_swap.3 b/man/im_copy_swap.3 deleted file mode 100644 index 8e0c909e..00000000 --- a/man/im_copy_swap.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_copy.3 diff --git a/man/im_correl.3 b/man/im_correl.3 deleted file mode 100644 index 89730696..00000000 --- a/man/im_correl.3 +++ /dev/null @@ -1,49 +0,0 @@ -.TH IM_CORREL 3 "13 May 1991" -.SH NAME -im_correl \- search for image match -.SH SYNOPSIS -#include - -int -.br -im_correl( IMAGE *ref, IMAGE *sec, -.br - int xref, int yref, int xsec, int ysec, -.br - int hwindowsize, int hsearchsize, -.br - double *correlation, int *x, int *y ) - -.SH DESCRIPTION -im_correl() is the base image-searching function used by the mosaicing -functions im_lrmosaic() and im_tbmosaic(), and by the matching funtions -im_match_linear() and im_match_linear_search(). - -It finds the position of the secondary image -.B sec -within -.B ref. -It searches the area around -.B xsec -, -.B ysec -for the best match for the area around -.B xref -, -.B yref. -It searches an area of size -.B hsearchsize -for a match of size -.B hwindowsize. -The position of the best match is returned, together with the correlation at -that point. - -Only the first band of each image is correlated. ref and sec may be very large ---- the function extracts and generated just the parts needed. Correlation is -done with im_spcor(); the position of the maximum is found with im_maxpos(). -.SH SEE ALSO -im_fastcor(3), im_spcor(3), im_maxpos(3), im_match_linear(3), im_lrmosaic(3). -.SH AUTHOR -J.Cupitt \- 22/02/93 -.SH COPYRIGHT -The National Gallery and Birkbeck College, 1989-1996. diff --git a/man/im_costra.3 b/man/im_costra.3 deleted file mode 100644 index be8b6393..00000000 --- a/man/im_costra.3 +++ /dev/null @@ -1,47 +0,0 @@ -.TH IM_COSTRA 3 "24 April 1991" -.SH NAME -im_costra, im_sintra, im_tantra, -im_acostra, im_asintra, im_atantra \- basic trig functions -.SH SYNOPSIS -#include - -int im_costra(in, out) -.br -IMAGE *in, *out; - -int im_sintra(in, out) -.br -IMAGE *in, *out; - -int im_tantra(in, out) -.br -IMAGE *in, *out; - -int im_acostra(in, out) -.br -IMAGE *in, *out; - -int im_asintra(in, out) -.br -IMAGE *in, *out; - -int im_atantra(in, out) -.br -IMAGE *in, *out; - -.SH DESCRIPTION -Basic trig functions. The input image is mapped through either cos(3), sin(3) or -tan(3) and written to out. All work in degrees. - -The size and number of bands are unchanged, the output type is float, unless -the input is double, in which case the output is double. Non-complex images -only! - -.SH RETURN VALUE -Each function returns 0 on success and -1 on error. -.SH SEE ALSO -im_add(3), im_lintra(3), im_abs(3), im_mean(3), im_logtra(3) -.SH COPYRIGHT -National Gallery, 1995. -.SH AUTHOR -J. Cupitt \- 21/7/93 diff --git a/man/im_cp_desc.3 b/man/im_cp_desc.3 deleted file mode 100644 index 89627abb..00000000 --- a/man/im_cp_desc.3 +++ /dev/null @@ -1,48 +0,0 @@ -.TH IM_CP_DESC 3 "11 April 1990" -.SH NAME -im_cp_desc, im_append_Hist \- copy most of an image descriptor to another -image descriptor. -.SH SYNOPSIS -.B #include - -int im_cp_desc_array( IMAGE *out, IMAGE *in[] ); - -int im_cp_descv( IMAGE *out, IMAGE *in1, ... ); - -.B int im_cp_desc( IMAGE *out, IMAGE *in ); - -.B int im_append_Hist( IMAGE *out, IMAGE *in ); - -.SH DESCRIPTION -.B im_cp_desc_array(3) -takes an output image and a NULL-terminated list of input images, which must -contain at least one input image. - -It copies the fields describing the size, bands, type, resolution, and -coding from the first input image to the output image. History and meta from -all images are copied over. If two input images have the same meta tag, the -earlier one takes precedence. - -.B im_cp_descv(3) -is a varargs conveniece function for -.B im_cp_desc_array(3). - -.B im_cp_desc(3) -is a convenience function which calls -.B im_cp_descv( image1, image2, NULL ). - -.B im_append_Hist(3) -appends the history attached to image2 to the end of the history on image1. It -is used by image processing functions which take more than one image as input, -and which need to make sure that all the input history appears in the output. - -The first line of image2 history is not copied, as this conventionally holds -background information which is not part of the file history. - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 11/04/1990 diff --git a/man/im_cp_desc_array.3 b/man/im_cp_desc_array.3 deleted file mode 100644 index 33ff1a6b..00000000 --- a/man/im_cp_desc_array.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_cp_desc.3 diff --git a/man/im_cp_descv.3 b/man/im_cp_descv.3 deleted file mode 100644 index 33ff1a6b..00000000 --- a/man/im_cp_descv.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_cp_desc.3 diff --git a/man/im_create_dmask.3 b/man/im_create_dmask.3 deleted file mode 100644 index df8ebcfd..00000000 --- a/man/im_create_dmask.3 +++ /dev/null @@ -1,224 +0,0 @@ -.TH IM_READMASK 3 "2 May 1991" -.SH NAME -im_create_dmask, im_create_imask, im_create_dmaskv, im_create_imaskv, -im_dup_dmask, im_dup_imask, im_free_dmask, -im_free_imask, im_print_imask, im_print_dmask, im_read_dmask, im_read_imask, -im_scale_dmask, im_write_dmask, im_write_imask \- operations on double or int -masks -.SH SYNOPSIS -#include - -DOUBLEMASK *im_create_dmask( name, xs, ys ) -.br -char *name; -.br -int xs, ys; - -INTMASK *im_create_imask( name, xs, ys ) -.br -char *name; -.br -int xs, ys; - -DOUBLEMASK *im_create_dmaskv( name, xs, ys, ... ) -.br -char *name; -.br -int xs, ys; - -INTMASK *im_create_imaskv( name, xs, ys, ... ) -.br -char *name; -.br -int xs, ys; - -DOUBLEMASK *im_dup_dmask( m, name ) -.br -DOUBLEMASK *m; -.br -char *name; - -INTMASK *im_dup_imask( m, name ) -.br -INTMASK *m; -.br -char *name; - -void im_free_dmask( mask ) -.br -DOUBLEMASK *mask; - -void im_free_imask( mask ) -.br -INTMASK *mask; - -DOUBLEMASK *im_read_dmask( name ) -.br -char *name; - -INTMASK *im_read_imask( name ) -.br -char *name; - -void im_print_dmask( mask ) -.br -DOUBLEMASK *mask; - -void im_print_imask( mask ) -.br -INTMASK *mask; - -INTMASK im_scale_dmask( mask, name ) -.br -DOUBLEMASK *mask; -.br -char *name - -void im_norm_dmask( DOUBLEMASK *mask ); - -int im_write_imask( m ) -.br -INTMASK *m; - -int im_write_imask_name( m, name ) -.br -INTMASK *m; -.br -char *name; - -int im_write_dmask_name( m, name ) -.br -DOUBLEMASK *m; -.br -char *name; - -.SH DESCRIPTION -Masks are (see ): - - typedef struct { typedef struct { - int xsize; int xsize; - int ysize; int ysize; - int scale; double scale; - int offset; double offset; - int *coeff; double *coeff; - char *filename; char *filename; - } INTMASK ; } DOUBLEMASK ; - -By mask files have the following structure: - - x y [scale] [offset] - a11 a12 ... a1y - a21 a22 ... a2y] - ... ... ... ... - ax1 ax2 ... axy - -The mask sizes x and y are always integer whereas all the remaining coefficients -are either int for INTMASK and double for the DOUBLEMASK. All numbers are -written in ASCII, for convenience. scale and offset are -always optional. If missing, they default to 1 and 0 respectively. This laxity -makes mask files useful for matrix operations, see im_matinv(3), etc. - -im_create_dmask() -returns an DOUBLEMASK with the filename xsize and ysize set to name xs and ys -respectively. The function allocates memory for the coefficients which are -all initialised to zero. In case of error the function returns NULL. - -im_create_dmaskv() operates exactly as im_create_dmask(), except that the mask -is initialised by the parameters following the width and height. These -parameters must all be doubles. For example: - - DOUBLEMASK *m = im_create_dmaskv( "untitled", 3, 3, - 1.0, 0.0, 0.0, - 0.0, 1.0, 0.0, - 0.0, 0.0, 1.0 ); - -creates an identity matrix. - -im_create_imask() -returns an INTMASK with the filename xsize and ysize set to name xs and ys -respectively. The function allocates memory for the coefficients which are -all initialised to zero. In case of error the function returns NULL. - -im_create_imaskv() operates exactly as im_create_imask(), except that the mask -is initialised by the parameters following the width and height. These -parameters must all be ints. For example: - - INTMASK *m = im_create_imaskv( "untitled", 3, 3, - 1, 0, 0, - 0, 1, 0, - 0, 0, 1 ); - -creates an identity matrix. - -im_dup_dmask() -duplicates the DOUBLEMASK mask pointed by m and returns a pointer to the -new mask. The filename member of the returned mask is set to the entered -name. The function returns either a DOUBLEMASK pointer or NULL on error. - -im_dup_imask() -duplicates the INTMASK mask pointed by m and returns a pointer to the -new mask. The filename member of the returned mask is set to the entered -name. The function returns either an INTMASK pointer or NULL on error. - -im_free_dmask() -frees the memory allocated for the DOUBLEMASK mask. - -im_free_imask() -frees the memory allocated for the INTMASK mask. - -im_print_dmask() -prints at the sterr the DOUBLEMASK pointed by mask. - -im_print_imask() -prints at the sterr the INTMASK pointed by mask. - -im_read_dmask() -opens the argument name and reads the mask into a DOUBLEMASK structure. -The function returns a pointer to an DOUBLEMASK or NULL on error. - -im_read_imask() -opens the argument name and reads the mask into a INTMASK structure. -If the input -file has non-integer coefficients then the function im_read_dmask() should -be used instead. There is a built-in checking for all mask members. -If the mask has coefficients which are integers or they are floats -with the decimal part equal to zero, the function reads the mask -properly and puts the resultant coefficients in a valid INTMASK. -The function returns a pointer to an INTMASK or NULL on error. - -im_scale_dmask() -returns an INTMASK of the DOUBLE MASK m. The maximum value of the DOUBLEMASK -is scaled to 100 in the returned mask. The scale member of the INTMASK is -scaled accordingly to the scale member of m. -The function returns a pointer to an INTMASK or NULL on error. - -.B im_norm_dmask(3) -applies the scale and offset members of -.I mask -to each of its coefficients, and then sets them to 1.0 and zero respectively. - -im_write_imask() -writes the INTMASK pointed by m to the filename member of m. The function -checks whether the filename is valid and it expects only an INTMASK. -The function returns 0 on success and -1 on error. -For writing a DOUBLEMASK use im_write_dmask() instead. - -im_write_imask_name() -operates as im_write_imask(), but the mask is written to the named file. - -im_write_dmask() -writes the DOUBLEMASK pointed by m to the filename member of m. The function -checks whether the filename is valid and it expects only an DOUBLEMASK. -The mask is written in a file with the format given above. The function uses -fprintf with the conversion character %g, to write the non integer -mask coefficients. It returns 0 on success and -1 on error. - -im_write_dmask_name() -operates as im_write_dmask(), but the mask is written to the named file. - -.SH SEE ALSO -im_lindetect(3), im_compass(3), im_conv(3), im_matinv(3). -.SH COPYRIGHT -N. Dessipris -.SH AUTHOR -N. Dessipris \- 02/05/1991 diff --git a/man/im_create_fmask.3 b/man/im_create_fmask.3 deleted file mode 100644 index a10c37b3..00000000 --- a/man/im_create_fmask.3 +++ /dev/null @@ -1,359 +0,0 @@ -.TH IM_FMASKPROF 3 "8 Oct 1991" -.SH NAME -im_create_fmask \- create a frequency domain filter mask according to args -.SH SYNOPSIS -.B #include - -int -.br -im_create_fmask( IMAGE *out, int xs, int ys, int type, double p1, ... ) - -.SH DESCRIPTION -im_create_fmask() -creates a float one band image mask. Sizes xs and ys must be powers of 2, -and must be square. Non-square masks may be added in a future version. - -There are 18 types of filter mask supported in this VIPS - they are listed -below. For each type, you are expected to give the correct number of -additional parameters. See the table. - -.br ------------------------------------------------------------ -.br -| Filter mask; type; num_args; parameters | -.br ------------------------------------------------------------ -.br -| Ideal high pass; 0; 1; fc | -.br -| Ideal low pass; 1; 1; fc | -.br -| Butterworth high pass; 2; 3; order, fc, ac | -.br -| Butterworth low pass; 3; 3; order, fc, ac | -.br -| Gaussian low pass; 4; 2; fc, ac | -.br -| Gaussian high pass; 5; 2; fc, ac | -.br -| | -.br -| Ideal ring pass; 6; 2; fc, width | -.br -| Ideal ring reject; 7; 2; fc, width | -.br -| Butterworth ring pass; 8; 4; order, fc, width, ac | -.br -| Butterworth ring reject; 9; 4; order, fc, width, ac | -.br -| Gaussian ring pass; 10; 3; fc, width, ac | -.br -| Gaussian ring reject; 11; 3; fc, width, ac | -.br -| | -.br -| Ideal band pass; 12; 3; fcx, fcy, r | -.br -| Ideal band reject; 13; 3; fcx, fcy, r | -.br -| Butterworth band pass; 14; 5; order, fcx, fcy, r, ac | -.br -| Butterworth band reject; 15; 5; order, fcx, fcy, r, ac | -.br -| Gaussian band pass; 16; 4; fcx, fcy, r, ac | -.br -| Gaussian band reject; 17; 4; fcx, fcy, r, ac | -.br -| | -.br -| fractal filter mask; 18; 1; fractal_dimension | -.br ------------------------------------------------------------ - -All masks are created with the four quadrants rotated so the (0,0) dc component -is at the top left corner of the image. In order to view a mask, -the four quadrants must be rotated -(im_rotquad(3)) and scaled (im_scale(3)). If the masks -are used for filtering in the frequency domain, there is no need for rotation. -Function im_flt_imag_freq(3) creates a mask and filter a square image in the -frequency domain. - -As a matter of convention the positive x axis is from left to right while the -positive y axis is from top to bottom (on the image with the frequency (0,0) -close to the centre i.e the four quadrants rotated). -All produced filters are float images with the maximum value normalised to 1.0. -Ideal and Butterworth filters are given in the book by Gonzalez and Wintz. - -HIGH PASS - LOW PASS FILTER MASKS (flag: 0 to 5) - -A high pass filter mask filters the low frequencies while allowing the high -frequencies to get through. The reverse happens with a low pass -filter mask. The transition is controlled by the frequency -cutoff (fc). All masks are circularly symmetric and they are creating -by duplicating one forth of them. - -Ideal high pass/low pass (argno=1): - -The variable fc determines the frequency cutoff which can be given either as -percentage of the max spatial frequency (normalised by convention to 1.0) or -in pixels. In the latter case it is assumed that the input image is -square and that the maximum spatial frequency -corresponds to xs/2 points horizontally and and ys/2 points vertically. -The following line of code creates an ideal circularly symmetric -high pass filter mask: - -im_create_fmask(im, 128, 128, 0, .5); - -with all values above half the max spatial frequency -(corresponding to 32 pixels) set to 1.0 and the remaining set to 0.0. -The dc value (corresponding to the frequency (0,0)) is set to 1.0. -When the mask is properly scaled and has its four quadrants rotated it is a -black circle within a white square. The radius of the circle is -determined by fc which is .5*max_spatial_frequency that is, for the example -above .5*64=32. -The centre of the circle is set to 1.0 (white), in order to allow -the dc component to pass unaltered. -A circularly symmetric ideal low pass filter mask is constructed in a similar -way. - -Butterworth high pass/low pass (argno=3): - -Each mask needs three arguments: the order, fc and ac. Order corresponds to -the order of the Butterworth filter mask, fc is the frequency cutoff and -ac is the amplitude cutoff. The same conventions are valid for both fc and ac -as for the ideal high pass and low pass filter mask. -The amplitude cutoff is determined by ac and corresponds to the percentage -of the maximum amplitude at fc. The maximum amplitude is always -normalised to 1.0. -If the transfer function of the filter is H(r) then H(fc) = ac*H(0). -The transfer function at frequency (0,0) is also set to 1.0. - -The transfer function of the Butterworth high pass is: -.br -H(r)=1.0/(1.0+(1.0/ac-1.0)*pow((fc*fc)/(r*r),order)). -.br -For a Butterworth low pass: -.br -H(r)=1.0/(1.0+(1.0/ac-1.0)*pow((r*r)/(fc*fc),order)). -.br -Both masks are given in Gonzalez and Wintz (Digital Image Processing, 2nd edn, -1987). -By increasing the order, the filter becomes steeper introducing ringing. - -Gaussian high pass/low pass (argno=2): - -Each of these masks needs 2 arguments: fc and ac. For both arguments the same -conventions as for the Butterworth mask are valid. The transfer function -of a Gaussian high pass filter mask is given by the equation: -.br -H(r) = 1.0 - exp(log(ac)*r*r/(fc*fc)). -.br -The corresponding mask for a Gaussian high pass is: -.br -H(f) = exp(log(ac)*r*r/(fc*fc)). -.br -ac being the amplitude cutoff. -.br - - -RING PASS - RING REJECT FILTER MASKS (flag: 6 to 11) - -A circularly symmetric ring pass filter mask allows all -frequencies within a ring, to pass while blocking all other frequencies. -The ring is specified by its width and it radius which corresponds to fc -the frequency cutoff. The fc is centred within the width and, therefore, -the ring starts at point fc-width/2 up to fc+width/2 along the positive -horizontal x axis. The reverse happens with a low pass -filter mask. The transition is controlled by the frequency -cutoff (fc). All masks are circularly symmetric and they are creating -by duplicating one forth of them. - -Ideal ring pass/ring reject filter masks (argno=2): - -An ideal ring pass filter mask has two arguments, the width and the frequency -cutoff. The created mask when properly rotated, -is a white ring of internal radius fc-df -and external radius fc+df, on a black square. All band pass values -within the ring are set to 1.0 while the remaining band reject frequencies -are set to 0.0. The (0,0) frequency component is set to 1.0. -Both fc and width must be either between 0.0 and 1.0, or between 1.0 and -xs/2. If both are between 0.0 and 1.0 then the program normalises then to the -maximum spatial frequency which is xs/2=ys/2. - -An ideal ring reject filter mask is the reverse of the ideal ring pass filter -mask, that is it allows all frequencies to get through apart from the -frequencies within a ring specified by the args of the function, -in a similar way as the ideal ring pass filter. - -Butterworth ring pass/ring reject filter masks (argno=4): - -.br -Each of these masks has 4 arguments: the order of the filter (order), -the frequency cutoff (fc), the width (width) and the amplitude cutoff (ac). -.br -A Butterworth ring pass filter mask is a circularly symmetric ring shape mask. -The profile of the mask along the horizontal positive axis is a shifted -low pass Butterworth filter mask, with the maximum value set to 1.0. -This mask is similar to the ideal ring pass but the transition -between band pass and band reject zones instead of a sharp brick -wall, is a shifted Butterworth low pass filter -mask. The transfer function of the mask is given by the equation: -.br -H(r)=1./(1.+cnst*pow(((r-fc)*(r-fc)/(w2)),order)) -.br -where cnst=1/ac, w2 = width*width/4. -.br -Both fc and width should be either between 0.0 and 1.0 or between 1.0 and xs/2 -as in the case of the ideal ring pass or ring reject mask. The amplitude -cutoff should be always between 0.0 and 1.0. It should be noted that: -.br -H(fc+df)=H(fc-df)=ac*H(fc) -.br -The value of H(0) at frequency (0,0) has been set to 1.0 in order to allow -the dc component of the image to pass unaltered. - -For the case of the Butterworth ring reject filter mask, its transfer function -is given by the equation: -.br -H(r)=1./(1.+cnst*pow((w2/((r-fc)*(r-fc))),order)) -.br -where cnst=1/ac, w2 = width*width/4. -.br - -Gaussian ring pass/ring reject filter masks (argno=3): - -Each of these masks takes three arguments: the frequency cutoff (fc), the width -(width) and the amplitude cutoff (ac). The conventions for the arguments -are the same as for the Butterworth ring pass and ring reject masks above; -however the order is not needed. - -The transfer function of a Gaussian ring pass filter mask is: -.br -H(r)=exp(log(ac)*(r-fc) * (r-fc)/w2) -.br -where w2 = width*width/4. -.br - -BAND PASS - BAND REJECT MASKS (flag:13 to 17) - -These filter masks are used in order to eliminate spatial frequencies -around a given frequency. Since the masks must be symmetrical -with respect to the origin, they cannot be realised by creating -one forth and replicating it four times. - -Ideal band pass/band reject filter masks (argno=3): - -An ideal band reject filter mask takes three arguments: the coordinates -of the centre of the one circle (fcx,fcy) and its radius r. The produced -filter mask has all values 0.0 except two disks centred at (fcx,fcy), -(-fcx,-fcy) each one having radius r. The two disks have values of 1.0. -The value of the mask corresponding to (0,0) spatial frequency, as also -set to 1.0. - -All three arguments fcx, fcy and r should be either between 0 and 1 or -between 1 and the max spatial frequency which is xs/2=ys/2. In the -case that the arguments are between 0.0 and 1.0 they are interpreted -as percentage of the maximum spatial frequency. For the case of band -pass filter masks the value of the (0,0) frequency is set to 1.0 so that -the dc component can pass unaltered. - -Butterworth band pass/band reject filter masks (argno=4): - -A Butterworth band pass/band reject -filter mask allows/rejects spatial frequencies -around a given frequency. The mask consists of the sum of two -Butterworth shape filters centered at (fcx,fcy) and (-fcx,-fcy). -The shape of each mask is determined by the parameters of the function. -The arguments fcx, fcy and r obey the same conventions as for those -of the ideal band pass / band reject masks. The transfer function of the -filter at point (0,0) is set to 1.0. - -The function works by adding the two Butterworth masks. -As a result, if the whole mask is normalised with respect to -frequency (fcx,fcy), the cutoff frequency at (fcx+||r||,fcy+||r||) will -be different to that of (fcx-||r||,fcy-||r||), since the tail of -the mask centered at (-fcx,-fcy) will give a different contribution -to (fcx+||r||,fcy+||r||) than that to (fcx-||r||,fcy-||r||). -In order to simplify the calculations, the function estimates the -amplitude at a cutoff frequency ((fcx-||r||,fcy-||r||) as if the contribution -comes only from the mask centred at (fcx,fcy). The side effect of this -approach is that for big values of r the cutoff frequency of the filter mask -is different at frequencies (fcx+||r||,fcy+||r||) and (fcx+||r||,fcy+||r||). - -More specifically, given that each disk has a Butterworth shape of radius r -with centres at (x0, y0) and (-x0,-y0), -the transfer function of a Butterworth band pass filter -mask is given by the equation: -.br -H(d)= { H1(d) + H2(d) } -.br -H1(d) = cnst1/(1 + cnst2 * pow((d-d0)/r, 2*order)) -.br -H2(d) = cnst1/(1 + cnst2 * pow((d+d0)/r, 2*order)) -.br -where -.br -cnst1=1./(1.+1./(1.+cnst1*pow(d02/((r/2)*(r/2)),order))) -.br -cnst2=1./ac - 1., -.br -d02 = x0*x0+y0*y0. -.br -With this configuration for d=+d0, H(+d0) = 1.0; for d=-d0 H(-d0) = 1.0. -If da=(xa,ya), then for d=+da, H1(+da)=ac and for d=-da, H1(-da)=ac. In the -latter case it is assumed that xa=x0*(1-radius/sqrt(x0*x0+y0*y0)) and that -ya=y0*(1-radius/sqrt(x0*x0+y0*y0)). - -The transfer function of a Butterworth band reject filter H_bbr(d) is given -by the equation: -.br -H_bbr(d) = 1.0 - H_bbp(d), -.br -where H_bbp(d) is the transfer function of the Butterworth bandpass filter -defined above. - -Gaussian band pass/band reject filter masks (argno=3): - -For a Gaussian band pass or band reject filter mask, similar conventions -to those of the Butterworth filter masks, are valid however the order as an -argument is not needed. - -The transfer function of a Gaussian band pass filter mask is given by the -equation -.br -H(d)= { H1(d) + H2(d) } -.br -H1(d) = cnst1 * exp(-cnst2 * (d-d0)*(d-d0)/(r*r)) -.br -H1(d) = cnst1 * exp(-cnst2 * (d+d0)*(d+d0)/(r*r)) -.br -where -.br -cnst1=1/( 1+exp(-cnst*d02/((r/2)*(r/2))) ), -.br -d02 = x0*x0+y0*y0 and cnst2=-log(ac). - -The transfer function of a Gaussian band reject filter H_gbr(d) is given -by the equation: -.br -H_gbr(d) = 1.0 - H_gbp(d), -.br -where H_gbp(d) is the transfer function of the Gaussian bandpass filter -defined above. - -FRACTAL FILTER MASK (flag:18) - -The fractal filter mask should be used only to filter square images of -white Gaussian noise in order to create fractal surfaces of a given fractal -dimension. The fractal dimension should be between 2.0 and 3.0. The produced -mask has a power spectrum which decays according to the rule entered by the -parameter fractal dimension. -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE\ ALSO -im_flt_image_freq(3). -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 10/08/1991 diff --git a/man/im_create_imask.3 b/man/im_create_imask.3 deleted file mode 100644 index 3b08512d..00000000 --- a/man/im_create_imask.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_create_dmask.3 diff --git a/man/im_csv2vips.3 b/man/im_csv2vips.3 deleted file mode 100644 index 04e3131f..00000000 --- a/man/im_csv2vips.3 +++ /dev/null @@ -1,68 +0,0 @@ -.TH IM_CSV 3 "November 2000" -.SH NAME -im_csv2vips, im_vips2csv \- read and write CSV (comma separated values) files -.SH SYNOPSIS -#include - -int im_csv2vips( const char *filename, IMAGE *out ) - -int im_vips2csv( IMAGE *in, const char *filename ) - -.SH DESCRIPTION -.B im_csv2vips(3) -reads the CSV (comma separated values) data in filename, and writes the image -out in VIPS format. The output image is always 1 band (monochrome), -IM_BANDFMT_DOUBLE. - -The reader is deliberately rather fussy: it will fail if there are any short -lines, or if the file is too short. It will ignore lines that are too long. - -Read options can be embedded in the filename. The options can be given in any -order and are: - - skip:lines-to-skip - -The number of lines to skip at the start of the file. Default zero. - - whi:whitespace-characters - -The skippable whitespace characters. Default and double quotes ("). -Whitespace characters are always run together. - - sep:separator-characters - -The characters that separate fields. Default ;,. Separators are -never run together. - - line:lines-to-read - -The number of lines to read from the file. Default -1, meaning read to end of -file. - -.B im_vips2csv(3) -writes the VIPS image to the file as ascii text, one line of text per -scanline. Complex numbers are written as "(real,imaginary)" and will need -extra parsing I guess. - -Write options can be embedded in the filename. The options can be given in any -order and are: - - sep:separator-string - -The string to use to separate numbers in the output. The default is "\\t" (tab). - -.SH EXAMPLES - - im_csv2vips( "fred.csv:skip:58,sep:\,,line:3", out ); - -Will read three lines starting at line 59, with space, comma and tab as the -allowed separators. Note that the ',' has to be escaped with a backslash. - - im_vips2csv fred.jpg fred.csv:sep:\t - -Convert a jpeg to CSV, separating numbers with tab characters. - -.SH SEE ALSO -im_read_dmask(3), im_ppm2vips(3) -.SH COPYRIGHT -Hey, you want this? You have it! diff --git a/man/im_dE00_fromLab.3 b/man/im_dE00_fromLab.3 deleted file mode 100644 index 0f335f81..00000000 --- a/man/im_dE00_fromLab.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_dE_fromLab.3 diff --git a/man/im_dECMC_fromLab.3 b/man/im_dECMC_fromLab.3 deleted file mode 100644 index 0f335f81..00000000 --- a/man/im_dECMC_fromLab.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_dE_fromLab.3 diff --git a/man/im_dECMC_fromdisp.3 b/man/im_dECMC_fromdisp.3 deleted file mode 100644 index 0d3cc14a..00000000 --- a/man/im_dECMC_fromdisp.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_dE_fromdisp.3 diff --git a/man/im_dE_fromLab.3 b/man/im_dE_fromLab.3 deleted file mode 100644 index 46de25af..00000000 --- a/man/im_dE_fromLab.3 +++ /dev/null @@ -1,42 +0,0 @@ -.TH im_dE_fromLab 3 "2 December 1992" -.SH NAME -im_dE_fromLab, im_dECMC_fromLab, im_dE00_fromLab \- calculate colour differences -.SH SYNOPSIS -#include - -int im_dE_fromLab(in1, in2, out) -.br -IMAGE *in1, *in2, *out; - -int im_dECMC_fromLab(in1, in2, out) -.br -IMAGE *in1, *in2, *out; - -int im_dE00_fromLab(in1, in2, out) -.br -IMAGE *in1, *in2, *out; - -.SH DESCRIPTION -Given a pair of images in Lab format, these functions calculate CIE76, -CMC(1:1) and CIEDE2000 colour difference images. These are the basic colour -difference -calculators in VIPS --- other colour difference functions, such as -.B im_dE_fromXYZ(3), -are provided as a convenience to the programmer. - -See -.B im_Lab2XYZ(3) -for an explanation of the various colour spaces VIPS -supports and how to convert between them. - -.SH RETURN VALUE -The functions return 0 on success and -1 on error. -.SH SEE ALSO -im_col_XYZ2rgb(3), im_XYZ2rgb(3), im_dE_fromXYZ(3). -.SH COPYRIGHT -National Gallery, 1990 - 1993 -.SH AUTHOR -J.Ph. Laurent \- 2/12/1992 -.br -J. Cupitt \- 21/7/93 - diff --git a/man/im_dE_fromXYZ.3 b/man/im_dE_fromXYZ.3 deleted file mode 100644 index 0d3cc14a..00000000 --- a/man/im_dE_fromXYZ.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_dE_fromdisp.3 diff --git a/man/im_dE_fromdisp.3 b/man/im_dE_fromdisp.3 deleted file mode 100644 index 5aa32c15..00000000 --- a/man/im_dE_fromdisp.3 +++ /dev/null @@ -1,38 +0,0 @@ -.TH IM_DE_FROMDISP 3 "2 December 1992" -.SH NAME -im_dE_fromdisp, im_dE_fromXYZ, im_dECMC_fromdisp \- derived colour difference -functions -.SH SYNOPSIS -#include - -im_dE_fromdisp( in1, in2, out, display ) -.br -IMAGE *in1, *in2, *out; -.br -struct im_col_display *display; - -int im_dE_fromXYZ(in, out) -.br -IMAGE *in, *out; - -im_dECMC_fromdisp( in1, in2, out, display ) -.br -IMAGE *in1, *in2, *out; -.br -struct im_col_display *display; - -.SH DESCRIPTION -These functions are built on the basic VIPS colour difference measurements as a -convenience for the programmer. See im_dE_fromLab(3) for an explanation of the -colour difference metrics and the basic comparision functions. - -.SH RETURN VALUE -The functions return 0 on success and -1 on error. -.SH SEE ALSO -im_col_XYZ2rgb(3), im_dE_fromLab(3), im_LabQ2Lab(3), im_Lab2disp(3). -.SH COPYRIGHT -National Gallery and Birkbeck College, 1990 - 1993 -.SH AUTHOR -K. Martinez \- 2/12/1992 -.br -J. Cupitt \- 21/7/93 diff --git a/man/im_debugim.3 b/man/im_debugim.3 deleted file mode 100644 index c2712a8a..00000000 --- a/man/im_debugim.3 +++ /dev/null @@ -1,31 +0,0 @@ -.TH IM_DEBUG 3 "22 April 1991" -.SH NAME -im_debug, im_printlines \- print raw image data pointed by an image descriptor -.SH SYNOPSIS -.B #include - -.B void im_debugim( image ) -.br -.B IMAGE *image; - -.B void im_printlines( image ) -.br -.B IMAGE *image; -.SH DESCRIPTION -.B im_debugim(3) -prints to the standard error output raw data pointed by image sequentially. -Data are printed as float numbers and the function interprets the input format -properly. If input is complex then for each pixel the real part followed -by the imaginary is printed. It can be used for debugging preferably on small -images. If input is uchar then the printed values are integers. - -.B im_printlines -printes in the standard error output the no of line followed by CR, followed -by the line pixel values. For each pixel, the x location -followed by the pixel value(s) is printed. The location and the pixels value(s) -are separated by a tab. Each pixel is printed on a separate line. -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 22/04/1991 diff --git a/man/im_demand_hint.3 b/man/im_demand_hint.3 deleted file mode 100644 index 383afa75..00000000 --- a/man/im_demand_hint.3 +++ /dev/null @@ -1,130 +0,0 @@ -.TH IM_IOCHECK 3 "11 April 1990" -.SH NAME -im_demand_hint \- hint on demand style for im_generate(3) -.SH SYNOPSIS -#include - -int im_demand_hint( im, hint, in1, in2, ..., NULL ) -.br -IMAGE *im, *in1, *in2, ...; -.br -im_demand_type hint; - -int im_demand_hint_array( im, hint, in ) -.br -IMAGE *im, **in; -.br -im_demand_type hint; -.SH DESCRIPTION -.B im_demand_hint(3) -suggests to im_generate(3) the sorts of demand with which this image processing -operation would be happiest. - -.B im -is the image this operation is generating. -.B hint -is the demand style this operation would like (see below), and -.B in1 ... -is a NULL-terminated list of the image upon which this output image directly -depends, that is, the images which this operation will call im_prepare(3) for. - -This list of parent images is necessary, as im_demand_hint(3) needs to know -what demand style this operation's ancestors have requested. If an ancestor of -this operation has specified a very restrictive demand style, then this -operation must fall back to that restrictive style and ignore the hint given -in this call to im_demand_hint(3). - -VIPS currently supports three demand styles. More may be added in the future. -These demand styles are given below in order of increasing restrictiveness. -When demanding output from a pipeline, im_generate(3) will use the most -restrictive of the styles requested by the operations in the pipeline. - -IM_THINSTRIP -.br -This operation would like to output strips the width of the image and a few -pels high. This is option suitable for point-to-point operations, such as -those in the arithmetic package. - -This option is only efficient for cases where each output pel depends upon the -pel in the corresponding position in the input image. - -IM_FATSTRIP -.br -This operation would like to output strips the width of the image and as high -as possible. This option is suitable for area operations which do not -violently transform coordinates, such as im_conv(3). - -IM_SMALLTILE -.br -This is the most general demand format, and is the default. Output is -demanded in small (around 100x100 pel) sections. This style works reasonably -efficiently, even for bizzare operations like 45 degree rotate. - -IM_ANY -.br -This image is not being demand-read from a disc file (even indirectly) so any -demand style is OK. It's used for things like -.B im_black(3) -where the pixels are calculated. - -.B -im_demand_hint_array(3) -works exactly as im_demand_hint(3), but expects a pointer to a NULL-terminated -array of parent images as its third argument. You may use -im_allocate_input_array(3), if you wish, to build this structure. - -As an example, here is part of the code for im_invert(3). In this operation, -each output pel depends upon the corresponding input pel. In other words, -there is no coordinate transformation in im_prepare(3). This style of -operation is most efficient with IM_THINSTRIP IO. - -int im_invert( IMAGE *in, IMAGE *out ) -.br -{ -.br - if( in->Coding != NOCODING ) { -.br - im_errormsg( "im_invert: input coded" ); -.br - return( -1 ); -.br - } -.br - if( in->BandFmt != FMTUCHAR ) { -.br - im_errormsg( "im_invert: input not UCHAR" ); -.br - return( -1 ); -.br - } -.br - if( im_piocheck( in, out ) ) -.br - return( -1 ); -.br - if( im_cp_desc( out, in ) ) -.br - return( -1 ); -.br - if( im_demand_hint( out, IM_THINSTRIP, in, NULL ) ) -.br - return( -1 ); -.br - if( im_generate( out, -.br - im_start_one, inv_gen, im_stop_one, in, NULL ) ) -.br - return( -1 ); -.br - return( 0 ); -.br -} - -.SH RETURN VALUE -All functions returns 0 on success and non-zero on error. -.SH SEE ALSO -im_generate(3), im_prepare(3). -.SH COPYRIGHT -National Gallery -.SH AUTHOR -J. Cupitt \- 3/9/93 diff --git a/man/im_demand_hint_array.3 b/man/im_demand_hint_array.3 deleted file mode 100644 index 124bcb4a..00000000 --- a/man/im_demand_hint_array.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_demand_hint.3 diff --git a/man/im_deviate.3 b/man/im_deviate.3 deleted file mode 100644 index 46443e20..00000000 --- a/man/im_deviate.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_avg.3 diff --git a/man/im_diag.3 b/man/im_diag.3 deleted file mode 100644 index 7db4b63b..00000000 --- a/man/im_diag.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_error.3 diff --git a/man/im_dif_std.3 b/man/im_dif_std.3 deleted file mode 100644 index 8d505818..00000000 --- a/man/im_dif_std.3 +++ /dev/null @@ -1,40 +0,0 @@ -.TH IM_DIF_STD 3 "10 May 1991" -.SH NAME -im_dif_std \- calculate the mean and the standard deviation of the difference image for a given displacement vector -.SH SYNOPSIS -.B #include - -int im_dif_std(im, xp, yp, xs, ys, dx, dy, mean, std) -.br -.B IMAGE *im; -.br -.B int xp, yp, xs, ys; -.br -.B int dx, dy; -.br -.B double *mean, *std; - -.SH DESCRIPTION -.B im_dif_std() -calculates the mean and the standard deviation of the difference image -created by the displacement vector (dx,dy) on the box (xp,yp;xs,ys) defined -on the image pointed by im. More specifically the difference image is -of an image given the dispacement vector (dx, dy) is defined as follows: -For each point of the original image, the start of the vector (dx,dy) is -set on that point. The difference image at this point is defined as the -difference of the values pointed by the vector (end value - start value). -The function returns the mean and the standard deviation of the -difference images measured on the area (xp,yp;xs,ys) of im. - -Input im should be one band unsigned char image and it should -have been set by a call to im_mmapin(3) or im_setbuf(3). - -.SH RETURNED VALUES(3) -The function returns 0 on success and -1 on error. -.SH SEE\ ALSO -im_cooc_matrix(3), im_glds_matrix(3) -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 10/05/1991 diff --git a/man/im_dilate.3 b/man/im_dilate.3 deleted file mode 100644 index ba2dfa6d..00000000 --- a/man/im_dilate.3 +++ /dev/null @@ -1,81 +0,0 @@ -.TH IM_DILATE 3 "14 May 1991" -.SH NAME -im_dilate, im_dilate_raw, im_erode, im_erode_raw \- perform morphological operations on a white object against a black background -.SH SYNOPSIS -.B #include - -.B int im_dilate(in, out, m) -.br -.B IMAGE *in, *out; -.br -.B INTMASK *m; - -.B int im_erode(in, out, m) -.br -.B IMAGE *in, *out; -.br -.B INTMASK *m; - -.B int im_dilate_raw(in, out, m) -.br -.B IMAGE *in, *out; -.br -.B INTMASK *m; - -.B int im_erode_raw(in, out, m) -.br -.B IMAGE *in, *out; -.br -.B INTMASK *m; - -.SH DESCRIPTION -The above functions are applications of morphological operations on one -channel binary images ie. images with pixels that are either 0 (black) or 255 -(white). All functions assume that input images contain white objects against -a black background. - -Mask coefficients can be either 0 (for object) or 255 (for background) or 128 -(for do not care). - -The mask should have odd length sides and the origin of the mask is at location -(m-\>xsize/2,m-\>ysize/2) integer division. All algorithms have been based on -the book "Fundamentals of Digital Image Processing" by A. Jain, pp 384-388, -Prentice-Hall, 1989. Essentially, -.B im_dilate(3) -sets pixels in the output if -*any* part of the mask matches, whereas -.B im_erode(3) -sets pixels only if *all* -of the mask matches. - -.B im_dilate(3) -dilates the image pointed by in, according to the mask pointed by m and writes -the result in the location pointed by the IMAGE descriptor out. The output -image is the same size as the input, in the manner of -.B im_conv(3). - -.B im_dilate_raw(3) -works as im_dilate(3), but does not expand the input. - -.B im_erode(3) -erodes the image pointed by in, according to the mask pointed by m and writes -the result in the location pointed by the IMAGE descriptor out. Again, the -output image is forced to have the same size as the input. - -.B im_erode_raw(3) -works as im_erode(3), but does not expand the input. - -See the boolean operations -.B im_andimage(3), -.B im_orimage(3) -and -.B im_eorimage(3) -for analogues -of the usual set difference and set union operations. - -.SH RETURN VALUE -All functions returns 0 on success and -1 on error. -.SH SEE ALSO -im_read_imask(3), im_conv(3), im_andimage(3), im_rotate_imask(3). -.SH COPYRIGHT -1991-1995, Birkbeck College and the National Gallery diff --git a/man/im_dilate_raw.3 b/man/im_dilate_raw.3 deleted file mode 100644 index 1fdf30e4..00000000 --- a/man/im_dilate_raw.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_dilate.3 diff --git a/man/im_disp2Lab.3 b/man/im_disp2Lab.3 deleted file mode 100644 index cb1e992d..00000000 --- a/man/im_disp2Lab.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_Lab2UCS.3 diff --git a/man/im_disp2XYZ.3 b/man/im_disp2XYZ.3 deleted file mode 100644 index 6866a230..00000000 --- a/man/im_disp2XYZ.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_XYZ2disp.3 diff --git a/man/im_disp_ps.3 b/man/im_disp_ps.3 deleted file mode 100644 index 33040ded..00000000 --- a/man/im_disp_ps.3 +++ /dev/null @@ -1,32 +0,0 @@ -.TH IM_DISP_PS 3 "23 May 1991" -.SH NAME -im_disp_ps \- creates a displayable power spectrum of an one band image -.SH SYNOPSIS -.B #include - -.B int im_disp_ps(in, out) -.br -.B IMAGE *in, *out; -.SH DESCRIPTION -im_disp_ps() creates a displayable power spectrum of the image held by the -image descriptor in. The resultant unsigned char image is written on the -image descriptor out. Input should be one band image of any non-complex -type. - -The function finds the fourier transform of the input (if in is not complex) -and then the amplitude power spectrum is created (im_c2ps(3)). The power -spectrum is passed through a non-linear transformation (im_scaleps(3)). The -final image has the four quadrants rotated in such a way that the coordinate -(0,0) is near the centre of the image (im_rotquad(3)). - -Input should be a square image with size power of 2. -The maximum size of the input image is dictated by the available RAM. -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_fwfft(3), im_c2ps(3), im_scaleps(3), im_rotquad(3). -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 23/05/1991 diff --git a/man/im_divide.3 b/man/im_divide.3 deleted file mode 100644 index 49e3b3b0..00000000 --- a/man/im_divide.3 +++ /dev/null @@ -1,33 +0,0 @@ -.TH DIVISION 3 "24 April 1991" -.SH NAME -im_divide \- divide two images -.SH SYNOPSIS -.B #include - -.B int im_divide(in1, in2, out) -.br -.B IMAGE *in1, *in2, *out; - -.SH DESCRIPTION -.B im_divide(3) -divides two images. The result is float except if one (or both) input is -double. In the latter case the result is double. If either input is complex, -the result is complex. If either input is double complex, the output is double -complex. - -Input images in1 and in2 should have the same channels and the same sizes, -however they can be of different types. - -For complex input pels (x1,y1) and (x2,y2), -.B im_divide(3) -calculates - ((x1*x2 + y1*y2)/(x2*x2 + y2*y2), (y1*x2 - x1*y2)/(x2*x2 + y2*y2)). - -.SH BUGS -The function does not check the result for over/underflow. -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE\ ALSO -im_remainder(3), im_multiply(3), im_subtract(3), im_lintra(3), im_add(3). -.SH COPYRIGHT -National Gallery, 1995 diff --git a/man/im_dup_dmask.3 b/man/im_dup_dmask.3 deleted file mode 100644 index 3b08512d..00000000 --- a/man/im_dup_dmask.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_create_dmask.3 diff --git a/man/im_dup_imask.3 b/man/im_dup_imask.3 deleted file mode 100644 index 3b08512d..00000000 --- a/man/im_dup_imask.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_create_dmask.3 diff --git a/man/im_embed.3 b/man/im_embed.3 deleted file mode 100644 index d09de3bf..00000000 --- a/man/im_embed.3 +++ /dev/null @@ -1,36 +0,0 @@ -.TH IM_EMBED 3 "11 April 1995" -.SH NAME -im_embed \- extract a portion of an image -.SH SYNOPSIS -.B #include - -int im_embed( in, out, type, x, y, w, h ) -.br -IMAGE *in, *out; -.br -int type; -.br -int x, y, w, h; - -.SH DESCRIPTION -im_embed() embeds in within a larger image (size w by h), with in's top -left-hand corner at position (x,y) within the output image. The value of type -controls what appears in the new pels. - - 0 - black pels (all bytes 0) - 1 - extend pels from image to edge - 2 - tile pels from image - 3 - mirror pels from image - 4 - white pels (all bytes 255) - -Works for any size image, any number of bands, any type. Works for LABPACK -coded images too. - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_insert(3), im_extract(3), im_region_region(3), im_fill_copy(3). -.SH COPYRIGHT -National Gallery, 1995. -.SH AUTHOR -J. Cupitt \- 11/04/1995 diff --git a/man/im_eor_vec.3 b/man/im_eor_vec.3 deleted file mode 100644 index dfcd881e..00000000 --- a/man/im_eor_vec.3 +++ /dev/null @@ -1,2 +0,0 @@ -.so man3/im_andimage.3 - diff --git a/man/im_eorconst.3 b/man/im_eorconst.3 deleted file mode 100644 index dfcd881e..00000000 --- a/man/im_eorconst.3 +++ /dev/null @@ -1,2 +0,0 @@ -.so man3/im_andimage.3 - diff --git a/man/im_eorimage.3 b/man/im_eorimage.3 deleted file mode 100644 index dfcd881e..00000000 --- a/man/im_eorimage.3 +++ /dev/null @@ -1,2 +0,0 @@ -.so man3/im_andimage.3 - diff --git a/man/im_equal.3 b/man/im_equal.3 deleted file mode 100644 index e953cda7..00000000 --- a/man/im_equal.3 +++ /dev/null @@ -1,141 +0,0 @@ -.TH RELATIONAL 3 "30 October 1992" -.SH NAME -im_equal, im_notequal, im_equalconst, im_equal_vec, im_notequalconst, -im_notequal_vec, im_less, im_lessconst, im_less_vec, -im_more, im_moreconst, im_more_vec, im_lesseq, im_lesseqconst, im_lesseq_vec, -im_moreeq, -im_moreeqconst, im_moreeq_vec \- relational tests on images. -.SH SYNOPSIS -.B #include - -.B int im_equal(a, b, out) -.br -.B IMAGE *a, *b, *out; - -.B int im_equalconst(a, out, c) -.br -.B IMAGE *a, *out; -.br -.B double c; - -.B int im_equal_vec(a, out, n, v) -.br -.B IMAGE *a, *out; -.br -.B int n; -.br -.B double *v; - -.B int im_notequal(a, b, out) -.br -.B IMAGE *a, *b, *out; - -.B int im_notequalconst(a, out, c) -.br -.B IMAGE *a, *out; -.br -.B double c; - -.B int im_notequal_vec(a, out, n, v) -.br -.B IMAGE *a, *out; -.br -.B int n; -.br -.B double *v; - -.B int im_less(a, b, out) -.br -.B IMAGE *a, *b, *out; - -.B int im_lessconst(a, out, c) -.br -.B IMAGE *a, *out; -.br -.B double c; - -.B int im_less_vec(a, out, n, v) -.br -.B IMAGE *a, *out; -.br -.B int n; -.br -.B double *v; - -.B int im_more(a, b, out) -.br -.B IMAGE *a, *b, *out; - -.B int im_moreconst(a, out, c) -.br -.B IMAGE *a, *out; -.br -.B double c; - -.B int im_more_vec(a, out, n, v) -.br -.B IMAGE *a, *out; -.br -.B int n; -.br -.B double *v; - -.B int im_lesseq(a, b, out) -.br -.B IMAGE *a, *b, *out; - -.B int im_lesseqconst(a, out, c) -.br -.B IMAGE *a, *out; -.br -.B double c; - -.B int im_lesseq_vec(a, out, n) -.br -.B IMAGE *a, *out; -.br -.B int n; -.br -.B double *v; - -.B int im_moreeq(a, b, out) -.br -.B IMAGE *a, *b, *out; - -.B int im_moreeqconst(a, out, c) -.br -.B IMAGE *a, *out; -.br -.B double c; - -.B int im_moreeq_vec(a, out, n, v) -.br -.B IMAGE *a, *out; -.br -.B int n; -.br -.B double *v; - -.SH DESCRIPTION -These functions perform a range of relational tests between images, or between -an image and a constant. Functions which take two images as arguments require -that the two images be the same size and have the same number of bands. They -can be of mixed type: you may compare an unsigned char image with a double -image. - -All functions return an unsigned char image, with the same number of bands as -the input images, in which band elements have been set to 255 for true and 0 -for false. - -The logical functions (im_andimage(3), im_orimage(3), im_eorimage(3)) may be -used to combine boolean images to make more complex tests. The selection -function im_ifthenelse(3) may be used to take action on the result of a test. - -.SH RETURN VALUE -All functions return 0 on success and -1 on error. -.SH SEE ALSO -im_ifthenelse(3), im_andimage(3). -.SH COPYRIGHT -National Gallery, 1992 -.SH AUTHOR -J. Cupitt diff --git a/man/im_equal_vec.3 b/man/im_equal_vec.3 deleted file mode 100644 index 141a819b..00000000 --- a/man/im_equal_vec.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_equal.3 diff --git a/man/im_equalconst.3 b/man/im_equalconst.3 deleted file mode 100644 index 141a819b..00000000 --- a/man/im_equalconst.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_equal.3 diff --git a/man/im_erode.3 b/man/im_erode.3 deleted file mode 100644 index 1fdf30e4..00000000 --- a/man/im_erode.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_dilate.3 diff --git a/man/im_erode_raw.3 b/man/im_erode_raw.3 deleted file mode 100644 index 1fdf30e4..00000000 --- a/man/im_erode_raw.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_dilate.3 diff --git a/man/im_error.3 b/man/im_error.3 deleted file mode 100644 index 71df1cb9..00000000 --- a/man/im_error.3 +++ /dev/null @@ -1,83 +0,0 @@ -.TH IM_ERRORMSG 3 "22 April 1991" -.SH NAME -im_error_buffer, im_verror, im_error, im_error_clear, im_warn, im_diag, -error_exit \- handle error messages from VIPS -.SH SYNOPSIS -.B #include - -.B const char *im_error_buffer( void ) - -.B void im_verror( const char *domain, const char *fmt, va_list ap ) - -.B void im_error( const char *domain, const char *fmt, ... ) - -.B void im_error_system( int errno, const char *domain, const char *fmt, ... ) - -.B void im_error_clear() - -.B void im_warn( const char *domain, const char *fmt, ... ) - -.B void im_diag( const char *domain, const char *fmt, ... ) - -.B void error_exit( const char *fmt, ... ) - -.SH DESCRIPTION -.B im_error(3) -formats its arguments as printf and appends the string, with a newline, to -the error buffer. The -.B domain -argument indicates the error source and should not be marked for translation. - -For example, the call: - - im_error( "mystuff", _( "bad argument %d" ), a ); - -might appear in the error buffer as: - - mystuff: bad argument 12 - -.B im_verror(3) -works exactly as -.B im_error(3) -but takes stdarg arguments. - -.B im_error_system(3) -works exactly as -.B im_error(3) -but additionally will translate and append a system error code. - -.B im_error_buffer(3) -returns a pointer to the start of the error buffer. - -.B im_error_clear(3) -empties the error buffer. - -.B error_exit(3) -formats its arguments as printf and sends the result to the error output, -together with the contents of the error log, before terminating with an error -status. - -.B im_warn(3) -works as -.B im_error(), -but output is sent to the list of warnings. - -If an environment variable IM_WARNING exists, messages are suppressed. -Warnings should be used for non-critical recoverable errors such as values -being clipped. - -.B im_diag(3) -works as -.B im_error(), -but output is sent to the list of diagnosic errors. - -If an environment variable IM_DIAGNOSTICS exists, messages are suppressed. -Diagnostics should be used to give extra feedback about the result of the -operation. -.SH SEE ALSO -error_exit(3), im_intro(3). -.SH COPYRIGHT -.br -Birkbeck College -.SH AUTHOR -N. Dessipris \- 22/04/1991 diff --git a/man/im_error_buffer.3 b/man/im_error_buffer.3 deleted file mode 100644 index 7db4b63b..00000000 --- a/man/im_error_buffer.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_error.3 diff --git a/man/im_error_clear.3 b/man/im_error_clear.3 deleted file mode 100644 index 7db4b63b..00000000 --- a/man/im_error_clear.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_error.3 diff --git a/man/im_exp10tra.3 b/man/im_exp10tra.3 deleted file mode 100644 index 6538cef4..00000000 --- a/man/im_exp10tra.3 +++ /dev/null @@ -1,100 +0,0 @@ -.TH IM_EXPTRA 3 "24 April 1991" -.SH NAME -im_exp10tra, im_exptra, im_expntra, im_expntra_vec, im_log10tra, im_logtra, -im_powtra, im_powtra_vec \- logarithmic, exponential and power transform of an image -.SH SYNOPSIS -.B #include - -.B int im_expntra(in, out, base) -.br -.B IMAGE *in, *out; -.br -.B double base; - -.B int im_expntra_vec(in, out, n, vec) -.br -.B IMAGE *in, *out; -.br -.B int n; -.br -.B double *vec; - -.B int im_exp10tra(in, out) -.br -.B IMAGE *in, *out; - -.B int im_exptra(in, out) -.br -.B IMAGE *in, *out; - -.B int im_log10tra(in, out) -.br -.B IMAGE *in, *out; - -.B int im_logtra(in, out) -.br -.B IMAGE *in, *out; - -.B int im_powtra(in, out, exponent) -.br -.B IMAGE *in, *out; -.br -.B double exponent; - -.B int im_powtra_vec(in, out, n, vec) -.br -.B IMAGE *in, *out; -.br -.B int n; -.br -.B double *vec; - -.SH DESCRIPTION -Each of the above functions maps in through a log or anti-log -function of some sort and writes the result to out. The size and number of -bands are unchanged, the output type is float, unless the input is double, in -which case the output is double. Non-complex images only! - -.B im_expntra(3) -transforms element x of input, to pow(base, x) in output. It detects division -by zero, setting those pixels to zero in the output. Beware: it does this -silently! - -.B im_expntra_vec(3) -works as im_expntra(), but lets you specify a constant per band. - -.B im_exp10tra(3) -transforms element x of input, to pow(10,0, x) in output. Internally, it is -defined in terms of im_expntra(). - -.B im_exptra(3) -transforms element x of input, to pow(e, x) in output, where e is the -mathematical constant. Internally, it is defined in terms of im_expntra(). - -.B im_log10tra(3) -transforms element x of input, to log10tra(x) in output. - -.B im_logtra(3) -transforms element x of input, to logtra(x) in output. - -.B im_powtra(3) -transforms element x of input, to pow(x, exponent) in output. It detects -division by zero, setting those pixels to zero in the output. Beware: it does -this silently! - -.B im_powtra_vec(3) -works as im_powtra(3), but lets you specify a constant per band. - -.SH BUGS -None of the functions checks for under/overflow. Overflow is very common for -many of these functions! - -.SH RETURN VALUE -Each function returns 0 on success and -1 on error. -.SH SEE ALSO -im_add(3), im_multiply(3), im_subtract(3), im_lintra(3), -im_absim(3), im_mean(3), im_max(3). -.SH AUTHOR -N. Dessipris \- 24/04/1991 -.br -J. Cupitt (rewrite) \- 21/7/93 diff --git a/man/im_expntra.3 b/man/im_expntra.3 deleted file mode 100644 index b7685e3d..00000000 --- a/man/im_expntra.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_exp10tra.3 diff --git a/man/im_expntra_vec.3 b/man/im_expntra_vec.3 deleted file mode 100644 index b7685e3d..00000000 --- a/man/im_expntra_vec.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_exp10tra.3 diff --git a/man/im_exptra.3 b/man/im_exptra.3 deleted file mode 100644 index b7685e3d..00000000 --- a/man/im_exptra.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_exp10tra.3 diff --git a/man/im_exr2vips.3 b/man/im_exr2vips.3 deleted file mode 100644 index 9f379039..00000000 --- a/man/im_exr2vips.3 +++ /dev/null @@ -1,17 +0,0 @@ -.TH IM_EXR 3 "3 Jan 2003" -.SH NAME -im_exr2vips \- convert OpenEXR images to VIPS format -.SH SYNOPSIS -#include - -int im_exr2vips( const char *filename, IMAGE *out ) - -.SH DESCRIPTION -.B im_exr2vips() -reads the OpenEXR image in filename, and writes the image out -in VIPS format. - -.SH SEE ALSO -im_open(3), im_vips2tiff(3) -.SH COPYRIGHT -Hey, you want this? You have it! diff --git a/man/im_extract.3 b/man/im_extract.3 deleted file mode 100644 index fe920239..00000000 --- a/man/im_extract.3 +++ /dev/null @@ -1,60 +0,0 @@ -.TH IM_EXTRACT 3 "11 April 1990" -.SH NAME -im_extract_areabands, im_extract_bands, im_extract_area \- extract a portion of an image -.SH SYNOPSIS -.B #include - -int im_extract_areabands( IMAGE *in, IMAGE *out, -.br - int left, int top, int width, int height, int band, int nbands ) - -int im_extract_area( IMAGE *in, IMAGE *out, -.br - int left, int top, int width, int height ) - -int im_extract_bands( IMAGE *in, IMAGE *out, -.br - int chsel, int nbands ) - -.SH DESCRIPTION -.B im_extract_areabands(3) -extracts the rectangular portion of the image defined by -.B left, -.B top, -.B width, -and -.B height of image -.B in -and writes the result to image -.B out. -The area must lie entirely within in the image. Selects the set of -.B nbands -bands -starting at band number -.B band -(numbering bands from zero). - -Works for any size image, any number of bands, any type. Works for LABPACK -coded images too! But disallows band extraction in this case. - -.B im_extract_area(3) -is a convenience function which extracts an area from an -image, leaving the bands the same. - -.B im_extract_bands(3) -takes -.B nbands -out of an image, starting from band -.B band. -So, for example, nbands == 2, bands == 1 will form a two band image from an RGB -image, where the two bands are the G and the B bands. - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_insert(3), im_lrjoin(3), im_lrmerge(3), im_stats(3), -im_region_region(3). -.SH COPYRIGHT -J. Cupitt, -.SH AUTHOR -J. Cupitt \- 11/04/1990 diff --git a/man/im_extract_area.3 b/man/im_extract_area.3 deleted file mode 100644 index 09e88df3..00000000 --- a/man/im_extract_area.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_extract.3 diff --git a/man/im_extract_areabands.3 b/man/im_extract_areabands.3 deleted file mode 100644 index 09e88df3..00000000 --- a/man/im_extract_areabands.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_extract.3 diff --git a/man/im_extract_bands.3 b/man/im_extract_bands.3 deleted file mode 100644 index 09e88df3..00000000 --- a/man/im_extract_bands.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_extract.3 diff --git a/man/im_eye.3 b/man/im_eye.3 deleted file mode 100644 index 33216d07..00000000 --- a/man/im_eye.3 +++ /dev/null @@ -1,47 +0,0 @@ -.TH IM_EYE 3 "10 May 1991" -.SH NAME -im_eye, im_feye \- creates a pattern which shows the spatial response of the human visual system -.SH SYNOPSIS -.B #include - -.B int im_eye(image, xsize, ysize, factor) -.br -.B IMAGE *image; -.br -.B int xsize, ysize; -.br -.B double factor; - -.B int im_feye(image, xsize, ysize, factor) -.br -.B IMAGE *image; -.br -.B int xsize, ysize; -.br -.B double factor; - -.SH DESCRIPTION -.B im_feye() -creates an one band float image with pels in [-1,+1] of a pattern which has -the following properties: -.br -- the spatial frequency increases from left to right. -.br -- the grey level intensity decreases from top to bottom. -.br -The sizes of the produced image are determined by the entered arguments -xsize and ysize. The variable factor which should be between 0 and 1, -determines the number of maximum spatial frequencies present along the -horizontal direction. - -.B im_eye() -behaves exactly as im_feye(), but scales the output to [0,255]. - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_grey(3), im_zone(3). -.SH COPYRIGHT -N. Dessipris -.SH AUTHOR -N. Dessipris \- 10/05/1991 diff --git a/man/im_falsecolour.3 b/man/im_falsecolour.3 deleted file mode 100644 index 1549752e..00000000 --- a/man/im_falsecolour.3 +++ /dev/null @@ -1,23 +0,0 @@ -.TH IM_FALSECOLOUR 3 "30 October 1992" -.SH NAME -im_falsecolour \- colour a mono image -.SH SYNOPSIS -.B #include - -.B int im_falsecolour(in, out) -.br -.B IMAGE *in, *out; - -.SH DESCRIPTION -Turns a one-band unsigned char image into a three band unsigned char image. -The colour scale is stolen from a PET scan and has red for hot, green for -normal and blue for cold. -.SH RETURN VALUE -0 on success and -1 on error. -.SH SEE ALSO -im_disp2XYZ(3), etc. -.SH COPYRIGHT -.br -National Gallery -.SH AUTHOR -J. Cupitt diff --git a/man/im_fastcor.3 b/man/im_fastcor.3 deleted file mode 100644 index 6d02e7ad..00000000 --- a/man/im_fastcor.3 +++ /dev/null @@ -1,67 +0,0 @@ -.TH IM_FASTCOR 3 "14 May 1991" -.SH NAME -im_fastcor, im_spcor \- correlate two images -.SH SYNOPSIS -.B #include - -.B int im_fastcor(in, ref, out) -.br -.B IMAGE *in, *ref, *out; - -.B int im_spcor(in, ref, out) -.br -.B IMAGE *in, *ref, *out; -.SH DESCRIPTION -These functions calculate spatial correlation between two -one-band images held -by the image descriptors -.B in -and -.B ref. -The sizes of -.B ref -should be smaller than -the sizes of -.B in. -The correlation is carried out by overlapping -.B ref -on the top -left corner of -.B in -and moving it over -.B in. - -The output image is the same size as the input. The edge pixels are calculated -by expanding the input image using -.B im_embed(3) -in mode 1 (replicating edge pixels) just enough so that the output can match -the input. - -.B im_spcor(3) -calculates the spatial correlation between -.B in -and -.B ref -using the -correlation coefficient from Niblack "An Introduction to Digital Image -Processing,", Prentice/Hall, pp 138. The resultant coefficients are written -as float numbers in -.B out. -The images must be char, short or ushort. - -.B im_fastcor(3) -simply returns the sum of squares of differences between -.B in -and -.B ref. -This is much faster, but less useful. The resultant coefficients are written -as unsigned int numbers in out which has a size of in. - -.SH BUGS -The functions do not check for integer overflow. -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_conv(3), im_lrmosaic(3). -.SH COPYRIGHT -The National Gallery and Birkbeck College, 1990-1997. diff --git a/man/im_fastline.3 b/man/im_fastline.3 deleted file mode 100644 index 24a57b00..00000000 --- a/man/im_fastline.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_paintrect.3 diff --git a/man/im_fastlineuser.3 b/man/im_fastlineuser.3 deleted file mode 100644 index 24a57b00..00000000 --- a/man/im_fastlineuser.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_paintrect.3 diff --git a/man/im_fav4.3 b/man/im_fav4.3 deleted file mode 100644 index a2af2034..00000000 --- a/man/im_fav4.3 +++ /dev/null @@ -1,23 +0,0 @@ -.TH IM_FAV4 3 "13 April 1992" -.SH NAME -im_fav4 \- averages four frames -.SH SYNOPSIS -.B #include - -.B int im_fav4(in, out) -.br -.B IMAGE **in, *out; -.SH DESCRIPTION -.B im_fav4 -averages four input VIPS images, which must be unsigned byte images with any -number of bands. This is useful for noise reduction by grabbing 4 frames -and averaging them. With 7 bit images this will give quite a convincing -eighth bit. -.SH RETURN VALUE -returns 0 on success or -1 on error -.SH SEE\ ALSO -add(1) -.SH COPYRIGHT -.br -K. Martinez 13/4/92 - diff --git a/man/im_feye.3 b/man/im_feye.3 deleted file mode 100644 index 0f1cc8cb..00000000 --- a/man/im_feye.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_eye.3 diff --git a/man/im_fgrey.3 b/man/im_fgrey.3 deleted file mode 100644 index af1bec37..00000000 --- a/man/im_fgrey.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_grey.3 diff --git a/man/im_fliphor.3 b/man/im_fliphor.3 deleted file mode 100644 index bf72dac4..00000000 --- a/man/im_fliphor.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_rot180.3 diff --git a/man/im_flipver.3 b/man/im_flipver.3 deleted file mode 100644 index bf72dac4..00000000 --- a/man/im_flipver.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_rot180.3 diff --git a/man/im_float2rad.3 b/man/im_float2rad.3 deleted file mode 100644 index b8c76698..00000000 --- a/man/im_float2rad.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_rad2float.3 diff --git a/man/im_flood.3 b/man/im_flood.3 deleted file mode 100644 index 87cc3fa5..00000000 --- a/man/im_flood.3 +++ /dev/null @@ -1,40 +0,0 @@ -.TH IM_FLOOD 3 "30 October 1992" -.SH NAME -im_flood, im_flood_blob \- flood a area -.SH SYNOPSIS -.B #include - -int im_flood( im, x, y, ink, dout ) -.br -IMAGE *im; -.br -int x, y; -.br -PEL *ink; -.br -Rect *dout; - -int im_flood_blob( im, x, y, ink, dout ) -.br -IMAGE *im; -.br -int x, y; -.br -PEL *ink; -.br -Rect *dout; - -.SH DESCRIPTION -.B im_flood() -fills an enclosed area from a starting point, painting ink into 4-way -connected pels whose colour is not equal to ink. - -.B im_flood_blob() -floods with the ink colour, finding pels 4-way connected to the start pel -which are the same colour as the start pel. It is useful for changing the -colour of a blob of pels which all have the same value. - -.SH RETURN VALUE -All functions return 0 on success and -1 on error. -.SH SEE ALSO -im_insertplace(3), im_smudge(3). diff --git a/man/im_flood_blob.3 b/man/im_flood_blob.3 deleted file mode 100644 index dac0a2ee..00000000 --- a/man/im_flood_blob.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_flood.3 diff --git a/man/im_floor.3 b/man/im_floor.3 deleted file mode 100644 index 79320b9e..00000000 --- a/man/im_floor.3 +++ /dev/null @@ -1,17 +0,0 @@ -.TH IM_FLOOR 3 "20 June 2002" -.SH NAME -im_floor \- for each pixel, find the largest integral value not greater than -.SH SYNOPSIS -#include - -int im_floor( in, out ) -.br -IMAGE *in, *out; -.SH DESCRIPTION -.B im_floor(3) -finds the largest integral value not greater than. Copy for integer types, -call floor(3) for float and complex types. Output type == input type. -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_abs(3), im_clip2fmt(3), im_ceil(3) diff --git a/man/im_flt_imag_freq.3 b/man/im_flt_imag_freq.3 deleted file mode 100644 index 3242a947..00000000 --- a/man/im_flt_imag_freq.3 +++ /dev/null @@ -1,27 +0,0 @@ -.TH IM_FMASKPROF 3 "8 Oct 1991" -.SH NAME -im_flt_imag_freq \- filter a square image in the frequency domain -.SH SYNOPSIS -#include - -int -.br -im_flt_imag_freq( IMAGE *in, IMAGE *out, int flag, double p1, ... ) - -.SH DESCRIPTION -im_flt_imag_freq() -filters an image in the frequency domain using a mask dictated by the flag -and the parameters p1, ... The mask is created by using the -function im_create_fmask(3). After creating the mask the program filters -the input image using the function im_freqflt(3). - -For details about the arguments refer to the function im_create_fmask(3). - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_freqflt(3). -.SH COPYRIGHT -N. Dessipris -.SH AUTHOR -N. Dessipris \- 10/08/1991 diff --git a/man/im_fractsurf.3 b/man/im_fractsurf.3 deleted file mode 100644 index 3fdeca34..00000000 --- a/man/im_fractsurf.3 +++ /dev/null @@ -1,29 +0,0 @@ -.TH IM_FRACTSURF 3 "10 May 1991" -.SH NAME -im_fractsurf \- creates a fractal surface -.SH SYNOPSIS -.B #include - -.B int im_fractsurf(in, frdim, size) -.br -.B IMAGE *in; -.br -.B double frdim; -.br -.B int size; -.SH DESCRIPTION -.B im_fractsurf -creates a fracta surface. The program initially creates a gaussian -noise image (im_gausnoise(3)) of sizes size x size. The image is then -filtered (im_flt_image_freq(3)) in order to force the power spectrum to -decay according to the desired fractal dimension frdim. The result is -a one band float image and should be scaled for display. -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE\ ALSO -im_flt_image_freq(3), im_gausnoise(3) -.SH COPYRIGHT -.br -N. Dessipris, -.SH AUTHOR -N. Dessipris \- 06/07/1990 diff --git a/man/im_free.3 b/man/im_free.3 deleted file mode 100644 index 0be9c41f..00000000 --- a/man/im_free.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_malloc.3 diff --git a/man/im_free_dmask.3 b/man/im_free_dmask.3 deleted file mode 100644 index 3b08512d..00000000 --- a/man/im_free_dmask.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_create_dmask.3 diff --git a/man/im_free_imask.3 b/man/im_free_imask.3 deleted file mode 100644 index 3b08512d..00000000 --- a/man/im_free_imask.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_create_dmask.3 diff --git a/man/im_freqflt.3 b/man/im_freqflt.3 deleted file mode 100644 index 5f6a5f41..00000000 --- a/man/im_freqflt.3 +++ /dev/null @@ -1,35 +0,0 @@ -.TH IM_FOURFLT 3 "10 May 1991" -.SH NAME -im_freqflt \- filters an image with a float filter mask in the frequency domain -.SH SYNOPSIS -.B #include - -.B int im_freqflt(in, filtermask, out) -.br -IMAGE *in, *filtermask, *out; -.SH DESCRIPTION -im_freqflt() performs filtering in the frequency domain of the input image -held by the image descriptor in with a mask held by the descriptor filtermask -and writes the result on the image descriptor out. - -Image sizes should be power of two and less or equal to 512. All images -should be one channel square images. Image filtermask is a non-complex one -channel image created by im_create_fmask(). Input image can be any type. If -input is complex, in and filtermask are multiplied using the function -im_cmultim(3). - -If input is not complex then it is transformed into the frequency domain and -then it is multiplied with the filtermask. In the latter case the result is -inverse fourier transformed and clipped to the input image format using the -function im_clip2fmt(3). -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH BUGS -The function has not been fully tested. -.SH SEE\ ALSO -im_fwfft(3), im_invfft(3), im_create_fmask(3), im_cmultim(3). -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 10/05/1991 diff --git a/man/im_fwfft.3 b/man/im_fwfft.3 deleted file mode 100644 index ba26cbeb..00000000 --- a/man/im_fwfft.3 +++ /dev/null @@ -1,60 +0,0 @@ -.TH IM_FWFFT 3 "14 May 1991" -.SH NAME -im_fwfft, im_invfft, im_invfftr \- forward and inverse fft on an image -.SH SYNOPSIS -.B #include - -.B int im_fwfft(in, out) -.br -.B IMAGE *in, *out; - -.B int im_invfft(in, out) -.br -.B IMAGE *in, *out; - -.B int im_invfftr(in, out) -.br -.B IMAGE *in, *out; - -.SH DESCRIPTION -.B im_fwfft() -performs a forward fast Fourier Transform on the image held by the -image descriptor in and writes the result to the image descriptor out. -The image can be in any format and have any number of bands. The output is -always complex. - -If VIPS has been built with support for libfftw, a high-speed FFT library, -then fftwnd_one() is used to compute the transform. This produces a double -precision complex result. The first transformation at a particular image -size will be very slow as libfftw optimises itself for your machine, -but subsequent transforms of images of that size are extremely fast. -Unfortunately, libfftw does not have good out-of-memory behaviour. If you -try to transform a very large image, your program will exit abruptly. - -If VIPS has not been built with libfftw support, VIPS uses its own fft -routines. These are rather slow, are single precision only, and can only -transform images whose sides are a power of two. - -.B im_invfft() -performs the reverse transform. -The input image must be complex, the output is always complex. The image may -have any number of bands. - -Again, if libfftw was present when VIPS was -compiled, that library is used to calculate the transform. - -.B im_invfftr() -performs the reverse transform. -The input image must be complex, the output is always real. The image may -have any number of bands. It is about 2 x faster than -.B im_invfft(). - -Again, if libfftw was present when VIPS was -compiled, that library is used to calculate the transform. - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_rotquad(3), im_c2ps(3), im_scaleps(3), im_disp_ps(3). -.SH COPYRIGHT -1995, National Gallery and Birkbeck College diff --git a/man/im_fzone.3 b/man/im_fzone.3 deleted file mode 100644 index 4d100b95..00000000 --- a/man/im_fzone.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_zone.3 diff --git a/man/im_gadd.3 b/man/im_gadd.3 deleted file mode 100644 index 295df09e..00000000 --- a/man/im_gadd.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_add.3 diff --git a/man/im_gaddim.3 b/man/im_gaddim.3 deleted file mode 100644 index 295df09e..00000000 --- a/man/im_gaddim.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_add.3 diff --git a/man/im_gammacorrect.3 b/man/im_gammacorrect.3 deleted file mode 100644 index ca4a8fa5..00000000 --- a/man/im_gammacorrect.3 +++ /dev/null @@ -1,24 +0,0 @@ -.TH GAMMA 3 "10 May 1991" -.SH NAME -im_gammacorrect \- carry out gamma correction -.SH SYNOPSIS -#include - -int im_gammacorrect(in, out, exponent) -.br -IMAGE *in, *out; -.br -double exponent; - -.SH DESCRIPTION -im_gammacorrect performs gamma correction to in. The result in written in out. -The correction is carried out by creating a lookup table using the double -exponent and mapping in through it. The exponent is applied on a ramp lut and -the resultant lut is scaled. All channels of im are mapped through the lookup -table. -.SH SEE ALSO -im_histgr(3), im_heq(3), im_histeq(3), im_identity(3), im_maplut(3) -.SH COPYRIGHT -N. Dessipris -.SH AUTHOR -N. Dessipris \- 10/05/1991 diff --git a/man/im_gauss_dmask.3 b/man/im_gauss_dmask.3 deleted file mode 100644 index e22e257b..00000000 --- a/man/im_gauss_dmask.3 +++ /dev/null @@ -1,63 +0,0 @@ -.TH GAUSS_MASKS 3 "6 December 1991" -.SH NAME -im_gauss_dmask, im_gauss_imask \- create a gaussian DOUBLEMASK or INTMASK -.SH SYNOPSIS -.B #include - -.B DOUBLEMASK im_gauss_dmask( name, sigma, min_amplitude ) -.br -char *name; -.br -double sigma, min_amplitude; - -.B INTMASK im_gauss_imask( name, sigma, min_amplitude ) -.br -char *name; -.br -double sigma, min_amplitude; - -.B INTMASK im_gauss_imask_sep( name, sigma, min_amplitude ) -.br -char *name; -.br -double sigma, min_amplitude; - -.SH DESCRIPTION -Both functions create a circularly symmetric Gaussian mask of sigma. The size -of the mask is determined by the variable min_amplitude; if for instance the -value .1 is entered this means that the produced mask is clipped at values -less than 10 percent of the maximum amplitude. -The mask can be directly used with the vasari convolution -programs, the default offset set is 0. - -The program uses the following equation: - - H(r) = exp( -(r * r) / (2 * sigma * sigma) ). - -The generated mask has odd size and its maximum value is normalised to -either 100 (gauss_imask) or to 1.0 (gauss_dmask). - -.B im_gauss_dmask(3) -creates a DOUBLEMASK laplacian of Gaussian mask with maximum value normalised -to 1.0. - -.B im_gauss_imask(3) -creates a INTMASK laplacian of Gaussian mask with maximum value normalised -to 100. - -.B im_gauss_imask_sep(3) -returns the centre line of -.B im_gauss_imask(3). -It is convenient for use with -.B im_conv_sep(3) -for building fast gaussian blur or sharpen. - -.SH RETURNED VALUE: -The functions return NULL on erorr. -.SH SEE ALSO -im_log_dmask(3), im_conv(3), im_conv_sep(3). -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 06/12/1991 diff --git a/man/im_gauss_imask.3 b/man/im_gauss_imask.3 deleted file mode 100644 index dca741eb..00000000 --- a/man/im_gauss_imask.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_gauss_dmask.3 diff --git a/man/im_gauss_imask_sep.3 b/man/im_gauss_imask_sep.3 deleted file mode 100644 index dca741eb..00000000 --- a/man/im_gauss_imask_sep.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_gauss_dmask.3 diff --git a/man/im_gaussnoise.3 b/man/im_gaussnoise.3 deleted file mode 100644 index a7b05c24..00000000 --- a/man/im_gaussnoise.3 +++ /dev/null @@ -1,27 +0,0 @@ -.TH IM_GAUSNOISE 3 "10 May 1991" -.SH NAME -im_gaussnoise \- creates a gaussian noisy picture -.SH SYNOPSIS -#include - -int im_gaussnoise(image, xsize, ysize, mean, sigma) -.br -IMAGE *image; -.br -int xsize, ysize; -.br -double mean, sigma; - -.SH DESCRIPTION -im_gaussnoise() creates a float one band gaussian noise picture of size xsize -by ysize. The created image has mean mean and square root of variance equal -to sigma. The noise is generated by averaging 12 random numbers. - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_grey(3), im_addgnoise(3). -.SH COPYRIGHT -N. Dessipris -.SH AUTHOR -N. Dessipris \- 10/05/1991 diff --git a/man/im_gbandjoin.3 b/man/im_gbandjoin.3 deleted file mode 100644 index 15713fe8..00000000 --- a/man/im_gbandjoin.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_bandjoin.3 diff --git a/man/im_generate.3 b/man/im_generate.3 deleted file mode 100644 index 44da8482..00000000 --- a/man/im_generate.3 +++ /dev/null @@ -1,214 +0,0 @@ -.TH IM_GENERATE 3 "11 April 1993" -.SH NAME -im_generate, im_start_one, im_stop_one, im_allocate_input_array, -im_start_many, im_stop_many \- generate image pixels -.SH SYNOPSIS -.B #include - -void *im_start_one( out, in ) -.br -IMAGE *out, *in; - -int im_stop_one( reg ) -.br -REGION *reg; - -IMAGE **im_allocate_input_array( IMAGE *out, ... ) - -void *im_start_many( out, in ) -.br -IMAGE *out, **in; - -int im_stop_many( REGION **out ) -.br -REGION **out; - -int im_generate( im, - start_fn, gen_fn, stop_fn, void *a, void *b ) -.br -IMAGE *im; -.br -void *(*start_fn)(); -.br -int (*gen_fn)(); -.br -int (*stop_fn)(); -.br -void *a, void *b; - -where, typically, - -void *start_fn( im, a, b ) -.br -IMAGE *im; -.br -void *a, *b; - -int gen_fn( or, seq, a, b ) -.br -REGION *or; -.br -void *seq; -.br -void *a, *b; - -int stop_fn( seq, a, b ) -.br -void *seq; -.br -void *a, *b; -.SH DESCRIPTION -.B im_generate(3), -with its supporting convenience functions, is used for -PIO image output. See also -.B im_wrapone(3) -for an easy alternative to -.B im_generate(3) -for simple image -processing operations. - -.B im_start_one(3) -and -.B im_stop_one(3) -are convenience functions, useful for -simple one-image-in, one-image-out operations. -.B im_start_one(3) -assumes the -first of the two user arguments (a, above) is the input image. It creates a -REGION on this image and returns a pointer to the region as a sequence value. - -.B im_stop_one(3) -assumes the sequence value is a REGION pointer, and frees it. - -.B im_allocate_input_array(3) -takes as arguments the output image and a list of -input images, terminated with a NULL. It allocates a NULL-terminated array to -hold the images, and attaches a close callback to the output image to free -that array. Example: - - IMAGE *in, *in2, *in3, *in4; - IMAGE **arry; - - if( !(arry = im_allocate_input_array( out, - in1, in2, in3, in4, NULL )) ) - return( -1 ); - -builds the structure - - IMAGE *arry[] = { in1, in2, in3, in4, NULL }; - -and makes sure it will be freed. - -.B im_start_many(3) -and -.B im_stop_many(3) -work exactly as -.B im_start_one(3) -and -.B im_stop_one(3), -but with NULL-terminated arrays of IMAGEs and REGIONs. -They are useful for many-images-in, one-image-out operations. -.B im_start_many(3) -assumes that the first of the two user arguments is a pointer -to a NULL-terminates array of IMAGEs. It builds and returns as the sequence -value a NULL-terminated array of REGIONs. - -.B im_stop_many(3) -assumes the sequence value is a pointer to a NULL-terminated -array of REGIONs. It frees all the regions in turn. See -.B im_add(3) -for an -example of this pair of functions in action. - -.B im_generate(3) -looks at the type of im and acts accordingly: - - IM_PARTIAL: the start, process and stop functions are attached to the -region, and im_generate returns immediately. See -.B im_prepare(3). - - IM_SETBUF: memory for the output image is created and sequences -started to fill it. It is an error to write to the same buffer twice. - - IM_MMAPINRW: sequences are started, and asked to fill the image in patches. - - IM_OPENOUT: The output file is created and a header written to disc. A -buffer -large enough to hold GENERATE_TILE_HEIGHT complete horizontal lines is -created, and sequences started to fill this buffer. When the buffer has been -filled, the whole set of lines are flushed to disc in a single write(2) -operation, and work starts on the next set of lines. - -Any other image type is an error. -.B im_generate(3) -returns 0 for complete -success, and non-zero on failure. - - static int - wombat_gen( or, ir, in ) - REGION *or, *ir; - IMAGE *in; - { - ... process! - - return( 0 ); - } - - int - im_wombat( in, out ) - IMAGE *in, *out; - { - if( im_iocheck( in, out ) ) - return( -1 ); - - ... check parametersm check image descriptors - ... for type-compatibility, etc. etc. - - if( im_cp_desc( out, in ) ) - return( -1 ); - - ... set fields in out for the type of image you - ... wish to write - - if( im_generate( out, - im_start_one, wombat_gen, im_stop_one, - in, NULL ) ) - return( -1 ); - - return( 0 ); - } - -See also the source to -.B im_invert(3), -.B im_exptra(3), -and, if you are brave, -.B im_conv(3) -or -.B im_add(3). - -On machines with several CPUs, -.B im_generate(3) -and -.B im_iterate(3) -automatically parallelise programs. You can set the desired -concurrency level with the environment variable IM_CONCURRENCY, for example - - example% export IM_CONCURRENCY=2 - example% lintra 2.0 fred.v 0.0 fred2.v - -will run lintra with enough concurrency to keep 2 CPUs fully occupied. -If IM_CONCURRENCY is not set, then it defaults to 1. See also -im_concurrency_set(3). - -Most programs which use VIPS will also let you use the command-line argument ---vips-concurrency to set parallelisation, see im_get_option_group(3). - -.SH COPYRIGHT -National Gallery, 1993 -.SH SEE ALSO -im_wrapone(3), im_add_eval_callback(3), im_iterate(3), im_piocheck(3), -im_concurrency_set(3), -im_get_option_group(3), -`VIPS manual,' in accompanying documentation. -.SH AUTHOR -J. Cupitt \- 23/7/93 diff --git a/man/im_get_option_group.3 b/man/im_get_option_group.3 deleted file mode 100644 index 73c527a0..00000000 --- a/man/im_get_option_group.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_init_world.3 diff --git a/man/im_gfadd.3 b/man/im_gfadd.3 deleted file mode 100644 index 295df09e..00000000 --- a/man/im_gfadd.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_add.3 diff --git a/man/im_glds_asm.3 b/man/im_glds_asm.3 deleted file mode 100644 index 141a819b..00000000 --- a/man/im_glds_asm.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_equal.3 diff --git a/man/im_glds_contrast.3 b/man/im_glds_contrast.3 deleted file mode 100644 index 141a819b..00000000 --- a/man/im_glds_contrast.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_equal.3 diff --git a/man/im_glds_entropy.3 b/man/im_glds_entropy.3 deleted file mode 100644 index 141a819b..00000000 --- a/man/im_glds_entropy.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_equal.3 diff --git a/man/im_glds_matrix.3 b/man/im_glds_matrix.3 deleted file mode 100644 index 2f3aaf4f..00000000 --- a/man/im_glds_matrix.3 +++ /dev/null @@ -1,78 +0,0 @@ -.TH IM_SGLDS_MATRIX 3 "10 May 1991" -.SH NAME -im_glds_matrix, im_glds_asm, im_glds_contrast, im_glds_mean, im_glds_entropy \- calculate the spatial grey level difference matrix and features on it -.SH SYNOPSIS -.B #include - -int im_glds_matrix(im, m, xp, yp, xs, ys, dx, dy) -.br -.B IMAGE *im, *m; -.br -.B int xp, yp, xs, ys; -.br -.B int dx, dy; - -.B int im_glds_asm(m, asmoment) -.br -.B IMAGE *m; -.br -.B double *asmoment; - -.B int im_glds_contrast(m, contrast) -.br -.B IMAGE *m; -.br -.B double *contrast; - -.B int im_glds_entropy(m, entropy) -.br -.B IMAGE *m; -.br -.B double *entropy; - -.B int im_glds_mean(m, mean) -.br -.B IMAGE *m; -.br -.B double *mean; - -.SH DESCRIPTION -.B im_glds_matrix() -creates a 256 by 1 one channel spatial grey level difference matrix (sglds) of -the box determined by the parameters (xp, yp; xs, ys) within the image pointed -by the IMAGE descriptor im. The matrix is written onto the IMAGE descriptor -m. The displacement vector is determined by (dx, dy). The user must ensure -that there is enough border pixels around the box within im dictated by the -displacement vector (dx,dy) or else the program fails. im should be one-band -unsigned char. - -All entries of the sgld matrix are double normalised to the number of pairs -involved. This function is a direct implementation of the paper: Haralick R. -M., Shanmugan K. and Dinstein I., 'Textural features for image -classification', IEEE Transactions on Systems, Man, and Cybernetics, Vol. -SMC-3, No 6, Nov. 1973, pp 610-621. - -.B im_glds_asm() -calculates the angular second moment of the co-occurrence matrix held by m. -The result is returned into the location pointed by asmoment. - -.B im_glds_contrast() -calculates the contrast of the sglds matrix held by m. The result is returned -into the location pointed by contrast. - -.B im_glds_entropy() -calculates the entropy of the sglds matrix held by m. The result is returned -into the location pointed by entropy. - -.B im_glds_mean() -calculates the mean of the sglds matrix held by m. The result is returned -into the location pointed by mean. -.SH RETURNED VALUES -All functions returns 0 on success and -1 on error. -.SH SEE\ ALSO -im_cooc_matrix(3) -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 10/05/1991 diff --git a/man/im_glds_mean.3 b/man/im_glds_mean.3 deleted file mode 100644 index 141a819b..00000000 --- a/man/im_glds_mean.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_equal.3 diff --git a/man/im_global_balance.3 b/man/im_global_balance.3 deleted file mode 100644 index adb5edb4..00000000 --- a/man/im_global_balance.3 +++ /dev/null @@ -1,53 +0,0 @@ -.TH IM_GLOBAL_BALANCE 3 "13 May 1991" -.SH NAME -im_global_balance, im_global_balancef \- perform global mosaic balancing on -an image -.SH SYNOPSIS -#include - -int -.br -im_global_balance( IMAGE *in, IMAGE *out, double gamma ) - -int -.br -im_global_balance_float( IMAGE *in, IMAGE *out, double gamma ) - -.SH DESCRIPTION -These functions takes an image assembled with the mosaicing functions -(im_*merge*(), im_*mosaic*()), take it apart, and reassemble it, globally -optimising the image balance. This is useful for assembling image mosaics -from sources where the exposure is uncontrolled and may vary from tile to tile ---- such as video, or photographic sources. - -The function finds a set of factors, one for each of the input images, and -scales each image by its factor before reassembling. The factors are chosen so -as to minimise the average grey-level difference between neighboring images at -their overlaps. Trivial overlaps (where the width and height of the overlap -are both less than 20 pixels) are ignored. - -The gamma parameter is the gamma of the image input system. It is used during -brightness adjustment. Set to 1.0 to disable gamma, to 1.6 for a typical IR -vidicon camera, or 2.3 for a typical video camera. - -It relies on information left by the mosaicing functions in ".desc" files. If -the ".desc" file of the input image has been corrupted, or is strangely -complicated, or if any of the original input images have been moved or -deleted, the function can fail. - -The function will fail for mosaics larger than about 7 by 7 frames, since it -will run out of file descriptors (UNIX sets a limit of 256 per process). To -balance larger mosaics, just assemble them in 7x7 sections, balancing and -saving each part in turn, before loading, assembling and balancing the final -image. The function can also fail if there are significant mosaicing errors. - -im_global_balancef() works as im_global_balance(), but outputs a float -rather than a uchar image. This lets you adjust the range of the image -manually, if the automatically-found scales are causing burn-out. - -.SH RETURN VALUE -All functions return 0 on success and -1 on error. -.SH SEE ALSO -im_lrmerge(3), im_lrmosaic(3). -.SH COPYRIGHT -Birkbeck College and the National Gallery, 1991 - 1995. diff --git a/man/im_global_balance_float.3 b/man/im_global_balance_float.3 deleted file mode 100644 index a0cd72cc..00000000 --- a/man/im_global_balance_float.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_global_balance.3 diff --git a/man/im_grad_x.3 b/man/im_grad_x.3 deleted file mode 100644 index fa786859..00000000 --- a/man/im_grad_x.3 +++ /dev/null @@ -1,29 +0,0 @@ -.TH IM_GRAD_X 3 "08 January 2008" -.SH NAME - im_grad_x, im_grad_y \- find horizontal or vertical differences -.SH SYNOPSIS -.nf -.B #include -.sp -.BI "int im_grad_x( IMAGE " "*in" ", IMAGE " "*out" " ); -.br - -.BI "int im_grad_y( IMAGE " "*in" ", IMAGE " "*out" " ); -.fi -.SH DESCRIPTION -.B im_grad_x(3) -generates an image where the value of each pixel is the difference between horizontally ajacent pixels in the input -image. The output has the same height as the input and one pixel less width. -.PP -.B im_grad_y(3) -generates an image where the value of each pixel is the difference between vertically ajacent pixels in the input -image. The output has the same width as the input and one pixel less height. -.PP -In both cases, the input can be any uncoded integer type, and the output is signed 32 bit integer. -.SH RETURN VALUE -The functions returns 0 on success and -1 on error. -.SH COPYRIGHT -.br -Copyright 2008, Nottingham Trent University. -.SH AUTHOR -Tom Vajzovic diff --git a/man/im_grad_y.3 b/man/im_grad_y.3 deleted file mode 100644 index f7dc71d4..00000000 --- a/man/im_grad_y.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_grad_x.3 diff --git a/man/im_gradcor.3 b/man/im_gradcor.3 deleted file mode 100644 index e22eb0f2..00000000 --- a/man/im_gradcor.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_fastcor.3 diff --git a/man/im_gradient.3 b/man/im_gradient.3 deleted file mode 100644 index 5f146a90..00000000 --- a/man/im_gradient.3 +++ /dev/null @@ -1,2 +0,0 @@ -.so man3/im_compass.3 - diff --git a/man/im_grey.3 b/man/im_grey.3 deleted file mode 100644 index 1c9af7c5..00000000 --- a/man/im_grey.3 +++ /dev/null @@ -1,46 +0,0 @@ -.TH IM_GREY 3 "10 May 1991" -.SH NAME -im_grey, im_fgrey, im_make_xy \- creates a grey scale -.SH SYNOPSIS -.B #include - -.B int im_grey( image, xsize, ysize ) -.br -.B IMAGE *image; -.br -.B int xsize, ysize; - -.B int im_fgrey( image, xsize, ysize ) -.br -.B IMAGE *image; -.br -.B int xsize, ysize; - -.B int im_make_xy( image, xsize, ysize ) -.br -.B IMAGE *image; -.br -.B int xsize, ysize; - -.SH DESCRIPTION -.B im_grey(3) -creates a one-band FMTUCHAR grey scale image of sizes xsize by -ysize. The intensity varies from 0 (left) to 255 (right). - -.B im_fgrey(3) -works as -.B im_grey(3), -except that the output image is FMTFLOAT, -allowing pixel values from 0 (left) to 1.0 (right). - -.B im_make_xy(3) -makes a two-band FMTUINT image where each pixel in band 0 has a value equal to -the x coordinate, and each pixel in band 1 has a value equal to the y -coordinate. - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_black(3) -.SH COPYRIGHT -Birkbeck College and the National Gallery, 1995 diff --git a/man/im_grid.3 b/man/im_grid.3 deleted file mode 100644 index f3597c00..00000000 --- a/man/im_grid.3 +++ /dev/null @@ -1,42 +0,0 @@ -.TH IM_GRID 3 "4 August 2005" -.SH NAME -im_grid \- split a vertical image into a grid of smaller images -.SH SYNOPSIS -.B #include - -int -.br -im_grid( IMAGE *in, IMAGE *out, -.br - int tile_height, int across, int down ) -.SH DESCRIPTION -.B im_grid(3) -slices image -.B in -into a set of tiles, each the same width as -.B in -and of height -.B tile_height -and rearranges the tiles into a grid with -.B across -tiles across and -.B down -tiles down. - -It is useful for loading volumetric images (for example, CT or PET scans) -where more than 2 dimensions need to be displayed. - -The current implementation is optimised for the case where image -.B in -is thin and tall and -.B across -and -.B down -are large. - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_extract_area(3), im_zoom(3) -.SH COPYRIGHT -Imperial College 2005 diff --git a/man/im_guess_libdir.3 b/man/im_guess_libdir.3 deleted file mode 100644 index cc35252a..00000000 --- a/man/im_guess_libdir.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_guess_prefix.3 diff --git a/man/im_guess_prefix.3 b/man/im_guess_prefix.3 deleted file mode 100644 index bdc334f3..00000000 --- a/man/im_guess_prefix.3 +++ /dev/null @@ -1,38 +0,0 @@ -.TH IM_VIPSHOME 3 "8 March 2001" -.SH NAME -im_guess_prefix, im_guess_libdir \- try to guess install directory -.SH SYNOPSIS -.B #include - -.B const char *im_guess_prefix( const char *argv0, -.B const char *env_name ) - -.B const char *im_guess_libdir( const char *argv0, -.B const char *env_name ) - -.SH DESCRIPTION -.B im_guess_prefix(3) -tries to guess the install directory. You should pass in the value of -argv[0] (the name your program was run as) as a clue to help it out, plus -the name of the environment variable you let the user override your package -install area with (eg. "VIPSHOME"). - -On success, -.B im_guess_prefix(3) -returns the prefix it discovered, and as a side effect, sets the environment -variable (if it's not set). - -.B im_guess_prefix(3) -is useful for programs in the VIPS distribution and contrib which need to be -able to find data files. - -Don't free the return string! - -.B im_guess_libdir(3) -works exactly as -.B im_guess_prefix(3) -but, if vips has not been moved since configure, returns the libdir configure -setting. If vips has been moved, it returns prefix/lib. - -.SH RETURN VALUE -The function returns NULL on failure. diff --git a/man/im_header.3 b/man/im_header.3 deleted file mode 100644 index 88c4a435..00000000 --- a/man/im_header.3 +++ /dev/null @@ -1,57 +0,0 @@ -.TH IM_HEADER 3 "7 May 2002" -.SH NAME -im_header_int, im_header_double, im_header_string, im_header_get, -im_header_get_type, im_header_map \- read fields from the image header -.SH SYNOPSIS -#include - -int im_header_int( IMAGE *image, const char *field, int *out ) -.br -int im_header_double( IMAGE *image, const char *field, double *out ) -.br -int im_header_string( IMAGE *image, const char *field, char **out ) -.br -GType im_header_get_type( IMAGE *im, const char *field ); -.br -int im_header_get( IMAGE *im, const char *field, GValue *value_copy ); -.br -typedef void *(*im_header_map_fn)( IMAGE *, - const char *, GValue *, void *, void * ); -.br -void *im_header_map( IMAGE *im, - im_header_map_fn fn, void *a, void *b ); - -.SH DESCRIPTION -.B im_header_int(3) -reads the value of an integer header field. These are -"Xsize", "Ysize", "Bands", "Bbits", "BandFmt", "Coding", and "Type", or any -integer meta field. - -.B im_header_double(3) -reads the value of the integer header fields. These are -"Xres", and "Yres", or any double meta field. - -.B im_header_string(3) -reads the value of the integer header fields. These are -"Hist", and "filename" or any string meta field. - -.B im_header_get_type(3) -returns the GType (eg. G_TYPE_INT) for a field. It returns zero if the field -does not exist. It does not set -.B im_error(3), -so it's useful for test for a field's existence. - -.B im_header_get(3) -fills the GValue with a copy of the field value, if the field exists. The -value should be zeroed but otherwise uninitialised. The value should be unset -once the user has finished with it. - -.B im_header_map(3) -maps a function over all header fields, presenting the value of each field as -a GValue. Return non-NULL from the map function to stop iteration early. It -maps over the builtin fields first, then any meta fields. - -.SH RETURN VALUE -All functions returns 0 on success and -1 on error. -.SH SEE ALSO -im_close(3), im_open(3). diff --git a/man/im_header_double.3 b/man/im_header_double.3 deleted file mode 100644 index eec90686..00000000 --- a/man/im_header_double.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_header.3 diff --git a/man/im_header_get.3 b/man/im_header_get.3 deleted file mode 100644 index eec90686..00000000 --- a/man/im_header_get.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_header.3 diff --git a/man/im_header_get_type.3 b/man/im_header_get_type.3 deleted file mode 100644 index eec90686..00000000 --- a/man/im_header_get_type.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_header.3 diff --git a/man/im_header_int.3 b/man/im_header_int.3 deleted file mode 100644 index eec90686..00000000 --- a/man/im_header_int.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_header.3 diff --git a/man/im_header_map.3 b/man/im_header_map.3 deleted file mode 100644 index eec90686..00000000 --- a/man/im_header_map.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_header.3 diff --git a/man/im_header_string.3 b/man/im_header_string.3 deleted file mode 100644 index eec90686..00000000 --- a/man/im_header_string.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_header.3 diff --git a/man/im_heq.3 b/man/im_heq.3 deleted file mode 100644 index 19f4481e..00000000 --- a/man/im_heq.3 +++ /dev/null @@ -1,57 +0,0 @@ -.TH IM_HEQ 3 "10 May 1991" -.SH NAME -im_heq, im_lhisteq, im_lhisteq_raw, im_hsp \- process an image using grey level transformations -.SH SYNOPSIS -#include - -int im_heq( in, out, bandno ) -.br -IMAGE *in, *out; -.br -int bandno; - -int im_lhisteq( in, out, xw, yw ) -.br -IMAGE *in, *out; -.br -int xw, yw; - -int im_hsp( in, ref, out ) -.br -IMAGE *in, *ref, *out; - -.SH DESCRIPTION -.B im_heq(3) -histogram equalises the unsigned char image held by the IMAGE descriptor -in. The result is written to the IMAGE descriptor out. -If bandno is -1 then all input bands are equalised independently. In all -other cases the input image is equalised using the histogram of bandno only. -The latter processing produces better results. - -.B im_hsp(3) -maps in to out with histogram specified by the ref. All images should be -unsigned char. Each band of the output image is specified according to the -distribution of grey levels of the reference image according to -im_histspec(3). - -.B im_lhisteq(3) -histogram equalises the one channel unsigned char image pointed to by the -Image descriptor in. The result is written to the IMAGE descriptor out. -The histogram equalisation is based on a window of size xw by yw centered at -the current location of each input pixel. - -In the manner of -.B im_conv(3) -the input image is expanded so that the output image is the same size as the -input. - -.B im_lhisteq_raw(3) -is as above, but does not expand the input. - -.SH RETURN VALUE -All functions returns 0 on success and -1 on error. -.SH SEE ALSO -im_histgr(3), im_histplot(3), im_histspec(3), im_lineprof(3), -im_stdif(3). -.SH COPYRIGHT -1991--1996 The National Gallery and Birkbeck College diff --git a/man/im_hist.3 b/man/im_hist.3 deleted file mode 100644 index 32170a06..00000000 --- a/man/im_hist.3 +++ /dev/null @@ -1,36 +0,0 @@ -.TH IM_HIST 3 "10 May 1991" -.SH NAME -im_hist \- create a displayable histogram from an image -.SH SYNOPSIS -.B #include - -.B int im_hist( in, plotofhist, bandno ) -.br -.B IMAGE *in, *plotofhist; -.br -.B int bandno; -.SH DESCRIPTION -.B im_hist() -creates a displayable histogram file for the image held by the image -descriptor -.B in. -The created displayable histogram is held in the IMAGE -descriptor -.B plotofhist. -If -.B bandno -== -1 a displayable histogram of all input bands -is created else the histogram of bandno only is created. - -See -.B im_histplot(3) -for rules on the size and scaling og the result. - -.SH RETURN VALUE -All functions returns 0 on success and -1 on error. -.SH SEE\ ALSO -im_histgr(3), im_histplot(3). -.SH COPYRIGHT -N. Dessipris -.SH AUTHOR -N. Dessipris \- 10/05/1991 diff --git a/man/im_histcum.3 b/man/im_histcum.3 deleted file mode 100644 index 44ba7c26..00000000 --- a/man/im_histcum.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_histgr.3 diff --git a/man/im_histeq.3 b/man/im_histeq.3 deleted file mode 100644 index 44ba7c26..00000000 --- a/man/im_histeq.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_histgr.3 diff --git a/man/im_histgr.3 b/man/im_histgr.3 deleted file mode 100644 index 8bb4d067..00000000 --- a/man/im_histgr.3 +++ /dev/null @@ -1,142 +0,0 @@ -.TH IM_HISTGR 3 "10 May 1991" -.SH NAME -im_histcum, -im_histeq, -im_histgr, -im_histnD, -im_histnorm, -im_histspec, -im_identity, -im_identity_ushort, -im_ismonotonic -\- create, display and process histograms or luts -.SH SYNOPSIS -#include - -int im_histgr( in, out, bandno ) -.br -IMAGE *in, *out; -.br -int bandno; - -int im_histnD( in, out, bins ) -.br -IMAGE *in, *out; -.br -int bins; - -int im_histcum(hist, lut) -.br -IMAGE *hist, *lut; - -int im_histnorm(hist, lut) -.br -IMAGE *hist, *lut; - -int im_histeq(hist, lut) -.br -IMAGE *hist, *lut; - -int im_histspec(histin, histref, lut) -.br -IMAGE *histin, *histref, *lut; - -int im_identity(lut, bands) -.br -IMAGE *lut; -.br -int bands; - -int im_identity_ushort(lut, bands, sz) -.br -IMAGE *lut; -.br -int bands; -.br -int sz; - -int im_ismonotonic( IMAGE *lut, int *out ) - -.SH DESCRIPTION -.B im_histgr(3) -writes the histogram of image in to image out. If bandno is -1, -then out will have the same number of bands as in, and each band of out will -have the histogram of the corresponding band of in. Otherwise, bandno selects -the band of the image for which the histogram will be found, numbering from -zero. - -Image in may be either FMTUCHAR or FMTUSHORT. If in is uchar, then out will -have 256 elements, one for each possible pixel value. If in is ushort, then -.B im_histgr(3) -finds the maximum of in, and outputs a histogram with max + 1 -elements. - -For example, suppose you have an image from a 12-bit camera, where -each pixel is in the range [0,4095]. Calling -.B im_histgr(3) -for this image will -make a histogram with at most 4096 elements. If the histogram is smaller than -this, then it means that the right hand end of the histogram was all zero, and -has not been generated. - -Also check -.B im_histnD(3) -below for another way to make histograms. - -.B im_histnD(3) -makes a n-dimensional histogram from an n-band image (1, 2 and 3 bands only). -Because 3D histograms can get very large very quickly, the -.B bins -parameter sets the length of each dimension, that is, the number of bins the -possible numeric range of the image is divided into. - -Unsigned 8 and 16 bit images only. - -Use -.B im_histplot(3) -to graph the histogram for visualisation. See the separate manpage. - -.B im_histcum(3) -forms a cumulative histogram. - -.B im_histnorm(3) -normalises a histogram. The maximum histogram value becomes equal to the -number of pixels in the histogram. In effect, the histogram -becomes 'square'. Each channel is normalised separately. - -.B im_histeq(3) -takes as input a histogram held by the IMAGE descriptor hist and creates an -unsigned char look up table (held by the IMAGE descriptor lut) which when -applied on the original image, (with histogram held by hist) histogram -equalises it. Histogram equalisation is carried out for each band of hist -individually. - -.B im_histspec(3) -creates a lut for transforming an image with histogram held by histin -according to the pdf (probability density function) of a reference image with -histogram held by histref. histin and histref should have the same number -of bands. - -.B im_identity(3) -creates an look-up-table with Xsize=256, Ysize=1, Bands=bands, Bbits=BBBYTE, -BandFmt=FMTUCHAR, Type=LUT, which is held by the IMAGE descriptor lut. The -created image consist a bands linear (ramp) lut and is the basis for building -look-up tables. - -.B im_identity_ushort(3) -creates an look-up-table with Xsize=sz, Ysize=1, Bands=bands, Bbits=BBSHORT, -BandFmt=FMTUSHORT, Type=LUT, which is held by the IMAGE descriptor lut. The -created image consist of a linear (ramp) lut and is the basis for building -look-up tables. - -.B im_ismonotonic(3) -sets out to non-zero if the look-up table (or histogram) in lut is monotonic, -that is, if it's slope is always >0. - -.SH RETURN VALUE -All functions return 0 on success and -1 on error. -.SH SEE ALSO -im_hist(3), im_hsp(3), im_heq(3), im_maplut(3), im_tone_map(3), -im_histplot(3). -.SH COPYRIGHT -The National Gallery and Birkbeck College, 1991 \- 1994. diff --git a/man/im_histlin.3 b/man/im_histlin.3 deleted file mode 100644 index cd5bc3e0..00000000 --- a/man/im_histlin.3 +++ /dev/null @@ -1,34 +0,0 @@ -.TH IM_HISTORY 3 "22 April 1991" -.SH NAME -im_histlin, im_updatehist, im_history_get \- manage image history -.SH SYNOPSIS -.B #include - -int im_histlin( IMAGE *im, const char *fmt, ... ); -.br -int im_updatehist( IMAGE *out, const char *name, int argc, char *argv[] ); -.br -const char *im_history_get( IMAGE *im ); - -.br -.SH DESCRIPTION -.B im_histlin(3) -formats its arguments as printf(3), appends " # time-and-date", and appends -the whole line of text to the image history. The string is typically the -command-line action that would be required to do whatever it is that you've -just done to the image. - -.B im_updatehist(3) -is given a standard argc/argv, formats them appropriately, and calls -im_histlin(3) for you. Note that the program name is passed separately. - -.B im_history_get(3) -returns the entire history of an image as a single C string, one action per -line. No need to free, but you mustn't modify either. - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_cp_desc(3). -.SH COPYRIGHT -Imperial College, London, 2007. diff --git a/man/im_histnD.3 b/man/im_histnD.3 deleted file mode 100644 index 44ba7c26..00000000 --- a/man/im_histnD.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_histgr.3 diff --git a/man/im_histnorm.3 b/man/im_histnorm.3 deleted file mode 100644 index 44ba7c26..00000000 --- a/man/im_histnorm.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_histgr.3 diff --git a/man/im_history_get.3 b/man/im_history_get.3 deleted file mode 100644 index d421d4b0..00000000 --- a/man/im_history_get.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_histlin.3 diff --git a/man/im_histplot.3 b/man/im_histplot.3 deleted file mode 100644 index 121995eb..00000000 --- a/man/im_histplot.3 +++ /dev/null @@ -1,47 +0,0 @@ -.TH IM_HISTPLOT 3 "10 May 1991" -.SH NAME -im_histplot \- graph an image of one horizontal or vertical line -.SH SYNOPSIS -#include - -int im_histplot(in, out) -.br -IMAGE *in, *out; - -.SH DESCRIPTION -.B im_histplot(3) -plots a graph of a horizontal or vertical image file with -one line. It is suitable for displaying the output of histogram functions -such as im_histgr(3) and for displaying line profiles. - -Note that if you try to directly plot the result of -.B im_histgr(3) -you will often get a very, very large image, since -.B im_histplot(3) -will draw an image as high (or as wide) as the largest pixel -value in the image (potentially huge). Use -.B im_histnorm(3) -to normalise the histogram maximum before plotting. - -The input image should be either one horizontal line (Ysize=1) or -one vertical line (Xsize=1). If the image is FMTUCHAR, the graph is drawn -as 256 by line-length pixels. For all other unsigned integer types, -.B im_histplot(3) -finds the image maximum, and draws the graph as max by line-length pixels. - -For signed integer types, -.B im_histplot(3) -finds minimum and maximum, moves min up to zero, and -draws the graph as min + max by line-lenth pixels. - -For float types, -.B im_histplot(3) -finds minimum and maximum, and scales the image range so as to make the -graph square. - -.SH RETURNED VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_histgr(3), im_histnorm(3), im_extract(3). -.SH COPYRIGHT -National Gallery and Birkbeck College, 1995 diff --git a/man/im_histspec.3 b/man/im_histspec.3 deleted file mode 100644 index 44ba7c26..00000000 --- a/man/im_histspec.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_histgr.3 diff --git a/man/im_hsp.3 b/man/im_hsp.3 deleted file mode 100644 index 0d4a60ee..00000000 --- a/man/im_hsp.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_heq.3 diff --git a/man/im_icc_ac2rc.3 b/man/im_icc_ac2rc.3 deleted file mode 100644 index 4e5ea9dc..00000000 --- a/man/im_icc_ac2rc.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_icc_transform.3 diff --git a/man/im_icc_export.3 b/man/im_icc_export.3 deleted file mode 100644 index 4e5ea9dc..00000000 --- a/man/im_icc_export.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_icc_transform.3 diff --git a/man/im_icc_export_depth.3 b/man/im_icc_export_depth.3 deleted file mode 100644 index 4e5ea9dc..00000000 --- a/man/im_icc_export_depth.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_icc_transform.3 diff --git a/man/im_icc_import.3 b/man/im_icc_import.3 deleted file mode 100644 index 4e5ea9dc..00000000 --- a/man/im_icc_import.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_icc_transform.3 diff --git a/man/im_icc_import_embedded.3 b/man/im_icc_import_embedded.3 deleted file mode 100644 index 4e5ea9dc..00000000 --- a/man/im_icc_import_embedded.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_icc_transform.3 diff --git a/man/im_icc_present.3 b/man/im_icc_present.3 deleted file mode 100644 index 4e5ea9dc..00000000 --- a/man/im_icc_present.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_icc_transform.3 diff --git a/man/im_icc_transform.3 b/man/im_icc_transform.3 deleted file mode 100644 index c473febe..00000000 --- a/man/im_icc_transform.3 +++ /dev/null @@ -1,116 +0,0 @@ -.TH IM_ICC_*() 3 "April 2002" -.SH NAME -im_icc_present, im_icc_transform, im_icc_import, im_icc_import_embedded, -im_icc_export, -im_icc_export_depth \- transform images using ICC profiles -.SH SYNOPSIS -#include - -#define VIPS_INTENT_PERCEPTUAL (0) -.br -#define VIPS_INTENT_RELATIVE_COLORIMETRIC (1) -.br -#define VIPS_INTENT_SATURATION (2) -.br -#define VIPS_INTENT_ABSOLUTE_COLORIMETRIC (3) - -int -.br -im_icc_present( void ) -.br -int -.br -im_icc_transform( IMAGE *in, IMAGE *out, -.br - const char *input_profile_filename, -.br - const char *output_profile_filename, -.br - int intent ) - -int -.br -im_icc_import( IMAGE *in, IMAGE *out, -.br - const char *input_profile_filename, int intent ) - -int -.br -im_icc_import_embedded( IMAGE *in, IMAGE *out, -.br - int intent ) - -int -.br -im_icc_export_depth( IMAGE *in, IMAGE *out, int depth, -.br - const char *output_profile_filename, int intent ) - -int -.br -im_icc_export( IMAGE *in, IMAGE *out, -.br - const char *output_profile_filename, int intent ) - -int -.br -im_icc_ac2rc( IMAGE *in, IMAGE *out, -.br - const char *profile_filename ) - -.SH DESCRIPTION -.B im_icc_present(3) -returns non-zero if there is an ICC library available. Calls to the other -VIPS ICC functions will all fail with an error message if there is no library. - -.B im_icc_transform(3) -maps between two images using an input and output profile and an intent. The -input image must have a format matching the input profile (eg. 4 bands for a -CMYK profile). The output image will have a form matching the output profile -(eg. 3 bands for an RGB output profile). The input image must be 8 or 16 bit -unsigned integer. The output image is always 8 bit unsigned int. The output -profile is attached to the output image under the name -.B "icc-profile-data". -Functions like -.B im_vips2jpeg(3) -will then attach the profile to the files they create. - -.B im_icc_import(3) -takes an image to D50 Lab float (profile interconnect space) from device space. -The input image must match the format expected by the profile: for example, a -printer profile will usually need 4 band CMYK data. The input image must be 8 -or 16 bit unsigned integer. - -.B im_icc_import_embedded(3) -takes an image to D50 Lab float (profile interconnect space) from device -space, using the profile embedded in the image. If there is no embedded -profile, an error is returned. Test for the presence of a profile with -.B im_header_get_type(3). - -.B im_icc_export_depth(3) -takes an image from D50 Lab float back to device space. The output image will -match the format of the profile: for example, a screen profile will write 3 -band RGB data. The output image biut depth can be set to 8 or 16 with the -depth parameter. The profile is attached to the output image under -the name -.B "icc-profile-data". -Functions like -.B im_vips2jpeg(3) -will then attach the profile to the files they create. - -.B im_icc_export(3) -behaves just as -.B im_icc_export_depth(), -but with depth always 8 bit. - -.B im_icc_ac2rc(3) -converts an image from D50 absolute to media relative colorimetry using the -media white point found in the ICC profile. - -.SH RETURN VALUE -The functions return 0 on success and -1 on error. -.SH SEE ALSO -im_LabQ2Lab(3), im_Lab2XYZ(3). -.SH COPYRIGHT -The National Gallery - diff --git a/man/im_identity.3 b/man/im_identity.3 deleted file mode 100644 index 44ba7c26..00000000 --- a/man/im_identity.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_histgr.3 diff --git a/man/im_identity_ushort.3 b/man/im_identity_ushort.3 deleted file mode 100644 index 44ba7c26..00000000 --- a/man/im_identity_ushort.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_histgr.3 diff --git a/man/im_ifthenelse.3 b/man/im_ifthenelse.3 deleted file mode 100644 index 38c07e11..00000000 --- a/man/im_ifthenelse.3 +++ /dev/null @@ -1,39 +0,0 @@ -.TH IM_IFTHENELSE 3 "30 October 1992" -.SH NAME -im_ifthenelse \- use an unsigned char image to join two images together -.SH SYNOPSIS -.B #include - -.B int im_ifthenelse(c, a, b, out) -.br -.B IMAGE *c, *a, *b, *out; - -.B int im_blend(c, a, b, out) -.br -.B IMAGE *c, *a, *b, *out; - -.SH DESCRIPTION -.B im_ifthenelse -builds an output image which uses some pels from a and some from b: if the -conditional image c is non-zero at that point, the pel comes from a; if it -is zero, the pel comes from b. - -The conditional image c can have either 1 band, in which case entire pels -come either from a or b, or n bands, where n is the number of bands in both a -and b, in which case individual band elements are chosen from a and b. - -Images a and b must match in size, type and number of bands. - -.B im_blend(3) -works just as im_ifthenelse(3), except that instead of selecting between a and -b, values in the condition image are used to softly blend between the two. 255 -means a only, 0 means b only, 128 means 50:50. - -.SH RETURN VALUE -0 on success and -1 on error. -.SH SEE ALSO -im_equal(3), im_and(3). -.SH COPYRIGHT -National Gallery -.SH AUTHOR -J. Cupitt diff --git a/man/im_image.3 b/man/im_image.3 deleted file mode 100644 index 597a5913..00000000 --- a/man/im_image.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_binfile.3 diff --git a/man/im_image_sanity.3 b/man/im_image_sanity.3 deleted file mode 100644 index a7e29bb7..00000000 --- a/man/im_image_sanity.3 +++ /dev/null @@ -1,19 +0,0 @@ -.TH IM_IMAGE_SANITY 3 "Feb 2001" -.SH NAME -im_image_sanity \- check image descriptors for sanity -.SH SYNOPSIS -.B #include - -int im_image_sanity( IMAGE *im ) - -.SH DESCRIPTION -.B im_image_sanity(3) -performs a few simple checks on the IMAGE for bad fields. If it finds a -problem it prints a warning message and returns -1. - -It is called from various places within VIPS to try to catch errors early. - -.SH RETURN VALUE -All functions returns 0 on success and -1 on error. -.SH SEE\ ALSO -im_incheck(3). diff --git a/man/im_incheck.3 b/man/im_incheck.3 deleted file mode 100644 index e0092c33..00000000 --- a/man/im_incheck.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_iocheck.3 diff --git a/man/im_init.3 b/man/im_init.3 deleted file mode 100644 index df1539fe..00000000 --- a/man/im_init.3 +++ /dev/null @@ -1,22 +0,0 @@ -.TH IM_INIT 3 "11 April 1990" -.SH NAME -im_init \- make an IMAGE descriptor -.SH SYNOPSIS -#include - -IMAGE *im_init( char *filename ) -.SH DESCRIPTION -im_init(3) allocates space for an IMAGE descriptor, sets all fields to -initial values, and returns the descriptor. A copy is made of the filename -argument. The IMAGE returned by im_init(3) should be passed to im_close(3) to -free it. - -This function is used internally by VIPS and should not be called by users. -.SH SEE ALSO -im_mmapin(3), im_openin(3), im_setbuf(3), im_close(3). -.SH COPYRIGHT -Birkbeck College and the National Gallery (c) 1994 -.SH AUTHOR -N. Dessipris \- 11/04/1990 -.br -J.Cupitt \- 23/2/94 diff --git a/man/im_init_world.3 b/man/im_init_world.3 deleted file mode 100644 index 2b266a28..00000000 --- a/man/im_init_world.3 +++ /dev/null @@ -1,47 +0,0 @@ -.TH IM_INIT_WORLD 3 "11 April 1990" -.SH NAME -im_init_world, im_get_option_group \- start up VIPS -.SH SYNOPSIS -#include - -int im_init_world( const char *argv0 ) -.br -GOptionGroup *im_get_option_group( void ); -.SH DESCRIPTION -.B im_init_world(3) -starts up the VIPS library. It: - - - initialises any libraries that VIPS is using, including GObject - - starts up the threading system - - guesses where the VIPS data files are and sets up i18n - - loads any plugins from libdir/vips-x.x - -The -.B argv0 -argument is the value of -.B argv[0] -your program was passed by the host operating system. VIPS uses this with -.B im_guess_prefix(3) -to try to find the various VIPS data files. - -.SH EXAMPLE - - int - main( int argc, char **argv ) - { - if( im_init_world( argv[0] ) ) - error_exit( "unable to start VIPS" ); - - return( 0 ); - } - -.B im_get_option_group(3) -returns a -.B GOptionGroup -containing various VIPS command-line options. It can be used with GOption to -help parse argc/argv. - -.SH SEE ALSO -im_guess_prefix(3), im_guess_libdir(3), GOption(3) -.SH COPYRIGHT -Birkbeck College and the National Gallery (c) 1994 diff --git a/man/im_initdesc.3 b/man/im_initdesc.3 deleted file mode 100644 index a531cf32..00000000 --- a/man/im_initdesc.3 +++ /dev/null @@ -1,45 +0,0 @@ -.TH IM_INITDESC 3 "22 April 1991" -.SH NAME -im_initdesc \- initialises an image descriptor to specific values -.SH SYNOPSIS -#include - -void im_initdesc( IMAGE *image, - int xsize, int ysize, - int bands, int bandbits, int bandfmt, - int coding, int type, - float xres, float yres, - float xo, float yo ) -.SH DESCRIPTION -.B im_initdesc(3) -initialises the image descriptor according to the entered values. -More specifically the Xsize, Ysize, Bands, BandFmt, Coding, Type, -Xres, Yres, Xoffset and Yoffset members of the descriptor are initialised by the -correspondingly entered arguments. The members fd, baseaddr, data and -filename are not handled by this function. The order of the args is -the same as in vips/vips.h. - -The -.B bandbits -parameter is deprecated and ignored by this function: you can always pass zero. - -Example: make a 512 by 512 one-band memory buffer. - - if( !(im = im_open( "temp", "t" )) ) - /* Error ... - im_initdesc( im, - 512, 512, - 1, 0, FMTUCHAR, - NOCODING, B_W, - 1.0, 1.0, - 0, 0 ); - if( im_setupout( im ) ) - /* Error ... - -.SH ALSO -im_open(3), im_setupout(3). -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 22/04/1991 diff --git a/man/im_insert.3 b/man/im_insert.3 deleted file mode 100644 index 7b4e69b6..00000000 --- a/man/im_insert.3 +++ /dev/null @@ -1,29 +0,0 @@ -.TH IM_INSERT 3 "11 April 1990" -.SH NAME -im_insert \- insert one image into another -.SH SYNOPSIS -#include - -int im_insert(in, ins, out, x, y) -.br -IMAGE *in, *insub, *out; -.br -int x, y; -.SH DESCRIPTION -im_insert() -inserts one image into another. ins is inserted into image in at -position x, y relative to the top left hand corner of in. out is made large -enough to hold all of both in and ins. Any areas of out not coming from -either in or ins are set to black (binary 0). If ins overlaps in, -ins -will appear on top of in. Both images must have the same number of -bands and the same BandFmt. -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE\ ALSO -im_extract(3), im_lrjoin(3), im_lrmerge(3) -.SH COPYRIGHT -.br -J. Cupitt, -.SH AUTHOR -J. Cupitt \- 11/04/1990 diff --git a/man/im_insertplace.3 b/man/im_insertplace.3 deleted file mode 100644 index c3cb9dba..00000000 --- a/man/im_insertplace.3 +++ /dev/null @@ -1,27 +0,0 @@ -.TH IM_INSERTPLACE 3 "30 October 1992" -.SH NAME -im_insertplace \- paste small images into big images -.SH SYNOPSIS -.B #include - -im_insertplace( big, small, x, y ) -.br -IMAGE *big, *small; -.br -int x, y; - -.SH DESCRIPTION -Paste image small into image big, with small's left-left-hand corner at (x,y) -in image big. Image big must be large enough to hold all of small! No -clipping. Images may have any type, but must both have the same type. - -This is an in-place operation. Big is damaged! Careful. -.SH RETURN VALUE -All functions return 0 on success and -1 on error. -.SH SEE\ ALSO -im_fastline(3), im_smudge(3). -.SH COPYRIGHT -.br -National Gallery, 1992 -.SH AUTHOR -J. Cupitt diff --git a/man/im_invalidate.3 b/man/im_invalidate.3 deleted file mode 100644 index 94cb0156..00000000 --- a/man/im_invalidate.3 +++ /dev/null @@ -1,19 +0,0 @@ -.TH IM_INVALIDATE 3 "5 December 2006" -.SH NAME -im_invalidate \- flush caches related to an image -.SH SYNOPSIS -.B #include - -.B void im_invalidate( IMAGE *im ) - -.SH DESCRIPTION -.B im_invalidate(3) -marks all caches related to the image as invalid and requring recalculation. -It needs to be called if an image changes after being made: for example, after -a paint action, or perhaps after a new frame has arrived from a video source. - -Any invalidate callbacks registered on any of the affected images are -triggered. - -.SH SEE\ ALSO -im_prepare(3), im_region_buffer(3), im_add_invalidate_callback(3). diff --git a/man/im_invert.3 b/man/im_invert.3 deleted file mode 100644 index dbe092ed..00000000 --- a/man/im_invert.3 +++ /dev/null @@ -1,24 +0,0 @@ -.TH IM_INVERT 3 "11 April 1990" -.SH NAME -im_invert \- inverts an image pointed by an image descriptor. -.SH SYNOPSIS -.B #include - -.B int im_invert(in, out) -.br -.B IMAGE *in, *out; -.SH DESCRIPTION -.B im_invert -inverts the image held by image descriptor in and writes the result on the -image descriptor out. The function works on FMTUCHAR images only. -The result at point x of the input image is 255-x at the output image. -Input can have any no of channels. -.br - This is not a generally useful program -- it is included as an example of a -very simple new-style IO function. Feel the power of the source, Luke! -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE\ ALSO -im_add(3), im_lintra(3), im_multiply(3). -.SH AUTHOR -J. Cupitt \- 21/7/93 diff --git a/man/im_invertlut.3 b/man/im_invertlut.3 deleted file mode 100644 index e1719ca0..00000000 --- a/man/im_invertlut.3 +++ /dev/null @@ -1,41 +0,0 @@ -.TH IM_INVERTLUT 3 "June 2001" -.SH NAME -im_invertlut \- turn a set of greyscale measurements into a gamma-correcting -LUT -.SH SYNOPSIS -#include - -int -.br -im_invertlut( DOUBLEMASK *input, IMAGE *output, int lut_size ) - -.SH DESCRIPTION -Given a mask of target values and real values, generate a LUT which -will map reals to targets. Handy for linearising images from -measurements of a colour chart. All values in [0,1]. -Extrapolate head and tail to 0 and 1. - -Eg. input like: - - 4 3 - 0.1 0.2 0.3 0.1 - 0.2 0.4 0.4 0.2 - 0.7 0.5 0.6 0.3 - -means a patch with 10% reflectance produces an image with 20% in -channel 1, 30% in channel 2, and 10% in channel 3. A patch with 20% -reflectance makes an image with 40% red, 40% green and 20% blue, and so on. - -Inputs don't need to be sorted (we do that). Generate any precision -LUT ... typically ask for 256 elements. - -It won't work too well for non-monotonic camera responses (should fix this). - -Interpolation is simple piecewise linear; ought to do something better really. - -.SH RETURN VALUE --1 on error, otherwise 0 -.SH SEE ALSO -im_histgr(3), im_hsp(3), im_heq(3), im_identity(3). -.SH COPYRIGHT -2001, National Gallery diff --git a/man/im_invfft.3 b/man/im_invfft.3 deleted file mode 100644 index 1111213f..00000000 --- a/man/im_invfft.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_fwfft.3 diff --git a/man/im_invfftr.3 b/man/im_invfftr.3 deleted file mode 100644 index 1111213f..00000000 --- a/man/im_invfftr.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_fwfft.3 diff --git a/man/im_iocheck.3 b/man/im_iocheck.3 deleted file mode 100644 index 921fa570..00000000 --- a/man/im_iocheck.3 +++ /dev/null @@ -1,50 +0,0 @@ -.TH IM_IOCHECK 3 "11 April 1990" -.SH NAME -im_incheck, im_outcheck, im_iocheck \- checks image descriptors -for WIO -.SH SYNOPSIS -.B #include - -int im_incheck( in ) -.br -IMAGE *in; - -int im_outcheck( out ) -.br -IMAGE *out; - -.B int im_iocheck( in, out) -.br -.B IMAGE *in, *out; - -.SH DESCRIPTION -im_incheck(3) -checks that an image descriptor is suitable for WIO input (ie. all of -its pels can be found from im\-\>data). If possible, it transforms the -descriptor to make WIO input ok using the following rules: - -IM_PARTIAL: the descriptor is magically turned into an IM_SETBUF descriptor. -Memory is allocated and the image generated into that. The old partial -callbacks are closed down, and the descriptor reformed as a IM_SETBUF. - -IM_OPENOUT: if the descriptor has been written to, it is automatically -`rewound,` that is, it is closed and reopened as an IM_MMAPIN descriptor. - -IM_SETBUF: just checks that the descriptor has been written to. - -See the manual page for im_setupout(3) for a skeleton program. - -im_outcheck(3) checks that a descriptor is suitable for WIO output with -im_writeline(3). If it sees an IM_PARTIAL image, it turns it magically into an -IM_SETBUF image. - -im_iocheck(3) simply calls in_incheck(3) for image in and im_outcheck(3) for -image out. -.SH RETURN VALUE -All functions returns 0 on success and -1 on error. -.SH SEE\ ALSO -im_open(3), im_cp_desc(3), im_setupout(3), im_makerw(3). -.SH COPYRIGHT -National Gallery -.SH AUTHOR -J. Cupitt \- 23/7/93 diff --git a/man/im_isMSBfirst.3 b/man/im_isMSBfirst.3 deleted file mode 100644 index 31d449ad..00000000 --- a/man/im_isMSBfirst.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_iscomplex.3 diff --git a/man/im_iscomplex.3 b/man/im_iscomplex.3 deleted file mode 100644 index df3d8dd3..00000000 --- a/man/im_iscomplex.3 +++ /dev/null @@ -1,91 +0,0 @@ -.TH IM_ISINT 3 "11 April 1990" -.SH NAME -im_isint, im_isuint, im_isfloat, im_isscalar, im_iscomplex, -im_isfile, im_ispartial, im_isvips, im_isMSBfirst, -im_fexists, im_amiMSBfirst \- classify image types -.SH SYNOPSIS -.B #include - -int im_isMSBfirst( im ) -.br -IMAGE *im; - -int im_amiMSBfirst( void ) - -int im_fexists( const char *filename, ... ) - -int im_isvips( filename ) -.br -char *filename; - -int im_isfile( im ) -.br -IMAGE *im; - -int im_ispartial( im ) -.br -IMAGE *im; - -int im_isint( im ) -.br -IMAGE *im; - -int im_isuint( im ) -.br -IMAGE *im; - -int im_isfloat( im ) -.br -IMAGE *im; - -int im_isscalar( im ) -.br -IMAGE *im; - -int im_iscomplex( im ) -.br -IMAGE *im; - -.SH DESCRIPTION -im_fexists(3) returns non-zero if the named file exists and is readable. Args -as printf(3). - -im_isvips(3) tests a file for vips-ness. - -im_isMSBfirst(3) returns true (1) if the file is in most-significant-byte first -form. This is the byte order used on the SPARC architecture, and others. It -returns false (0)for intel-order images. - -im_amiMSBfirst(3) returns true (1) if this processor is MSB first. - -im_isfile(3) returns true if the descriptor corresponds to some disc object, -that is, was opened with modes "r", "rw" or "w". - -im_ispartial(3) returns true if the descriptor is partial, -that is, was opened with mode "p". - -The rest of these functions test im\-\>BandFmt, returning logical truth -(non-zero) if BandFmt is one of a number of possibles, and returning zero if -it is not. - -im_isint(3) (is integer type) returns true if im\-\>BandFmt is one of FMTUCHAR, -FMTCHAR, FMTUSHORT, FMTSHORT, FMTUINT or FMTINT. - -im_isuint(3) (is unsigned integer type) returns true if im\-\>BandFmt is one of -FMTUCHAR, FMTUSHORT or FMTUINT. - -im_isfloat(3) (is floating point type) returns true if im\-\>BandFmt is one of -FMTFLOAT or FMTDOUBLE. - -im_isscalar(3) (is scalar type) returns true if im\-\>BandFmt is one of FMTUCHAR, -FMTCHAR, FMTUSHORT, FMTSHORT, FMTUINT, FMTINT, FMTFLOAT or FMTDOUBLE. - -im_iscomplex(3) (is complex type) returns true if im\-\>BandFmt is one of -FMTCOMPLEX or FMTDPCOMPLEX. - -.SH COPYRIGHT -National Gallery, 1993 -.SH SEE ALSO -im_tiff2vips(3), im_jpeg2vips(3) -.SH AUTHOR -J. Cupitt \- 23/7/93 diff --git a/man/im_isfile.3 b/man/im_isfile.3 deleted file mode 100644 index 31d449ad..00000000 --- a/man/im_isfile.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_iscomplex.3 diff --git a/man/im_isfloat.3 b/man/im_isfloat.3 deleted file mode 100644 index 31d449ad..00000000 --- a/man/im_isfloat.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_iscomplex.3 diff --git a/man/im_isint.3 b/man/im_isint.3 deleted file mode 100644 index 31d449ad..00000000 --- a/man/im_isint.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_iscomplex.3 diff --git a/man/im_ispartial.3 b/man/im_ispartial.3 deleted file mode 100644 index 31d449ad..00000000 --- a/man/im_ispartial.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_iscomplex.3 diff --git a/man/im_isscalar.3 b/man/im_isscalar.3 deleted file mode 100644 index 31d449ad..00000000 --- a/man/im_isscalar.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_iscomplex.3 diff --git a/man/im_isuint.3 b/man/im_isuint.3 deleted file mode 100644 index 31d449ad..00000000 --- a/man/im_isuint.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_iscomplex.3 diff --git a/man/im_isvips.3 b/man/im_isvips.3 deleted file mode 100644 index 31d449ad..00000000 --- a/man/im_isvips.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_iscomplex.3 diff --git a/man/im_iterate.3 b/man/im_iterate.3 deleted file mode 100644 index d777ce73..00000000 --- a/man/im_iterate.3 +++ /dev/null @@ -1,70 +0,0 @@ -.TH IM_ITERATE 3 "30 October 1992" -.SH NAME -im_iterate \- PIO input from image -.SH SYNOPSIS -.B #include - -int im_iterate( im, start_fn, scan_fn, stop_fn, a, b ) -.br -IMAGE *im; -.br -void *(*start_fn)(); -.br -int (*scan_fn)(); -.br -int (*stop_fn)(); -.br -void *a, *b; - -where, typically, - -void *start_fn( im, a, b ) -.br -IMAGE *im; -.br -void *a, *b; - -int scan_fn( or, seq, a, b ) -.br -REGION *or; -.br -void *seq; -.br -void *a, *b; - -int stop_fn( seq, a, b ) -.br -void *seq; -.br -void *a, *b; -.SH DESCRIPTION -im_iterate(3) is used for PIO image input. See `VIPS Library Programmers' -guide,' in the accompanying documentation, for an introduction to this -function. - -im_iterate(3) makes one or more regions on im, and starts one or more sequences -running over the image. im_iterate(3) guarantees that - - - scan_fn() will see each of the pels in im exactly once - - start_fn() and stop_fn() are both exclusive - -See the guide, the man page for im_generate(3), and the source to im_deviate(3) -for examples. - -On machines with SVR4 threads and several CPUs, im_generate(3) and -im_iterate(3) automatically parallelise programs. You can set the desired -concurrency level with the environment variable IM_CONCURRENCY, for example - - example% setenv IM_CONCURRENCY 2 - example% stats fred.v - -will run stats with enough concurrency to keep 2 CPUs fully occupied. -If IM_CONCURRENCY is not set, then it defaults to 1. -.SH RETURN VALUE -All functions return 0 on success and non-zero on error. -.SH SEE ALSO -im_generate(3). -.SH COPYRIGHT -National Gallery, 1993 -.SH AUTHOR -J. Cupitt \- 23/7/93 diff --git a/man/im_jpeg2vips.3 b/man/im_jpeg2vips.3 deleted file mode 100644 index a4131c66..00000000 --- a/man/im_jpeg2vips.3 +++ /dev/null @@ -1,86 +0,0 @@ -.TH IM_JPEG2VIPS 3 "6 June 1994" -.SH NAME -im_jpeg2vips, im_vips2jpeg, im_vips2bufjpeg, im_vips2mimejpeg \- convert JPEG images to and from VIPS format -.SH SYNOPSIS -#include - -int im_jpeg2vips( char *filename, IMAGE *out ) - -int im_vips2jpeg( IMAGE *in, char *filename ) - -int im_vips2bufjpeg( IMAGE *in, IMAGE *base, char **obuf, int *olen ) - -int im_vips2mimejpeg( IMAGE *in ) - -.SH DESCRIPTION -.B im_jpeg2vips(3) -reads the named jpeg file and writes it to the specified -IMAGE. The entire image is read before returning. It can read most 8-bit JPEG -images, including CMYK. - -You can embed options in the filename. They have the form: - - filename.jpg:, - -.B shrink-factor -will shrink the image by that factor during read. Allowed values are 1, 2, 4 -and 8. Shrinking during read is very much faster than decompressing the whole -image and then shrinking. Example: - - fred.jpg:8 - -will return fred.jpg shrink by a factor of 8. - -.B fail -makes the JPEG reader fail on any warnings. This can be useful for detecting -truncated files, for example. Normally reading these produces a warning, but -no fatal error. Example: - - fred.jpg:,fail - -will read fred.jpg, failing with a fatal error if the file has been truncated. - -Any embedded ICC profiles are ignored: you always just get the RGB from the -file. Instead, the embedded profile will be attached to the image as metadata. -You need to use something like im_icc_import(3) to get CIE values from the -file. Any EXIF data is also attached as VIPS metadata. - -.B im_vips2jpeg(3) -writes the IMAGE to filename in JPEG format. It uses the -default settings of the IJG library. - -A compression factor may be encoded in the filename: for example, -"fred.jpg" will write with the default compression factor (75), -"fred.jpg:25" will write with factor 25. - -An ICC profile may also be specified. For example, -"fred.jpg:,/home/john/srgb.icc" will embed the profile stored in the file -"/home/john/srgb.icc" into the JPEG image. This does not affect the pixels -which are written, just the way they are tagged. You can use the special -string "none" to mean "don't attach a profile". - -If no profile is specified in the save string and the VIPS header contains an -ICC profile named IM_META_ICC_NAME ("icc-profile-data"), the -profile from the VIPS header will be attached. - -The image is automatically converted to RGB, Monochrome or CMYK before saving. -Any metadata attached to the image is saved as EXIF, if possible. - -.B im_vips2bufjpeg(3) -returns the compressed image in a memory buffer. The buffer -is allocated for you, local to IMAGE descriptor -.B base. -The size of the -allocated buffer is returned in the -.B olen -parameter. You are responsible for -freeing the buffer. The buffer is only allocated if the function returns -successfully. - -.B im_vips2mimejpeg(3) -writes the image to stdout as a MIME image/jpeg type. It -outputs Content-Length and Content-Type fields making the result suitable for -sending to a web browser. - -.SH SEE ALSO -im_open(3). diff --git a/man/im_lab_morph.3 b/man/im_lab_morph.3 deleted file mode 100644 index ac5563ba..00000000 --- a/man/im_lab_morph.3 +++ /dev/null @@ -1,44 +0,0 @@ -.TH IM_LAB_MORPH 3 "8 March 2001" -.SH NAME -im_lab_morph \- calculate colour differences -.SH SYNOPSIS -#include - -int im_lab_morph( IMAGE *in, IMAGE *out, -.br - DOUBLEMASK *mask, -.br - double L_offset, double L_scale, -.br - double a_scale, double b_scale ) - -.SH DESCRIPTION -This function tweaks the colour in an LAB image. It's useful for -making a 'tweaked' image for sending to a colour printer. - -It performs three corrections: first, it straightens the neutral axis (this is -useful if your printer tends to tint shadows slightly red, for example); it -moves L* by adding an offset and then multiplying by a scale (useful if your -printer thinks in relative colorimetry, for example), and finally scales a* -and b* by a factor (useful if your printer desaturates to avoid gamut -clipping). - -The neutral axis straightening is specified as a DOUBLEMASK containing L*, a* -and b* readings taken from a print of a neutral greyscale (one with a* and b* -zero). For example: - - 3 4 - 14.23 4.8 -3.95 - 18.74 2.76 -2.62 - 23.46 1.4 -1.95 - 27.53 1.76 -2.01 - -This is interpolated to make an a/b offset for each input value of L*. The top -and tail are interpolated towards [100,0,0] and [0,0,0]. Entries in the mask -can be in any order. - -.SH RETURN VALUE -All functions return 0 on success and -1 on error. -.SH COPYRIGHT -National Gallery, 2001 - diff --git a/man/im_less.3 b/man/im_less.3 deleted file mode 100644 index 141a819b..00000000 --- a/man/im_less.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_equal.3 diff --git a/man/im_less_vec.3 b/man/im_less_vec.3 deleted file mode 100644 index 141a819b..00000000 --- a/man/im_less_vec.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_equal.3 diff --git a/man/im_lessconst.3 b/man/im_lessconst.3 deleted file mode 100644 index 141a819b..00000000 --- a/man/im_lessconst.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_equal.3 diff --git a/man/im_lesseq.3 b/man/im_lesseq.3 deleted file mode 100644 index 141a819b..00000000 --- a/man/im_lesseq.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_equal.3 diff --git a/man/im_lesseq_vec.3 b/man/im_lesseq_vec.3 deleted file mode 100644 index 141a819b..00000000 --- a/man/im_lesseq_vec.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_equal.3 diff --git a/man/im_lesseqconst.3 b/man/im_lesseqconst.3 deleted file mode 100644 index 141a819b..00000000 --- a/man/im_lesseqconst.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_equal.3 diff --git a/man/im_lhisteq.3 b/man/im_lhisteq.3 deleted file mode 100644 index 0d4a60ee..00000000 --- a/man/im_lhisteq.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_heq.3 diff --git a/man/im_lhisteq_raw.3 b/man/im_lhisteq_raw.3 deleted file mode 100644 index 0d4a60ee..00000000 --- a/man/im_lhisteq_raw.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_heq.3 diff --git a/man/im_lindetect.3 b/man/im_lindetect.3 deleted file mode 100644 index 34274649..00000000 --- a/man/im_lindetect.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_compass.3 diff --git a/man/im_line.3 b/man/im_line.3 deleted file mode 100644 index 51f5a998..00000000 --- a/man/im_line.3 +++ /dev/null @@ -1,29 +0,0 @@ -.TH IM_LINE 3 "10 May 1991" -.SH NAME -im_line \- writes a line on a vasari image -.SH SYNOPSIS -.B #include - -.B int im_line(image, x1, y1, x2, y2, pelval) -.br -.B IMAGE *image; -.br -.B int x1, x2, y1, y2, pelval; -.SH DESCRIPTION -im_line() -draws a line in the image held by image. The start of the line is at point -(x1,y1) and the end is at (x2,y2). The intensity of the drawn line is pelval. -Input image should be one byte unsigned char. The function overwrites any -data in the file, so take care when applying it. - -This function is here for compatibility only. You should use im_fastline(3) or -im_fastlineuser(3). -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_grey(3), im_fastline(3). -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 10/05/1991 diff --git a/man/im_lineset.3 b/man/im_lineset.3 deleted file mode 100644 index 24a57b00..00000000 --- a/man/im_lineset.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_paintrect.3 diff --git a/man/im_lintra.3 b/man/im_lintra.3 deleted file mode 100644 index 788ba37a..00000000 --- a/man/im_lintra.3 +++ /dev/null @@ -1,58 +0,0 @@ -.TH IM_LINTRA 3 "24 April 1991" -.SH NAME -im_lintra, im_lintra_vec \- performs a linear transformation on an image -.SH SYNOPSIS -.B #include - -.B int im_lintra_vec(n, a, in, b, out) -.br -.B int n; -.br -.B double *a, *b; -.br -.B IMAGE *in, *out; - -.B int im_lintra(a, in, b, out) -.br -.B double a, b; -.br -.B IMAGE *in, *out; - -.SH DESCRIPTION -.B im_lintra_vec(3) -performs a linear transform on image in, that is, it calculates - - out = a * in + b - -.B a -and -.B b -are vectors, ie. arrays of constants of length -.B n. -If -.B in -has one band, then the vectors may be any length and the output image will -have the same number of bands as the length of the vector. If -.B in -has many bands, then the vector must be length 1, or have the same length as -the number of bands in the image. - -If the input format is one of the integer types -then output is float. In all other cases the -output is the same as the input. - -.B im_lintra(3) -is a convenience function which calls -.B im_lintra_vec(3) -with a vector of length 1. - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH BUGS -The function does not check for under/overflow -.SH SEE\ ALSO -im_exptra(3), im_logtra(3) -.SH AUTHOR -N. Dessipris \- 24/04/1991 -.br -J. Cupitt (rewrite) \- 21/7/93 diff --git a/man/im_lintra_vec.3 b/man/im_lintra_vec.3 deleted file mode 100644 index 4c6c0ca9..00000000 --- a/man/im_lintra_vec.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_lintra.3 diff --git a/man/im_litecor.3 b/man/im_litecor.3 deleted file mode 100644 index 46a838b2..00000000 --- a/man/im_litecor.3 +++ /dev/null @@ -1,52 +0,0 @@ -.TH IM_LITECOR 3 "5 December 1991" -.SH NAME -im_litecor \- perform light correction -.SH SYNOPSIS -.B #include - -.B int im_litecor(in, white, out, clip, factor) -.br -.B IMAGE *in, *out; -.br -.B int clip; -.br -.B double factor; -.SH DESCRIPTION -.B im_litecor(3) -performs light correction on the image held by the IMAGE descriptor in, -with respect to a reference white image held by the IMAGE descriptor white. -The result is written onto the IMAGE descriptor out. The function works -on byte one channel images only. - -The flag clip can take two values 0 and 1. If clip is 1 then the input is -corrected with reference to the maximum value of white (maxw) as follows. - - pel_out = factor * pel_in * maxw / pel_white. - -If clip is 0 then the output is scaled with the maximum possible output set -to 255. In this case factor is not used but it must be set to a dummy value. - -The basic reason for lighting correction is that the input frame does not -have a uniform distribution of white light due to the optical response of -the lens. The function accepts a white image which is a simple multiple -of the input image in size; for example it is possible that the white -is a subsampled version of in; however the sizes of in must be an exact -multiple of the white. If clip is set to 0, lighting correction is -carried out and the result is scaled between 0 and 255. This can be used -to correct individual frames. - -If multiband images are grabbed, then flag should be set to 1, since -no scaling must be done. In this case the factor can reduce the number of -clipped pels if overshooting occurs in the brightest band. The program -prints the number of clipped pels with im_warning(3). -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH BUGS -clip==0 case not working too well. -.SH SEE\ ALSO -im_add(3), im_lintra(3), im_multiply(3). -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 05/12/1991 diff --git a/man/im_log10tra.3 b/man/im_log10tra.3 deleted file mode 100644 index 9ae2c5a1..00000000 --- a/man/im_log10tra.3 +++ /dev/null @@ -1,2 +0,0 @@ -.so man3/im_exp10tra.3 - diff --git a/man/im_log_dmask.3 b/man/im_log_dmask.3 deleted file mode 100644 index 3bc62f48..00000000 --- a/man/im_log_dmask.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_log_imask.3 diff --git a/man/im_log_imask.3 b/man/im_log_imask.3 deleted file mode 100644 index 15e4cb2d..00000000 --- a/man/im_log_imask.3 +++ /dev/null @@ -1,56 +0,0 @@ -.TH LOG_MASKS 3 "6 December 1991" -.SH NAME -im_log_dmask, im_log_imask \- create a laplacian of gaussian (log) -DOUBLEMASK or INTMASK -.SH SYNOPSIS -.B -#include - - -.B DOUBLEMASK *im_log_dmask( name, sigma, min_amplitude ) -.br -char *name; -.br -double sigma, min_amplitude; - -.B INTMASK *im_log_imask( name, sigma, min_amplitude ) -.br -char *name; -.br -double sigma, min_amplitude; -.SH DESCRIPTION -Both functions create a circularly symmetric laplacian of Gaussian mask. The -size of the mask is determined by the variable min_amplitude; if for instance -the value .1 is entered this means that the produced mask is clipped at values -within 10 persent of zero, and where the change between mask elements is less -than 10%. -The mask can be directly used with the vasari convolution -programs, the default offset set is 0. - -The program uses the following equation: (from Handbook of Pattern Recognition -and image processing by Young and Fu, AP 1986 pages 220-221): - - H(r) = (1 / (2 * M_PI * s4)) * - (2 - (r2 / s2)) * - exp(-r2 / (2 * s2)) - -where s2 = sigma * sigma, s4=s2 * s2, r2 = r * r. The generated mask has odd -size and its -maximum value is normalised to either 100 (log_imask) or to 1.0 (log_dmask) - -.B im_log_dmask() -creates a DOUBLEMASK laplacian of Gaussian mask with maximum value normalised -to 1.0. - -.B im_log_imask() -creates a INTMASK laplacian of Gaussian mask with maximum value normalised -to 100. -.SH RETURNED VALUE: -The functions return NULL on erorr. -.SH SEE ALSO -im_gauss_dmask(3), im_conv(3) -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 06/12/1991 diff --git a/man/im_logtra.3 b/man/im_logtra.3 deleted file mode 100644 index 9ae2c5a1..00000000 --- a/man/im_logtra.3 +++ /dev/null @@ -1,2 +0,0 @@ -.so man3/im_exp10tra.3 - diff --git a/man/im_lowpass.3 b/man/im_lowpass.3 deleted file mode 100644 index 38a25465..00000000 --- a/man/im_lowpass.3 +++ /dev/null @@ -1,26 +0,0 @@ -.TH IM_CONV 3 "2 May 1991" -.SH NAME -im_lowpass \- remove high frequencies quickly -.SH SYNOPSIS -#include - -int im_lowpass(in, out, x, y) -.br -IMAGE *in, *out; -.br -int x, y; -.SH DESCRIPTION -Expand image up to X by Y pixels. Linear interpolation. Used by lowpass(1X) -for simple and nasty low-pass filtering. The result is very poor, but good -enough for smoothing out whites. Any number of bands, output size == input -size, any non-complex type. - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE\ ALSO -im_shrink(3), im_similarity_area(3). -.SH COPYRIGHT -.br -National Gallery -.SH AUTHOR -Too embarrassed to say diff --git a/man/im_lrjoin.3 b/man/im_lrjoin.3 deleted file mode 100644 index 83de90c3..00000000 --- a/man/im_lrjoin.3 +++ /dev/null @@ -1,38 +0,0 @@ -.TH JOIN 3 "25 April 1991" -.SH NAME -im_lrjoin, im_tbjoin \- join two images into one -.SH SYNOPSIS -#include - -int im_lrjoin( IMAGE *im1, IMAGE *im2, IMAGE *imout ) - -int im_tbjoin( IMAGE *im1, IMAGE *im2, IMAGE *imout ) -.SH DESCRIPTION -These functions join two image left-right or top-bottom. Both input images -should have the same no of bands and the same BandFmt. Output has the same no -of bands and BandFmt as input. Only the history of the first image is kept by -the output image. - -im_lrjoin() joins two images held by image descriptors im1 and im2 and writes -the resultant byte image on the image descriptor imout. The number of the -extracted channels are identical for all images. The Xsize of imout is the -sum of the Xsizes of im1 and im2; the Ysize of imout is the min of the Ysizes -of im1 and im2. When joining im1 is on the left side of imout and im2 is on -the right side of imout. - -im_tbjoin() joins two images held by image descriptors im1 and im2 and writes -the resultant byte image on the image descriptor imout. The number of the -extracted channels are identical for all images. The Xsize of imout is the -min of the Xsizes of im1 and im2; the Ysize of imout is the sum of the Ysizes -of im1 and im2. When joining im1 is on the top side of imout and im2 is on -the bottom side of imout. - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_extract(3), im_lrmerge(3), im_insert(3) -.SH COPYRIGHT -.br -K. Martinez, N. Dessipris, -.SH AUTHOR -K. Martinez and N. Dessipris \- 25/04/1991 diff --git a/man/im_lrmerge.3 b/man/im_lrmerge.3 deleted file mode 100644 index 0e295312..00000000 --- a/man/im_lrmerge.3 +++ /dev/null @@ -1,40 +0,0 @@ -.TH IM_LRMERGE 3 "13 May 1991" -.SH NAME -im_lrmerge, im_tbmerge, im_lrsmerge, im_tbsmerge, im_lrmergeb, im_tbmergeb \- merges two images with a given dx and dy -.SH SYNOPSIS -#include - -int im_lrmerge( ref, sec, out, dx, dy, mwidth ) -.br -IMAGE *ref, *sec, *out; -.br -int dx, dy; -.br -int mwidth; - -int im_tbmerge( ref, sec, out, dx, dy, mwidth ) -.br -IMAGE *ref, *sec, *out; -.br -int dx, dy; -.br -int mwidth; - -.SH DESCRIPTION -im_lrmerge() and im_tbmerge() merge the images held by the image descriptors -reference and secondary (ref and sec) according to the values dx and dy. dx -and dy give the displacement of sec relative to ref. The result is written on -the image descriptor out. The program carries out a smooth merge using a -raised cosine function. Both work for any image type, including LABPACK. - -The functions treat pixels with the value zero as "transparent", that is, -zero pixels in the overlap area do not contribute to the merge. This makes it -possible to join non-rectangular images. - -The "mwidth" parameter limits the maximum width (or height) of the blend area. -A value of "-1" means "unlimited". All other negative values are errors. - -.SH RETURN VALUE -Both functions return 0 on success and -1 on error. -.SH SEE ALSO -im_lrmosaic(3), im_tbmosaic(3), im_match_linear(3). diff --git a/man/im_lrmosaic.3 b/man/im_lrmosaic.3 deleted file mode 100644 index 8192075b..00000000 --- a/man/im_lrmosaic.3 +++ /dev/null @@ -1,104 +0,0 @@ -.TH IM_LRMOSAIC 3 "13 May 1991" -.SH NAME -im_lrmosaic, im_tbmosaic \- mosaic two images using a zero order procedure -.SH SYNOPSIS -#include - -int -.br -im_lrmosaic( IMAGE *ref, IMAGE *sec, IMAGE *out, -.br - int bandno, -.br - int xref, int yref, int xsec, int ysec, -.br - int halfcorrelation, int halfarea, -.br - int balancetype, -.br - int mwidth ) - -int -.br -im_tbmosaic( IMAGE *ref, IMAGE *sec, IMAGE *out, -.br - int bandno, -.br - int xref, int yref, int xsec, int ysec, -.br - int halfcorrelation, int halfarea, -.br - int balancetype, -.br - int mwidth ) - -.SH DESCRIPTION -im_lrmosaic() and im_tbmosaic() are used to mosaic two images (left-right and -top-bottom respectively). Both input images are held by the IMAGE descriptors -reference and secondary whereas the output is written on the IMAGE descriptor -out. - -In order to carry out mosaicing, the coordinates of one tie point are -required. The tie point is expected to be in the overlapping area and has -coordinates (xref, yref) on the reference image and (xsec, ysec) on the -secondary image. The tie-point is not used as a start point for the search, -but is used to specify the overlap of the two images. - -The functions split the overlap area into three parts (top, middle and bottom; -or left, middle and right) and search the reference image in each part for the -20 best high contrast points. These 60 points are then searched for in the -secondary image, giving a set of 60 possible corrected vectors. - -A straight line is fitted through the 60 vectors, and points discarded which -lie a significant distance from the line. The line is then refitted to the -remaining points, and the process repeated until either all remaining points -lie on a straight line, or too many points have been discarded. - -If a good straight line fit is found, ref and sec are joined. If no fit was -found, the functions fail with an error message. Note that these functions -detect rotation: if the straight line found requires sec to be rotated, they -also fail with an error message. - -Each function requires three more parameters: - -halfcorrelationsize - sets the size of the fragments of ref - for which the function searches sec. The actual window - will be of size 2*halfcorrelationsize+1. We recommend a - value of 5. - -halfareasize - sets the size of the area of sec that is - searched. The actual area searched will be of size - 2*halfareasize+1. We recommend a value of 14. - -balancetype - sets the style of the balancing the functions - perform. Balancing finds the average value of pixels in - the overlap area, and scales the left and right images - (or top and bottom images) so as to make the images - match in average overlap. Possible values are: - - 0 - means do no balancing. - - 1 - means keep the left image unadjusted and adjust - the contrast of the right image to match the left. - - 2 - means keep the right image unadjusted and scale - the left image to match it. - - 3 - means adjust the contrast of both the left and - right images to bring both averages to a middle - value. The middle value chosen is weighted by the - number of pixels in each image: large images will be - adjusted less than small images. - -Balancing is useful for mosaicing frames from photographic or video sources -where exact colour control is impossible and exposure varies from frame to -frame. Balancing is only allowed for uncoded uchar images. - -The final "mwidth" parameter sets the maximum blend width, see im_lrmerge(3). - -See also im_global_balance() for a better way of balancing large mosaics. - -.SH RETURN VALUE -All functions return 0 on success and -1 on error. -.SH SEE ALSO -im_lrmerge(3), im_tbmerge(3), im_global_balance(3). diff --git a/man/im_lu_decomp.3 b/man/im_lu_decomp.3 deleted file mode 100644 index 05a51f7b..00000000 --- a/man/im_lu_decomp.3 +++ /dev/null @@ -1,75 +0,0 @@ -.TH IM_LU_DECOMP 3 "18 September 2006" -.SH NAME - im_lu_decomp, im_lu_solve \- Solve SLEs by LU decomposition -.SH SYNOPSIS -.nf -.B #include -.sp -.BI "DOUBLEMASK *im_lu_decomp( const DOUBLEMASK " "*mat" ", const char " "*name" " ); -.br - -.BI "int im_lu_solve( const DOUBLEMASK " "*lu" ", double " "*vec" " ); -.fi -.SH DESCRIPTION -.B im_lu_decomp(3) -allocates a DOUBLEMASK representing the LU decomposition of the matrix in -DOUBLEMASK -.IR "*mat" ", -and gives it the filename member -.IR "name" ". -.PP -.B im_lu_solve(3) -solves the system of linear equations (SLE) Ax=b, where matrix A has already -been decomposed into LU form in DOUBLEMASK -.IR "*lu" ". -Input vector b is in -.I *vec -and is overwritten with output vector x. -.PP -DOUBLEMASK -.I *lu -is unaltered by -.BR "im_matinv(3)" ", -and can be used again to solve a different SLE containing matrix A. -.SH NOTES -The scale and offset members of -.I *mat -are ignored. If they are not set to 1.0 and zero respectively, you must first -call -.BR "im_norm_dmask(3)" ". -.PP -To understand the decomposition A=LU, see Press et al. (1992). For the exact -format used to represent the matrices L and U in -.IR "*lu" ", -see the acompanying source code. -.SH ERRORS -If matrix -.I *mat -is singular (non-invertible), or close to singular then -.B im_lu_decomp(3) -will fail, calling -.BR "im_error(3)" ". -.SH RETURN VALUE -.B im_lu_decomp(3) -returns a pointer to the new DOUBLEMASK, or NULL on error. -.PP -.B im_lu_solve(3) -always returns zero, unless -.I lu -was not returned by -.BR "im_lu_decomp(3)" ", -when it returns -1. -.SH SEE ALSO -im_create_dmask(3), im_free_dmask(3), im_norm_dmask(3), im_matinv(3) -.SH REFERENCES -PRESS, W. et al, 1992. Numerical Recipies in C; The Art of Scientific -Computing, 2nd ed. Cambridge: Cambridge University Press, pp. 43-50. -.PP -[Available online: -http://www.library.cornell.edu/nr/bookcpdf.html accessed 2006-09-19] -.SH COPYRIGHT -.br -Copyright 2006, Tom Vajzovic. -.SH AUTHOR -Tom Vajzovic - diff --git a/man/im_lu_solve.3 b/man/im_lu_solve.3 deleted file mode 100644 index cfe8df4e..00000000 --- a/man/im_lu_solve.3 +++ /dev/null @@ -1,2 +0,0 @@ -.so man3/im_lu_decomp.3 - diff --git a/man/im_magick2vips.3 b/man/im_magick2vips.3 deleted file mode 100644 index ad4ea0dd..00000000 --- a/man/im_magick2vips.3 +++ /dev/null @@ -1,19 +0,0 @@ -.TH IM_MAGICK 3 "January 2003" -.SH NAME -im_magick2vips \- read images with the libMagick -library -.SH SYNOPSIS -#include - -int im_magick2vips( const char *filename, IMAGE *out ) - -.SH DESCRIPTION -.B im_magick2vips(3) -reads the image in filename using libMagick, and writes the image out -in VIPS format. It should be able to read any ImageMagick image, including -the float and double formats. - -.SH SEE ALSO -im_open(3) -.SH COPYRIGHT -Hey, you want this? You have it! diff --git a/man/im_make_xy.3 b/man/im_make_xy.3 deleted file mode 100644 index af1bec37..00000000 --- a/man/im_make_xy.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_grey.3 diff --git a/man/im_makerw.3 b/man/im_makerw.3 deleted file mode 100644 index e76d462b..00000000 --- a/man/im_makerw.3 +++ /dev/null @@ -1,26 +0,0 @@ -.TH IM_MAKERW 3 "22 April 1992" -.SH NAME -im_makerw \- make an IMAGE writeable -.SH SYNOPSIS -#include - -int im_makerw( image ) -.br -IMAGE *image; -.SH DESCRIPTION -im_makerw(3) attempts to make image writeable, ready for an in-place operation. -Its actions are just as those for im_incheck(3), except that descriptors which -after im_incheck(3) end up as IM_MMAPIN descriptors, magically become -IM_MMAPINRW descriptors. - -Extreme caution is urged! You can permanently damage valuable data with this -call. -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE\ ALSO -im_mmapin(3), im_mmapinrw(3), im_fastlineuser(3). -.SH COPYRIGHT -.br -National Gallery, 1992 -.SH AUTHOR -J. Cupitt diff --git a/man/im_malloc.3 b/man/im_malloc.3 deleted file mode 100644 index 19d91f13..00000000 --- a/man/im_malloc.3 +++ /dev/null @@ -1,153 +0,0 @@ -.TH IM_AND 3 "30 October 1992" -.SH NAME -im_add_close_callback, im_add_eval_callback, im_malloc, im_free, -im_add_evalend_callback, im_add_evalstart_callback, im_add_preclose_callback, -im_add_invalidate_callback \- add image callbacks -.SH SYNOPSIS -.B #include - -typedef int (*im_callback_fn)( void *, void * ); - -int im_add_close_callback( IMAGE *, im_callback_fn, void *, void * ); - -int im_add_preclose_callback( IMAGE *, im_callback_fn, void *, void * ); - -int im_add_evalstart_callback( IMAGE *, im_callback_fn, void *, void * ); - -int im_add_eval_callback( IMAGE *, im_callback_fn, void *, void * ); - -int im_add_evalend_callback( IMAGE *, im_callback_fn, void *, void * ); - -int im_add_invalidate_callback( IMAGE *, im_callback_fn, void *, void * ); - -void *im_malloc( IMAGE *, size_t ); - -int im_free( void * ); - -.SH DESCRIPTION -These functions attach callbacks to images. Callbacks are functions, with -optional extra arguments a and b, which are remembered by the IMAGE they are -attached to. These functions are triggered at some later stage in reponse to -some event. You can attach as many callbacks as you like; all will be -remembered, and will be called when the event occurs. The most recently added -callback is called first --- this can be important for close callbacks. - -.B im_add_close_callback(3) -adds a callback which will be triggered when the image -is closed by -.B im_close(3). -The callback is expected to return 0 for success and -non-zero for failure. If the function fails, then the whole -.B im_close(3) -fails. Close callbacks are guaranteed to be called exactly once, so they are a -good place to release resources. - -This function is used by VIPS to implement -.B im_malloc(3). -This allocates memory -exactly as the standard -.B malloc(3) -function, but memory allocated is local to a -descriptor. When the descriptor is closed, the memory allocated is -automatically freed for you. If you pass NULL for the descriptor, then -.B im_malloc(3) -acts as -.B malloc(3). -On error, -.B im_malloc(3) -returns NULL, setting an -error message. See the man pages for -.B IM_NEW(3) and -.B im_open_local(3) -for further examples. - -Free memory with -.B im_free(3). - -You may use close callbacks to trigger other -.B im_close(3) -operations, and there -may even be circularity in your -.B im_close(3) -lists. - -.B im_add_preclose_callback(3) -adds a callback which will be triggered when the image is closed, but before -any closing has started. Everything is still alive and you can do anything -with the image. Preclose callbacks are guaranteed to be called exactly once. - -.B im_add_evalstart_callback(3) -adds a callback which will be triggered just before image evaluation starts. -It can be called many times. It's a good place to initialize data structures. -Don't allocate resources here. - -Eval callbacks are inherited. That is, any images which use your image as -input will inherit your eval callbacks. As a result, if you add an eval -callback to an image, you will be notified if any later image uses your image -for computation. - -If a later image adds eval callbacks, then the inheritance is broken, and that -image will receive notification instead. - -.B im_add_eval_callback(3) -adds a callback which will be triggered repeatedly as -the image is evaluated. - -When the callback is triggered, the time field of the descriptor will point to -a -.B im_time_t -structure, see vips.h - - typedef struct { - IMAGE *im; /* Image we are part of */ - time_t unused; /* For compatibility */ - int run; /* Time we have been running (secs) */ - int eta; /* Estimated seconds of computation left */ - gint64 tpels; /* Number of pels we expect to calculate */ - gint64 npels; /* Number of pels calculated so far */ - int percent; /* Percent complete */ - GTimer *start; /* Start time */ - } im_time_t; - -These fields are not exact! They should only be used to give approximate -feedback to the user. It is possible to have - - percent > 100 - ntiles > ttiles - eta == 0 - -so be careful. Again, the eval callback should return 0 for success and -non-zero for failure. If the callback fails, evaluation is abandoned. This may -be used to provide a `cancel' feature in your user-interface. - - int - eval_cb( IMAGE *im ) - { - printf( "%d%% complete ...\\n", im->time->percent ); - return( 0 ); - } - - if( im_add_eval_callback( out, eval_cb, out, NULL ) ) - return( -1 ); - - ... now as out is evaluated, we will get %complete - ... messages on stdout. - -.B im_add_evalend_callback(3) -adds a callback which will be triggered when VIPS -has finished evaluating the image. If you want to output some diagnostics -from your function (an overflow count, for example), this is the callback to -use. Again, this can be called many times. - -.B im_add_invalidate_callback(3) -adds a callback which will be triggered when VIPS invalidates the cache on an -image. This is useful for removing images from other, higher-level caches. - -.SH RETURN VALUE -All functions return 0 on success and non-zero on error. -.SH SEE ALSO -IM_NEW(3), im_open_local(3). -.SH COPYRIGHT -National Gallery, 1993 -.SH AUTHOR -J. Cupitt \- 23/7/93 diff --git a/man/im_maplut.3 b/man/im_maplut.3 deleted file mode 100644 index a5eb245b..00000000 --- a/man/im_maplut.3 +++ /dev/null @@ -1,46 +0,0 @@ -.TH IM_MAPLUT 3 "10 May 1991" -.SH NAME -im_maplut \- map an image through a lookup table -.SH SYNOPSIS -#include - -int im_maplut(in, out, lut) -.br -IMAGE *in, *out, *lut; - -.SH DESCRIPTION -im_maplut() maps an image through another image, acting as a LUT (Look Up -Table). The lut may have any type, and the output image will be of that type. - -The input image must be an unsigned integer types, that is, it must be one of -FMTUCHAR, FMTUSHORT or FMTUINT. - -If the input is FMTUCHAR, then the LUT must have 256 elements, in other words, -lut->Xsize * lut->Ysize == 256. - -If the input is FMTUSHORT or FMTUINT, then the lut may have any number of -elements, and input pels whose value is greater than lut->Xsize * lut->Ysize -are mapped with the last LUT element. The function counts and prints the -number of image elements which overflow in this way. - -As regards bands, there are three cases: - - - If LUT has one band, then the input may have any number of bands, and - each band will pass through the same LUT. - - - If LUT has the same number of bands as the input, then each band of the - input will be LUTed separately. - - - If the input has one band, then the LUT may have any number of bands, and - the output will have the same number of bands as the LUT. - -.SH RETURN VALUE -All functions returns 0 on success and -1 on error. -.SH SEE ALSO -im_histgr(3), im_hsp(3), im_heq(3), im_identity(3). -.SH COPYRIGHT -1995, National Gallery and Birkbeck College -.SH AUTHORS -J. Cupitt, 1995 -.br -N. Dessipris \- 10/05/1991 diff --git a/man/im_mask2vips.3 b/man/im_mask2vips.3 deleted file mode 100644 index 48cca147..00000000 --- a/man/im_mask2vips.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_vips2mask.3 diff --git a/man/im_matcat.3 b/man/im_matcat.3 deleted file mode 100644 index 20d77a80..00000000 --- a/man/im_matcat.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_matinv.3 diff --git a/man/im_match_linear.3 b/man/im_match_linear.3 deleted file mode 100644 index d397a7a6..00000000 --- a/man/im_match_linear.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_match_linear_search.3 diff --git a/man/im_match_linear_search.3 b/man/im_match_linear_search.3 deleted file mode 100644 index a5b52574..00000000 --- a/man/im_match_linear_search.3 +++ /dev/null @@ -1,55 +0,0 @@ -.TH MATCH_LINEAR 3 "13 May 1991" -.SH NAME -im_match_linear_search, im_match_linear \- resample to make a match -.SH SYNOPSIS - -#include - -int -.br -im_match_linear( IMAGE *ref, IMAGE *sec, IMAGE *out, -.br - int xr1, int yr1, int xs1, int ys1, -.br - int xr2, int yr2, int xs2, int ys2 ) - -int -.br -im_match_linear_search( IMAGE *ref, IMAGE *sec, IMAGE *out, -.br - int xr1, int yr1, int xs1, int ys1, -.br - int xr2, int yr2, int xs2, int ys2, -.br - int hwindowsize, int hsearchsize ) - -.SH DESCRIPTION -im_match_linear_search() attempts to transform sec to make it match -ref. The transformation is linear, that is, it only involves scale, -rotate and translate. - -im_match_linear_search() requires a pair of tie points to fix the parameters of -its transformation. You should pick points as far apart as possible to -increase accuracy. im_match_linear_search() will search the area in the image -around each tie point for a good fit, so your selection of points need not -be exact. WARNING! This searching process will fail for rotations of more -than about 10 degrees or for scales of more than about 10 percent. -The best you can hope for is < 1 pixel error, since the command does not -attempt sub-pixel correlation. - -hwindowsize and hsearchsize set the size of the area to be searched: we -recommend values of 5 and 14. - -The output image is positioned and clipped so that you can immediately -subtract it from orig to obtain pixel difference images. - -im_match_linear() works exactly as im_match_linear_search(), but does not -attempt to correlate to correct your tie points. It can thus be used for any -angle and any scale, but you must be far more careful in your selection. - -.SH SEE ALSO -im_lrmosaic(). -.SH AUTHORS -J.Ph.Laurent \- 12/12/92 -.br -J.Cupitt \- 22/02/93 diff --git a/man/im_matinv.3 b/man/im_matinv.3 deleted file mode 100644 index 147ab6c4..00000000 --- a/man/im_matinv.3 +++ /dev/null @@ -1,90 +0,0 @@ -.TH IM_MATINV 3 "2 May 1991" -.SH NAME -im_matinv, im_matmul, im_mattrn \- matrix operations on DOUBLEMASKs - -.SH SYNOPSIS -.B #include - -.B DOUBLEMASK *im_matinv( const DOUBLEMASK *in, const char *name ); - -.B int im_matinv_inplace( DOUBLEMASK *mat ); - -.B DOUBLEMASK *im_matmul( in1, in2, name ) -.br -.B DOUBLEMASK *in1, *in2; -.br -.B char *name; - -.B DOUBLEMASK *im_matcat( in1, in2, name ) -.br -.B DOUBLEMASK *in1, *in2; -.br -.B char *name; - -.B DOUBLEMASK *im_mattrn( in, name ) -.br -.B DOUBLEMASK *in; -.br -.B char *name; - -.SH DESCRIPTION -These functions treat DOUBLEMASKs as matricies, performing some of the basics -of matrix algebra on them. - -There should be more matrix functions: those implemeneted are just sufficient -for the Gallery's calibration routines. im_matadd, im_matidentity should -really be added. - -None of these functions damage their arguments, except -.BR "im_matinv_inplace(3)" ". - -.B im_matinv(3) -inverts DOUBLEMASK -.IR "in" ", -returning a new DOUBLEMASK, called -.IR "name" ", -which contains the inverse of in. If no inverse exists, NULL is returned and -.B im_error(3) -is called with a diagnostic message. - -.B im_matinv_inplace(3) -is as -.B im_matinv(3) -except that it overwrites its input. - -.B im_matmul() -multiples the matrices held in in1 and in2, returning their product in a -matrix called name. - -.B im_matcat() -returns a new matrix formed by appending matrix in2 to the end of matrix in1. -The two matricies must be the same width. It is useful for combining several -im_measure()s into a single matrix. - -.B im_mattrn() -transposes matrix in, returning the transpose in new matrix called name. -.SH NOTES -.B DO NOT -use matrix inversion to solve systems of linear equations (SLEs). The -routines -.B im_lu_decomp(3) -and -.B im_lu_solve(3) -are more efficient, even for a single SLE. - -.SH RETURN VALUE -The functions returns a new DOUBLEMASK on sucess, and NULL on failure. -.PP -.B im_matinv_inplace(3) -returns zero on success, and -1 on failure. - -.SH SEE\ ALSO -im_create_dmask(3), im_measure(3), etc. im_lu_decomp(3), im_lu_solve(3) - -.SH COPYRIGHT -National Gallery, 1992. Tom Vajzovic, 2006 -.SH AUTHORS -J. Cupitt -.br -Tom Vajzovic - diff --git a/man/im_matinv_inplace.3 b/man/im_matinv_inplace.3 deleted file mode 100644 index 9f466546..00000000 --- a/man/im_matinv_inplace.3 +++ /dev/null @@ -1,2 +0,0 @@ -.so man3/im_matinv.3 - diff --git a/man/im_matmul.3 b/man/im_matmul.3 deleted file mode 100644 index 20d77a80..00000000 --- a/man/im_matmul.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_matinv.3 diff --git a/man/im_mattrn.3 b/man/im_mattrn.3 deleted file mode 100644 index 20d77a80..00000000 --- a/man/im_mattrn.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_matinv.3 diff --git a/man/im_max.3 b/man/im_max.3 deleted file mode 100644 index fc6dde89..00000000 --- a/man/im_max.3 +++ /dev/null @@ -1,2 +0,0 @@ -.so man3/im_avg.3 - diff --git a/man/im_maxpos.3 b/man/im_maxpos.3 deleted file mode 100644 index fc6dde89..00000000 --- a/man/im_maxpos.3 +++ /dev/null @@ -1,2 +0,0 @@ -.so man3/im_avg.3 - diff --git a/man/im_maxpos_vec.3 b/man/im_maxpos_vec.3 deleted file mode 100644 index 6a82283c..00000000 --- a/man/im_maxpos_vec.3 +++ /dev/null @@ -1,42 +0,0 @@ -.TH IM_MAXPOS_VEC 3 "01 September 2006" -.SH NAME - im_maxpos_vec, im_minpos_vec \- Find highest or lowest pixel values -.SH SYNOPSIS -.nf -.B #include -.sp -.BI "int im_maxpos_vec( IMAGE " "*im" ", int " "*xpos" ", int " "*ypos" ", double " "*maxima" ", int " "n" " ); -.br - -.BI "int im_minpos_vec( IMAGE " "*im" ", int " "*xpos" ", int " "*ypos" ", double " "*minima" ", int " "n" " ); -.fi -.SH DESCRIPTION -.B im_maxpos_vec(3) -fills the arrays -.I xpos -and -.I ypos -with the x and y coordinates of the -.I n -pixels in the image -.I im -which have the highest values. It writes those values (at double-precsion) -into the corresponding elements in the array -.IR maxima ". -.PP -If there is a draw for the -.IR n "th -pixel, then which of the drawing pixels is used is not defined. -.PP -.B im_minpos_vec(3) -performs the same operation, looking for the lowest valued pixels. -.SH RETURN VALUE -The functions returns 0 on success and -1 on error. -.SH SEE ALSO -im_maxpos(3), im_minpos(3) -.SH COPYRIGHT -.br -Copyright 2006, The Nottingham Trent University. -Copyright 2006, Tom Vajzovic. -.SH AUTHOR -Tom Vajzovic diff --git a/man/im_maxvalue.3 b/man/im_maxvalue.3 deleted file mode 100644 index 34274649..00000000 --- a/man/im_maxvalue.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_compass.3 diff --git a/man/im_mean_std_double_buffer.3 b/man/im_mean_std_double_buffer.3 deleted file mode 100644 index 8467ffdc..00000000 --- a/man/im_mean_std_double_buffer.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_mean_std_int_buffer.3 diff --git a/man/im_mean_std_int_buffer.3 b/man/im_mean_std_int_buffer.3 deleted file mode 100644 index bf2898ad..00000000 --- a/man/im_mean_std_int_buffer.3 +++ /dev/null @@ -1,38 +0,0 @@ -.TH IM_MEAN_STD 3 "10 May 1991" -.SH NAME -im_mean_std_double_buffer, im_mean_std_int_buffer \- calculates the mean and the std of data held by a by an int or double buffer -.SH SYNOPSIS -.B #include - -int im_mean_std_int_buffer(buf, size, mean, std) -.br -.B int *buf; -.br -.B int size; -.br -.B double *mean, *std; - -int im_mean_std_double_buffer(buf, size, mean, std) -.br -.B double *buf; -.br -.B int size; -.br -.B double *mean, *std; - -.SH DESCRIPTION -im_mean_std_int_buffer() and im_mean_std_double_buffer() -calculate the mean and the standard deviation (std) of data held by the -integer or double buffer buf. The buffer has size elements. The results are -returned to the locations pointed by mean and std. -It is the responsibility of the calling function to ensure that there is -enough data in the buffer. -.SH RETURN VALUE -Both functions returns 0 on success and -1 on error. -.SH SEE\ ALSO -im_avg(3), im_stats(3). -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 10/05/1991 diff --git a/man/im_measure.3 b/man/im_measure.3 deleted file mode 100644 index 5aa240f1..00000000 --- a/man/im_measure.3 +++ /dev/null @@ -1,47 +0,0 @@ -.TH IM_MEASURE 3 "24 October 1992" -.SH NAME -im_measure \- measure colour patches off images -.SH SYNOPSIS -#include - -DOUBLEMASK *im_measure(in, box, h, v, sel, nsel, name) -.br -IMAGE *in; -.br -IMAGE_BOX *box; -.br -int h, v; -.br -int *sel; -.br -int nsel; -.br -char *name; - -.SH DESCRIPTION -Analyse a grid of colour patches, producing a DOUBLEMASK of averages. -Pass an IMAGE, an IMAGE_BOX, the number of horizontal and vertical -patches, an array giving the numbers of the patches to measure (patches -are numbered left-to-right, top-to-bottom, starting with 1) and the name we -should give the output mask. Return a DOUBLEMASK in which rows are patches and -columns are bands. Only the central 50% of each patch is averaged. - -Example: 6 band image of 4x2 block of colour patches. - - +---+---+---+---+ - | 1 | 2 | 3 | 4 | - +---+---+---+---+ - | 5 | 6 | 7 | 8 | - +---+---+---+---+ - -Then call im_measure( im, box, 4, 2, { 2, 4 }, 2, "fred" ) makes a mask -"fred" which has 6 columns, two rows. The first row contains the averages -for patch 2, the second for patch 4. - -Output warnings: a warning is issued if the standard deviation of any patch is -greater than 20% of the mean of that patch. - -.SH RETURN VALUE -NULL on error. -.SH SEE ALSO -im_avg(3), im_deviate(3), im_stats(3). diff --git a/man/im_meta.3 b/man/im_meta.3 deleted file mode 100644 index 19eede86..00000000 --- a/man/im_meta.3 +++ /dev/null @@ -1,126 +0,0 @@ -.TH IM_META 3 "7 June 2005" -.SH NAME -im_meta_set_int, im_meta_get_int, im_meta_set_double, im_meta_get_double, -im_meta_set_area, im_meta_get_area, im_meta_set_string, im_meta_get_string, -im_meta_set_blob, im_meta_get_blob, -im_meta_set, im_meta_get -\- read and write extra header fields -.SH SYNOPSIS -#include - -int im_meta_set_int( IMAGE *im, const char *field, int i ); -.br -int im_meta_get_int( IMAGE *im, const char *field, int *i ); -.br -int im_meta_set_double( IMAGE *im, const char *field, double d ); -.br -int im_meta_get_double( IMAGE *im, const char *field, double *d ); -.br -int im_meta_set_area( IMAGE *im, const char *field, - im_callback_fn free_fn, void *data ); -.br -int im_meta_get_area( IMAGE *im, const char *field, void **data ); -.br -int im_meta_set_string( IMAGE *im, const char *field, - const char *str ); -.br -int im_meta_get_string( IMAGE *im, const char *field, char **str ); -.br -int im_meta_set_blob( IMAGE *im, const char *field, - im_callback_fn free_fn, void *blob, size_t blob_length ); -.br -int im_meta_get_blob( IMAGE *im, const char *field, - void **blob, size_t *blob_length ); - -typedef int (*im_callback_fn)( void *, void * ); - -int im_meta_set( IMAGE *im, const char *field, GValue *value ); -.br -int im_meta_get( IMAGE *im, const char *field, GValue *value_copy ); -.br -GType im_meta_get_type( IMAGE *im, const char *field ); - -#define IM_TYPE_SAVE_STRING (im_save_string_get_type()) -.br -GType im_save_string_get_type( void ); -.br -const char *im_save_string_get( const GValue *value ); -.br -void im_save_string_set( GValue *value, const char *str ); -.br -void im_save_string_setf( GValue *value, const char *fmt, ... ); - -.SH DESCRIPTION -These functions read and write extra image header fields. Writing to a field -destroys any old value. You must read a field with the correct type of reader: -you can't read an int field as a string. Fields are copied when images are -processed, so you can use them to pass information to subsequent operations. -Unless otherwise noted, image header fields created with these functions are -also saved to disc when an image is saved in VIPS format, and automatically -restored when the image is loaded again. - -.B im_meta_set_int(3) -sets an integer field. Any existing field of any type with this name is -removed. It returns 0 for success, or -1 on error setting -.B im_error(3). - -.B im_meta_get_int(3) -reads an integer field. It returns 0 for success, or -1 on error, setting -.B im_error(3). -It can fail if the field does not exist, or if the field is not an int. - -.B im_meta_set_double(3) -and -.B im_meta_get_double(3) -work exactly as -.B im_meta_set_int(3) -and -.B im_meta_get_int(3). - -.B im_meta_set_area(3) -sets a field which is an area of memory. When the field is copied to a -subsequent IMAGE, VIPS just copies the pointer. VIPS keeps a reference count -and when the last IMAGE using this field is closed, VIPS will call -.B free_fn -to release the memory. You can therefore use this function to attach very -large areas of memory to images efficiently. Areas cannot be saved to VIPS -files on disc, since there is no known length. - -.B im_meta_set_string(3) -is a convenience function over -.B im_meta_set_area(3). -It copies the string, and -then shares that copy between all images derived from this IMAGE. - -.B im_meta_get_string(3) -is a convenience function over -.B im_meta_get_area(3). -It returns a pointer to the string being mananged by VIPS. Do not free the -return result! - -.B im_meta_set_blob(3) -sets a field which is a blob (binary object). A blob is just like string, -except that rather than being NULL-terminated, you must pass an explicit -length. - -.B im_meta_set(3), -.B im_meta_get_type(3) -and -.B im_meta_get(3) -operate at a lower level: they let you set image header fields as GValue. Use -one of the convenience functions above if possible. -.B im_meta_get_type(3) -returns 0 if the field is not defined. - -In order for the autoload/save to VIPS files to work, you need to use a GType -with a transform defined to and from -.B IM_TYPE_SAVE_STRING. - -.SH RETURN VALUE -The functions return 0 success and -1 on error. -.SH SEE ALSO -im_header_int(3), im_header_map(3). -.SH COPYRIGHT -The National Gallery, 2005. -.SH AUTHOR -Markus Wollgarten and John Cupitt diff --git a/man/im_meta_get.3 b/man/im_meta_get.3 deleted file mode 100644 index d90069be..00000000 --- a/man/im_meta_get.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_meta.3 diff --git a/man/im_meta_get_area.3 b/man/im_meta_get_area.3 deleted file mode 100644 index d90069be..00000000 --- a/man/im_meta_get_area.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_meta.3 diff --git a/man/im_meta_get_blob.3 b/man/im_meta_get_blob.3 deleted file mode 100644 index d90069be..00000000 --- a/man/im_meta_get_blob.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_meta.3 diff --git a/man/im_meta_get_double.3 b/man/im_meta_get_double.3 deleted file mode 100644 index d90069be..00000000 --- a/man/im_meta_get_double.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_meta.3 diff --git a/man/im_meta_get_int.3 b/man/im_meta_get_int.3 deleted file mode 100644 index d90069be..00000000 --- a/man/im_meta_get_int.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_meta.3 diff --git a/man/im_meta_get_string.3 b/man/im_meta_get_string.3 deleted file mode 100644 index d90069be..00000000 --- a/man/im_meta_get_string.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_meta.3 diff --git a/man/im_meta_get_type.3 b/man/im_meta_get_type.3 deleted file mode 100644 index d90069be..00000000 --- a/man/im_meta_get_type.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_meta.3 diff --git a/man/im_meta_set.3 b/man/im_meta_set.3 deleted file mode 100644 index d90069be..00000000 --- a/man/im_meta_set.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_meta.3 diff --git a/man/im_meta_set_area.3 b/man/im_meta_set_area.3 deleted file mode 100644 index d90069be..00000000 --- a/man/im_meta_set_area.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_meta.3 diff --git a/man/im_meta_set_blob.3 b/man/im_meta_set_blob.3 deleted file mode 100644 index d90069be..00000000 --- a/man/im_meta_set_blob.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_meta.3 diff --git a/man/im_meta_set_double.3 b/man/im_meta_set_double.3 deleted file mode 100644 index d90069be..00000000 --- a/man/im_meta_set_double.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_meta.3 diff --git a/man/im_meta_set_int.3 b/man/im_meta_set_int.3 deleted file mode 100644 index d90069be..00000000 --- a/man/im_meta_set_int.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_meta.3 diff --git a/man/im_meta_set_string.3 b/man/im_meta_set_string.3 deleted file mode 100644 index d90069be..00000000 --- a/man/im_meta_set_string.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_meta.3 diff --git a/man/im_min.3 b/man/im_min.3 deleted file mode 100644 index 46443e20..00000000 --- a/man/im_min.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_avg.3 diff --git a/man/im_minpos.3 b/man/im_minpos.3 deleted file mode 100644 index fc6dde89..00000000 --- a/man/im_minpos.3 +++ /dev/null @@ -1,2 +0,0 @@ -.so man3/im_avg.3 - diff --git a/man/im_minpos_vec.3 b/man/im_minpos_vec.3 deleted file mode 100644 index b92d839c..00000000 --- a/man/im_minpos_vec.3 +++ /dev/null @@ -1,2 +0,0 @@ -.so man3/im_maxpos_vec.3 - diff --git a/man/im_mmapin.3 b/man/im_mmapin.3 deleted file mode 100644 index 271d8603..00000000 --- a/man/im_mmapin.3 +++ /dev/null @@ -1,22 +0,0 @@ -.TH IM_MMAPIN 3 "11 April 1990" -.SH NAME -im_mmapin \- memory maps a VASARI image file (read only) and returns -an image descriptor. -.SH SYNOPSIS -.B #include - -.B IMAGE *im_mmapin(file_name) -.br -.B char *file_name; -.SH DESCRIPTION -.B im_mmapin(3) -opens a file for input. It has been replaced by im_open( file_name, "r" ). -.SH RETURN VALUE -The function returns the image descriptor on success and NULL on error. -.SH SEE ALSO -im_open(3), im_close(3), im_mmapinrw(3), im_makerw(3). -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 11/04/1990 diff --git a/man/im_mmapinrw.3 b/man/im_mmapinrw.3 deleted file mode 100644 index cbcdedbf..00000000 --- a/man/im_mmapinrw.3 +++ /dev/null @@ -1,27 +0,0 @@ -.TH IM_MMAPINRW 3 "22 April 1991" -.SH NAME -im_mmapinrw \- memory maps a VASARI image file with read and write access -.SH SYNOPSIS -.B #include - -.B IMAGE *im_mmapinrw(file_name) -.br -.B char *file_name; -.SH DESCRIPTION -.B im_mmapinrw(3) -works exactly as im_mmapin but the entered file_name is memory mapped -with read and write permissions. This is useful for some applications, -like writing lines onto an existing file. Since -the user might change accidentally the context of the original file, -great care should taken when handling a file with this routine. - -im_open(3) is generally more convenient. -.SH RETURN VALUE -The function returns the image descriptor on success and NULL on error. -.SH SEE\ ALSO -im_close(3), im_open(3), im_makerw(3). -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 11/04/1990 diff --git a/man/im_more.3 b/man/im_more.3 deleted file mode 100644 index 141a819b..00000000 --- a/man/im_more.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_equal.3 diff --git a/man/im_more_vec.3 b/man/im_more_vec.3 deleted file mode 100644 index 141a819b..00000000 --- a/man/im_more_vec.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_equal.3 diff --git a/man/im_moreconst.3 b/man/im_moreconst.3 deleted file mode 100644 index 141a819b..00000000 --- a/man/im_moreconst.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_equal.3 diff --git a/man/im_moreeq.3 b/man/im_moreeq.3 deleted file mode 100644 index 141a819b..00000000 --- a/man/im_moreeq.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_equal.3 diff --git a/man/im_moreeq_vec.3 b/man/im_moreeq_vec.3 deleted file mode 100644 index 141a819b..00000000 --- a/man/im_moreeq_vec.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_equal.3 diff --git a/man/im_moreeqconst.3 b/man/im_moreeqconst.3 deleted file mode 100644 index 141a819b..00000000 --- a/man/im_moreeqconst.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_equal.3 diff --git a/man/im_mpercent.3 b/man/im_mpercent.3 deleted file mode 100644 index 1f5ec9dc..00000000 --- a/man/im_mpercent.3 +++ /dev/null @@ -1,30 +0,0 @@ -.TH IM_MPERCENT 3 "14 May 1991" -.SH NAME -im_mpercent \- find threshold corresponding to a percentage of an image values -.SH SYNOPSIS -#include - -int im_mpercent( in, percent, thresh ) -.br -IMAGE *in; -.br -int percent; -.br -int *thresh; - -.SH DESCRIPTION -im_mpercent() returns (through the thresh parameter) the threshold above which -there are percent values of the input image. If for example percent=.1, the -number of pels of the input image with values greater than the returned int -will correspond to 10% of all pels of the image. - -The function is applied on one band FMTUCHAR images only. It can be -used in order to threshold the scaled result of a filtering operation. -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_conv(3), im_zerox(3). -.SH COPYRIGHT -N. Dessipris -.SH AUTHOR -N. Dessipris \- 14/05/1991 diff --git a/man/im_msb.3 b/man/im_msb.3 deleted file mode 100644 index 35e45abc..00000000 --- a/man/im_msb.3 +++ /dev/null @@ -1,63 +0,0 @@ -.TH IM_MSB 3 "06 May 2006" -.SH NAME - im_msb, im_msb_band \- Convert to uchar by discarding bits -.SH SYNOPSIS -.nf -.B #include -.sp -.BI "int im_msb( IMAGE " "*in" ", IMAGE " "*out" " ); -.br - -.BI "int im_msb_band( IMAGE " "*in" ", IMAGE " "*out" ", int " "band" " ); -.fi -.SH DESCRIPTION -.B im_msb(3) -converts char, short, or int images (including LABQ coded ones) into unsigned -char images, very quickly, by discarding the lower order bits. Once scaled to -char, signed values are converted to unsigned by adding 128. -.PP -For a signed short (16 bit) image, -.PP -im_msb( in, out ); -.PP -is equivalent to: -.PP -im_lintra( (1.0/256.0), in, 128.0, temp ); -.br -im_clip2fmt( temp, out, IM_BANDFMT_UCHAR ); -.PP -but much faster. -.PP -For any image which uses the whole range of values for its band format, -.PP -im_msb( in, out ); -.PP -is equivalent to: -.PP -im_scale( in, out ); -.PP -but a great deal faster, and without evaluating the input twice. -.PP -.B im_msb_band(3) -is as -.BR im_msb(3) , -except that all but one of the bands are also discarded. -.PP -im_msb_band( in, out, i ); -.PP -is equivalent to: -.PP -im_msb( in, temp ); -.br -im_extract_bands( temp, out, i, 1 ); -.PP -but again, faster. -.SH RETURN VALUE -The functions returns 0 on success and -1 on error. -.SH SEE ALSO -im_lintra(3), im_scale(3), im_clip(3) -.SH COPYRIGHT -.br -Copyright 2006, The Nottingham Trent University. -.SH AUTHOR -Tom Vajzovic diff --git a/man/im_msb_band.3 b/man/im_msb_band.3 deleted file mode 100644 index 7c697b04..00000000 --- a/man/im_msb_band.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_msb.3 diff --git a/man/im_multiply.3 b/man/im_multiply.3 deleted file mode 100644 index 29c07b75..00000000 --- a/man/im_multiply.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_cmulnorm.3 diff --git a/man/im_norm_dmask.3 b/man/im_norm_dmask.3 deleted file mode 100644 index 3b08512d..00000000 --- a/man/im_norm_dmask.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_create_dmask.3 diff --git a/man/im_notequal.3 b/man/im_notequal.3 deleted file mode 100644 index 141a819b..00000000 --- a/man/im_notequal.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_equal.3 diff --git a/man/im_notequal_vec.3 b/man/im_notequal_vec.3 deleted file mode 100644 index 141a819b..00000000 --- a/man/im_notequal_vec.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_equal.3 diff --git a/man/im_notequalconst.3 b/man/im_notequalconst.3 deleted file mode 100644 index 141a819b..00000000 --- a/man/im_notequalconst.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_equal.3 diff --git a/man/im_offsets45.3 b/man/im_offsets45.3 deleted file mode 100644 index 5504772e..00000000 --- a/man/im_offsets45.3 +++ /dev/null @@ -1,99 +0,0 @@ -.TH IM_OFFSETS45 3 "28 May 1991" -.SH NAME -im_offsets45, im_offsets90, im_rotate_imask45, im_rotate_dmask45, -im_rotate_imask90, im_rotate_dmask90 \- rotate square masks -.SH SYNOPSIS - -.B int *im_offsets45( size ) -.br -.B int size; - -.B int *im_offsets90( size ) -.br -.B int size; - -.B INTMASK *im_rotate_imask45( m, name ) -.br -.B INTMASK *m; -.br -.B char *name; - -.B DOUBLEMASK *im_rotate_dmask45( m, name ) -.br -.B DOUBLEMASK *m; -.br -.B char *name; - -.B INTMASK *im_rotate_imask90( m, name ) -.br -.B INTMASK *m; -.br -.B char *name; - -.B DOUBLEMASK *im_rotate_dmask90( m, name ) -.br -.B DOUBLEMASK *m; -.br -.B char *name; - -.SH DESCRIPTION -These functions can be used to produce the integer offsets needed to rotate -masks by 45 or 90 degrees clockwise. - -.B im_offsets45() -accepts only even size and returns a pointer to an int buffer of size*size. -The program mallocs the buffer and puts into it the integer offsets needed to -rotate a mask of even size size by 45 degrees. For instance if size is 3 the -program returns the buffer 3 0 1 6 4 2 7 8 5 which is the offsets needed to -rotate a mask with offsets 0 1 2 3 4 5 6 7 8. The function return a -pointer to valid data on success or NULL on error. Since the program mallocs -a buffer, the user should free the returned pointer accordingly. - -.B im_offsets90() -accepts any size and returns a pointer to an int buffer of size*size. The -program mallocs the buffer and puts into it the integer offsets needed to -rotate a mask of size size by 90 degrees. For instance if size is 3 the -program returns the buffer 6 3 0 7 4 1 8 5 2 which is the offsets needed to -rotate a mask with offsets 0 1 2 3 4 5 6 7 8. The function return a -pointers to valid data on success or NULL on error. Since the program mallocs -a buffer, the user should free the returned pointer accordingly. - -.B im_rotate_imask45() -rotates the INTMASK m by 45 degrees and returns the rotated mask. The filename -member of the returned structure is set to name. The program allocates memory -for the new mask and therefore the user must free the returned mask by a call -to im_free_imask(3). The returned mask is rotated by 45 degrees clockwise. -The function return a valid INTMASK pointer on success or NULL on error. - -.B im_rotate_dmask45() -rotates the DOUBLEMASK m by 45 degrees -and returns the rotated mask. The filename -member of the returned structure is set to name. The program allocates memory -for the new mask and therefore the user must free the returned mask by a call -to im_free_dmask(3). The returned mask is rotated by 45 degrees clockwise. -The function return a valid DOUBLEMASK pointer on success or NULL on error. - -.B im_rotate_imask90() -rotates the INTMASK m by 90 degrees and returns the rotated mask. The filename -member of the returned structure is set to name. The program allocates memory -for the new mask and therefore the user must free the returned mask by a call -to im_free_imask(3). The returned mask is rotated by 90 degrees clockwise. -The function return a valid INTMASK pointer on success or NULL on error. - -.B im_rotate_dmask90() -rotates the DOUBLEMASK m by 90 degrees -and returns the rotated mask. The filename -member of the returned structure is set to name. The program allocates memory -for the new mask and therefore the user must free the returned mask by a call -to im_free_dmask(3). The returned mask is rotated by 90 degrees clockwise. -The function return a valid DOUBLEMASK pointer on success or NULL on error. - -.SH RETURN VALUE -.SH SEE ALSO -im_read_imask(3), im_read_dmask(3), im_free_imask(3), im_free_dmask(3), -im_gradient(3), im_compass(3), im_conv(3). -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \-28/05/1991 diff --git a/man/im_offsets90.3 b/man/im_offsets90.3 deleted file mode 100644 index bf93b39a..00000000 --- a/man/im_offsets90.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_offsets45.3 diff --git a/man/im_open.3 b/man/im_open.3 deleted file mode 100644 index 726bd593..00000000 --- a/man/im_open.3 +++ /dev/null @@ -1,135 +0,0 @@ -.TH IM_OPEN 3 "30 October 1992" -.SH NAME -im_open, im_open_local, im_open_local_array \- open VIPS -image descriptor(s) -.SH SYNOPSIS -#include - -IMAGE *im_open( const char *filename, const char *mode ) - -IMAGE *im_open_local( IMAGE *im, const char *filename, const char *mode ) - -int im_open_local_array( IMAGE *im, - IMAGE **out, int n, const char *filename, const char *mode ) - -.SH DESCRIPTION -.B im_open(3) -examines the mode string, and creates an appropriate VIPS IMAGE descriptor. - -.B "r" -opens the named file for reading. If the file is not in the native VIPS format -for your machine, -.B im_open(3) -automatically converts the file for you in memory. For some large files (eg. -TIFF) this may not be what you want: you should call the appropriate converter -yourself, and arrange for the conversion to take place on disc. See -.B im_tiff2vips(3), -.B im_jpeg2vips(3), -.B im_png2vips(3), -.B im_magick2vips(3), -and -.B im_ppm2vips(3). - -.B im_open(3) -can read files in most formats. - -.B "w" -opens the named file for writing. It looks at the file name suffix to -determine the type to write -- for example: - - im_open( "fred.tif", "w" ) - -will write in TIFF format. - -You can pass parameters to the conversion functions encoded in the filename -string. For example: - - im_open( "fred.tif:deflate", "w" ) - -will write a deflate (ZIP) compressed TIFF file. See the man pages for -.B im_vips2tiff(3), -.B im_vips2jpeg(3), -.B im_vips2png(3) -and -.B im_vips2ppm(3) -for details on all of the options available. - -.B "t" -creates a temporary memory buffer image. - -.B "p" -creates a "glue" descriptor you can use to join two image processing -operations together. - -.B "rw" -opens the named file for reading and writing. This will only work for VIPS -files in a format native to your machine. It is only for paintbox-type -applications. - -.B im_open_local(3) -is a convenience function which opens an image descriptor as -im_open(3), but makes it local to im, that is, when im is closed, the -descriptor created by im_open_local(3) will be closed too. - -.B im_open_local(3) -is handy for saving you from adding many -.B im_close(3) -calls to -escape points. Example: find the total of an array of images. - - #include - - int - total( IMAGE **in, int nin, IMAGE *out ) - { - int i; - IMAGE *t1, *t2; - - if( nin <= 0 ) { - im_errormsg( "total: nin should be > 0" ); - return( -1 ); - } - else if( nin == 1 ) - return( im_copy( *in, out ) ); - else - for( t1 = *in, i = 1; i < nin; i++ ) { - if( i + 1 == nin ) - t2 = out; - else if( !(t2 = im_open_local( out, "t2", "p" )) ) - return( -1 ); - - if( im_add( t1, in[i], t2 ) ) - return( -1 ); - t1 = t2; - } - - return( 0 ); - } - -This function will create many intermediate images, but does not need to close -them. Any which are created will be closed automatically when out is closed by -our caller. - -.B im_open_local(3) -returns NULL on error, or if its first parameter is NULL. - -.B im_open_local_array(3) -will open an array of images, failing if any of the opens fail. It's handy if -you need a number of images for intermediates. Example: - - IMAGE *t[6]; - - if( im_open_local_array( out, t, 6, "mytemps", "p" ) ) - return( -1 ); - -opens 6 temp images (t[0] to t[5]). - -.SH RETURN VALUE -The function returns the image descriptor on success and NULL on error. -.SH SEE ALSO -im_close(3), im_vips2tiff(3), im_vips2jpeg(3), im_vips2ppm(3), -im_tiff2vips(3), im_jpeg2vips(3), im_ppm2vips(3). -.SH COPYRIGHT -K. Martinez, 1992. -.SH AUTHOR -K. Martinez. diff --git a/man/im_open_local.3 b/man/im_open_local.3 deleted file mode 100644 index 227e5534..00000000 --- a/man/im_open_local.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_open.3 diff --git a/man/im_open_local_array.3 b/man/im_open_local_array.3 deleted file mode 100644 index 227e5534..00000000 --- a/man/im_open_local_array.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_open.3 diff --git a/man/im_openout.3 b/man/im_openout.3 deleted file mode 100644 index ddbc4bb9..00000000 --- a/man/im_openout.3 +++ /dev/null @@ -1,22 +0,0 @@ -.TH IM_OPENOUT 3 "22 April 1991" -.SH NAME -im_openout \- sets an image descriptor corresponding to an output file -.SH SYNOPSIS -.B #include - -.B IMAGE *im_openout(file_name) -.br -.B char *file_name; -.SH DESCRIPTION -.B im_openout(3) -returns a descriptor which when written to will write pels to file_name. This -function has been replaced by im_open(3). -.SH RETURN VALUE -The function returns a valid image descriptor on success and NULL on error. -.SH SEE\ ALSO -im_open(3), im_close(3), im_mmapin(3), im_intro(3). -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 22/04/1991 diff --git a/man/im_or_vec.3 b/man/im_or_vec.3 deleted file mode 100644 index dfcd881e..00000000 --- a/man/im_or_vec.3 +++ /dev/null @@ -1,2 +0,0 @@ -.so man3/im_andimage.3 - diff --git a/man/im_orconst.3 b/man/im_orconst.3 deleted file mode 100644 index dfcd881e..00000000 --- a/man/im_orconst.3 +++ /dev/null @@ -1,2 +0,0 @@ -.so man3/im_andimage.3 - diff --git a/man/im_orimage.3 b/man/im_orimage.3 deleted file mode 100644 index 46ff7aff..00000000 --- a/man/im_orimage.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_andimage.3 diff --git a/man/im_outcheck.3 b/man/im_outcheck.3 deleted file mode 100644 index e0092c33..00000000 --- a/man/im_outcheck.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_iocheck.3 diff --git a/man/im_paintrect.3 b/man/im_paintrect.3 deleted file mode 100644 index 812dd46d..00000000 --- a/man/im_paintrect.3 +++ /dev/null @@ -1,124 +0,0 @@ -.TH IM_AND 3 "30 October 1992" -.SH NAME -im_paintrect, im_plotmask, im_readpoint, im_plotpoint, im_fastline, -im_fastlineuser \- suck pels up, and paint them down somewhere else -.SH SYNOPSIS -.B #include - -int im_readpoint( im, x, y, ink ) -.br -IMAGE *im; -.br -int x, y; -.br -PEL *ink; - -int im_plotpoint( im, x, y, ink ) -.br -IMAGE *im; -.br -int x, y; -.br -PEL *ink; - -int im_plotmask( im, ix, iy, ink, mask, r ) -.br -IMAGE *im; -.br -int ix, iy; -.br -PEL *ink; -.br -PEL *mask; -.br -Rect *r; - -int im_paintrect( im, r, ink ) -.br -IMAGE *im; -.br -Rect *r; -.br -PEL *ink; - -int im_fastline( im, x1, y1, x2, y2, ink ) -.br -IMAGE *im; -.br -int x1, y1, x2, y2; -.br -PEL *ink; - -int im_fastlineuser( im, x1, y1, x2, y2, -.br - plot_fn, client1, client2, client3 ) -.br -IMAGE *im; -.br -int x1, y1, x2, y2; -.br -int (*plot_fn)(); -.br -void *client1, *client2, *client3; - -int plot_fn( im, x, y, client1, client2, client3 ) -.br -IMAGE *im; -.br -int x, y; -.br -void *client1, *client2, *client3; - -int im_lineset( IMAGE *in, IMAGE *out, IMAGE *mask, IMAGE *ink, -.br - int n, int *x1v, int *y1v, int *x2v, int *y2v ) - -.SH DESCRIPTION -.B im_readpoint(3) -sucks a pel from position (x,y) into a buffer; all other -functions paint that buffer back again in various ways. These functions will -work for an image of any type, since they rely on -.B im_readpoint(3) -for their -data. If you read a pel from one image and paint with it to another, it is -your responsibility to check that the two images have identical pels. - -All these functions are `in place,' that is, they write directly to the -output image! Be very careful, you can destroy data. - -.B im_plotmask(3) -takes an array of 0/255s and a Rect describing the size and -offset of the array. It adds (ix,iy) to the array offset, and then paint pels -into all array positions which are non-zero. Rect need not lie inside the -image - the function clips carefully at the edges. - -.B im_paintrect(3) -fills the rectangle described with ink. The Rect can be any -size and at any position - the function clipps against the edges of the -image. - -.B im_fastline(3) -is a replacement for -.B im_line(3) -which plots the specified ink in -the image. The start and end points must lie entirely inside the image. - -.B im_fastlineuser(3) -does not plot points, instead it calls a user plot function -for every position along the line. There is no clipping - the endpoints may be -anywhere at all. Three client values are carried around and passed into the -user function. - -.B im_lineset(3) -copies the image and draws a set of lines on the copy. The lines are drawn -using the mask image as a brush to apply the ink image. Useful for nip2. - -.SH RETURN VALUE -All functions return 0 on success and -1 on error. -.SH SEE\ ALSO -im_insertplace(3), im_smudge(3). -.SH COPYRIGHT -.br -National Gallery, 1992 -.SH AUTHOR -J. Cupitt diff --git a/man/im_partial.3 b/man/im_partial.3 deleted file mode 100644 index 82396807..00000000 --- a/man/im_partial.3 +++ /dev/null @@ -1,24 +0,0 @@ -.TH IM_OPENOUT 3 "22 April 1991" -.SH NAME -im_partial \- makes a PIO intermediate image -.SH SYNOPSIS -.B #include - -.B IMAGE *im_partial(file_name) -.br -.B char *file_name; -.SH DESCRIPTION -.B im_partial(3) -returns a descriptor which can be used to join PIO image processing -operations together. - -This function is obsolete --- you should call im_open(3) instead. -.SH RETURN VALUE -The function returns a valid image descriptor on success and NULL on error. -.SH SEE ALSO -im_open(3), im_close(3), im_mmapin(3), im_intro(3). -.SH COPYRIGHT -.br -National Gallery, 1993 -.SH AUTHOR -J.Cupitt \- 23/7/93 diff --git a/man/im_pincheck.3 b/man/im_pincheck.3 deleted file mode 100644 index 1dc8c392..00000000 --- a/man/im_pincheck.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_piocheck.3 diff --git a/man/im_piocheck.3 b/man/im_piocheck.3 deleted file mode 100644 index 98280199..00000000 --- a/man/im_piocheck.3 +++ /dev/null @@ -1,36 +0,0 @@ -.TH IM_IOCHECK 3 "11 April 1990" -.SH NAME -im_pincheck, im_poutcheck, im_piocheck \- checks image descriptors for -PIO -.SH SYNOPSIS -.B #include - -int im_pincheck( in ) -.br -IMAGE *in; - -int im_poutcheck( out ) -.br -IMAGE *out; - -.B int im_piocheck( in, out) -.br -.B IMAGE *in, *out; -.SH DESCRIPTION -.B im_pincheck(3) -checks that an image descriptor is suitable for PIO input. If the descriptor is -IM_OPENOUT and the descriptor has been written to, it is automatically -`rewound,' that is, it is closed and reopened as an IM_MMAPIN descriptor. - -im_poutcheck(3) checks that a descriptor is suitable for PIO output. - -im_piocheck(3) simply calls in_pincheck(3) for image in and im_poutcheck(3) for -image out. -.SH RETURN VALUE -All functions returns 0 on success and -1 on error. -.SH SEE\ ALSO -im_generate(3), im_open(3). -.SH COPYRIGHT -National Gallery -.SH AUTHOR -J. Cupitt \- 23/7/93 diff --git a/man/im_plotmask.3 b/man/im_plotmask.3 deleted file mode 100644 index 24a57b00..00000000 --- a/man/im_plotmask.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_paintrect.3 diff --git a/man/im_plotpoint.3 b/man/im_plotpoint.3 deleted file mode 100644 index 24a57b00..00000000 --- a/man/im_plotpoint.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_paintrect.3 diff --git a/man/im_png2vips.3 b/man/im_png2vips.3 deleted file mode 100644 index 04890af2..00000000 --- a/man/im_png2vips.3 +++ /dev/null @@ -1,50 +0,0 @@ -.TH IM_PNG 3 "3 Jan 2003" -.SH NAME -im_png2vips, im_png2vips \- convert PNG images to and from VIPS format -.SH SYNOPSIS -#include - -int im_png2vips( const char *filename, IMAGE *out ) - -int im_vips2png( IMAGE *in, const char *filename ) - -.SH DESCRIPTION -.B im_png2vips(3) -reads the png image in filename, and writes the image out -in VIPS format. - -.B im_vips2png(3) -reads the image in and writes a PNG file to the specified -filename. The filename may include an optional mode string, following a ':' -character, which you can use to specify compression and interlace. - -The mode string has the following syntax: - - , - -where is an integer between 0 and 9 specifying the amount of -compression (6 is the default), and is 0 for no interlace (this is -the default) and 1 for ADAM7 interlace. - -Beware that writing an interlaced image is potentially up to 7 times slower -than writing a non-interlaced image. - -The image is automatically converted to RGB or Monochrome (with an optional -alpha channel) before saving. - -.SH EXAMPLES - -The call: - - im_vips2png fred.v fred.png - -Writes a compression 6, uninterlaced PNG image. - - im_vips2png fred.v fred.tif:,1 - -Writes an interlaced image. - -.SH SEE ALSO -im_open(3), im_vips2tiff(3) -.SH COPYRIGHT -Hey, you want this? You have it! diff --git a/man/im_poutcheck.3 b/man/im_poutcheck.3 deleted file mode 100644 index 1dc8c392..00000000 --- a/man/im_poutcheck.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_piocheck.3 diff --git a/man/im_powtra.3 b/man/im_powtra.3 deleted file mode 100644 index 9ae2c5a1..00000000 --- a/man/im_powtra.3 +++ /dev/null @@ -1,2 +0,0 @@ -.so man3/im_exp10tra.3 - diff --git a/man/im_powtra_vec.3 b/man/im_powtra_vec.3 deleted file mode 100644 index b7685e3d..00000000 --- a/man/im_powtra_vec.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_exp10tra.3 diff --git a/man/im_ppm2vips.3 b/man/im_ppm2vips.3 deleted file mode 100644 index 95a5a505..00000000 --- a/man/im_ppm2vips.3 +++ /dev/null @@ -1,32 +0,0 @@ -.TH IM_PPM 3 "November 2000" -.SH NAME -im_ppm2vips, im_vips2ppm \- convert PPM/PGM/PBM images to and from VIPS format -.SH SYNOPSIS -#include - -int im_ppm2vips( const char *filename, IMAGE *out ) - -int im_vips2ppm( IMAGE *in, const char *filename ) - -.SH DESCRIPTION -.B im_ppm2vips(3) -reads the PPM/PGM/PBM image in filename, and writes the image out -in VIPS format. It can read 1, 8, 16 and 32 bit images, colour or monochrome, -stored in binary or in ASCII. One bit images become 8 bit VIPS images, with 0 -and 255 for 0 and 1. - -.B im_vips2ppm(3) -writes the VIPS image to the named file in PPM format. It can write 8, 16 or -32 bit integer images, colour or monochrome, stored as binary or ASCII. Images -of more than 8 bits can only be stored in ASCII. - -The storage format is indicated by a filename extension. - - im_vips2ppm( im, "fred.ppm:ascii" ) - -will write to "fred.ppm" in ascii format. The default is binary. - -.SH SEE ALSO -im_open(3) -.SH COPYRIGHT -Hey, you want this? You have it! diff --git a/man/im_prepare.3 b/man/im_prepare.3 deleted file mode 100644 index e1f5357f..00000000 --- a/man/im_prepare.3 +++ /dev/null @@ -1,89 +0,0 @@ -.TH IM_PREPARE 3 "11 April 1990" -.SH NAME -im_prepare, im_prepare_to \- fill region with data -.SH SYNOPSIS -.B #include - -int im_prepare( reg, r ) -.br -REGION *reg; -.br -Rect *r; - -int im_prepare_to( reg, dest, r, x, y ) -.br -REGION *reg, *dest; -.br -Rect *r; -.br -int x, y; - -int im_prepare_many( reg, r ) -.br -REGION **reg; -.br -Rect *r; - -.SH DESCRIPTION -.B im_prepare(3) -fills region reg with pels covering the area inside r. - -r is expected to lie within the image on which reg was defined; if it does not -it will be clipped against the size of the image. Consequence: if - - im_prepare( reg, r ) - -succeeds, VIPS guarantees that pels within reg->valid may be read from reg -with -.B IM_REGION_ADDR(3). -It does not guarantee that you may read all of r! - -The action taken by im_prepare(3) depends upon the image descriptor on which -reg was defined: - -PARTIAL: The area requested is clipped against the edges of the image, local -memory is attached to reg with -.B im_region_buffer(3) -and that area requested -from the image's generate function, see -.B im_generate(3). -If necessary, a new -sequence is started. - -SETBUF: MMAPIN: MMAPINRW: The area defined by r is clipped against the edges -of the image, and that area attached to reg. - -.B im_prepare_to(3) -is very like -.B im_prepare(3), -but rather than writing pixels to local memory on reg (or attaching reg to -some other piece of memory), it instead writes pixels into the region dest at -position x, y. The parameters dest, r, x, y behave in the same way as the -paramaters to -.B im_region_region(3). - -Effectively, it's just like -.B im_prepare(3) -followed by a copy operation. Except that the copy will be skipped when -possible. - -This call is used by (among others) -.B im_generate(3) -to make operations output to -disc buffers, and by -.B im_embed(3) -to get images written inside larger images. - -.B im_prepare_many(3) -prepares the same Rect on a NULL terminated array of REGION pointers, as -returned by -.BR im_start_many(3) . - -.SH RETURN VALUE -The function returns 0 on success and non-zero on error. -.SH SEE ALSO -im_generate(3), im_open(3). -.SH COPYRIGHT -National Gallery -.SH AUTHOR -J. Cupitt \- 23/7/93 diff --git a/man/im_prepare_many.3 b/man/im_prepare_many.3 deleted file mode 100644 index 381ca378..00000000 --- a/man/im_prepare_many.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_prepare.3 diff --git a/man/im_prepare_to.3 b/man/im_prepare_to.3 deleted file mode 100644 index 381ca378..00000000 --- a/man/im_prepare_to.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_prepare.3 diff --git a/man/im_print.3 b/man/im_print.3 deleted file mode 100644 index e1ebc80f..00000000 --- a/man/im_print.3 +++ /dev/null @@ -1,21 +0,0 @@ -.TH IM_PRINT 3 "January 2002" -.SH NAME -im_print \- print a string to stdout -.SH SYNOPSIS -#include - -int -.br -im_print( const char *message ) - -.SH DESCRIPTION -.B im_print() -prints the message to stdout, with a newline. Sometimes useful for debugging -language bindings. - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_system(3) -.SH COPYRIGHT -2002 The National Gallery diff --git a/man/im_print_dmask.3 b/man/im_print_dmask.3 deleted file mode 100644 index 3b08512d..00000000 --- a/man/im_print_dmask.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_create_dmask.3 diff --git a/man/im_print_imask.3 b/man/im_print_imask.3 deleted file mode 100644 index 3b08512d..00000000 --- a/man/im_print_imask.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_create_dmask.3 diff --git a/man/im_printdesc.3 b/man/im_printdesc.3 deleted file mode 100644 index 240e79c7..00000000 --- a/man/im_printdesc.3 +++ /dev/null @@ -1,64 +0,0 @@ -.TH IM_PRINTDESC 3 "11 April 1990" -.SH NAME -im_printdesc, im_Type2char, im_char2Type, im_BandFmt2char, im_char2BandFmt, -im_Coding2char, im_char2Coding, im_Compression2char, im_char2Compression -\- decode image descriptors - -.SH SYNOPSIS -.B #include - -.B void im_printdesc(image) -.br -.B IMAGE *image; - -char *im_Type2char( ty ); -.br -int ty; - -char *im_BandFmt2char( bf ); -.br -int bf; - -char *im_Coding2char( cod ); -.br -int cod; - -char *im_Compression2char( comp ); -.br -int comp; - -int im_char2Type( str ); -.br -char *str; - -int im_char2BandFmt( str ); -.br -char *str; - -int im_char2Coding( str ); -.br -char *str; - -int im_char2Compression( str ); -.br -char *str; - -.SH DESCRIPTION -.B im_printdesc(3) -prints the image descriptor pointed by image. - -.B im_printdesc(3) -exports the functions it uses to code and uncode the type fields -in image headers. The functions which return char * return a static string of -the form "" on error, - -The functions which return int return -1 on error, -setting -.B im_error(3). - -.SH SEE ALSO -header(1). -.SH COPYRIGHT -N. Dessipris -.SH AUTHOR -N. Dessipris \- 11/04/1990 diff --git a/man/im_printlines.3 b/man/im_printlines.3 deleted file mode 100644 index 4db97dcb..00000000 --- a/man/im_printlines.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_debugim.3 diff --git a/man/im_profile.3 b/man/im_profile.3 deleted file mode 100644 index a181029c..00000000 --- a/man/im_profile.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_cntlines.3 diff --git a/man/im_project.3 b/man/im_project.3 deleted file mode 100644 index c51b3326..00000000 --- a/man/im_project.3 +++ /dev/null @@ -1,34 +0,0 @@ -.TH IM_PROJECT 3 "10 April 2006" -.SH NAME -im_project \- find horizontal and vertical projections -.SH SYNOPSIS -#include - -int im_project(IMAGE *in, IMAGE *hout, IMAGE *vout) - -.SH DESCRIPTION -.B im_project(3) -finds the horizontal and vertical projections of an image, that is, the sum of -each row and the sum of each column. - -The -.B hout -result image is 1 x in->Ysize pixels, where each pixel is the sum of all the -pixels in that row of the input image. -The -.B vout -result image is in->Xsize x 1 pixels, where each pixel is the sum of all the -pixels in that column of the input image. - -The output images are of the largest appropriate type for the input image: so -unsigned integer images produce UINT output, and so on. The output images have -the same number of bands as the input. - -The operation does not work for complex images, or for coded images. - -.SH RETURNED VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_histplot(3), im_histnorm(3), im_extract(3). -.SH COPYRIGHT -Imperial College, 2006 diff --git a/man/im_quantim.3 b/man/im_quantim.3 deleted file mode 100644 index c25c5138..00000000 --- a/man/im_quantim.3 +++ /dev/null @@ -1,53 +0,0 @@ -.TH IM_QUANTIM 3 "10 May 1991" -.SH NAME -im_quantim, im_quantlut, im_spatres \- quantise an image or a lut -.SH SYNOPSIS -.B #include - -.B int im_quantim(in, out, no_of_bits) -.br -.B IMAGE *in, *out; -.br -.B int no_of_bits; - -.B int im_quantlut(lut, no_of_bits) -.br -.B IMAGE *lut; -.br -.B int no_of_bits; - -.B int im_spatres(in, out, step) -.br -.B IMAGE *in, *out; -.br -.B int step; -.SH DESCRIPTION -.B im_quantim() -quantises the image file held by in using no_of_bits and writes the result to -out. The no_of_bits should be between 1 and 7 inclusive. Input can have any -number of bands. The function expects as input a valid unsigned char image. - -These functions are here for compatibility only. You should use the boolean -operations im_andconst(3), im_orconst(3), im_shrink(3), im_zoom(3) and -im_lowpass(3). - -.B im_quantlut() -creates an one band unsigned char -lookup table which is used by im_quantim(3). -The no_of_bits should be between 1 and 7 inclusive. - -.B im_spatres() -reduces the spatial resolution of in by averaging step*step pixels -and replicating the result in out. The function can be used in -order to show the effect of reducing the spatial resolution of a given image -and the importance of post-filtering before displaying. -Input can have any number of bands. -.SH RETURN VALUE -All functions returns 0 on success and -1 on error. -.SH SEE ALSO -im_andconst(3), im_orconst(3), im_shrink(3), im_zoom(3) im_lowpass(3). -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 10/05/1991 diff --git a/man/im_quantlut.3 b/man/im_quantlut.3 deleted file mode 100644 index 81b965d9..00000000 --- a/man/im_quantlut.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_quantim.3 diff --git a/man/im_rad2float.3 b/man/im_rad2float.3 deleted file mode 100644 index 337b3f34..00000000 --- a/man/im_rad2float.3 +++ /dev/null @@ -1,38 +0,0 @@ -.TH IM_RAD2FLOAT 3 "25 March 2009" -.SH NAME -im_rad2float, im_float2rad \- convert RAD coded images to float and back -.SH SYNOPSIS -#include - -int im_rad2float( IMAGE *in, IMAGE *out ) - -int im_float2rad( IMAGE *in, IMAGE *out ) - -.SH DESCRIPTION -These functions convert -.B IM_CODING_RAD -images to 3-band float and back. - -.B im_rad2float(3) -unpacks a 4-band uchar image in -.B IM_CODING_RAD -format to 3-band float. RAD images are used by the -.B radiance(1) -family of programs for HDR imaging. - -Some VIPS operations will work directly on the packed RAD images (such as -.B im_extract_area(3) -) but many will require the image to be unpacked to 3-band float for -processing. - -.B im_float2rad(3) -packs a 3-band float image back to 4-band uchar in -.B IM_CODING_RAD -format. - -.SH RETURN VALUE -The functions return 0 on success and -1 on error. -.SH SEE ALSO -im_LabQ2Lab(3), im_format(3). -.SH AUTHOR -J. Cupitt \- 23 March 2009 diff --git a/man/im_rank.3 b/man/im_rank.3 deleted file mode 100644 index 24679f49..00000000 --- a/man/im_rank.3 +++ /dev/null @@ -1,47 +0,0 @@ -.TH IM_RANK 3 "19 Aug 1996" -.SH NAME -im_rank, im_rank_raw \- rank filter -.SH SYNOPSIS -#include - -int im_rank(in, out, xsize, ysize, n) -.br -IMAGE *in, *out; -.br -int xsize, ysize, n; - -int im_rank_raw(in, out, xsize, ysize, n) -.br -IMAGE *in, *out; -.br -int xsize, ysize, n; - -.SH DESCRIPTION -.B im_rank() -does rank filtering on an image. A window of size xsize by ysize -is passed over the image. At each position, the pixels inside the window are -sorted into ascending order and the pixel at the nth position is output. n -numbers from 0. - -It works for any non-complex image type, with any number of bands. -The input -is expanded by copying edge pixels before performing the operation so that the -output image has the same size as the input. Edge pixels in the output image -are therefore only approximate. - -.B im_rank_raw() -works just as im_rank(), but does not expand the input. -.SH EXAMPLES -For a median filter with mask size m (3 for 3x3, 5 for 5x5, etc.) use - - im_rank( in, out, m, m, m * m / 2 ); - -The special cases n == 0 and n == m * m - 1 are useful dilate and expand -operators. - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_conv(3), im_fastcor(3). -.SH COPYRIGHT -1989-1996 The National Gallery and Birkbeck College diff --git a/man/im_rank_image.3 b/man/im_rank_image.3 deleted file mode 100644 index 34274649..00000000 --- a/man/im_rank_image.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_compass.3 diff --git a/man/im_raw2vips.3 b/man/im_raw2vips.3 deleted file mode 100644 index 13a80525..00000000 --- a/man/im_raw2vips.3 +++ /dev/null @@ -1,39 +0,0 @@ -.TH IM_RAW2VIPS 3 "4 August 2005" -.SH NAME -im_raw2vips, im_vips2raw \- wrap a raw binary file inside an IMAGE descriptor -.SH SYNOPSIS -.B #include - -int -.br -im_raw2vips( const char *filename, IMAGE *out, -.br - int width, int height, int bpp, int offset ) - -int -.br -im_vips2raw( IMAGE *in, int fd ) - - -.SH DESCRIPTION -.B im_raw2vips(3) -mmaps the file named, setting image -.B out -so that access to that image will read from the file. -The parameters specify the image width, height, bytes per pixel and offset -in bytes from the start of the file. - -Use functions like -.B im_copy_morph(3) -to set the pixel type, byte ordering and so on. - -.B im_vips2raw(3) -writes the pixels in the IMAGE to the file descriptor. It's handy for writing -writers for other formats. - -.SH RETURN VALUE -The functions return NULL on error. -.SH SEE ALSO -im_copy_morph(3), im_copy_swap(3). -.SH COPYRIGHT -Imperial College, 2005 diff --git a/man/im_read_dmask.3 b/man/im_read_dmask.3 deleted file mode 100644 index 3b08512d..00000000 --- a/man/im_read_dmask.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_create_dmask.3 diff --git a/man/im_read_imask.3 b/man/im_read_imask.3 deleted file mode 100644 index 3b08512d..00000000 --- a/man/im_read_imask.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_create_dmask.3 diff --git a/man/im_readpoint.3 b/man/im_readpoint.3 deleted file mode 100644 index 24a57b00..00000000 --- a/man/im_readpoint.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_paintrect.3 diff --git a/man/im_recomb.3 b/man/im_recomb.3 deleted file mode 100644 index c0481d11..00000000 --- a/man/im_recomb.3 +++ /dev/null @@ -1,36 +0,0 @@ -.TH IM_RECOMB 3 "11 April 1990" -.SH NAME -im_recomb \- matrix recombination of image -.SH SYNOPSIS -#include - -int im_recomb(imagein, imageout, mat) -.br -IMAGE *imagein, *imageout; -.br -DOUBLEMASK *mat; - -.SH DESCRIPTION -im_recomb() recombines the elements of an m band image to form an n band image -using mat, an m by n matrix of floating point numbers. - -It calculates - - A = B x C - -where A is an n band output image, C is an m band input image and B -is an m by n matrix of floats. Can be used with a 3 by 3 matrix to perform -simple colour space transforms; 7 by 30 matrix to shrink 3rd order -development of 3 filter system to XYZ etc. - -The output type is float unless the input type is double, in which case the -output type is double. It does not work for complex image types. All -intermediates are calculated as double. Note that the width of the matrix -should be equal to the number of bands in the input image. - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_read_dmask(3), im_matinv(3), im_lintra(3) -.SH COPYRIGHT -National Gallery and Birkbeck College, 1990 - 1996 diff --git a/man/im_rect_dup.3 b/man/im_rect_dup.3 deleted file mode 100644 index 0ad304e6..00000000 --- a/man/im_rect_dup.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_rect_marginadjust.3 diff --git a/man/im_rect_equalsrect.3 b/man/im_rect_equalsrect.3 deleted file mode 100644 index 0ad304e6..00000000 --- a/man/im_rect_equalsrect.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_rect_marginadjust.3 diff --git a/man/im_rect_includespoint.3 b/man/im_rect_includespoint.3 deleted file mode 100644 index 0ad304e6..00000000 --- a/man/im_rect_includespoint.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_rect_marginadjust.3 diff --git a/man/im_rect_includesrect.3 b/man/im_rect_includesrect.3 deleted file mode 100644 index 0ad304e6..00000000 --- a/man/im_rect_includesrect.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_rect_marginadjust.3 diff --git a/man/im_rect_intersectrect.3 b/man/im_rect_intersectrect.3 deleted file mode 100644 index 0ad304e6..00000000 --- a/man/im_rect_intersectrect.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_rect_marginadjust.3 diff --git a/man/im_rect_isempty.3 b/man/im_rect_isempty.3 deleted file mode 100644 index 0ad304e6..00000000 --- a/man/im_rect_isempty.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_rect_marginadjust.3 diff --git a/man/im_rect_marginadjust.3 b/man/im_rect_marginadjust.3 deleted file mode 100644 index 488e2f34..00000000 --- a/man/im_rect_marginadjust.3 +++ /dev/null @@ -1,79 +0,0 @@ -.TH Rect 3 "2 May 1991" -.SH NAME -im_rect_marginadjust, im_rect_includespoint, im_rect_includesrect, -im_rect_intersectrect, im_rect_isempty, im_rect_unionrect, im_rect_normalise, -im_rect_equalsrect, im_rect_dup, -IM_RECT_RIGHT, IM_RECT_BOTTOM, IM_RECT_HCENTRE, IM_RECT_VCENTRE -\- rectangle algebra functions -.SH SYNOPSIS -#include - -typedef struct { -.br - int left, top, width, height; -.br -} Rect; - -#define IM_RECT_RIGHT(R) ((R)->left + (R)->width) -.br -#define IM_RECT_BOTTOM(R) ((R)->top + (R)->height) -.br -#define IM_RECT_HCENTRE(R) ((R)->left + (R)->width / 2) -.br -#define IM_RECT_VCENTRE(R) ((R)->top + (R)->height / 2) - -void im_rect_marginadjust( Rect *r, int n ); -.br -int im_rect_includespoint( Rect *r, int x, int y ); -.br -int im_rect_includesrect( Rect *r1, Rect *r2 ); -.br -void im_rect_intersectrect( Rect *r1, Rect *r2, Rect *r3 ); -.br -int im_rect_isempty( Rect *r ); -.br -void im_rect_unionrect( Rect *r1, Rect *r2, Rect *r3 ); -.br -int im_rect_equalsrect( Rect *r1, Rect *r2 ); -.br -Rect *im_rect_dup( Rect *r ); -.br -void im_rect_normalise( Rect *r ); -.SH DESCRIPTION -These functions perform simple algebra on Rect structs. There should also be a -set of functions to do rectlist algebra. - -im_rect_marginadjust(3) expands a Rect by n units up, down, left and right. -Negative expansions shrink the Rect. - -im_rect_includespoint(3) returns non-zero -if point (x,y) lies within Rect r. - -im_rect_includesrect(3) returns non-zero if -Rect r2 lies completely within Rect r1. - -im_rect_intersectrect(3) fills Rect r3 -with the intersection of Rects r1 and r2. - -im_rect_isempty(3) returns non-zero -if Rect r has either width less than or equal to 0 or height less than or -equal to 0. - -im_rect_unionrect(3) fills Rect r3 with the bounding box of Rect r1 and Rect -r2. A proper union operation requires lists of rectangles, sadly. - -im_rect_equalsrect(3) returns non-zero if r1 and r2 are identical. - -im_rect_dup(3) allocates memory for a new Rect structure and copies the -elements of r into it. It returns a pointer to the new struct, or NULL on -error. - -im_rect_normalise(3) flips r so that the same pixels are enclosed, -but width and height are guaranteed >=0. - -.SH SEE ALSO -im_prepare(3), im_region_create(3) -.SH COPYRIGHT -National Gallery, 1992 -.SH AUTHOR -J. Cupitt diff --git a/man/im_rect_normalise.3 b/man/im_rect_normalise.3 deleted file mode 100644 index 0ad304e6..00000000 --- a/man/im_rect_normalise.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_rect_marginadjust.3 diff --git a/man/im_rect_unionrect.3 b/man/im_rect_unionrect.3 deleted file mode 100644 index 0ad304e6..00000000 --- a/man/im_rect_unionrect.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_rect_marginadjust.3 diff --git a/man/im_region_buffer.3 b/man/im_region_buffer.3 deleted file mode 100644 index 327feefe..00000000 --- a/man/im_region_buffer.3 +++ /dev/null @@ -1,117 +0,0 @@ -.TH REGION-OPERATIONS 3 "11 April 1990" -.SH NAME -im_region_buffer, im_region_image, im_region_region, im_region_position, -im_region_equalsregion \- -attach data to region -.SH SYNOPSIS -.B #include - -int im_region_buffer( reg, r ) -.br -REGION *reg; -.br -Rect *r; - -int im_region_image( reg, r ) -.br -REGION *reg; -.br -Rect *r; - -int im_region_region( reg, treg, r, x, y ) -.br -REGION *reg, treg; -.br -Rect *r; -.br -int x, y; - -int im_region_position( reg, x, y ) -.br -REGION *reg; -.br -int x, y; - -int im_region_equalsregion( REGION *reg1, REGION *reg2 ) - -.SH DESCRIPTION -These functions are used to say where exactly input from or output to a -region goes. Briefly, -.B im_region_buffer(3) -gives a region its own piece of local storage, -.B im_region_image(3) -links the region to an image, and -.B im_region_region(3) -links the region to another region. - -.B im_region_region(3) -is the most powerful of the three --- you can use it to -avoid copy operations. See the source for -.B im_extract(3), -.B im_insert(3), -.B im_copy(3), -.B im_embed(3), -and -.B im_lrmerge(3) -for examples of its use, and see also -.B im_prepare_copy(3). - -.B im_region_buffer(3) -clips Rect r against the size of the image upon which reg is -defined, then searches for any calculated pixels which enclose that area. If -there are any suitable pixels already, the region is set to point to them. -Otherwise, a fresh buffer is allocated. - -If region->buffer->done is set, then the region is already calculated. -Otherwise, the pixels need to be calculated. - -.B im_region_buffer(3) -is called by -.B im_prepare(3) -just before it calls the user generate function. - -.B im_region_image(3) -attaches reg to the image on which it was defined. The image -has to be SETBUF, MMAPIN, MMAPINRW, or OPENIN --- ie., the types passed by -.B im_incheck(3). - -.B im_region_region(3) -redirects reg to treg. treg can be defined on another -image. r is clipped against the size of reg's image, and against treg->valid. -treg has to have pel data associated with it (ie. memory local to treg, memory -that is part of the image on which treg is defined, or even memory from a -third region), and the pel data has to be in a form which is compatible with -reg, ie. BandFmt and Bands must be the same. - -r becomes the valid field in reg, (x,y) is the top left-hand corner of the -area in treg to which valid is mapped. - - -.B im_region_position(3) -changes reg->valid, so that reg->valid.left == x and -reg->valid.top == y. width and height are clipped against the size of the -image. If x < 0 or y < 0 or the clipped rect has zero width or height, the -call fails. - -This function affects the way that pels are addressed by the -.B IM_REGION_ADDR(3) -macro. It does not affect the pels themselves! It has the effect of moving -the area of pels a region represents. This call is used by -.B im_extract(3). - -.B im_region_equalsregion(3) -tests for reg1 and reg2 are identical, ie.: - - IM_REGION_ADDR( reg1, x, y ) == - IM_REGION_ADDR( reg2, x, y ) && - *IM_REGION_ADDR( reg1, x, y ) == - *IM_REGION_ADDR( reg2, x, y ) - -It is used internally by VIPS, but may be useful to applications. - -.SH RETURN VALUE -All int-valued functions return zero on success and non-zero on error. -.SH COPYRIGHT -National Gallery, 1993 -.SH AUTHOR -J. Cupitt \- 23/7/93 diff --git a/man/im_region_create.3 b/man/im_region_create.3 deleted file mode 100644 index b05fb735..00000000 --- a/man/im_region_create.3 +++ /dev/null @@ -1,38 +0,0 @@ -.TH PREDICATES 3 "11 April 1990" -.SH NAME -im_region_create, im_region_free \- region creation and destruction -.SH SYNOPSIS -.B #include - -REGION *im_region_create( im ) -.br -IMAGE *im; - -int im_region_free( reg ) -.br -REGION *reg; -.SH DESCRIPTION -These functions create and destroy regions on images. Regions are used for -PIO, see accompanying documentation. Regions have type - - typedef struct { - Rect valid /* Area of im represented */ - IMAGE *im; /* im we are defined on */ - - ... more fields, all private and used for - ... housekeeping - } REGION; - -im_region_create(3) returns a pointer to a new region, or NULL on error. -Regions are made blank, with no input or output possible. See im_prepare(3), -im_generate(3), im_start_one(3) and IM_REGION_ADDR(3). - -im_region_free(3) frees a region and any resources associated with that -region. When an image is closed, all regions which have been created on that -image are automatically freed. -.SH RETURN VALUE -All int-valued functions return zero on success and non-zero on error. -.SH COPYRIGHT -National Gallery, 1993 -.SH AUTHOR -J. Cupitt \- 23/7/93 diff --git a/man/im_region_free.3 b/man/im_region_free.3 deleted file mode 100644 index d21d2aa2..00000000 --- a/man/im_region_free.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_region_create.3 diff --git a/man/im_region_image.3 b/man/im_region_image.3 deleted file mode 100644 index 886fa201..00000000 --- a/man/im_region_image.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_region_buffer.3 diff --git a/man/im_region_position.3 b/man/im_region_position.3 deleted file mode 100644 index 886fa201..00000000 --- a/man/im_region_position.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_region_buffer.3 diff --git a/man/im_region_region.3 b/man/im_region_region.3 deleted file mode 100644 index 886fa201..00000000 --- a/man/im_region_region.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_region_buffer.3 diff --git a/man/im_remainder.3 b/man/im_remainder.3 deleted file mode 100644 index 3a0a96c6..00000000 --- a/man/im_remainder.3 +++ /dev/null @@ -1,47 +0,0 @@ -.TH REMAINDER 3 "May 2002" -.SH NAME -im_remainder, im_remainderconst, im_remainderconst_vec \- remainder after integer division -.SH SYNOPSIS -#include - -int im_remainder( IMAGE *in1, IMAGE *in2, IMAGE *out ) -.br - -int im_remainderconst( IMAGE *in, IMAGE *out, double c ) -.br - -int im_remainderconst_vec( IMAGE *in, IMAGE *out, int n, double *c ) -.SH DESCRIPTION -.B im_remainder(3) -calculates the remainder after integer division of two images. The output -type is the same as the type of -.B in1 -unless -.B in1 -is float or complex, in which -case the output type is signed integer. - -.B im_remainderconst(3) -calculates the remainder after integer division of -.B in -by the constant -.B c. -The output -type is the same as the type of -.B in -unless -.B in -is float or complex, in which -case the output type is signed integer. - -.B im_remainderconst_vec(3) -works as -.B im_remainderconst(3), -but lets you specify a constant per band. - -.SH RETURN VALUE -All functions return 0 on success and -1 on error. -.SH SEE ALSO -im_add(3), im_lintra(3), im_divide(3) -.SH COPYRIGHT -National Gallery, 2002 diff --git a/man/im_remainderconst.3 b/man/im_remainderconst.3 deleted file mode 100644 index bef634ce..00000000 --- a/man/im_remainderconst.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_remainder.3 diff --git a/man/im_remainderconst_vec.3 b/man/im_remainderconst_vec.3 deleted file mode 100644 index bef634ce..00000000 --- a/man/im_remainderconst_vec.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_remainder.3 diff --git a/man/im_remosaic.3 b/man/im_remosaic.3 deleted file mode 100644 index 406ecbc6..00000000 --- a/man/im_remosaic.3 +++ /dev/null @@ -1,28 +0,0 @@ -.TH IM_REMOSAIC 3 "7 Nov 2001" -.SH NAME -im_remosaic \- rebuild a mosaic, substituting filenames -.SH SYNOPSIS -#include - -int im_remosaic( IMAGE *in, IMAGE *out, -.br - const char *old_str, const char *new_str ) - -.SH DESCRIPTION -.B im_remosaic(3) -works rather as im_global_balance(). It takes apart the mosaiced image in and -rebuilds it, substituting images. - -Unlike -.B im_global_balance(3) -images are substituted based on their filenames. The rightmost occurence of -the string old_str is swapped for new_str, that file is opened, and that image -substituted for the old image. - -It's convenient for multispectral images. You can mosaic one band, then use -that mosaic as a template for mosaicing the others automatically. - -.SH RETURN VALUE -Functions return 0 on success and -1 on error. -.SH SEE ALSO -im_global_balance(3) diff --git a/man/im_render.3 b/man/im_render.3 deleted file mode 100644 index 79ce5d10..00000000 --- a/man/im_render.3 +++ /dev/null @@ -1,103 +0,0 @@ -.TH IM_RENDER 3 "5 October 2003" -.SH NAME -im_render, im_render_fade, im_cache \- make image in the background -.SH SYNOPSIS -#include - -int im_render_fade( IMAGE *in, IMAGE *out, IMAGE *mask, -.br - int width, int height, int max, -.br - int fps, int steps, -.br - int priority, -.br - void (*notify)( IMAGE *, Rect *, void * ), void *client ); - -int im_render( IMAGE *in, IMAGE *out, IMAGE *mask, -.br - int width, int height, int max, -.br - void (*notify)( IMAGE *, Rect *, void * ), void *client ); - -int im_cache( IMAGE *in, IMAGE *out, -.br - int width, int height, int max ); - -.SH DESCRIPTION -.B im_render_fade(3) -behaves rather like -.B im_copy(3) -between images -.B in -and -.B out, -except that it keeps a cache of computed pixels. This cache is made of up to -.B max -tiles (a value of -1 for -.B max -means any number of tiles), and each tile is of size -.B width -by -.B height -pixels. Each cache tile is made with a call to -.B im_prepare_thread(3), -so cache tile calculation will be accelerated on multi-CPU machines. If image -.B in -represents a large computation, -.B im_render_fade(3) -can save a lot of time. - -If the -.B notify -parameter points to a function, then tiles are not calculated immediately, but -are added to a job list and calculated as CPU becomes available. When a tile has -been calculated, the notify function is passed the image which was being -cached, the area of the image which is now available, and a client pointer. -The notify function will be called by a background thread, so you will usually -need to implement some mechanism to interrupt your main thread and update. - -The -.B mask -image is a one band uchar image the same size as out, which has 255 for every -pixels which is in the cache and 0 everywhere else. You should not read -pixels from -.B mask -after -.B out -has been closed. If mask is NULL, then no mask image is written. - -If -.B steps -is greater than zero, then pixels in mask are moved between 0 and 255 as tiles -age in that many steps. The -.B fps -parameter sets how many times per second the notify function is called to -indicate that an updated tile is ready. - -If -.B priority -is zero, then the render will only run when the system is idle, and only a few -renders will run at any time. Higher values will cause the render to happen -more quickly. - -.B im_cache(3) -is a convenience function for -.B im_render_fade(3) -that caches image pixels synchronously. If you ask for an area not in the cache, -execution blocks until the area has been calculated. - -.B im_render(3) -is deprecated: it is the old interface to the render function, before the -.B fps -and -.B steps -parameters were added. - -.SH RETURN VALUE -The function returns 0 on success, and non-zero on error, setting -im_error(). -.SH SEE ALSO -im_prepare(3) -.SH AUTHOR -J Cupitt, 2003 diff --git a/man/im_render_fade.3 b/man/im_render_fade.3 deleted file mode 100644 index b7647daa..00000000 --- a/man/im_render_fade.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_render.3 diff --git a/man/im_replicate.3 b/man/im_replicate.3 deleted file mode 100644 index d05a7817..00000000 --- a/man/im_replicate.3 +++ /dev/null @@ -1,31 +0,0 @@ -.TH IM_REPLICATE 3 "6 October 2003" -.SH NAME -im_replicate \- replicate an image horizontally and vertically -.SH SYNOPSIS -.B #include - -int -.br -im_replicate( IMAGE *in, IMAGE *out, -.br - int across, int down ) -.SH DESCRIPTION -.B im_replicate(3) -repeats image -.B in -across and down a fixed number of times to make a new larger image. - -The current implementation is optimised for the case where image -.B in -is small and -.B across -and -.B down -are large. - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_extract_area(3), im_zoom(3) -.SH COPYRIGHT -National Gallery 2003 diff --git a/man/im_resize_linear.3 b/man/im_resize_linear.3 deleted file mode 100644 index 00f1e6b4..00000000 --- a/man/im_resize_linear.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_shrink.3 diff --git a/man/im_ri2c.3 b/man/im_ri2c.3 deleted file mode 100644 index 47bc803a..00000000 --- a/man/im_ri2c.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_clip.3 diff --git a/man/im_rightshift_size.3 b/man/im_rightshift_size.3 deleted file mode 100644 index 52b6782f..00000000 --- a/man/im_rightshift_size.3 +++ /dev/null @@ -1,30 +0,0 @@ -.TH IM_RIGHTSHIFT_SIZE 3 "12 August 2006" -.SH NAME - im_rightshift_size \- Decrease size by a power-of-two factor -.SH SYNOPSIS -.nf -.B #include -.sp -.BI "int im_rightshift_size( IMAGE " "*in" ", IMAGE " "*out" ", int " "xshift" ", int " "yshift" ", int " "band_fmt" " ); -.fi -.SH DESCRIPTION -.B im_rightshift_size(3) -decreases the size of an integer type image by a power-of-two factor, very quickly, by summing the values of -adjacent pixels. The sum is shifted to produce output of the specified band format. -.IR xshift " and "yshift -are positive and give the base-two logarithms of the scale factors. -.PP -If the input image is a signed type, then -.I band_fmt -must be one of IM_BANDFMT_CHAR, IM_BANDFMT_SHORT or IM_BANDFMT_INT. If it is an unsigned type, then -.I band_fmt -must be one of IM_BANDFMT_UCHAR, IM_BANDFMT_USHORT or IM_BANDFMT_UINT. -.SH RETURN VALUE -The functions returns 0 on success and -1 on error. -.SH SEE ALSO -im_affine(3) -.SH COPYRIGHT -.br -Copyright 2006, Tom Vajzovic. -.SH AUTHOR -Tom Vajzovic diff --git a/man/im_rint.3 b/man/im_rint.3 deleted file mode 100644 index 15f371e1..00000000 --- a/man/im_rint.3 +++ /dev/null @@ -1,18 +0,0 @@ -.TH IM_RINT 3 -.SH NAME -im_rint \- for each pixel, find the nearest integral value -.SH SYNOPSIS -#include - -int im_rint( in, out ) -.br -IMAGE *in, *out; -.SH DESCRIPTION -.B im_rint(3) -finds the nearest integral value. Copy for integer types, -call rint(3) for float and complex types. Output type == input type. -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_abs(3), im_clip2fmt(3), im_floor(3) - diff --git a/man/im_rot180.3 b/man/im_rot180.3 deleted file mode 100644 index 94fba66f..00000000 --- a/man/im_rot180.3 +++ /dev/null @@ -1,38 +0,0 @@ -.TH IM_ROTATION 3 "5 December 1991" -.SH NAME -im_rot180, im_rot270, im_rot90, im_fliphor, im_flipver \- rotate and flip -an image -.SH SYNOPSIS -.B #include - -.B int im_rot180(in, out) -.br -.B IMAGE *in, *out; - -.B int im_rot270(in, out) -.br -.B IMAGE *in, *out; - -.B int im_rot90(in, out) -.br -.B IMAGE *in, *out; - -.B int im_fliphor(in, out) -.br -.B IMAGE *in, *out; - -.B int im_flipver(in, out) -.br -.B IMAGE *in, *out; -.SH DESCRIPTION -im_rot180(), im_rot270() and im_rot90(), rotate the input image in by 180, -270 and 90 degrees clockwise. im_fliphor() and im_flipver(), flip in -horizontally and vertically respectively. All functions work for any size -image, any type and any number of bands. All also work for LABPACK coded -images. -.SH RETURN VALUE -All functions return 0 on success and -1 on error. -.SH SEE\ ALSO -rot180(1) -.SH AUTHOR -N. Dessipris \- 5/12/1991 diff --git a/man/im_rot270.3 b/man/im_rot270.3 deleted file mode 100644 index bf72dac4..00000000 --- a/man/im_rot270.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_rot180.3 diff --git a/man/im_rot90.3 b/man/im_rot90.3 deleted file mode 100644 index bf72dac4..00000000 --- a/man/im_rot90.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_rot180.3 diff --git a/man/im_rotate_dmask45.3 b/man/im_rotate_dmask45.3 deleted file mode 100644 index bf93b39a..00000000 --- a/man/im_rotate_dmask45.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_offsets45.3 diff --git a/man/im_rotate_dmask90.3 b/man/im_rotate_dmask90.3 deleted file mode 100644 index bf93b39a..00000000 --- a/man/im_rotate_dmask90.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_offsets45.3 diff --git a/man/im_rotate_imask45.3 b/man/im_rotate_imask45.3 deleted file mode 100644 index bf93b39a..00000000 --- a/man/im_rotate_imask45.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_offsets45.3 diff --git a/man/im_rotate_imask90.3 b/man/im_rotate_imask90.3 deleted file mode 100644 index bf93b39a..00000000 --- a/man/im_rotate_imask90.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_offsets45.3 diff --git a/man/im_rotquad.3 b/man/im_rotquad.3 deleted file mode 100644 index d2fc6bea..00000000 --- a/man/im_rotquad.3 +++ /dev/null @@ -1,28 +0,0 @@ -.TH IM_ROTQUAD 3 "07 July 1990" -.SH NAME -im_rotquad \- rotates the four quadrants of an image -.SH SYNOPSIS -.B #include - -.B int im_rotquad(in, out) -.br -.B IMAGE *in, *out; -.SH DESCRIPTION -im_rotquad rotates the four quadrants of the image held by the image -descriptor in and writes the result on the image descriptor out. - -The function is used primarily to rotate a fourier transform in such a way -that the coordinate (0,0) is near the centre of the image, the so-called -optical transform. - -The function operates on any input; -output has the same format, sizes and bands as input. -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_fwfft(3), im_invfft(3), im_scaleps(3). -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 06/07/1990 diff --git a/man/im_sRGB2XYZ.3 b/man/im_sRGB2XYZ.3 deleted file mode 100644 index 6866a230..00000000 --- a/man/im_sRGB2XYZ.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_XYZ2disp.3 diff --git a/man/im_scale.3 b/man/im_scale.3 deleted file mode 100644 index 29915b4b..00000000 --- a/man/im_scale.3 +++ /dev/null @@ -1,40 +0,0 @@ -.TH CONVERSIONS 3 "28 June 1990" -.SH NAME -im_scale, im_scaleps \- scale an image to unsigned char image -.SH SYNOPSIS -#include - -int im_scale(in, out) -.br -IMAGE *in, *out; - -int im_scaleps(in, out) -.br -IMAGE *in, *out; -.SH DESCRIPTION -These functions scale a non-complex image to a displayable -byte (unsigned char) image. - -im_scale() scales the image held by image descriptor to a byte (unsigned char) -image and writes the result on the image descriptor out. Sizes and the number -of the bands of out are identical to those of input. -Input image should be non complex and can have any number of channels. -The output is scaled between 0 and 255; if the image is multiband the maximum -value of all channels is set to 255 and the minimum to 0. In all cases, -rounding is performed by adding .5 to the scaled values. - -.B im_scaleps() -scales to 0 - 255 by mapping each pixel through the equation - - log10(1.0 + pow(x, 0.25)) - -and then multiplying by a factor so that the image maximum is 255. - -This transformation highlights both low and high spatial -frequencies in the power spectrum. -The images produced by this non-linear transformation are only -for display and not for further processing. -.SH RETURN VALUE -Each function returns 0 on success and -1 on error. -.SH SEE ALSO -im_any2c(3), im_c2amph(3), im_clip(3) diff --git a/man/im_scale_dmask.3 b/man/im_scale_dmask.3 deleted file mode 100644 index 3b08512d..00000000 --- a/man/im_scale_dmask.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_create_dmask.3 diff --git a/man/im_scaleps.3 b/man/im_scaleps.3 deleted file mode 100644 index ed46d616..00000000 --- a/man/im_scaleps.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_scale.3 diff --git a/man/im_setbuf.3 b/man/im_setbuf.3 deleted file mode 100644 index eb13b64f..00000000 --- a/man/im_setbuf.3 +++ /dev/null @@ -1,21 +0,0 @@ -.TH IM_SETBUF 3 "11 April 1990" -.SH NAME -im_setbuf \- sets an image descriptor to keep an image in ram -.SH SYNOPSIS -.B #include - -.B IMAGE *im_setbuf(buffer_name) -.br -.B char *buffer_image; -.SH DESCRIPTION -.B im_setbuf(3) -returns an image descriptor which, when written to, will save pels in a memory -buffer. It is generally more convenient to call im_open(3). -.SH RETURN VALUE -The function returns a valid image descriptor on success or NULL on error. -.SH SEE\ ALSO -im_close(3), im_open(3). -.SH COPYRIGHT -N. Dessipris -.SH AUTHOR -N. Dessipris \- 11/04/1990 diff --git a/man/im_setupout.3 b/man/im_setupout.3 deleted file mode 100644 index 845bd7bf..00000000 --- a/man/im_setupout.3 +++ /dev/null @@ -1,51 +0,0 @@ -.TH IM_SETUPOUT 3 "11 April 1990" -.SH NAME -im_setupout \- set up an image descriptor for WIO output -.SH SYNOPSIS -.B #include - -.B int im_setupout(image) -.br -.B IMAGE *image; -.SH DESCRIPTION -.B im_setupout(3) -makes a descriptor ready for WIO writing. If the descriptor is a memory -buffer, enough memory is allocated to be able to hold all of the pels of the -image. If the descriptor is an output file, then the header is written to -disc. - -Typically, for WIO, you should have - - int - im_wombat( in, out ) - IMAGE *in, *out; - { - if( im_iocheck( in, out ) ) - return( -1 ); - - ... check parameters, check image descriptors - ... for type-compatibility, etc. etc. - - if( im_cp_desc( out, in ) ) - return( -1 ); - - ... set fields in out for the type of image you - ... wish to write - - if( im_setupout( out ) ) - return( -1 ); - - ... process from input to output, reading from in->data - ... and writing to out with im_writeline(3) - - return( 0 ); - } -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE\ ALSO -im_cp_desc(3), im_iocheck(3). -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 11/04/1990, updated on 22/04/1991 diff --git a/man/im_sharpen.3 b/man/im_sharpen.3 deleted file mode 100644 index a6bd295d..00000000 --- a/man/im_sharpen.3 +++ /dev/null @@ -1,163 +0,0 @@ -.TH IM_SHARPEN 3 "16 May 1995" -.SH NAME -im_sharpen \- simple coring edge enhancement -.SH SYNOPSIS -#include - -int -.br -im_sharpen( in, out, mask_radius, x1, y2, y3, m1, m2 ) -.br -IMAGE *in, *out; -.br -int mask_radius; -.br -double x1, y2, y3; -.br -double m1, m2; - -.SH DESCRIPTION -This function selectively sharpens the L* channel of a LABPACK coded image. It -is suitable for preparing an image for printing, where edges need to be -boosted to compensate for blurring introduced by the half-tone process, and -also for giving any additional `crispening' required. - -The function operates as: - - in gaussian out - --+-> blur with ----> subtract --> LUT --> add ----> - | mask_radius ^ ^ - | | | - +----------------------+ | - | | - +-----------------------------------------+ - -In other words, the L* channel is smoothed with a gaussian average function of -radius mask_radius and this smoothed image is subtracted from the -original L* to generate a high-frequency signal. - -This high-frequency signal is passed through a look-up table specified by the -x1, y2, y3, m1 and m2 parameters and added back to the original L* channel to -generate the sharpened image. - -The LUT is shaped as: - - ^ - y2 |- - - - - ----------- - | / - | / slope m2 - | .../ - -x1 | ... | - -------------------...----------------------> - | ... | x1 - |... slope m1 - / | - / m2 | - / | - / | - / | - / | - ______/ _ _ _ _ _ _ | -y3 - | - -When trying to understand the meaning of these parameters, it is helpful to -imagine a cross-section through an image. Sharpening filters boost apparent -sharpness by performing the following transformation. Consider a cross-section -through a soft edge: - - ^ - | .......... - | .... - | ... - | .. - |. - --------------------+-------------------> - .| - .. | - ... | - .... | - .......... | - | - -This becomes an enhanced edge, perhaps: - - ^ - | ... overshoot - | . . - | . ............ - | . - |. - . - . - --------------------+-------------------> - . - .| - .| - . | - ............. . | - . . | - undershoot ... | - | - -There are two features: the transition from black to white has become -steeper, and there are positive and negative undershoots and overshoots. - -As a general guide, some overshoot is good for printing (it helps exaggerate -the edge), but not too much, as you will start to see strong white fringes. -Undershoot introduces black lines, which are less intrusive, so you can allow -more under- than over-shoot. - -im_sharpen uses the x1 parameter to distinguish between low and high frequency -areas. Pixels which differ by less than x1 L* units from their local average -are sharpened by factor 1+m1, and pixels which differ by more than x1 are -sharpened by factor 1+m2. y2 and y3 set limits on the amount of positive and -negative sharpening we allow. - -For printing, we recommend the following settings: - - mask_radius == 7 - x1 == 1.5 - y2 == 20 (don't brighten by more than 20 L*) - y3 == 50 (can darken by up to 50 L*) - - m1 == 1 (some sharpening in flat areas) - m2 == 2 (more sharpening in jaggy areas) - -If you want more or less sharpening, we suggest you just change the m1 and m2 -parameters. For an extreme sharpen, you might try: - - m1 == 2 - m2 == 4 - -And for a relatively gentle sharpen, perhaps: - - m1 == 0.5 - m2 == 1.5 - -If you want to adjust the x1 parameter, it can be helpful visualise its -effect by setting: - - m1 == -2 - m2 == 4 - -In other words, heavily blur flat areas, and heavily sharpen elsewhere. This -creates a terrible-looking image, but you will be able to see clearly what -parts of your image are being classified as flat. - -The y2 and y3 parameters need not usually be adjusted, unless you wish to -reduce the strength of the finges. - -The mask_radius parameter changes the width of the fringe and can be adjusted -according to the output printing resolution. As an approximate guideline, use -3 for 4 pixels/mm (CRT display resolution), 5 for 8 pixels/mm, 7 for 12 -pixels/mm and 9 for 16 pixels/mm (300 dpi == 12 pixels/mm). These figures -refer to the image raster, not the half-tone resolution. - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_conv(3), im_compass(3), im_fastcor(3). -.SH COPYRIGHT -National Gallery and Birkbeck College, 1995 -.SH THANKS TO -Lindsay! diff --git a/man/im_shiftleft.3 b/man/im_shiftleft.3 deleted file mode 100644 index 711f6093..00000000 --- a/man/im_shiftleft.3 +++ /dev/null @@ -1,30 +0,0 @@ -.TH SHIFT 3 "30 October 1992" -.SH NAME -im_shiftleft, im_shiftright \- bit shift operations -.SH SYNOPSIS -.B #include - -.B int im_shiftleft( in, out, n ) -.br -.B IMAGE *in, *out; -.br -.B int n; - -.B int im_shiftright( in, out, n ) -.br -.B IMAGE *in, *out; -.br -.B int n; - -.SH DESCRIPTION -Shift integer images n bits left or right. Shifts on signed images are -sign-preserving. - -.SH RETURN VALUE -All functions return 0 on success and -1 on error. -.SH SEE ALSO -im_ifthenelse(3), im_equal(3), im_andimage(3). -.SH COPYRIGHT -National Gallery, 1992 -.SH AUTHOR -J. Cupitt diff --git a/man/im_shiftright.3 b/man/im_shiftright.3 deleted file mode 100644 index 3551b625..00000000 --- a/man/im_shiftright.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_shiftleft.3 diff --git a/man/im_shrink.3 b/man/im_shrink.3 deleted file mode 100644 index 3d482689..00000000 --- a/man/im_shrink.3 +++ /dev/null @@ -1,45 +0,0 @@ -.TH SHRINK 3 "2 May 1991" -.SH NAME -im_shrink \- shrink an image -.SH SYNOPSIS -#include - -int im_shrink(in, out, xfactor, yfactor) -.br -IMAGE *in, *out; -.br -double xfactor, yfactor; - -int im_resize_linear(in, out, X, Y) -.br -IMAGE *in, *out; -.br -int X, Y; - -.SH DESCRIPTION - -.B im_shrink(3) -shrink the input image file by -.B xfactor -along the horizontal and -.B yfactor -along the vertical direction. The function does not perform subpixel -interpolation and therefore the resultant image can present aliasing especially -for small x and y factors. Any size image, any non-complex type, any number of -bands. - -.B im_resize_linear(3) -resizes the image to be -.B X -by -.B Y -pixels. It is slow, only does bilinear interpolation (and so will be -inaccurate for factors greater than two), and uses WIO, so it has a 2GB image -size limit and will use large amounts of memory. Use -.B im_shrink(3) -in preference if possible. - -.SH RETURN VALUE -The functions returns 0 on success and -1 on error. -.SH SEE ALSO -im_affine(3) diff --git a/man/im_sign.3 b/man/im_sign.3 deleted file mode 100644 index f6fc7781..00000000 --- a/man/im_sign.3 +++ /dev/null @@ -1,19 +0,0 @@ -.TH IM_SIGN 3 "July 2002" -.SH NAME -im_sign \- find the unit vector in the direction of value -.SH SYNOPSIS -#include - -int im_sign( in, out ) -.br -IMAGE *in, *out; -.SH DESCRIPTION -.B im_sign(3) -finds the unit vector in the direction of the pixel value. For non-complex -images, it returns a signed char image with values -1, 0, and 1 for negative, -zero and positive pixels. For complex images it returns a -complex normalised to length 1. -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_abs(3), im_cmulnorm(3), im_c2amph(3) diff --git a/man/im_simcontr.3 b/man/im_simcontr.3 deleted file mode 100644 index b90ecbb7..00000000 --- a/man/im_simcontr.3 +++ /dev/null @@ -1,27 +0,0 @@ -.TH IM_SIMCONTR 3 "10 May 1991" -.SH NAME -im_simcontr \- shows the effect of simultaneous contrast -.SH SYNOPSIS -.B #include - -.B int im_simcontr( image, xsize, ysize ) -.br -.B IMAGE *image; -.br -.B int xsize, ysize; -.SH DESCRIPTION -.B im_simcontr() -creates an unsigned char one band grey scale image of sizes xsize by ysize. -The created pattern consists of two neighbouring squares one dark (left -square) and one light (right square). The left -one contains a smaller light square and the right -one contains a darker square. -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE\ ALSO -im_grey(3) -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 10/05/1991 diff --git a/man/im_similarity.3 b/man/im_similarity.3 deleted file mode 100644 index e9a1151d..00000000 --- a/man/im_similarity.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_similarity_area.3 diff --git a/man/im_similarity_area.3 b/man/im_similarity_area.3 deleted file mode 100644 index 330a480e..00000000 --- a/man/im_similarity_area.3 +++ /dev/null @@ -1,61 +0,0 @@ -.TH IM_SIMILARITY_AREA 3 "13 January 1992" -.SH NAME -im_similarity_area, im_similarity \- apply a similarity transform to an image -.SH SYNOPSIS -.B #include - -int im_similarity_area(in, out, s, a, dx, dy, x, y, w, h) -.br -.B IMAGE *in, *out; -.br -.B double s, a, dx, dy; -.br -.B int x, y; -.br -.B int w, h; - -int im_similarity(in, out, s, a, dx, dy) -.br -.B IMAGE *in, *out; -.br -.B double s, a, dx, dy; - -.SH DESCRIPTION -.B im_similarity_area() -applies a similarity transformation on the image held by the IMAGE descriptor -in and puts the result at the location pointed by the IMAGE descriptor out. in -many have any number of bands, be any size, and have any non-complex type. - -The transformation is described by s, a, dx, dy. The point (x,y) in the input -is mapped onto point (X,Y) in the output by - - X = s * x - a * y + dx - Y = a * x + s * y + dy - -s and a do not correspond to scale and angle of the transformation; the actual -scale and angle are given by the equations: - - scale = sqrt(s*s + a*a) - angle = arctan(s/a). - -The area of the output image given by x, y, w, h is generated. (0,0) is -the position of the transformed top-left-hand corner of the input image. -Function im_similarity_area resamples the transformed image using bilinear -interpolation. - -im_similarity works exactly as im_similarity_area, but calculates x, y, w, h -for you such that the rectangle described just encloses all of the transformed -input pixels. -.SH RETURN VALUE -The functions return 0 on success and -1 on error. -.SH BUGS -As with most resamplers, im_similarity performs poorly at the edges of -images. -.SH SEE\ ALSO -similarity(1), similarity_area(1) -.SH AUTHORS -N. Dessipris -\ 13/01/1992 -.br -J.Ph. Laurent -\ 12/12/92 -.br -J. Cupitt -\ 22/02/93 diff --git a/man/im_sines.3 b/man/im_sines.3 deleted file mode 100644 index 4ee48707..00000000 --- a/man/im_sines.3 +++ /dev/null @@ -1,29 +0,0 @@ -.TH IM_SINES 3 "10 May 1991" -.SH NAME -im_sines \- creates a spatial sine wave form -.SH SYNOPSIS -.B #include - -.B int im_sines(image, xsize, ysize, horfreq, verfreq) -.br -.B IMAGE *image; -.br -.B int xsize, ysize; -.br -.B double horfreq, verfreq; -.SH DESCRIPTION -.B im_sines() -creates a float one band image of the a sine waveform in two dimensions. -The sizes of the created image are xsize by ysize. The number of -horizontal and vertical spatial frequencies are determined by the variables -horfreq and verfreq respectively. The function is the base for creating -displayable sine waves and square waves in two dimensions. -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE\ ALSO -im_grey(3). -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 10/05/1991 diff --git a/man/im_sintra.3 b/man/im_sintra.3 deleted file mode 100644 index 83ac049e..00000000 --- a/man/im_sintra.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_costra.3 diff --git a/man/im_slice.3 b/man/im_slice.3 deleted file mode 100644 index 2e4675e8..00000000 --- a/man/im_slice.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_thresh.3 diff --git a/man/im_smear.3 b/man/im_smear.3 deleted file mode 100644 index b180aebc..00000000 --- a/man/im_smear.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_smudge.3 diff --git a/man/im_smudge.3 b/man/im_smudge.3 deleted file mode 100644 index 878cd645..00000000 --- a/man/im_smudge.3 +++ /dev/null @@ -1,40 +0,0 @@ -.TH IM_SMUDGE 3 "30 October 1992" -.SH NAME -im_smudge, im_smear \- filter and smudge in place -.SH SYNOPSIS -.B #include - -int -.br -im_smudge( im, ix, iy, r ) -.br -IMAGE *im; -.br -int ix, iy; -.br -Rect *r; - -int -.br -im_smear( im, ix, iy, r ) -.br -IMAGE *im; -.br -int ix, iy; -.br -Rect *r; -.SH DESCRIPTION -im_smudge() performs a low-pass filter of the pels inside rect r. Rect r is -clipped against the edges of the image. im_smear() is not very useful. - -Both these functions are `in place,' that is, they write directly to the -output image! Be very careful, you can destroy data. -.SH RETURN VALUE -All functions return 0 on success and -1 on error. -.SH SEE\ ALSO -im_insertplace(3), im_readpoint(3). -.SH COPYRIGHT -.br -National Gallery, 1992 -.SH AUTHOR -J. Cupitt diff --git a/man/im_spatres.3 b/man/im_spatres.3 deleted file mode 100644 index 81b965d9..00000000 --- a/man/im_spatres.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_quantim.3 diff --git a/man/im_spcor.3 b/man/im_spcor.3 deleted file mode 100644 index e22eb0f2..00000000 --- a/man/im_spcor.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_fastcor.3 diff --git a/man/im_start_many.3 b/man/im_start_many.3 deleted file mode 100644 index c124af1e..00000000 --- a/man/im_start_many.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_generate.3 diff --git a/man/im_start_one.3 b/man/im_start_one.3 deleted file mode 100644 index c124af1e..00000000 --- a/man/im_start_one.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_generate.3 diff --git a/man/im_stats.3 b/man/im_stats.3 deleted file mode 100644 index 4061098b..00000000 --- a/man/im_stats.3 +++ /dev/null @@ -1,24 +0,0 @@ -.TH IM_STATS 3 "24 October 1992" -.SH NAME -im_stats \- calculate many image statistics in a single pass -.SH SYNOPSIS -.B #include - -.B DOUBLEMASK *im_stats(in) -.br -.B IMAGE *in; -.SH DESCRIPTION -Find many image statistics in a single pass through the PELs. Returns a -DOUBLEMASK of 6 columns by n+1 (where n is number of bands in image in) rows. -Columns are statistics, and are, in order: minimum, maximum, sum, sum of -squares, mean, standard deviation. Row 0 has statistics for all bands -together, row 1 has stats for band 1, and so on. - -Non-complex images only! -.SH RETURN VALUE -NULL on error. -.SH SEE\ ALSO -im_avg(3), im_deviate(3) -.SH COPYRIGHT -.br -National Gallery, 1992 diff --git a/man/im_stdif.3 b/man/im_stdif.3 deleted file mode 100644 index d13a29a7..00000000 --- a/man/im_stdif.3 +++ /dev/null @@ -1,54 +0,0 @@ -.TH IM_STDIF 3 "10 May 1991" -.SH NAME -im_stdif, im_stdif_raw \- statistical differentiation of an image -.SH SYNOPSIS -.B #include - -int im_stdif(in, out, a, m0, b, s0, xw, yw) -.br -IMAGE *in, *out; -.br -double a, m0, b, s0; -.br -int xw, yw; - -int im_stdif_raw(in, out, a, m0, b, s0, xw, yw) -.br -IMAGE *in, *out; -.br -double a, m0, b, s0; -.br -int xw, yw; - -.SH DESCRIPTION -im_stdif() preforms statistical differencing according to the formula -given in page 45 of the book "An Introduction to Digital Image Processing" by -Wayne Niblack. This transformation emphasises the way in which a pel differs -statistically from its neighbours. It is useful for enhancing low-contrast -images with lots of detail, such as X-ray plates. - -At point (i,j) the output is given by the eqn: - - vout(i,j) = a*m0 + (1-a)*meanv + - (vin(i,j) - meanv) * (b*s0) / (s0+b*stdv) - -Values a, m0, b and s0 are entered, while meanv and stdv are the values -calculated over a moving window of size xw, yw centred on pixel (i,j). m0 is the -new mean, a is the weight given to it. s0 is the new standard deviation, b is -the weight given to it. Try: - - im_stdif $VIPSHOME/pics/huysum.v fred.v 0.5 128 0.5 50 11 11 - -The opreation works on one-band UCHAR images only, and writes a one-band UCHAR -image as its result. The output image has the same size as the input - a black -border is added to mark uncomputable pixels. - -im_stdif_raw() behaves exactly as im_stdif(), but does not add the border of -black pixels. - -.SH RETURN VALUE -All functions returns 0 on success and -1 on error. -.SH SEE ALSO -im_lhisteq(3), im_histgr(3), im_hsp(3), im_heq(3). -.SH COPYRIGHT -1991-1996, The National Gallery and Birkbeck College diff --git a/man/im_stop_many.3 b/man/im_stop_many.3 deleted file mode 100644 index c124af1e..00000000 --- a/man/im_stop_many.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_generate.3 diff --git a/man/im_stop_one.3 b/man/im_stop_one.3 deleted file mode 100644 index c124af1e..00000000 --- a/man/im_stop_one.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_generate.3 diff --git a/man/im_stretch3.3 b/man/im_stretch3.3 deleted file mode 100644 index 3b08c3e4..00000000 --- a/man/im_stretch3.3 +++ /dev/null @@ -1,28 +0,0 @@ -.TH IM_STRETCH3 3 "Sep 18 1997" -.SH NAME -im_stretch3 \- stretch horizontally by 3%, displace sub-pixel -mask -.SH SYNOPSIS -#include - -int im_stretch3( in, out, xdisp, ydisp ) -.br -IMAGE *in, *out; -.br -double xdisp, ydisp; - -.SH DESCRIPTION -im_stretch3() stretches the input image by 3% horizontally, and displaces it -by xdisp/ydisp. It uses bi-cubic interpolation, but runs quickly. It works -only for unsigned short images. - -This function is part of the MARC acquisition software, but is generally -useful for squaring up the pixels in images from the Kontron ProgRes camera -range. - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_conv(3), im_shrink(3). -.SH COPYRIGHT -The National Gallery, 1997 diff --git a/man/im_subsample.3 b/man/im_subsample.3 deleted file mode 100644 index c8cefe3b..00000000 --- a/man/im_subsample.3 +++ /dev/null @@ -1,24 +0,0 @@ -.TH IM_SUBSAMPLE 3 "19 Aug 1996" -.SH NAME -im_subsample \- subsample image by integer factor -.SH SYNOPSIS -#include - -int im_subsample(in, out, xsub, ysub) -.br -IMAGE *in, *out; -.br -int xsub, ysub; - -.SH DESCRIPTION -.B im_subsample() -sub-samples image in by an x and y integer factor. It is much faster than -im_shrink(), especially for large partial images. - -It works for any image type. -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_shrink(3), im_similarity(3), im_zoom(3) -.SH COPYRIGHT -1989-1996 The National Gallery and Birkbeck College diff --git a/man/im_subtract.3 b/man/im_subtract.3 deleted file mode 100644 index a20f8b40..00000000 --- a/man/im_subtract.3 +++ /dev/null @@ -1,41 +0,0 @@ -.TH SUBTRACTION 3 "24 April 1991" -.SH NAME -im_subtract \- subtracts two images -.SH SYNOPSIS -#include - -int im_subtract(in1, in2, out) -.br -IMAGE *in1, *in2, *out; -.SH DESCRIPTION - -This functions calculates in1 - in2 and writes the result in the image -descriptor out. Input images in1 and in2 should have the same channels and -the same sizes; however they can be of different types. Only the history of -the image descriptor pointed by in1 is copied to out. - -The type of the output is given by the table: - - in1 - uchar char ushort short uint int - -------|----------------------------------------- - in2 | - uchar | short short short short int int - char | short short short short int int - ushort | short short short short int int - short | short short short short int int - uint | int int int int int int - int | int int int int int int - -The result of this operation cannot be unsigned. For float types, the refult -is float unless one of the inputs is double, in which case the result is -double. For complex types the result is FMTCOMPLEX, unless one of the inputs -is FMTDPCOMPLEX, in which case the output is FMTDPCOMPLEX. - -.SH BUGS -None of the functions checks the result for over/underflow. -.SH RETURN VALUE -All functions return 0 on success and -1 on error. -.SH SEE ALSO -im_add(3), im_lintra(3), im_multiply(3). -.SH COPYRIGHT -National Gallery, 1995 diff --git a/man/im_system.3 b/man/im_system.3 deleted file mode 100644 index d0adc95f..00000000 --- a/man/im_system.3 +++ /dev/null @@ -1,48 +0,0 @@ -.TH IM_SYSTEM 3 "7 Mar 2000" -.SH NAME -im_system \- run a command on an image -.SH SYNOPSIS -#include - -int -im_system(im, cmd, out) -.br -IMAGE *im; -.br -const char *cmd; -.br -char **out; - -.SH DESCRIPTION -.B im_system() -runs a command on an image, returning the command's output as a string. This -string should be freed with -.B im_free() -when you've finished with it. - -The command is executed with the -.B system(3) -call; the first '%s' in the command being substituted for a filename. - -For example: - -im_system( im, "vips2dj %s | lpr", &result ) - -will run the command vips2dj(1) on the image, piping the result to the -printer. - -If the IMAGE is a file on disc, then the filename will be the name of the real -file. If the image is in memory, or the result of a computation, then a new -file is created in the temporary area called something like "vips_XXXXXX", and -that filename given to the command. The file is deleted when the command -finishes. - -The environment variable TMPDIR can be used to set the temporary directory. If -it is not set, it defaults to "/tmp". - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -system(3), vips2dj(1) -.SH COPYRIGHT -2000 The National Gallery and Birkbeck College diff --git a/man/im_tantra.3 b/man/im_tantra.3 deleted file mode 100644 index 83ac049e..00000000 --- a/man/im_tantra.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_costra.3 diff --git a/man/im_tbjoin.3 b/man/im_tbjoin.3 deleted file mode 100644 index 82c54e22..00000000 --- a/man/im_tbjoin.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_lrjoin.3 diff --git a/man/im_tbmerge.3 b/man/im_tbmerge.3 deleted file mode 100644 index ee6cab70..00000000 --- a/man/im_tbmerge.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_lrmerge.3 diff --git a/man/im_tbmosaic.3 b/man/im_tbmosaic.3 deleted file mode 100644 index 385c7d7d..00000000 --- a/man/im_tbmosaic.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_lrmosaic.3 diff --git a/man/im_text.3 b/man/im_text.3 deleted file mode 100644 index c1b7be46..00000000 --- a/man/im_text.3 +++ /dev/null @@ -1,47 +0,0 @@ -.TH IM_TEXT 3 "20 May 2004" -.SH NAME -im_text \- render a utf-8 text string into an image -.SH SYNOPSIS -.B #include - -.B int im_text( out, text, font, width, alignment, dpi ) -.br -.B IMAGE *out; -.br -.B const char *text; -.br -.B const char *font; -.br -.B int width; -.br -.B int alignment; -.br -.B int dpi; - -.SH DESCRIPTION -.B im_text(3) -makes an image containing the text string rendered as a bitmap with Pango. -The result is a one band 8 bit image with 0 - 255 as black to white. The -string may contain Pango markup, for example "TheGuardian". - -Fonts are specified pango-style as "family style size", for example "sans 12" -or "times italic 14". - -The -.B width -parameter, if greater than zero, gives the line width to wrap at. - -.B alignment -can be 0, 1 or 2 for right, centre and left alignment. - -.B dpi -is the resolution to render the text at. 300 is good for print, 100 for -displays. - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE\ ALSO -im_plotmask(3), im_insertplace(3) -.SH COPYRIGHT -.br -National Gallery 2004 diff --git a/man/im_thresh.3 b/man/im_thresh.3 deleted file mode 100644 index 345fdb57..00000000 --- a/man/im_thresh.3 +++ /dev/null @@ -1,46 +0,0 @@ -.TH IM_THRESH 3 "26 April 1991" -.SH NAME -im_thresh, im_slice \- threshold an image -.SH SYNOPSIS -#include - -int im_thresh(in, out, threshold) -.br -IMAGE *in, *out; -.br -double threshold; - -int im_slice(in, out, threshold1, threshold2) -.br -IMAGE *in, *out; -.br -double threshold1, threshold2; -.SH DESCRIPTION -These functions have been replaced with the relational and boolean -packages - see -.B im_lessconst() -and -.B im_and() -for much better ways of doing this. - -These functions operate on any non-complex input. The output image is a -unsigned char image with the same sizes and the same number of channels as -input. - -im_slice() thresholds the image held by image descriptor in and writes the -result on the image descriptor out. Output is a byte image with values less -than threshold1) set to 0, values in [threshold1, threshold2) set to 128 and -values greater than threshold2 set to 255 (x in range [a,b) means a<=x - -int im_tiff2vips( const char *filename, IMAGE *out ) - -int im_vips2tiff( IMAGE *in, const char *filename ) - -.SH DESCRIPTION -.B im_tiff2vips(3) -reads the tiff image in filename, and writes the image out -in VIPS format. It is a full baseline TIFF 6 reader, with extensions for -tiled images, multipage images, LAB colour space, pyramidal images and -JPEG compression. - -You can embed options in the filename. They have the form: - - filename.tif: - -.B page-number -lets you read a particular page out of a multipage TIFF file. For -example: - - "fred.tif:12" - -will read page 12 (numbering from page zero) from the TIFF image. - -.B im_vips2tiff(3) -reads the image in and writes a TIFF file to the specified -filename. The filename may include an optional mode string, following a ':' -character. For example, "fred.tif" would write a default TIFF file (flat, -strips, no compression). Writing to "fred.tif:deflate,tile:64x64" would write a -ZIP-coded image, split into 64 by 64 pixel tiles. - -The mode string has the following syntax: - - ,,,,, - -where is one of: - - "none" - no compression - "jpeg" - JPEG compression - "deflate" - ZIP (deflate) compression - "packbits" - TIFF packbits compression - "ccittfax4" - CCITT Group 4 fax encoding - "lzw" - Lempel-Ziv compression - -"jpeg" compression can be followed by a ":" character and a JPEG quality -level; "lzw" and "deflate" can be followed by a ":" and predictor value. The -default compression type is "none", the default JPEG quality factor is 75. - -Predictor is not set by default. There are three predictor values recognised -at the moment (2007, July): 1 is no prediction, 2 is a horizontal differencing -and 3 is a floating point predictor. Refer to the libtiff specifications for -further discussion of various predictors. In short, predictor helps to better -compress image, especially in case of digital photos or scanned images and bit -depths > 8. Try it to find whether it works for your images. - -JPEG compression is a good lossy compressor for photographs, packbits is good -for 1-bit images, and deflate is the best lossless compression TIFF can do. -LZW has patent problems and is no longer recommended. - - is one of: - - "strip" - strip layout - "tile" - tiled layout - -"tile" layout can be followed by a ":" character and the horizontal and -vertical tile size, separated by a "x" character. The default layout is -"strip", and the default tile size is 128 by 128 pixels. - - is one of: - - "flat" - single image - "pyramid" - many images arranged in a pyramid - -The default multi-res mode is "flat". - - is one of: - - "manybit" - don't bit-reduce images - "onebit" - one band 8 bit images are saved as 1 bit - -The default format is "multibit". - - is one of: - - "res_cm" - output resolution unit is pixels per centimetre - "res_inch" - output resolution unit is pixels per inch - -The default resolution unit is taken from the header field "resolution-unit" -(IM_META_RESOLUTION_UNIT in C). If this field is not set, then VIPS defaults -to cm. - -This may be overridden by the option. The unit can optionally -be followed by a ":" character and the horizontal and vertical resolution, -separated by a "x" character. You can have a single number with no "x" and -set the horizontal and vertical resolutions together. The default unit is -cm, and the default resolution is taken from the VIPS header. - - is the filename of an ICC profile to embed in the TIFF file - -The TIFF reader and writer are based on Sam Leffler's TIFF library, and the IJG -JPEG coder. - -.SH EXAMPLES - -The call: - - im_vips2tiff fred.v fred.tif - -Writes a striped, uncompressed TIFF image. Almost anything should be able to -read this. - - im_vips2tiff fred.v fred.tif:jpeg,tile,pyramid - -Writes a tiled JPEG pyramid image. Although VIPS tries to follow the TIFF -specification carefully, you may have trouble reading this on any system other -than VIPS. - - im_vips2tiff fred.v fred.tif:jpeg:25,tile:64x64 - -Writes a highly compressed JPEG image, with a tile size of 64 by 64 pixels. - - im_vips2tiff fred.v fred.tif:,tile - -Writes an uncompressed tiled image. - - im_vips2tiff fred.v fred.tif:packbits,tile,,onebit - -Writes a tiled one bit TIFF image (provided fred.v is a one band 8 bit image) -compressed with packbits. - - im_vips2tiff fred.v fred.tif:,,,,res_inch:300 - -Writes fred.v as a tiff file, with the resolution in the tiff header set to -300 dpi. - -.SH SEE ALSO -im_open(3) -.SH COPYRIGHT -Hey, you want this? You have it! diff --git a/man/im_tile_cache.3 b/man/im_tile_cache.3 deleted file mode 100644 index 181c253b..00000000 --- a/man/im_tile_cache.3 +++ /dev/null @@ -1,45 +0,0 @@ -.TH IM_TILE_CACHE 3 "19 May 2006" -.SH NAME -im_tile_cache \- cache an image, tilewise -.SH SYNOPSIS -#include - -int -.br -im_tile_cache( IMAGE *in, IMAGE *out, -.br - int tile_width, int tile_height, int max_tiles ); - -.SH DESCRIPTION -.B tile_cache(3) -behaves rather like -.B im_copy(3) -between images -.B in -and -.B out, -except that it keeps a cache of computed pixels. This cache is made of up to -.B max_tiles -tiles (a value of -1 for -.B max -means any number of tiles), and each tile is of size -.B tile_width -by -.B tile_height -pixels. Each cache tile is made with a single call to -.B im_prepare(3). - -This is a lower-level operation than -.B im_cache(3) -since it does no subdivision. It is suitable for caching the output of -operations like -.B im_exr2vips(3) -on tiled images. - -.SH RETURN VALUE -The function returns 0 on success, and non-zero on error, setting -im_error(). -.SH SEE ALSO -im_prepare(3) -.SH AUTHOR -J Cupitt, 2006 diff --git a/man/im_tone_analyse.3 b/man/im_tone_analyse.3 deleted file mode 100644 index adbb59b6..00000000 --- a/man/im_tone_analyse.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_tone_build.3 diff --git a/man/im_tone_build.3 b/man/im_tone_build.3 deleted file mode 100644 index 2ef1615c..00000000 --- a/man/im_tone_build.3 +++ /dev/null @@ -1,151 +0,0 @@ -.TH TONE 3 "10 May 1991" -.SH NAME -im_tone_build, im_tone_map, im_tone_analyse, im_tone_build_range \- tone-curve adjustment of LAB -images -.SH SYNOPSIS - -int -.br -im_tone_build_range( -.br - int in_max, int out_max, -.br - IMAGE *lut, -.br - double Lb, double Lw, -.br - double Ps, double Pm, double Ph, -.br - double S, double M, double H ) - -int -.br -im_tone_build( -.br - IMAGE *lut, -.br - double Lb, double Lw, -.br - double Ps, double Pm, double Ph, -.br - double S, double M, double H ) - -int -.br -im_tone_analyse( -.br - IMAGE *in, -.br - IMAGE *lut, -.br - double Ps, double Pm, double Ph, -.br - double S, double M, double H ) - -int -.br -im_tone_map( IMAGE *in, IMAGE *out, IMAGE *lut ) - -.SH DESCRIPTION -Various functions relating to tone curve adjustment. Example tone curve: - - repro L* out - ^ - | - 100 | . . . . . . . . . . . . . . . .* - | * . - Lw | . . . . . . . . . . . . . .* . - | * . . - | /* . . - | / * . . - | / .* . . - | * * /* *. . . - | * * / . . . - | * / . . . . - | * / . . . . - | * / . . . . - | * / . . . . . - | */ . . . . . - Lb | . .* . . . . . - | * . . . . . . - |* . . . . . . - 0 +---------------------------------------> - 0 Lb Ls Lm Lh Lw 100 L* in - -.B im_tone_build_range(3) -generates a tone curve for the adjustment of image levels. The curve is -an unsigned 16-bit image with (in_max + 1) entries, each in the range [0, -out_max]. - -The parameters are -expressed as 0-100, as in LAB colour space, but you specify the scaling for the -input and output images with the in_max and out_max parameters. - -Parameters: - - Lb - black point - Lw - white point - -Both in L* units, ie. in the range [0,100]. These should be set by histogram -analysis of the image to be transformed to 0.1% and 99.9% of the full range of -the image. See im_tone_analyse() below. - - Ps - shadow point - Pm - mid-tone point - Ph - highlight point - -All in [0,1], meaning max of shadow section of curve should be positioned -at Lb+Ps(Lw-Lb), etc. Suggested values: Ps, Pm, Ph should be 0.2, 0.5 and 0.8. -Ps is limited to the range [0.1,0.3], Pm to the range [0.4,0.6] and Ph to -[0.7,0.9]. - - S - shadow adjustment factor (+/- 15) - M - mid-tone adjustment factor (+/- 30) - H - highlight adjustment factor (+/- 15) - -These are the principal parameters, controlling the brightness in the shadow, -mid-tone and highlight areas. Suggested values: - - 0, 0, 0 - no change to input image - 5, 0, -2 - boost shadows a little, depress highlights slightly - -.B im_tone_build(3) -is a convenience function that calls -.B im_tone_build_range(3) -with ranges suitable for tone correcting a LABQ image to a LABS image. - -Use -.B im_ismonotonic(3) -to check that the slope of your tone curve is always >0, -use -.B im_histplot(3) -to graph the curve, use -.B im_tone_map(3) -to apply your curve to an image. - -.B im_tone_map(3) -map just the L channel of a LabQ or LabS image through a tone -curve. - -.B im_tone_analyse(3) -find the histogram of a LabS or LabQ image and use that to -set the Ln and Lw parameters of -.B im_tone_build(3). -All other parameters as above. - -Example: - - example% im_tone_analyse $VIPSHOME/pics/master.v /tmp/lut.v \ - 0.2 0.5 0.8 6.3 0.8 -3 - example% im_ismonotonic /tmp/lut.v - 255 - example% im_tone_map $VIPSHOME/pics/master.v /tmp/master2.v /tmp/lut.v - -.SH RETURN VALUE -All functions returns 0 on success and -1 on error. -.SH SEE ALSO -im_histplot(3), im_ismonotonic(3). -.SH COPYRIGHT -1995, National Gallery -.SH AUTHORS -J. Cupitt diff --git a/man/im_tone_map.3 b/man/im_tone_map.3 deleted file mode 100644 index adbb59b6..00000000 --- a/man/im_tone_map.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_tone_build.3 diff --git a/man/im_updatehist.3 b/man/im_updatehist.3 deleted file mode 100644 index d421d4b0..00000000 --- a/man/im_updatehist.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_histlin.3 diff --git a/man/im_verror.3 b/man/im_verror.3 deleted file mode 100644 index 7db4b63b..00000000 --- a/man/im_verror.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_error.3 diff --git a/man/im_version.3 b/man/im_version.3 deleted file mode 100644 index ae5522de..00000000 --- a/man/im_version.3 +++ /dev/null @@ -1,46 +0,0 @@ -.TH IM_VERSION 3 "15 December 1999" -.SH NAME -im_version, im_version_string \- return VIPS version info -.SH SYNOPSIS -.B #include - -.B int im_version( int flag ) - -.B const char *im_version_string( void ) - -.SH DESCRIPTION - -.B im_version(3) -returns the major version number if -.B flag -== 0, the minor version number if -.B flag -== 1, and the micro version number if -.B flag -== 2. - -Major versions are supposed to represent very large changes to the -library, minor versions indicate steady improvements (with odd minor -versions indicating unstable and undocumented development releases), -and micro versions indicating bug-fixes. - -.B im_version_string(3) -returns a static string representing the vips version number, and the date -when the library was built. - -The version number always has three parts, separated by '.' characters. The -first part is the major release, the second the minor release (odd minor -values denote development releases), and the third the micro version number. - -The version number and the date are separated by a '-' character. - -The value of this string is constructed in 'configure.in'. - -A typical value for tthe string might be "7.7.0-Thu Dec 16 18:10:01 GMT 1999". - -.SH RETURN VALUE -The function returns 0 on success and non-zero on error. -.SH COPYRIGHT -National Gallery -.SH AUTHOR -J. Cupitt \- 15/12/99 diff --git a/man/im_version_string.3 b/man/im_version_string.3 deleted file mode 100644 index f4a36ee1..00000000 --- a/man/im_version_string.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_version.3 diff --git a/man/im_video_v4l1.3 b/man/im_video_v4l1.3 deleted file mode 100644 index c3e71a16..00000000 --- a/man/im_video_v4l1.3 +++ /dev/null @@ -1,39 +0,0 @@ -.TH VIDEO 3 "3 March 2001" -.SH NAME -im_video_v4l1 \- various image grabbers - -.SH SYNOPSIS -.B #include - -.B int -.B im_video_v4l1( IMAGE *im, const char *device, int channel, -.B int brightness, int colour, int contrast, int hue, -.B int ngrabs ) - -.SH DESCRIPTION -These functions grab single video frames from various devices. Which of these -functions work depends upon how your VIPS has been configured and compiled, -and your platform. As a result, they are far from portable ... you want a -layer on top of these functions. - -.B im_video_v4l1(3) -grabs a frame using Video4Linux. It grabs a 24-bit RGB colour image, at the -maximum resolution your card allows. - -.B device -should typically be "/dev/video". -.B channel -selects the channel to acquire: usually 0 is TV, and 1 is composite video. -.B brightness, -.B colour, -.B contrast -and -.B hue -set grab parameters. Each should be in the range (0 - 32768). 32768 is usually -the value you want. -.B ngrabs -sets the number of frames the card should average. Higher values are slower, -but typically less noisy (and slightly softer). - -.SH RETURN VALUE -All functions return 0 on success and -1 on error. diff --git a/man/im_vips2bufjpeg.3 b/man/im_vips2bufjpeg.3 deleted file mode 100644 index d7fbd38d..00000000 --- a/man/im_vips2bufjpeg.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_jpeg2vips.3 diff --git a/man/im_vips2csv.3 b/man/im_vips2csv.3 deleted file mode 100644 index e4558b4a..00000000 --- a/man/im_vips2csv.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_csv2vips.3 diff --git a/man/im_vips2jpeg.3 b/man/im_vips2jpeg.3 deleted file mode 100644 index d7fbd38d..00000000 --- a/man/im_vips2jpeg.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_jpeg2vips.3 diff --git a/man/im_vips2mask.3 b/man/im_vips2mask.3 deleted file mode 100644 index 9be32f55..00000000 --- a/man/im_vips2mask.3 +++ /dev/null @@ -1,26 +0,0 @@ -.TH IM_VIPS2MASK 3 "6 June 1994" -.SH NAME -im_vips2mask, im_mask2vips \- convert between masks and images -.SH SYNOPSIS -.B #include - -DOUBLEMASK *im_vips2mask( IMAGE *in, char *out_name ) - -int im_mask2vips( DOUBLEMASK *in, IMAGE *out ) -.SH DESCRIPTION -.B im_vips2mask(3) -returns a DOUBLEMASK of name out_name containing the data from IMAGE in. -Images must have either one band, a width of 1, or a height of 1. -Returns NULL on error, and a new mask on success. -The scale field is set to 1.0 and the offset to 0.0. - -.B im_mask2vips(3) -writes the doubles held in mask in to the IMAGE out. It creates a one-band -image of the same size as in. It returns 0 on success and -1 on error. The -scale and offset fields are ignored. - -.SH SEE ALSO -im_openin(3), im_openout(3), im_setbuf(3), edvips(3), im_create_dmask(3). -.SH COPYRIGHT -.br -National Gallery, 1994 diff --git a/man/im_vips2mimejpeg.3 b/man/im_vips2mimejpeg.3 deleted file mode 100644 index d7fbd38d..00000000 --- a/man/im_vips2mimejpeg.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_jpeg2vips.3 diff --git a/man/im_vips2png.3 b/man/im_vips2png.3 deleted file mode 100644 index 4a4b4cd7..00000000 --- a/man/im_vips2png.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_png2vips.3 diff --git a/man/im_vips2ppm.3 b/man/im_vips2ppm.3 deleted file mode 100644 index de0d1282..00000000 --- a/man/im_vips2ppm.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_ppm2vips.3 diff --git a/man/im_vips2raw.3 b/man/im_vips2raw.3 deleted file mode 100644 index a3d5b7b1..00000000 --- a/man/im_vips2raw.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_raw2vips.3 diff --git a/man/im_vips2tiff.3 b/man/im_vips2tiff.3 deleted file mode 100644 index 78ab0c6a..00000000 --- a/man/im_vips2tiff.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_tiff2vips.3 diff --git a/man/im_warn.3 b/man/im_warn.3 deleted file mode 100644 index 7db4b63b..00000000 --- a/man/im_warn.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_error.3 diff --git a/man/im_wrapmany.3 b/man/im_wrapmany.3 deleted file mode 100644 index e2d3a418..00000000 --- a/man/im_wrapmany.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_wrapone.3 diff --git a/man/im_wrapone.3 b/man/im_wrapone.3 deleted file mode 100644 index 09589f06..00000000 --- a/man/im_wrapone.3 +++ /dev/null @@ -1,67 +0,0 @@ -.TH WRAPPERS 3 "11 April 1990" -.SH NAME -im_wrapone, im_wrapmany \- easy interface to partial image IO system -.SH SYNOPSIS -.B #include - -int im_wrapone( IMAGE *in, IMAGE *out, - im_wrapone_fn fn, void *a, void *b ) -.br -int im_wrapmany( IMAGE **in, IMAGE *out, - im_wrapmany_fn fn, void *a, void *b ) - -where - -typedef void (*im_wrapone_fn)( void *in, void *out, int n, - void *a, void *b ) -.br -typedef void (*im_wrapmany_fn)( void **in, void *out, int n, - void *a, void *b ) - -.SH DESCRIPTION -These functions provide a simple way to use the VIPS partial image IO system, -provided that your image processing function involves no coordinate -transformations, that is, that each output PEL depends only upon the -corresponding PEL(s) in the input image(s). - -You should write your operation as a buffer processing function --- for -example: - - static void - invert_buffer( unsigned char *in, unsigned char *out, - int width ) - { - int x; - - for( x = 0; x < width; x++ ) - *out++ = 255 - *in++; - } - -This can now be turned into a full PIO image processing function by: - - int - invert( IMAGE *in, IMAGE *out ) - { - if( in->BandFmt != FMTUCHAR || - in->Coding != NOCODING || - in->Bands != 1 ) { - im_errormsg( "invert: bad input" ); - return( -1 ); - } - if( im_cp_desc( out, in ) ) - return( -1 ); - if( im_wrapone( in, out, - (im_wrapone_fn) invert_buffer, NULL, NULL ) ) - return( 0 ); - } - -im_wrapmany(3) works as im_wrapone(3), but allows many input images. All the -inputs should be same Xsize and Ysize, but may vary in type. The array of -input images should be NULL-terminated, as for im_start_many(3). - -.SH RETURN VALUE -All int-valued functions return zero on success and non-zero on error. -.SH COPYRIGHT -National Gallery, 1995 -.SH AUTHOR -J. Cupitt \- 9/2/95 diff --git a/man/im_write_dmask.3 b/man/im_write_dmask.3 deleted file mode 100644 index 3b08512d..00000000 --- a/man/im_write_dmask.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_create_dmask.3 diff --git a/man/im_write_dmask_name.3 b/man/im_write_dmask_name.3 deleted file mode 100644 index 3b08512d..00000000 --- a/man/im_write_dmask_name.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_create_dmask.3 diff --git a/man/im_write_imask.3 b/man/im_write_imask.3 deleted file mode 100644 index 3b08512d..00000000 --- a/man/im_write_imask.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_create_dmask.3 diff --git a/man/im_write_imask_name.3 b/man/im_write_imask_name.3 deleted file mode 100644 index 3b08512d..00000000 --- a/man/im_write_imask_name.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/im_create_dmask.3 diff --git a/man/im_writeline.3 b/man/im_writeline.3 deleted file mode 100644 index 96029903..00000000 --- a/man/im_writeline.3 +++ /dev/null @@ -1,37 +0,0 @@ -.TH IM_WRITELINE 3 "22 April 1991" -.SH NAME -im_writeline \- writes a line of data in the image descriptor -.SH SYNOPSIS -.B #include - -.B int im_writeline(ypos, image, buffer) -.br -.B int ypos; -.br -.B IMAGE *image; -.br -.B char *buffer; -.SH DESCRIPTION -.B im_writeline(3) -writes the ypos line of an image held in buffer to either the output -buffer image (previously set by im_setbuf(3)) or to an output file -(previously set by im_openput(3)). The function provides uniform treatment of -output irrespectively whether it is a file or a buffer image. - -You should be careful that the buffer does indeed contain enough data for a -complete line of pels --- see lsize(3). - -Any evaluation callbacks which have been added to image are triggered --- see -im_generate(3) and im_add_eval_callback(3). -.SH BUGS -This function changed in VIPS6: -programs written previously must be modified by removing the last argument -of the old im_writeline(3). -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_setbuf(3), im_openout(3), im_add_eval_callback(3). -.SH COPYRIGHT -N. Dessipris -.SH AUTHOR -N. Dessipris 23/04/1991 diff --git a/man/im_zerox.3 b/man/im_zerox.3 deleted file mode 100644 index 5678af66..00000000 --- a/man/im_zerox.3 +++ /dev/null @@ -1,30 +0,0 @@ -.TH IM_ZEROX 3 "14 May 1991" -.SH NAME -im_zerox \- find the zero crossings of an image -.SH SYNOPSIS -.B #include - -int im_zerox(in, out, flag) -.br -IMAGE *in, *out; -.br -int flag; - -.SH DESCRIPTION -im_zerox() detects the positive and negative edges of zero crossings of an -image held by the image descriptor in, depending on the flag. - -If flag is -1 the negative zero crossings are returned. -If flag is 1 the positive zero crossings are returned. - -The output image is byte with zero crossing set to 255 and all other values -set to zero. Input can have any number of channels, and be any non-complex type. - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_conv(3). -.SH COPYRIGHT -N. Dessipris -.SH AUTHOR -N. Dessipris \- 14/05/1991 diff --git a/man/im_zone.3 b/man/im_zone.3 deleted file mode 100644 index 14b1ec19..00000000 --- a/man/im_zone.3 +++ /dev/null @@ -1,38 +0,0 @@ -.TH IM_ZONE 3 "10 May 1991" -.SH NAME -im_zone, im_fzone \- creates a zone plate -.SH SYNOPSIS -.B #include - -.B int im_zone(image, size) -.br -.B IMAGE *image; -.br -.B int size; - -.B int im_fzone(image, size) -.br -.B IMAGE *image; -.br -.B int size; - -.SH DESCRIPTION - -.B im_fzone() -creates a float one band image of a zone plate of size size by size. Pels are -in the range [-1,+1]. The zone plate has spatial frequencies increasing from -0 the center (at size/2, size/2) up to infinity at the edges. size must be -positive and even. - -.B im_zone() -behaves exactly as im_fzone(), but writes a FMTUCHAR image scaled to the range -0-255. - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_grey(3), im_fgrey(3). -.SH COPYRIGHT -N. Dessipris -.SH AUTHOR -N. Dessipris \- 10/05/1991 diff --git a/man/im_zoom.3 b/man/im_zoom.3 deleted file mode 100644 index 440fdd84..00000000 --- a/man/im_zoom.3 +++ /dev/null @@ -1,23 +0,0 @@ -.TH IM_ZOOM 3 "11 April 1990" -.SH NAME -im_zoom \- zoom an image -.SH SYNOPSIS -.B #include - -.B int im_zoom(in, out, xfac, yfac) -.br -.B IMAGE *in, *out; -.B int xfac, yfac; - -.SH DESCRIPTION -.B im_zoom() -zooms (ie. nearest neighbour upsampling) the image held by the image -descriptor in by factors xfac and yfac and writes the result to the image -descriptor out. Works for any type of image, even LABPACK. - -.SH RETURN VALUE -The function returns 0 on success and -1 on error. -.SH SEE ALSO -im_copy(3), im_affine(3). -.SH COPYRIGHT -National Gallery, 1994. diff --git a/man/light_correct.1 b/man/light_correct.1 deleted file mode 100644 index f992499b..00000000 --- a/man/light_correct.1 +++ /dev/null @@ -1,39 +0,0 @@ -.TH LIGHT_CORRECT 1 "14 Oct 1996" -.SH NAME -light_correct \- correct illumination errors on set of images -.SH SYNOPSIS -.B light_correct grey image1 image2 image3 ... -.SH DESCRIPTION -The first argument should be an image of a piece of grey card, subsequent -arguments should be images taken with the same lighting set-up which need -correcting. The corrected images are written to files prefixed with "ic_". - -For example, suppose you have a directory with the following files in: - - example% ls - dat1.1.v dat1.2.v dat2.1.v dat2.2.v dat3.1.v dat3.2.v - dat4.1.v dat4.2.v grey.v - -then run light_correct like this: - - example% light_correct grey.v dat*.v - -to generate this: - - example% ls - dat1.1.v dat1.2.v dat2.1.v dat2.2.v dat3.1.v dat3.2.v - dat4.1.v dat4.2.v grey.v - ic_dat1.1.v ic_dat1.2.v ic_dat2.1.v ic_dat2.2.v ic_dat3.1.v - ic_dat3.2.v ic_dat4.1.v ic_dat4.2.v - -light_correct works by smoothing out the grey card image, finding -grey-mean/pixel for each point, and then multiplying the result by all the -following images. It also removes any .desc files it generates, to avoid -problems with im_global_balance(3). - -.SH RETURN VALUE -returns 0 on success and non-zero on error. -.SH SEE ALSO -header(1), vips(1) -.SH COPYRIGHT -The National Gallery and Birkbeck College, 1989-1996. diff --git a/man/printlines.1 b/man/printlines.1 deleted file mode 100644 index a5f43318..00000000 --- a/man/printlines.1 +++ /dev/null @@ -1 +0,0 @@ -.so man1/debugim.1 diff --git a/man/simcontr.1 b/man/simcontr.1 deleted file mode 100644 index efa0fc4c..00000000 --- a/man/simcontr.1 +++ /dev/null @@ -1,18 +0,0 @@ -.TH SIMCONTR 1 "27 January 1992" -.SH NAME -simcontr \- shows the effect of simultaneous contrast -.SH SYNOPSIS -.B simcontr image xsize ysize -.SH DESCRIPTION -.B simcontr -creates an unsigned char one band grey scale image of sizes xsize by ysize. -The created pattern consists of two neighbouring squares one dark (left -square) and one light (right square). The left -one contains a smaller light square and the right -one contains a darker square. -.SH SEE\ ALSO -grey(1) -.SH COPYRIGHT -N. Dessipris -.SH AUTHOR -N. Dessipris \- 27/02/1992 diff --git a/man/sines.1 b/man/sines.1 deleted file mode 100644 index d767e5e7..00000000 --- a/man/sines.1 +++ /dev/null @@ -1,24 +0,0 @@ -.TH SINES 1 "27 January 1992" -.SH NAME -sines, squares \- creates a spatial sine or square wave form -.SH SYNOPSIS -.B sines image xsize ysize horfreq verfreq - -.B squares image xsize ysize horfreq verfreq -.SH DESCRIPTION -.B sines -creates an one band unsigned char -image of the a sine waveform in two dimensions. -The sizes of the created image are xsize by ysize. The number of -horizontal and vertical spatial frequencies are determined by the variables -horfreq and verfreq respectively. - -.B squares -creates an one band unsigned cahr image by thresholding a sine waveform. -.SH SEE\ ALSO -grey(1), im_sines(3X), squares(1). -.SH COPYRIGHT -.br -N. Dessipris -.SH AUTHOR -N. Dessipris \- 27/02/1992 diff --git a/man/squares.1 b/man/squares.1 deleted file mode 100644 index baa612a7..00000000 --- a/man/squares.1 +++ /dev/null @@ -1 +0,0 @@ -.so man1/sines.1 diff --git a/man/vips.1 b/man/vips.1 deleted file mode 100644 index 919bb2fb..00000000 --- a/man/vips.1 +++ /dev/null @@ -1,54 +0,0 @@ -.TH VIPS 1 "30 June 1993" -.SH NAME -vips \- run vips operations from the command line -.SH SYNOPSIS -.B vips [flags] [command] [command-args] -.SH DESCRIPTION -.B vips(1) -is the VIPS universal main program. You can use it to run any VIPS function -from the command line, to query the VIPS function database, and to -maintain parts of the VIPS library. - -To run a VIPS function, the first argument should be the name of the function -and following arguments should be the function parameters. For example: - - example% vips im_invert lena.v lena2.v - -If you make a symbolic link to the vips executable named after an operation, -then you can use that link to call an operation directly. For example: - - example% ln -s vips im_invert - example% im_invert lena.v lena2.v - -.SH OPTIONS -.TP -.B -l PACKAGE, --list=PACKAGE -List operations defined in PACKAGE. PACKAGE can also be "classes", "packages" -or "all". - -.TP -.B -u OPERATION, --usage=OPERATION -Show usage message for OPERATION. - -.TP -.B -p PLUGIN, --plugin=PLUGIN -Load PLUGIN. Note that plugins in $VIPSHOME/lib are loaded automatically. - -.TP -.B -k, --links -Print link lines for all operations. - -.TP -.B -h PACKAGE, --cpph=PACKAGE -Print C++ header for PACKAGE. PACKAGE can also be a function name, or "all". - -.TP -.B -c PACKAGE, --cppc=PACKAGE -Print C++ binding for PACKAGE. PACKAGE can also be a function name, or "all". - -.SH RETURN VALUE -returns 0 on success and non-zero on error. -.SH SEE ALSO -header(1) -.SH COPYRIGHT -The National Gallery and Birkbeck College, 1989-1996. diff --git a/man/vips_format_for_file.3 b/man/vips_format_for_file.3 deleted file mode 100644 index 70ed4cc1..00000000 --- a/man/vips_format_for_file.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/VipsFormat.3 diff --git a/man/vips_format_for_name.3 b/man/vips_format_for_name.3 deleted file mode 100644 index 70ed4cc1..00000000 --- a/man/vips_format_for_name.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/VipsFormat.3 diff --git a/man/vips_format_map.3 b/man/vips_format_map.3 deleted file mode 100644 index 70ed4cc1..00000000 --- a/man/vips_format_map.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/VipsFormat.3 diff --git a/man/vips_format_read.3 b/man/vips_format_read.3 deleted file mode 100644 index 70ed4cc1..00000000 --- a/man/vips_format_read.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/VipsFormat.3 diff --git a/man/vips_format_write.3 b/man/vips_format_write.3 deleted file mode 100644 index 70ed4cc1..00000000 --- a/man/vips_format_write.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/VipsFormat.3 diff --git a/man/vipsthumbnail.1 b/man/vipsthumbnail.1 deleted file mode 100644 index 5b8fdb96..00000000 --- a/man/vipsthumbnail.1 +++ /dev/null @@ -1,119 +0,0 @@ -.TH VIPSTHUMBNAIL 1 "13 May 2010" -.SH NAME -vipsthumbnail \- make thumbnails of image files -.SH SYNOPSIS -.B vipsthumbnail [flags] imagefile1 imagefile2 ... -.SH DESCRIPTION -.B vipsthumbnail(1) -processes each -.B imagefile -in turn, shrinking each image to fit within a 128 by 128 pixel square. -The shrunk image is written to a new file named -.B tn_imagefile.jpg. -This program is typically quite a bit faster and uses much less memory than -other image thumbnail programs. - -For example: - - $ vipsthumbnail fred.png jim.tif - -will read image files -.B fred.png -and -.B jim.tif -and write thumbnails to the files -.B tn_fred.jpg -and -.B tn_jim.jpg. - - $ vipsthumbnail --size=64 -o thumbnails/%s.png fred.jpg - -will read image file -.B fred.jpg -and write a 64 x 64 pixel thumbnail to the file -.B thumbnails/fred.png. - -On Unix machines, vips -will create temporary files in "/tmp" by default. Use the environment variable -TMPDIR to change this location. On Windows, vips uses GetTempPath() to pick a -location, see the MS documentation. - -Use the --vips-disc-threshold command-line switch, or the IM_DISC_THRESHOLD -environment variable, to make vipsthumbnail use memory rather than temporary -files. - -.SH OPTIONS -.TP -.B -s N, --size=N -Set the output thumbnail size to -.B N -x -.B N -pixels. The image is shrunk so that it just fits within this area, Images -which are smaller than this are expanded. - -.TP -.B -o FORMAT, --output=FORMAT -Set the output format string. The input filename has any file type suffix -removed, then that value is substitued into -.B FORMAT -replacing -.B %s. -The default value is -.B tn_%s.jpg -meaning JPEG output, with -.B tn_ -prepended. You can add format options too, for example -.B tn_%s.jpg:20 -will write JPEG images with Q set to 20. - -.TP -.B -p I, --interpolator=I -Resample with interpolator -.B I. -Use -.B vips --list classes -to see a list of valid interpolators. The default is -.B bilinear. - -.TP -.B -n, --nosharpen -By default, -.B vipsthumbnail(1) -will sharpen thumbnails slightly to make them look more pleasing. This option -disables this sharpening. - -.TP -.B -e PROFILE, --eprofile=PROFILE -Export thumbnails with this ICC profile. Images are only colour-transformed if -there is both an output and an input profile available. The input profile can -either be embedded in the input image or supplied with the -.B --iprofile -option. - -.TP -.B -i PROFILE, --iprofile=PROFILE -Import images with this ICC profile, if no profile is embdedded in the image. -Images are only colour-transformed if -there is both an output and an input profile available. The output profile -should be supplied with the -.B --oprofile -option. - -.TP -.B -l, --nodelete -Don't delete the profile from the output image. Since all output images will -generally have the same profile, -.B vipsthumbnail(1) -will usually delete it. This option leaves the profile inside the image. - -.TP -.B -v, --verbose -.B vipsthumbnail(1) -normally runs silently, except for warning and error messages. This option -makes it print a list of the operations it performs on each image. - -.SH RETURN VALUE -returns 0 on success and non-zero on error. -.SH SEE ALSO -header(1)