Logo Search packages:      
Sourcecode: openexr version File versions

ImfPreviewImage.h

///////////////////////////////////////////////////////////////////////////
//
// Copyright (c) 2003, Industrial Light & Magic, a division of Lucas
// Digital Ltd. LLC
// 
// All rights reserved.
// 
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are
// met:
// *       Redistributions of source code must retain the above copyright
// notice, this list of conditions and the following disclaimer.
// *       Redistributions in binary form must reproduce the above
// copyright notice, this list of conditions and the following disclaimer
// in the documentation and/or other materials provided with the
// distribution.
// *       Neither the name of Industrial Light & Magic nor the names of
// its contributors may be used to endorse or promote products derived
// from this software without specific prior written permission. 
// 
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
//
///////////////////////////////////////////////////////////////////////////


#ifndef INCLUDED_IMF_PREVIEW_IMAGE_H
#define INCLUDED_IMF_PREVIEW_IMAGE_H

//-----------------------------------------------------------------------------
//
//    class PreviewImage -- a usually small, low-dynamic range image,
//    that is intended to be stored in an image file's header.
//
//    struct PreviewRgba -- holds the value of a PreviewImage pixel.
//
//-----------------------------------------------------------------------------

namespace Imf {


struct PreviewRgba
{
    unsigned char r;    // Red, green and blue components of
    unsigned char g;    // the pixel's color; intensity is
    unsigned char b;    // proportional to pow (x/255, 2.2),
                        // where x is r, g, or b.

    unsigned char a;    // The pixel's alpha; 0 == transparent,
                        // 255 == opaque.

    PreviewRgba (unsigned char r = 0,
             unsigned char g = 0,
             unsigned char b = 0,
             unsigned char a = 255)
      : r(r), g(g), b(b), a(a) {}
};


class PreviewImage
{
  public:

    //--------------------------------------------------------------------
    // Constructor:
    //
    // PreviewImage(w,h,p) constructs a preview image with w by h pixels
    // whose initial values are specified in pixel array p.  The x and y
    // coordinates of the pixels in p go from 0 to w-1, and from 0 to h-1.
    // The pixel with coordinates (x, y) is at address p + y*w + x.
    // Pixel (0, 0) is in the upper left corner of the preview image.
    // If p is zero, the pixels in the preview image are initialized with
    // (r = 0, b = 0, g = 0, a = 255).
    //
    //--------------------------------------------------------------------
   
     PreviewImage (unsigned int width = 0,
               unsigned int height = 0,
               const PreviewRgba pixels[] = 0);

    //-----------------------------------------------------
    // Copy constructor, destructor and assignment operator
    //-----------------------------------------------------

     PreviewImage (const PreviewImage &other);
    ~PreviewImage ();

    PreviewImage &      operator = (const PreviewImage &other);


    //-----------------------------------------------
    // Access to width, height and to the pixel array
    //-----------------------------------------------

    unsigned int  width () const    {return _width;}
    unsigned int  height () const   {return _height;}

    PreviewRgba * pixels ()   {return _pixels;}
    const PreviewRgba * pixels () const   {return _pixels;}


    //----------------------------
    // Access to individual pixels
    //----------------------------

    PreviewRgba & pixel (unsigned int x, unsigned int y)
                              {return _pixels[y * _width + x];}

    const PreviewRgba & pixel (unsigned int x, unsigned int y) const
                              {return _pixels[y * _width + x];}

  private:

    unsigned int  _width;
    unsigned int  _height;
    PreviewRgba * _pixels;
};


} // namespace Imf

#endif

Generated by  Doxygen 1.6.0   Back to index