399 lines
9.9 KiB
C++
399 lines
9.9 KiB
C++
///////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// Copyright (c) 2014, 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_FLAT_IMAGE_LEVEL_H
|
|
#define INCLUDED_IMF_FLAT_IMAGE_LEVEL_H
|
|
|
|
//----------------------------------------------------------------------------
|
|
//
|
|
// class FlatImageLevel
|
|
// class FlatImageLevel::Iterator
|
|
// class FlatImageLevel::ConstIterator
|
|
//
|
|
// For an explanation of images, levels and channels,
|
|
// see the comments in header file Image.h.
|
|
//
|
|
//----------------------------------------------------------------------------
|
|
|
|
#include <ImfFlatImageChannel.h>
|
|
#include <ImfImageLevel.h>
|
|
#include <ImathBox.h>
|
|
#include <string>
|
|
#include <map>
|
|
#include "ImfExport.h"
|
|
|
|
OPENEXR_IMF_INTERNAL_NAMESPACE_HEADER_ENTER
|
|
|
|
class FlatImage;
|
|
|
|
class IMF_EXPORT FlatImageLevel : public ImageLevel
|
|
{
|
|
public:
|
|
|
|
//
|
|
// Access to the flat image to which the level belongs.
|
|
//
|
|
|
|
FlatImage & flatImage();
|
|
const FlatImage & flatImage() const;
|
|
|
|
|
|
|
|
//
|
|
// Accessing channels by name:
|
|
//
|
|
// findChannel(n) returns a pointer to the image channel with
|
|
// name n, or 0 if no such channel exists.
|
|
//
|
|
// channel(n) returns a reference to the image channel with
|
|
// name n, or throws an Iex::ArgExc exception if
|
|
// no such channel exists.
|
|
//
|
|
// findTypedChannel<T>(n) returns a pointer to the image channel with
|
|
// name n and type T, or 0 if no such channel
|
|
// exists.
|
|
//
|
|
// typedChannel(n) returns a reference to the image channel with
|
|
// name n and type T, or throws an Iex::ArgExc
|
|
// exception if no such channel exists.
|
|
//
|
|
|
|
FlatImageChannel * findChannel (const std::string& name);
|
|
const FlatImageChannel * findChannel (const std::string& name) const;
|
|
|
|
FlatImageChannel & channel (const std::string& name);
|
|
const FlatImageChannel & channel (const std::string& name) const;
|
|
|
|
template <class T>
|
|
TypedFlatImageChannel<T> * findTypedChannel
|
|
(const std::string& name);
|
|
|
|
template <class T>
|
|
const TypedFlatImageChannel<T> * findTypedChannel
|
|
(const std::string& name) const;
|
|
|
|
template <class T>
|
|
TypedFlatImageChannel<T> & typedChannel
|
|
(const std::string& name);
|
|
|
|
template <class T>
|
|
const TypedFlatImageChannel<T> & typedChannel
|
|
(const std::string& name) const;
|
|
|
|
//
|
|
// Iterator-style access to channels
|
|
//
|
|
|
|
typedef std::map <std::string, FlatImageChannel *> ChannelMap;
|
|
|
|
class Iterator;
|
|
class ConstIterator;
|
|
|
|
Iterator begin();
|
|
ConstIterator begin() const;
|
|
|
|
Iterator end();
|
|
ConstIterator end() const;
|
|
|
|
private:
|
|
|
|
friend class FlatImage;
|
|
|
|
//
|
|
// The constructor and destructor are private.
|
|
// Image levels exist only as part of an image.
|
|
//
|
|
|
|
FlatImageLevel (FlatImage& image,
|
|
int xLevelNumber,
|
|
int yLevelNumber,
|
|
const IMATH_NAMESPACE::Box2i& dataWindow);
|
|
|
|
virtual ~FlatImageLevel ();
|
|
|
|
virtual void resize (const IMATH_NAMESPACE::Box2i& dataWindow);
|
|
|
|
virtual void shiftPixels (int dx, int dy);
|
|
|
|
virtual void insertChannel (const std::string& name,
|
|
PixelType type,
|
|
int xSampling,
|
|
int ySampling,
|
|
bool pLinear);
|
|
|
|
virtual void eraseChannel (const std::string& name);
|
|
|
|
virtual void clearChannels ();
|
|
|
|
virtual void renameChannel (const std::string &oldName,
|
|
const std::string &newName);
|
|
|
|
virtual void renameChannels (const RenamingMap &oldToNewNames);
|
|
|
|
ChannelMap _channels;
|
|
};
|
|
|
|
|
|
class FlatImageLevel::Iterator
|
|
{
|
|
public:
|
|
|
|
Iterator ();
|
|
Iterator (const FlatImageLevel::ChannelMap::iterator& i);
|
|
|
|
|
|
//
|
|
// Advance the iterator
|
|
//
|
|
|
|
Iterator & operator ++ ();
|
|
Iterator operator ++ (int);
|
|
|
|
|
|
//
|
|
// Access to the channel to which the iterator points,
|
|
// and to the name of that channel.
|
|
//
|
|
|
|
const std::string & name () const;
|
|
FlatImageChannel & channel () const;
|
|
|
|
private:
|
|
|
|
friend class FlatImageLevel::ConstIterator;
|
|
|
|
FlatImageLevel::ChannelMap::iterator _i;
|
|
};
|
|
|
|
|
|
class FlatImageLevel::ConstIterator
|
|
{
|
|
public:
|
|
|
|
ConstIterator ();
|
|
ConstIterator (const FlatImageLevel::ChannelMap::const_iterator& i);
|
|
ConstIterator (const FlatImageLevel::Iterator& other);
|
|
|
|
|
|
//
|
|
// Advance the iterator
|
|
//
|
|
|
|
ConstIterator & operator ++ ();
|
|
ConstIterator operator ++ (int);
|
|
|
|
|
|
//
|
|
// Access to the channel to which the iterator points,
|
|
// and to the name of that channel.
|
|
//
|
|
|
|
const std::string & name () const;
|
|
const FlatImageChannel & channel () const;
|
|
|
|
private:
|
|
|
|
friend bool operator ==
|
|
(const ConstIterator &, const ConstIterator &);
|
|
|
|
friend bool operator !=
|
|
(const ConstIterator &, const ConstIterator &);
|
|
|
|
FlatImageLevel::ChannelMap::const_iterator _i;
|
|
};
|
|
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// Implementation of templates and inline functions
|
|
//-----------------------------------------------------------------------------
|
|
|
|
|
|
template <class T>
|
|
TypedFlatImageChannel<T> *
|
|
FlatImageLevel::findTypedChannel (const std::string& name)
|
|
{
|
|
return dynamic_cast <TypedFlatImageChannel<T>*> (findChannel (name));
|
|
}
|
|
|
|
|
|
template <class T>
|
|
const TypedFlatImageChannel<T> *
|
|
FlatImageLevel::findTypedChannel (const std::string& name) const
|
|
{
|
|
return dynamic_cast <const TypedFlatImageChannel<T>*> (findChannel (name));
|
|
}
|
|
|
|
|
|
template <class T>
|
|
TypedFlatImageChannel<T> &
|
|
FlatImageLevel::typedChannel (const std::string& name)
|
|
{
|
|
TypedFlatImageChannel<T> * ptr = findTypedChannel<T> (name);
|
|
|
|
if (ptr == 0)
|
|
throwBadChannelNameOrType (name);
|
|
|
|
return *ptr;
|
|
}
|
|
|
|
|
|
template <class T>
|
|
const TypedFlatImageChannel<T> &
|
|
FlatImageLevel::typedChannel (const std::string& name) const
|
|
{
|
|
const TypedFlatImageChannel<T> * ptr = findTypedChannel<T> (name);
|
|
|
|
if (ptr == 0)
|
|
throwBadChannelNameOrType (name);
|
|
|
|
return *ptr;
|
|
}
|
|
|
|
|
|
inline
|
|
FlatImageLevel::Iterator::Iterator (): _i()
|
|
{
|
|
// empty
|
|
}
|
|
|
|
|
|
inline
|
|
FlatImageLevel::Iterator::Iterator (const FlatImageLevel::ChannelMap::iterator& i):
|
|
_i (i)
|
|
{
|
|
// empty
|
|
}
|
|
|
|
|
|
inline FlatImageLevel::Iterator &
|
|
FlatImageLevel::Iterator::operator ++ ()
|
|
{
|
|
++_i;
|
|
return *this;
|
|
}
|
|
|
|
|
|
inline FlatImageLevel::Iterator
|
|
FlatImageLevel::Iterator::operator ++ (int)
|
|
{
|
|
Iterator tmp = *this;
|
|
++_i;
|
|
return tmp;
|
|
}
|
|
|
|
|
|
inline const std::string &
|
|
FlatImageLevel::Iterator::name () const
|
|
{
|
|
return _i->first;
|
|
}
|
|
|
|
|
|
inline FlatImageChannel &
|
|
FlatImageLevel::Iterator::channel () const
|
|
{
|
|
return *_i->second;
|
|
}
|
|
|
|
|
|
inline
|
|
FlatImageLevel::ConstIterator::ConstIterator (): _i()
|
|
{
|
|
// empty
|
|
}
|
|
|
|
inline
|
|
FlatImageLevel::ConstIterator::ConstIterator
|
|
(const FlatImageLevel::ChannelMap::const_iterator& i): _i (i)
|
|
{
|
|
// empty
|
|
}
|
|
|
|
|
|
inline
|
|
FlatImageLevel::ConstIterator::ConstIterator
|
|
(const FlatImageLevel::Iterator& other): _i (other._i)
|
|
{
|
|
// empty
|
|
}
|
|
|
|
inline FlatImageLevel::ConstIterator &
|
|
FlatImageLevel::ConstIterator::operator ++ ()
|
|
{
|
|
++_i;
|
|
return *this;
|
|
}
|
|
|
|
|
|
inline FlatImageLevel::ConstIterator
|
|
FlatImageLevel::ConstIterator::operator ++ (int)
|
|
{
|
|
ConstIterator tmp = *this;
|
|
++_i;
|
|
return tmp;
|
|
}
|
|
|
|
|
|
inline const std::string &
|
|
FlatImageLevel::ConstIterator::name () const
|
|
{
|
|
return _i->first;
|
|
}
|
|
|
|
inline const FlatImageChannel &
|
|
FlatImageLevel::ConstIterator::channel () const
|
|
{
|
|
return *_i->second;
|
|
}
|
|
|
|
|
|
inline bool
|
|
operator == (const FlatImageLevel::ConstIterator& x,
|
|
const FlatImageLevel::ConstIterator& y)
|
|
{
|
|
return x._i == y._i;
|
|
}
|
|
|
|
|
|
inline bool
|
|
operator != (const FlatImageLevel::ConstIterator& x,
|
|
const FlatImageLevel::ConstIterator& y)
|
|
{
|
|
return !(x == y);
|
|
}
|
|
|
|
OPENEXR_IMF_INTERNAL_NAMESPACE_HEADER_EXIT
|
|
|
|
#endif
|