[Bf-docboard-svn] bf-manual: [7359] trunk/blender_docs/manual: GPencil: New Trace images using Potrace

[Aaron Carlisle]

Revision: 7359
          https://developer.blender.org/rBM7359
Author:   Blendify
Date:     2020-11-11 23:01:39 +0100 (Wed, 11 Nov 2020)
Log Message:
-----------
GPencil: New Trace images using Potrace

rB4d62bb8fe57ca431da669386d47ca185f3624c9a

Modified Paths:
--------------
    trunk/blender_docs/manual/editors/image/image_settings.rst
    trunk/blender_docs/manual/grease_pencil/modes/object/index.rst

Added Paths:
-----------
    trunk/blender_docs/manual/grease_pencil/modes/object/trace_image.rst

Modified: trunk/blender_docs/manual/editors/image/image_settings.rst
===================================================================
--- trunk/blender_docs/manual/editors/image/image_settings.rst	2020-11-11 22:00:35 UTC (rev 7358)
+++ trunk/blender_docs/manual/editors/image/image_settings.rst	2020-11-11 22:01:39 UTC (rev 7359)
@@ -31,6 +31,8 @@
 Still image or a single frame.
 
 
+.. _image-sequence:
+
 Image Sequence
 ^^^^^^^^^^^^^^
 

Modified: trunk/blender_docs/manual/grease_pencil/modes/object/index.rst
===================================================================
--- trunk/blender_docs/manual/grease_pencil/modes/object/index.rst	2020-11-11 22:00:35 UTC (rev 7358)
+++ trunk/blender_docs/manual/grease_pencil/modes/object/index.rst	2020-11-11 22:01:39 UTC (rev 7359)
@@ -7,3 +7,4 @@
    :maxdepth: 2
 
    convert_to_geometry.rst
+   trace_image.rst

Added: trunk/blender_docs/manual/grease_pencil/modes/object/trace_image.rst
===================================================================
--- trunk/blender_docs/manual/grease_pencil/modes/object/trace_image.rst	                        (rev 0)
+++ trunk/blender_docs/manual/grease_pencil/modes/object/trace_image.rst	2020-11-11 22:01:39 UTC (rev 7359)
@@ -0,0 +1,68 @@
+.. _bpy.ops.gpencil.trace_image:
+
+*****************************
+Trace Images to Grease Pencil
+*****************************
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Mode:      Object Mode
+   :Menu:      :menuselection:`Object --> Trace Images to Grease Pencil`
+
+The *Trace Images to Grease Pencil* operator 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, use manually converted to black and white images.
+Also try to keep the resolution of the image small; high resolutions could produce very dense strokes.
+
+
+Usage
+=====
+
+#. Add an :ref:`Image Empty <bpy.types.Object.empty_image>` to the scene.
+#. Run *Trace Images to Grease Pencil*.
+
+
+Options
+=======
+
+Target Object
+   The grease pencil object name. If empty, a new grease pencil object will be created.
+
+Thickness
+   The thickness of the generated grease pencil strokes.
+
+Resolution
+   Resolution of the generated  grease pencil strokes i.e. how many control points the stroke will have.
+   A higher resolution will preserve more detail from the original image.
+
+Scale
+   The object scale applied to the generated grease pencil object.
+
+Sample
+   Recreates the stroke geometry with a predefined length between points.
+   Smaller values will require more points to recreate the stroke,
+   while larger values will result in fewer points needed to recreate the curve.
+   A value of 0 disables stroke sampling.
+
+Color Threshold
+   Determines what is considered white and what black.
+
+Turn Policy
+   Determines how to resolve ambiguities during decomposition of bitmaps into paths.
+
+   :Black: Prefers to connect black (foreground) components.
+   :White: Prefers to connect white (background) components.
+   :Left: Always take a left turn.
+   :Right: Always take a right turn.
+   :Minority: Prefers to connect the color (black or white) that occurs least
+      frequently in the local neighborhood of the current position.
+   :Majority: Prefers 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 an 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 a :ref:`Image Sequence <image-sequence>`.


Property changes on: trunk/blender_docs/manual/grease_pencil/modes/object/trace_image.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property