IMG/IMG_TileOptions.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
 *      123 Front Street West, Suite 1401
 *      Toronto, Ontario
 *      Canada   M5J 2M2
 *      416-504-9876
 *
 * NAME:        IMG_TileOptions.h ( IMG Library, C++)
 *
 * COMMENTS:
 */

#ifndef __IMG_TileOptions__
#define __IMG_TileOptions__

#include "IMG_API.h"
#include "IMG_FileTypes.h"
#include <UT/UT_Options.h>
#include <UT/UT_PtrArray.h>

class UT_StringArray;
class IMG_Format;

class IMG_API IMG_TileOptions {
public:
    /// If the format is a null pointer, it will be inferred from the filename
             IMG_TileOptions();
    virtual ~IMG_TileOptions();

    /// Create a new copy of myself
    virtual IMG_TileOptions     *clone() const;

    void        setPlaneInfo(const char *filename,
                        const char *channel,
                        const char *format,
                        IMG_DataType dtype = IMG_DT_ANY,
                        IMG_ColorModel cmodel = IMG_CM_ANY);

    // Change the filename extension to match the format
    bool        changeFileExtension();

    /// There are sevaral ways to set format options:
    ///   1)  A sting (which is parsed into token/value pairs)
    ///   2)  A set of token/value pairs specified as a linear array
    void        clearOptions();
    void        setFormatOptions(const char *string);
    void        setFormatOptions(int argc, char *argv[]);
    void        setFormatOptions(const UT_StringArray &options);
    void        setFormatOption(const char *token, const char *value);
    void        setFormatOptions(const UT_Options &options);

    /// Get the IMG_Format associated with these options.  This will possibly
    /// return a null ptr.
    virtual const IMG_Format    *getFormat() const;

    const char                  *getFilename() const;
    const char                  *getChannel() const;
    const char                  *getFormatName() const;
    IMG_DataType                 getDataType() const;
    IMG_ColorModel               getColorModel() const;
    const UT_Options            &getLocalOptions() const;

    /// Getting the option will return true/false based on whether the option
    /// was defined.  If the option was not defined, the value will not be
    /// touched (i.e. it will remain unchanged).
    virtual bool        getOption(const char *token, UT_String &value) const;

    /// Texture options are only output for specific file formats.  These
    /// texture options are used to pass information from the calling
    /// application to the device (where required).
    /// The application can write directly to the UT_Options, which will
    /// then be output in the file.
    virtual void        setTextureOptions(UT_Options &options);

    /// Pack all options into a single string.  Returns the number of options
    /// packed.
    virtual int         packOptionsString(UT_String &result) const;
protected:
    // Copy from the option source
    void                copy(const IMG_TileOptions &src);

    UT_String           myFilename;
    UT_String           myChannel;
    UT_String           myFormatName;
    IMG_DataType        myDataType;
    IMG_ColorModel      myColorModel;
    UT_Options          myOptions;
};

class IMG_API IMG_TileOptionList {
public:
     IMG_TileOptionList();
    ~IMG_TileOptionList();

    /// WARNING:  Using this class will delete all the contents, so you must
    /// append clones if you're creating single lists from existing options.
    int         entries() const                 { return myOptions.entries(); }
    void        append(IMG_TileOptions *opt)    { myOptions.append(opt); }
    IMG_TileOptions     *operator()(int i)      { return myOptions(i); }
private:
    UT_PtrArray<IMG_TileOptions *>      myOptions;
};

#endif

---