← Back to branch summary

~ubuntu-branches/ubuntu/karmic/tiff/karmic-security

« back to all changes in this revision

Viewing changes to html/man/TIFFSetDirectory.3t.html

  • Committer: Bazaar Package Importer
  • Author(s): Fabio M. Di Nitto
  • Date: 2004-10-14 07:57:59 UTC
  • Revision ID: james.westby@ubuntu.com-20041014075759-a77e7zuaetya8cp0
Tags: upstream-3.6.1
Import upstream version 3.6.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
html/man/TIFFSetDirectory.3t.html
 
1
<html>
 
2
<head>
 
3
<meta name="generator" content="groff -Thtml, see www.gnu.org">
 
4
<meta name="Content-Style" content="text/css">
 
5
<title>TIFFSetDirectory</title>
 
6
</head>
 
7
<body>
 
8
 
 
9
<h1 align=center>TIFFSetDirectory</h1>
 
10
<a href="#NAME">NAME</a><br>
 
11
<a href="#SYNOPSIS">SYNOPSIS</a><br>
 
12
<a href="#DESCRIPTION">DESCRIPTION</a><br>
 
13
<a href="#RETURN VALUES">RETURN VALUES</a><br>
 
14
<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br>
 
15
<a href="#SEE ALSO">SEE ALSO</a><br>
 
16
 
 
17
<hr>
 
18
<!-- Creator     : groff version 1.17.2 -->
 
19
<!-- CreationDate: Mon Dec 22 00:39:26 2003 -->
 
20
<a name="NAME"></a>
 
21
<h2>NAME</h2>
 
22
<table width="100%" border=0 rules="none" frame="void"
 
23
       cols="2" cellspacing="0" cellpadding="0">
 
24
<tr valign="top" align="left">
 
25
<td width="10%"></td><td width="90%">
 
26
TIFFSetDirectory, TIFFSetSubDirectory - set the current directory for an open <small>TIFF</small> file</td></table>
 
27
<a name="SYNOPSIS"></a>
 
28
<h2>SYNOPSIS</h2>
 
29
 
 
30
<table width="100%" border=0 rules="none" frame="void"
 
31
       cols="2" cellspacing="0" cellpadding="0">
 
32
<tr valign="top" align="left">
 
33
<td width="10%"></td><td width="90%">
 
34
<b>#include &lt;tiffio.h&gt;<br>
 
35
int TIFFSetDirectory(TIFF* tif, tdir_t dirnum)<br>
 
36
int TIFFSetSubDirectory(TIFF* tif, uint32
 
37
diroff)</b></td></table>
 
38
<a name="DESCRIPTION"></a>
 
39
<h2>DESCRIPTION</h2>
 
40
 
 
41
<table width="100%" border=0 rules="none" frame="void"
 
42
       cols="2" cellspacing="0" cellpadding="0">
 
43
<tr valign="top" align="left">
 
44
<td width="10%"></td><td width="90%">
 
45
<i>TIFFSetDirectory</i> changes the current directory and
 
46
reads its contents with <i>TIFFReadDirectory</i>. The
 
47
parameter <i>dirnum</i> specifies the subfile/directory as
 
48
an integer number, with the first directory numbered
 
49
zero.</td></table>
 
50
 
 
51
<table width="100%" border=0 rules="none" frame="void"
 
52
       cols="2" cellspacing="0" cellpadding="0">
 
53
<tr valign="top" align="left">
 
54
<td width="10%"></td><td width="90%">
 
55
<i>TIFFSetSubDirectory</i> acts like
 
56
<i>TIFFSetDirectory</i>, except the directory is specified
 
57
as a file offset instead of an index; this is required for
 
58
accessing subdirectories linked through a <i>SubIFD</i>
 
59
tag.</td></table>
 
60
<a name="RETURN VALUES"></a>
 
61
<h2>RETURN VALUES</h2>
 
62
 
 
63
<table width="100%" border=0 rules="none" frame="void"
 
64
       cols="2" cellspacing="0" cellpadding="0">
 
65
<tr valign="top" align="left">
 
66
<td width="10%"></td><td width="90%">
 
67
On successful return 1 is returned. Otherwise, 0 is returned
 
68
if <i>dirnum</i> or <i>diroff</i> specifies a non-existent
 
69
directory, or if an error was encountered while reading the
 
70
directory's contents.</td></table>
 
71
<a name="DIAGNOSTICS"></a>
 
72
<h2>DIAGNOSTICS</h2>
 
73
 
 
74
<table width="100%" border=0 rules="none" frame="void"
 
75
       cols="2" cellspacing="0" cellpadding="0">
 
76
<tr valign="top" align="left">
 
77
<td width="10%"></td><td width="90%">
 
78
All error messages are directed to the <i>TIFFError</i>(3T)
 
79
routine.</td></table>
 
80
 
 
81
<table width="100%" border=0 rules="none" frame="void"
 
82
       cols="2" cellspacing="0" cellpadding="0">
 
83
<tr valign="top" align="left">
 
84
<td width="10%"></td><td width="90%">
 
85
<b>%s: Error fetching directory count</b>. An error was
 
86
encountered while reading the ``directory count''
 
87
field.</td></table>
 
88
 
 
89
<table width="100%" border=0 rules="none" frame="void"
 
90
       cols="2" cellspacing="0" cellpadding="0">
 
91
<tr valign="top" align="left">
 
92
<td width="10%"></td><td width="90%">
 
93
<b>%s: Error fetching directory link</b>. An error was
 
94
encountered while reading the ``link value'' that points to
 
95
the next directory in a file.</td></table>
 
96
<a name="SEE ALSO"></a>
 
97
<h2>SEE ALSO</h2>
 
98
 
 
99
<table width="100%" border=0 rules="none" frame="void"
 
100
       cols="2" cellspacing="0" cellpadding="0">
 
101
<tr valign="top" align="left">
 
102
<td width="10%"></td><td width="90%">
 
103
<i>libtiff</i>(3T), <i>TIFFCurrentDirectory</i>(3T),
 
104
<i>TIFFOpen</i>(3T), <i>TIFFReadDirectory</i>(3T),
 
105
<i>TIFFWriteDirectory</i>(3T)</td></table>
 
106
<hr>
 
107
</body>
 
108
</html>