Blame IlmImf/ImfMultiView.cpp

Packit 0d464f
///////////////////////////////////////////////////////////////////////////
Packit 0d464f
//
Packit 0d464f
// Copyright (c) 2007, Weta Digital Ltd
Packit 0d464f
// 
Packit 0d464f
// All rights reserved.
Packit 0d464f
// 
Packit 0d464f
// Redistribution and use in source and binary forms, with or without
Packit 0d464f
// modification, are permitted provided that the following conditions are
Packit 0d464f
// met:
Packit 0d464f
// *       Redistributions of source code must retain the above copyright
Packit 0d464f
// notice, this list of conditions and the following disclaimer.
Packit 0d464f
// *       Redistributions in binary form must reproduce the above
Packit 0d464f
// copyright notice, this list of conditions and the following disclaimer
Packit 0d464f
// in the documentation and/or other materials provided with the
Packit 0d464f
// distribution.
Packit 0d464f
// *       Neither the name of Weta Digital nor the names of
Packit 0d464f
// its contributors may be used to endorse or promote products derived
Packit 0d464f
// from this software without specific prior written permission. 
Packit 0d464f
// 
Packit 0d464f
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
Packit 0d464f
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
Packit 0d464f
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
Packit 0d464f
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
Packit 0d464f
// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
Packit 0d464f
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
Packit 0d464f
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
Packit 0d464f
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
Packit 0d464f
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
Packit 0d464f
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
Packit 0d464f
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Packit 0d464f
//
Packit 0d464f
///////////////////////////////////////////////////////////////////////////
Packit 0d464f
Packit 0d464f
//-----------------------------------------------------------------------------
Packit 0d464f
//
Packit 0d464f
//	Functions related to accessing channels
Packit 0d464f
//	and views in multi-view OpenEXR files.
Packit 0d464f
//
Packit 0d464f
//-----------------------------------------------------------------------------
Packit 0d464f
Packit 0d464f
#include <ImfMultiView.h>
Packit 0d464f
Packit 0d464f
using namespace std;
Packit 0d464f
#include "ImfNamespace.h"
Packit 0d464f
Packit 0d464f
OPENEXR_IMF_INTERNAL_NAMESPACE_SOURCE_ENTER
Packit 0d464f
Packit 0d464f
namespace {
Packit 0d464f
Packit 0d464f
StringVector
Packit 0d464f
parseString (string name, char c = '.')
Packit 0d464f
{
Packit 0d464f
    //
Packit 0d464f
    // Turn name into a list of strings, separating
Packit 0d464f
    // on char 'c' with whitespace stripped.
Packit 0d464f
    //
Packit 0d464f
Packit 0d464f
    StringVector r;
Packit 0d464f
Packit 0d464f
    while (name.size() > 0)
Packit 0d464f
    {  
Packit 0d464f
	size_t s = name.find (c);
Packit 0d464f
	string sec = name.substr (0, s);
Packit 0d464f
Packit 0d464f
	//
Packit 0d464f
	// Strip spaces from beginning
Packit 0d464f
	//
Packit 0d464f
Packit 0d464f
	while (sec.size() > 0 && sec[0] == ' ')
Packit 0d464f
	    sec.erase (0, 1);
Packit 0d464f
Packit 0d464f
	//
Packit 0d464f
	// Strip spaces from end
Packit 0d464f
	//
Packit 0d464f
Packit 0d464f
	while (sec.size() > 0 && sec[sec.size() - 1] == ' ')
Packit 0d464f
	    sec.erase (sec.size() - 1);
Packit 0d464f
Packit 0d464f
	r.push_back (sec);
Packit 0d464f
Packit 0d464f
	//
Packit 0d464f
	// Strip off name including ending 'c'
Packit 0d464f
	//
Packit 0d464f
Packit 0d464f
	if (s == name.npos)
Packit 0d464f
	    name = "";
Packit 0d464f
	else
Packit 0d464f
	    name = name.substr (s + 1);
Packit 0d464f
    } 
Packit 0d464f
Packit 0d464f
    return r;
Packit 0d464f
}
Packit 0d464f
Packit 0d464f
Packit 0d464f
int
Packit 0d464f
viewNum (const string &view, const StringVector &multiView)
Packit 0d464f
{
Packit 0d464f
    //
Packit 0d464f
    // returns which view number is called 'view'
Packit 0d464f
    // returns -1 if no member of multiView is 'view'
Packit 0d464f
    // (i.e. if viewNum() returns -1, 'view' isn't a view name
Packit 0d464f
    //       if viewNum() returns 0, 'view' is the default view
Packit 0d464f
    // otherwise, it's some other (valid) view
Packit 0d464f
    //
Packit 0d464f
Packit 0d464f
    for (size_t i = 0; i < multiView.size(); ++i)
Packit 0d464f
    {
Packit 0d464f
	if (multiView[i] == view)
Packit 0d464f
	    return i;
Packit 0d464f
    }
Packit 0d464f
Packit 0d464f
    return -1;
Packit 0d464f
}
Packit 0d464f
Packit 0d464f
} // namespace
Packit 0d464f
Packit 0d464f
Packit 0d464f
string
Packit 0d464f
defaultViewName (const StringVector &multiView)
Packit 0d464f
{
Packit 0d464f
    if (multiView.size() > 0)
Packit 0d464f
	return multiView[0];
Packit 0d464f
    else
Packit 0d464f
	return "";
Packit 0d464f
}
Packit 0d464f
Packit 0d464f
Packit 0d464f
string
Packit 0d464f
viewFromChannelName (const string &channel,
Packit 0d464f
		     const StringVector &multiView)
