text: //////////////////////////////////////////////////////////////////////////
  //
  //  Copyright (c) 2014, Image Engine Design Inc. 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 John Haddon nor the names of
  //        any other contributors to this software 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 GAFFERSCENE_SET_H
  #define GAFFERSCENE_SET_H
  
  #include "Gaffer/TypedObjectPlug.h"
  
  #include "GafferScene/SceneProcessor.h"
  
  namespace Gaffer
  {
  
  IE_CORE_FORWARDDECLARE( StringPlug )
  
  } // namespace Gaffer
  
  namespace GafferScene
  {
  
  /// Node to define sets of locations in the scene - not to be confused
  /// with the Gaffer::Set class which is for an entirely different purpose.
  class Set : public SceneProcessor
  {
  
  	public :
  
  		Set( const std::string &name=defaultName<Set>() );
  		virtual ~Set();
  
  		IE_CORE_DECLARERUNTIMETYPEDEXTENSION( GafferScene::Set, SetTypeId, SceneProcessor );
  
  		enum Mode
  		{
  			Create,
  			Add,
  			Remove
  		};
  
  		Gaffer::IntPlug *modePlug();
  		const Gaffer::IntPlug *modePlug() const;
  
  		Gaffer::StringPlug *namePlug();
  		const Gaffer::StringPlug *namePlug() const;
  
  		Gaffer::StringVectorDataPlug *pathsPlug();
  		const Gaffer::StringVectorDataPlug *pathsPlug() const;
  
  		virtual void affects( const Gaffer::Plug *input, AffectedPlugsContainer &outputs ) const;
  
  	protected :
  
  		virtual void hash( const Gaffer::ValuePlug *output, const Gaffer::Context *context, IECore::MurmurHash &h ) const;
  		virtual void compute( Gaffer::ValuePlug *output, const Gaffer::Context *context ) const;
  
  		virtual void hashSetNames( const Gaffer::Context *context, const ScenePlug *parent, IECore::MurmurHash &h ) const;
  		virtual void hashSet( const IECore::InternedString &setName, const Gaffer::Context *context, const ScenePlug *parent, IECore::MurmurHash &h ) const;
  
  		virtual IECore::ConstInternedStringVectorDataPtr computeSetNames( const Gaffer::Context *context, const ScenePlug *parent ) const;
  		virtual ConstPathMatcherDataPtr computeSet( const IECore::InternedString &setName, const Gaffer::Context *context, const ScenePlug *parent ) const;
  
  	private :
  
  		PathMatcherDataPlug *pathMatcherPlug();
  		const PathMatcherDataPlug *pathMatcherPlug() const;
  
  		static size_t g_firstPlugIndex;
  
  };
  
  IE_CORE_DECLAREPTR( Set );
  
  } // namespace GafferScene
  
  #endif // GAFFERSCENE_SET_H
  