openvrml::viewpoint_node Class Reference

Abstract base class for viewpoint nodes. More...

#include <openvrml/node.h>

Inheritance diagram for openvrml::viewpoint_node:

Public Member Functions

virtual ~viewpoint_node ()=0 throw ()
 Destructor.
const mat4ftransformation () const throw ()
 Get the transformation of the viewpoint_node in the global coordinate system.
const mat4fuser_view_transform () const throw ()
 Get the transformation of the user view relative to the viewpoint_node.
void user_view_transform (const mat4f &transform) throw ()
 Set the transformation of the user view relative to the viewpoint_node.
const std::string & description () const throw ()
 Get the description.
float field_of_view () const throw ()
 Get the field of view.
- Public Member Functions inherited from openvrml::child_node
virtual ~child_node ()=0 throw ()
 Destructor.
void relocate () throw ( std::bad_alloc )
 Called when the node is relocated to a new position in the scene graph.
void render_child (viewer &v, rendering_context context)
 Render the node.
- Public Member Functions inherited from openvrml::bounded_volume_node
virtual ~bounded_volume_node () throw ()
 Destroy.
const openvrml::bounding_volumebounding_volume () const
 Get this node's bounding volume.
- Public Member Functions inherited from openvrml::node
virtual ~node ()=0 throw ()
 Destructor.
void add_ref () const throw ()
 Increment the reference count.
void remove_ref () const throw ()
 Decrement the reference count.
void release () const throw ()
 Decrement the reference count; destroy the instance if the count drops to zero.
size_t use_count () const throw ()
 The number of owning references to the instance.
const node_typetype () const throw ()
 The type information object for the node.
const std::string & id () const throw ()
 Retrieve the name of this node.
void id (const std::string &node_id) throw ( std::bad_alloc )
 Set the name of the node.
const openvrml::scopescope () const throw ()
 Get the scope to which the node belongs.
openvrml::scenescene () const throw ()
 Get the scene with which the node is associated.
const std::vector
< boost::intrusive_ptr< node > > & 
impl_nodes () const throw ()
 Get the implementation nodes of a PROTO instance.
std::ostream & print (std::ostream &out, size_t indent) const
 Pretty print.
void initialize (openvrml::scene &scene, double timestamp) throw ( std::bad_alloc )
 Initialize the node.
std::auto_ptr< field_valuefield (const std::string &id) const throw ( unsupported_interface , std::bad_alloc )
 Generalized field accessor.
openvrml::event_listenerevent_listener (const std::string &id) throw ( unsupported_interface )
 Get an event listener.
openvrml::event_emitterevent_emitter (const std::string &id) throw ( unsupported_interface )
 Get an event emitter.
void shutdown (double timestamp) throw ()
 Shut down the node.
bool modified () const throw ( boost::thread_resource_error )
 Determine whether the node has been modified.
void modified (bool value) throw ( boost::thread_resource_error )
 Set the modified flag.

Protected Member Functions

 viewpoint_node (const node_type &type, const boost::shared_ptr< openvrml::scope > &scope) throw ()
 Constructor.
- Protected Member Functions inherited from openvrml::child_node
 child_node (const node_type &type, const boost::shared_ptr< openvrml::scope > &scope) throw ()
 Constructor.
- Protected Member Functions inherited from openvrml::bounded_volume_node
 bounded_volume_node (const node_type &type, const boost::shared_ptr< openvrml::scope > &scope) throw ()
 Construct.
void bounding_volume_dirty (bool value)
 Set whether the node's bounding volume needs to be recalculated.
bool bounding_volume_dirty () const
 Whether the node's bounding volume needs to be recalculated.
virtual const
openvrml::bounding_volume
do_bounding_volume () const
 Called by bounding_volume.
- Protected Member Functions inherited from openvrml::node
 node (const node_type &type, const boost::shared_ptr< openvrml::scope > &scope) throw ()
 Construct.
