nurbsSurfaceResult.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 nurbsSurfaceResult.I
 * @author drose
 * @date 2003-10-10
 */

/**
 *
 */
INLINE NurbsSurfaceResult::
~NurbsSurfaceResult() {
}

/**
 * Returns the first legal value of u on the surface.  Usually this is 0.0.
 */
INLINE PN_stdfloat NurbsSurfaceResult::
get_start_u() const {
  return _u_basis.get_start_t();
}

/**
 * Returns the last legal value of u on the surface.
 */
INLINE PN_stdfloat NurbsSurfaceResult::
get_end_u() const {
  return _u_basis.get_end_t();
}

/**
 * Returns the first legal value of v on the surface.  Usually this is 0.0.
 */
INLINE PN_stdfloat NurbsSurfaceResult::
get_start_v() const {
  return _v_basis.get_start_t();
}

/**
 * Returns the last legal value of v on the surface.
 */
INLINE PN_stdfloat NurbsSurfaceResult::
get_end_v() const {
  return _v_basis.get_end_t();
}

/**
 * Computes the point on the surface corresponding to the indicated value in
 * parametric time.  Returns true if the u, v values are valid, false
 * otherwise.
 */
INLINE bool NurbsSurfaceResult::
eval_point(PN_stdfloat u, PN_stdfloat v, LVecBase3 &point) {
  int ui = find_u_segment(u);
  int vi = find_v_segment(v);
  if (ui == -1 || vi == -1) {
    return false;
  }

  eval_segment_point(ui, vi, _u_basis.scale_t(ui, u), _v_basis.scale_t(vi, v),
                     point);
  return true;
}

/**
 * Computes the normal to the surface at the indicated point in parametric
 * time.  This normal vector will not necessarily be normalized, and could be
 * zero.  See also eval_point().
 */
INLINE bool NurbsSurfaceResult::
eval_normal(PN_stdfloat u, PN_stdfloat v, LVecBase3 &normal) {
  int ui = find_u_segment(u);
  int vi = find_v_segment(v);
  if (ui == -1 || vi == -1) {
    return false;
  }

  eval_segment_normal(ui, vi, _u_basis.scale_t(ui, u), _v_basis.scale_t(vi, v),
                      normal);
  return true;
}

/**
 * Evaluates the surface in n-dimensional space according to the extended
 * vertices associated with the surface in the indicated dimension.
 */
INLINE PN_stdfloat NurbsSurfaceResult::
eval_extended_point(PN_stdfloat u, PN_stdfloat v, int d) {
  int ui = find_u_segment(u);
  int vi = find_v_segment(v);
  if (ui == -1 || vi == -1) {
    return 0.0f;
  }

  return eval_segment_extended_point(ui, vi, _u_basis.scale_t(ui, u),
                                     _v_basis.scale_t(vi, v), d);
}

/**
 * Simultaneously performs eval_extended_point on a contiguous sequence of
 * dimensions.  The dimensions evaluated are d through (d + num_values - 1);
 * the results are filled into the num_values elements in the indicated result
 * array.
 */
INLINE bool NurbsSurfaceResult::
eval_extended_points(PN_stdfloat u, PN_stdfloat v, int d, PN_stdfloat result[],
                     int num_values) {
  int ui = find_u_segment(u);
  int vi = find_v_segment(v);
  if (ui == -1 || vi == -1) {
    return false;
  }

  eval_segment_extended_points(ui, vi, _u_basis.scale_t(ui, u),
                               _v_basis.scale_t(vi, v), d, result,
                               num_values);
  return true;
}

/**
 * Returns the number of piecewise continuous segments within the surface in
 * the U direction.  This number is usually not important unless you plan to
 * call eval_segment_point().
 */
INLINE int NurbsSurfaceResult::
get_num_u_segments() const {
  return _u_basis.get_num_segments();
}

/**
 * Returns the number of piecewise continuous segments within the surface in
 * the V direction.  This number is usually not important unless you plan to
 * call eval_segment_point().
 */
INLINE int NurbsSurfaceResult::
get_num_v_segments() const {
  return _v_basis.get_num_segments();
}

/**
 * Accepts a u value in the range [0, 1], and assumed to be relative to the
 * indicated segment (as in eval_segment_point()), and returns the
 * corresponding u value in the entire surface (as in eval_point()).
 */
INLINE PN_stdfloat NurbsSurfaceResult::
get_segment_u(int ui, PN_stdfloat u) const {
  return u * (_u_basis.get_to(ui) - _u_basis.get_from(ui)) + _u_basis.get_from(ui);
}

/**
 * Accepts a v value in the range [0, 1], and assumed to be relative to the
 * indicated segment (as in eval_segment_point()), and returns the
 * corresponding v value in the entire surface (as in eval_point()).
 */
INLINE PN_stdfloat NurbsSurfaceResult::
get_segment_v(int vi, PN_stdfloat v) const {
  return v * (_v_basis.get_to(vi) - _v_basis.get_from(vi)) + _v_basis.get_from(vi);
}

/**
 * An internal function to dereference a 2-d vertex coordinate pair into a
 * linear list of vertices.  This returns the linear index corresponding to
 * the 2-d pair.
 */
INLINE int NurbsSurfaceResult::
verti(int ui, int vi) const {
  return ui * _num_v_vertices + vi;
}

/**
 * An internal function to dereference a 2-d segment coordinate pair into a
 * linear list of segments.  This returns the linear index corresponding to
 * the 2-d pair.
 */
INLINE int NurbsSurfaceResult::
segi(int ui, int vi) const {
  return ui * _v_basis.get_num_segments() + vi;
}