--- /dev/null
+///////////////////////////////////////////////////////////////////////////
+//
+// 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