Packit 0d464f
{
Packit 0d464f
    //
Packit 0d464f
    // Given the name of a channel, return the name of the view to
Packit 0d464f
    // which it belongs.
Packit 0d464f
    //
Packit 0d464f
Packit 0d464f
    //
Packit 0d464f
    // View name is penultimate section of name separated by periods ('.'s)
Packit 0d464f
    //
Packit 0d464f
Packit 0d464f
    StringVector s = parseString (channel, '.');
Packit 0d464f
Packit 0d464f
    if (s.size() == 0)
Packit 0d464f
	return ""; // nothing in, nothing out
Packit 0d464f
Packit 0d464f
    if (s.size() == 1)
Packit 0d464f
    {
Packit 0d464f
	//
Packit 0d464f
	// Return default view name.
Packit 0d464f
	// The rules say ALL channels with no periods
Packit 0d464f
	// in the name belong to the default view.
Packit 0d464f
	//
Packit 0d464f
Packit 0d464f
	return multiView[0];
Packit 0d464f
    }
Packit 0d464f
    else
Packit 0d464f
    { 
Packit 0d464f
	//
Packit 0d464f
	// size >= 2 - the last part is the channel name,
Packit 0d464f
	// the next-to-last part is the view name.
Packit 0d464f
	// Check if that part of the name really is
Packit 0d464f
	// a valid view and, if it is, return it.
Packit 0d464f
	//
Packit 0d464f
Packit 0d464f
	const string &viewName = s[s.size() - 2];
Packit 0d464f
Packit 0d464f
	if (viewNum (viewName, multiView) >= 0)
Packit 0d464f
	    return viewName;
Packit 0d464f
	else
Packit 0d464f
	    return ""; // not associated with any particular view
Packit 0d464f
    }
Packit 0d464f
}
Packit 0d464f
Packit 0d464f
Packit 0d464f
ChannelList
Packit 0d464f
channelsInView (const string & viewName,
Packit 0d464f
	        const ChannelList & channelList,
Packit 0d464f
		const StringVector & multiView)
Packit 0d464f
{
Packit 0d464f
    //
Packit 0d464f
    // Return a list of all channels belonging to view viewName.
Packit 0d464f
    //
Packit 0d464f
Packit 0d464f
    ChannelList q;
Packit 0d464f
Packit 0d464f
    for (ChannelList::ConstIterator i = channelList.begin();
Packit 0d464f
	 i != channelList.end();
Packit 0d464f
	 ++i)
Packit 0d464f
    {
Packit 0d464f
	//
Packit 0d464f
	// Get view name for this channel
Packit 0d464f
	//
Packit 0d464f
Packit 0d464f
	string view = viewFromChannelName (i.name(), multiView);
Packit 0d464f
Packit 0d464f
Packit 0d464f
	//
Packit 0d464f
	// Insert channel into q if it's a member of view viewName
Packit 0d464f
	//
Packit 0d464f
Packit 0d464f
	if (view == viewName)
Packit 0d464f
	   q.insert (i.name(), i.channel());
Packit 0d464f
    }
Packit 0d464f
Packit 0d464f
    return q;
Packit 0d464f
}
Packit 0d464f
Packit 0d464f
Packit 0d464f
ChannelList
Packit 0d464f
channelsInNoView (const ChannelList &channelList,
Packit 0d464f
		  const StringVector &multiView)
Packit 0d464f
{
Packit 0d464f
    //
Packit 0d464f
    // Return a list of channels not associated with any named view.
Packit 0d464f
    //
Packit 0d464f
Packit 0d464f
    return channelsInView ("", channelList, multiView); 
Packit 0d464f
}
Packit 0d464f
Packit 0d464f
Packit 0d464f
Packit 0d464f
bool
Packit 0d464f
areCounterparts (const string &channel1, 
Packit 0d464f
	         const string &channel2,
Packit 0d464f
		 const StringVector &multiView)
