<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<title>Exiv2: Exiv2::TiffImage Class Reference</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.5.4 -->
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="classes.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li><a href="examples.html"><span>Examples</span></a></li>
<li>
<form action="search.php" method="get">
<table cellspacing="0" cellpadding="0" border="0">
<tr>
<td><label> <u>S</u>earch for </label></td>
<td><input type="text" name="query" value="" size="20" accesskey="s"/></td>
</tr>
</table>
</form>
</li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="classes.html"><span>Alphabetical List</span></a></li>
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
<div class="nav">
<a class="el" href="namespaceExiv2.html">Exiv2</a>::<a class="el" href="classExiv2_1_1TiffImage.html">TiffImage</a></div>
<h1>Exiv2::TiffImage Class Reference</h1><!-- doxytag: class="Exiv2::TiffImage" --><!-- doxytag: inherits="Exiv2::Image" -->Class to access TIFF images. Exif metadata is supported directly, IPTC is read from the Exif data, if present.
<a href="#_details">More...</a>
<p>
<code>#include <tiffimage.hpp></code>
<p>
<div class="dynheader">
Inheritance diagram for Exiv2::TiffImage:</div>
<div class="dynsection">
<p><center><img src="classExiv2_1_1TiffImage__inherit__graph.png" border="0" usemap="#Exiv2_1_1TiffImage__inherit__map" alt="Inheritance graph"></center>
<map name="Exiv2_1_1TiffImage__inherit__map">
<area shape="rect" href="classExiv2_1_1Image.html" title="Abstract base class defining the interface for an image. This is the top-level interface..." alt="" coords="25,7,167,31"></map>
<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center></div>
<div class="dynheader">
Collaboration diagram for Exiv2::TiffImage:</div>
<div class="dynsection">
<p><center><img src="classExiv2_1_1TiffImage__coll__graph.png" border="0" usemap="#Exiv2_1_1TiffImage__coll__map" alt="Collaboration graph"></center>
<map name="Exiv2_1_1TiffImage__coll__map">
<area shape="rect" href="classExiv2_1_1Image.html" title="Abstract base class defining the interface for an image. This is the top-level interface..." alt="" coords="1301,216,1443,240"><area shape="rect" href="classExiv2_1_1ExifData.html" title="A container for Exif data. This is a top-level class of the Exiv2 library. The container..." alt="" coords="965,167,1136,191"><area shape="rect" href="classExiv2_1_1MakerNote.html" title="Exif makernote interface." alt="" coords="501,176,683,200"><area shape="rect" href="classExiv2_1_1Ifd.html" title="Models an IFD (Image File Directory)." alt="" coords="532,118,652,142"><area shape="rect" title="STL class." alt="" coords="51,58,232,82"><area shape="rect" href="classExiv2_1_1XmpData.html" title="A container for XMP data. This is a top-level class of the Exiv2 library." alt="" coords="759,271,919,295"><area shape="rect" href="classExiv2_1_1IptcData.html" title="A container for IPTC data. This is a top-level class of the Exiv2 library." alt="" coords="753,6,924,30"><area shape="rect" href="classExiv2_1_1TiffHeader.html" title="Helper class modelling the TIFF header structure." alt="" coords="496,224,688,248"><area shape="rect" title="STL class." alt="" coords="951,276,1151,300"><area shape="rect" title="STL class." alt="" coords="985,330,1116,354"><area shape="rect" title="STL class." alt="" coords="5,330,277,354"></map>
<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center></div>
<p>
<a href="classExiv2_1_1TiffImage-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
<tr><td colspan="2"><div class="groupHeader">Creators</div></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1TiffImage.html#c304d73256f3406c0a63d18edc98be39">TiffImage</a> (<a class="el" href="classExiv2_1_1BasicIo.html#f8f989522925b884d8c9d3a257265fa1">BasicIo::AutoPtr</a> io, bool create)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Constructor that can either open an existing TIFF image or create a new image from scratch. If a new image is to be created, any existing data is overwritten. Since the constructor can not return a result, callers should check the <a class="el" href="classExiv2_1_1Image.html#057cb663d5666ca5c0515a3957d15102" title="Check if the Image instance is valid. Use after object construction.">good()</a> method after object construction to determine success or failure. <a href="#c304d73256f3406c0a63d18edc98be39"></a><br></td></tr>
<tr><td colspan="2"><div class="groupHeader">Manipulators</div></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1TiffImage.html#c0965fb8aea437062775da11bece20ff">readMetadata</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Read all metadata supported by a specific image format from the image. Before this method is called, the image metadata will be cleared. <a href="#c0965fb8aea437062775da11bece20ff"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="b4d6dcbd915abe2254bfef751a3f1da7"></a><!-- doxytag: member="Exiv2::TiffImage::writeMetadata" ref="b4d6dcbd915abe2254bfef751a3f1da7" args="()" -->
void </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1TiffImage.html#b4d6dcbd915abe2254bfef751a3f1da7">writeMetadata</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Todo: Write metadata back to the image. This method is not yet implemented. Calling it will throw an Error(31). <br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="8ddde0de8a5e276a76228f87a421457f"></a><!-- doxytag: member="Exiv2::TiffImage::setExifData" ref="8ddde0de8a5e276a76228f87a421457f" args="(const ExifData &exifData)" -->
void </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1TiffImage.html#8ddde0de8a5e276a76228f87a421457f">setExifData</a> (const <a class="el" href="classExiv2_1_1ExifData.html">ExifData</a> &exifData)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Todo: Not supported yet, requires <a class="el" href="classExiv2_1_1TiffImage.html#b4d6dcbd915abe2254bfef751a3f1da7" title="Todo: Write metadata back to the image. This method is not yet implemented. Calling...">writeMetadata()</a>. Calling this function will throw an Error(32). <br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="0e942d1c73382377681728e9e417e7bd"></a><!-- doxytag: member="Exiv2::TiffImage::setIptcData" ref="0e942d1c73382377681728e9e417e7bd" args="(const IptcData &iptcData)" -->
void </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1TiffImage.html#0e942d1c73382377681728e9e417e7bd">setIptcData</a> (const <a class="el" href="classExiv2_1_1IptcData.html">IptcData</a> &iptcData)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Todo: Not supported yet, requires <a class="el" href="classExiv2_1_1TiffImage.html#b4d6dcbd915abe2254bfef751a3f1da7" title="Todo: Write metadata back to the image. This method is not yet implemented. Calling...">writeMetadata()</a>. Calling this function will throw an Error(32). <br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="c204968b22d3098c974551e0d2067650"></a><!-- doxytag: member="Exiv2::TiffImage::setComment" ref="c204968b22d3098c974551e0d2067650" args="(const std::string &comment)" -->
void </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1TiffImage.html#c204968b22d3098c974551e0d2067650">setComment</a> (const std::string &comment)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Not supported. TIFF format does not contain a comment. Calling this function will throw an Error(32). <br></td></tr>
<tr><td colspan="2"><div class="groupHeader">Accessors</div></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="classExiv2_1_1TiffImage.html#c756bdc09ffb0ab6acf005058b2ac032">mimeType</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return the MIME type of the image. <a href="#c756bdc09ffb0ab6acf005058b2ac032"></a><br></td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
Class to access TIFF images. Exif metadata is supported directly, IPTC is read from the Exif data, if present. <hr><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" name="c304d73256f3406c0a63d18edc98be39"></a><!-- doxytag: member="Exiv2::TiffImage::TiffImage" ref="c304d73256f3406c0a63d18edc98be39" args="(BasicIo::AutoPtr io, bool create)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Exiv2::TiffImage::TiffImage </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classExiv2_1_1BasicIo.html#f8f989522925b884d8c9d3a257265fa1">BasicIo::AutoPtr</a> </td>
<td class="paramname"> <em>io</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>create</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Constructor that can either open an existing TIFF image or create a new image from scratch. If a new image is to be created, any existing data is overwritten. Since the constructor can not return a result, callers should check the <a class="el" href="classExiv2_1_1Image.html#057cb663d5666ca5c0515a3957d15102" title="Check if the Image instance is valid. Use after object construction.">good()</a> method after object construction to determine success or failure.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>io</em> </td><td>An auto-pointer that owns a <a class="el" href="classExiv2_1_1BasicIo.html" title="An interface for simple binary IO.">BasicIo</a> instance used for reading and writing image metadata. <b>Important:</b> The constructor takes ownership of the passed in <a class="el" href="classExiv2_1_1BasicIo.html" title="An interface for simple binary IO.">BasicIo</a> instance through the auto-pointer. Callers should not continue to use the <a class="el" href="classExiv2_1_1BasicIo.html" title="An interface for simple binary IO.">BasicIo</a> instance after it is passed to this method. Use the <a class="el" href="classExiv2_1_1Image.html#5b4560b599ff50e28e3dc31fba62431e" title="Return a reference to the BasicIo instance being used for Io.">Image::io()</a> method to get a temporary reference. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>create</em> </td><td>Specifies if an existing image should be read (false) or if a new file should be created (true). </td></tr>
</table>
</dl>
</div>
</div><p>
<hr><h2>Member Function Documentation</h2>
<a class="anchor" name="c0965fb8aea437062775da11bece20ff"></a><!-- doxytag: member="Exiv2::TiffImage::readMetadata" ref="c0965fb8aea437062775da11bece20ff" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Exiv2::TiffImage::readMetadata </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Read all metadata supported by a specific image format from the image. Before this method is called, the image metadata will be cleared.
<p>
This method returns success even if no metadata is found in the image. Callers must therefore check the size of individual metadata types before accessing the data.<p>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classExiv2_1_1Error.html" title="Simple error class used for exceptions. An output operator is provided to print errors...">Error</a></em> </td><td>if opening or reading of the file fails or the image data is not valid (does not look like data of the specific image type). </td></tr>
</table>
</dl>
<p>Implements <a class="el" href="classExiv2_1_1Image.html#198b8d5924d6441748aa162130c96a5f">Exiv2::Image</a>.</p>
</div>
</div><p>
<a class="anchor" name="c756bdc09ffb0ab6acf005058b2ac032"></a><!-- doxytag: member="Exiv2::TiffImage::mimeType" ref="c756bdc09ffb0ab6acf005058b2ac032" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::string Exiv2::TiffImage::mimeType </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const<code> [inline, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Return the MIME type of the image.
<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>For each supported image format, the library knows only one MIME type. This may not be the most specific MIME type for that format. In particular, several RAW formats are variants of the TIFF format with the same magic as TIFF itself. Class <a class="el" href="classExiv2_1_1TiffImage.html" title="Class to access TIFF images. Exif metadata is supported directly, IPTC is read from...">TiffImage</a> handles most of them and thus they all have MIME type "image/tiff", although a more specific MIME type may exist (e.g., "image/x-nikon-nef"). </dd></dl>
<p>Implements <a class="el" href="classExiv2_1_1Image.html#5c517b500586613595e2e1b62601657a">Exiv2::Image</a>.</p>
</div>
</div><p>
<hr>The documentation for this class was generated from the following file:<ul>
<li><a class="el" href="tiffimage_8hpp.html">tiffimage.hpp</a></ul>
<hr size="1"><address style="text-align: right;"><small>Generated on Tue Feb 5 11:51:12 2008 for Exiv2 by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.4 </small></address>
</body>
</html>
distrib
>
Mandriva
>
2008.1
>
x86_64
>
media
>
main-release
>
by-pkgid
>
e31b59fe09ff595814e8029d984f51c5
>
files
>
757
