Panda3D
Classes | Public Member Functions
NurbsSurfaceResult Class Reference

The result of a NurbsSurfaceEvaluator. More...

#include "nurbsSurfaceResult.h"

Inheritance diagram for NurbsSurfaceResult:
ReferenceCount MemoryBase

List of all members.

Classes

class  ComposedMats

Public Member Functions

 NurbsSurfaceResult (const NurbsBasisVector &u_basis, const NurbsBasisVector &v_basis, const LVecBase4 vecs[], const NurbsVertex *verts, int num_u_vertices, int num_v_vertices)
 The constructor automatically builds up the result as the product of the indicated set of basis matrices and the indicated table of control vertex positions.
PN_stdfloat eval_extended_point (PN_stdfloat u, PN_stdfloat v, int d)
 Evaluates the surface in n-dimensional space according to the extended vertices associated with the surface in the indicated dimension.
bool eval_extended_points (PN_stdfloat u, PN_stdfloat v, int d, PN_stdfloat result[], int num_values)
 Simultaneously performs eval_extended_point on a contiguous sequence of dimensions.
bool eval_normal (PN_stdfloat u, PN_stdfloat v, LVecBase3 &normal)
 Computes the normal to the surface at the indicated point in parametric time.
bool eval_point (PN_stdfloat u, PN_stdfloat v, LVecBase3 &point)
 Computes the point on the surface corresponding to the indicated value in parametric time.
PN_stdfloat eval_segment_extended_point (int ui, int vi, PN_stdfloat u, PN_stdfloat v, int d) const
 Evaluates the surface in n-dimensional space according to the extended vertices associated with the surface in the indicated dimension.
void eval_segment_extended_points (int ui, int vi, PN_stdfloat u, PN_stdfloat v, int d, PN_stdfloat result[], int num_values) const
 Simultaneously performs eval_extended_point on a contiguous sequence of dimensions.
void eval_segment_normal (int ui, int vi, PN_stdfloat u, PN_stdfloat v, LVecBase3 &normal) const
 As eval_segment_point, but computes the normal to the surface at the indicated point.
void eval_segment_point (int ui, int vi, PN_stdfloat u, PN_stdfloat v, LVecBase3 &point) const
 Evaluates the point on the surface corresponding to the indicated value in parametric time within the indicated surface segment.
PN_stdfloat get_end_u () const
 Returns the last legal value of u on the surface.
PN_stdfloat get_end_v () const
 Returns the last legal value of v on the surface.
int get_num_u_segments () const
 Returns the number of piecewise continuous segments within the surface in the U direction.
int get_num_v_segments () const
 Returns the number of piecewise continuous segments within the surface in the V direction.
PN_stdfloat get_segment_u (int ui, PN_stdfloat u) const
 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()).
PN_stdfloat get_segment_v (int vi, PN_stdfloat v) const
 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()).
PN_stdfloat get_start_u () const
 Returns the first legal value of u on the surface.
PN_stdfloat get_start_v () const
 Returns the first legal value of v on the surface.

Detailed Description

The result of a NurbsSurfaceEvaluator.

This object represents a surface in a particular coordinate space. It can return the point and/or normal to the surface at any point.

Definition at line 31 of file nurbsSurfaceResult.h.


Constructor & Destructor Documentation

NurbsSurfaceResult::NurbsSurfaceResult ( const NurbsBasisVector u_basis,
const NurbsBasisVector v_basis,
const LVecBase4  vecs[],
const NurbsVertex verts,
int  num_u_vertices,
int  num_v_vertices 
)

The constructor automatically builds up the result as the product of the indicated set of basis matrices and the indicated table of control vertex positions.

Definition at line 27 of file nurbsSurfaceResult.cxx.

References NurbsBasisVector::get_basis(), NurbsBasisVector::get_num_segments(), NurbsBasisVector::get_order(), NurbsBasisVector::get_vertex_index(), and NurbsBasisVector::transpose().


Member Function Documentation

PN_stdfloat NurbsSurfaceResult::eval_extended_point ( PN_stdfloat  u,
PN_stdfloat  v,
int  d 
) [inline]

Evaluates the surface in n-dimensional space according to the extended vertices associated with the surface in the indicated dimension.

Definition at line 116 of file nurbsSurfaceResult.I.

References eval_segment_extended_point(), and NurbsBasisVector::scale_t().

bool NurbsSurfaceResult::eval_extended_points ( PN_stdfloat  u,
PN_stdfloat  v,
int  d,
PN_stdfloat  result[],
int  num_values 
) [inline]

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.

Definition at line 137 of file nurbsSurfaceResult.I.

References eval_segment_extended_points(), and NurbsBasisVector::scale_t().

