10dcb9ef1SAndrey Kiselev<!-- Creator : groff version 1.18.1 --> 2f14d1a56SAndrey Kiselev<!-- CreationDate: Sat Feb 24 18:37:17 2007 --> 387c5da6fSAndrey Kiselev<html> 487c5da6fSAndrey Kiselev<head> 587c5da6fSAndrey Kiselev<meta name="generator" content="groff -Thtml, see www.gnu.org"> 687c5da6fSAndrey Kiselev<meta name="Content-Style" content="text/css"> 787c5da6fSAndrey Kiselev<title>TIFFSetDirectory</title> 887c5da6fSAndrey Kiselev</head> 987c5da6fSAndrey Kiselev<body> 1087c5da6fSAndrey Kiselev 1187c5da6fSAndrey Kiselev<h1 align=center>TIFFSetDirectory</h1> 1287c5da6fSAndrey Kiselev<a href="#NAME">NAME</a><br> 1387c5da6fSAndrey Kiselev<a href="#SYNOPSIS">SYNOPSIS</a><br> 1487c5da6fSAndrey Kiselev<a href="#DESCRIPTION">DESCRIPTION</a><br> 1587c5da6fSAndrey Kiselev<a href="#RETURN VALUES">RETURN VALUES</a><br> 1687c5da6fSAndrey Kiselev<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br> 1787c5da6fSAndrey Kiselev<a href="#SEE ALSO">SEE ALSO</a><br> 1887c5da6fSAndrey Kiselev 1987c5da6fSAndrey Kiselev<hr> 2087c5da6fSAndrey Kiselev<a name="NAME"></a> 2187c5da6fSAndrey Kiselev<h2>NAME</h2> 220dcb9ef1SAndrey Kiselev<!-- INDENTATION --> 230dcb9ef1SAndrey Kiselev<table width="100%" border=0 rules="none" frame="void" 240dcb9ef1SAndrey Kiselev cols="2" cellspacing="0" cellpadding="0"> 250dcb9ef1SAndrey Kiselev<tr valign="top" align="left"> 260dcb9ef1SAndrey Kiselev<td width="8%"></td> 270dcb9ef1SAndrey Kiselev<td width="91%"> 280dcb9ef1SAndrey Kiselev<p>TIFFSetDirectory, TIFFSetSubDirectory − set the 290dcb9ef1SAndrey Kiselevcurrent directory for an open <small>TIFF</small> file</p> 300dcb9ef1SAndrey Kiselev</td> 310dcb9ef1SAndrey Kiselev</table> 3287c5da6fSAndrey Kiselev<a name="SYNOPSIS"></a> 3387c5da6fSAndrey Kiselev<h2>SYNOPSIS</h2> 340dcb9ef1SAndrey Kiselev<!-- INDENTATION --> 350dcb9ef1SAndrey Kiselev<table width="100%" border=0 rules="none" frame="void" 360dcb9ef1SAndrey Kiselev cols="2" cellspacing="0" cellpadding="0"> 370dcb9ef1SAndrey Kiselev<tr valign="top" align="left"> 380dcb9ef1SAndrey Kiselev<td width="8%"></td> 390dcb9ef1SAndrey Kiselev<td width="91%"> 400dcb9ef1SAndrey Kiselev<p><b>#include <tiffio.h></b></p> 410dcb9ef1SAndrey Kiselev<!-- INDENTATION --> 420dcb9ef1SAndrey Kiselev<p><b>int TIFFSetDirectory(TIFF *</b><i>tif</i><b>, 430dcb9ef1SAndrey Kiselevtdir_t</b> <i>dirnum</i><b>)<br> 4487c5da6fSAndrey Kiselevint TIFFSetSubDirectory(TIFF *</b><i>tif</i><b>, uint32</b> 4587c5da6fSAndrey Kiselev<i>diroff</i><b>)</b></p> 460dcb9ef1SAndrey Kiselev</td> 470dcb9ef1SAndrey Kiselev</table> 4887c5da6fSAndrey Kiselev<a name="DESCRIPTION"></a> 4987c5da6fSAndrey Kiselev<h2>DESCRIPTION</h2> 500dcb9ef1SAndrey Kiselev<!-- INDENTATION --> 510dcb9ef1SAndrey Kiselev<table width="100%" border=0 rules="none" frame="void" 520dcb9ef1SAndrey Kiselev cols="2" cellspacing="0" cellpadding="0"> 530dcb9ef1SAndrey Kiselev<tr valign="top" align="left"> 540dcb9ef1SAndrey Kiselev<td width="8%"></td> 550dcb9ef1SAndrey Kiselev<td width="91%"> 560dcb9ef1SAndrey Kiselev<p><i>TIFFSetDirectory</i> changes the current directory and 570dcb9ef1SAndrey Kiselevreads its contents with <i>TIFFReadDirectory</i>. The 580dcb9ef1SAndrey Kiselevparameter <i>dirnum</i> specifies the subfile/directory as 590dcb9ef1SAndrey Kiselevan integer number, with the first directory numbered 600dcb9ef1SAndrey Kiselevzero.</p> 610dcb9ef1SAndrey Kiselev<!-- INDENTATION --> 620dcb9ef1SAndrey Kiselev<p><i>TIFFSetSubDirectory</i> acts like 630dcb9ef1SAndrey Kiselev<i>TIFFSetDirectory</i>, except the directory is specified 640dcb9ef1SAndrey Kiselevas a file offset instead of an index; this is required for 650dcb9ef1SAndrey Kiselevaccessing subdirectories linked through a <i>SubIFD</i> 660dcb9ef1SAndrey Kiselevtag.</p> 670dcb9ef1SAndrey Kiselev</td> 680dcb9ef1SAndrey Kiselev</table> 6987c5da6fSAndrey Kiselev<a name="RETURN VALUES"></a> 7087c5da6fSAndrey Kiselev<h2>RETURN VALUES</h2> 710dcb9ef1SAndrey Kiselev<!-- INDENTATION --> 720dcb9ef1SAndrey Kiselev<table width="100%" border=0 rules="none" frame="void" 730dcb9ef1SAndrey Kiselev cols="2" cellspacing="0" cellpadding="0"> 740dcb9ef1SAndrey Kiselev<tr valign="top" align="left"> 750dcb9ef1SAndrey Kiselev<td width="8%"></td> 760dcb9ef1SAndrey Kiselev<td width="91%"> 770dcb9ef1SAndrey Kiselev<p>On successful return 1 is returned. Otherwise, 0 is 780dcb9ef1SAndrey Kiselevreturned if <i>dirnum</i> or <i>diroff</i> specifies a 790dcb9ef1SAndrey Kiselevnon-existent directory, or if an error was encountered while 800dcb9ef1SAndrey Kiselevreading the directory’s contents.</p> 810dcb9ef1SAndrey Kiselev</td> 820dcb9ef1SAndrey Kiselev</table> 8387c5da6fSAndrey Kiselev<a name="DIAGNOSTICS"></a> 8487c5da6fSAndrey Kiselev<h2>DIAGNOSTICS</h2> 850dcb9ef1SAndrey Kiselev<!-- INDENTATION --> 860dcb9ef1SAndrey Kiselev<table width="100%" border=0 rules="none" frame="void" 870dcb9ef1SAndrey Kiselev cols="2" cellspacing="0" cellpadding="0"> 880dcb9ef1SAndrey Kiselev<tr valign="top" align="left"> 890dcb9ef1SAndrey Kiselev<td width="8%"></td> 900dcb9ef1SAndrey Kiselev<td width="91%"> 910dcb9ef1SAndrey Kiselev<p>All error messages are directed to the 920dcb9ef1SAndrey Kiselev<i>TIFFError</i>(3TIFF) routine.</p> 930dcb9ef1SAndrey Kiselev<!-- INDENTATION --> 940dcb9ef1SAndrey Kiselev<p><b>%s: Error fetching directory count</b>. An error was 950dcb9ef1SAndrey Kiselevencountered while reading the ‘‘directory 960dcb9ef1SAndrey Kiselevcount’’ field.</p> 970dcb9ef1SAndrey Kiselev<!-- INDENTATION --> 980dcb9ef1SAndrey Kiselev<p><b>%s: Error fetching directory link</b>. An error was 990dcb9ef1SAndrey Kiselevencountered while reading the ‘‘link 1000dcb9ef1SAndrey Kiselevvalue’’ that points to the next directory in a 1010dcb9ef1SAndrey Kiselevfile.</p> 1020dcb9ef1SAndrey Kiselev</td> 1030dcb9ef1SAndrey Kiselev</table> 10487c5da6fSAndrey Kiselev<a name="SEE ALSO"></a> 10587c5da6fSAndrey Kiselev<h2>SEE ALSO</h2> 1060dcb9ef1SAndrey Kiselev<!-- INDENTATION --> 1070dcb9ef1SAndrey Kiselev<table width="100%" border=0 rules="none" frame="void" 1080dcb9ef1SAndrey Kiselev cols="2" cellspacing="0" cellpadding="0"> 1090dcb9ef1SAndrey Kiselev<tr valign="top" align="left"> 1100dcb9ef1SAndrey Kiselev<td width="8%"></td> 1110dcb9ef1SAndrey Kiselev<td width="91%"> 1120dcb9ef1SAndrey Kiselev<p><i>TIFFCurrentDirectory</i>(3TIFF), 1130776b32dSAndrey Kiselev<i>TIFFOpen</i>(3TIFF), <i>TIFFReadDirectory</i>(3TIFF), 1140776b32dSAndrey Kiselev<i>TIFFWriteDirectory</i>(3TIFF), <i>libtiff</i>(3TIFF)</p> 1150dcb9ef1SAndrey Kiselev<!-- INDENTATION --> 1160dcb9ef1SAndrey Kiselev<p>Libtiff library home page: 117*d4dd6cccSBob Friesenhahn<b>http://www.simplesystems.org/libtiff/</b></p> 1180dcb9ef1SAndrey Kiselev</td> 1190dcb9ef1SAndrey Kiselev</table> 12087c5da6fSAndrey Kiselev<hr> 12187c5da6fSAndrey Kiselev</body> 12287c5da6fSAndrey Kiselev</html> 123