portalNode.h

Go to the documentation of this file.

/**
 * PANDA 3D SOFTWARE
 * Copyright (c) Carnegie Mellon University.  All rights reserved.
 *
 * All use of this software is subject to the terms of the revised BSD
 * license.  You should have received a copy of this license along
 * with this source code in a file named "LICENSE."
 *
 * @file portalNode.h
 * @author masad
 * @date 2004-05-13
 */

#ifndef PORTALNODE_H
#define PORTALNODE_H

#include "pandabase.h"

#include "portalMask.h"
#include "pandaNode.h"
#include "planeNode.h"
#include "nodePath.h"
#include "pvector.h"

/**
 * A node in the scene graph that can hold a Portal Polygon, which is a
 * rectangle.  Other types of polygons are not supported for now.  It also
 * holds a PT(PandaNode) Cell that this portal is connected to
 */
class EXPCL_PANDA_PGRAPH PortalNode : public PandaNode {
PUBLISHED:
  explicit PortalNode(const std::string &name);
  explicit PortalNode(const std::string &name, LPoint3 pos, PN_stdfloat scale=10.0);

protected:
  PortalNode(const PortalNode &copy);

public:
  virtual ~PortalNode();
  virtual PandaNode *make_copy() const;
  virtual bool preserve_name() const;
  virtual void xform(const LMatrix4 &mat);
  virtual PandaNode *combine_with(PandaNode *other);

  virtual void enable_clipping_planes();

  virtual bool cull_callback(CullTraverser *trav, CullTraverserData &data);
  virtual bool is_renderable() const;

  virtual void output(std::ostream &out) const;

PUBLISHED:
  INLINE void set_portal_mask(PortalMask mask);
  INLINE void set_from_portal_mask(PortalMask mask);
  INLINE void set_into_portal_mask(PortalMask mask);
  INLINE PortalMask get_from_portal_mask() const;
  INLINE PortalMask get_into_portal_mask() const;

  INLINE void set_portal_geom(bool flag);
  INLINE bool get_portal_geom() const;

  INLINE void clear_vertices();
  INLINE void add_vertex(const LPoint3 &vertex);

  INLINE int get_num_vertices() const;
  INLINE const LPoint3 &get_vertex(int n) const;
  MAKE_SEQ(get_vertices, get_num_vertices, get_vertex);

  INLINE void set_cell_in(const NodePath &cell);
  INLINE NodePath get_cell_in() const;

  INLINE void set_cell_out(const NodePath &cell);
  INLINE NodePath get_cell_out() const;

  INLINE void set_clip_plane(bool value);
  INLINE bool is_clip_plane();

  INLINE void set_visible(bool value);
  INLINE bool is_visible();

  INLINE void set_max_depth(int value);
  INLINE int get_max_depth();

  INLINE void set_open(bool value);
  INLINE bool is_open();

  // void draw () const;

  MAKE_PROPERTY(into_portal_mask, get_into_portal_mask, set_into_portal_mask);
  MAKE_PROPERTY(from_portal_mask, get_from_portal_mask, set_from_portal_mask);
  MAKE_PROPERTY(portal_geom, get_portal_geom, set_portal_geom);
  MAKE_SEQ_PROPERTY(vertices, get_num_vertices, get_vertex);
  MAKE_PROPERTY(cell_in, get_cell_in, set_cell_in);
  MAKE_PROPERTY(cell_out, get_cell_out, set_cell_out);
  MAKE_PROPERTY(clip_plane, is_clip_plane, set_clip_plane);
  MAKE_PROPERTY(visible, is_visible, set_visible);
  MAKE_PROPERTY(max_depth, get_max_depth, set_max_depth);
  MAKE_PROPERTY(open, is_open, set_open);

protected:
  virtual void compute_internal_bounds(CPT(BoundingVolume) &internal_bounds,
                                       int &internal_vertices,
                                       int pipeline_stage,
                                       Thread *current_thread) const;

private:
  CPT(RenderState) get_last_pos_state();

  // This data is not cycled, for now.  We assume the collision traversal will
  // take place in App only.  Perhaps we will revisit this later.
  PortalMask _from_portal_mask;
  PortalMask _into_portal_mask;

  enum Flags {
    F_portal_geom = 0x0001,
    // Presently only 8 bits are written to the bam file.
  };
  int _flags;

  typedef pvector<LPoint3> Vertices;
  Vertices _vertices;

  NodePath _cell_in;  // This is the cell it resides in
  NodePath _cell_out;  // This is the cell it leads out to

  // enable plane clipping on this portal
  bool _clip_plane;
  PT(PlaneNode) _left_plane_node;
  PT(PlaneNode) _right_plane_node;
  PT(PlaneNode) _top_plane_node;
  PT(PlaneNode) _bottom_plane_node;
  CPT(RenderState) _clip_state;

  bool _visible;
  bool _open;
  int _max_depth;

public:
  static void register_with_read_factory();
  virtual void write_datagram(BamWriter *manager, Datagram &dg);
  virtual int complete_pointers(TypedWritable **plist, BamReader *manager);

protected:
  static TypedWritable *make_from_bam(const FactoryParams &params);
  void fillin(DatagramIterator &scan, BamReader *manager);

public:
  static TypeHandle get_class_type() {
    return _type_handle;
  }
  static void init_type() {
    PandaNode::init_type();
    register_type(_type_handle, "PortalNode",
                  PandaNode::get_class_type());
  }
  virtual TypeHandle get_type() const {
    return get_class_type();
  }
  virtual TypeHandle force_init_type() {init_type(); return get_class_type();}

private:
  static TypeHandle _type_handle;
};

#include "portalNode.I"

#endif