The Bondi gallery Module - Version 1.1

3.1. GalleryError

        interface GalleryError : GenericError {

                const unsigned short GALLERY_OPEN_ERROR = 1;

                const unsigned short GALLERY_NOT_OPEN_ERROR = 2;
        };

3.2. GalleryManager

        interface GalleryManager {

                GalleryArray getGalleries();
        };

        var availableGalleries = bondi.gallery.getGalleries();
        for (i=0; i < availableGalleries.length; i++) {
                var galleryInfo = availableGalleries[i].info;
                // check gallery info...
        }
 

3.3. Gallery

        interface Gallery {

                const unsigned short MEDIA_ITEM_TYPE_UNDEFINED = 0;

                const unsigned short MEDIA_ITEM_TYPE_AUDIO = 1;

                const unsigned short MEDIA_ITEM_TYPE_VIDEO = 2;

                const unsigned short MEDIA_ITEM_TYPE_IMAGE = 3;

                const unsigned short MEDIA_SORT_NONE = 0;

                const unsigned short MEDIA_SORT_BY_FILENAME = 1;

                const unsigned short MEDIA_SORT_BY_FILEDATE = 2;

                const unsigned short MEDIA_SORT_BY_TYPE = 3;

                const unsigned short MEDIA_SORT_BY_TITLE = 20;

                const unsigned short MEDIA_SORT_BY_AUTHOR = 21;

                const unsigned short MEDIA_SORT_BY_ALBUM = 22;

                const unsigned short MEDIA_SORT_BY_DATE = 23;

                const unsigned short MEDIA_SORT_ASCENDING = 0;

                const unsigned short MEDIA_SORT_DESCENDING = 1;

                readonly attribute Map info;

                unsigned long getNumberOfMediaItems()
                        raises(SecurityError, GalleryError);

                PendingOperation open(in SuccessCallback successCallback, in ErrorCallback errorCallback)
                        raises(SecurityError, DeviceAPIError, GalleryError);

                PendingOperation refresh(in SuccessCallback successCallback, in ErrorCallback errorCallback)
                        raises(SecurityError, DeviceAPIError, GalleryError);

                void close()
                        raises(DeviceAPIError, GalleryError);

                PendingOperation changeView(in SuccessCallback successCallback,
                                            in ErrorCallback errorCallback,
                                            in ViewFilter viewOptions)
                        raises(SecurityError, DeviceAPIError, GalleryError);

                MediaItemArray getMediaItems()
                        raises(SecurityError, DeviceAPIError, GalleryError);

                MediaItem getMediaItemById(in unsigned long itemId)
                        raises(SecurityError, DeviceAPIError, GalleryError);
        };

        // Define the changeView success callback.
        function changeViewSuccess() {
                alert("Gallery contains " + myGallery.getNumberOfMediaItems() + " images");
        }

        // Define the changeView failure callback.
        function changeViewFailure(e) {
                alert("Cannot change gallery view");
        }

        // Define the open success callback.
        function openSuccess() {
                alert("Gallery contains " + myGallery.getNumberOfMediaItems() + " media items");
                myGallery.changeView(changeViewSuccess, changeViewFailure, {filterItemType:gallery.MEDIA_ITEM_TYPE_IMAGE});
        }

        // Define the open failure callback.
        function openFailure(e) {
                alert("Cannot open the gallery");
        }

        // Open the gallery.
        myGallery.open(openSuccess, openFailure);
 

3.4. MediaItem

        interface MediaItem {

                readonly attribute unsigned long id;

                readonly attribute long type;

                readonly attribute DOMString mimeType;

                readonly attribute DOMString fileName;

                readonly attribute Map metadata;
        };

        var myPreferredPictureId = 7;
        var myPreferredPicture = gallery.getMediaItemById(myPreferredPictureId);
        if(myPreferredPicture.type == gallery.MEDIA_ITEM_TYPE_IMAGE) {
                alert("My preferred picture was taken with camera " + myPreferredPicture.metadata.cameraModel);
        }
        else {
                alert("My preferred picture is not an image...");
        }
 

3.5. ViewFilter

   [NoInterfaceObject, Callback] interface ViewFilter {
        attribute short primarySortOrder;

        attribute short secondarySortOrder;

        attribute Date startDate;

        attribute Date endDate;

        attribute DOMString metaTag;
   };

        // Define the changeView error callback.
        function cvFailure(e) {
                alert("Cannot change gallery view");
        }

        // Define the changeView success callback.
        function cvSuccess() {
                var itemNum = gallery.getNumberOfMediaItems();
                alert("You have "+itemNum+" pictures taken in November 2008");
        }

        // Define the open error callback.
        function openFailure(e) {
                alert("Cannot open gallery");
        }

        // Define the open success callback.
        function openSuccess() {
                alert("Gallery successfully opened");
                // Change the view.
                var startDate = new Date(8,10,1);
                var endDate = new Date(8,10,30);
                gallery.changeView(cvSuccess, cvFailure, {
                        primarySortOrder:gallery.MEDIA_SORT_BY_FILENAME,
                        secondarySortOrder:gallery.MEDIA_SORT_NONE,
                        startDate:startDate,
                        endDate:endDate
                });
        }

        // Open the gallery.
        gallery.open(openSuccess, openFailure);
 

3.6. GalleryManagerObject

        interface GalleryManagerObject {
                readonly attribute GalleryManager galleryManager; 
        };

        Bondi implements GalleryManagerObject;