Home Hierarchy Members Alphabetical Related Pages

Appearance Class Reference
[Standard Node Types]

#include <appearance.h>

Inherits Node.

Inheritance diagram for Appearance:

Inheritance graph
[legend]
List of all members.

Public Member Functions

 Appearance (const char *name="")
virtual ~Appearance ()
virtual unsigned int nbFields () const
virtual FieldHandle field (const std::string &n)
virtual FieldHandle field (const unsigned int i)
virtual bool isSetToDefaultValue (const unsigned int i) const
virtual unsigned int nbEventsIn () const
virtual EventInHandle eventIn (const std::string &n)
virtual EventInHandle eventIn (const unsigned int i)
virtual unsigned int nbEventsOut () const
virtual EventOutHandle eventOut (const std::string &n)
virtual EventOutHandle eventOut (const unsigned int i)
const char * typeName () const
virtual Node * duplicate () const
virtual Node * duplicate (std::map< const Node *, Node * > &) const

Public Attributes

Exposed Fields
A field that is capable of receiving events via an eventIn to change its value(s), and generating events via an eventOut when its value(s) change.

SFNode material
SFNode texture
SFNode textureTransform
Events In
EventIn< SFNode > set_material
EventIn< SFNode > set_texture
EventIn< SFNode > set_textureTransform
Events Out
EventOut< SFNode > material_changed
EventOut< SFNode > texture_changed
EventOut< SFNode > textureTransform_changed

Detailed Description

Here is the documentation for this node type, from the ISO standard.

+6.3 Appearance

The Appearance node specifies the visual properties of geometry. The value for each of the fields in this node may be NULL. However, if the field is non-NULL, it shall contain one node of the appropriate type.

The material field, if specified, shall contain a Material node. If the material field is NULL or unspecified, lighting is off (all lights are ignored during rendering of the object that references this Appearance) and the unlit object colour is (1, 1, 1). Details of the VRML lighting model are in 4.14, Lighting model.

The texture field, if specified, shall contain one of the various types of texture nodes (ImageTexture, MovieTexture, or PixelTexture). If the texture node is NULL or the texture field is unspecified, the object that references this Appearance is not textured.

The textureTransform field, if specified, shall contain a TextureTransform node. If the textureTransform is NULL or unspecified, the textureTransform field has no effect.

--- VRML separator bar ---

Constructor & Destructor Documentation

Appearance (  const char *  name = ""  ) 
 

Construct a node with all its fields set to default value, which is equivalent to the code below: 

    		
  







  

    
      

        

          ~Appearance           
          ( 
                    
           ) 
           [virtual]
        

      

    		
  





  

    
       
    
    



Virtual destructor, does nothing     

  




Member Function Documentation





  

    
      

        

          wrl::Node * duplicate           
          ( 
          std::map< const Node *, Node * > & 
                    
           ) 
           const [virtual]
        

      

    		
  





  

    
       
    
    






Implements Node.    

  







  

    
      

        

          wrl::Node * duplicate           
          ( 
                    
           ) 
           const [virtual]
        

      

    		
  





  

    
       
    
    



Returns a deep copy of this node, that is a fully independant node with all children (if any) also copied. This is mainly useful for instanciating protos. 


Implements Node.    

  







  

    
      

        

          wrl::Node::EventInHandle eventIn           
          ( 
          const unsigned int 
           n          
           ) 
           [virtual]
        

      

    		
  





  

    
       
    
    



Return a handle on the i th event in of the node or a "unknown" typed handle if there is no such node. emarks This class has no eventIn. This function is useful, with nbEventsIn() if you want to traverse all events in of a Node. 


Implements Node.    

  







  

    
      

        

          wrl::Node::EventInHandle eventIn           
          ( 
          const std::string & 
           n          
           ) 
           [virtual]
        

      

    		
  





  

    
       
    
    



Return a handle on the event in named n of the node or a "unknown" typed handle if there is no such event. Valid names are:
    

  • set_material
  • set_texture
  • set_textureTransform 




Implements Node.    

  







  

    
      

        

          wrl::Node::EventOutHandle eventOut           
          ( 
          const unsigned int 
           n          
           ) 
           [virtual]
        

      

    		
  





  

    
       
    
    



