entity_renderer.hh

Go to the documentation of this file.

//------------------------------------------------------------------------------
// This file is part of the OpenStructure project <www.openstructure.org>
//
// Copyright (C) 2008-2020 by the OpenStructure authors
//
// This library is free software; you can redistribute it and/or modify it under
// the terms of the GNU Lesser General Public License as published by the Free
// Software Foundation; either version 3.0 of the License, or (at your option)
// any later version.
// This library 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 Lesser General Public License for more
// details.
//
// You should have received a copy of the GNU Lesser General Public License
// along with this library; if not, write to the Free Software Foundation, Inc.,
// 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
//------------------------------------------------------------------------------
#ifndef OST_GFX_ENTITY_RENDERER_HH
#define OST_GFX_ENTITY_RENDERER_HH

/*
  Author: Stefan Scheuber, Marco Biasini
*/


#if defined(GetAtomProps)
#undef GetAtomProps
#endif
#include <vector>

#include <ost/mol/query_view_wrapper.hh>
#include <ost/mol/entity_view.hh>
#include <ost/mol/atom_handle.hh>
#include <ost/mol/entity_property_mapper.hh>

#include <ost/gfx/color.hh>
#include <ost/gfx/gfx_object.hh>
#include <ost/gfx/module_config.hh>
#include <ost/gfx/render_pass.hh>
#include <ost/gfx/vertex_array.hh>
#include <ost/gfx/exporter_fw.hh>

#include <ost/gfx/render_options/render_options.hh>

#include <ost/gfx/color_ops/color_op.hh>
#include <ost/gfx/color_ops/by_element_color_op.hh>
#include <ost/gfx/color_ops/by_chain_color_op.hh>
#include <ost/gfx/color_ops/uniform_color_op.hh>
#include <ost/gfx/color_ops/gradient_level_color_op.hh>
#include <ost/gfx/color_ops/entity_view_color_op.hh>
#include <ost/gfx/color_ops/map_handle_color_op.hh>

#include "mapped_property.hh"
#include "entity_renderer_fw.hh"

namespace ost { namespace gfx { namespace impl {

typedef enum {
  DIRTY_VIEW   = 0x1,
  DIRTY_VA     = 0x2
} DirtyFlag;

typedef unsigned int DirtyFlags;

class DLLEXPORT_OST_GFX EntityRenderer {
public:
  EntityRenderer();
  virtual ~EntityRenderer(){}

  void AddView(const mol::EntityView& view);
  
  void SubstractView(const mol::EntityView& view);
  void ClearViews();
  
  virtual bool HasDataToRender() const;
  
  virtual const String& GetName() const;

  void SetEnabled(bool enabled=true);

  bool IsEnabled() const;

  bool HasSelection() const;
  
  void SetSelection(const mol::EntityView& sel);
  
  void SetVisible(const mol::EntityView& view, bool visible);

  const Color& GetSelectionColor() const;
  
  const Color& GetSelectionColorOutline() const;
  
  mol::EntityView GetFullView();

  mol::EntityView GetEffectiveView();

  virtual void UpdateViews()=0;
  
  virtual void PrepareRendering()=0;

  virtual void Render(RenderPass pass);
  
  virtual void RenderPov(PovState& pov, const std::string& name);

  virtual void Export(Exporter* ex);

  virtual bool CanSetOptions(RenderOptionsPtr& render_options)=0;
  virtual void SetOptions(RenderOptionsPtr& render_options)=0;
  
  virtual RenderOptionsPtr GetOptions()=0;

  virtual geom::AlignedCuboid GetBoundingBox() const=0;
  
  virtual void PickAtom(const geom::Line3& line, Real line_width,
                        mol::AtomHandle& picked_atom)=0;

  virtual void PickBond(const geom::Line3& line, Real line_width,
                        mol::BondHandle& picked_bond)=0;

  virtual void RenderOptionsChanged();

  virtual void Apply(const gfx::ByElementColorOp& op)=0;
  virtual void Apply(const gfx::ByChainColorOp& op)=0;
  virtual void Apply(const gfx::UniformColorOp& op)=0;
  virtual void Apply(const gfx::GradientLevelColorOp& op)=0;
  virtual void Apply(const gfx::EntityViewColorOp& op)=0;
  virtual void Apply(const gfx::MapHandleColorOp& op)=0;