bool NurbsSurfaceResult::eval_normal ( PN_stdfloat  u,
PN_stdfloat  v,
LVecBase3 normal 
) [inline]

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().

Definition at line 96 of file nurbsSurfaceResult.I.

References eval_segment_normal(), and NurbsBasisVector::scale_t().

bool NurbsSurfaceResult::eval_point ( PN_stdfloat  u,
PN_stdfloat  v,
LVecBase3 point 
) [inline]

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.

Definition at line 75 of file nurbsSurfaceResult.I.

References eval_segment_point(), and NurbsBasisVector::scale_t().

PN_stdfloat NurbsSurfaceResult::eval_segment_extended_point ( int  ui,
int  vi,
PN_stdfloat  u,
PN_stdfloat  v,
int  d 
) const

Evaluates the surface in n-dimensional space according to the extended vertices associated with the surface in the indicated dimension.

Definition at line 173 of file nurbsSurfaceResult.cxx.

References NurbsBasisVector::get_basis(), NurbsVertex::get_extended_vertex(), NurbsBasisVector::get_order(), and NurbsBasisVector::get_vertex_index().

Referenced by eval_extended_point().

void NurbsSurfaceResult::eval_segment_extended_points ( int  ui,
int  vi,
PN_stdfloat  u,
PN_stdfloat  v,
int  d,
PN_stdfloat  result[],
int  num_values 
) const

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.

Definition at line 219 of file nurbsSurfaceResult.cxx.

References NurbsBasisVector::get_basis(), NurbsVertex::get_extended_vertex(), NurbsBasisVector::get_order(), and NurbsBasisVector::get_vertex_index().

Referenced by eval_extended_points().

void NurbsSurfaceResult::eval_segment_normal ( int  ui,
int  vi,
PN_stdfloat  u,
PN_stdfloat  v,
LVecBase3 normal 
) const

As eval_segment_point, but computes the normal to the surface at the indicated point.

The normal vector will not necessarily be normalized, and could be zero.

Definition at line 143 of file nurbsSurfaceResult.cxx.

Referenced by eval_normal().

void NurbsSurfaceResult::eval_segment_point ( int  ui,
int  vi,
PN_stdfloat  u,
PN_stdfloat  v,
LVecBase3 point 
) const

Evaluates the point on the surface corresponding to the indicated value in parametric time within the indicated surface segment.

u and v should be in the range [0, 1].

The surface is internally represented as a number of connected (or possibly unconnected) piecewise continuous segments. The exact number of segments for a particular surface depends on the knot vector, and is returned by get_num_segments(). Normally, eval_point() is used to evaluate a point along the continuous surface, but when you care more about local continuity, you can use eval_segment_point() to evaluate the points along each segment.

Definition at line 118 of file nurbsSurfaceResult.cxx.

Referenced by eval_point().

PN_stdfloat NurbsSurfaceResult::get_end_u ( ) const [inline]

Returns the last legal value of u on the surface.

Definition at line 42 of file nurbsSurfaceResult.I.

References NurbsBasisVector::get_end_t().

PN_stdfloat NurbsSurfaceResult::get_end_v ( ) const [inline]

Returns the last legal value of v on the surface.

Definition at line 63 of file nurbsSurfaceResult.I.

References NurbsBasisVector::get_end_t().

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().

Definition at line 160 of file nurbsSurfaceResult.I.

References NurbsBasisVector::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().

Definition at line 173 of file nurbsSurfaceResult.I.

References NurbsBasisVector::get_num_segments().

PN_stdfloat NurbsSurfaceResult::get_segment_u ( int  ui,
PN_stdfloat  u 
) const [inline]

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()).

Definition at line 186 of file nurbsSurfaceResult.I.

References NurbsBasisVector::get_from(), and NurbsBasisVector::get_to().

PN_stdfloat NurbsSurfaceResult::get_segment_v ( int  vi,
PN_stdfloat  v 
) const [inline]

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()).

Definition at line 199 of file nurbsSurfaceResult.I.

References NurbsBasisVector::get_from(), and NurbsBasisVector::get_to().

PN_stdfloat NurbsSurfaceResult::get_start_u ( ) const [inline]

Returns the first legal value of u on the surface.

Usually this is 0.0.

Definition at line 32 of file nurbsSurfaceResult.I.

References NurbsBasisVector::get_start_t().

PN_stdfloat NurbsSurfaceResult::get_start_v ( ) const [inline]

Returns the first legal value of v on the surface.

Usually this is 0.0.

Definition at line 53 of file nurbsSurfaceResult.I.

References NurbsBasisVector::get_start_t().


The documentation for this class was generated from the following files:
 All Classes Functions Variables Enumerations