displayRegion.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 displayRegion.I
 * @author frang
 * @date 1999-03-07
 */

/**
 * Returns true if this DisplayRegion should be sorted before the other one,
 * false otherwise.
 */
INLINE bool DisplayRegion::
operator < (const DisplayRegion &other) const {
  return get_sort() < other.get_sort();
}

/**
 * Returns the specific lens of the associated Camera that will be used for
 * rendering this scene.  Most Cameras hold only one lens, but for multiple
 * lenses this method may be used to selected between them.
 */
INLINE int DisplayRegion::
get_lens_index() const {
  CDReader cdata(_cycler);
  return cdata->_lens_index;
}

/**
 * Returns the number of regions, see set_num_regions.
 */
INLINE int DisplayRegion::
get_num_regions() const {
  CDReader cdata(_cycler);
  return cdata->_regions.size();
}

/**
 * Sets the number of regions that this DisplayRegion indicates.  Usually,
 * this number is 1 (and it is always at least 1), and only the first is used
 * for rendering.  However, if more than one is provided, you may select which
 * one to render into using a geometry shader (gl_ViewportIndex in GLSL).
 */
INLINE void DisplayRegion::
set_num_regions(int i) {
  nassertv(i >= 1);
  CDWriter cdata(_cycler);
  cdata->_regions.resize(i);
}

/**
 * Retrieves the coordinates of the DisplayRegion's rectangle within its
 * GraphicsOutput.  These numbers will be in the range [0..1].
 */
INLINE void DisplayRegion::
get_dimensions(PN_stdfloat &l, PN_stdfloat &r, PN_stdfloat &b, PN_stdfloat &t) const {
  get_dimensions(0, l, r, b, t);
}

/**
 * Retrieves the coordinates of the DisplayRegion's rectangle within its
 * GraphicsOutput.  These numbers will be in the range [0..1].
 */
INLINE void DisplayRegion::
get_dimensions(int i, PN_stdfloat &l, PN_stdfloat &r, PN_stdfloat &b, PN_stdfloat &t) const {
  CDReader cdata(_cycler);
  const Region &region = cdata->_regions[i];
  l = region._dimensions[0];
  r = region._dimensions[1];
  b = region._dimensions[2];
  t = region._dimensions[3];
}

/**
 * Retrieves the coordinates of the DisplayRegion's rectangle within its
 * GraphicsOutput.  These numbers will be in the range [0..1].
 */
INLINE LVecBase4 DisplayRegion::
get_dimensions(int i) const {
  CDReader cdata(_cycler);
  return cdata->_regions[i]._dimensions;
}

/**
 * Retrieves the x coordinate of the left edge of the rectangle within its
 * GraphicsOutput.  This number will be in the range [0..1].
 */
INLINE PN_stdfloat DisplayRegion::
get_left(int i) const {
  CDReader cdata(_cycler);
  return cdata->_regions[i]._dimensions[0];
}

/**
 * Retrieves the x coordinate of the right edge of the rectangle within its
 * GraphicsOutput.  This number will be in the range [0..1].
 */
INLINE PN_stdfloat DisplayRegion::
get_right(int i) const {
  CDReader cdata(_cycler);
  return cdata->_regions[i]._dimensions[1];
}

/**
 * Retrieves the y coordinate of the bottom edge of the rectangle within its
 * GraphicsOutput.  This number will be in the range [0..1].
 */
INLINE PN_stdfloat DisplayRegion::
get_bottom(int i) const {
  CDReader cdata(_cycler);
  return cdata->_regions[i]._dimensions[2];
}

/**
 * Retrieves the y coordinate of the top edge of the rectangle within its
 * GraphicsOutput.  This number will be in the range [0..1].
 */
INLINE PN_stdfloat DisplayRegion::
get_top(int i) const {
  CDReader cdata(_cycler);
  return cdata->_regions[i]._dimensions[3];
}

/**
 * Changes the portion of the framebuffer this DisplayRegion corresponds to.
 * The parameters range from 0 to 1, where 0,0 is the lower left corner and
 * 1,1 is the upper right; (0, 1, 0, 1) represents the whole screen.
 */
INLINE void DisplayRegion::
set_dimensions(PN_stdfloat l, PN_stdfloat r, PN_stdfloat b, PN_stdfloat t) {
  set_dimensions(0, LVecBase4(l, r, b, t));
}

/**
 * Changes the portion of the framebuffer this DisplayRegion corresponds to.
 * The parameters range from 0 to 1, where 0,0 is the lower left corner and
 * 1,1 is the upper right; (0, 1, 0, 1) represents the whole screen.
 */
INLINE void DisplayRegion::
set_dimensions(int i, PN_stdfloat l, PN_stdfloat r, PN_stdfloat b, PN_stdfloat t) {
  set_dimensions(i, LVecBase4(l, r, b, t));
}

/**
 * Changes the portion of the framebuffer this DisplayRegion corresponds to.
 * The parameters range from 0 to 1, where 0,0 is the lower left corner and
 * 1,1 is the upper right; (0, 1, 0, 1) represents the whole screen.
 */
INLINE void DisplayRegion::
set_dimensions(const LVecBase4 &dimensions) {
  set_dimensions(0, dimensions);
}

/**
 * Returns the GraphicsOutput that this DisplayRegion is ultimately associated
 * with, or NULL if no window is associated.
 */
INLINE GraphicsOutput *DisplayRegion::
get_window() const {
  return _window;
}

/**
 * Returns the camera associated with this DisplayRegion, or an empty NodePath
 * if no camera is associated.
 */
INLINE NodePath DisplayRegion::
get_camera(Thread *current_thread) const {
  CDReader cdata(_cycler, current_thread);
  return cdata->_camera;
}

/**
 * Returns the active flag associated with the DisplayRegion.
 */
INLINE bool DisplayRegion::
is_active() const {
  CDReader cdata(_cycler);
  return cdata->_active;
}

/**
 * Returns the sort value associated with the DisplayRegion.
 */
INLINE int DisplayRegion::
get_sort() const {
  CDReader cdata(_cycler);
  return cdata->_sort;
}

/**
 * Returns whether the DisplayRegion is specified as the left or right channel
 * of a stereo pair, or whether it is a normal, monocular image.  See
 * set_stereo_channel().
 */
INLINE Lens::StereoChannel DisplayRegion::
get_stereo_channel() const {
  CDReader cdata(_cycler);
  return cdata->_stereo_channel;
}

/**
 * Returns the current texture view offset for this DisplayRegion.  This is
 * normally set to zero.  If nonzero, it is used to select a particular view
 * of any multiview textures that are rendered within this DisplayRegion.
 *
 * For a StereoDisplayRegion, this is normally 0 for the left eye, and 1 for
 * the right eye, to support stereo textures.
 */
INLINE int DisplayRegion::
get_tex_view_offset() const {
  CDReader cdata(_cycler);
  return cdata->_tex_view_offset;
}

/**
 * Returns the incomplete_render flag.  See set_incomplete_render().
 */
INLINE bool DisplayRegion::
get_incomplete_render() const {
  return _incomplete_render;
}

/**
 * Returns the priority which is assigned to asynchronous texture reload
 * requests.  See set_texture_reload_priority().
 */
INLINE int DisplayRegion::
get_texture_reload_priority() const {
  return _texture_reload_priority;
}

/**
 * Deprecated; replaced by set_target_tex_page().
 */
INLINE void DisplayRegion::
set_cube_map_index(int cube_map_index) {
  set_target_tex_page(cube_map_index);
}

/**
 * Returns the target page number associated with this particular
 * DisplayRegion, or -1 if it is not associated with a page.  See
 * set_target_tex_page().
 */
INLINE int DisplayRegion::
get_target_tex_page() const {
  CDReader cdata(_cycler);
  return cdata->_target_tex_page;
}

