libballview1.4-dev 1.4.3~beta1-3 / usr / include / BALL / VIEW / MODELS / ballAndStickModel.h

// -*- Mode: C++; tab-width: 2; -*-
// vi: set ts=2:
//
// $Id: ballAndStickModel.h,v 1.17.18.1 2007/03/25 21:26:05 oliver Exp $
//

#ifndef BALL_VIEW_MODELS_BALLANDSTICKMODEL_H
#define BALL_VIEW_MODELS_BALLANDSTICKMODEL_H

#ifndef BALL_VIEW_MODELS_ATOMBONDMODELBASEPROCESSOR_H
#	include <BALL/VIEW/MODELS/atomBondModelBaseProcessor.h>
#endif

#ifndef BALL_KERNEL_ATOM_H
 #include <BALL/KERNEL/atom.h>
#endif

namespace BALL
{
	class Atom;

	namespace VIEW
	{
		/** AddBallAndStickModel class.
				The class AddBallAndStickModel is a model processor that is responsible
				for creating either a <b>ball and stick</b> model or a <b>stick</b> model.
				In a ball and stick model the graphical representation of the Atom objects
				(Sphere objects) have a different radius than the representation of
				the Bond objects (Tube objects). Otherwise in the stick model
				the radi of the ball and the stick components are equal.
				For information about the processor concept see Processor in the BALL
				documentation. 
				\ingroup  ViewModels
		*/
		class BALL_VIEW_EXPORT AddBallAndStickModel: public AtomBondModelBaseProcessor
		{
			public:

			BALL_CREATE(AddBallAndStickModel)

			/**	@name	Constructors and Destructors
			*/	
			//@{

			/** Default Constructor.
					Set the appearance to:
					 - set the appearance to ball and stick model
					 - set the ball radius to 0.4
					 - set the stick radius to 0.2
			*/
			AddBallAndStickModel();

			/** Copy constructor.
			*/
			AddBallAndStickModel(const AddBallAndStickModel& add_ball_and_stick_model);

			/** Destructor.
			*/
			virtual ~AddBallAndStickModel();

			/** Explicit default initialization.
					Reset the state of this AddBallAndStickModel to:
					 - set the appearance to ball and stick model
					 - set the ball radius to 0.4
					 - set the stick radius to 0.2
					Calls AtomBondModelBaseProcessor::clear.
			*/
			virtual void clear();

			//@} 
			/**	@name	Assignment 
			*/ 
			//@{

			/** Assignment.
					Calls AtomBondModelBaseProcessor::set.
			*/
			void set(const AddBallAndStickModel& add_ball_and_stick_model);

			/** Assignment operator.
					Calls set().
			*/
			const AddBallAndStickModel& operator = (const AddBallAndStickModel& processor);

			//@}
			/**	@name	Accessors: inspectors and mutators 
					This methods are used to specify the appearance of the model. This processor
					can either be used for creating a <b>ball and stick</b> model or a <b>stick</b> model.
					For the ball-component (the graphical representation of the Atom object) and
					the stick-component (the graphical representation of the Bond object)
					different radi can be assigned.
			*/
			//@{

			/** Change the radius of the ball-component.
					\param       radius the new radius of the ball-component: (<b>radius > 0</b>)
					\exception  OutOfRange thrown if <b>radius <= 0</b>
			*/
			void setBallRadius(const float radius)
				throw(Exception::OutOfRange);

			/** Inspection of the radius of the ball-component.
			*/
			float getBallRadius() const;

			/** Change the radius of the stick-component.
					\param       radius the new radius of the stick-component: (radius > 0)
					\exception  OutOfRange thrown if radius <= 0
			*/
			void setStickRadius(const float radius)
				throw(Exception::OutOfRange);

			/** Inspection of the radius of the stick-component.
			*/
			float getStickRadius() const;

			/** Enable the creation of the ball and stick model.
			*/
			void enableBallAndStickModel();

			/** Enable the creation of the stick model.
			*/
			void enableStickModel();

			//@} 
			/**	@name Processor specific methods 
			*/ 
			//@{

			/**	Operator () method.
					This method iterates over each Composite object reachable in the 
					Composite tree. If the composite is of kind Atom than a Sphere
					is created for that atom, and the atom is inserted with 
					the method insertAtom_().
					If the AddBallAndStickModel should create a ball and stick model
					the radius assigned to the sphere will be the ball radius (see method
					setBallRadius()); if a stick model should be created than the stick radius
					is assigned to the sphere (see method setStickRadius()).
					All atoms inserted with the method insertAtom_() will later used for creating
					the model of the reachable Bond objects. Those models will be created
					with the method buildBondModels_().
					\param  composite the Composite object that will be processed
					\return Processor::Result the result 
					\exception OutOfMemory thrown if the memory allocation for a Sphere object failed
			*/
			virtual Processor::Result operator() (Composite& composite);

			//@} 
			/**	@name	Predicates 
			*/ 
			//@{

			/** Test if create ball and stick model.
					\return   bool true if a ball and stick model should be created, false if stick model 
			*/
			bool isBallAndStickModel() const;

			/** Test if create a stick model.
					\return   bool true if a stick model should be created, false if ball and stick model 
			*/
			bool isStickModel() const;

			///
			bool dashedBondsEnabled() const
				{ return dashed_bonds_;}

			///
			void enableDashedBonds(bool state)
				{ dashed_bonds_ = state;}

			//@} 
			/**	@name	debuggers and diagnostics 
			*/ 
			//@{

			/** Internal value dump.
					Dump the current state of this AddBallAndStickModel to 
					the output ostream <b>s</b> with dumping depth <b>depth</b>.
					Calls AtomBondModelBaseProcessor::dump.
					\param   s output stream where to output the state 
					\param   depth the dumping depth
			*/
			virtual void dump(std::ostream& s = std::cout, Size depth = 0) const;

			//@}

			virtual bool createGeometricObjects();
		
			protected:

			void visualiseBond_(const Bond& bond);

			virtual void visualiseRings_();

			inline void renderStandardBond_(const Bond& bond);

			inline void renderMultipleBond_(const Bond& bond, Vector3 normal, Vector3 dir);

			inline void renderDashedBond_(const Bond& bond, Vector3 n)
				throw(Exception::DivisionByZero);

			void collectRingBonds_();

			Vector3 getSP2Plane_(const Atom& atom, const Bond& bond, const Vector3& dir) const;

			private:

			float ball_radius_;
			float stick_radius_;
			float special_radius_;
		
			bool ball_and_stick_;
			bool dashed_bonds_;

			vector<vector<Bond*> > ring_bonds_;
		};

#	ifndef BALL_NO_INLINE_FUNCTIONS
#		include <BALL/VIEW/MODELS/ballAndStickModel.iC>
#	endif

	} // namespace VIEW
} // namespace BALL

#endif // BALL_VIEW_MODELS_BALLANDSTICKMODEL_H