rfreeimage 0.1.0

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

@@ -0,0 +1,335 @@
+///////////////////////////////////////////////////////////////////////////
+//
+// 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.
+//
+///////////////////////////////////////////////////////////////////////////
+
+
+//-----------------------------------------------------------------------------
+//
+//	Environment maps
+//
+//-----------------------------------------------------------------------------
+
+#include "ImfEnvmap.h"
+#include "ImathFun.h"
+#include "ImfNamespace.h"
+
+#include <algorithm>
+#include <math.h>
+
+using namespace std;
+using namespace IMATH_NAMESPACE;
+
+
+OPENEXR_IMF_INTERNAL_NAMESPACE_SOURCE_ENTER
+
+
+namespace LatLongMap {
+
+V2f	
+latLong (const V3f &dir)
+{
+    float r = sqrt (dir.z * dir.z + dir.x * dir.x);
+
+    float latitude = (r < abs (dir.y))?
+			 acos (r / dir.length()) * sign (dir.y):
+			 asin (dir.y / dir.length());
+
+    float longitude = (dir.z == 0 && dir.x == 0)? 0: atan2 (dir.x, dir.z);
+
+    return V2f (latitude, longitude);
+}
+
+
+V2f
+latLong (const Box2i &dataWindow, const V2f &pixelPosition)
+{
+    float latitude, longitude;
+
+    if (dataWindow.max.y > dataWindow.min.y)
+    {
+        latitude = -1 * float(M_PI) *
+            ((pixelPosition.y  - dataWindow.min.y) /
+            (dataWindow.max.y - dataWindow.min.y) - 0.5f);
+    }
+    else
+    {
+	latitude = 0;
+    }
+
+    if (dataWindow.max.x > dataWindow.min.x)
+    {
+	longitude = -2 * float(M_PI) *
+		   ((pixelPosition.x  - dataWindow.min.x) /
+		    (dataWindow.max.x - dataWindow.min.x) - 0.5f);
+    }
+    else
+    {
+	longitude = 0;
+    }
+
+    return V2f (latitude, longitude);
+}
+
+
+V2f
+pixelPosition (const Box2i &dataWindow, const V2f &latLong)
+{
+    float x = latLong.y / (-2 * float(M_PI)) + 0.5f;
+    float y = latLong.x / (-1 * float(M_PI)) + 0.5f;
+
+    return V2f (x * (dataWindow.max.x - dataWindow.min.x) + dataWindow.min.x,
+		y * (dataWindow.max.y - dataWindow.min.y) + dataWindow.min.y);
+}
+
+
+V2f
+pixelPosition (const Box2i &dataWindow, const V3f &direction)
+{
+    return pixelPosition (dataWindow, latLong (direction));
+}
+
+
+V3f
+direction (const Box2i &dataWindow, const V2f &pixelPosition)
+{
+    V2f ll = latLong (dataWindow, pixelPosition);
+
+    return V3f (sin (ll.y) * cos (ll.x),
+		sin (ll.x),
+		cos (ll.y) * cos (ll.x));
+}
+
+} // namespace LatLongMap
+
+
+namespace CubeMap {
+
+int
+sizeOfFace (const Box2i &dataWindow)
+{
+    return min ((dataWindow.max.x - dataWindow.min.x + 1),
+		(dataWindow.max.y - dataWindow.min.y + 1) / 6);
+}
+
+
+Box2i
+dataWindowForFace (CubeMapFace face, const Box2i &dataWindow)
+{
+    int sof = sizeOfFace (dataWindow);
+    Box2i dwf;
+
+    dwf.min.x = 0;
+    dwf.min.y = int (face) * sof;
+
+    dwf.max.x = dwf.min.x + sof - 1;
+    dwf.max.y = dwf.min.y + sof - 1;
+
+    return dwf;
+}
+
+
+V2f
+pixelPosition (CubeMapFace face, const Box2i &dataWindow, V2f positionInFace)
+{
+    Box2i dwf = dataWindowForFace (face, dataWindow);
+    V2f pos (0, 0);
+
+    switch (face)
+    {
+      case CUBEFACE_POS_X:
+
+	pos.x = dwf.min.x + positionInFace.y;
+	pos.y = dwf.max.y - positionInFace.x;
+	break;
+
+      case CUBEFACE_NEG_X:
+
+	pos.x = dwf.max.x - positionInFace.y;
+	pos.y = dwf.max.y - positionInFace.x;
+	break;
+
+      case CUBEFACE_POS_Y:
+
+	pos.x = dwf.min.x + positionInFace.x;
+	pos.y = dwf.max.y - positionInFace.y;
+	break;
+
+      case CUBEFACE_NEG_Y:
+
+	pos.x = dwf.min.x + positionInFace.x;
+	pos.y = dwf.min.y + positionInFace.y;
+	break;
+
+      case CUBEFACE_POS_Z:
+
+	pos.x = dwf.max.x - positionInFace.x;
+	pos.y = dwf.max.y - positionInFace.y;
+	break;
+
+      case CUBEFACE_NEG_Z:
+
+	pos.x = dwf.min.x + positionInFace.x;
+	pos.y = dwf.max.y - positionInFace.y;
+	break;
+    }
+
+    return pos;
+}
+
+
+void
+faceAndPixelPosition (const V3f &direction,
+		      const Box2i &dataWindow,
+		      CubeMapFace &face,
+		      V2f &pif)
+{
+    int sof = sizeOfFace (dataWindow);
+    float absx = abs (direction.x);
+    float absy = abs (direction.y);
+    float absz = abs (direction.z);
+
+    if (absx >= absy && absx >= absz)
+    {
+	if (absx == 0)
+	{
+	    //
+	    // Special case - direction is (0, 0, 0)
+	    //
+
+	    face = CUBEFACE_POS_X;
+	    pif = V2f (0, 0);
+	    return;
+	}
+
+	pif.x = (direction.y / absx + 1) / 2 * (sof - 1);
+	pif.y = (direction.z / absx + 1) / 2 * (sof - 1);
+
+	if (direction.x > 0)
+	    face = CUBEFACE_POS_X;
+	else
+	    face = CUBEFACE_NEG_X;
+    }
+    else if (absy >= absz)
+    {
+	pif.x = (direction.x / absy + 1) / 2 * (sof - 1);
+	pif.y = (direction.z / absy + 1) / 2 * (sof - 1);
+
+	if (direction.y > 0)
+	    face = CUBEFACE_POS_Y;
+	else
+	    face = CUBEFACE_NEG_Y;
+    }
+    else
+    {
+	pif.x = (direction.x / absz + 1) / 2 * (sof - 1);
+	pif.y = (direction.y / absz + 1) / 2 * (sof - 1);
+
+	if (direction.z > 0)
+	    face = CUBEFACE_POS_Z;
+	else
+	    face = CUBEFACE_NEG_Z;
+    }
+}
+
+
+V3f
+direction (CubeMapFace face, const Box2i &dataWindow, const V2f &positionInFace)
+{
+    int sof = sizeOfFace (dataWindow);
+
+    V2f pos;
+    
+    if (sof > 1)
+    {
+	pos = V2f (positionInFace.x / (sof - 1) * 2 - 1,
+		   positionInFace.y / (sof - 1) * 2 - 1);
+    }
+    else
+    {
+	pos = V2f (0, 0);
+    }
+
+    V3f dir (1, 0, 0);
+
+    switch (face)
+    {
+      case CUBEFACE_POS_X:
+
+	dir.x = 1;
+	dir.y = pos.x;
+	dir.z = pos.y;
+	break;
+
+      case CUBEFACE_NEG_X:
+
+	dir.x = -1;
+	dir.y = pos.x;
+	dir.z = pos.y;
+	break;
+
+      case CUBEFACE_POS_Y:
+
+	dir.x = pos.x;
+	dir.y = 1;
+	dir.z = pos.y;
+	break;
+
+      case CUBEFACE_NEG_Y:
+
+	dir.x = pos.x;
+	dir.y = -1;
+	dir.z = pos.y;
+	break;
+
+      case CUBEFACE_POS_Z:
+
+	dir.x = pos.x;
+	dir.y = pos.y;
+	dir.z = 1;
+	break;
+
+      case CUBEFACE_NEG_Z:
+
+	dir.x = pos.x;
+	dir.y = pos.y;
+	dir.z = -1;
+	break;
+    }
+
+    return dir;
+}
+
+} // namespace CubeMap
+
+
+OPENEXR_IMF_INTERNAL_NAMESPACE_SOURCE_EXIT

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