boost::shared_mutex & scene_mutex ()
 The scene mutex.

Private Member Functions

virtual viewpoint_nodeto_viewpoint () throw ()
 Cast to a viewpoint_node.
virtual const mat4fdo_transformation () const =0 throw ()
 Get the transformation of the viewpoint_node in the global coordinate system.
virtual const mat4fdo_user_view_transform () const =0 throw ()
 Get the transformation of the user view relative to the viewpoint_node.
virtual void do_user_view_transform (const mat4f &transform)=0 throw ()
 Set the transformation of the user view relative to the viewpoint_node.
virtual const std::string & do_description () const =0 throw ()
 Get the description.
virtual float do_field_of_view () const =0 throw ()
 Get the field of view.

Additional Inherited Members

- Static Public Attributes inherited from openvrml::node
static const
boost::intrusive_ptr< node
self_tag
 Special value used when initializing a script_node.
- Static Protected Member Functions inherited from openvrml::node
static void emit_event (openvrml::event_emitter &emitter, double timestamp) throw ( std::bad_alloc )
 Emit an event.

Detailed Description

Abstract base class for viewpoint nodes.

Constructor & Destructor Documentation

openvrml::viewpoint_node::~viewpoint_node ( ) throw ()
pure virtual

Destructor.

openvrml::viewpoint_node::viewpoint_node ( const node_type type,
const boost::shared_ptr< openvrml::scope > &  scope 
) throw ()
protected

Constructor.

Parameters
[in]typethe node_type associated with the node.
[in]scopethe scope the node belongs to.

Member Function Documentation

const openvrml::mat4f & openvrml::viewpoint_node::transformation ( ) const throw ()

Get the transformation of the viewpoint_node in the global coordinate system.

This function delegates to do_transformation.

Returns
the transformation of the viewpoint_node in the global coordinate system.
const openvrml::mat4f & openvrml::viewpoint_node::user_view_transform ( ) const throw ()

Get the transformation of the user view relative to the viewpoint_node.

This function delegates to do_user_view_transform().

Returns
the transformation of the user view relative to the viewpoint_node.
void openvrml::viewpoint_node::user_view_transform ( const mat4f transform) throw ()

Set the transformation of the user view relative to the viewpoint_node.

This function delegates to do_user_view_transform(const mat4f &).

Parameters
[in]transformthe new transformation.
const std::string & openvrml::viewpoint_node::description ( ) const throw ()

Get the description.

This function delegates to do_description.

Returns
the description.
float openvrml::viewpoint_node::field_of_view ( ) const throw ()

Get the field of view.

This function delegates to do_field_of_view.

Returns
the field of view in radians.
openvrml::viewpoint_node * openvrml::viewpoint_node::to_viewpoint ( ) throw ()
privatevirtual

Cast to a viewpoint_node.

Returns
a pointer to this viewpoint_node.
const openvrml::mat4f & openvrml::viewpoint_node::do_transformation ( ) const throw ()
privatepure virtual

Get the transformation of the viewpoint_node in the global coordinate system.

Returns
the transformation of the viewpoint_node in the global coordinate system.
const openvrml::mat4f & openvrml::viewpoint_node::do_user_view_transform ( ) const throw ()
privatepure virtual

Get the transformation of the user view relative to the viewpoint_node.

Returns
the transformation of the user view relative to the viewpoint_node.
void openvrml::viewpoint_node::do_user_view_transform ( const mat4f transform) throw ()
privatepure virtual

Set the transformation of the user view relative to the viewpoint_node.

Parameters
[in]transformthe new transformation.
const std::string & openvrml::viewpoint_node::do_description ( ) const throw ()
privatepure virtual

Get the description.

Returns
the description.
float openvrml::viewpoint_node::do_field_of_view ( ) const throw ()
privatepure virtual

Get the field of view.

Returns
the field of view in radians.