[Bf-docboard-svn] bf-manual: [9602] trunk/blender_docs/manual: GPencil: Doc and images update
Matias Mendiola
noreply at blender.org
Thu Oct 6 18:17:09 CEST 2022
Revision: 9602
https://developer.blender.org/rBM9602
Author: mendio
Date: 2022-10-06 18:17:09 +0200 (Thu, 06 Oct 2022)
Log Message:
-----------
GPencil: Doc and images update
Modified Paths:
--------------
trunk/blender_docs/manual/grease_pencil/modes/draw/tools/draw.rst
trunk/blender_docs/manual/grease_pencil/modes/draw/tools/fill.rst
trunk/blender_docs/manual/grease_pencil/modes/edit/grease_pencil_menu.rst
trunk/blender_docs/manual/grease_pencil/modes/edit/stroke_menu.rst
trunk/blender_docs/manual/grease_pencil/modifiers/generate/index.rst
trunk/blender_docs/manual/grease_pencil/modifiers/modify/time_offset.rst
trunk/blender_docs/manual/images/grease-pencil_modes_draw_tool-settings_brushes_fill-brush-data-block.png
trunk/blender_docs/manual/images/grease-pencil_modes_draw_tools_fill_extended-strokes-02.png
trunk/blender_docs/manual/images/grease-pencil_modifiers_generate_envelope_panel.png
trunk/blender_docs/manual/images/grease-pencil_modifiers_introduction_menu.png
Added Paths:
-----------
trunk/blender_docs/manual/grease_pencil/modifiers/generate/outline.rst
trunk/blender_docs/manual/images/grease-pencil_modes_draw_tools_fill_radius-02.png
trunk/blender_docs/manual/images/grease-pencil_modes_draw_tools_fill_radius-03.png
trunk/blender_docs/manual/images/grease-pencil_modes_edit_stroke-menu_outline-1.png
trunk/blender_docs/manual/images/grease-pencil_modes_edit_stroke-menu_outline-2.png
trunk/blender_docs/manual/images/grease-pencil_modifiers_generate_outline_panel.png
Modified: trunk/blender_docs/manual/grease_pencil/modes/draw/tools/draw.rst
===================================================================
--- trunk/blender_docs/manual/grease_pencil/modes/draw/tools/draw.rst 2022-10-04 20:47:05 UTC (rev 9601)
+++ trunk/blender_docs/manual/grease_pencil/modes/draw/tools/draw.rst 2022-10-06 16:17:09 UTC (rev 9602)
@@ -134,7 +134,16 @@
Trim Strokes End
Automatically trim intersection strokes ends.
+.. _bpy.types.BrushGpencilSettings.use_settings_outline:
+Outline
+ Activate the conversion of the newly created stroke to its outline.
+
+ Material
+ Material used for outline stroke.
+ Thickness
+ Thickness used for outline stroke.
+
.. _bpy.types.BrushGpencilSettings.use_settings_random:
Randomize
Modified: trunk/blender_docs/manual/grease_pencil/modes/draw/tools/fill.rst
===================================================================
--- trunk/blender_docs/manual/grease_pencil/modes/draw/tools/fill.rst 2022-10-04 20:47:05 UTC (rev 9601)
+++ trunk/blender_docs/manual/grease_pencil/modes/draw/tools/fill.rst 2022-10-06 16:17:09 UTC (rev 9602)
@@ -54,7 +54,7 @@
:Stroke: Use only the thickness of the strokes (ignore edit lines).
:Line: Use only the edit lines (ignore strokes).
- .. _bpy.types.BrushGpencilSettings.show_fill_boundary:
+.. _bpy.types.BrushGpencilSettings.show_fill_boundary:
Show Lines (grid icon)
Toggle show auxiliary lines to see the fill boundary.
@@ -71,23 +71,6 @@
:All Above: Calculates boundaries based on all layers above the active layer.
:All Below: Calculates boundaries based on all layers below the active layer.
-.. _bpy.types.BrushGpencilSettings.extend_stroke_factor:
-
-Stroke Extension
- Extends the actual stroke to close gaps in the fill area.
- The extended strokes are temporarily and will be not be rendered.
- The value control the extension length to use. Zero value means disabled.
-
- .. _bpy.types.BrushGpencilSettings.show_fill_extend:
-
- Visual Aids (eye icon)
- Toggle show extended lines helper.
-
-.. _bpy.types.BrushGpencilSettings.fill_leak:
-
-Leak Size
- Size in pixel to consider the leak as closed.
-
.. _bpy.types.BrushGpencilSettings.fill_simplify_level:
Simplify
@@ -107,7 +90,27 @@
Limit to Viewport
When enabled, fill only visible areas in the viewport.
+Gap Closure
+^^^^^^^^^^^
+Gap closure lines are automatic temporarily lines that help to close gaps on the strokes.
+
+.. _bpy.types.BrushGpencilSettings.extend_stroke_factor:
+
+Size
+ Control the Size of the line extension or the circumference to use to calculate the lines that will close the gaps.
+
+Mode
+ Sets the type of Gap closure method to use.
+
+ :Radius: Uses the Radius of circumference of opened nearest points to calculate a line that close the gap.
+ :Extend: Extends the opened strokes to close gaps.
+
+.. _bpy.types.BrushGpencilSettings.show_fill_extend:
+
+Visual Aids
+ Toggle show closure lines helper.
+
Usage
=====
@@ -147,7 +150,7 @@
----------------
If you have a large gap in an area that you want fill,
-you can use boundary strokes, a temporary auxiliary lines for closing open shapes.
+you can add boundary strokes manually, a temporary auxiliary lines for closing open shapes.
To create a boundary stroke use :kbd:`Alt-LMB` and draw a line to close the desired area.
.. list-table::
@@ -171,12 +174,37 @@
the *Clean Up* tool in the :doc:`Grease Pencil Menu </grease_pencil/modes/edit/grease_pencil_menu>` in Edit Mode.
-Stroke Extension
-----------------
+Automatic Gap Closure
+---------------------
-A more automatic way to close gaps in an area that you want fill is using temporarily extended lines.
-*Stroke Extension* are temporary extended auxiliary lines for closing open shapes.
-Set a value more than zero to use the extended lines, click over the area you want to be filled
+A more automatic way to close gaps in an area that you want fill is using temporarily helper lines.
+There are two method to use "Radius" or "Extend"
+
+*Radius* use temporary auxiliary lines calculated from the radius of nearby open points to close open shapes.
+Set the size more than zero to control the circle size over opened points (the circle will disappear when the line close the gap).
+Click over the area you want to be filled and change the length of the strokes using :kbd:`PageUp` :kbd:`PageDown` or :kbd:`Wheel`.
+When you are satisfied with the length and you are sure the temporarily strokes cross each other,
+click again to fill the area.
+
+.. list-table::
+
+ * - .. figure:: /images/grease-pencil_modes_draw_tools_fill_extended-strokes-01.png
+ :width: 200px
+
+ Original Drawing.
+
+ - .. figure:: /images/grease-pencil_modes_draw_tools_fill_radius-02.png
+ :width: 200px
+
+ Use Radius mode to close open areas (Red circles and cyan lines).
+
+ - .. figure:: /images/grease-pencil_modes_draw_tools_fill_radius-03.png
+ :width: 200px
+
+ Use Fill Tool to leak material on the new closed area.
+
+*Extend* use temporary auxiliary lines extending the actual strokes ends for closing open shapes.
+Set the size more than zero to use the extended lines, click over the area you want to be filled
and change the length of the strokes using :kbd:`PageUp` :kbd:`PageDown` or :kbd:`Wheel`.
When you are satisfied with the length and you are sure the temporarily strokes cross each other,
click again to fill the area.
@@ -191,7 +219,7 @@
- .. figure:: /images/grease-pencil_modes_draw_tools_fill_extended-strokes-02.png
:width: 200px
- Use Strokes extension to close open areas (cyan lines).
+ Use Extend mode to close open areas (cyan lines).
- .. figure:: /images/grease-pencil_modes_draw_tools_fill_extended-strokes-03.png
:width: 200px
@@ -202,6 +230,6 @@
Switch to Draw Tool
-------------------
-Use :kbd:`Shift-LMB` to change temporary to the active draw tool.
+Use :kbd:`Ctrl-LMB` to change temporary to the active draw tool.
For example to manually cover small areas difficult to reach for the Fill tool.
See :doc:`Draw Tool </grease_pencil/modes/draw/tools/draw>` for more information.
Modified: trunk/blender_docs/manual/grease_pencil/modes/edit/grease_pencil_menu.rst
===================================================================
--- trunk/blender_docs/manual/grease_pencil/modes/edit/grease_pencil_menu.rst 2022-10-04 20:47:05 UTC (rev 9601)
+++ trunk/blender_docs/manual/grease_pencil/modes/edit/grease_pencil_menu.rst 2022-10-06 16:17:09 UTC (rev 9602)
@@ -313,6 +313,9 @@
Cursor
Reproject selected strokes onto 3D cursor rotation.
+Surface Offset
+ When Surface Mode is activated controls the stroke offset from the object.
+
Keep Original
Maintains the original strokes after applying the tool.
Modified: trunk/blender_docs/manual/grease_pencil/modes/edit/stroke_menu.rst
===================================================================
--- trunk/blender_docs/manual/grease_pencil/modes/edit/stroke_menu.rst 2022-10-04 20:47:05 UTC (rev 9601)
+++ trunk/blender_docs/manual/grease_pencil/modes/edit/stroke_menu.rst 2022-10-06 16:17:09 UTC (rev 9602)
@@ -111,7 +111,31 @@
Result of trim operation.
+.. _bpy.ops.gpencil.stroke_trim:
+Outline
+=======
+
+.. reference::
+
+ :Mode: Edit Mode
+ :Menu: :menuselection:`Stroke --> Outline`
+
+Converts a stroke to an outline.
+
+.. list-table::
+
+ * - .. figure:: /images/grease-pencil_modes_edit_stroke-menu_outline-1.png
+ :width: 320px
+
+ Original stroke.
+
+ - .. figure:: /images/grease-pencil_modes_edit_stroke-menu_outline-2.png
+ :width: 320px
+
+ Generated stroke after outline operation.
+
+
.. _bpy.ops.gpencil.stroke_join:
Join
@@ -315,16 +339,17 @@
Reverse the direction of the points in the selected strokes
(i.e. the start point will become the end one, and vice versa).
+.. _bpy.ops.gpencil.stroke_start_set:
-Scale Thickness
+Set Start Point
===============
.. reference::
:Mode: Edit Mode
- :Menu: :menuselection:`Stroke --> Scale Thickness`
+ :Menu: :menuselection:`Stroke --> Set Start Point`
-When enabled, scales the stroke thickness during scale transformations.
+Set the start point for cyclic strokes.
Normalize Thickness
@@ -361,6 +386,16 @@
Opacity value to use on all points of the stroke.
+Scale Thickness
+===============
+
+.. reference::
+
+ :Mode: Edit Mode
+ :Menu: :menuselection:`Stroke --> Scale Thickness`
+
+When enabled, scales the stroke thickness during scale transformations.
+
Reset Fill Transform
====================
Modified: trunk/blender_docs/manual/grease_pencil/modifiers/generate/index.rst
===================================================================
--- trunk/blender_docs/manual/grease_pencil/modifiers/generate/index.rst 2022-10-04 20:47:05 UTC (rev 9601)
+++ trunk/blender_docs/manual/grease_pencil/modifiers/generate/index.rst 2022-10-06 16:17:09 UTC (rev 9602)
@@ -14,5 +14,6 @@
line_art.rst
mirror.rst
multiple_strokes.rst
+ outline.rst
simplify.rst
subdivide.rst
Added: trunk/blender_docs/manual/grease_pencil/modifiers/generate/outline.rst
===================================================================
--- trunk/blender_docs/manual/grease_pencil/modifiers/generate/outline.rst (rev 0)
+++ trunk/blender_docs/manual/grease_pencil/modifiers/generate/outline.rst 2022-10-06 16:17:09 UTC (rev 9602)
@@ -0,0 +1,40 @@
+.. index:: Grease Pencil Modifiers; Outline Modifier
+.. _bpy.types.OutlineGpencilModifier:
+
+*****************
+Outline Modifier
+*****************
+
+The *Outline* modifier convert strokes to outline tracing all strokes perimeter with new strokes.
+
+
+Options
+=======
+
+.. figure:: /images/grease-pencil_modifiers_generate_outline_panel.png
+ :align: right
+
+ The Outline modifier.
+
+Thickness
+ The thickness of the generated strokes outline.
+
+ Keep shape
+ The perimeter strokes are maintaining inside the original stroke perimeter trying to keep the original shape.
+
+Subdivisions
+ controls the number of subdivision of the generated strokes outline.
+
+Sample Length
+ Controls the accuracy of the perimeter conversion.
+
+Outline Material
+ Defines the material to use on the generated strokes outline.
+
+Target Object
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list