Panda3D
Public Member Functions | Static Public Member Functions | Protected Member Functions

QtessSurface Class Reference

A reference to an EggNurbsSurface in the egg file, and its parameters as set by the user input file and as computed in relation to the other surfaces. More...

#include "qtessSurface.h"

Inheritance diagram for QtessSurface:
ReferenceCount MemoryBase

List of all members.

Public Member Functions

 QtessSurface (EggNurbsSurface *egg_surface)
double count_patches () const
 Returns the number of patches the NURBS contains.
int count_tris () const
 Returns the number of triangles that will be generated by the current tesselation parameters.
const string & get_name () const
int get_ref_count () const
 Returns the current reference count.
double get_score (double ratio)
 Computes the curvature/stretch score for the surface, if it has not been already computed, and returns the net surface score.
WeakReferenceListget_weak_list () const
 Returns the WeakReferenceList associated with this ReferenceCount object.
bool has_weak_list () const
 Returns true if this particular ReferenceCount object has a WeakReferenceList created, false otherwise.
bool is_valid () const
 Returns true if the defined surface is valid, false otherwise.
void local_object ()
 This function should be called, once, immediately after creating a new instance of some ReferenceCount-derived object on the stack.
void omit ()
 Sets up the surface to omit itself from the output.
void operator delete (void *ptr)
void operator delete (void *ptr, void *)
void operator delete[] (void *ptr)
void operator delete[] (void *, void *)
void * operator new (size_t size, void *ptr)
void * operator new (size_t size)
void * operator new[] (size_t size)
void * operator new[] (size_t size, void *ptr)
void ref () const
 Explicitly increments the reference count.
void set_importance (double importance2)
 Sets the importance of the surface, as a ratio in proportion to the square of its size.
void set_match_u (QtessSurface **match_u, bool match_u_to_u)
 Indicates the surface to which this surface must match in its U direction.
void set_match_v (QtessSurface **match_v, bool match_v_to_v)
 Indicates the surface to which this surface must match in its V direction.
void set_min_u (int min_u)
 Specifies the absolute minimum number of segments allowed in the U direction.
void set_min_v (int min_v)
 Specifies the absolute minimum number of segments allowed in the V direction.
int tesselate ()
 Applies the appropriate tesselation to the surface, and replaces its node in the tree with an EggGroup containing both the new vertex pool and all of the polygons.
void tesselate_auto (int u, int v, double ratio)
 Sets the surface up to tesselate itself by automatically determining the best place to put the indicated u x v isoparams.
void tesselate_per_isoparam (double pi, bool autoplace, double ratio)
 Sets the surface up to tesselate itself to a uniform amount per isoparam.
void tesselate_per_score (double pi, bool autoplace, double ratio)
 Sets the surface up to tesselate itself according to its computed curvature score in both dimensions.
void tesselate_specific (const pvector< double > &u_list, const pvector< double > &v_list)
 Sets the surface up to tesselate itself at specific isoparams only.
void tesselate_uv (int u, int v, bool autoplace, double ratio)
 Sets the surface up to tesselate itself uniformly at u x v, or if autoplace is true, automatically with u x v quads.
bool test_ref_count_integrity () const
 Does some easy checks to make sure that the reference count isn't completely bogus.
bool test_ref_count_nonzero () const
 Does some easy checks to make sure that the reference count isn't zero, or completely bogus.
virtual bool unref () const
 Explicitly decrements the reference count.
void weak_ref (WeakPointerToVoid *ptv)
 Adds the indicated PointerToVoid as a weak reference to this object.
void weak_unref (WeakPointerToVoid *ptv)
 Removes the indicated PointerToVoid as a weak reference to this object.
int write_qtess_parameter (ostream &out)
 Writes a line to the given output file telling qtess how this surface should be tesselated uniformly.

Static Public Member Functions

static TypeHandle get_class_type ()
static void init_type ()

Protected Member Functions

bool do_test_ref_count_integrity () const
 Does some easy checks to make sure that the reference count isn't completely bogus.
bool do_test_ref_count_nonzero () const
 Returns true if the reference count is nonzero, false otherwise.

Detailed Description

A reference to an EggNurbsSurface in the egg file, and its parameters as set by the user input file and as computed in relation to the other surfaces.

Definition at line 34 of file qtessSurface.h.


Member Function Documentation

double QtessSurface::count_patches ( ) const [inline]

Returns the number of patches the NURBS contains.

Each patch is a square area bounded by isoparams. This actually scales by the importance of the surface, if it is not 1.

Definition at line 121 of file qtessSurface.I.

Referenced by QtessInputEntry::match().

int QtessSurface::count_tris ( ) const [inline]

Returns the number of triangles that will be generated by the current tesselation parameters.

Definition at line 132 of file qtessSurface.I.

Referenced by QtessInputEntry::count_tris(), and write_qtess_parameter().

bool ReferenceCount::do_test_ref_count_integrity ( ) const [protected, inherited]

Does some easy checks to make sure that the reference count isn't completely bogus.

Returns true if ok, false otherwise.

