OXIESEC PANEL

Name	Size	Modified	Perms
📁 ..	-	10/28/2024 06:50:42 AM	rwxr-xr-x
📄 Iex.h	2.34 KB	04/16/2016 12:51:59 AM	rw-r--r--
📄 IexBaseExc.h	9.06 KB	04/16/2016 12:51:59 AM	rw-r--r--
📄 IexErrnoExc.h	7.37 KB	04/16/2016 12:51:59 AM	rw-r--r--
📄 IexExport.h	2.08 KB	04/16/2016 12:51:59 AM	rw-r--r--
📄 IexForward.h	5.1 KB	04/16/2016 12:51:59 AM	rw-r--r--
📄 IexMacros.h	5.63 KB	04/16/2016 12:51:59 AM	rw-r--r--
📄 IexMathExc.h	2.41 KB	04/16/2016 12:51:59 AM	rw-r--r--
📄 IexMathFloatExc.h	4.58 KB	04/16/2016 12:51:59 AM	rw-r--r--
📄 IexMathFpu.h	3.3 KB	04/16/2016 12:51:59 AM	rw-r--r--
📄 IexMathIeeeExc.h	2.3 KB	04/16/2016 12:51:59 AM	rw-r--r--
📄 IexNamespace.h	4.3 KB	04/16/2016 12:51:59 AM	rw-r--r--
📄 IexThrowErrnoExc.h	3.4 KB	04/16/2016 12:51:59 AM	rw-r--r--
📄 IlmBaseConfig.h	1.64 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 IlmThread.h	4.78 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 IlmThreadExport.h	2.15 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 IlmThreadForward.h	2.08 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 IlmThreadMutex.h	4.32 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 IlmThreadNamespace.h	4.54 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 IlmThreadPool.h	5.21 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 IlmThreadSemaphore.h	3.38 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathBox.h	16.62 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathBoxAlgo.h	22.35 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathColor.h	14.87 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathColorAlgo.h	7.08 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathEuler.h	22.88 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathExc.h	2.82 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathExport.h	2.13 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathForward.h	2.68 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathFrame.h	6.6 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathFrustum.h	22.26 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathFrustumTest.h	14.77 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathFun.h	5.99 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathGL.h	4.52 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathGLU.h	2.17 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathHalfLimits.h	2.47 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathInt64.h	2.4 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathInterval.h	5.34 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathLimits.h	7.76 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathLine.h	4.74 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathLineAlgo.h	7.68 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathMath.h	7.17 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathMatrix.h	82.42 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathMatrixAlgo.h	37.97 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathNamespace.h	4.38 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathPlane.h	6.75 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathPlatform.h	3.23 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathQuat.h	20.94 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathRandom.h	9.84 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathRoots.h	5.62 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathShear.h	13.85 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathSphere.h	4.68 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathVec.h	44.17 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImathVecAlgo.h	4.64 KB	04/16/2016 12:52:00 AM	rw-r--r--
📄 ImfAcesFile.h	10.27 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfArray.h	6.79 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfAttribute.h	10.36 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfB44Compressor.h	3.67 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfBoxAttribute.h	3.1 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfCRgbaFile.h	12.5 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfChannelList.h	11.2 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfChannelListAttribute.h	2.69 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfChromaticities.h	4.45 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfChromaticitiesAttribute.h	2.74 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfCompositeDeepScanLine.h	5.38 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfCompression.h	3.25 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfCompressionAttribute.h	2.71 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfConvert.h	3.39 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfDeepCompositing.h	5.97 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfDeepFrameBuffer.h	8.79 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfDeepImageState.h	3.67 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfDeepImageStateAttribute.h	2.64 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfDeepScanLineInputFile.h	11.01 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfDeepScanLineInputPart.h	6.9 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfDeepScanLineOutputFile.h	9.37 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfDeepScanLineOutputPart.h	6.41 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfDeepTiledInputFile.h	16.08 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfDeepTiledInputPart.h	13.27 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfDeepTiledOutputFile.h	18.1 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfDeepTiledOutputPart.h	14.83 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfDoubleAttribute.h	2.29 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfEnvmap.h	11.29 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfEnvmapAttribute.h	2.67 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfExport.h	2.11 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfFloatAttribute.h	2.26 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfForward.h	3.48 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfFrameBuffer.h	11.18 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfFramesPerSecond.h	3.79 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfGenericInputFile.h	2.26 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfGenericOutputFile.h	2.44 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfHeader.h	19.27 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfHuf.h	2.86 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfIO.h	7.45 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfInputFile.h	8.28 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfInputPart.h	3.52 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfInt64.h	2.24 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfIntAttribute.h	2.27 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfKeyCode.h	4.9 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfKeyCodeAttribute.h	2.65 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfLineOrder.h	2.42 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfLineOrderAttribute.h	2.67 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfLut.h	5.12 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfMatrixAttribute.h	3.65 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfMisc.h	16.33 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfMultiPartInputFile.h	3.94 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfMultiPartOutputFile.h	4.29 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfMultiView.h	6.29 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfName.h	3.52 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfNamespace.h	4.46 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfOpaqueAttribute.h	3.55 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfOutputFile.h	9.66 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfOutputPart.h	3.04 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfPartHelper.h	7.66 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfPartType.h	2.38 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfPixelType.h	2.34 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfPreviewImage.h	4.65 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfPreviewImageAttribute.h	2.68 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfRational.h	3.17 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfRationalAttribute.h	2.63 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfRgba.h	3.08 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfRgbaFile.h	13.09 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfRgbaYca.h	8.21 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfStandardAttributes.h	13.26 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfStringAttribute.h	2.58 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfStringVectorAttribute.h	2.7 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfTestFile.h	3.55 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfThreading.h	4.24 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfTileDescription.h	3.13 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfTileDescriptionAttribute.h	2.7 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfTiledInputFile.h	13.82 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfTiledInputPart.h	4.55 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfTiledOutputFile.h	17.83 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfTiledOutputPart.h	4.75 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfTiledRgbaFile.h	15.89 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfTimeCode.h	7 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfTimeCodeAttribute.h	2.64 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfVecAttribute.h	4.45 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfVersion.h	4.64 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfWav.h	2.73 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 ImfXdr.h	18.74 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 OpenEXRConfig.h	1.8 KB	11/16/2021 03:51:38 PM	rw-r--r--
📄 half.h	17.22 KB	04/16/2016 12:51:59 AM	rw-r--r--
📄 halfExport.h	757 bytes	04/16/2016 12:51:59 AM	rw-r--r--
📄 halfFunction.h	4.83 KB	04/16/2016 12:51:59 AM	rw-r--r--
📄 halfLimits.h	3.73 KB	04/16/2016 12:51:59 AM	rw-r--r--

Editing: ImfEnvmap.h

///////////////////////////////////////////////////////////////////////////
//
// 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