support for F-Spot photo versioning, refs #67
[phpfspot.git] / phpfspot.js
1 /***************************************************************************
2  *
3  * phpfspot, presents your F-Spot photo collection in Web browsers.
4  *
5  * Copyright (c) by Andreas Unterkircher
6  *
7  *  This program is free software; you can redistribute it and/or modify
8  *  it under the terms of the GNU General Public License as published by
9  *  the Free Software Foundation; either version 2 of the License, or
10  *  any later version.
11  *
12  *  This program is distributed in the hope that it will be useful,
13  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
14  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  *  GNU General Public License for more details.
16  *
17  *  You should have received a copy of the GNU General Public License
18  *  along with this program; if not, write to the Free Software
19  *  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
20  *
21  ***************************************************************************/
22
23 /**
24  * show photo
25  *
26  * this function will be called by client and fetches
27  * the single-photo view via AJAX from the server.
28  * Furthermore it will scrollup the browser to the top
29  * position so the image become visibile immediatley.
30  */
31 function showPhoto(id, scrollup)
32 {
33    /* is phpfspot skeleton really displayed? */
34    if(!document.getElementById('content'))
35       return;
36
37    var content = document.getElementById('content');
38
39    /* blank the screen */
40    if(scrollup != undefined) {
41       content.innerHTML = "";
42    }
43
44    /* fetch single-photo view from server */
45    HTML_AJAX.replace(content, encodeURI(web_path + '/rpc.php?action=showphoto&id=' + id));
46
47    /* scroll the window up to the top */
48    if(scrollup != undefined) {
49       window.scrollTo(0,0);
50    }
51
52    /* delete some global vars */
53    delete(origHeight); origHeight = undefined;
54    delete(origWidth); origWidth = undefined;
55    delete(photo_details_pos); photo_details_pos = undefined;
56
57 } // showPhoto()
58
59 /**
60  * scroll browser to the last shown photo
61  *
62  * this function will be called when user returns from single-photo
63  * to the photo index. It will scroll down the window (if possible)
64  * to the position of the last shown photo.
65  */
66 function moveToThumb(thumb_id)
67 {
68    if(thumb_id == undefined)
69       return;
70
71    if(thumbimg = document.getElementById('thumbimg' + thumb_id)) {
72       window.scrollTo(0, findPos(thumbimg,'top')-100);
73    }
74
75 } // moveToThumb()
76
77 /**
78  * return position of object
79  *
80  * this function returns the position of an object.
81  * depending on the parameter 'direction' it will either
82  * return the X or Y position.
83  */
84 function findPos(obj, direction) {
85    var cur = 0;
86    if (obj.offsetParent) {
87       do {
88          if(direction == 'left')
89             cur += obj.offsetLeft;
90          if(direction == 'top')
91             cur += obj.offsetTop;
92       } while (obj = obj.offsetParent);
93    }
94    return [cur];
95
96 } // findPos()
97
98 /**
99  * opens the credits page
100  */
101 function showCredits()
102 {
103    var credits = document.getElementById("content");
104    credits.innerHTML = HTML_AJAX.grab(encodeURI(web_path + '/rpc.php?action=showcredits'));
105
106 } // showCredits()
107
108 /**
109  * tag-selection handling
110  *
111  * this function is getting called by client to either
112  * - add
113  ∗ - delete
114  * - modify tag-match condition
115  *
116  * It will then fetch the result from the server via AJAX
117  * and updates the tag-selection.
118  */
119 function Tags(mode, id)
120 {
121    var objTemp = new Object();
122
123    if(mode == "add") {
124       // add tag to users session
125       objTemp['action'] = 'addtag';
126       objTemp['id'] = id;
127    }
128    else if(mode == "del") {
129       // del tag from users session
130       objTemp['action'] = 'deltag';
131       objTemp['id'] = id;
132    }
133    else if(mode == "condition") {
134       setCheckedValue(id, id.value);
135       objTemp['action'] = 'tagcondition';
136       objTemp['mode'] = id.value;
137    }
138
139    var retr = HTML_AJAX.post(web_path + '/rpc.php', objTemp);
140    if(retr == "ok") {
141       refreshAvailableTags();
142       refreshSelectedTags();
143       refreshPhotoIndex();
144    }
145    else {
146       window.alert("Server message: "+ retr);
147    }
148
149 } // Tags()
150
151 /**
152  * update available-tags tag-cloud
153  *
154  * this function queries an actual version of the tag-cloud
155  * for the available (not-selected) tags from the server via
156  * AJAX.
157  */
158 function refreshAvailableTags()
159 {
160    // update available tags
161    var avail_tags = document.getElementById('available_tags');
162    if(avail_tags != undefined) {
163       avail_tags.innerHTML = "Loading...";
164       avail_tags.innerHTML = HTML_AJAX.grab(encodeURI(web_path + '/rpc.php?action=show_available_tags'));
165    }
166
167 } // refreshAvailableTags()
168
169 /**
170  * update selected-tags list
171  *
172  * this function queries an actual version of the tag-list
173  * for the selected tags from the server via AJAX.
174  */
175 function refreshSelectedTags()
176 {
177    // update selected tags
178    var selected_tags = document.getElementById("selected_tags");
179    if(selected_tags != undefined) {
180       selected_tags.innerHTML = "Loading...";
181       selected_tags.innerHTML = HTML_AJAX.grab(encodeURI(web_path + '/rpc.php?action=show_selected_tags'));
182    }
183
184 } // refreshSelectedTags()
185
186 /**
187  * show photo index
188  *
189  * this function will fetch the photo-index view from
190  * the server via AJAX. It's also used to browse through
191  * the photo-index pages
192  */
193 function showPhotoIndex(begin_with, last_photo)
194 {
195    var url = web_path + "/rpc.php?action=show_photo_index";
196    if(begin_with != undefined)
197       url = url + '&begin_with=' + begin_with;
198    if(last_photo != undefined)
199       url = url + '&last_photo=' + last_photo;
200
201    HTML_AJAX.replace(document.getElementById("content"), encodeURI(url));
202
203 } // showPhotoIndex()
204
205 /**
206  * update photo index
207  *
208  * this function will be called, to request a refresh of the
209  * photo index. this, for example, can be caused, when changing
210  * the tag-selection.
211  */
212 function refreshPhotoIndex()
213 {
214    /* only invoke showPhotoIndex(), if photo-index is really shown */
215    if(document.getElementById("index") != undefined || startup == 1) {
216       showPhotoIndex();
217       startup = 0;
218    }
219
220 } // refreshPhotoIndex()
221
222 /**
223  * blur cursor focus
224  *
225  * this function removes the focus-rectangle which may appear
226  * when click on a link. Not always beautiful.
227  */
228 function click(object)
229 {
230    if(object.blur)
231       object.blur();
232
233 } // click()
234
235 /**
236  * change current radio-button setting
237  *
238  * This function will check the radio-button with the given value.
239  * If no radio-button is currently displayed, this function will do
240  * nothing.
241  * If the given value does not exist, the existing radio buttons will
242  * be reseted.
243  */
244 function setCheckedValue(condition, value) {
245
246    var count = condition.length;
247    if(count == undefined) {
248       condition.checked = (condition.value == value.toString());
249       return;
250    }
251    for(var i = 0; i < count; i++) {
252       condition[i].checked = false;
253       if(condition[i].value == value.toString()) {
254          condition[i].checked = true;
255       }
256    }
257
258 } // setCheckedValue()
259
260 /**
261  * Invoke a search
262  *
263  * This function will be invoked by starting
264  * any kind of search (tag-name, photo-name, date, ...).
265  */
266 function startSearch()
267 {
268    if(document.getElementById('date_from').value != undefined) {
269       date_from = document.getElementById('date_from').value;
270    }
271    if(document.getElementById('date_to').value != undefined) {
272       date_to = document.getElementById('date_to').value;
273    }
274       
275    var objTemp = new Object();
276    objTemp['action'] = 'search';
277
278    if(document.getElementsByName('searchfor_tag')[0] != undefined &&
279       document.getElementsByName('searchfor_tag')[0].value != "") {
280       objTemp['for_tag'] = document.getElementsByName('searchfor_tag')[0].value;
281    }
282    if(document.getElementsByName('searchfor_name')[0] != undefined &&
283       document.getElementsByName('searchfor_name')[0].value != "") {
284       objTemp['for_name'] = document.getElementsByName('searchfor_name')[0].value;
285    }
286    if(document.getElementsByName('consider_date')[0] != undefined &&
287       document.getElementsByName('consider_date')[0].checked == true) {
288       objTemp['date_from'] = date_from;
289       objTemp['date_to'] = date_to;
290    }
291    if(document.getElementsByName('consider_rate')[0] != undefined &&
292       document.getElementsByName('consider_rate')[0].checked == true) {
293       objTemp['rate_from'] = rate_search['from'];
294       objTemp['rate_to'] = rate_search['to'];
295    }
296
297    var retr = HTML_AJAX.post(web_path + '/rpc.php', objTemp);
298    if(retr == "ok") {
299       refreshAvailableTags();
300       refreshSelectedTags();
301       showPhotoIndex();
302    }
303    else {
304       window.alert("Server message: "+ retr);
305    }
306
307 } // startSearch()
308
309 /**
310  * enable/disable date search
311  *
312  * this function will either enable or disable the
313  * input fields for the date-search
314  */
315 function datesearch()
316 {
317    var mode = true;
318
319    if(document.getElementsByName('consider_date')[0].checked == true) {
320       mode = false;
321    }
322       
323    document.getElementById('date_from').disabled = mode;
324    document.getElementById('date_to').disabled = mode;
325  
326 } // datesearch()
327
328 /**
329  * set view mode
330  *
331  * called for photo-index export. will return the
332  * selected mode via AJAX from the server.
333  */
334 function setViewMode(srv_webpath, mode)
335 {
336    if(srv_webpath != undefined)
337       web_path = srv_webpath;
338    else
339       web_path = '';
340
341    var exprt = document.getElementById('output');
342    exprt.innerHTML = "Loading...";
343    exprt.innerHTML = HTML_AJAX.grab(encodeURI(web_path + '/rpc.php?action=get_export&mode=' + mode));
344
345 } // setViewMode()
346
347 /**
348  * reset all search-fields
349  */
350 function clearSearch()
351 {
352    if(document.getElementsByName('searchfor_tag')[0] != undefined)
353       document.getElementsByName('searchfor_tag')[0].value = '';
354    if(document.getElementsByName('searchfor_name')[0] != undefined)
355       document.getElementsByName('searchfor_name')[0].value = '';
356
357    if(document.getElementsByName('consider_date')[0] != undefined &&
358       document.getElementsByName('consider_date')[0].checked == true) {
359       document.getElementsByName('consider_date')[0].checked = false;
360       datesearch();
361    }
362    if(document.getElementsByName('consider_rate')[0] != undefined &&
363       document.getElementsByName('consider_rate')[0].checked == true) {
364       document.getElementsByName('consider_rate')[0].checked = false;
365    }
366
367 } // clearSearch()
368
369 /**
370  * if the client is planless, ask the server what to do
371  * next.
372  */
373 function AskServerWhatToDo()
374 {
375    return HTML_AJAX.grab(encodeURI(web_path + '/rpc.php?action=what_to_do'));
376
377 } // AskServerWhatToDo()
378
379 /**
380  * init phpfspot
381  *
382  * this function will be called when the browser opens phpfspot
383  * the first time. It will fetch the tag-lists and will then
384  * switch to the right view, which the browser got told from
385  * the server (maybe someone hit the refresh button...).
386  *
387  * as parameter the server can set the correct webpath.
388  * espacialley when using user-friendly url's, the browser
389  * does not know the correct URLs to address images, stylesheets,
390  * ... then.
391  */
392 function init_phpfspot(srv_webpath)
393 {
394    if(srv_webpath != undefined)
395       web_path = srv_webpath;
396    else
397       web_path = '';
398
399    /* always load list of available tags */
400    //this should not be more necessary since 4.5.08
401    //refreshAvailableTags();
402
403    /* ask the server what we are currently displaying */
404    whattodo = AskServerWhatToDo();
405
406    if(whattodo == 'showpi' || whattodo == 'showpi_date') {
407       showPhotoIndex();
408    }
409    if(whattodo == 'showpi_tags') {
410       refreshSelectedTags();
411       showPhotoIndex();
412    }
413    if(whattodo == 'show_photo') {
414       if(photo = getPhotoToShow()) {
415          showPhoto(photo);
416          refreshSelectedTags();
417       }
418    }
419
420 } // init_phpfspot()
421
422 /**
423  * change background-color on mouse-over
424  */
425 function setBackGrdColor(item, color)
426 {
427    if(color == 'mouseover')
428       item.style.backgroundColor='#c6e9ff';
429    if(color == 'mouseout')
430       item.style.backgroundColor='#eeeeee';
431    if(color == 'mouseclick')
432       item.style.backgroundColor='#93A8CA';
433
434 } // setBackGrdColor()
435
436 /**
437  * ask server, which photo needs to be shown
438  *
439  * when user press the refresh-button in a single-photo
440  * view or maybe enters the link via an external URL, the
441  * client does not know, what photo will be shown (dimensions...).
442  * But the server can tell this the browser.
443  */
444 function getPhotoToShow()
445 {
446    var photo_to_show = HTML_AJAX.grab(encodeURI(web_path + '/rpc.php?action=get_photo_to_show'));
447
448    // if no image needs to be shown, return false from here
449    if(photo_to_show == "")
450       return false;
451    
452    return photo_to_show;
453
454 } // getPhotoToShow()
455
456 /**
457  * a fake-zoom for photo
458  *
459  * a quick to let the browser do some zooming on
460  * photos.
461  */
462 function zoom(mod)
463 {
464    var photo;
465
466    if(mod == undefined)
467       return;
468
469    /* internet explorer */
470    if(document.images['photo'].width)
471       photo = document.images['photo'];
472
473    /* all others */
474    if(photo == undefined && document.getElementById('photo').width)
475       photo = document.getElementById('photo');
476
477    if(photo != undefined) {
478
479       if(origWidth == undefined)
480          origWidth = photo.width;
481       if(origHeight == undefined)
482          origHeight = photo.height;
483
484       if(mod != 0) {
485          new_w = photo.width * (1 + mod/100);
486          new_h = photo.height * (1 + mod/100);
487          photo.width = new_w;
488          photo.height = new_h;
489
490          if(photo_details_pos == undefined) {
491             photo_details_pos = findPos(document.getElementById('photo_details'),'left');
492          }
493
494          if((photo.offsetLeft + new_w) >= photo_details_pos-20) {
495             hidePhotoDetails('true');
496          }
497          else {
498             hidePhotoDetails('false');
499          }
500       }
501       else {
502          photo.width = origWidth;
503          photo.height = origHeight;
504          hidePhotoDetails('false');
505       }
506    }
507
508 } // zoom()
509
510 /**
511  * hides the photo details layin
512  *
513  * if the photo is getting zoomed quiet large, this will
514  * auto-hide (and also restore) the photo-details-box.
515  */
516 function hidePhotoDetails(mode)
517 {
518    var photo_details;
519
520    if(photo_details = document.getElementById('photo_details')) {
521       if(mode == 'true') {
522          photo_details.style.visibility = 'hidden';
523          photo_details.style.display = 'none';
524       }
525       else {
526          photo_details.style.visibility = 'visible';
527          photo_details.style.display = '';
528       }
529    }
530 } // hidePhotoDetails()
531
532 /**
533  * show calendar
534  */
535 function showCalendar(date_box, click_obj)
536 {
537    var calendar = document.getElementById('calendar');
538    var year = document.getElementById(date_box+'year').value;
539    var month = document.getElementById(date_box+'month').value;
540    if(date_box == 'from') {
541       var xpos = document.getElementById('frompic').offsetLeft;
542       var ypos = document.getElementById('frompic').offsetTop;
543       calendar_mode = 'from';
544    }
545    if(date_box == 'to') {
546       var xpos = document.getElementById('topic').offsetLeft;
547       var ypos = document.getElementById('topic').offsetTop;
548       calendar_mode = 'to';
549    }
550    calendar.style.left = xpos + 100 + 'px';
551    calendar.style.top = ypos + 80 + 'px';
552
553    if(calendar.style.visibility == "" || calendar.style.visibility == 'hidden') {
554       calendar.style.visibility = 'visible';
555       calendar.innerHTML = "Loading...";
556       calendar.innerHTML = HTML_AJAX.grab(encodeURI(web_path +'/rpc.php?action=get_calendar_matrix&year=' + year + '&month=' + month));
557       calendar_shown = 1;
558    }
559    else {
560       hideCalendar();
561    }
562
563 } // showCalendar()
564
565 /**
566  * hide calendar
567  */
568 function hideCalendar()
569 {
570    var calendar = document.getElementById('calendar');
571    if(calendar.style.visibility != 'hidden') {
572       calendar.style.visibility = 'hidden';
573       calendar_shown = 0;
574    }
575 } // hideCalendar()
576
577 /**
578  * switch month in calendar
579  */
580 function setMonth(year, month, day)
581 {
582    var calendar = document.getElementById('calendar');
583    calendar.innerHTML = "Loading...";
584    calendar.innerHTML = HTML_AJAX.grab(encodeURI(web_path + '/rpc.php?action=get_calendar_matrix&year='+ year +'&month='+ month +'&day='+ day));
585 }
586
587 /**
588  * get the user-selected date from the calendar and
589  * put it into the date-search boxes
590  */
591 function setCalendarDate(year, month, day)
592 {
593    document.getElementById(calendar_mode+'year').value = year;
594    document.getElementById(calendar_mode+'month').value = month;
595    document.getElementById(calendar_mode+'day').value = day;
596    hideCalendar();
597
598 } // setCalendarDate()
599
600 /**
601  * reset phpfspot complelely and move to the begining
602  */
603 function resetAll()
604 {
605    HTML_AJAX.grab(encodeURI(web_path + '/rpc.php?action=reset'));
606    clearSearch();
607    refreshAvailableTags();
608    refreshSelectedTags();
609    refreshPhotoIndex();
610
611 } // resetAll()
612
613 /**
614  * find objects with their class-name
615  */
616 function WSR_getElementsByClassName(oElm, strTagName, oClassNames){
617    var arrElements = (strTagName == "*" && oElm.all)? oElm.all : oElm.getElementsByTagName(strTagName);
618    var arrReturnElements = new Array();
619    var arrRegExpClassNames = new Array();
620    if(typeof oClassNames == "object"){
621       for(var i=0; i<oClassNames.length; i++){
622          arrRegExpClassNames.push(new RegExp("(^|\s)" + oClassNames[i].replace(/-/g, "\-") + "(\s|$)"));
623       }
624    }
625    else{
626       arrRegExpClassNames.push(new RegExp("(^|\s)" + oClassNames.replace(/-/g, "\-") + "(\s|$)"));
627    }
628    var oElement;
629    var bMatchesAll;
630    for(var j=0; j<arrElements.length; j++){
631       oElement = arrElements[j];
632       bMatchesAll = true;
633       for(var k=0; k<arrRegExpClassNames.length; k++){
634          if(!arrRegExpClassNames[k].test(oElement.className)){
635             bMatchesAll = false;
636             break;
637          }
638       }
639       if(bMatchesAll){
640          arrReturnElements.push(oElement);
641       }
642    }
643    return (arrReturnElements)
644
645 } // WSR_getElementsByClassName()
646
647 /**
648  * javascript based photo preloading
649  */
650 function preloadPhotos(image_url) {
651
652    var i;
653    var timeout = 1000;
654    var waiting = 100;
655    var counting;
656
657    lbImg = WSR_getElementsByClassName(document,"img","thumb");
658    if(lbImg != undefined) {
659       for(i=0;i<lbImg.length;i++){
660          lbImg[i].src=image_url[i];
661          // to not bomb the server with requests, give the page some time
662          // to load the images one by one. if a image exceeds the timeout,
663          // the next image will be loaded.
664          if(lbImg[i].complete != undefined && lbImg[i].complete != true) {
665             counting = 0;
666             while(lbImg[i].complete != true && counting < timeout) {
667                window.setTimeout("noop()", waiting);
668                counting+=waiting;
669             }
670          }
671       }
672    }
673
674 } // preloadPhotos()
675
676 /* a function that does nothing */
677 function noop() {}
678
679 /**
680  * start slideshow
681  */
682 function startSlideShow(srv_webpath)
683 {
684    if(srv_webpath != undefined)
685       web_path = srv_webpath;
686    else
687       web_path = '';
688
689    if(!sliding) {
690       HTML_AJAX.grab(encodeURI(web_path + '/rpc.php?action=reset_slideshow'));
691       nextSlide();
692       sliding = setInterval("nextSlide()", sliding_time*1000);
693       document.getElementById('stop_ico').src = web_path + "/resources/32_stop.png";
694    }
695    else {
696       clearInterval(sliding);
697       sliding = 0;
698       document.getElementById('stop_ico').src = web_path + "/resources/32_play.png";
699    }
700
701 } // startSlideShow()
702
703 /**
704  * switch to next slide
705  */
706 function nextSlide()
707 {
708    var next_img = HTML_AJAX.grab(encodeURI(web_path + '/rpc.php?action=get_next_slideshow_img'));
709    document.getElementById('slide_img').src = next_img;
710
711 } // nextSlide()
712
713 /**
714  * switch to previous slide
715  */
716 function prevSlide()
717 {
718    var prev_img = HTML_AJAX.grab(encodeURI(web_path + '/rpc.php?action=get_prev_slideshow_img'));
719    document.getElementById('slide_img').src = prev_img;
720
721 } // prevSlide()
722
723 /**
724  * interrupt slide show
725  */
726 function pauseSlideShow()
727 {
728    if(!sliding_paused) {
729       sliding_paused = 1;
730       clearInterval(sliding);
731       document.getElementById('pause_ico').src = web_path + "/resources/32_play.png";
732    }
733    else {
734       sliding_paused = 0;
735       sliding = setInterval("nextSlide()", sliding_time*1000);
736       document.getElementById('pause_ico').src = web_path + "/resources/32_pause.png";
737    }
738
739 } // pauseSlideShow()
740
741 /**
742  * start auto-browse
743  */
744 function startAutoBrowse()
745 {
746    if(!autobrowse) {
747       autoBrowse();
748       autobrowse = setInterval("autoBrowse()", 5000);
749    }
750    else {
751       clearInterval(autobrowse);
752       autobrowse = 0;
753       document.getElementById('autobrowse_ico').src = web_path + "/resources/16_play.png";
754    }
755
756 } // startAutoBrowser()
757
758 /**
759  * auto-browsing
760  */
761 function autoBrowse()
762 {
763    if(document.getElementById('next_link')) {
764       var next_link = document.getElementById('next_link').href;
765       window.location.href = next_link;
766       document.getElementById('autobrowse_ico').src = web_path + "/resources/16_pause.png";
767    }
768    /* we have reached the last photo */
769    else {
770       if(ab_ico = document.getElementById('autobrowse_ico'))
771          ab_ico.src = web_path + "/resources/16_play.png";
772       clearInterval(autobrowse);
773    }
774
775 } // autoBrowse()
776
777 /**
778  * initiate slider to modify slide-switching-speed
779  */
780 function initSlider()
781 {
782    var sliderEl = document.getElementById ? document.getElementById("slider-1") : null;
783    var inputEl = document.forms[0]["slider-input-1"];
784    var s = new Slider(sliderEl, inputEl);
785    s.setMinimum(1);
786    s.setMaximum(10);
787    s.setValue(sliding_time);
788    document.getElementById("current_slide_time").innerHTML = sliding_time + "s Interval";
789    s.onchange = function () {
790       sliding_time = s.getValue();
791       document.getElementById("current_slide_time").innerHTML = sliding_time + "s Interval";
792       if(!sliding_paused && sliding) {
793          clearInterval(sliding);
794          sliding = setInterval("nextSlide()", sliding_time*1000);
795       }
796    };
797    window.onresize = function () {
798       s.recalculate();
799    };
800
801 } // initSlider()
802
803 /**
804  * if the sort-order (photo-name, date, ...) has been
805  * changed, update the photo-index view.
806  */
807 function update_sort_order(obj)
808 {  
809    var objTemp = new Object();
810    objTemp['value'] = obj.options[obj.selectedIndex].value;
811
812    var retr = HTML_AJAX.post(web_path + '/rpc.php?action=update_sort_order', objTemp);
813
814    if(retr == "ok") {
815       showPhotoIndex();
816    }
817    else {
818       window.alert("Server message: "+ retr);
819    }
820
821 } // update_sort_order()
822
823 /**
824  * if the photo-version ѕelect-box has changed, set the newly
825  * choosen photo version as the to-be-displayed photo version
826  */
827 function update_photo_version(obj, current_photo)
828 {
829    var objTemp = new Object();
830    objTemp['photo_version'] = obj.options[obj.selectedIndex].value;
831    objTemp['photo_idx'] = current_photo;
832
833    var retr = HTML_AJAX.post(web_path + '/rpc.php?action=update_photo_version', objTemp);
834
835    if(retr == "ok") {
836       showPhoto(current_photo);
837    }
838    else {
839       window.alert("Server message: "+ retr);
840    }
841
842 } // update_photo_version()
843
844 /**
845  * show rate stars
846  *
847  * this function will show the requested amount of
848  * rate-stars.
849  *
850  * @param string mode
851  * @param int level
852  */
853 function show_rate(mode, level)
854 {
855    var i;
856
857    for(i = 1; i <= 5; i++) {
858       if(i <= level) {
859          document.getElementById('rate_' + mode + '_' + i).src = web_path + '/resources/star.png';
860       }
861       else {
862          document.getElementById('rate_' + mode + '_' + i).src = web_path + '/resources/empty_rate.png';
863       }
864    }
865
866 } // show_rate()
867
868 /**
869  * set rate stars
870  *
871  *
872  * this function will set the requested rate-stars-amount into a global
873  * variable (which will then later be used on form-submit) and will also
874  * update the display.
875  *
876  * @param string mode
877  * @param int level
878  */
879 function set_rate(mode, level)
880 {
881    rate_search[mode] = level;
882    show_rate(mode, level);
883
884 } // set_rate()
885
886 /**
887  * reset rate stars
888  *
889  * this function will reset the rate-star to their initial value.
890  *
891  * @param string mode
892  */
893 function reset_rate(mode)
894 {
895    if(rate_search[mode] == undefined)
896       rate_search[mode] = 0;
897
898    show_rate(mode, rate_search[mode]);
899
900 } // reset_rate()
901
902 /**
903  * handle key events
904  */
905 function keyDown(e) {
906    var evt = (e) ? e:(window.event) ? window.event:null;
907
908    if(evt) {
909       var key = (evt.charCode) ? evt.charCode :
910          ((evt.keyCode) ? evt.keyCode : ((evt.which) ? evt.which : 0));
911
912
913       if(key == 37) /* left curosr */ {
914          if(document.getElementById('prev_link')) {
915             var prev_link = document.getElementById('prev_link').href;
916             window.location.href = prev_link;
917          }
918          return;
919       }
920       if(key == 38) /* up cursor */ {
921       }
922       if(key == 39) /* right curosr */ {
923          if(document.getElementById('next_link')) {
924             var next_link = document.getElementById('next_link').href;
925             window.location.href = next_link;
926          }
927          return;
928       }
929       if(key == 73 && evt.altKey && evt.ctrlKey) /* ctrl+alt+i */ {
930          showPhotoIndex();
931          return;
932       }
933       if(key == 82 && evt.altKey && evt.ctrlKey) /* ctrl+alt+r */ {
934          resetAll();
935          return;
936       }
937    }
938 }
939
940 document.onkeydown=keyDown;
941 if(document.layers) {
942    document.captureEvents(Event.KEYDOWN);
943 }
944
945 // will be reseted by first viewing photo-index
946 var startup = 1;
947 // calendar specific
948 var calendar_shown = 0;
949 var calendar_mode = '';
950 // auto-browsing & sliding
951 var autobrowse = 0;
952 var sliding = 0;
953 var sliding_paused = 0;
954 var sliding_time = 3;
955 // zooming
956 var origHeight;
957 var origWidth;
958 // position of the last shown photo in photo-index
959 var photo_details_pos;
960 var web_path;
961 var rate_search = new Array();