|
Packit Service |
6754ca |
///////////////////////////////////////////////////////////////////////////
|
|
Packit Service |
6754ca |
//
|
|
Packit Service |
6754ca |
// Copyright (c) 2002, Industrial Light & Magic, a division of Lucas
|
|
Packit Service |
6754ca |
// Digital Ltd. LLC
|
|
Packit Service |
6754ca |
//
|
|
Packit Service |
6754ca |
// All rights reserved.
|
|
Packit Service |
6754ca |
//
|
|
Packit Service |
6754ca |
// Redistribution and use in source and binary forms, with or without
|
|
Packit Service |
6754ca |
// modification, are permitted provided that the following conditions are
|
|
Packit Service |
6754ca |
// met:
|
|
Packit Service |
6754ca |
// * Redistributions of source code must retain the above copyright
|
|
Packit Service |
6754ca |
// notice, this list of conditions and the following disclaimer.
|
|
Packit Service |
6754ca |
// * Redistributions in binary form must reproduce the above
|
|
Packit Service |
6754ca |
// copyright notice, this list of conditions and the following disclaimer
|
|
Packit Service |
6754ca |
// in the documentation and/or other materials provided with the
|
|
Packit Service |
6754ca |
// distribution.
|
|
Packit Service |
6754ca |
// * Neither the name of Industrial Light & Magic nor the names of
|
|
Packit Service |
6754ca |
// its contributors may be used to endorse or promote products derived
|
|
Packit Service |
6754ca |
// from this software without specific prior written permission.
|
|
Packit Service |
6754ca |
//
|
|
Packit Service |
6754ca |
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
Packit Service |
6754ca |
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
Packit Service |
6754ca |
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
|
Packit Service |
6754ca |
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
|
Packit Service |
6754ca |
// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
Packit Service |
6754ca |
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
|
Packit Service |
6754ca |
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
Packit Service |
6754ca |
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
Packit Service |
6754ca |
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
Packit Service |
6754ca |
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
Packit Service |
6754ca |
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
Packit Service |
6754ca |
//
|
|
Packit Service |
6754ca |
///////////////////////////////////////////////////////////////////////////
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
#ifndef INCLUDED_IMF_FRAME_BUFFER_H
|
|
Packit Service |
6754ca |
#define INCLUDED_IMF_FRAME_BUFFER_H
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
//-----------------------------------------------------------------------------
|
|
Packit Service |
6754ca |
//
|
|
Packit Service |
6754ca |
// class Slice
|
|
Packit Service |
6754ca |
// class FrameBuffer
|
|
Packit Service |
6754ca |
//
|
|
Packit Service |
6754ca |
//-----------------------------------------------------------------------------
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
#include "ImfName.h"
|
|
Packit Service |
6754ca |
#include "ImfPixelType.h"
|
|
Packit Service |
6754ca |
#include "ImfExport.h"
|
|
Packit Service |
6754ca |
#include "ImfNamespace.h"
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
#include <map>
|
|
Packit Service |
6754ca |
#include <string>
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
OPENEXR_IMF_INTERNAL_NAMESPACE_HEADER_ENTER
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
//-------------------------------------------------------
|
|
Packit Service |
6754ca |
// Description of a single slice of the frame buffer:
|
|
Packit Service |
6754ca |
//
|
|
Packit Service |
6754ca |
// Note -- terminology: as part of a file, a component of
|
|
Packit Service |
6754ca |
// an image (e.g. red, green, blue, depth etc.) is called
|
|
Packit Service |
6754ca |
// a "channel". As part of a frame buffer, an image
|
|
Packit Service |
6754ca |
// component is called a "slice".
|
|
Packit Service |
6754ca |
//-------------------------------------------------------
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
struct IMF_EXPORT Slice
|
|
Packit Service |
6754ca |
{
|
|
Packit Service |
6754ca |
//------------------------------
|
|
Packit Service |
6754ca |
// Data type; see ImfPixelType.h
|
|
Packit Service |
6754ca |
//------------------------------
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
PixelType type;
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
//---------------------------------------------------------------------
|
|
Packit Service |
6754ca |
// Memory layout: The address of pixel (x, y) is
|
|
Packit Service |
6754ca |
//
|
|
Packit Service |
6754ca |
// base + (xp / xSampling) * xStride + (yp / ySampling) * yStride
|
|
Packit Service |
6754ca |
//
|
|
Packit Service |
6754ca |
// where xp and yp are computed as follows:
|
|
Packit Service |
6754ca |
//
|
|
Packit Service |
6754ca |
// * If we are reading or writing a scanline-based file:
|
|
Packit Service |
6754ca |
//
|
|
Packit Service |
6754ca |
// xp = x
|
|
Packit Service |
6754ca |
// yp = y
|
|
Packit Service |
6754ca |
//
|
|
Packit Service |
6754ca |
// * If we are reading a tile whose upper left coorner is at (xt, yt):
|
|
Packit Service |
6754ca |
//
|
|
Packit Service |
6754ca |
// if xTileCoords is true then xp = x - xt, else xp = x
|
|
Packit Service |
6754ca |
// if yTileCoords is true then yp = y - yt, else yp = y
|
|
Packit Service |
6754ca |
//
|
|
Packit Service |
6754ca |
//---------------------------------------------------------------------
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
char * base;
|
|
Packit Service |
6754ca |
size_t xStride;
|
|
Packit Service |
6754ca |
size_t yStride;
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
//--------------------------------------------
|
|
Packit Service |
6754ca |
// Subsampling: pixel (x, y) is present in the
|
|
Packit Service |
6754ca |
// slice only if
|
|
Packit Service |
6754ca |
//
|
|
Packit Service |
6754ca |
// x % xSampling == 0 && y % ySampling == 0
|
|
Packit Service |
6754ca |
//
|
|
Packit Service |
6754ca |
//--------------------------------------------
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
int xSampling;
|
|
Packit Service |
6754ca |
int ySampling;
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
//----------------------------------------------------------
|
|
Packit Service |
6754ca |
// Default value, used to fill the slice when a file without
|
|
Packit Service |
6754ca |
// a channel that corresponds to this slice is read.
|
|
Packit Service |
6754ca |
//----------------------------------------------------------
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
double fillValue;
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
//-------------------------------------------------------
|
|
Packit Service |
6754ca |
// For tiled files, the xTileCoords and yTileCoords flags
|
|
Packit Service |
6754ca |
// determine whether pixel addressing is performed using
|
|
Packit Service |
6754ca |
// absolute coordinates or coordinates relative to a
|
|
Packit Service |
6754ca |
// tile's upper left corner. (See the comment on base,
|
|
Packit Service |
6754ca |
// xStride and yStride, above.)
|
|
Packit Service |
6754ca |
//
|
|
Packit Service |
6754ca |
// For scanline-based files these flags have no effect;
|
|
Packit Service |
6754ca |
// pixel addressing is always done using absolute
|
|
Packit Service |
6754ca |
// coordinates.
|
|
Packit Service |
6754ca |
//-------------------------------------------------------
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
bool xTileCoords;
|
|
Packit Service |
6754ca |
bool yTileCoords;
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
//------------
|
|
Packit Service |
6754ca |
// Constructor
|
|
Packit Service |
6754ca |
//------------
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
Slice (PixelType type = HALF,
|
|
Packit Service |
6754ca |
char * base = 0,
|
|
Packit Service |
6754ca |
size_t xStride = 0,
|
|
Packit Service |
6754ca |
size_t yStride = 0,
|
|
Packit Service |
6754ca |
int xSampling = 1,
|
|
Packit Service |
6754ca |
int ySampling = 1,
|
|
Packit Service |
6754ca |
double fillValue = 0.0,
|
|
Packit Service |
6754ca |
bool xTileCoords = false,
|
|
Packit Service |
6754ca |
bool yTileCoords = false);
|
|
Packit Service |
6754ca |
};
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
class IMF_EXPORT FrameBuffer
|
|
Packit Service |
6754ca |
{
|
|
Packit Service |
6754ca |
public:
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
//------------
|
|
Packit Service |
6754ca |
// Add a slice
|
|
Packit Service |
6754ca |
//------------
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
void insert (const char name[],
|
|
Packit Service |
6754ca |
const Slice &slice);
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
void insert (const std::string &name,
|
|
Packit Service |
6754ca |
const Slice &slice);
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
//----------------------------------------------------------------
|
|
Packit Service |
6754ca |
// Access to existing slices:
|
|
Packit Service |
6754ca |
//
|
|
Packit Service |
6754ca |
// [n] Returns a reference to the slice with name n.
|
|
Packit Service |
6754ca |
// If no slice with name n exists, an IEX_NAMESPACE::ArgExc
|
|
Packit Service |
6754ca |
// is thrown.
|
|
Packit Service |
6754ca |
//
|
|
Packit Service |
6754ca |
// findSlice(n) Returns a pointer to the slice with name n,
|
|
Packit Service |
6754ca |
// or 0 if no slice with name n exists.
|
|
Packit Service |
6754ca |
//
|
|
Packit Service |
6754ca |
//----------------------------------------------------------------
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
Slice & operator [] (const char name[]);
|
|
Packit Service |
6754ca |
const Slice & operator [] (const char name[]) const;
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
Slice & operator [] (const std::string &name);
|
|
Packit Service |
6754ca |
const Slice & operator [] (const std::string &name) const;
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
Slice * findSlice (const char name[]);
|
|
Packit Service |
6754ca |
const Slice * findSlice (const char name[]) const;
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
Slice * findSlice (const std::string &name);
|
|
Packit Service |
6754ca |
const Slice * findSlice (const std::string &name) const;
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
//-----------------------------------------
|
|
Packit Service |
6754ca |
// Iterator-style access to existing slices
|
|
Packit Service |
6754ca |
//-----------------------------------------
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
typedef std::map <Name, Slice> SliceMap;
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
class Iterator;
|
|
Packit Service |
6754ca |
class ConstIterator;
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
Iterator begin ();
|
|
Packit Service |
6754ca |
ConstIterator begin () const;
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
Iterator end ();
|
|
Packit Service |
6754ca |
ConstIterator end () const;
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
Iterator find (const char name[]);
|
|
Packit Service |
6754ca |
ConstIterator find (const char name[]) const;
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
Iterator find (const std::string &name);
|
|
Packit Service |
6754ca |
ConstIterator find (const std::string &name) const;
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
private:
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
SliceMap _map;
|
|
Packit Service |
6754ca |
};
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
//----------
|
|
Packit Service |
6754ca |
// Iterators
|
|
Packit Service |
6754ca |
//----------
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
class FrameBuffer::Iterator
|
|
Packit Service |
6754ca |
{
|
|
Packit Service |
6754ca |
public:
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
Iterator ();
|
|
Packit Service |
6754ca |
Iterator (const FrameBuffer::SliceMap::iterator &i);
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
Iterator & operator ++ ();
|
|
Packit Service |
6754ca |
Iterator operator ++ (int);
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
const char * name () const;
|
|
Packit Service |
6754ca |
Slice & slice () const;
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
private:
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
friend class FrameBuffer::ConstIterator;
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
FrameBuffer::SliceMap::iterator _i;
|
|
Packit Service |
6754ca |
};
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
class FrameBuffer::ConstIterator
|
|
Packit Service |
6754ca |
{
|
|
Packit Service |
6754ca |
public:
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
ConstIterator ();
|
|
Packit Service |
6754ca |
ConstIterator (const FrameBuffer::SliceMap::const_iterator &i);
|
|
Packit Service |
6754ca |
ConstIterator (const FrameBuffer::Iterator &other);
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
ConstIterator & operator ++ ();
|
|
Packit Service |
6754ca |
ConstIterator operator ++ (int);
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
const char * name () const;
|
|
Packit Service |
6754ca |
const Slice & slice () const;
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
private:
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
friend bool operator == (const ConstIterator &, const ConstIterator &);
|
|
Packit Service |
6754ca |
friend bool operator != (const ConstIterator &, const ConstIterator &);
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
FrameBuffer::SliceMap::const_iterator _i;
|
|
Packit Service |
6754ca |
};
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
//-----------------
|
|
Packit Service |
6754ca |
// Inline Functions
|
|
Packit Service |
6754ca |
//-----------------
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
inline
|
|
Packit Service |
6754ca |
FrameBuffer::Iterator::Iterator (): _i()
|
|
Packit Service |
6754ca |
{
|
|
Packit Service |
6754ca |
// empty
|
|
Packit Service |
6754ca |
}
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
inline
|
|
Packit Service |
6754ca |
FrameBuffer::Iterator::Iterator (const FrameBuffer::SliceMap::iterator &i):
|
|
Packit Service |
6754ca |
_i (i)
|
|
Packit Service |
6754ca |
{
|
|
Packit Service |
6754ca |
// empty
|
|
Packit Service |
6754ca |
}
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
inline FrameBuffer::Iterator &
|
|
Packit Service |
6754ca |
FrameBuffer::Iterator::operator ++ ()
|
|
Packit Service |
6754ca |
{
|
|
Packit Service |
6754ca |
++_i;
|
|
Packit Service |
6754ca |
return *this;
|
|
Packit Service |
6754ca |
}
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
inline FrameBuffer::Iterator
|
|
Packit Service |
6754ca |
FrameBuffer::Iterator::operator ++ (int)
|
|
Packit Service |
6754ca |
{
|
|
Packit Service |
6754ca |
Iterator tmp = *this;
|
|
Packit Service |
6754ca |
++_i;
|
|
Packit Service |
6754ca |
return tmp;
|
|
Packit Service |
6754ca |
}
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
inline const char *
|
|
Packit Service |
6754ca |
FrameBuffer::Iterator::name () const
|
|
Packit Service |
6754ca |
{
|
|
Packit Service |
6754ca |
return *_i->first;
|
|
Packit Service |
6754ca |
}
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
inline Slice &
|
|
Packit Service |
6754ca |
FrameBuffer::Iterator::slice () const
|
|
Packit Service |
6754ca |
{
|
|
Packit Service |
6754ca |
return _i->second;
|
|
Packit Service |
6754ca |
}
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
inline
|
|
Packit Service |
6754ca |
FrameBuffer::ConstIterator::ConstIterator (): _i()
|
|
Packit Service |
6754ca |
{
|
|
Packit Service |
6754ca |
// empty
|
|
Packit Service |
6754ca |
}
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
inline
|
|
Packit Service |
6754ca |
FrameBuffer::ConstIterator::ConstIterator
|
|
Packit Service |
6754ca |
(const FrameBuffer::SliceMap::const_iterator &i): _i (i)
|
|
Packit Service |
6754ca |
{
|
|
Packit Service |
6754ca |
// empty
|
|
Packit Service |
6754ca |
}
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
inline
|
|
Packit Service |
6754ca |
FrameBuffer::ConstIterator::ConstIterator (const FrameBuffer::Iterator &other):
|
|
Packit Service |
6754ca |
_i (other._i)
|
|
Packit Service |
6754ca |
{
|
|
Packit Service |
6754ca |
// empty
|
|
Packit Service |
6754ca |
}
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
inline FrameBuffer::ConstIterator &
|
|
Packit Service |
6754ca |
FrameBuffer::ConstIterator::operator ++ ()
|
|
Packit Service |
6754ca |
{
|
|
Packit Service |
6754ca |
++_i;
|
|
Packit Service |
6754ca |
return *this;
|
|
Packit Service |
6754ca |
}
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
inline FrameBuffer::ConstIterator
|
|
Packit Service |
6754ca |
FrameBuffer::ConstIterator::operator ++ (int)
|
|
Packit Service |
6754ca |
{
|
|
Packit Service |
6754ca |
ConstIterator tmp = *this;
|
|
Packit Service |
6754ca |
++_i;
|
|
Packit Service |
6754ca |
return tmp;
|
|
Packit Service |
6754ca |
}
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
inline const char *
|
|
Packit Service |
6754ca |
FrameBuffer::ConstIterator::name () const
|
|
Packit Service |
6754ca |
{
|
|
Packit Service |
6754ca |
return *_i->first;
|
|
Packit Service |
6754ca |
}
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
inline const Slice &
|
|
Packit Service |
6754ca |
FrameBuffer::ConstIterator::slice () const
|
|
Packit Service |
6754ca |
{
|
|
Packit Service |
6754ca |
return _i->second;
|
|
Packit Service |
6754ca |
}
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
inline bool
|
|
Packit Service |
6754ca |
operator == (const FrameBuffer::ConstIterator &x,
|
|
Packit Service |
6754ca |
const FrameBuffer::ConstIterator &y)
|
|
Packit Service |
6754ca |
{
|
|
Packit Service |
6754ca |
return x._i == y._i;
|
|
Packit Service |
6754ca |
}
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
inline bool
|
|
Packit Service |
6754ca |
operator != (const FrameBuffer::ConstIterator &x,
|
|
Packit Service |
6754ca |
const FrameBuffer::ConstIterator &y)
|
|
Packit Service |
6754ca |
{
|
|
Packit Service |
6754ca |
return !(x == y);
|
|
Packit Service |
6754ca |
}
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
OPENEXR_IMF_INTERNAL_NAMESPACE_HEADER_EXIT
|
|
Packit Service |
6754ca |
|
|
Packit Service |
6754ca |
#endif
|