/**
 * Sets whether or not scissor testing is enabled for this region.  The
 * default is true, except for the overlay display region.
 */
INLINE void DisplayRegion::
set_scissor_enabled(bool scissor_enabled) {
  CDWriter cdata(_cycler);
  cdata->_scissor_enabled = scissor_enabled;
}

/**
 * Returns whether or not scissor testing is enabled for this region.  The
 * default is true, except for the overlay display region.
 */
INLINE bool DisplayRegion::
get_scissor_enabled() const {
  CDReader cdata(_cycler);
  return cdata->_scissor_enabled;
}

/**
 * Sets the CallbackObject that will be notified when the DisplayRegion is
 * visited during the cull traversal.  This callback will be made during the
 * cull thread.
 *
 * The cull traversal is responsible for determining which nodes are visible
 * and within the view frustum, and for accumulating state and transform, and
 * generally building up the list of CullableObjects that are to be eventually
 * passed to the draw traversal for rendering.
 *
 * At the time the cull traversal callback is made, the traversal for this
 * DisplayRegion has not yet started.
 *
 * The callback is passed an instance of a DisplayRegionCullCallbackData,
 * which contains pointers to the current scene information, as well as the
 * current DisplayRegion and GSG.  The callback *replaces* the normal cull
 * behavior, so if your callback does nothing, the scene graph will not be
 * traversed and therefore nothing will be drawn.  If you wish the normal cull
 * traversal to be performed for this DisplayRegion, you must call
 * cbdata->upcall() from your callback.
 */
INLINE void DisplayRegion::
set_cull_callback(CallbackObject *object) {
  CDWriter cdata(_cycler);
  cdata->_cull_callback = object;
}

/**
 * Removes the callback set by an earlier call to set_cull_callback().
 */
INLINE void DisplayRegion::
clear_cull_callback() {
  set_cull_callback(nullptr);
}

/**
 * Returns the CallbackObject set by set_cull_callback().
 */
INLINE CallbackObject *DisplayRegion::
get_cull_callback() const {
  CDReader cdata(_cycler);
  return cdata->_cull_callback;
}

/**
 * Sets the CallbackObject that will be notified when the contents of
 * DisplayRegion is drawn during the draw traversal.  This callback will be
 * made during the draw thread.
 *
 * The draw traversal is responsible for actually issuing the commands to the
 * graphics engine to draw primitives.  Its job is to walk through the list of
 * CullableObjects build up by the cull traversal, as quickly as possible,
 * issuing the appropriate commands to draw each one.
 *
 * At the time the draw traversal callback is made, the graphics state is in
 * the initial state, and no projection matrix or modelview matrix is in
 * effect.  begin_scene() has not yet been called, and no objects have yet
 * been drawn.  However, the viewport has already been set to the appropriate
 * part of the window, and the clear commands for this DisplayRegion (if any)
 * have been issued.
 *
 * The callback is passed an instance of a DisplayRegionDrawCallbackData,
 * which contains pointers to the current scene information, as well as the
 * current DisplayRegion and GSG.  The callback *replaces* the normal draw
 * behavior, so if your callback does nothing, nothing in the DisplayRegion
 * will be drawn.  If you wish the draw traversal to continue to draw the
 * contents of this DisplayRegion, you must call cbdata->upcall() from your
 * callback.
 */
INLINE void DisplayRegion::
set_draw_callback(CallbackObject *object) {
  CDWriter cdata(_cycler);
  cdata->_draw_callback = object;
}

/**
 * Removes the callback set by an earlier call to set_draw_callback().
 */
INLINE void DisplayRegion::
clear_draw_callback() {
  set_draw_callback(nullptr);
}

/**
 * Returns the CallbackObject set by set_draw_callback().
 */
INLINE CallbackObject *DisplayRegion::
get_draw_callback() const {
  CDReader cdata(_cycler);
  return cdata->_draw_callback;
}

