Graphite  Version 3
An experimental 3D geometry processing program
OGF::MeshGrobTransformTool Class Referenceabstract

A MultiTool that applies a mouse-controlled transform to a subset. More...

#include <OGF/mesh_gfx/tools/mesh_grob_tool.h>

Inheritance diagram for OGF::MeshGrobTransformTool:
OGF::MultiTool OGF::Tool OGF::Node OGF::Object GEO::Counted OGF::MeshGrobCopyComponent OGF::MeshGrobTransformComponent OGF::MeshGrobTransformFacet

Public Member Functions

 MeshGrobTransformTool (ToolsManager *parent)
 
void grab (const RayPick &p_ndc) override
 
void release (const RayPick &p_ndc) override
 The event handler for mouse release events. More...
 
MeshGrobmesh_grob () const
 Gets the MeshGrob this MeshGrobTransformTool operates on. More...
 
- Public Member Functions inherited from OGF::MultiTool
 MultiTool (ToolsManager *mgr)
 MultiTool constructor. More...
 
void grab (const RayPick &value) override
 
void drag (const RayPick &value) override
 The event handler for mouse drag events. More...
 
void release (const RayPick &value) override
 The event handler for mouse release events. More...
 
void reset () override
 Resets this Tool. More...
 
- Public Member Functions inherited from OGF::Tool
 Tool (ToolsManager *mgr)
 Tool constructor. More...
 
void status (const std::string &value)
 Outputs a message in the status bar. More...
 
SceneGraphscene_graph ()
 Gets the SceneGraph. More...
 
virtual void configure ()
 Configures this Tool. More...
 
ToolsManagertools_manager () const
 Gets the ToolsManager. More...
 
const mat4focus () const
 Gets the current focus matrix. More...
 
RenderingContextrendering_context () const
 Gets the RenderingContext. More...
 
Grobobject () const
 Gets the current object. More...
 
vec2 project_point (vec3 p) const
 Computes screen-coordinates of a 3D point. More...
 
vec2 ndc_to_dc (vec2 p) const
 Converts normalized device coordinates to device coordinates. More...
 
- Public Member Functions inherited from OGF::Node
 Node (Node *parent=nullptr)
 Node constructor. More...
 
virtual ~Node ()
 Node destructor.
 
virtual void add_child (Node *child)
 Adds a child to this Node. More...
 
virtual void remove_child (Node *child)
 Removes a child from this Node. \parma[in] child a pointer to the child to be removed.
 
Nodeget_parent () const
 Gets the parent. More...
 
- Public Member Functions inherited from OGF::Object
 Object (bool transient=false)
 Object constructor. More...
 
virtual ~Object ()
 Object destructor.
 
virtual MetaClassmeta_class () const
 Gets the meta class. More...
 
virtual void set_meta_class (MetaClass *mclass)
 Sets the meta class. More...
 
unsigned int id () const
 Gets the identifier of this object. More...
 
std::string string_id () const
 Gets the unique string identifier. More...
 
bool has_method (const std::string &method_name) const
 Tests whether a method is defined. More...
 
virtual bool invoke_method (const std::string &method_name, const ArgList &args, Any &ret_val)
 Invokes a method by method name and argument list, and gets the return value. More...
 
bool invoke_method (const std::string &method_name, const ArgList &args)
 Invokes a method by method name and argument list. More...
 
bool invoke_method (const std::string &method_name)
 Invokes a method by method name. More...
 
bool has_property (const std::string &prop_name) const
 Tests whether a property is defined. More...
 
virtual bool get_property (const std::string &prop_name, std::string &prop_value) const
 Gets a property. More...
 
virtual Connectionconnect_signal_to_slot (const std::string &signal_name, Object *to, const std::string &slot_name)
 Connects a signal with a slot of another object. More...
 
virtual void add_connection (Connection *connection)
 Adds a connection to this object. More...
 
virtual void remove_connection (Connection *connection)
 Removes a connection to this object. More...
 
virtual void get_element (index_t i, Any &value) const
 Gets an element by index. More...
 
virtual void set_element (index_t i, const Any &value)
 Sets an element by index. More...
 
virtual void search (const std::string &needle, const std::string &path="")
 Displays the names of all objects that contain a substring. More...
 
bool get_signals_enabled () const
 Tests wheter signals are enabled. More...
 
void set_signals_enabled (bool value)
 Enables or disables signals. More...
 
bool get_slots_enabled () const
 Tests wheter slots are enabled. More...
 
void set_slots_enabled (bool value)
 Enables or disables slots. More...
 
MetaClassget_meta_class () const
 Gets the meta class. More...
 
std::string get_string_id () const
 Gets the unique string identifier. More...
 
virtual std::string get_doc () const
 Gets the documentation. More...
 
virtual Sign compare (const Object *other) const
 Compares this object with another one. More...
 
virtual bool is_a (const MetaType *type) const
 Tests whether this object inherits a given type. More...
 
void disconnect ()
 Removes all connections from signals of this objects. More...
 
void enable_signals ()
 Enables signals.
 
void disable_signals ()
 Disables signals.
 
void enable_slots ()
 Enables slots.
 
void disable_slots ()
 Disables slots.
 
void set_properties (const ArgList &args)
 Sets several properties in a single call. More...
 
virtual bool set_property (const std::string &name, const std::string &value)
 Sets an individual property. More...
 
void help () const
 Displays some help about this object. More...
 
virtual bool set_property (const std::string &name, const Any &value)
 Sets an individual property. More...
 
virtual bool get_property (const std::string &prop_name, Any &prop_value) const
 Gets a property. More...
 
- Public Member Functions inherited from GEO::Counted
void ref () const
 Increments the reference count. More...
 
