Poster of Linux kernelThe best gift for a Linux geek
IM_CP_DESC

IM_CP_DESC

Section: C Library Functions (3) Updated: 11 April 1990
Local index Up
 

NAME

im_cp_desc, im_append_Hist - copy most of an image descriptor to another image descriptor.  

SYNOPSIS

#include <vips/vips.h>

int im_cp_desc_array( IMAGE *out, IMAGE *in[] );

int im_cp_descv( IMAGE *out, IMAGE *in1, ... );

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

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

 

DESCRIPTION

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.

im_cp_descv(3) is a varargs conveniece function for im_cp_desc_array(3).

im_cp_desc(3) is a convenience function which calls im_cp_descv( image1, image2, NULL ).

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.

 

RETURN VALUE

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

COPYRIGHT


N. Dessipris  

AUTHOR

N. Dessipris - 11/04/1990


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
COPYRIGHT
AUTHOR

This document was created by man2html, using the manual pages.
Time: 21:48:16 GMT, April 16, 2011