File: hook.rst

package info (click to toggle)
blender-doc 4.3-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 253,604 kB
  • sloc: python: 13,030; javascript: 322; makefile: 113; sh: 107
file content (73 lines) | stat: -rw-r--r-- 1,975 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
.. index:: Grease Pencil Modifiers; Hook Modifier
.. _bpy.types.GreasePencilHookModifier:

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

The *Hook* Modifier is used to deform stroke points using another object
(usually an empty or a bone but it can be any object).

As the hook moves, it pulls points from the strokes with it.
You can think of it as animated
:doc:`Proportional Editing </editors/3dview/controls/proportional_editing>`.

.. seealso::

   This documentation refers to the Hook Modifier specific to the Grease Pencil object.
   For uses with other object types refer to the general :doc:`/modeling/modifiers/deform/hooks`.


Options
=======

.. figure:: /images/grease-pencil_modifiers_deform_hook_panel.png
   :align: right
   :width: 300px

   The Hook modifier.

Object
   The name of the object to hook points to.

Vertex Group
   Restricts the effect only to a vertex group.

Strength
   Adjust this hooks influence on the stroke points, were (0.0 to 1.0) (no change to fully follow the hook).


Falloff
-------

Type
   This can be used to adjust the type of curve for the Strength attenuation.
   You can also define a custom curve to get a much higher level of control.

Radius
   The size of the hooks influence.

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.


Influence
---------

See :ref:`grease-pencil-modifier-influence-filters`.

.. note::

   The Hook Modifier stores points indices from the original strokes to determine what to affect;
   this means that modifiers that generate geometry, like a Subdivision Surface Modifier,
   should always be applied **after** the Hook Modifier;
   otherwise the generated geometry will be left out of the hook's influence.


Example
=======

.. figure:: /images/grease-pencil_modifiers_deform_hook_sample.png

   Empty used as a hook to manipulate a vertex group (right eye of the monkey).