/////////////////////////////////////////////////////////////////////////// // // 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_DEEP_IMAGE_LEVEL_H #define INCLUDED_IMF_DEEP_IMAGE_LEVEL_H //---------------------------------------------------------------------------- // // class DeepImageLevel // class DeepImageLevel::Iterator // class DeepImageLevel::ConstIterator // // For an explanation of images, levels and channels, // see the comments in header file Image.h. // //---------------------------------------------------------------------------- #include "ImfDeepImageChannel.h" #include "ImfSampleCountChannel.h" #include "ImfImageLevel.h" #include "ImfExport.h" #include #include OPENEXR_IMF_INTERNAL_NAMESPACE_HEADER_ENTER class DeepImage; class IMF_EXPORT DeepImageLevel : public ImageLevel { public: // // Access to the image to which the level belongs. // DeepImage & deepImage (); const DeepImage & deepImage () const; // // Access to deep 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(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. // DeepImageChannel * findChannel (const std::string& name); const DeepImageChannel * findChannel (const std::string& name) const; DeepImageChannel & channel (const std::string& name); const DeepImageChannel & channel (const std::string& name) const; template TypedDeepImageChannel * findTypedChannel (const std::string& name); template const TypedDeepImageChannel * findTypedChannel (const std::string& name) const; template TypedDeepImageChannel & typedChannel (const std::string& name); template const TypedDeepImageChannel & typedChannel (const std::string& name) const; // // Iterator-style access to deep channels // typedef std::map ChannelMap; class Iterator; class ConstIterator; Iterator begin(); ConstIterator begin() const; Iterator end(); ConstIterator end() const; // // Access to the sample count channel // SampleCountChannel & sampleCounts(); const SampleCountChannel & sampleCounts() const; private: friend class DeepImage; friend class SampleCountChannel; // // The constructor and destructor are private. // Deep image levels exist only as part of a deep image. // DeepImageLevel (DeepImage& image, int xLevelNumber, int yLevelNumber, const IMATH_NAMESPACE::Box2i& dataWindow); ~DeepImageLevel (); void setSamplesToZero (size_t i, unsigned int oldNumSamples, unsigned int newNumSamples); void moveSampleList (size_t i, unsigned int oldNumSamples, unsigned int newNumSamples, size_t newSampleListPosition); void moveSamplesToNewBuffer (const unsigned int * oldNumSamples, const unsigned int * newNumSamples, const size_t * newSampleListPositions); void initializeSampleLists (); 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; SampleCountChannel _sampleCounts; }; class DeepImageLevel::Iterator { public: Iterator (); Iterator (const DeepImageLevel::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; DeepImageChannel & channel () const; private: friend class DeepImageLevel::ConstIterator; DeepImageLevel::ChannelMap::iterator _i; }; class DeepImageLevel::ConstIterator { public: ConstIterator (); ConstIterator (const DeepImageLevel::ChannelMap::const_iterator& i); ConstIterator (const DeepImageLevel::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 DeepImageChannel & channel () const; private: friend bool operator == (const ConstIterator &, const ConstIterator &); friend bool operator != (const ConstIterator &, const ConstIterator &); DeepImageLevel::ChannelMap::const_iterator _i; }; //----------------------------------------------------------------------------- // Implementation of inline functions //----------------------------------------------------------------------------- template TypedDeepImageChannel * DeepImageLevel::findTypedChannel (const std::string& name) { return dynamic_cast *> (findChannel (name)); } template const TypedDeepImageChannel * DeepImageLevel::findTypedChannel (const std::string& name) const { return dynamic_cast *> (findChannel (name)); } template TypedDeepImageChannel & DeepImageLevel::typedChannel (const std::string& name) { TypedDeepImageChannel * ptr = findTypedChannel (name); if (ptr == 0) throwBadChannelNameOrType (name); return *ptr; } template const TypedDeepImageChannel & DeepImageLevel::typedChannel (const std::string& name) const { const TypedDeepImageChannel * ptr = findTypedChannel (name); if (ptr == 0) throwBadChannelNameOrType (name); return *ptr; } inline SampleCountChannel & DeepImageLevel::sampleCounts () { return _sampleCounts; } inline const SampleCountChannel & DeepImageLevel::sampleCounts () const { return _sampleCounts; } inline DeepImageLevel::Iterator::Iterator (): _i() { // empty } inline DeepImageLevel::Iterator::Iterator (const DeepImageLevel::ChannelMap::iterator& i) : _i (i) { // empty } inline DeepImageLevel::Iterator & DeepImageLevel::Iterator::operator ++ () { ++_i; return *this; } inline DeepImageLevel::Iterator DeepImageLevel::Iterator::operator ++ (int) { Iterator tmp = *this; ++_i; return tmp; } inline const std::string & DeepImageLevel::Iterator::name () const { return _i->first; } inline DeepImageChannel & DeepImageLevel::Iterator::channel () const { return *_i->second; } inline DeepImageLevel::ConstIterator::ConstIterator (): _i() { // empty } inline DeepImageLevel::ConstIterator::ConstIterator (const DeepImageLevel::ChannelMap::const_iterator& i): _i (i) { // empty } inline DeepImageLevel::ConstIterator::ConstIterator (const DeepImageLevel::Iterator& other): _i (other._i) { // empty } inline DeepImageLevel::ConstIterator & DeepImageLevel::ConstIterator::operator ++ () { ++_i; return *this; } inline DeepImageLevel::ConstIterator DeepImageLevel::ConstIterator::operator ++ (int) { ConstIterator tmp = *this; ++_i; return tmp; } inline const std::string & DeepImageLevel::ConstIterator::name () const { return _i->first; } inline const DeepImageChannel & DeepImageLevel::ConstIterator::channel () const { return *_i->second; } inline bool operator == (const DeepImageLevel::ConstIterator& x, const DeepImageLevel::ConstIterator& y) { return x._i == y._i; } inline bool operator != (const DeepImageLevel::ConstIterator& x, const DeepImageLevel::ConstIterator& y) { return !(x == y); } OPENEXR_IMF_INTERNAL_NAMESPACE_HEADER_EXIT #endif