rfreeimage 0.1.0

data/vendor/FreeImage/Source/OpenEXR/IlmImf/ImfStandardAttributes.h

@@ -0,0 +1,382 @@
+///////////////////////////////////////////////////////////////////////////
+//
+// Copyright (c) 2004, 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_STANDARD_ATTRIBUTES_H
+#define INCLUDED_IMF_STANDARD_ATTRIBUTES_H
+
+//-----------------------------------------------------------------------------
+//
+//	Optional Standard Attributes -- these attributes are "optional"
+//	because not every image file header has them, but they define a
+//	"standard" way to represent commonly used data in the file header.
+//
+//	For each attribute, with name "foo", and type "T", the following
+//	functions are automatically generated via macros:
+//
+//	void			   addFoo (Header &header, const T &value);
+//	bool			   hasFoo (const Header &header);
+//	const TypedAttribute<T> &  fooAttribute (const Header &header);
+//	TypedAttribute<T> &	   fooAttribute (Header &header);
+//	const T &		   foo (const Header &Header);
+//	T &			   foo (Header &Header);
+//
+//-----------------------------------------------------------------------------
+
+#include "ImfHeader.h"
+#include "ImfBoxAttribute.h"
+#include "ImfChromaticitiesAttribute.h"
+#include "ImfEnvmapAttribute.h"
+#include "ImfDeepImageStateAttribute.h"
+#include "ImfFloatAttribute.h"
+#include "ImfKeyCodeAttribute.h"
+#include "ImfMatrixAttribute.h"
+#include "ImfRationalAttribute.h"
+#include "ImfStringAttribute.h"
+#include "ImfStringVectorAttribute.h"
+#include "ImfTimeCodeAttribute.h"
+#include "ImfVecAttribute.h"
+#include "ImfNamespace.h"
+#include "ImfExport.h"
+
+#define IMF_STD_ATTRIBUTE_DEF(name,suffix,object)                            \
+                                                                             \
+    OPENEXR_IMF_INTERNAL_NAMESPACE_HEADER_ENTER                              \
+    IMF_EXPORT void           add##suffix (Header &header, const object &v); \
+    IMF_EXPORT bool           has##suffix (const Header &header);            \
+    IMF_EXPORT const TypedAttribute<object> &                                \
+                              name##Attribute (const Header &header);        \
+    IMF_EXPORT TypedAttribute<object> &                                      \
+                              name##Attribute (Header &header);              \
+    IMF_EXPORT const object &                                                \
+                              name (const Header &header);                   \
+    IMF_EXPORT object &       name (Header &header);                         \
+    OPENEXR_IMF_INTERNAL_NAMESPACE_HEADER_EXIT                               \
+
+//
+// chromaticities -- for RGB images, specifies the CIE (x,y)
+// chromaticities of the primaries and the white point
+//
+
+IMF_STD_ATTRIBUTE_DEF (chromaticities, Chromaticities, Chromaticities)
+
+
+//
+// whiteLuminance -- for RGB images, defines the luminance, in Nits
+// (candelas per square meter) of the RGB value (1.0, 1.0, 1.0).
+//
+// If the chromaticities and the whiteLuminance of an RGB image are
+// known, then it is possible to convert the image's pixels from RGB
+// to CIE XYZ tristimulus values (see function RGBtoXYZ() in header
+// file ImfChromaticities.h).
+// 
+//
+
+IMF_STD_ATTRIBUTE_DEF (whiteLuminance, WhiteLuminance, float)
+
+
+//
+// adoptedNeutral -- specifies the CIE (x,y) coordinates that should
+// be considered neutral during color rendering.  Pixels in the image
+// file whose (x,y) coordinates match the adoptedNeutral value should
+// be mapped to neutral values on the display.
+//
+
+IMF_STD_ATTRIBUTE_DEF (adoptedNeutral, AdoptedNeutral, IMATH_NAMESPACE::V2f)
+
+
+//
+// renderingTransform, lookModTransform -- specify the names of the
+// CTL functions that implements the intended color rendering and look
+// modification transforms for this image.
+// 
+
+IMF_STD_ATTRIBUTE_DEF (renderingTransform, RenderingTransform, std::string)
+IMF_STD_ATTRIBUTE_DEF (lookModTransform, LookModTransform, std::string)
+
+
+//
+// xDensity -- horizontal output density, in pixels per inch.
+// The image's vertical output density is xDensity * pixelAspectRatio.
+//
+
+IMF_STD_ATTRIBUTE_DEF (xDensity, XDensity, float)
+
+
+//
+// owner -- name of the owner of the image
+//
+
+IMF_STD_ATTRIBUTE_DEF (owner, Owner, std::string)
+   
+
+//
+// comments -- additional image information in human-readable
+// form, for example a verbal description of the image
+//
+
+IMF_STD_ATTRIBUTE_DEF (comments, Comments, std::string)
+
+
+//
+// capDate -- the date when the image was created or captured,
+// in local time, and formatted as
+//
+//    YYYY:MM:DD hh:mm:ss
+//
+// where YYYY is the year (4 digits, e.g. 2003), MM is the month
+// (2 digits, 01, 02, ... 12), DD is the day of the month (2 digits,
+// 01, 02, ... 31), hh is the hour (2 digits, 00, 01, ... 23), mm
+// is the minute, and ss is the second (2 digits, 00, 01, ... 59).
+//
+//
+
+IMF_STD_ATTRIBUTE_DEF (capDate, CapDate, std::string)
+
+
+//
+// utcOffset -- offset of local time at capDate from
+// Universal Coordinated Time (UTC), in seconds:
+//
+//    UTC == local time + utcOffset
+//
+
+IMF_STD_ATTRIBUTE_DEF (utcOffset, UtcOffset, float)
+
+
+//
+// longitude, latitude, altitude -- for images of real objects, the
+// location where the image was recorded.  Longitude and latitude are
+// in degrees east of Greenwich and north of the equator.  Altitude
+// is in meters above sea level.  For example, Kathmandu, Nepal is
+// at longitude 85.317, latitude 27.717, altitude 1305.
+//
+
+IMF_STD_ATTRIBUTE_DEF (longitude, Longitude, float)
+IMF_STD_ATTRIBUTE_DEF (latitude, Latitude, float)
+IMF_STD_ATTRIBUTE_DEF (altitude, Altitude, float)
+
+
+//
+// focus -- the camera's focus distance, in meters
+//
+
+IMF_STD_ATTRIBUTE_DEF (focus, Focus, float)
+
+
+//
+// exposure -- exposure time, in seconds
+//
+
+IMF_STD_ATTRIBUTE_DEF (expTime, ExpTime, float)
+
+
+//
+// aperture -- the camera's lens aperture, in f-stops (focal length
+// of the lens divided by the diameter of the iris opening)
+//
+
+IMF_STD_ATTRIBUTE_DEF (aperture, Aperture, float)
+
+
+//
+// isoSpeed -- the ISO speed of the film or image sensor
+// that was used to record the image
+//
+
+IMF_STD_ATTRIBUTE_DEF (isoSpeed, IsoSpeed, float)
+
+
+//
+// envmap -- if this attribute is present, the image represents
+// an environment map.  The attribute's value defines how 3D
+// directions are mapped to 2D pixel locations.  For details
+// see header file ImfEnvmap.h
+//
+
+IMF_STD_ATTRIBUTE_DEF (envmap, Envmap, Envmap)
+
+
+//
+// keyCode -- for motion picture film frames.  Identifies film
+// manufacturer, film type, film roll and frame position within
+// the roll.
+//
+
+IMF_STD_ATTRIBUTE_DEF (keyCode, KeyCode, KeyCode)
+
+
+//
+// timeCode -- time and control code
+//
+
+IMF_STD_ATTRIBUTE_DEF (timeCode, TimeCode, TimeCode)
+
+
+//
+// wrapmodes -- determines how texture map images are extrapolated.
+// If an OpenEXR file is used as a texture map for 3D rendering,
+// texture coordinates (0.0, 0.0) and (1.0, 1.0) correspond to
+// the upper left and lower right corners of the data window.
+// If the image is mapped onto a surface with texture coordinates
+// outside the zero-to-one range, then the image must be extrapolated.
+// This attribute tells the renderer how to do this extrapolation.
+// The attribute contains either a pair of comma-separated keywords,
+// to specify separate extrapolation modes for the horizontal and
+// vertical directions; or a single keyword, to specify extrapolation
+// in both directions (e.g. "clamp,periodic" or "clamp").  Extra white
+// space surrounding the keywords is allowed, but should be ignored
+// by the renderer ("clamp, black " is equivalent to "clamp,black").
+// The keywords listed below are predefined; some renderers may support
+// additional extrapolation modes:
+//
+//	black		pixels outside the zero-to-one range are black
+//
+//	clamp		texture coordinates less than 0.0 and greater
+//			than 1.0 are clamped to 0.0 and 1.0 respectively
+//
+//	periodic	the texture image repeats periodically
+//
+//	mirror		the texture image repeats periodically, but
+//			every other instance is mirrored
+//
+
+IMF_STD_ATTRIBUTE_DEF (wrapmodes, Wrapmodes, std::string)
+
+
+//
+// framesPerSecond -- defines the nominal playback frame rate for image
+// sequences, in frames per second.  Every image in a sequence should
+// have a framesPerSecond attribute, and the attribute value should be
+// the same for all images in the sequence.  If an image sequence has
+// no framesPerSecond attribute, playback software should assume that
+// the frame rate for the sequence is 24 frames per second.
+//
+// In order to allow exact representation of NTSC frame and field rates,
+// framesPerSecond is stored as a rational number.  A rational number is
+// a pair of integers, n and d, that represents the value n/d.
+//
+// For the exact values of commonly used frame rates, please see header
+// file ImfFramesPerSecond.h.
+//
+
+IMF_STD_ATTRIBUTE_DEF (framesPerSecond, FramesPerSecond, Rational)
+
+
+//
+// multiView -- defines the view names for multi-view image files.
+// A multi-view image contains two or more views of the same scene,
+// as seen from different viewpoints, for example a left-eye and
+// a right-eye view for stereo displays.  The multiView attribute
+// lists the names of the views in an image, and a naming convention
+// identifies the channels that belong to each view.
+//
+// For details, please see header file ImfMultiView.h
+//
+
+IMF_STD_ATTRIBUTE_DEF (multiView , MultiView, StringVector)
+
+
+// 
+// worldToCamera -- for images generated by 3D computer graphics rendering,
+// a matrix that transforms 3D points from the world to the camera coordinate
+// space of the renderer.
+// 
+// The camera coordinate space is left-handed.  Its origin indicates the
+// location of the camera.  The positive x and y axes correspond to the
+// "right" and "up" directions in the rendered image.  The positive z
+// axis indicates the camera's viewing direction.  (Objects in front of
+// the camera have positive z coordinates.)
+// 
+// Camera coordinate space in OpenEXR is the same as in Pixar's Renderman.
+// 
+
+IMF_STD_ATTRIBUTE_DEF (worldToCamera, WorldToCamera, IMATH_NAMESPACE::M44f)
+
+
+// 
+// worldToNDC -- for images generated by 3D computer graphics rendering, a
+// matrix that transforms 3D points from the world to the Normalized Device
+// Coordinate (NDC) space of the renderer.
+// 
+// NDC is a 2D coordinate space that corresponds to the image plane, with
+// positive x and pointing to the right and y positive pointing down.  The
+// coordinates (0, 0) and (1, 1) correspond to the upper left and lower right
+// corners of the OpenEXR display window.
+// 
+// To transform a 3D point in word space into a 2D point in NDC space,
+// multiply the 3D point by the worldToNDC matrix and discard the z
+// coordinate.
+// 
+// NDC space in OpenEXR is the same as in Pixar's Renderman.
+// 
+
+IMF_STD_ATTRIBUTE_DEF (worldToNDC, WorldToNDC, IMATH_NAMESPACE::M44f)
+
+
+//
+// deepImageState -- specifies whether the pixels in a deep image are
+// sorted and non-overlapping.
+//
+// Note: this attribute can be set by application code that writes a file
+// in order to tell applications that read the file whether the pixel data
+// must be cleaned up prior to image processing operations such as flattening. 
+// The IlmImf library does not verify that the attribute is consistent with
+// the actual state of the pixels.  Application software may assume that the
+// attribute is valid, as long as the software will not crash or lock up if
+// any pixels are inconsistent with the deepImageState attribute.
+//
+
+IMF_STD_ATTRIBUTE_DEF (deepImageState, DeepImageState, DeepImageState)
+
+
+//
+// originalDataWindow -- if application software crops an image, then it
+// should save the data window of the original, un-cropped image in the
+// originalDataWindow attribute.
+//
+
+IMF_STD_ATTRIBUTE_DEF
+    (originalDataWindow, OriginalDataWindow, IMATH_NAMESPACE::Box2i)
+
+
+//
+// dwaCompressionLevel -- sets the quality level for images compressed
+// with the DWAA or DWAB method.
+//
+
+IMF_STD_ATTRIBUTE_DEF (dwaCompressionLevel, DwaCompressionLevel, float)
+
+
+#endif