/**
 * Returns the width of the DisplayRegion in pixels.
 */
INLINE int DisplayRegion::
get_pixel_width(int i) const {
  CDReader cdata(_cycler);
  return cdata->_regions[i]._pixels[1] - cdata->_regions[i]._pixels[0];
}

/**
 * Returns the height of the DisplayRegion in pixels.
 */
INLINE int DisplayRegion::
get_pixel_height(int i) const {
  CDReader cdata(_cycler);
  return cdata->_regions[i]._pixels[3] - cdata->_regions[i]._pixels[2];
}

/**
 * Returns the size of the DisplayRegion in pixels.
 */
INLINE LVecBase2i DisplayRegion::
get_pixel_size(int i) const {
  CDReader cdata(_cycler);
  return LVecBase2i(cdata->_regions[i]._pixels[1] - cdata->_regions[i]._pixels[0],
                    cdata->_regions[i]._pixels[3] - cdata->_regions[i]._pixels[2]);
}

/**
 * Retrieves the coordinates of the DisplayRegion within its window, in
 * pixels.
 */
INLINE void DisplayRegion::
get_pixels(int &pl, int &pr, int &pb, int &pt) const {
  get_pixels(0, pl, pr, pb, pt);
}

/**
 * Retrieves the coordinates of the DisplayRegion within its window, in
 * pixels.
 */
INLINE void DisplayRegion::
get_pixels(int i, int &pl, int &pr, int &pb, int &pt) const {
  CDReader cdata(_cycler);
  const Region &region = cdata->_regions[i];
  pl = region._pixels[0];
  pr = region._pixels[1];
  pb = region._pixels[2];
  pt = region._pixels[3];
}

/**
 * Retrieves the coordinates of the DisplayRegion within its window, as the
 * pixel location of its bottom-left corner, along with a pixel width and
 * height.
 */
INLINE void DisplayRegion::
get_region_pixels(int &xo, int &yo, int &w, int &h) const {
  get_region_pixels(0, xo, yo, w, h);
}

/**
 * Retrieves the coordinates of the DisplayRegion within its window, as the
 * pixel location of its bottom-left corner, along with a pixel width and
 * height.
 */
INLINE void DisplayRegion::
get_region_pixels(int i, int &xo, int &yo, int &w, int &h) const {
  CDReader cdata(_cycler);
  const Region &region = cdata->_regions[i];
  xo = region._pixels[0];
  yo = region._pixels[2];
  w = region._pixels[1] - xo;
  h = region._pixels[3] - yo;
}

/**
 * Similar to get_region_pixels(), but returns the upper left corner, and the
 * pixel numbers are numbered from the top-left corner down, in the DirectX
 * way of things.
 */
INLINE void DisplayRegion::
get_region_pixels_i(int &xo, int &yo, int &w, int &h) const {
  get_region_pixels_i(0, xo, yo, w, h);
}

/**
 * Similar to get_region_pixels(), but returns the upper left corner, and the
 * pixel numbers are numbered from the top-left corner down, in the DirectX
 * way of things.
 */
INLINE void DisplayRegion::
get_region_pixels_i(int i, int &xo, int &yo, int &w, int &h) const {
  CDReader cdata(_cycler);
  const Region &region = cdata->_regions[i];
  xo = region._pixels_i[0];
  yo = region._pixels_i[3];
  w = region._pixels_i[1] - xo;
  h = region._pixels_i[2] - yo;
}

/**
 * Stores the result of performing a cull operation on this DisplayRegion.
 * Normally, this will only be called by the GraphicsEngine; you should not
 * call this directly.
 *
 * The stored result will automatically be applied back to all upstream
 * pipeline stages.
 */
INLINE void DisplayRegion::
set_cull_result(PT(CullResult) cull_result, PT(SceneSetup) scene_setup,
                Thread *current_thread) {
  CDCullWriter cdata(_cycler_cull, true, current_thread);
  cdata->_cull_result = std::move(cull_result);
  cdata->_scene_setup = std::move(scene_setup);
}

