Panda3D
|
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"
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. | |
WeakReferenceList * | get_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. |
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.
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] |
Returns the current reference count.
Definition at line 155 of file referenceCount.I.
References ReferenceCount::test_ref_count_integrity().
Referenced by TransformState::clear_cache(), RenderState::clear_cache(), RenderState::finalize(), RenderEffects::finalize(), RenderEffect::finalize(), RenderAttrib::finalize(), InternalName::finalize(), TransformState::get_num_unused_states(), RenderState::get_num_unused_states(), TransformState::list_cycles(), RenderState::list_cycles(), GeomVertexFormat::remove_column(), TransformState::unref(), RenderState::unref(), RenderState::~RenderState(), and TransformState::~TransformState().
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] |
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 236 of file referenceCount.I.
References ReferenceCount::do_test_ref_count_integrity().
Referenced by EggGroupNode::add_child(), InternalName::find_ancestor(), InternalName::get_ancestor(), ReferenceCount::get_ref_count(), InternalName::get_top(), ReferenceCount::ref(), EggVertex::test_gref_integrity(), EggVertex::test_pref_integrity(), EggNode::test_under_integrity(), EggPrimitive::test_vref_integrity(), EggGroup::test_vref_integrity(), MouseWatcher::throw_event_pattern(), ReferenceCount::unref(), and EggNode::update_under().
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().