mat.hxx

// mat.hxx -- a material in the scene graph.
// TODO: this class needs to be renamed.
//
// Written by Curtis Olson, started May 1998.
// Overhauled by David Megginson, December 2001
//
// Copyright (C) 1998 - 2000  Curtis L. Olson  - http://www.flightgear.org/~curt
//
// This program 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.
//
// This program 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 this program; if not, write to the Free Software
// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
//
// $Id: mat_8hxx_source.html,v 1.3 2010/02/23 22:10:15 curt Exp $


#ifndef _SG_MAT_HXX
#define _SG_MAT_HXX

#ifndef __cplusplus
# error This library requires C++
#endif

#include <simgear/compiler.h>

#include <string>      // Standard C++ string library
#include <vector>
#include <map>

#include <simgear/math/SGMath.hxx>

#include <osg/ref_ptr>
#include <osgDB/ReaderWriter>

namespace osg
{
class StateSet;
}

#include <simgear/props/props.hxx>
#include <simgear/structure/SGSharedPtr.hxx>
#include <simgear/scene/util/SGSceneFeatures.hxx>

#include "matmodel.hxx"

namespace simgear
{
class Effect;
void reload_shaders();
}

class SGMaterialGlyph;

class SGMaterial : public SGReferenced {

public:


  // Public Constructors.

  SGMaterial( const osgDB::ReaderWriter::Options*, const SGPropertyNode *props);

  ~SGMaterial( void );



  // Public methods.

  simgear::Effect *get_effect(int n = -1);

  inline int get_num() const { return _status.size(); }


  inline double get_xsize() const { return xsize; }


  inline double get_ysize() const { return ysize; }


  inline double get_light_coverage () const { return light_coverage; }

  inline double get_wood_coverage () const { return wood_coverage; }

  inline double get_tree_density () const { return tree_density; }
  
  inline double get_wood_size () const { return wood_size; }
  
  inline double get_tree_height () const { return tree_height; }

  inline double get_tree_width () const { return tree_width; }

  inline double get_tree_range () const { return tree_range; }
  
  inline int get_tree_varieties () const { return tree_varieties; }
  
  inline std::string get_tree_texture () const { return  tree_texture; }

  bool get_solid () const { return solid; }

  double get_friction_factor () const { return friction_factor; }

  double get_rolling_friction () const { return rolling_friction; }

  double get_bumpiness () const { return bumpiness; }

  double get_load_resistance () const { return load_resistance; }

  const std::vector<std::string>& get_names() const { return _names; }

  void add_name(const std::string& name) { _names.push_back(name); }

  int get_object_group_count () const { return object_groups.size(); }

  SGMatModelGroup * get_object_group (int index) const {
    return object_groups[index];
  }

  SGMaterialGlyph * get_glyph (const std::string& name) const;

  void set_light_color(const SGVec4f& color)
  { emission = color; }
  const SGVec4f& get_light_color() const
  { return emission; }

  SGVec2f get_tex_coord_scale() const
  {
    float tex_width = get_xsize();
    float tex_height = get_ysize();

    return SGVec2f((0 < tex_width) ? 1000.0f/tex_width : 1.0f,
                   (0 < tex_height) ? 1000.0f/tex_height : 1.0f);
  }

protected:


  // Protected methods.

  void init();

protected:

  struct _internal_state {
      _internal_state(simgear::Effect *e, const std::string &t, bool l,
                      const osgDB::ReaderWriter::Options *o);
      osg::ref_ptr<simgear::Effect> effect;
      std::string texture_path;
      bool effect_realized;
      osg::ref_ptr<const osgDB::ReaderWriter::Options> options;
  };

private:


  // Internal state.

  // texture status
  std::vector<_internal_state> _status;

  // Round-robin counter
  mutable unsigned int _current_ptr;

  // texture size
  double xsize, ysize;

  // wrap texture?
  bool wrapu, wrapv;

  // use mipmapping?
  bool mipmap;

  // coverage of night lighting.
  double light_coverage;
  
  // coverage of woods
  double wood_coverage;

  // The size of each wood
  double wood_size;

  // Tree density within the wood
  double tree_density;

  // Range at which trees become visible
  double tree_range;

  // Height of the tree
  double tree_height;

  // Width of the tree
  double tree_width;

  // Number of varieties of tree texture
  int tree_varieties;

  // True if the material is solid, false if it is a fluid
  bool solid;

  // the friction factor of that surface material
  double friction_factor;

  // the rolling friction of that surface material
  double rolling_friction;

  // the bumpiness of that surface material
  double bumpiness;

  // the load resistance of that surface material
  double load_resistance;

  // material properties
  SGVec4f ambient, diffuse, specular, emission;
  double shininess;

  // effect for this material
  std::string effect;

  // the list of names for this material. May be empty.
  std::vector<std::string> _names;

  std::vector<SGSharedPtr<SGMatModelGroup> > object_groups;

  // taxiway-/runway-sign texture elements
  std::map<std::string, SGSharedPtr<SGMaterialGlyph> > glyphs;
  
  // Tree texture, typically a strip of applicable tree textures
  std::string tree_texture;

  // Internal constructors and methods.

  void read_properties(const osgDB::ReaderWriter::Options* options,
                        const SGPropertyNode *props);
  void buildEffectProperties(const osgDB::ReaderWriter::Options* options);
};


class SGMaterialGlyph : public SGReferenced {
public:
  SGMaterialGlyph(SGPropertyNode *);
  inline double get_left() const { return _left; }
  inline double get_right() const { return _right; }
  inline double get_width() const { return _right - _left; }

protected:
  double _left;
  double _right;
};

class SGMaterialUserData : public osg::Referenced {
public:
  SGMaterialUserData(const SGMaterial* material) :
    mMaterial(material)
  {}
  const SGMaterial* getMaterial() const
  { return mMaterial; }
private:
  // this cannot be an SGSharedPtr since that would create a cicrular reference
  // making it impossible to ever free the space needed by SGMaterial
  const SGMaterial* mMaterial;
};

void
SGSetTextureFilter( int max);

int
SGGetTextureFilter();

#endif // _SG_MAT_HXX 

---