/usr/share/gtk-doc/html/libgpod/libgpod-Photo-database.html is in libgpod-doc 0.8.3-6ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Photo database: libgpod Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
<link rel="home" href="index.html" title="libgpod Reference Manual">
<link rel="up" href="photodb.html" title="Part II. Photo database">
<link rel="prev" href="photodb.html" title="Part II. Photo database">
<meta name="generator" content="GTK-Doc V1.25 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
<a href="#libgpod-Photo-database.description" class="shortcut">Description</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="photodb.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="photodb.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><img src="right-insensitive.png" width="16" height="16" border="0"></td>
</tr></table>
<div class="refentry">
<a name="libgpod-Photo-database"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="libgpod-Photo-database.top_of_page"></a>Photo database</span></h2>
<p>Photo database — Functions to create, read, write the photo database</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="libgpod-Photo-database.description"></a><h2>Description</h2>
<p>
These functions are for creating, reading, and writing the photo
database.
</p>
<p>
Overview of using the Photo database:
</p>
<p>
<code class="function">itdb_photodb_parse()</code>:
Read an existing PhotoDB.
</p>
<p>
<code class="function">itdb_photodb_create()</code>:
Create a new <span class="type">Itdb_PhotoDB</span> structure. The Photo Library Album is
(first album) is created automatically.
</p>
<p>
<code class="function">itdb_photodb_add_photo()</code>, <code class="function">itdb_photodb_add_photo_from_data()</code>:
Add a photo to the PhotoDB (from file or from a chunk of
memory). It is automatically added to the Photo Library Album
(first album), which is created if it does not exist already.
</p>
<p>
<code class="function">itdb_photodb_photoalbum_create()</code>:
Create and add a new photoalbum.
</p>
<p>
<code class="function">itdb_photodb_photoalbum_add_photo()</code>:
Add a photo (<span class="type">Itdb_Artwork</span>) to an existing photoalbum.
</p>
<p>
<code class="function">itdb_photodb_photoalbum_remove()</code>:
Remove an existing photoalbum. Pictures can be kept in the
Photo Library or automatically removed as well.
</p>
<p>
<code class="function">itdb_photodb_remove_photo()</code>:
Remove a photo either from a photoalbum or completely from the database.
</p>
<p>
<code class="function">itdb_photodb_write()</code>:
Write out your PhotoDB.
</p>
<p>
<code class="function">itdb_photodb_free()</code>:
Free all memory taken by the PhotoDB.
</p>
<p>
<code class="function">itdb_photodb_photoalbum_by_name()</code>:
Find the first photoalbum with a given name or the Photo
Library Album if called with no name.
</p>
<p>
If you cannot add photos because your iPod is not recognized,
you may have to set the iPod model by calling
<code class="function">itdb_device_set_sysinfo()</code>, e.g. for an 80 GB 6th generation
iPod Video, you would use:
</p>
<pre class="programlisting">
itdb_device_set_sysinfo (db->device, "ModelNumStr", "MA450");
</pre>
<p>
See <a class="ulink" href="http://gtkpod.git.sourceforge.net/git/gitweb.cgi?p=gtkpod/libgpod;a=blob_plain;f=src/itdb_device.c;hb=HEAD" target="_top">itdb_device.c</a>
for a list of supported models.
</p>
<p>
The model number will be saved on the iPod when the PhotoDB is
written (<code class="function">itdb_photodb_write()</code> calls <code class="function">itdb_device_write_sysinfo()</code>).
</p>
<p>
Have a look at the <a class="ulink" href="http://gtkpod.git.sourceforge.net/git/gitweb.cgi?p=gtkpod/libgpod;a=blob_plain;f=tests/test-photos.c;hb=HEAD" target="_top">test-photos</a>
test program in the <a class="ulink" href="http://gtkpod.git.sourceforge.net/git/gitweb.cgi?p=gtkpod/libgpod;a=tree;f=tests;hb=HEAD" target="_top">tests/</a>
directory of the libgpod source for an example of how to use the interface.
</p>
</div>
<div class="refsect1">
<a name="libgpod-Photo-database.functions_details"></a><h2>Functions</h2>
<p></p>
</div>
<div class="refsect1">
<a name="libgpod-Photo-database.other_details"></a><h2>Types and Values</h2>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.25</div>
</body>
</html>
|