"http://www.w3.org/TR/html4/loose.dtd">

<meta content="groff -Thtml, see www.gnu.org" name="generator">

<meta content="text/html; charset=US-ASCII" http-equiv="Content-Type">

<meta content="text/css" name="Content-Style">

<style type="text/css"></style>

       p       { margin-top: 0; margin-bottom: 0; vertical-align: top }

       pre     { margin-top: 0; margin-bottom: 0; vertical-align: top }

       table   { margin-top: 0; margin-bottom: 0; vertical-align: top }

       h1      { text-align: center }

<title>TIFFSetField</title>

TIFFSetField

NAME

SYNOPSIS

DESCRIPTION

RETURN VALUES

DIAGNOSTICS

SEE ALSO

NAME

TIFFSetField,

TIFFVSetField − set the value(s) of a tag in a

<small>TIFF</small> file open for writing

SYNOPSIS

#include

<tiffio.h>

int

TIFFSetField(TIFF *tif, ttag_t

tag, ...)

#include

<stdarg.h>

int

TIFFVSetField(TIFF *tif, ttag_t

tag, va_list ap)

DESCRIPTION

TIFFSetField

sets the value of a field or pseudo-tag in the current

directory associated with the open <small>TIFF</small> file

tif. (A pseudo-tag is a parameter that is used

to control the operation of the <small>TIFF</small> library

but whose value is not read or written to the underlying

file.) To set the value of a field the file must have been

previously opened for writing with TIFFOpen(3TIFF);

pseudo-tags can be set whether the file was opened for

reading or writing. The field is identified by tag,

one of the values defined in the include file tiff.h

(see also the table below). The actual value is specified

using a variable argument list, as prescribed by the

stdarg(3) interface (or, on some machines, the

varargs(3) interface.)

TIFFVSetField

is functionally equivalent to TIFFSetField except

that it takes a pointer to a variable argument list.

TIFFVSetField is useful for writing routines that are

layered on top of the functionality provided by

TIFFSetField.

The tags

understood by libtiff, the number of parameter

values, and the expected types for the parameter values are

shown below. The data types are: char* is

null-terminated string and corresponds to the

<small>ASCII</small> data type; uint16 is an unsigned

16-bit value; uint32 is an unsigned 32-bit value;

uint16* is an array of unsigned 16-bit values.

void* is an array of data values of unspecified

type.

Consult the

<small>TIFF</small> specification for information on the

meaning of each tag.

       cellspacing="0" cellpadding="0">

Tag Name

Count

Types

Notes

TIFFTAG_ARTIST

1

char*

TIFFTAG_BADFAXLINES

1

uint32

TIFFTAG_BITSPERSAMPLE

1

uint16

†

TIFFTAG_CLEANFAXDATA

1

uint16

TIFFTAG_COLORMAP

3

uint16*

1<<BitsPerSample arrays

TIFFTAG_COMPRESSION

1

uint16

†

TIFFTAG_CONSECUTIVEBADFAXLINES

1

uint32

TIFFTAG_COPYRIGHT

1

char*

TIFFTAG_DATETIME

1

char*

TIFFTAG_DOCUMENTNAME

1

char*

TIFFTAG_DOTRANGE

2

uint16

TIFFTAG_EXTRASAMPLES

2

uint16,uint16*

† count & types array

TIFFTAG_FAXFILLFUNC

1

TIFFFaxFillFunc

G3/G4 compression pseudo-tag

TIFFTAG_FAXMODE

1

int

† G3/G4 compression pseudo-tag

TIFFTAG_FILLORDER

1

uint16

†

TIFFTAG_GROUP3OPTIONS

1

uint32

†

TIFFTAG_GROUP4OPTIONS

1

uint32

†

TIFFTAG_HALFTONEHINTS

2

uint16

TIFFTAG_HOSTCOMPUTER

1

char*

TIFFTAG_ICCPROFILE

2

uint32,void*

count, profile data

TIFFTAG_IMAGEDEPTH

1

uint32

†

TIFFTAG_IMAGEDESCRIPTION

1

char*

TIFFTAG_IMAGELENGTH

1

uint32

TIFFTAG_IMAGEWIDTH

1

uint32

†

TIFFTAG_INKNAMES

2

uint16, char*

TIFFTAG_INKSET

1

uint16

†

TIFFTAG_JPEGCOLORMODE

1

int

† JPEG pseudo-tag

TIFFTAG_JPEGQUALITY

1

int

JPEG pseudo-tag

TIFFTAG_JPEGTABLES

2

uint32*,void*

† count & tables

TIFFTAG_JPEGTABLESMODE

1

int

† JPEG pseudo-tag