  bool IsDirty() const;
  
  void FlagPositionsDirty();

  void Debug(unsigned int flags);

  IndexedVertexArray& VA() {return va_;}
protected:
  virtual void SetName(const String& name);

  String                name_;
  bool                  enabled_;

  mol::EntityView       full_view_;
  mol::EntityView       effective_view_;
  mol::EntityView       hidden_view_;
  IndexedVertexArray    va_;
  
  mol::EntityView       sel_;
  mol::EntityView       full_sel_;
  IndexedVertexArray    sel_va_;
  
  DirtyFlags            sel_state_;
  DirtyFlags            state_;
  unsigned int          debug_flags_;
  float                 opacity_;
};

//Simplify color ops
struct ByElementGetCol {
  std::pair<bool,Color> ColorOfAtom(mol::AtomHandle& atom) const{
    return std::make_pair(true,GfxObj::Ele2Color(atom.GetElement()));
  }
};

struct ByChainGetCol {
  ByChainGetCol(const ByChainColorOp& op):op_(op){}
  std::pair<bool,Color> ColorOfAtom(mol::AtomHandle& atom) const{
    return std::make_pair(true,op_.GetColor(atom.GetResidue().GetChain().GetName()));
  }
  const ByChainColorOp& op_;
};

struct UniformGetCol {
  UniformGetCol(const Color& col):col_(col){ }
  std::pair<bool,Color> ColorOfAtom(mol::AtomHandle& atom) const{
    return std::make_pair(true,col_);
  }
  const Color& col_;
};

struct GradientLevelGetCol {
  GradientLevelGetCol(const GradientLevelColorOp& op):
    property_(op.GetProperty()),
    epm_(property_, op.GetLevel()),
    gradient_(op.GetGradient()),
    minv_(op.GetMinV()),
    maxv_(op.GetMaxV()),
    clamp_(op.GetClamp())
  {}
  std::pair<bool,Color> ColorOfAtom(mol::AtomHandle& atom) const{
    try{
      float r = epm_.Get(atom, minv_);
      if(clamp_) {
        float n=Normalize(r, minv_, maxv_);
        return std::make_pair(true,gradient_.GetColorAt(n));
      } else {
        if(r>=minv_ && r<=maxv_) {
          float n=Normalize(r, minv_, maxv_);
          return std::make_pair(true,gradient_.GetColorAt(n));
        } else {
          return std::make_pair(false,Color());
        }
      }
    }catch(std::exception&){
      LOG_DEBUG("property " << property_ << " not found");
      return std::make_pair(false,Color());
    }
    return std::make_pair(false,Color());
  }
  String property_;
  mol::EntityPropertyMapper epm_;
  Gradient gradient_;
  float minv_, maxv_;
  bool clamp_;
};

struct EntityViewGetCol {
  EntityViewGetCol(const EntityViewColorOp& op):property_(op.GetProperty()),
      ev_(op.GetEntityView()),
      gradient_(op.GetGradient()),
      minv_(op.GetMinV()),
      maxv_(op.GetMaxV()){}
  std::pair<bool,Color> ColorOfAtom(mol::AtomHandle& atom) const{
    return std::make_pair(true,MappedProperty(ev_,property_,gradient_,minv_,maxv_,atom.GetPos()));
  }
  String property_;
  mol::EntityView ev_;
  Gradient gradient_;
  float minv_, maxv_;
};

struct MapHandleGetCol {
  MapHandleGetCol(const MapHandleColorOp& op):property_(op.GetProperty()),
      mh_(op.GetMapHandle()),
      gradient_(op.GetGradient()),
      minv_(op.GetMinV()),
      maxv_(op.GetMaxV()){}
  std::pair<bool,Color> ColorOfAtom(mol::AtomHandle& atom) const{
    return std::make_pair(true,MappedProperty(mh_,property_,gradient_,minv_,maxv_,atom.GetPos()));
  }
  String property_;
  img::MapHandle mh_;
  Gradient gradient_;
  float minv_, maxv_;
};

}}} //ns

#endif /* ENTITYRENDERER_HH_ */