Packit 0d464f
{
Packit 0d464f
    //
Packit 0d464f
    // Given two channels, return true if they are the same
Packit 0d464f
    // channel in two different views.
Packit 0d464f
    //
Packit 0d464f
Packit 0d464f
    StringVector chan1 = parseString (channel1);
Packit 0d464f
    size_t size1 = chan1.size();	// number of SECTIONS in string
Packit 0d464f
    					// name (not string length)
Packit 0d464f
Packit 0d464f
    StringVector chan2 = parseString (channel2);
Packit 0d464f
    size_t size2 = chan2.size();
Packit 0d464f
Packit 0d464f
    if (size1 == 0 || size2 == 0)
Packit 0d464f
	return false;
Packit 0d464f
     
Packit 0d464f
    //
Packit 0d464f
    // channel1 and channel2 can't be counterparts
Packit 0d464f
    // if either channel is in no view.
Packit 0d464f
    //
Packit 0d464f
Packit 0d464f
    if (size1 > 1 && viewNum (chan1[size1 - 2], multiView) == -1)
Packit 0d464f
	return false;
Packit 0d464f
Packit 0d464f
    if (size2 > 1 && viewNum (chan2[size2 - 2], multiView) == -1)
Packit 0d464f
	return false; 
Packit 0d464f
Packit 0d464f
    if (viewFromChannelName (channel1, multiView) ==
Packit 0d464f
	viewFromChannelName (channel2, multiView))
Packit 0d464f
    {
Packit 0d464f
	//
Packit 0d464f
	// channel1 and channel2 are not counterparts
Packit 0d464f
	// if they are in the same view.
Packit 0d464f
	//
Packit 0d464f
Packit 0d464f
	return false;
Packit 0d464f
    }
Packit 0d464f
Packit 0d464f
    if (size1 == 1)
Packit 0d464f
    { 
Packit 0d464f
	//
Packit 0d464f
	// channel1 is a default channel - the channels will only be
Packit 0d464f
	// counterparts if channel2 is of the form <view>.<channel1>
Packit 0d464f
	//
Packit 0d464f
Packit 0d464f
	return size2 == 2 && chan1[0] == chan2[1];
Packit 0d464f
    }
Packit 0d464f
Packit 0d464f
    if (size2 == 1)
Packit 0d464f
    {
Packit 0d464f
	//
Packit 0d464f
	// channel2 is a default channel - the channels will only be
Packit 0d464f
	// counterparts if channel1 is of the form <view>.<channel2>
Packit 0d464f
	//
Packit 0d464f
Packit 0d464f
	return size1 == 2 && chan2[0] == chan1[1];
Packit 0d464f
    }
Packit 0d464f
Packit 0d464f
    //
Packit 0d464f
    // Neither channel is a default channel.  To be counterparts both
Packit 0d464f
    // channel names must have the same number of components, and
Packit 0d464f
    // all components except the penultimate one must be the same.
Packit 0d464f
    //
Packit 0d464f
Packit 0d464f
    if (size1 != size2)
Packit 0d464f
	return false;
Packit 0d464f
Packit 0d464f
    for(size_t i = 0; i < size1; ++i)
Packit 0d464f
    {
Packit 0d464f
	if (i != size1 - 2 && chan1[i] != chan2[i])
Packit 0d464f
	    return false;
Packit 0d464f
    }
Packit 0d464f
Packit 0d464f
    return true;
Packit 0d464f
}
Packit 0d464f
Packit 0d464f
Packit 0d464f
ChannelList
Packit 0d464f
channelInAllViews (const string &channelName,
Packit 0d464f
		   const ChannelList &channelList,
Packit 0d464f
		   const StringVector &multiView)
Packit 0d464f
{
Packit 0d464f
    //
Packit 0d464f
    // Given the name of a channel, return a
Packit 0d464f
    // list of the same channel in all views.
Packit 0d464f
    //
Packit 0d464f
Packit 0d464f
    ChannelList q;
Packit 0d464f
Packit 0d464f
    for (ChannelList::ConstIterator i=channelList.begin();
Packit 0d464f
	 i != channelList.end();
Packit 0d464f
	 ++i)
Packit 0d464f
    {
Packit 0d464f
	if (i.name() == channelName ||
Packit 0d464f
	    areCounterparts (i.name(), channelName, multiView))
Packit 0d464f
	{
Packit 0d464f
	    q.insert (i.name(), i.channel());
Packit 0d464f
	}
Packit 0d464f
    }
Packit 0d464f
Packit 0d464f
    return q;
Packit 0d464f
}
Packit 0d464f
Packit 0d464f
Packit 0d464f
string
Packit 0d464f
channelInOtherView (const string &channelName,
Packit 0d464f
		    const ChannelList &channelList,
Packit 0d464f
		    const StringVector &multiView,
Packit 0d464f
		    const string &otherViewName)