@@ -0,0 +1,336 @@
+///////////////////////////////////////////////////////////////////////////
+//
+// 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_ENVMAP_H
+#define INCLUDED_IMF_ENVMAP_H
+
+//-----------------------------------------------------------------------------
+//
+//	Environment maps
+//
+//	Environment maps define a mapping from 3D directions to 2D
+//	pixel space locations.  Environment maps are typically used
+//	in 3D rendering, for effects such as quickly approximating
+//	how shiny surfaces reflect their environment.
+//
+//	Environment maps can be stored in scanline-based or in tiled
+//	OpenEXR files.  The fact that an image is an environment map
+//	is indicated by the presence of an EnvmapAttribute whose name
+//	is "envmap". (Convenience functions to access this attribute
+//	are defined in header file ImfStandardAttributes.h.)
+//	The attribute's value defines the mapping from 3D directions
+//	to 2D pixel space locations.
+//
+//	This header file defines the set of possible EnvmapAttribute
+//	values.
+//
+//	For each possible EnvmapAttribute value, this header file also
+//	defines a set of convienience functions to convert between 3D
+//	directions and 2D pixel locations.
+//
+//	Most of the convenience functions defined below require a
+//	dataWindow parameter.  For scanline-based images, and for
+//	tiled images with level mode ONE_LEVEL, the dataWindow
+//	parameter should be set to the image's data window, as
+//	defined in the image header.  For tiled images with level
+//	mode MIPMAP_LEVELS or RIPMAP_LEVELS, the data window of the
+//	image level that is being accessed should be used instead.
+//	(See the dataWindowForLevel() methods in ImfTiledInputFile.h
+//	and ImfTiledOutputFile.h.)
+//
+//-----------------------------------------------------------------------------
+
+#include "ImathBox.h"
+#include "ImfNamespace.h"
+#include "ImfExport.h"
+
+
+OPENEXR_IMF_INTERNAL_NAMESPACE_HEADER_ENTER
+
+//--------------------------------
+// Supported environment map types
+//--------------------------------
+
+enum Envmap
+{
+    ENVMAP_LATLONG = 0,		// Latitude-longitude environment map
+    ENVMAP_CUBE = 1,		// Cube map
+
+    NUM_ENVMAPTYPES		// Number of different environment map types
+};
+
+
+//-------------------------------------------------------------------------
+// Latitude-Longitude Map:
+//
+// The environment is projected onto the image using polar coordinates
+// (latitude and longitude).  A pixel's x coordinate corresponds to
+// its longitude, and the y coordinate corresponds to its latitude.
+// Pixel (dataWindow.min.x, dataWindow.min.y) has latitude +pi/2 and
+// longitude +pi; pixel (dataWindow.max.x, dataWindow.max.y) has
+// latitude -pi/2 and longitude -pi.
+//
+// In 3D space, latitudes -pi/2 and +pi/2 correspond to the negative and
+// positive y direction.  Latitude 0, longitude 0 points into positive
+// z direction; and latitude 0, longitude pi/2 points into positive x
+// direction.
+//
+// The size of the data window should be 2*N by N pixels (width by height),
+// where N can be any integer greater than 0.
+//-------------------------------------------------------------------------
+
+namespace LatLongMap
+{
+    //----------------------------------------------------
+    // Convert a 3D direction to a 2D vector whose x and y
+    // components represent the corresponding latitude
+    // and longitude.
+    //----------------------------------------------------
+
+    IMF_EXPORT 
+    IMATH_NAMESPACE::V2f		latLong (const IMATH_NAMESPACE::V3f &direction);
+
+
+    //--------------------------------------------------------
+    // Convert the position of a pixel to a 2D vector whose
+    // x and y components represent the corresponding latitude
+    // and longitude.
+    //--------------------------------------------------------
+
+    IMF_EXPORT 
+    IMATH_NAMESPACE::V2f		latLong (const IMATH_NAMESPACE::Box2i &dataWindow,
+				 const IMATH_NAMESPACE::V2f &pixelPosition);
+
+
+    //-------------------------------------------------------------
+    // Convert a 2D vector, whose x and y components represent
+    // longitude and latitude, into a corresponding pixel position.
+    //-------------------------------------------------------------
+
+    IMF_EXPORT 
+    IMATH_NAMESPACE::V2f		pixelPosition (const IMATH_NAMESPACE::Box2i &dataWindow,
+				       const IMATH_NAMESPACE::V2f &latLong);
+
+
+    //-----------------------------------------------------
+    // Convert a 3D direction vector into a corresponding
+    // pixel position.  pixelPosition(dw,dir) is equivalent
+    // to pixelPosition(dw,latLong(dw,dir)).
+    //-----------------------------------------------------
+
+    IMF_EXPORT 
+    IMATH_NAMESPACE::V2f		pixelPosition (const IMATH_NAMESPACE::Box2i &dataWindow,
+				       const IMATH_NAMESPACE::V3f &direction);
+
+
+    //--------------------------------------------------------
+    // Convert the position of a pixel in a latitude-longitude
+    // map into a corresponding 3D direction.
+    //--------------------------------------------------------
+
+    IMF_EXPORT 
+    IMATH_NAMESPACE::V3f		direction (const IMATH_NAMESPACE::Box2i &dataWindow,
+				   const IMATH_NAMESPACE::V2f &pixelPosition);
+}
+
+
+//--------------------------------------------------------------
+// Cube Map:
+//
+// The environment is projected onto the six faces of an
+// axis-aligned cube.  The cube's faces are then arranged
+// in a 2D image as shown below.
+//
+//          2-----------3
+//         /           /|
+//        /           / |       Y
+//       /           /  |       |
+//      6-----------7   |       |
+//      |           |   |       |
+//      |           |   |       |
+//      |   0       |   1       *------- X
+//      |           |  /       /
+//      |           | /       /
+//      |           |/       /
+//      4-----------5       Z
+// 
+//   dataWindow.min
+//        /
+//       / 
+//      +-----------+
+//      |3    Y    7|
+//      |     |     |
+//      |     |     |
+//      |  ---+---Z |  +X face
+//      |     |     |
+//      |     |     |
+//      |1         5|
+//      +-----------+
+//      |6    Y    2|
+//      |     |     |
+//      |     |     |
+//      | Z---+---  |  -X face
+//      |     |     |
+//      |     |     |
+//      |4         0|
+//      +-----------+
+//      |6    Z    7|
+//      |     |     |
+//      |     |     |
+//      |  ---+---X |  +Y face
+//      |     |     |
+//      |     |     |
+//      |2         3|
+//      +-----------+
+//      |0         1|
+//      |     |     |
+//      |     |     |
+//      |  ---+---X |  -Y face
+//      |     |     |
+//      |     |     |
+//      |4    Z    5|
+//      +-----------+
+//      |7    Y    6|
+//      |     |     |
+//      |     |     |
+//      | X---+---  |  +Z face
+//      |     |     |
+//      |     |     |
+//      |5         4|
+//      +-----------+
+//      |2    Y    3|
+//      |     |     |
+//      |     |     |
+//      |  ---+---X |  -Z face
+//      |     |     |
+//      |     |     |
+//      |0         1|
+//      +-----------+
+//                 /
+//                /
+//          dataWindow.max
+//
+// The size of the data window should be N by 6*N pixels
+// (width by height), where N can be any integer greater
+// than 0.
+// 
+//--------------------------------------------------------------
+
+//------------------------------------
+// Names for the six faces of the cube
+//------------------------------------
+
+enum CubeMapFace
+{
+    CUBEFACE_POS_X,	// +X face
+    CUBEFACE_NEG_X,	// -X face
+    CUBEFACE_POS_Y,	// +Y face
+    CUBEFACE_NEG_Y,	// -Y face
+    CUBEFACE_POS_Z,	// +Z face
+    CUBEFACE_NEG_Z 	// -Z face
+};
+
+namespace CubeMap
+{
+    //---------------------------------------------
+    // Width and height of a cube's face, in pixels
+    //---------------------------------------------
+
+    IMF_EXPORT 
+    int			sizeOfFace (const IMATH_NAMESPACE::Box2i &dataWindow);
+
+
+    //------------------------------------------
+    // Compute the region in the environment map
+    // that is covered by the specified face.
+    //------------------------------------------
+
+    IMF_EXPORT 
+    IMATH_NAMESPACE::Box2i	dataWindowForFace (CubeMapFace face,
+					   const IMATH_NAMESPACE::Box2i &dataWindow);
+
+
+    //----------------------------------------------------
+    // Convert the coordinates of a pixel within a face
+    // [in the range from (0,0) to (s-1,s-1), where
+    // s == sizeOfFace(dataWindow)] to pixel coordinates
+    // in the environment map.
+    //----------------------------------------------------
+
+    IMF_EXPORT 
+    IMATH_NAMESPACE::V2f		pixelPosition (CubeMapFace face,
+				       const IMATH_NAMESPACE::Box2i &dataWindow,
+				       IMATH_NAMESPACE::V2f positionInFace);
+
+
+    //--------------------------------------------------------------
+    // Convert a 3D direction into a cube face, and a pixel position
+    // within that face.
+    //
+    // If you have a 3D direction, dir, the following code fragment
+    // finds the position, pos, of the corresponding pixel in an
+    // environment map with data window dw:
+    //
+    // CubeMapFace f;
+    // V2f pif, pos;
+    //
+    // faceAndPixelPosition (dir, dw, f, pif);
+    // pos = pixelPosition (f, dw, pif);
+    //
+    //--------------------------------------------------------------
+
+    IMF_EXPORT 
+    void		faceAndPixelPosition (const IMATH_NAMESPACE::V3f &direction,
+					      const IMATH_NAMESPACE::Box2i &dataWindow,
+					      CubeMapFace &face,
+					      IMATH_NAMESPACE::V2f &positionInFace);
+
+   
+    // --------------------------------------------------------
+    // Given a cube face and a pixel position within that face,
+    // compute the corresponding 3D direction.
+    // --------------------------------------------------------
+
+    IMF_EXPORT 
+    IMATH_NAMESPACE::V3f		direction (CubeMapFace face,
+				   const IMATH_NAMESPACE::Box2i &dataWindow,
+				   const IMATH_NAMESPACE::V2f &positionInFace);
+}
+
+
+OPENEXR_IMF_INTERNAL_NAMESPACE_HEADER_EXIT
+
+
+#endif