ProtoDeclaration.h

Go to the documentation of this file.

//    Copyright 2004-2019, SenseGraphics AB
//
//    This file is part of H3D API.
//
//    H3D API is free software; you can redistribute it and/or modify
//    it under the terms of the GNU General Public License as published by
//    the Free Software Foundation; either version 2 of the License, or
//    (at your option) any later version.
//
//    H3D API is distributed in the hope that it will be useful,
//    but WITHOUT ANY WARRANTY; without even the implied warranty of
//    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
//    GNU General Public License for more details.
//
//    You should have received a copy of the GNU General Public License
//    along with H3D API; if not, write to the Free Software
//    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
//
//    A commercial license is also available. Please contact us at 
//    www.sensegraphics.com for more information.
//
//
//
 
#ifndef __PROTODECLARATION_H__
#define __PROTODECLARATION_H__
 
#include <H3D/X3DPrototypeInstance.h>
#include <H3D/PrototypeInstance.h>
#include <H3D/DEFNodes.h>
#include <list>
 
namespace H3D {
  namespace X3D {
    class PrototypeVector;
  }
 
  class H3DAPI_API ProtoDeclaration : public RefCountedClass {
  public:
    class H3DAPI_API FieldDeclaration {
    public:
      FieldDeclaration( const string &_name = "",
                        const X3DTypes::X3DType &_type = X3DTypes::UNKNOWN_X3D_TYPE,
                        const Field::AccessType &_access_type = Field::INPUT_OUTPUT,
                        const string &_value = "" ) :
        name( _name ),
        type( _type ),
        access_type( _access_type ),
        value( _value ),
        external( false ) {
 
      }
 
      string name;
      X3DTypes::X3DType type;
      Field::AccessType access_type;
      string value;
      bool external;
    };
 
    ProtoDeclaration( const string &_name,
                      const string &_body = "",
                      const vector<string > &_body_extra = vector<string>(),
                      X3D::PrototypeVector *_existing_protos = NULL );
 
    // destructor
    virtual ~ProtoDeclaration();
 
    const string &getProtoBody() {
      return body;
    }
 
    void setProtoBody( const string &_body ) {
      body = _body;
    }
 
    void addProtoBodyExtra( const string &_body ) {
      body_extra.push_back( _body );
    }
    
    const vector<string> & getProtoBodyExtra( ) {
      return body_extra;
    }
 
    const string& getName() {
      return name;
    }
 
    void setName( const string &_name ) {
      name = _name;
    }
 
    string addFieldDeclaration( const string &_name,
                                const X3DTypes::X3DType &type,
                                const Field::AccessType &access_type,
                                const string &value = ""  ) {
      FieldDeclaration *field_declaration = getFieldDeclaration( _name );
      if( field_declaration ) {
        if( field_declaration->external ) {
          string error_message = "";
          if( field_declaration->type != type )
            error_message =
              "Warning: Value for \"type\" attribute of \"field\" element with name"
              + _name + " does not match the value in found ExternProto. Attribute is ignored.";
          if( error_message == "" &&
              field_declaration->access_type != access_type )
            error_message =
              "Warning: Value for \"access_type\" attribute of \"field\" element with name"
              + _name + " does not match the value in found ExternProto. Attribute is ignored.";
          if( value != "" )
            field_declaration->value = "";
          // No need to add field declaration. Just indicate that it is no
          // longer defined in external proto.
          field_declaration->external = false;
          return error_message;
        } else {
          return "\"field\" element with name " + _name
                 + " already exists. The field will not be added.";
        }
      }
      field_declarations.push_back( FieldDeclaration(_name, type, access_type, value ) );
      return "";
    }
 
    FieldDeclaration *getFieldDeclaration( const string& _name ) {
      for( list< FieldDeclaration >::iterator i = field_declarations.begin();
           i != field_declarations.end(); ++i ) {
        if( (*i).name == _name ) {
          return &(*i);
        }
      }
      return NULL;
    }
 
    void setFieldDeclarationsExternal( bool is_external ) {
      for( list< FieldDeclaration >::iterator i = field_declarations.begin();
           i != field_declarations.end(); ++i ) {
        (*i).external = is_external;
      }
    }
    
    X3DPrototypeInstance *newProtoInstance();
  protected:
    string name;
    // The main body string, i.e. the first node in the proto body.
    string body;
 
    // The extra body string, i.e. all nodes on the same level 
    // as the main body but defined after it.
    vector< string > body_extra; 
    std::list< FieldDeclaration > field_declarations;
 
    // Contains ProtoDeclarations that existed when this protodeclaration was
    // created.
    X3D::PrototypeVector *existing_protos;
 
    AutoRef< Node > createProtoInstanceNodeX3D( PrototypeInstance *proto,
                                                X3D::DEFNodes *dn,
                                                const string &body_string );
 
    AutoRef< Node > createProtoInstanceNodeVRML( PrototypeInstance *proto,
                                                 X3D::DEFNodes *dn,
                                                 const string &body_string );
  };
 
}
 
#endif