Fish Class Reference
#include <visx/fish.h>
Public Member Functions | |
| virtual | ~Fish () throw () |
| Virtual destructor. | |
| virtual io::version_id | class_version_id () const |
| virtual void | read_from (io::reader &reader) |
| virtual void | write_to (io::writer &writer) const |
| virtual int | category () const |
| Returns the value of the user-defined category. | |
| virtual void | setCategory (int val) |
| Change the value of the user-defined category to val. | |
| bool | getBBVisibility () const |
| virtual void | getBoundingCube (Gfx::Bbox &bbox) const |
| int | getScalingMode () const |
| Returns the current scaling mode. | |
| double | getWidth () const |
| Returns the object's onscreen width in OpenGL units. | |
| double | getHeight () const |
| Returns the object's onscreen height in OpenGL units. | |
| double | getAspectRatio () const |
| double | getMaxDimension () const |
| Returns the value of the larger of the object's width and height. | |
| int | getAlignmentMode () const |
| Returns the current alignment mode. | |
| double | getCenterX () const |
| Returns the x value of the location of the object's center. | |
| double | getCenterY () const |
| Returns the x value of the location of the object's center. | |
| int | getPercentBorder () const |
| int | getRenderMode () const |
| Returns the current rendering mode. | |
| void | setBBVisibility (bool visibility) |
| Changes whether the bounding box will be visible when the object is drawn. | |
| void | setScalingMode (int mode) |
| void | setWidth (double val) |
| void | setHeight (double val) |
| void | setAspectRatio (double val) |
| void | setMaxDimension (double val) |
| void | setAlignmentMode (int mode) |
| void | setCenterX (double val) |
| void | setCenterY (double val) |
| void | setPercentBorder (int pixels) |
| void | setRenderMode (int mode) |
| void | draw (Gfx::Canvas &canvas) const |
| virtual bool | contains (GxNode *other) const |
| virtual rutz::fwd_iter< const nub::ref< GxNode > > | deepChildren () |
| geom::rect< double > | getBoundingBox (Gfx::Canvas &canvas) const |
| Get the 2-D z-projection of the result of getBoundingCube(). | |
| void | undraw (Gfx::Canvas &canvas) const |
| Undraw the object from canvas by clearing the bounding box. | |
| nub::uid | id () const throw () |
| rutz::fstring | real_typename () const |
| Returns the typename of the full object. | |
| virtual rutz::fstring | obj_typename () const |
| Returns the (apparent) typename of the full object. | |
| rutz::fstring | unique_name () const |
| Returns a short string describing the object by its typename and id. | |
| void * | operator new (size_t bytes) |
| void | operator delete (void *space, size_t bytes) |
| void | mark_as_volatile () throw () |
| Mark this object as a volatile (unshareable) object. | |
| void | incr_ref_count () const throw () |
| Increment the object's reference count. | |
| void | decr_ref_count () const throw () |
| Decrement the object's reference count. | |
| void | decr_ref_count_no_delete () const throw () |
| Decrement the object's reference count, but don't delete it. | |
| bool | is_shared () const throw () |
| Returns true if no external client has sole ownership of the object. | |
| bool | is_unshared () const throw () |
| Returns true if there is a sole external owner of the object. | |
| bool | is_not_shareable () const throw () |
| ref_counts * | get_counts () const throw () |
| Returns the object's reference count manager. | |
| int | dbg_ref_count () const throw () |
| FOR TEST/DEBUG ONLY! Returns the object's (strong) reference count. | |
| int | dbg_weak_ref_count () const throw () |
| FOR TEST/DEBUG ONLY! Returns the object's weak reference count. | |
| void | setFieldMap (const FieldMap &fields) |
| Set the field map for this object. | |
| const Field & | field (const rutz::fstring &name) const |
| Lookup the Field for a given name. | |
| void | touch () const |
| Emit a signal saying that one of our values has changed. | |
| void | readFieldsFrom (io::reader &reader, const FieldMap &fields) |
| Read all fields from the io::reader. | |
| void | writeFieldsTo (io::writer &writer, const FieldMap &fields, io::version_id svid) const |
| Write all fields to the io::writer. | |
| const FieldMap & | fields () const |
| Get the FieldMap for this object. | |
| virtual FieldContainer * | child () const |
| Get this container's child, if any. Default implementation returns null. | |
Static Public Member Functions | |
| static Fish * | make () |
| Factory function. | |
| static Fish * | makeFromFiles (const char *splinefile, const char *coordfile, int index) |
| Create from files specifying the spline values. | |
| static const FieldMap & | classFields () |
| Get Fish's fields. | |
Public Attributes | |
| nub::signal0 | sigNodeChanged |
| Signal that will be triggered whenever the node changes state. | |
| nub::signal0 * | itsSignal |
Static Public Attributes | |
| static rutz::tracer | tracer |
This tracer dynamically controls the tracing of Fish member functions. | |
Protected Member Functions | |
| Fish (const char *splinefile=0, const char *coordfile=0, int index=0) | |
| virtual void | grGetBoundingBox (Gfx::Bbox &bbox) const |
| virtual void | grRender (Gfx::Canvas &canvas) const |
Classes | |
| struct | Part |
Detailed Description
Fish is a subclass of GxShapeKit that can render outline drawings of tropical fish (rendering algorithm designed by Fabrizio Gabbiani).
Definition at line 51 of file fish.h.
Constructor & Destructor Documentation
| Fish::Fish | ( | const char * | splinefile = 0, |
|
| const char * | coordfile = 0, |
|||
| int | index = 0 | |||
| ) | [protected] |
Constructor can make a Fish by reading a spline file and a coordinate file. If either of these filenames are null, the constructor will use default values for the spline coefficients.
Definition at line 185 of file fish.cc.
References classFields(), nub::signal0::connect(), nub::signal0::emit(), FieldContainer::setFieldMap(), and GxNode::sigNodeChanged.
Member Function Documentation
| io::version_id Fish::class_version_id | ( | ) | const [virtual] |
Returns a serialization version id for the class. The default implementation returns zero. Classes should override this when they make a change that requires a change to their serialization protocol. Overriding versions of this function should follow the convention that a higher id refers to a later version of the class. Implementations of io::reader and io::writer will provide a way for a class to store and retrieve the serialization version of an object.
Reimplemented from GxShapeKit.
| void Fish::read_from | ( | io::reader & | reader | ) | [virtual] |
Subclasses implement this method to save the object's state via the generic interface provided by io::reader. Parsing the format of the input is handled by the io::reader, so implementors of read_from() of don't need to deal with formatting.
Reimplemented from GxShapeKit.
Definition at line 317 of file fish.cc.
References classFields(), io::reader::ensure_version_id(), io::reader::read_base_class(), FieldContainer::readFieldsFrom(), and SRC_POS.
| void Fish::write_to | ( | io::writer & | writer | ) | const [virtual] |
Subclasses implement this method to restore the object's state via the generic interface provided by io::writer. Formatting the output is handled by the io::writer, so implementors of write_to() of don't need to deal with formatting.
Reimplemented from GxShapeKit.
Definition at line 330 of file fish.cc.
References classFields(), io::writer::ensure_output_version_id(), SRC_POS, io::writer::write_base_class(), and FieldContainer::writeFieldsTo().
| void Fish::grGetBoundingBox | ( | Gfx::Bbox & | bbox | ) | const [protected, virtual] |
Subclasses must override this function to return the bounding box in GL coordinates for the object's onscreen image.
Implements GxShapeKit.
Definition at line 480 of file fish.cc.
References Gfx::Bbox::vertex2().
| void Fish::grRender | ( | Gfx::Canvas & | canvas | ) | const [protected, virtual] |
This function must be overridden in derived classes to execute the actual drawing commands that render the object.
Implements GxShapeKit.
Definition at line 488 of file fish.cc.
References Gfx::Canvas::drawNurbsCurve(), Gfx::Canvas::drawRect(), geom::rect< V >::set_lbwh(), Gfx::Canvas::setColor(), Gfx::Canvas::setPointSize(), Gfx::Canvas::setPolygonFill(), rutz::dynamic_block< T >::size(), Gfx::Canvas::translate(), Gfx::Canvas::vertex2(), and Gfx::Canvas::vertex3().
| bool GxShapeKit::getBBVisibility | ( | ) | const [inherited] |
Queries whether the bounding box will be visible when the object is drawn.
Definition at line 266 of file gxshapekit.cc.
References GxShapeKitImpl::boundsOutline.
| void GxShapeKit::getBoundingCube | ( | Gfx::Bbox & | bbox | ) | const [virtual, inherited] |
Overridden from GxNode. Extends the cube by the rect returned by grGetBoundingBox(), with additional transformations to reflect the scaling mode, alignment mode, and pixel border values. Subclasses of GxShapeKit should override grGetBoundingBox(), not getBoundingCube().
Implements GxNode.
Definition at line 272 of file gxshapekit.cc.
References GxShapeKitImpl::topNode.
| double GxShapeKit::getAspectRatio | ( | ) | const [inherited] |
Returns the object's aspect ratio in OpenGL units. This measures how much the object is deformed relative to its native size. For both width and height, a scaling factor is computed as the ratio of the native dimension to the actual onscreen dimension. The aspect ratio is then the ratio of the width scaling factor to the height scaling factor.
Definition at line 297 of file gxshapekit.cc.
References GxShapeKitImpl::scaler.
| int GxShapeKit::getPercentBorder | ( | ) | const [inherited] |
Returns the thickness (as a percentage of object size) of the border around the bounding box area.
Definition at line 327 of file gxshapekit.cc.
References GxShapeKitImpl::boundsOutline.
| void GxShapeKit::setScalingMode | ( | int | mode | ) | [inherited] |
Changes the current scaling mode to mode, unless the requirements of mode (for example, requiring a bounding box) are not met, in which case the scaling mode is unchanged.
Definition at line 354 of file gxshapekit.cc.
References nub::signal0::emit(), GxShapeKitImpl::scaler, and GxNode::sigNodeChanged.
Referenced by Gabor::Gabor(), GxText::GxText(), and MorphyFace::MorphyFace().
| void GxShapeKit::setWidth | ( | double | val | ) | [inherited] |
Changes the current width to val, unless the scaling mode is NATIVE_SCALING. If the scaling mode is MAINTAIN_ASPECT_SCALING, the height will be adjusted accordingly as well.
Definition at line 362 of file gxshapekit.cc.
References nub::signal0::emit(), GxShapeKitImpl::scaler, and GxNode::sigNodeChanged.
| void GxShapeKit::setHeight | ( | double | val | ) | [inherited] |
Changes the current height to val, unless the scaling mode is NATIVE_SCALING. If the scaling mode is MAINTAIN_ASPECT_SCALING, the width will be adjusted accordingly as well.
Definition at line 370 of file gxshapekit.cc.
References nub::signal0::emit(), GxShapeKitImpl::scaler, and GxNode::sigNodeChanged.
Referenced by GxText::GxText().
| void GxShapeKit::setAspectRatio | ( | double | val | ) | [inherited] |
Changes the aspect ratio to val, unless the scaling mode is NATIVE_SCALING or MAINTAIN_ASPECT_SCALING.
Definition at line 378 of file gxshapekit.cc.
References nub::signal0::emit(), GxShapeKitImpl::scaler, and GxNode::sigNodeChanged.
| void GxShapeKit::setMaxDimension | ( | double | val | ) | [inherited] |
Sets the larger of width or height to val, unless the scaling mode is NATIVE_SCALING. If the scaling mode is MAINTAIN_ASPECT_SCALING, the other dimension will be adjusted accordingly as well.
Definition at line 386 of file gxshapekit.cc.
References nub::signal0::emit(), GxShapeKitImpl::scaler, and GxNode::sigNodeChanged.
Referenced by MorphyFace::MorphyFace().
| void GxShapeKit::setAlignmentMode | ( | int | mode | ) | [inherited] |
Changes the current alignment mode to mode, unless the requirements of mode (for example, requiring a bounding box) are not met, in which case the scaling mode is unchanged.
Definition at line 394 of file gxshapekit.cc.
References GxShapeKitImpl::aligner, nub::signal0::emit(), and GxNode::sigNodeChanged.
Referenced by GxPixmap::GxPixmap(), GxText::GxText(), and MaskHatch::MaskHatch().
| void GxShapeKit::setCenterX | ( | double | val | ) | [inherited] |
Change the x value for the location of the object's center to val. This value is used only if the alignment mode is ARBITRARY_ON_CENTER.
Definition at line 402 of file gxshapekit.cc.
References GxShapeKitImpl::aligner, nub::signal0::emit(), and GxNode::sigNodeChanged.
| void GxShapeKit::setCenterY | ( | double | val | ) | [inherited] |
Change the y value for the location of the object's center to val. This value is used only if the alignment mode is ARBITRARY_ON_CENTER.
Definition at line 410 of file gxshapekit.cc.
References GxShapeKitImpl::aligner, nub::signal0::emit(), and GxNode::sigNodeChanged.
| void GxShapeKit::setPercentBorder | ( | int | pixels | ) | [inherited] |
Change the thickness (as a percentage of object size) of the border that will be added around the bounding box area.
Definition at line 418 of file gxshapekit.cc.
References GxShapeKitImpl::boundsOutline.
Referenced by GxPixmap::GxPixmap(), and GxText::setStrokeWidth().
| void GxShapeKit::setRenderMode | ( | int | mode | ) | [inherited] |
Changes the current rendering mode to mode, unless the requirements of mode (for example, requiring a bounding box) are not met, in which case the scaling mode is unchanged.
Definition at line 430 of file gxshapekit.cc.
References GxShapeKitImpl::cache, nub::signal0::emit(), and GxNode::sigNodeChanged.
Referenced by GxText::GxText().
| void GxShapeKit::draw | ( | Gfx::Canvas & | canvas | ) | const [virtual, inherited] |
This function draws the object according to the GrRenderMode selected with setRenderMode().
Implements GxNode.
Definition at line 443 of file gxshapekit.cc.
References GxShapeKitImpl::topNode.
| bool GxNode::contains | ( | GxNode * | other | ) | const [virtual, inherited] |
Returns true if other is contained within this node in the scene graph. The default implementation (for leaf nodes) returns true only if this == other. For composite nodes, the function will check recursively is other is contained within the composite structure. This function is used to avoid generated cycles in the scene graph.
Reimplemented in GxSeparator.
| rutz::fwd_iter< const nub::ref< GxNode > > GxNode::deepChildren | ( | ) | [virtual, inherited] |
Returns an iterator to all the children recursively contained in this object.
Reimplemented in GxSeparator.
| nub::uid nub::object::id | ( | ) | const throw () [inherited] |
| rutz::fstring nub::object::real_typename | ( | ) | const [inherited] |
Returns the typename of the full object.
The result is a demangled version of typeid(*this).name(), which should very closely resemble the way the object was declared in source code.
Definition at line 67 of file object.cc.
References rutz::demangled_name().
Referenced by nub::object::obj_typename().
| rutz::fstring nub::object::obj_typename | ( | ) | const [virtual, inherited] |
Returns the (apparent) typename of the full object.
The default implementation just returns real_typename(). However, certain kinds of objects -- e.g., proxy objects -- might usefully choose to have obj_typename() return something besides the real_typename(), in order to masquerade as a different type of object.
Reimplemented in io::proxy< C >, io::const_proxy< C >, MtxObj, and TrialMemFuncEvent.
Definition at line 73 of file object.cc.
References nub::object::real_typename().
Referenced by io::legacy_reader::read_root(), and nub::object::unique_name().
| void * nub::ref_counted::operator new | ( | size_t | bytes | ) | [inherited] |
Class-specific operator new; protected to ensure that clients use factory functions.
Definition at line 157 of file refcounted.cc.
| void nub::ref_counted::operator delete | ( | void * | space, | |
| size_t | bytes | |||
| ) | [inherited] |
Class-specific operator delete; private since deletion should only happen in ref_counted::decr_ref_count.
Definition at line 163 of file refcounted.cc.
| void nub::ref_counted::incr_ref_count | ( | ) | const throw () [inherited] |
Increment the object's reference count.
This operation (on the strong reference count) is not permitted if the object is unshareable. Unshareable objects can only have their weak reference counts manipulated.
Definition at line 207 of file refcounted.cc.
References nub::ref_counts::acquire_strong().
Referenced by GxEmptyNode::make().
| void nub::ref_counted::decr_ref_count | ( | ) | const throw () [inherited] |
Decrement the object's reference count.
If this causes the reference count to fall to zero or below, the pointee and the pointer will be destroyed by a call to 'delete this'. This operation (on the strong reference count) is not permitted if the object is unshareable. Unshareable objects can only have their weak reference counts manipulated.
Definition at line 212 of file refcounted.cc.
References nub::ref_counts::release_strong().
| void nub::ref_counted::decr_ref_count_no_delete | ( | ) | const throw () [inherited] |
Decrement the object's reference count, but don't delete it.
Unlike decr_ref_count(), the object will NOT be delete'd if the reference count falls to zero. This operation (on the strong reference count) is not permitted if the object is unshareable. Unshareable objects can only have their weak reference counts manipulated.
Definition at line 221 of file refcounted.cc.
References nub::ref_counts::release_strong_no_delete().
| bool nub::ref_counted::is_shared | ( | ) | const throw () [inherited] |
Returns true if no external client has sole ownership of the object.
This may occur if either (1) the reference count is greater than one, or (2) the object is_not_shareable(), meaning that the object itself is the only "owner".
Definition at line 226 of file refcounted.cc.
References rutz::mutex_atomic_int::atomic_get(), nub::ref_counted::is_not_shareable(), and nub::ref_counts::m_strong.
Referenced by nub::ref_counted::is_unshared().
| bool nub::ref_counted::is_unshared | ( | ) | const throw () [inherited] |
Returns true if there is a sole external owner of the object.
This occurs if the reference count is one or less and the object is shareable.
Definition at line 236 of file refcounted.cc.
References nub::ref_counted::is_shared().
| bool nub::ref_counted::is_not_shareable | ( | ) | const throw () [inherited] |
Returns true if the object is not shareable for any reason. This could be because its lifespan is volatile (such as objects representing on-screen windows that can be dismissed by the user). The default is for objects to be shareable; objects can declare themselves as unshareable by calling mark_as_volatile().
Definition at line 242 of file refcounted.cc.
References nub::ref_counts::m_volatile.
Referenced by nub::ref_counted::is_shared().
| const Field & FieldContainer::field | ( | const rutz::fstring & | name | ) | const [inherited] |
Lookup the Field for a given name.
An exception will be thrown if no such Field is found.
Definition at line 176 of file fields.cc.
References FieldMap::field().
The documentation for this class was generated from the following files: