-
Notifications
You must be signed in to change notification settings - Fork 52
/
IMBAppleMediaParser.h
194 lines (125 loc) · 8.05 KB
/
IMBAppleMediaParser.h
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
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
/*
iMedia Browser Framework <http://karelia.com/imedia/>
Copyright (c) 2005-2012 by Karelia Software et al.
iMedia Browser is based on code originally developed by Jason Terhorst,
further developed for Sandvox by Greg Hulands, Dan Wood, and Terrence Talbot.
The new architecture for version 2.0 was developed by Peter Baumgartner.
Contributions have also been made by Matt Gough, Martin Wennerberg and others
as indicated in source files.
The iMedia Browser Framework is licensed under the following terms:
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in all or substantial portions of the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to permit
persons to whom the Software is furnished to do so, subject to the following
conditions:
Redistributions of source code must retain the original terms stated here,
including this list of conditions, the disclaimer noted below, and the
following copyright notice: Copyright (c) 2005-2012 by Karelia Software et al.
Redistributions in binary form must include, in an end-user-visible manner,
e.g., About window, Acknowledgments window, or similar, either a) the original
terms stated here, including this list of conditions, the disclaimer noted
below, and the aforementioned copyright notice, or b) the aforementioned
copyright notice and a link to karelia.com/imedia.
Neither the name of Karelia Software, nor Sandvox, nor the names of
contributors to iMedia Browser may be used to endorse or promote products
derived from the Software without prior and express written permission from
Karelia Software or individual contributors, as appropriate.
Disclaimer: THE SOFTWARE IS PROVIDED BY THE COPYRIGHT OWNER AND CONTRIBUTORS
"AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE,
AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF
CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH, THE
SOFTWARE OR THE USE OF, OR OTHER DEALINGS IN, THE SOFTWARE.
*/
// Author: Jörg Jacobsen
//----------------------------------------------------------------------------------------------------------------------
#pragma mark ABSTRACT
/*
This class provides parsing functionality that is common to some media data storages provided by Apple
(such as iPhoto and Aperture). Public property list files of iPhoto and Aperture share a lot of structure
(specifically regarding faces data) so you can utilize this intermediate class to share corresponding
functionality between iPhoto and Aperture parsers (and maybe other parsers to come).
ATTENTION: This is an abstract class. Do not use an instance of this class, but use a specific subclass
like IMBiPhotoParser or IMBApertureParser instead...
*/
//----------------------------------------------------------------------------------------------------------------------
#pragma mark HEADERS
#import <Cocoa/Cocoa.h>
#import "IMBParser.h"
#import "IMBSkimmableObjectViewController.h"
#import "IMBNodeObject.h"
//----------------------------------------------------------------------------------------------------------------------
#pragma mark CONSTANTS
// Provide different id spaces for events, faces and albums. Distinct ids must be guaranteed
// throughout the media tree in the outline view.
#define EVENTS_ID_SPACE @"EventId"
#define FACES_ID_SPACE @"FaceId"
#define ALBUMS_ID_SPACE @"AlbumId"
#define PHOTO_STREAM_ID_SPACE @"PhotoStreamId"
// Since we will add an events node to the list of iPhoto albums and a faces node to iPhoto and Aperture
// we have to create (sub-)ids for them that are unique throughout their library. The ones chosen below
// are very, very likely to be.
#define EVENTS_NODE_ID UINT_MAX-4811 // Very, very unlikely this not to be unique throughout library
#define FACES_NODE_ID UINT_MAX-4812 // Very, very unlikely this not to be unique throughout library
#define PHOTO_STREAM_NODE_ID UINT_MAX-4813 // Very, very unlikely this not to be unique throughout library
#define ALL_PHOTOS_NODE_ID UINT_MAX-4814 // Very, very unlikely this not to be unique throughout library
// node object types of interest for skimming
extern NSString* const kIMBiPhotoNodeObjectTypeEvent; // = @"events"
extern NSString* const kIMBiPhotoNodeObjectTypeFace; // = @"faces"
//----------------------------------------------------------------------------------------------------------------------
#pragma mark -
@interface IMBAppleMediaParser : IMBParser <IMBSkimmableObjectViewControllerDelegate>
{
NSDictionary* _plist;
NSDate* _modificationDate;
}
@property (retain, nonatomic) NSDictionary* plist;
@property (retain) NSDate* modificationDate;
// Returns IKImageBrowserCGImageRepresentationType
- (NSString*) requestedImageRepresentationType;
// Returns events id space (EVENTS_ID_SPACE) for album types "Event" and "Events".
// Returns faces id space (FACES_ID_SPACE) for album types "Face" and "Faces".
// Otherwise returns the albums id space (ALBUMS_ID_SPACE).
- (NSString*) idSpaceForAlbumType:(NSString*) inAlbumType;
// Returns an identifier built from the provided id and id space. An example is "IMBiPhotoParser://FaceId/17"...
- (NSString*) identifierForId:(NSNumber*) inId inSpace:(NSString*) inIdSpace;
// Returns the index of the all photos album ("Photos") in given album list
- (NSUInteger) indexOfAllPhotosAlbumInAlbumList:(NSArray*)inAlbumList;
// Returns the index of the projects album ("Projects") in given album list
// Projects are to Aperture what events are to iPhoto - hence the method name for coherence
- (NSUInteger) indexOfEventsAlbumInAlbumList:(NSArray*)inAlbumList;
// Returns the index of the flagged album ("Flagged") in given album list
- (NSUInteger) indexOfFlaggedAlbumInAlbumList:(NSArray*)inAlbumList;
// Returns whether inNode is the events node
- (BOOL) isEventsNode:(IMBNode*)inNode;
// Returns whether node provided is the faces node
- (BOOL) isFacesNode:(IMBNode*)inNode;
// Returns whether inNode is the Photo Stream node
- (BOOL) isPhotoStreamNode:(IMBNode*)inNode;
// Returns whether an album of this type exposes a disclosure triangle or not.
// Takes care of album Types "Folder", "Faces" and "Events".
// Subclass for more specific behavior.
- (BOOL) isLeafAlbumType:(NSString*)inType;
// The image location represents an image path to the image to be used for display inside of the browser (a preview of
// of the original image). By default we use the path to the image's thumbnail (key: "ThumbPath").
// Subclass for distinct behavior.
- (NSString*) imageLocationForObject:(NSDictionary*)inObjectDict;
// Returns the image location for the clipped face in the image represented by inImageKey in the master image list
// (aka dictionary)
- (NSString*) imagePathForFaceIndex:(NSNumber*)inFaceIndex inImageWithKey:(NSString*)inImageKey;
// Returns the image location for the image represented by inImageKey in the master image list (aka dictionary)
- (NSString*) imagePathForImageKey:(NSString*)inImageKey;
// Specific method for populating Faces nodes (in Aperture and iPhoto library)
- (void) populateFacesNode:(IMBNode*)inNode withFaces:(NSDictionary*)inFaces images:(NSDictionary*)inImages;
// Events and Faces have other metadata than images or movies
- (NSString*) countableMetadataDescriptionForMetadata:(NSDictionary*)inMetadata;
// Convert metadata into a human readable string...
- (NSString*) metadataDescriptionForMetadata:(NSDictionary*)inMetadata;
// Checks inKey whether it is a valid key in resource list and returns it if valid.
// If not checks all other candidates for validity and returns the first that is valid.
// If not returns nil.
- (NSString *)validatedResourceKey:(NSString *)inKey relativeToResourceList:(NSDictionary *)inResources otherCandidates:(NSArray *)inKeyList;
@end