OP/OP_GalleryManager.h

Go to the documentation of this file.

/*
 * PROPRIETARY INFORMATION.  This software is proprietary to
 * Side Effects Software Inc., and is not to be reproduced,
 * transmitted, or disclosed in any way without written permission.
 *
 * Produced by:
 *      Side Effects Software Inc
 *      477 Richmond Street West
 *      Toronto, Ontario
 *      Canada   M5V 3E7
 *      416-504-9876
 *
 * NAME:        OP_GalleryManager.h ( OP Library, C++)
 *
 * COMMENTS:    Class to manage OP_Gallerys.
 */

#ifndef __OP_GalleryManager__
#define __OP_GalleryManager__

#include "OP_API.h"
#include <UT/UT_Notifier.h>
#include <UT/UT_Version.h>
#include "OP_Gallery.h"

typedef enum {
    OP_GALLERY_ADDED,
    OP_GALLERY_REMOVED,
    OP_GALLERY_REFRESHED,
    OP_GALLERY_CONFIGCHANGE
} OP_GalleryChangeType;

#define OP_GALLERY_DEFAULT_PATH "$HOME/houdini" \
                                UT_SAVE_VERSION \
                                "/gallery/Custom.gal"

typedef UT_NotifierImpl<OP_GalleryChangeType> OP_GalleryNotifier;

class OP_API OP_GalleryManager
{
public:
    int                          getNumGalleries() const;
    OP_Gallery                  *getGallery(int index) const;
    OP_Gallery                  *findGallery(const char *path) const;
    OP_Gallery                  *installGallery(const char *path,
                                    bool create, bool addtohistory);
    void                         removeGallery(const char *path);
    void                         removeGallery(int index);
    void                         getMatchingEntries(
                                    OP_GalleryEntryList &found,
                                    OP_Node *node) const;
    void                         getMatchingEntries(
                                    OP_GalleryEntryList &found,
                                    const char *namepattern,
                                    const char *labelpattern,
                                    const char *keywordpattern,
                                    const char *category,
                                    const char *optable,
                                    const char *optype) const;

    void                         refreshAll(bool force);
    void                         purgeInvalidGalleries();
    void                         sendEvent(OP_GalleryChangeType changetype);
    OP_GalleryNotifier          &getEventNotifier();

    void                         getInstalledGalleryPaths(
                                    UT_StringArray &gallerypaths,
                                    bool includestandard,
                                    bool includehda) const;

    void                         getCommonGalleryDirs(UT_StringList & paths);

    // Controls whether galleries should create backup files when they
    // are saved.
    void                         setCreateBackups(bool createbackups);
    bool                         getCreateBackups() const;

    // Returns whether or not we are allowed to save the preferences file.
    // This will be false if there is a nosave file in the HOUDINI_PATH.
    bool                         canSavePreferences() const;

    static OP_GalleryManager    &getManager();

protected:
                                 OP_GalleryManager();
    virtual                     ~OP_GalleryManager();

    void                         clear();
    void                         scanGalleriesPath();

    static void                  fullyQualifyGalleryPath(UT_String &path);

private:
    void                         loadPreferences();
    void                         savePreferences();

    OP_GalleryList               myGalleries;
    UT_SymbolTable               myGalleriesTable;
    OP_GalleryNotifier           myNotifier;
    bool                         myCreateBackups;
};

OP_API extern OP_GalleryManager &OPgetGalleryManager();

#endif

---