data/vendor/FreeImage/Source/OpenEXR/IlmImf/ImfStdIO.cpp

@@ -0,0 +1,242 @@
+///////////////////////////////////////////////////////////////////////////
+//
+// Copyright (c) 2004, 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.67
+//
+///////////////////////////////////////////////////////////////////////////
+
+
+//-----------------------------------------------------------------------------
+//
+//	Low-level file input and output for OpenEXR
+//	based on C++ standard iostreams.
+//
+//-----------------------------------------------------------------------------
+
+#include <ImfStdIO.h>
+#include "Iex.h"
+#include <errno.h>
+
+using namespace std;
+#include "ImfNamespace.h"
+
+OPENEXR_IMF_INTERNAL_NAMESPACE_SOURCE_ENTER
+
+namespace {
+
+void
+clearError ()
+{
+    errno = 0;
+}
+
+
+bool
+checkError (istream &is, streamsize expected = 0)
+{
+    if (!is)
+    {
+	if (errno)
+	    IEX_NAMESPACE::throwErrnoExc();
+
+	if (is.gcount() < expected) 
+	{
+		THROW (IEX_NAMESPACE::InputExc, "Early end of file: read " << is.gcount() 
+			<< " out of " << expected << " requested bytes.");
+	}
+	return false;
+    }
+
+    return true;
+}
+
+
+void
+checkError (ostream &os)
+{
+    if (!os)
+    {
+	if (errno)
+	    IEX_NAMESPACE::throwErrnoExc();
+
+	throw IEX_NAMESPACE::ErrnoExc ("File output failed.");
+    }
+}
+
+} // namespace
+
+
+StdIFStream::StdIFStream (const char fileName[]):
+    OPENEXR_IMF_INTERNAL_NAMESPACE::IStream (fileName),
+    _is (new ifstream (fileName, ios_base::binary)),
+    _deleteStream (true)
+{
+    if (!*_is)
+    {
+	delete _is;
+	IEX_NAMESPACE::throwErrnoExc();
+    }
+}
+
+    
+StdIFStream::StdIFStream (ifstream &is, const char fileName[]):
+    OPENEXR_IMF_INTERNAL_NAMESPACE::IStream (fileName),
+    _is (&is),
+    _deleteStream (false)
+{
+    // empty
+}
+
+
+StdIFStream::~StdIFStream ()
+{
+    if (_deleteStream)
+	delete _is;
+}
+
+
+bool
+StdIFStream::read (char c[/*n*/], int n)
+{
+    if (!*_is)
+        throw IEX_NAMESPACE::InputExc ("Unexpected end of file.");
+
+    clearError();
+    _is->read (c, n);
+    return checkError (*_is, n);
+}
+
+
+Int64
+StdIFStream::tellg ()
+{
+    return std::streamoff (_is->tellg());
+}
+
+
+void
+StdIFStream::seekg (Int64 pos)
+{
+    _is->seekg (pos);
+    checkError (*_is);
+}
+
+
+void
+StdIFStream::clear ()
+{
+    _is->clear();
+}
+
+
+StdOFStream::StdOFStream (const char fileName[]):
+    OPENEXR_IMF_INTERNAL_NAMESPACE::OStream (fileName),
+    _os (new ofstream (fileName, ios_base::binary)),
+    _deleteStream (true)
+{
+    if (!*_os)
+    {
+	delete _os;
+	IEX_NAMESPACE::throwErrnoExc();
+    }
+}
+
+
+StdOFStream::StdOFStream (ofstream &os, const char fileName[]):
+    OPENEXR_IMF_INTERNAL_NAMESPACE::OStream (fileName),
+    _os (&os),
+    _deleteStream (false)
+{
+    // empty
+}
+
+
+StdOFStream::~StdOFStream ()
+{
+    if (_deleteStream)
+	delete _os;
+}
+
+
+void
+StdOFStream::write (const char c[/*n*/], int n)
+{
+    clearError();
+    _os->write (c, n);
+    checkError (*_os);
+}
+
+
+Int64
+StdOFStream::tellp ()
+{
+    return std::streamoff (_os->tellp());
+}
+
+
+void
+StdOFStream::seekp (Int64 pos)
+{
+    _os->seekp (pos);
+    checkError (*_os);
+}
+
+
+StdOSStream::StdOSStream (): OPENEXR_IMF_INTERNAL_NAMESPACE::OStream ("(string)")
+{
+    // empty
+}
+
+
+void
+StdOSStream::write (const char c[/*n*/], int n)
+{
+    clearError();
+    _os.write (c, n);
+    checkError (_os);
+}
+
+
+Int64
+StdOSStream::tellp ()
+{
+    return std::streamoff (_os.tellp());
+}
+
+
+void
+StdOSStream::seekp (Int64 pos)
+{
+    _os.seekp (pos);
+    checkError (_os);
+}
+
+
+OPENEXR_IMF_INTERNAL_NAMESPACE_SOURCE_EXIT