| .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 <vips/vips.h> |
| |
| 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) |