Reimplemented in NodeReferenceCount, CachedTypedWritableReferenceCount, and NodeCachedReferenceCount.

Definition at line 29 of file referenceCount.cxx.

Referenced by ReferenceCount::do_test_ref_count_nonzero(), and ReferenceCount::test_ref_count_integrity().

bool ReferenceCount::do_test_ref_count_nonzero ( ) const [protected, inherited]

Returns true if the reference count is nonzero, false otherwise.

Definition at line 56 of file referenceCount.cxx.

References ReferenceCount::do_test_ref_count_integrity().

Referenced by ReferenceCount::test_ref_count_nonzero().

int ReferenceCount::get_ref_count ( ) const [inline, inherited]
double QtessSurface::get_score ( double  ratio)

Computes the curvature/stretch score for the surface, if it has not been already computed, and returns the net surface score.

This is used both for automatically distributing isoparams among the surfaces by curvature, as well as for automatically placing the isoparams within each surface by curvature.

Definition at line 95 of file qtessSurface.cxx.

Referenced by QtessInputEntry::match(), tesselate_auto(), and tesselate_per_score().

WeakReferenceList * ReferenceCount::get_weak_list ( ) const [inline, inherited]

Returns the WeakReferenceList associated with this ReferenceCount object.

If there has never been a WeakReferenceList associated with this object, creates one now.

Definition at line 307 of file referenceCount.I.

Referenced by ReferenceCount::weak_ref().

bool ReferenceCount::has_weak_list ( ) const [inline, inherited]

Returns true if this particular ReferenceCount object has a WeakReferenceList created, false otherwise.

In general, this will be true if there was ever a WeakPointerTo created for this object (even if there is not any for it now).

Definition at line 294 of file referenceCount.I.

Referenced by ReferenceCount::weak_unref().

bool QtessSurface::is_valid ( ) const [inline]

Returns true if the defined surface is valid, false otherwise.

Definition at line 33 of file qtessSurface.I.

void ReferenceCount::local_object ( ) [inline, inherited]

This function should be called, once, immediately after creating a new instance of some ReferenceCount-derived object on the stack.

This allows the object to be passed to functions that will increment and decrement the object's reference count temporarily, and it will prevent the object from being deleted (inappropriately), when the reference count returns to zero. It actually achieves this by setting a large positive value in the reference count field.

Definition at line 276 of file referenceCount.I.

Referenced by PGTop::cull_callback(), BoundingSphere::extend_by_hexahedron(), AsyncTaskManager::find_task(), AsyncTaskManager::find_tasks(), and AsyncTaskManager::find_tasks_matching().

void QtessSurface::omit ( )

Sets up the surface to omit itself from the output.

Definition at line 175 of file qtessSurface.cxx.

Referenced by QtessInputEntry::count_tris(), tesselate_auto(), tesselate_per_isoparam(), and tesselate_per_score().

void ReferenceCount::ref ( ) const [inline, inherited]

Explicitly increments the reference count.

User code should avoid using ref() and unref() directly, which can result in missed reference counts. Instead, let a PointerTo object manage the reference counting automatically.

This function is const, even though it changes the object, because generally fiddling with an object's reference count isn't considered part of fiddling with the object. An object might be const in other ways, but we still need to accurately count the number of references to it.

Definition at line 179 of file referenceCount.I.

References ReferenceCount::test_ref_count_integrity().

Referenced by CachedTypedWritableReferenceCount::cache_ref(), TypedWritable::decode_raw_from_bam_stream(), NodeCachedReferenceCount::node_ref(), NodeReferenceCount::node_ref(), BamCacheRecord::set_data(), CullableObject::set_draw_callback(), and ModelRoot::set_reference().

void QtessSurface::set_importance ( double  importance2) [inline]

Sets the importance of the surface, as a ratio in proportion to the square of its size.

Definition at line 44 of file qtessSurface.I.

Referenced by QtessInputEntry::match().

void QtessSurface::set_match_u ( QtessSurface **  match_u,
bool  match_u_to_u 
) [inline]

Indicates the surface to which this surface must match in its U direction.

If u_to_u is true, it matches to the other surface's U direction; otherwise, it matches to the other surface's V direction.

Note that the surface pointer is an indirect pointer. The value passed in is the address of the pointer to the actual surface (which may or may not be filled in yet). The actual pointer may be filled in later.

Definition at line 64 of file qtessSurface.I.

Referenced by QtessInputEntry::match().

void QtessSurface::set_match_v ( QtessSurface **  match_v,
bool  match_v_to_v 
) [inline]

Indicates the surface to which this surface must match in its V direction.

If v_to_v is true, it matches to the other surface's V direction; otherwise, it matches to the other surface's U direction.

Note that the surface pointer is an indirect pointer. The value passed in is the address of the pointer to the actual surface (which may or may not be filled in yet). The actual pointer may be filled in later.

Definition at line 84 of file qtessSurface.I.

Referenced by QtessInputEntry::match().

void QtessSurface::set_min_u ( int  min_u) [inline]