/**
 * Returns the CullResult value that was stored on this DisplayRegion,
 * presumably by the last successful cull operation.  This method is for the
 * benefit of the GraphicsEngine; normally you shouldn't call this directly.
 */
INLINE CullResult *DisplayRegion::
get_cull_result(Thread *current_thread) const {
  CDCullReader cdata(_cycler_cull, current_thread);
  return cdata->_cull_result;
}

/**
 * Returns the SceneSetup value that was stored on this DisplayRegion,
 * presumably by the last successful cull operation.  This method is for the
 * benefit of the GraphicsEngine; normally you shouldn't call this directly.
 */
INLINE SceneSetup *DisplayRegion::
get_scene_setup(Thread *current_thread) const {
  CDCullReader cdata(_cycler_cull, current_thread);
  return cdata->_scene_setup;
}

/**
 * Returns a PStatCollector for timing the cull operation for just this
 * DisplayRegion.
 */
INLINE PStatCollector &DisplayRegion::
get_cull_region_pcollector() {
  return _cull_region_pcollector;
}

/**
 * Returns a PStatCollector for timing the draw operation for just this
 * DisplayRegion.
 */
INLINE PStatCollector &DisplayRegion::
get_draw_region_pcollector() {
  return _draw_region_pcollector;
}

/**
 * Returns a unique name used for debugging.
 */
INLINE const std::string &DisplayRegion::
get_debug_name() const {
  return _debug_name;
}

/**
 *
 */
INLINE DisplayRegion::Region::
Region() :
  _dimensions(0, 1, 0, 1),
  _pixels(0),
  _pixels_i(0) {
}

/**
 *
 */
INLINE DisplayRegion::CDataCull::
CDataCull() {
}

/**
 *
 */
INLINE DisplayRegion::CDataCull::
CDataCull(const DisplayRegion::CDataCull &copy) :
  _cull_result(copy._cull_result),
  _scene_setup(copy._scene_setup)
{
}

/**
 *
 */
INLINE DisplayRegionPipelineReader::
DisplayRegionPipelineReader(DisplayRegion *object, Thread *current_thread) :
  _object(object),
  _current_thread(current_thread),
  _cdata(object->_cycler.read(current_thread))
{
#ifdef _DEBUG
  nassertv(_object->test_ref_count_nonzero());
#ifdef DO_PIPELINING
  nassertv(_cdata->test_ref_count_nonzero());
#endif  // DO_PIPELINING
#endif // _DEBUG
}

/**
 *
 */
INLINE DisplayRegionPipelineReader::
~DisplayRegionPipelineReader() {
#ifdef _DEBUG
  nassertv(_object->test_ref_count_nonzero());
#ifdef DO_PIPELINING
  nassertv(_cdata->test_ref_count_nonzero());
#endif  // DO_PIPELINING
#endif // _DEBUG
  _object->_cycler.release_read(_cdata);

#ifdef _DEBUG
  _object = nullptr;
  _cdata = nullptr;
#endif  // _DEBUG
}

/**
 *
 */
INLINE DisplayRegion *DisplayRegionPipelineReader::
get_object() const {
  return _object;
}

/**
 *
 */
INLINE Thread *DisplayRegionPipelineReader::
get_current_thread() const {
  return _current_thread;
}

/**
 *
 */
INLINE bool DisplayRegionPipelineReader::
is_any_clear_active() const {
  return _object->is_any_clear_active();
}

/**
 * Returns the number of regions, see set_num_regions.
 */
INLINE int DisplayRegionPipelineReader::
get_num_regions() const {
  return _cdata->_regions.size();
}

/**
 * Retrieves the coordinates of the DisplayRegion's rectangle within its
 * GraphicsOutput.  These numbers will be in the range [0..1].
 */
INLINE void DisplayRegionPipelineReader::
get_dimensions(PN_stdfloat &l, PN_stdfloat &r, PN_stdfloat &b, PN_stdfloat &t) const {
  return get_dimensions(0, l, r, b, t);
}

