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
|
.. _bpy.ops.grease_pencil.trace_image:
****************************
Trace Image to Grease Pencil
****************************
.. reference::
:Mode: Object Mode
:Menu: :menuselection:`Object --> Convert --> Trace Image to Grease Pencil`
The *Trace Image to Grease Pencil* tool traces a black and white image and generates Grease Pencil strokes.
If the image is not black and white, it will be internally converted.
For better results, convert the images manually to black and white.
Also try to keep the resolution of the image small; high resolutions can produce very dense strokes.
Usage
=====
#. Add an :ref:`Image Empty <bpy.types.Object.empty_image>` to the scene.
#. Run *Trace Image to Grease Pencil*.
Options
=======
Target Object
Determines if the image empty is kept or replaced.
New Object: Creates a new grease pencil object and keeps the image empty
Selected Object: Replaces the image empty with the grease pencil object.
Radius
The thickness of the generated Grease Pencil strokes.
Color Threshold
Determine the :term:`Luminance` threshold above which strokes are generated.
Turn Policy
Determines how to resolve ambiguities during decomposition of an image into paths.
:Black: Prioritizes to connect black (foreground) components.
:White: Prioritizes to connect white (background) components.
:Left: Always take a left turn.
:Right: Always take a right turn.
:Minority: Prioritizes to connect the color (black or white) that occurs
least frequently in the local neighborhood of the current position.
:Majority: Prioritizes to connect the color (black or white) that occurs
most frequently in the local neighborhood of the current position.
:Random: Choose pseudo-randomly.
Mode
Determines if the image being traced is a single image or image sequence.
:Single: The image empty is a single image or the current frame of an image sequence.
:Sequence: The image empty is an :ref:`Image Sequence <image-sequence>`.
Start at Current Frame
When enabled, start the tracing process at the current image frame.
Trace Frame
Used to trace only one frame of the image sequence, set to zero to trace all.
|
