.. _bpy.types.HookModifier:

*************
Hook Modifier
*************

The *Hook* modifier is used to deform a *Mesh*, *Curve* or *Lattice* using another object
(usually an *Empty* or a *Bone* but it can be any object).

As the hook moves, it pulls vertices or control points from the geometry with it.
You can think of it as animated
:doc:`Proportional Editing </scene_layout/object/editing/transform/control/proportional_edit>`.

While hooks do not give you the fine control over vertices movement that shape keys do,
they have the advantage that you can select vertices directly for manipulation.


Options
=======

.. figure:: /images/modeling_modifiers_deform_hooks_panel.png
   :align: right

   The Hook modifier.

Object
   The name of the object to hook vertices to.
Vertex Group
   Allows you to define the influence per vertex.

   Useful when you want something other than a spherical field of influence.

Radius
   The size of the hooks influence.
Strength
   Adjust this hooks influence on the vertices, were (0.0 to 1.0) (no change to fully follows the hook).

   Since multiple hooks can work on the same vertices, you can weight the influence of a hook using this property.

Falloff Type
   This can be used to adjust the kind of influence curve that the hook has on the mesh.
   You can also define a custom curve to get a much higher level of control.
Uniform Falloff
   This setting is useful when using hooks on scaled objects,
   especially in cases where non-uniform scale would stretch the result of the hook.

   This is especially useful for lattices, where it is common to use non-uniform scaling.

The following settings are only available in Edit Mode:

Reset
   Recalculate and clear the offset transform of the hook.
Recenter
   Set the hook center to the 3D cursor position.

Select
   Select the vertices affected by this hook.
Assign
   Assigns selected vertices to this hook.

.. warning::

   The Hook Modifier stores vertex indices from the original mesh to determine what to affect.
   This means that modifiers that generate geometry, like *Subdivision Surface*,
   should always be put **after** the *Hook* one in the stack.
   Otherwise, the generated geometry will be left out of the hook's influence.


Example
=======

.. figure:: /images/modeling_modifiers_deform_hooks_example.png
   :width: 460px

   Empty used as Hook to deform a subdivided cube.