|
1083
|
1 /**
|
|
|
2 digilib plugin for annotations.
|
|
|
3
|
|
1086
|
4 currently only point-like annotations (like marks).
|
|
|
5
|
|
|
6 Annotations are stored on a Annotator http://annotateit.org compatible server.
|
|
1083
|
7
|
|
|
8 */
|
|
|
9
|
|
|
10 (function($) {
|
|
|
11
|
|
|
12 // affine geometry
|
|
|
13 var geom;
|
|
|
14 // plugin object with digilib data
|
|
|
15 var digilib;
|
|
|
16
|
|
|
17 var FULL_AREA;
|
|
|
18
|
|
|
19 var buttons = {
|
|
|
20 annotations : {
|
|
|
21 onclick : "toggleAnnotations",
|
|
|
22 tooltip : "show or hide annotations",
|
|
|
23 icon : "annotations.png"
|
|
|
24 },
|
|
|
25 annotationmark : {
|
|
|
26 onclick : "setAnnotationMark",
|
|
|
27 tooltip : "create an annotation for a point",
|
|
|
28 icon : "annotation-mark.png"
|
|
|
29 }
|
|
|
30 };
|
|
|
31
|
|
|
32 var defaults = {
|
|
|
33 // are annotations active?
|
|
|
34 'isAnnotationsVisible' : true,
|
|
|
35 // buttonset of this plugin
|
|
|
36 'annotationSet' : ['annotations', 'annotationmark', 'lessoptions'],
|
|
|
37 // URL of annotation server
|
|
|
38 'annotationServerUrl' : 'http://virtuoso.mpiwg-berlin.mpg.de:8080/AnnotationManager/annotator',
|
|
|
39 // URL of authentication token server
|
|
|
40 'annotationTokenUrl' : 'http://localhost:8080/test/annotator/token?user=anonymous',
|
|
|
41 // annotation user name
|
|
|
42 'annotationUser' : 'anonymous'
|
|
|
43 };
|
|
|
44
|
|
|
45 var actions = {
|
|
|
46 /**
|
|
|
47 * show/hide annotations
|
|
|
48 */
|
|
|
49 toggleAnnotations : function(data) {
|
|
|
50 var show = !data.settings.isAnnotationsVisible;
|
|
|
51 data.settings.isAnnotationsVisible = show;
|
|
|
52 fn.highlightButtons(data, 'annotations', show);
|
|
|
53 renderAnnotations(data);
|
|
|
54 },
|
|
|
55
|
|
|
56 /**
|
|
|
57 * set a mark-annotation by clicking (or giving a position and a text)
|
|
|
58 *
|
|
|
59 * @param data
|
|
|
60 * @param mpos
|
|
|
61 * @param text
|
|
|
62 */
|
|
|
63 setAnnotationMark : function(data, mpos, text) {
|
|
|
64 if (mpos == null) {
|
|
|
65 // interactive
|
|
|
66 setAnnotationMark(data);
|
|
|
67 } else {
|
|
|
68 // use position and text
|
|
|
69 var annotation = newAnnotation(mpos, text);
|
|
|
70 storeAnnotation(data, annotation);
|
|
|
71 data.annotations.push(annotation);
|
|
|
72 digilib.fn.redisplay(data);
|
|
|
73 }
|
|
|
74 },
|
|
|
75 };
|
|
|
76
|
|
1086
|
77 /**
|
|
|
78 * create a new annotation object
|
|
|
79 */
|
|
1083
|
80 var newAnnotation = function(mpos, text, id, uri, user) {
|
|
|
81 var annot = {
|
|
|
82 pos : mpos,
|
|
|
83 text : text,
|
|
|
84 id : id,
|
|
|
85 uri : uri,
|
|
|
86 user : user
|
|
|
87 };
|
|
|
88 return annot;
|
|
|
89 };
|
|
|
90
|
|
|
91 /**
|
|
|
92 * returns an annotatable url to this digilib image
|
|
|
93 */
|
|
|
94 var getAnnotationPageUrl = function(data) {
|
|
|
95 var url = data.settings.digilibBaseUrl + '/jquery/digilib.html?';
|
|
|
96 url += digilib.fn.getParamString(data.settings, ['fn', 'pn'], digilib.defaults);
|
|
|
97 return url;
|
|
1086
|
98 };
|
|
|
99
|
|
1083
|
100 /**
|
|
|
101 * add a mark-annotation where clicked.
|
|
|
102 */
|
|
|
103 var setAnnotationMark = function(data) {
|
|
|
104 var $scaler = data.$scaler;
|
|
|
105 // unbind other handler TODO: do we need to do this?
|
|
|
106 $scaler.off(".dlZoomDrag");
|
|
|
107 // start event capturing
|
|
|
108 $scaler.one('mousedown.dlSetAnnotationMark', function(evt) {
|
|
|
109 // event handler adding a new mark
|
|
|
110 console.log("setAnnotationMark at=", evt);
|
|
|
111 var mpos = geom.position(evt);
|
|
|
112 var pos = data.imgTrafo.invtransform(mpos);
|
|
1086
|
113 // Annotation text entered in JS-prompt
|
|
1083
|
114 var text = window.prompt("Annotation text:");
|
|
|
115 if (text == null)
|
|
|
116 return false;
|
|
|
117 var annotation = newAnnotation(pos, text);
|
|
|
118 storeAnnotation(data, annotation);
|
|
|
119 data.annotations.push(annotation);
|
|
|
120 digilib.fn.redisplay(data);
|
|
|
121 return false;
|
|
|
122 });
|
|
|
123 };
|
|
|
124
|
|
|
125 /**
|
|
|
126 * place annotations on the image
|
|
|
127 */
|
|
|
128 var renderAnnotations = function(data) {
|
|
|
129 if (data.annotations == null || data.$img == null || data.imgTrafo == null)
|
|
|
130 return;
|
|
|
131 var cssPrefix = data.settings.cssPrefix;
|
|
|
132 var $elem = data.$elem;
|
|
|
133 var annotations = data.annotations;
|
|
|
134 console.debug("renderAnnotations: annotations=" + annotations);
|
|
|
135 // clear annotations
|
|
|
136 $elem.find('div.' + cssPrefix + 'annotationmark').remove();
|
|
|
137 for (var i = 0; i < annotations.length; i++) {
|
|
|
138 var annotation = annotations[i];
|
|
|
139 if (data.zoomArea.containsPosition(annotation.pos)) {
|
|
|
140 var mpos = data.imgTrafo.transform(annotation.pos);
|
|
|
141 console.debug("renderannotations: pos=", mpos);
|
|
|
142 // create annotation
|
|
|
143 var html = '<div class="' + cssPrefix + 'annotationmark ' + cssPrefix + 'overlay">' + (i + 1) + '</div>';
|
|
|
144 var $annotation = $(html);
|
|
|
145 // set text as tooltip TODO: have real popup with editing
|
|
|
146 $annotation.attr('title', "Annotation: " + annotation.text);
|
|
|
147 $elem.append($annotation);
|
|
|
148 mpos.adjustDiv($annotation);
|
|
|
149 }
|
|
|
150 }
|
|
|
151 };
|
|
|
152
|
|
1086
|
153 /**
|
|
|
154 * Get an authentication token from the token server.
|
|
|
155 *
|
|
|
156 * Stores the token and loads annotations on success.
|
|
|
157 */
|
|
1083
|
158 var loadAnnotationToken = function(data) {
|
|
|
159 var settings = data.settings;
|
|
|
160 var url = settings.annotationTokenUrl;
|
|
|
161 // TODO: better error handling
|
|
|
162 $.get(url, function(authToken, authStatus) {
|
|
|
163 console.debug("got auth token data=", authToken);
|
|
|
164 data.annotationToken = authToken;
|
|
|
165 loadAnnotations(data);
|
|
|
166 });
|
|
|
167 };
|
|
|
168
|
|
1086
|
169 /**
|
|
|
170 * loads all annotations for this url from the annotation server.
|
|
|
171 */
|
|
1083
|
172 var loadAnnotations = function(data) {
|
|
|
173 var settings = data.settings;
|
|
1086
|
174 // we use the search API
|
|
1083
|
175 var url = settings.annotationServerUrl + '/search';
|
|
1084
|
176 var pageUrl = getAnnotationPageUrl(data);
|
|
1083
|
177 // send authentication token in header
|
|
|
178 headers = {
|
|
|
179 'x-annotator-auth-token' : data.annotationToken
|
|
|
180 };
|
|
1086
|
181 // get only 20 annotations with this url
|
|
1083
|
182 var query = {
|
|
|
183 limit : 20,
|
|
|
184 uri : pageUrl
|
|
|
185 };
|
|
|
186 $.ajax(url, {
|
|
|
187 dataType : 'json',
|
|
|
188 data : query,
|
|
|
189 headers : headers,
|
|
|
190 success : function(annotData, annotStatus) {
|
|
|
191 console.debug("got annotation data=", annotData);
|
|
|
192 data.annotationData = annotData;
|
|
|
193 parseAnnotations(data, annotData);
|
|
|
194 renderAnnotations(data);
|
|
|
195 }
|
|
|
196 });
|
|
|
197 };
|
|
|
198
|
|
1086
|
199 /**
|
|
|
200 * parse all JSON-annotations in annotationData.rows and put in data.annotations
|
|
|
201 */
|
|
1083
|
202 var parseAnnotations = function(data, annotationData) {
|
|
|
203 var annotations = [];
|
|
|
204 for (var i = 0; i < annotationData.rows.length; ++i) {
|
|
|
205 var ann = annotationData.rows[i];
|
|
|
206 var annot = parseAnnotation(ann)
|
|
|
207 if (annot != null) {
|
|
|
208 annotations.push(annot);
|
|
|
209 }
|
|
|
210 }
|
|
|
211 data.annotations = annotations;
|
|
|
212 };
|
|
|
213
|
|
1086
|
214 /**
|
|
|
215 * Parse a JSON-annotation.
|
|
|
216 *
|
|
|
217 * Returns an annotation object.
|
|
|
218 */
|
|
1083
|
219 var parseAnnotation = function(ann) {
|
|
|
220 // TODO: check validity of annotation data
|
|
1084
|
221 if (ann.areas != null && ann.areas.length > 0) {
|
|
|
222 var area = ann.areas[0];
|
|
1086
|
223 // currently only point annotations
|
|
1084
|
224 var pos = geom.position(area.x, area.y);
|
|
1083
|
225 return newAnnotation(pos, ann.text, ann.id, ann.uri, ann.user);
|
|
|
226 }
|
|
|
227 return null;
|
|
|
228 };
|
|
|
229
|
|
1086
|
230 /**
|
|
|
231 * Store an annotation on the annotation server.
|
|
|
232 */
|
|
1083
|
233 var storeAnnotation = function(data, annotation) {
|
|
|
234 console.debug("storeAnnotation:", annotation);
|
|
|
235 var settings = data.settings;
|
|
|
236 var url = settings.annotationServerUrl + '/annotations';
|
|
|
237 var pageUrl = getAnnotationPageUrl(data);
|
|
|
238 // send authentication token in header
|
|
|
239 headers = {
|
|
|
240 'x-annotator-auth-token' : data.annotationToken
|
|
|
241 };
|
|
|
242 // create annotation object to send
|
|
|
243 var annotData = {
|
|
1084
|
244 areas : [{
|
|
|
245 x : annotation.pos.x,
|
|
|
246 y : annotation.pos.y
|
|
|
247 }],
|
|
1083
|
248 text : annotation.text,
|
|
|
249 uri : pageUrl,
|
|
|
250 user : settings.annotationUser
|
|
|
251 };
|
|
|
252 var dataString = JSON.stringify(annotData);
|
|
|
253 $.ajax(url, {
|
|
|
254 type : 'POST',
|
|
|
255 dataType : 'json',
|
|
|
256 contentType : 'application/json',
|
|
|
257 data : dataString,
|
|
|
258 headers : headers,
|
|
|
259 success : function(annotData, annotStatus) {
|
|
1084
|
260 console.debug("sent annotation data, got=", annotData, " status=" + annotStatus);
|
|
1083
|
261 var annot = parseAnnotation(annotData);
|
|
|
262 // TODO: we have to add the returned data to the real annotation!
|
|
|
263 //renderAnnotations(data);
|
|
|
264 }
|
|
|
265 });
|
|
|
266
|
|
1086
|
267 };
|
|
|
268
|
|
|
269 /**
|
|
|
270 * install additional buttons
|
|
|
271 */
|
|
1083
|
272 var installButtons = function(data) {
|
|
|
273 var settings = data.settings;
|
|
|
274 var mode = settings.interactionMode;
|
|
|
275 var buttonSettings = settings.buttonSettings[mode];
|
|
|
276 // configure buttons through digilib "annotationSet" option
|
|
|
277 var buttonSet = settings.annotationSet || annotationSet;
|
|
|
278 // set annotationSet to [] or '' for no buttons (when showing annotations only)
|
|
|
279 if (buttonSet.length && buttonSet.length > 0) {
|
|
|
280 buttonSettings.annotationSet = buttonSet;
|
|
|
281 buttonSettings.buttonSets.push('annotationSet');
|
|
|
282 }
|
|
|
283 };
|
|
|
284
|
|
1086
|
285 /**
|
|
|
286 * plugin installation. called by digilib on plugin object.
|
|
|
287 */
|
|
1083
|
288 var install = function(plugin) {
|
|
|
289 digilib = plugin;
|
|
|
290 console.debug('installing annotations plugin. digilib:', digilib);
|
|
|
291 // import geometry classes
|
|
|
292 geom = digilib.fn.geometry;
|
|
|
293 FULL_AREA = geom.rectangle(0, 0, 1, 1);
|
|
|
294 // add defaults, actins, buttons
|
|
|
295 $.extend(digilib.defaults, defaults);
|
|
|
296 $.extend(digilib.actions, actions);
|
|
|
297 $.extend(digilib.buttons, buttons);
|
|
|
298 };
|
|
|
299
|
|
|
300 /** plugin initialization */
|
|
|
301 var init = function(data) {
|
|
|
302 console.debug('initialising annotations plugin. data:', data);
|
|
|
303 var $data = $(data);
|
|
|
304 // set up
|
|
|
305 data.annotations = [];
|
|
|
306 if (digilib.plugins.buttons != null) {
|
|
|
307 installButtons(data);
|
|
|
308 }
|
|
|
309 // install event handler
|
|
|
310 $data.bind('setup', handleSetup);
|
|
|
311 $data.bind('update', handleUpdate);
|
|
|
312 };
|
|
|
313
|
|
1086
|
314 /**
|
|
|
315 * setup loads all annotations.
|
|
|
316 */
|
|
1083
|
317 var handleSetup = function(evt) {
|
|
|
318 console.debug("annotations: handleSetup");
|
|
|
319 var data = this;
|
|
|
320 // load annotations from server
|
|
|
321 loadAnnotationToken(data);
|
|
|
322 };
|
|
|
323
|
|
1086
|
324 /**
|
|
|
325 * update renders all annotations.
|
|
|
326 */
|
|
1083
|
327 var handleUpdate = function(evt) {
|
|
|
328 console.debug("annotations: handleUpdate");
|
|
|
329 var data = this;
|
|
|
330 if (data.marks != null) {
|
|
|
331 renderAnnotations(data);
|
|
|
332 }
|
|
|
333 };
|
|
|
334
|
|
|
335 // plugin object with name and init
|
|
|
336 // shared objects filled by digilib on registration
|
|
|
337 var plugin = {
|
|
|
338 name : 'annotations',
|
|
|
339 install : install,
|
|
|
340 init : init,
|
|
|
341 buttons : {},
|
|
|
342 actions : {},
|
|
|
343 fn : {},
|
|
|
344 plugins : {}
|
|
|
345 };
|
|
|
346
|
|
|
347 if ($.fn.digilib == null) {
|
|
|
348 $.error("jquery.digilib.annotations must be loaded after jquery.digilib!");
|
|
|
349 } else {
|
|
|
350 $.fn.digilib('plugin', plugin);
|
|
|
351 }
|
|
|
352 })(jQuery);
|