Packit 0d464f
{
Packit 0d464f
    //
Packit 0d464f
    // Given the name of a channel in one view, return the
Packit 0d464f
    // corresponding channel name for view otherViewName.
Packit 0d464f
    //
Packit 0d464f
Packit 0d464f
    for (ChannelList::ConstIterator i=channelList.begin();
Packit 0d464f
	 i != channelList.end();
Packit 0d464f
	 ++i)
Packit 0d464f
    {
Packit 0d464f
	if (viewFromChannelName (i.name(), multiView) == otherViewName &&
Packit 0d464f
	    areCounterparts (i.name(), channelName, multiView))
Packit 0d464f
	{
Packit 0d464f
	    return i.name(); 
Packit 0d464f
	}
Packit 0d464f
    }
Packit 0d464f
Packit 0d464f
    return "";
Packit 0d464f
}
Packit 0d464f
Packit 0d464f
Packit 0d464f
string
Packit 0d464f
insertViewName (const string &channel,
Packit 0d464f
		const StringVector &multiView,
Packit 0d464f
		int i)
Packit 0d464f
{
Packit 0d464f
    //
Packit 0d464f
    // Insert multiView[i] into the channel name if appropriate.
Packit 0d464f
    //
Packit 0d464f
Packit 0d464f
    StringVector s = parseString (channel, '.');
Packit 0d464f
Packit 0d464f
    if (s.size() == 0)
Packit 0d464f
	return ""; // nothing in, nothing out
Packit 0d464f
Packit 0d464f
    if (s.size() == 1 && i == 0)
Packit 0d464f
    {
Packit 0d464f
	//
Packit 0d464f
	// Channel in the default view, with no periods in its name.
Packit 0d464f
	// Do not insert view name.
Packit 0d464f
	//
Packit 0d464f
Packit 0d464f
	return channel;
Packit 0d464f
    }
Packit 0d464f
Packit 0d464f
    //
Packit 0d464f
    // View name becomes penultimate section of new channel name.
Packit 0d464f
    //
Packit 0d464f
Packit 0d464f
    string newName;
Packit 0d464f
Packit 0d464f
    for (size_t j = 0; j < s.size(); ++j)
Packit 0d464f
    {
Packit 0d464f
	if (j < s.size() - 1)
Packit 0d464f
	    newName += s[j] + ".";
Packit 0d464f
	else
Packit 0d464f
	    newName += multiView[i] + "." + s[j];
Packit 0d464f
    }
Packit 0d464f
Packit 0d464f
    return newName;
Packit 0d464f
}
Packit 0d464f
Packit 0d464f
Packit 0d464f
string
Packit 0d464f
removeViewName(const string & channel,const string & view)
Packit 0d464f
{
Packit 0d464f
    StringVector s = parseString (channel, '.');
Packit 0d464f
Packit 0d464f
    if (s.size() == 0)
Packit 0d464f
	return ""; // nothing in, nothing out
Packit 0d464f
Packit 0d464f
    if (s.size() == 1)
Packit 0d464f
    {
Packit 0d464f
	//
Packit 0d464f
	// Channel in the default view, since no periods in its name.
Packit 0d464f
	// No viewname to remove
Packit 0d464f
	//
Packit 0d464f
Packit 0d464f
	return channel;
Packit 0d464f
    }
Packit 0d464f
Packit 0d464f
    string newName;
Packit 0d464f
    for( size_t j = 0 ; j < s.size() ; ++j)
Packit 0d464f
    {
Packit 0d464f
	    // only add the penultimate string part
Packit 0d464f
	    // if it doesn't match the view name
Packit 0d464f
	    if(j+2!=s.size() || s[j]!=view)
Packit 0d464f
	    {
Packit 0d464f
                  newName += s[j];
Packit 0d464f
	          if(j+1!=s.size())
Packit 0d464f
	          {
Packit 0d464f
                      newName  += ".";
Packit 0d464f
	          }
Packit 0d464f
	    }
Packit 0d464f
    }
Packit 0d464f
Packit 0d464f
    return newName;
Packit 0d464f
Packit 0d464f
}
Packit 0d464f
Packit 0d464f
OPENEXR_IMF_INTERNAL_NAMESPACE_SOURCE_EXIT