Commit 426b216f authored by gbillock@chromium.org's avatar gbillock@chromium.org

[MediaGalleries] Update overall package doc to include iphoto paragraph.

R=vandebo@chromium.org
BUG=343968

Review URL: https://codereview.chromium.org/215433003

git-svn-id: svn://svn.chromium.org/chrome/trunk/src@260273 0039d316-1c4b-4281-b951-d872f2087c98
parent d005dbd7
...@@ -110,21 +110,42 @@ to read all the media files from galleries that the user selected.</p> ...@@ -110,21 +110,42 @@ to read all the media files from galleries that the user selected.</p>
<p>If present, the user's iTunes library can be accessed as a media gallery. <p>If present, the user's iTunes library can be accessed as a media gallery.
In addition to the media files in the library, the "iTunes Music Library.xml" In addition to the media files in the library, the "iTunes Music Library.xml"
file is also presented. Regardless of where the music files are actually on the file is also presented.</p>
disk (and where the xml file says they are), they are mapping into an <p>Regardless of where the music files are actually on the disk (and where
Artist/Album/Track hierarchy like iTunes does by default. This mapping doesn't the xml file says they are), they are mapped into an Artist/Album/Track
always work perfectly, so there are two things to note for Apps trying to match hierarchy like iTunes does by default. This mapping doesn't always work
the xml file with files in the gallery. If the filenames for tracks within an perfectly, so there are two things to note for Apps trying to match the
album are not unique, they will be uniquified by adding the track id in xml file with files in the gallery.</p>
parentheses before the extension, and if there is a colon or a slash in the <p>If the filenames for tracks within an album are not unique, they will be
artist, album, or track name, they are turned into underscore characters.</p> uniquified by adding the track id in parentheses before the extension, and
if there is a colon or a slash in the artist, album, or track name, they are
turned into underscore characters.</p>
<h2 id="Picasa">Picasa</h2> <h2 id="Picasa">Picasa</h2>
<p>If present, the user's Picasa library can also be accessed as a media <p>If present, the user's Picasa library can also be accessed as a media
gallery. Directories on the filesystem scanned by Picasa are presented under gallery. Directories on the filesystem scanned by Picasa are presented under
folders/. Picasa Albums are presented under albums/. Albums and Folders that folders/. Picasa Albums are presented under albums/.</p>
have duplicate names and dates will be uniquified using an incrementing <p>Albums and Folders that have duplicate names and dates will be uniquified
integer in parenthesis before the extension. Duplicate filenames within the using an incrementing integer in parenthesis before the extension.</p>
same Album will also be uniquified using an incrementing integer in parenthesis <p>Duplicate filenames within the same Album will also be uniquified using an
before the extension.</p> incrementing integer in parenthesis before the extension.</p>
<h2 id="iPhoto">iPhoto</h2>
<p>If present, the user's iPhoto library can be accessed as a media gallery.
The files are structured within a subdirectory called "Albums/". Within that
subdirectory, each album in the user's iPhoto library will appear as a
subdirectory by name, and contain file entries for the photos in that album.
</p>
<p>Duplicate album names or image filenames with albums will get a
disambiguating suffix like "(NN)" where NN is a unique number.</p>
<p>Any items appearing in multiple albums in iPhoto will appear in all those
albums in the gallery.</p>
<p>If the user has modified any images within an album, there will be an
additional subdirectory called "originals/" within the album directory, which
will then contain the original image, which will have the same filename as
the file in the album itself. The file as it appears in the album directory,
though, will be the one the user has invested time cropping, rotating, or
otherwise editing.</p>
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment