VRMLTest - Full VRML 1.x parser and partial viewer

/**
 * @doc VRMLCanvas EXTERNAL VRML OPENGL CONTROL
 * 
 * @module VRMLCanvas.h - VRML Scene renderer |
 *
 * This file defines the class to render a VRML Scene. 
 * 
 * @update 2000-2-03 | ATL | Example added
 * @update 2000-1-25 | ATL | Fixed material lighting
 * @update 1999-3-16 | ATL | Creation
 *
 * @rem This class only supports rendering of Material, Coordinate3 and IndexedFaceSet 
 * nodes
 * 
 * @ex Given a <c CVRMLCanvas>, to view a <c CVRMLScene> just do |
 * CVRMLScene* pvscn;
 * pvscn = new CVRMLScene();
 * // Load default VRML 1.x node library
 * pvscn->LoadScene("allnodes.wrl");
 * // Load desired VRML file
 * pvscn->
 * // Attach scene to canvas
 * vrcnvCanvas.SetScene(pvscn);
 * // The scene will be deallocated when the
 * // CVRMLCanvas is deleted
 *
 */

#if !defined(AFX_VRMLCANVAS_H__1407BFC3_0A2B_11D3_AA42_F04DDA726F57__INCLUDED_)
#define AFX_VRMLCANVAS_H__1407BFC3_0A2B_11D3_AA42_F04DDA726F57__INCLUDED_

#if _MSC_VER > 1000
#pragma once
#endif // _MSC_VER > 1000

#include "OGLCanvas.h"
#include "VRML.h"

/**
 * @class <c COGLCanvas> wrapper to allow rendering of VRML models
 */
class CVRMLCanvas : public COGLCanvas {
public:
     
//@access Consruction
   /** 
    * @cmember Constructs this canvas
    */
   CVRMLCanvas();
   /**
    * @cmember,mfunc Destructs this canvas, and the <c CVRMLScene> it owns, if any
    * @@rem Call <mf CVRMLCanvas::SetScene> with NULL as parameter if you don't want
    * the <c CVRMLScene> to be destroyed with the canvas.
    */
   virtual ~CVRMLCanvas();

//@access Operations
   /** 
    * @cmember,mfunc Renders a <c CVRMLNode> recursively by rendering the 
    * node itself and its children
    * @@parm Node to render
    */
   void RenderNode(CVRMLNode* pvn); 
   /**
    * @cmember,mfunc Sets the <c CVRMLScene> to render
    * @@parm Scene to set as scene to render. Can be NULL.
    */
   void SetScene(CVRMLScene* pvscn);

//@access Overridables
   /**
    * @cmember,mfunc Partially supports rendering of <c CVRMLScene>s.
    * @@rem By now it only supports wrl files like those found in http://www.rosl.com,
    * that is IndexedFaceSets and Coordinate3 nodes with Material nodes (perhaps nested 
    * with Separators). All other kind of nodes are silently ignored
    */
   virtual void Render();

//@access Public Data Members
   CVRMLScene* m_pvscn;    ///@cmember <c CVRMLScene> Scene to render.
   CMFVec3f* m_pvm3fCoord; ///@cmember Last Coordinate3 node travelled
};

#endif // !defined(AFX_VRMLCANVAS_H__1407BFC3_0A2B_11D3_AA42_F04DDA726F57__INCLUDED_)