IMG/IMG_Plane.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:
 *      Mark Alexander
 *      Side Effects Software Inc
 *      477 Richmond Street West
 *      Toronto, Ontario
 *      Canada   M5V 3E7
 *      416-504-9876
 *
 * NAME:        IMG_Plane.h ( IMG Library, C++)
 *
 * COMMENTS:
 *      Description class of a single plane in a deep raster file.
 *      IMG_Stat contains a list of IMG_Plane structures.
 */
#ifndef __IMG_PLANE_INFO_H__
#define __IMG_PLANE_INFO_H__

#include "IMG_API.h"

#include <SYS/SYS_Types.h>
#include <UT/UT_String.h>
#include <UT/UT_Rect.h>

#include "IMG_FileTypes.h"

class IMG_Stat;

/// @brief Describes the format and layout of a single plane in an image
/// The plane specifies the format and name of a single image plane in a deep
/// raster image. IMG_Stat contains a list of planes found in the image.
/// Non-deep raster formats only contain one plane. 
class IMG_API IMG_Plane
{
public:
    /// @{
    /// Planes are generally not created by the user, but by 
    /// IMG_State::addPlane()
    IMG_Plane();
    IMG_Plane(const IMG_Plane &p);
    IMG_Plane(const char *name, IMG_DataType dt, IMG_ColorModel cm,
                  int index);
    /// @}

    /// @{
    /// plane name - must be unique in the list of planes found in IMG_Stat
    void        setName(const char *name);
    const char *getName() const;
    /// @}

    /// @{
    /// data format of the individual pixel components (8bit - FP)
    void         setDataType(IMG_DataType dt);
    IMG_DataType getDataType() const;
    /// @}

    /// @{
    /// color model of the pixel, which specifies the components per pixel.
    /// (SINGLE_CHAN, RGB, RGBA)
    void           setColorModel(IMG_ColorModel cm);
    IMG_ColorModel getColorModel() const;
    /// @}

    /// @{
    /// Sets the individual component name(s) (default: r,g,b,a). Always call 
    /// after setColorModel().
    void        setComponentNames(const char *c1,
                                  const char *c2=0,
                                  const char *c3=0,
                                  const char *c4=0,
                                  bool only_if_not_set = false);
    void        setComponentName(int comp, const char *name);

    /// Returns the name of the individual component of a pixel (r,g,b,a, x,y,z)
    const char *getComponentName(int comp) const;
    /// @}

    

    /// @{
    /// Specifies black/white points for integer formats (not supported for FP)
    /// always set the data type before setting the BW points.
    /// The black and white points must be within the range of the intger data
    /// format (ie, 8b - 0-255). 
    void           setBlackWhitePoints(int64 b, int64 w);
    bool           hasBlackWhitePoints() const;
    void           getBlackWhitePoints(int64 &b, int64 &w) const;
    /// @}

    /// the size of a single pixel, in bytes, including the data format and
    /// the color model.
    int            getPixelSize() const;

    /// This is the index of this plane, in the list of planes found in
    /// IMG_Stat (0 to getNumPlanes()-1).
    int            getPlaneIndex() const { return myIndex; }
    
private:
    // only used by IMG_Stat.
    void           setParentStat(IMG_Stat *stat) { myStat = stat; }
    void           setPlaneIndex(int index) { myIndex = index; }

    // data members
    UT_String           myName;
    UT_String           myComponentNames[4];
    int                 myIndex;
    
    IMG_DataType        myDataType;
    IMG_ColorModel      myColorModel;
    int64               myBlackPoint;
    int64               myWhitePoint;    
    IMG_Stat           *myStat;

    friend class IMG_Stat;
};



#endif

---