void unref () const
 Decrements the reference count. More...
 
bool is_shared () const
 Check if the object is shared. More...
 
int nb_refs () const
 Gets the number of references that point to this object. More...
 

Protected Member Functions

void update_transform_subset (const mat4 &M)
 Applies the transform M to the subset. More...
 
const vec3center () const
 Gets the center of the subset.
 
virtual void pick_subset (MeshGrobTransformSubset *tool, const RayPick &rp)=0
 Gets the subset by picking. More...
 
virtual void transform_subset (const mat4 &M)=0
 Applies a 3D transform to the subset. More...
 
virtual void clear_subset ()
 Clears the state variables that store the subset. More...
 
- Protected Member Functions inherited from OGF::MultiTool
void set_tool (int button, Tool *tool)
 Associates a tool to one of the buttons. More...
 
Toolget_tool (int button) const
 Gets a Tool by button id. More...
 
- Protected Member Functions inherited from OGF::Tool
void set_tooltip (const std::string &text)
 Sets the tooltip to be displayed under the mouse. More...
 
void reset_tooltip ()
 Removes a tooltip previously created by set_tooltip()
 
- Protected Member Functions inherited from OGF::Node
void swap_children (Node *n1, Node *n2)
 Swaps two children by indices. More...
 
- Protected Member Functions inherited from OGF::Object
virtual bool emit_signal (const std::string &signal_name, const ArgList &args, bool called_from_slot=false)
 Emits a signal and calls the slots it is connected to. More...
 
- Protected Member Functions inherited from GEO::Counted
 Counted ()
 Creates a reference counted object. More...
 
virtual ~Counted ()
 Destroys a reference counted object. More...
 

Protected Attributes

mat4 prev_inverse_transform_
 The inverse of the previous transform. More...
 
vec3 center_
 
- Protected Attributes inherited from OGF::MultiTool
Tool_var tools_ [MOUSE_BUTTONS_NB]
 
- Protected Attributes inherited from OGF::Tool
ToolsManagertools_manager_
 

Friends

class MeshGrobTransformSubset
 

Additional Inherited Members

- Static Public Member Functions inherited from OGF::Object
static Objectid_to_object (unsigned int id)
 Gets an object from a unique object id. More...
 
- Static Public Member Functions inherited from GEO::Counted
static void ref (const Counted *counted)
 Increments the reference count. More...
 
static void unref (const Counted *counted)
 Decrements the reference count. More...
 
- Public Attributes inherited from OGF::Tool
 __pad0__: virtual void grab(const RayPick& value)
 
- Public Attributes inherited from OGF::Node
 __pad0__: Node* ith_child(index_t i) const { ogf_assert(i < get_nb_children())
 
return children_ [i]
 
 __pad1__: size_t get_nb_children() const { return children_.size()
 
- Public Attributes inherited from OGF::Object
 __pad0__: virtual index_t get_nb_elements() const
 
 __pad1__: bool equals(const Object* other) const
 

Detailed Description

A MultiTool that applies a mouse-controlled transform to a subset.

Left mouse button controls a translation, center mouse button controls a scaling, and right mouse button controls a rotation.

Definition at line 378 of file mesh_grob_tool.h.

Member Function Documentation

◆ clear_subset()

virtual void OGF::MeshGrobTransformTool::clear_subset ( )
protectedvirtual

Clears the state variables that store the subset.

Default implementation does nothing.

Reimplemented in OGF::MeshGrobTransformComponent.

◆ grab()

void OGF::MeshGrobTransformTool::grab ( const RayPick p_ndc)
override

◆ mesh_grob()

MeshGrob* OGF::MeshGrobTransformTool::mesh_grob ( ) const
inline

Gets the MeshGrob this MeshGrobTransformTool operates on.

Returns
a pointer to the MeshGrob

Definition at line 409 of file mesh_grob_tool.h.

◆ pick_subset()

virtual void OGF::MeshGrobTransformTool::pick_subset ( MeshGrobTransformSubset tool,
const RayPick rp 
)
protectedpure virtual

Gets the subset by picking.

This function is called when the mouse is pressed. It is meant to be overloaded in derived classes, to memorize the picked subset in some state variables.

Parameters
[in]toola pointer to the MeshGrobTransformSubset
[in]rpa RayPick as returned by RenderArea events

Implemented in OGF::MeshGrobTransformFacet, OGF::MeshGrobCopyComponent, and OGF::MeshGrobTransformComponent.

◆ release()

void OGF::MeshGrobTransformTool::release ( const RayPick p_ndc)
overridevirtual

The event handler for mouse release events.

Parameters
[in]valuea const reference to the picking event

Reimplemented from OGF::Tool.

◆ transform_subset()

virtual void OGF::MeshGrobTransformTool::transform_subset ( const mat4 M)
protectedpure virtual

Applies a 3D transform to the subset.

Parameters
[in]Ma const reference of the homogeneous coordinates matrix of the transform.

Implemented in OGF::MeshGrobTransformFacet, OGF::MeshGrobCopyComponent, and OGF::MeshGrobTransformComponent.

◆ update_transform_subset()

void OGF::MeshGrobTransformTool::update_transform_subset ( const mat4 M)
inlineprotected

Applies the transform M to the subset.

The transform /p M is applied to the subset as it was when grab() was called (any previously applied transform is canceled).

Parameters
[in]Mthe transform to be applied

Definition at line 422 of file mesh_grob_tool.h.

Member Data Documentation

◆ prev_inverse_transform_

mat4 OGF::MeshGrobTransformTool::prev_inverse_transform_
protected

The inverse of the previous transform.

It is used when the transform is updated, to undo the previous transform.

Definition at line 465 of file mesh_grob_tool.h.


The documentation for this class was generated from the following file: