IM_COPY

Section: C Library Functions (3)
Updated: 11 April 1990
Index Return to Main Contents
 

NAME

im_copy, im_copy_set, im_copy_swap, im_copy_morph - copy an image  

SYNOPSIS

#include <vips/vips.h>

int im_copy(in, out)
IMAGE *in, *out;

int im_copy_set( in, out, type, xres, yres )
IMAGE *in, *out;
int type;
float xres, yres;

int im_copy_swap( in, out )
IMAGE *in, *out;

int im_copy_morph( in, out, Bands, BandFmt, Coding )
IMAGE *in, *out;
int Bands, BandFmt, Coding;

typedef enum {

  IM_ARCH_NATIVE,

  IM_ARCH_BYTE_SWAPPED,

  IM_ARCH_LSB_FIRST,

  IM_ARCH_MSB_FIRST
} im_arch_type;

int im_copy_from( in, out, architecture )
IMAGE *in, *out;
im_arch_type architecture;

 

DESCRIPTION

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!

im_copy_set(3) behaves exactly as im_copy(3), but lets you set informational fields in the header on the way through.

im_copy_swap(3) copies an uncoded image, swapping between SPARC and Intel byte order on the way.

im_copy_morph(3) behaves exactly as im_copy(3), but lets you set fields which affect pixel format on the way through.

im_copy_from(3) calls either im_copy(3) or im_copy_swap(3) as necessary to copy from the specified architecture.

 

RETURN VALUE

The function returns 0 on success and -1 on error.  

SEE ALSO

im_extract(3), im_open(3)