Specifies the absolute minimum number of segments allowed in the U direction.

Definition at line 96 of file qtessSurface.I.

Referenced by QtessInputEntry::match().

void QtessSurface::set_min_v ( int  min_v) [inline]

Specifies the absolute minimum number of segments allowed in the V direction.

Definition at line 107 of file qtessSurface.I.

Referenced by QtessInputEntry::match().

int QtessSurface::tesselate ( )

Applies the appropriate tesselation to the surface, and replaces its node in the tree with an EggGroup containing both the new vertex pool and all of the polygons.

Definition at line 122 of file qtessSurface.cxx.

References EggGroupNode::add_child().

void QtessSurface::tesselate_auto ( int  u,
int  v,
double  ratio 
)

Sets the surface up to tesselate itself by automatically determining the best place to put the indicated u x v isoparams.

Definition at line 266 of file qtessSurface.cxx.

References get_score(), and omit().

Referenced by tesselate_per_isoparam(), tesselate_per_score(), and tesselate_uv().

void QtessSurface::tesselate_per_isoparam ( double  pi,
bool  autoplace,
double  ratio 
)

Sets the surface up to tesselate itself to a uniform amount per isoparam.

Definition at line 220 of file qtessSurface.cxx.

References omit(), and tesselate_auto().

Referenced by QtessInputEntry::count_tris().

void QtessSurface::tesselate_per_score ( double  pi,
bool  autoplace,
double  ratio 
)

Sets the surface up to tesselate itself according to its computed curvature score in both dimensions.

Definition at line 243 of file qtessSurface.cxx.

References get_score(), omit(), and tesselate_auto().

Referenced by QtessInputEntry::count_tris().

void QtessSurface::tesselate_specific ( const pvector< double > &  u_list,
const pvector< double > &  v_list 
)

Sets the surface up to tesselate itself at specific isoparams only.

Definition at line 205 of file qtessSurface.cxx.

Referenced by QtessInputEntry::count_tris().

void QtessSurface::tesselate_uv ( int  u,
int  v,
bool  autoplace,
double  ratio 
)

Sets the surface up to tesselate itself uniformly at u x v, or if autoplace is true, automatically with u x v quads.

Definition at line 188 of file qtessSurface.cxx.

References tesselate_auto().

Referenced by QtessInputEntry::count_tris().

bool ReferenceCount::test_ref_count_integrity ( ) const [inline, inherited]
bool ReferenceCount::test_ref_count_nonzero ( ) const [inline, inherited]

Does some easy checks to make sure that the reference count isn't zero, or completely bogus.

Returns true if ok, false otherwise.

Definition at line 252 of file referenceCount.I.

References ReferenceCount::do_test_ref_count_nonzero().

Referenced by CopyOnWritePointer::test_ref_count_nonzero().

bool ReferenceCount::unref ( ) const [inline, virtual, inherited]

Explicitly decrements the reference count.

Note that the object will not be implicitly deleted by unref() simply because the reference count drops to zero. (Having a member function delete itself is problematic.) However, see the helper function unref_delete().

User code should avoid using ref() and unref() directly, which can result in missed reference counts. Instead, let a PointerTo object manage the reference counting automatically.

This function is const, even though it changes the object, because generally fiddling with an object's reference count isn't considered part of fiddling with the object. An object might be const in other ways, but we still need to accurately count the number of references to it.

The return value is true if the new reference count is nonzero, false if it is zero.

Reimplemented in GeomVertexArrayFormat, GeomVertexFormat, InternalName, RenderAttrib, RenderEffects, RenderState, and TransformState.

Definition at line 214 of file referenceCount.I.

References ReferenceCount::test_ref_count_integrity().

Referenced by CachedTypedWritableReferenceCount::cache_unref(), TypedWritable::decode_raw_from_bam_stream(), RenderEffect::finalize(), NodeCachedReferenceCount::node_unref(), NodeReferenceCount::node_unref(), TransformState::unref(), RenderState::unref(), RenderEffects::unref(), RenderAttrib::unref(), InternalName::unref(), GeomVertexFormat::unref(), and GeomVertexArrayFormat::unref().

void ReferenceCount::weak_ref ( WeakPointerToVoid ptv) [inline, inherited]

Adds the indicated PointerToVoid as a weak reference to this object.

Definition at line 321 of file referenceCount.I.

References WeakReferenceList::add_reference(), and ReferenceCount::get_weak_list().

void ReferenceCount::weak_unref ( WeakPointerToVoid ptv) [inline, inherited]

Removes the indicated PointerToVoid as a weak reference to this object.

It must have previously been added via a call to weak_ref().

Definition at line 334 of file referenceCount.I.

References WeakReferenceList::clear_reference(), and ReferenceCount::has_weak_list().

int QtessSurface::write_qtess_parameter ( ostream &  out)

Writes a line to the given output file telling qtess how this surface should be tesselated uniformly.

Returns the number of tris.

Definition at line 149 of file qtessSurface.cxx.

References count_tris(), and QtessInputEntry::output_extra().


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