eggRenderMode.I

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 eggRenderMode.I
 * @author drose
 * @date 1999-01-20
 */

/**
 *
 */
INLINE EggRenderMode::
EggRenderMode(const EggRenderMode &copy) {
  (*this) = copy;
}

/**
 * Specifies whether writes should be made to the depth buffer (assuming the
 * rendering backend provides a depth buffer) when rendering this geometry.
 */
INLINE void EggRenderMode::
set_depth_write_mode(DepthWriteMode mode) {
  _depth_write_mode = mode;
}

/**
 * Returns the depth_write mode that was set, or DWM_unspecified if nothing
 * was set.  See set_depth_write_mode().
 */
INLINE EggRenderMode::DepthWriteMode EggRenderMode::
get_depth_write_mode() const {
  return _depth_write_mode;
}

/**
 * Specifies whether this geometry should be tested against the depth buffer
 * when it is drawn (assuming the rendering backend provides a depth buffer).
 * Note that this is different, and independent from, the depth_write mode.
 */
INLINE void EggRenderMode::
set_depth_test_mode(DepthTestMode mode) {
  _depth_test_mode = mode;
}

/**
 * Returns the depth_test mode that was set, or DTM_unspecified if nothing was
 * set.  See set_depth_test_mode().
 */
INLINE EggRenderMode::DepthTestMode EggRenderMode::
get_depth_test_mode() const {
  return _depth_test_mode;
}

/**
 * Specifies whether this geometry is to be considered normally visible, or
 * hidden.  If it is hidden, it is either not loaded into the scene graph at
 * all, or loaded as a "stashed" node, according to the setting of egg-
 * suppress-hidden.
 */
INLINE void EggRenderMode::
set_visibility_mode(VisibilityMode mode) {
  _visibility_mode = mode;
}

/**
 * Returns the visibility mode that was set, or VM_unspecified if nothing was
 * set.  See set_visibility_mode().
 */
INLINE EggRenderMode::VisibilityMode EggRenderMode::
get_visibility_mode() const {
  return _visibility_mode;
}

/**
 * Specifies precisely how the transparency for this geometry should be
 * achieved, or if it should be used.  The default, AM_unspecified, is to use
 * transparency if the geometry has a color whose alpha value is non-1, or if
 * it has a four-channel texture applied; otherwise, AM_on forces transparency
 * on, and AM_off forces it off.  The other flavors of transparency are
 * specific ways to turn on transparency, which may or may not be supported by
 * a particular rendering backend.
 */
INLINE void EggRenderMode::
set_alpha_mode(AlphaMode mode) {
  _alpha_mode = mode;
}

/**
 * Returns the alpha mode that was set, or AM_unspecified if nothing was set.
 * See set_alpha_mode().
 */
INLINE EggRenderMode::AlphaMode EggRenderMode::
get_alpha_mode() const {
  return _alpha_mode;
}

/**
 * Sets the "depth-offset" flag associated with this object.  This adds or
 * subtracts an offset bias into the depth buffer.  See also DepthOffsetAttrib
 * and NodePath::set_depth_offset().
 */
INLINE void EggRenderMode::
set_depth_offset(int order) {
  _depth_offset = order;
  _has_depth_offset = true;
}


/**
 * Returns the "depth-offset" flag as set for this particular object.  See
 * set_depth_offset().
 */
INLINE int EggRenderMode::
get_depth_offset() const {
  return _depth_offset;
}

/**
 * Returns true if the depth-offset flag has been set for this particular
 * object.  See set_depth_offset().
 */
INLINE bool EggRenderMode::
has_depth_offset() const {
  return _has_depth_offset;
}

/**
 * Removes the depth-offset flag from this particular object.  See
 * set_depth_offset().
 */
INLINE void EggRenderMode::
clear_depth_offset() {
  _has_depth_offset = false;
}


/**
 * Sets the "draw-order" flag associated with this object.  This specifies a
 * particular order in which objects of this type should be drawn, within the
 * specified bin.  If a bin is not explicitly specified, "fixed" is used.  See
 * also set_bin().
 */
INLINE void EggRenderMode::
set_draw_order(int order) {
  _draw_order = order;
  _has_draw_order = true;
}

/**
 * Returns the "draw-order" flag as set for this particular object.  See
 * set_draw_order().
 */
INLINE int EggRenderMode::
get_draw_order() const {
  return _draw_order;
}

/**
 * Returns true if the draw-order flag has been set for this particular
 * object.  See set_draw_order().
 */
INLINE bool EggRenderMode::
has_draw_order() const {
  return _has_draw_order;
}

/**
 * Removes the draw-order flag from this particular object.  See
 * set_draw_order().
 */
INLINE void EggRenderMode::
clear_draw_order() {
  _has_draw_order = false;
}

/**
 * Sets the "bin" string for this particular object.  This names a particular
 * bin in which the object should be rendered.  The exact meaning of a bin is
 * implementation defined, but generally a GeomBin matching each bin name must
 * also be specifically added to the rendering engine (e.g.  the
 * CullTraverser) in use for this to work.  See also set_draw_order().
 */
INLINE void EggRenderMode::
set_bin(const std::string &bin) {
  _bin = bin;
}

/**
 * Returns the bin name that has been set for this particular object, if any.
 * See set_bin().
 */
INLINE std::string EggRenderMode::
get_bin() const {
  return _bin;
}

/**
 * Returns true if a bin name has been set for this particular object.  See
 * set_bin().
 */
INLINE bool EggRenderMode::
has_bin() const {
  return !_bin.empty();
}

/**
 * Removes the bin name that was set for this particular object.  See
 * set_bin().
 */
INLINE void EggRenderMode::
clear_bin() {
  _bin = std::string();
}

/**
 *
 */
INLINE bool EggRenderMode::
operator != (const EggRenderMode &other) const {
  return !(*this == other);
}