Return a handle on the i th event out of the node or a "unknown" typed handle if there is no such node. Here is how i is related to fields:
    

  • 0 : material_changed
  • 1 : texture_changed
  • 2 : textureTransform_changed This function is useful, with nbEventsOut() if you want to traverse all events in of a Node. 




Implements Node.    

  







  

    
      

        

          wrl::Node::EventOutHandle eventOut           
          ( 
          const std::string & 
           n          
           ) 
           [virtual]
        

      

    		
  





  

    
       
    
    



Return a handle on the event out named n of the node or a "unknown" typed handle if there is no such event. Valid names are:
    

  • material_changed
  • texture_changed
  • textureTransform_changed 




Implements Node.    

  







  

    
      

        

          wrl::Node::FieldHandle field           
          ( 
          const unsigned int 
           n          
           ) 
           [virtual]
        

      

    		
  





  

    
       
    
    



Return a handle on the i th field of the node or a "unknown" typed handle if there is no such node. Here is how i is related to fields:
    

  • 0 : material
  • 1 : texture
  • 2 : textureTransform This function is useful, with nbFields() if you want to traverse all fields of a Node. 




Implements Node.    

  







  

    
      

        

          wrl::Node::FieldHandle field           
          ( 
          const std::string & 
           n          
           ) 
           [virtual]
        

      

    		
  





  

    
       
    
    



Return a handle on the field named n of the node or a "unknown" typed handle if there is no such field. Valid names are:
    

  • material
  • texture
  • textureTransform 




Implements Node.    

  







  

    
      

        

          bool isSetToDefaultValue           
          ( 
          const unsigned int 
           i          
           ) 
           const [virtual]
        

      

    		
  





  

    
       
    
    






Implements Node.    

  







  

    
      

        

          unsigned int nbEventsIn           
          ( 
                    
           ) 
           const [inline, virtual]
        

      

    		
  





  

    
       
    
    



Returns the number of events in for this node type. 


Implements Node.    

  







  

    
      

        

          unsigned int nbEventsOut           
          ( 
                    
           ) 
           const [inline, virtual]
        

      

    		
  





  

    
       
    
    



Returns the number of events out for this node type. 


Implements Node.    

  







  

    
      

        

          unsigned int nbFields           
          ( 
                    
           ) 
           const [inline, virtual]
        

      

    		
  





  

    
       
    
    



Returns the number of fields (exposed or not) for this node type. 


Implements Node.    

  







  

    
      

        

          const char * typeName           
          ( 
                    
           ) 
           const [inline, virtual]
        

      

    		
  





  

    
       
    
    



Returns "Appearance". Useful for printing. 


Implements Node.    

  




Member Data Documentation





  

    
      

        

          SFNode material          
        

      

    		
  





  

    
       
    
    



See Detailed Description for meaning of this field. Default value is set to SFNode default value     

  







  

    
      

        

          EventOut<SFNode> material_changed          
        

      

    		
  





  

    
       
    
    



Changed event associated to exposedField material     

  







  

    
      

        

          EventIn<SFNode> set_material          
        

      

    		
  





  

    
       
    
    



Set event associated to exposedField material     

  







  

    
      

        

          EventIn<SFNode> set_texture          
        

      

    		
  





  

    
       
    
    



Set event associated to exposedField texture     

  







  

    
      

        

          EventIn<SFNode> set_textureTransform          
        

      

    		
  





  

    
       
    
    



Set event associated to exposedField textureTransform     

  







  

    
      

        

          SFNode texture          
        

      

    		
  





  

    
       
    
    



See Detailed Description for meaning of this field. Default value is set to SFNode default value     

  







  

    
      

        

          EventOut<SFNode> texture_changed          
        

      

    		
  





  

    
       
    
    



Changed event associated to exposedField texture     

  







  

    
      

        

          SFNode textureTransform          
        

      

    		
  





  

    
       
    
    



See Detailed Description for meaning of this field. Default value is set to SFNode default value     

  







  

    
      

        

          EventOut<SFNode> textureTransform_changed          
        

      

    		
  





  

    
       
    
    



Changed event associated to exposedField textureTransform     

  



  

  

    

      
        
          
            Generated on 24 Feb 2005 with 
            
              doxygen
             version 1.3.9.1.
          
        
      
      
        
          Valid HTML 4.0!
        
        
          Valid CSS!