/**
 * Retrieves the coordinates of the DisplayRegion's rectangle within its
 * GraphicsOutput.  These numbers will be in the range [0..1].
 */
INLINE void DisplayRegionPipelineReader::
get_dimensions(int i, PN_stdfloat &l, PN_stdfloat &r, PN_stdfloat &b, PN_stdfloat &t) const {
  const DisplayRegion::Region &region = _cdata->_regions[i];
  l = region._dimensions[0];
  r = region._dimensions[1];
  b = region._dimensions[2];
  t = region._dimensions[3];
}

/**
 * Retrieves the coordinates of the DisplayRegion's rectangle within its
 * GraphicsOutput.  These numbers will be in the range [0..1].
 */
INLINE const LVecBase4 &DisplayRegionPipelineReader::
get_dimensions(int i) const {
  return _cdata->_regions[i]._dimensions;
}

/**
 * Retrieves the x coordinate of the left edge of the rectangle within its
 * GraphicsOutput.  This number will be in the range [0..1].
 */
INLINE PN_stdfloat DisplayRegionPipelineReader::
get_left(int i) const {
  return _cdata->_regions[i]._dimensions[0];
}

/**
 * Retrieves the x coordinate of the right edge of the rectangle within its
 * GraphicsOutput.  This number will be in the range [0..1].
 */
INLINE PN_stdfloat DisplayRegionPipelineReader::
get_right(int i) const {
  return _cdata->_regions[i]._dimensions[1];
}

/**
 * Retrieves the y coordinate of the bottom edge of the rectangle within its
 * GraphicsOutput.  This number will be in the range [0..1].
 */
INLINE PN_stdfloat DisplayRegionPipelineReader::
get_bottom(int i) const {
  return _cdata->_regions[i]._dimensions[2];
}

/**
 * Retrieves the y coordinate of the top edge of the rectangle within its
 * GraphicsOutput.  This number will be in the range [0..1].
 */
INLINE PN_stdfloat DisplayRegionPipelineReader::
get_top(int i) const {
  return _cdata->_regions[i]._dimensions[3];
}

/**
 * Returns the GraphicsOutput that this DisplayRegion is ultimately associated
 * with, or NULL if no window is associated.
 */
INLINE GraphicsOutput *DisplayRegionPipelineReader::
get_window() const {
  return _object->_window;
}

/**
 * Returns the camera associated with this DisplayRegion, or an empty NodePath
 * if no camera is associated.
 */
INLINE NodePath DisplayRegionPipelineReader::
get_camera() const {
  return _cdata->_camera;
}

/**
 * Returns the active flag associated with the DisplayRegion.
 */
INLINE bool DisplayRegionPipelineReader::
is_active() const {
  return _cdata->_active;
}

/**
 * Returns the sort value associated with the DisplayRegion.
 */
INLINE int DisplayRegionPipelineReader::
get_sort() const {
  return _cdata->_sort;
}

/**
 * Returns whether the DisplayRegion is specified as the left or right channel
 * of a stereo pair, or whether it is a normal, monocular image.  See
 * set_stereo_channel().
 */
INLINE Lens::StereoChannel DisplayRegionPipelineReader::
get_stereo_channel() const {
  return _cdata->_stereo_channel;
}

/**
 * Returns the current texture view offset for this DisplayRegion.  This is
 * normally set to zero.  If nonzero, it is used to select a particular view
 * of any multiview textures that are rendered within this DisplayRegion.
 *
 * For a StereoDisplayRegion, this is normally 0 for the left eye, and 1 for
 * the right eye, to support stereo textures.
 */
INLINE int DisplayRegionPipelineReader::
get_tex_view_offset() {
  return _cdata->_tex_view_offset;
}

/**
 * Returns the target page number associated with this particular
 * DisplayRegion, or -1 if it is not associated with a page.  See
 * set_target_tex_page().
 */
INLINE int DisplayRegionPipelineReader::
get_target_tex_page() const {
  return _cdata->_target_tex_page;
}

/**
 * Returns whether or not scissor testing is enabled for this region.  The
 * default is true, except for the overlay display region.
 */
INLINE bool DisplayRegionPipelineReader::
get_scissor_enabled() const {
  return _cdata->_scissor_enabled;
}

/**
 * Returns the CallbackObject set by set_draw_callback().
 */
INLINE CallbackObject *DisplayRegionPipelineReader::
get_draw_callback() const {
  return _cdata->_draw_callback;
}

/**
 * Retrieves the coordinates of the DisplayRegion within its window, in
 * pixels.
 */
INLINE void DisplayRegionPipelineReader::
get_pixels(int &pl, int &pr, int &pb, int &pt) const {
  get_pixels(0, pl, pr, pb, pt);
}

/**
 * Retrieves the coordinates of the DisplayRegion within its window, in
 * pixels.
 */
INLINE void DisplayRegionPipelineReader::
get_pixels(int i, int &pl, int &pr, int &pb, int &pt) const {
  const DisplayRegion::Region &region = _cdata->_regions[i];
  pl = region._pixels[0];
  pr = region._pixels[1];
  pb = region._pixels[2];
  pt = region._pixels[3];
}

/**
 * Retrieves the coordinates of the DisplayRegion within its window, as the
 * pixel location of its bottom-left corner, along with a pixel width and
 * height.
 */
INLINE void DisplayRegionPipelineReader::
get_region_pixels(int &xo, int &yo, int &w, int &h) const {
  get_region_pixels(0, xo, yo, w, h);
}

/**
 * Retrieves the coordinates of the DisplayRegion within its window, as the
 * pixel location of its bottom-left corner, along with a pixel width and
 * height.
 */
INLINE void DisplayRegionPipelineReader::
get_region_pixels(int i, int &xo, int &yo, int &w, int &h) const {
  const DisplayRegion::Region &region = _cdata->_regions[i];
  xo = region._pixels[0];
  yo = region._pixels[2];
  w = region._pixels[1] - xo;
  h = region._pixels[3] - yo;
}

/**
 * Similar to get_region_pixels(), but returns the upper left corner, and the
 * pixel numbers are numbered from the top-left corner down, in the DirectX
 * way of things.
 */
INLINE void DisplayRegionPipelineReader::
get_region_pixels_i(int &xo, int &yo, int &w, int &h) const {
  get_region_pixels_i(0, xo, yo, w, h);
}

/**
 * Similar to get_region_pixels(), but returns the upper left corner, and the
 * pixel numbers are numbered from the top-left corner down, in the DirectX
 * way of things.
 */
INLINE void DisplayRegionPipelineReader::
get_region_pixels_i(int i, int &xo, int &yo, int &w, int &h) const {
  const DisplayRegion::Region &region = _cdata->_regions[i];
  xo = region._pixels_i[0];
  yo = region._pixels_i[3];
  w = region._pixels_i[1] - xo;
  h = region._pixels_i[2] - yo;
}

/**
 * Returns the width of the DisplayRegion in pixels.
 */
INLINE int DisplayRegionPipelineReader::
get_pixel_width(int i) const {
  return _cdata->_regions[i]._pixels[1] - _cdata->_regions[i]._pixels[0];
}

/**
 * Gets the index into a lens_node lens array.  0 default
 */
INLINE int DisplayRegionPipelineReader::
get_lens_index() const {
  return _cdata->_lens_index;
}

/**
 * Returns the height of the DisplayRegion in pixels.
 */
INLINE int DisplayRegionPipelineReader::
get_pixel_height(int i) const {
  return _cdata->_regions[i]._pixels[3] - _cdata->_regions[i]._pixels[2];
}

INLINE std::ostream &
operator << (std::ostream &out, const DisplayRegion &dr) {
  dr.output(out);
  return out;
}