[Bf-docboard-svn] bf-manual: [7896] trunk/blender_docs/manual: GPencil: New features and updates

Matias Mendiola noreply at blender.org
Wed Mar 24 22:08:03 CET 2021


Revision: 7896
          https://developer.blender.org/rBM7896
Author:   mendio
Date:     2021-03-24 22:08:03 +0100 (Wed, 24 Mar 2021)
Log Message:
-----------
GPencil: New features and updates

Modified Paths:
--------------
    trunk/blender_docs/manual/addons/import_export/index.rst
    trunk/blender_docs/manual/editors/3dview/display/overlays.rst
    trunk/blender_docs/manual/grease_pencil/animation/introduction.rst
    trunk/blender_docs/manual/grease_pencil/modes/draw/tools/cutter.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/object/trace_image.rst
    trunk/blender_docs/manual/grease_pencil/modifiers/generate/array.rst
    trunk/blender_docs/manual/grease_pencil/multiframe.rst
    trunk/blender_docs/manual/grease_pencil/properties/layers.rst
    trunk/blender_docs/manual/images/editors_dope-sheet_grease-pencil_view.png
    trunk/blender_docs/manual/images/grease-pencil_animation_introduction_drawing-options.png
    trunk/blender_docs/manual/images/grease-pencil_animation_introduction_example.png
    trunk/blender_docs/manual/images/grease-pencil_modifiers_deform_noise_panel.png
    trunk/blender_docs/manual/images/grease-pencil_multiframe_panel.png
    trunk/blender_docs/manual/images/grease-pencil_properties_layers_panel.png
    trunk/blender_docs/manual/interface/annotate_tool.rst

Added Paths:
-----------
    trunk/blender_docs/manual/addons/import_export/gpencil_pdf.rst
    trunk/blender_docs/manual/addons/import_export/gpencil_svg.rst
    trunk/blender_docs/manual/images/grease-pencil_modes_draw_tools_fill_extended-strokes-01.png
    trunk/blender_docs/manual/images/grease-pencil_modes_draw_tools_fill_extended-strokes-02.png
    trunk/blender_docs/manual/images/grease-pencil_modes_draw_tools_fill_extended-strokes-03.png

Added: trunk/blender_docs/manual/addons/import_export/gpencil_pdf.rst
===================================================================
--- trunk/blender_docs/manual/addons/import_export/gpencil_pdf.rst	                        (rev 0)
+++ trunk/blender_docs/manual/addons/import_export/gpencil_pdf.rst	2021-03-24 21:08:03 UTC (rev 7896)
@@ -0,0 +1,45 @@
+
+************************************************
+Portable Document Fromat (PDF) as Grease Pencil
+************************************************
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Category:  Import-Export
+   :Menu:      :menuselection:`File --> Export --> Grease Pencil as PDF`
+
+.. warning:: .. warning:: This script only works in Object Mode.
+
+Properties
+==========
+
+Object
+   Determine wich objects include in the export
+
+   :Active: Export only the active Grease Pencil object.
+   :Selected: Export all selected Grease Pencil objects.
+   :Visible: Export all visible Grease Pencil object in the scene.
+
+Frame
+   :Active: Export only the active keyframe.
+   :Selected: Export all selected keyframes as different PDF pages.
+
+.. note:: To enable multi-keyframe selection you must enable Multiframe Edition.
+   See :doc:`Multiframe Edition </grease_pencil/multiframe>` for more information.
+
+Sampling
+   Precision for the stroke sampling. Low values mean a more accurate result.
+
+Fill
+   When enabled, Export the Grease Pencil strokes fill.
+
+Normalize
+   When enabled, Export strokes with constant thickness.
+
+
+Usage
+=====
+
+This format is use for interchanging PDF between applications,
+it support the export of Grease Pencil animation creating one page in the PDF document for each keyframe selected.


Property changes on: trunk/blender_docs/manual/addons/import_export/gpencil_pdf.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/blender_docs/manual/addons/import_export/gpencil_svg.rst
===================================================================
--- trunk/blender_docs/manual/addons/import_export/gpencil_svg.rst	                        (rev 0)
+++ trunk/blender_docs/manual/addons/import_export/gpencil_svg.rst	2021-03-24 21:08:03 UTC (rev 7896)
@@ -0,0 +1,56 @@
+
+************************************************
+Scalable Vector Graphics (SVG) as Grease Pencil
+************************************************
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Category:  Import-Export
+   :Menu:      :menuselection:`File --> Import --> SVG as Grease Pencil`
+   :Menu:      :menuselection:`File --> Export --> Grease Pencil as SVG`
+
+.. warning:: This script only works in Object Mode.
+
+Import
+======
+
+Properties
+----------
+
+Resolution
+   Resolution for generated strokes.
+
+Scale
+   Generated strokes scale.
+
+Export
+======
+
+Properties
+----------
+
+Object
+   Determine wich objects include in the export
+
+   :Active: Export only the active Grease Pencil object.
+   :Selected: Export all selected Grease Pencil objects.
+   :Visible: Export all visible Grease Pencil object in the scene.
+
+Sampling
+   Precision for the stroke sampling. Low values mean a more accurate result.
+
+Fill
+   When enabled, Export the Grease Pencil strokes fill.
+
+Normalize
+   When enabled, Export strokes with constant thickness.
+
+Clip Camera
+   When enabled, and camera view is active export only the strokes clipped from camera view.
+
+Usage
+=====
+
+This format is use for interchanging vector based illustrations between applications and is supported by applications such as Inkscape, 
+Illustrator, Corel Draw, and modern browsers among others.


Property changes on: trunk/blender_docs/manual/addons/import_export/gpencil_svg.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/blender_docs/manual/addons/import_export/index.rst
===================================================================
--- trunk/blender_docs/manual/addons/import_export/index.rst	2021-03-24 16:15:45 UTC (rev 7895)
+++ trunk/blender_docs/manual/addons/import_export/index.rst	2021-03-24 21:08:03 UTC (rev 7896)
@@ -26,6 +26,8 @@
    anim_nuke_chan.rst
    mesh_stl.rst
    curve_svg.rst
+   gpencil_svg.rst
+   gpencil_pdf.rst
    mesh_ply.rst
    mesh_uv_layout.rst
    scene_obj.rst

Modified: trunk/blender_docs/manual/editors/3dview/display/overlays.rst
===================================================================
--- trunk/blender_docs/manual/editors/3dview/display/overlays.rst	2021-03-24 16:15:45 UTC (rev 7895)
+++ trunk/blender_docs/manual/editors/3dview/display/overlays.rst	2021-03-24 21:08:03 UTC (rev 7896)
@@ -326,6 +326,7 @@
 
 Onion Skin
    Show ghosts of the keyframes before and after the current frame.
+   If Multiframe is enabled Keyframes before and after of the active frame are displayed using onion colors.
 Canvas
    Display a grid over Grease Pencil drawing plane.
    The opacity of the grid can be controlled with the slider.

Modified: trunk/blender_docs/manual/grease_pencil/animation/introduction.rst
===================================================================
--- trunk/blender_docs/manual/grease_pencil/animation/introduction.rst	2021-03-24 16:15:45 UTC (rev 7895)
+++ trunk/blender_docs/manual/grease_pencil/animation/introduction.rst	2021-03-24 21:08:03 UTC (rev 7896)
@@ -39,11 +39,16 @@
 
 Traditional animation in Grease Pencil is achieved with the use of
 :doc:`keyframes </animation/keyframes/introduction>`
-that hold the strokes information at a particular frame.
+that hold the strokes information at a particular frame or frame range.
 
-Every time you create a stroke in Grease Pencil object Draw Mode
+With Auto keyframe activated, every time you create a stroke in Grease Pencil object Draw Mode
 a new keyframe is added at the current frame on the active channel.
 
+With Auto keyframe deactivated, you will have to add manually
+a new keyframe or your new strokes will be added on the active keyframe.
+
+See :doc:`Keyframe Editing </animation/keyframes/editing>` for more information.
+
 .. note::
 
    The channels in the Dope Sheet correspond to the active 2D layer of the Grease Pencil object.
@@ -70,7 +75,7 @@
 Draw Mode
 ---------
 
-In Draw Mode there are two option related to the animation workflow that you can use.
+In Draw Mode there are three options related to the animation workflow that you can use.
 
 .. figure:: /images/grease-pencil_animation_introduction_drawing-options.png
 
@@ -98,7 +103,7 @@
 Edit Mode
 ---------
 
-In Edit Mode there are two option related to the animation workflow that you can use.
+In Edit Mode there is an option related to the animation workflow that you can use.
 
 .. figure:: /images/grease-pencil_animation_introduction_edit-options.png
 
@@ -123,7 +128,7 @@
 
 First, go to menu :menuselection:`File --> New --> 2D Animation` to start with a new 2D animation template.
 The template is ready to quick start your animation with a Grease Pencil object already created,
-onion skinning activated and in camera view.
+onion skinning activated, Auto keyframe enabled and in camera view.
 
 #. Set the range of the animation in the Timeline from 1 to 24.
 #. In the 3D Viewport draw a ball on the upper left corner with the Draw Tool (extreme).

Modified: trunk/blender_docs/manual/grease_pencil/modes/draw/tools/cutter.rst
===================================================================
--- trunk/blender_docs/manual/grease_pencil/modes/draw/tools/cutter.rst	2021-03-24 16:15:45 UTC (rev 7895)
+++ trunk/blender_docs/manual/grease_pencil/modes/draw/tools/cutter.rst	2021-03-24 21:08:03 UTC (rev 7896)
@@ -19,6 +19,8 @@
 Flat Caps
    Mark newly created :ref:`End Caps <bpy.ops.gpencil.stroke_caps_set>` as *Flat*.
 
+Threshold
+   Determine the threshold for stroke intersections.
 
 Usage
 =====

Modified: trunk/blender_docs/manual/grease_pencil/modes/draw/tools/fill.rst
===================================================================
--- trunk/blender_docs/manual/grease_pencil/modes/draw/tools/fill.rst	2021-03-24 16:15:45 UTC (rev 7895)
+++ trunk/blender_docs/manual/grease_pencil/modes/draw/tools/fill.rst	2021-03-24 21:08:03 UTC (rev 7896)
@@ -28,6 +28,12 @@
    Inverted
       Fills the area outside the shape under the cursor.
 
+.. _bpy.types.BrushGpencilSettings.fill_factor:
+
+Precision
+   Multiplier for fill boundary accuracy.
+   Higher values are more accurate but slower.
+
 .. _bpy.types.BrushGpencilSettings.fill_leak:
 
 Leak Size
@@ -36,13 +42,7 @@
 Thickness
    The thickness radius of the boundary stroke in pixels.
 
-.. _bpy.types.BrushGpencilSettings.fill_simplify_level:
 
-Simplify
-   Number of simplify steps to apply to the boundary line.
-   Higher values reduce the accuracy of the final filled area.
-
-
 Advanced
 --------
 
@@ -72,12 +72,18 @@
    :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.fill_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.
 
-Precision
-   Multiplier for fill boundary accuracy.
-   Higher values are more accurate but slower.
+   Show Extend Lines (grid icon)
+      Toggle show extended lines helper.
 
+.. _bpy.types.BrushGpencilSettings.fill_simplify_level:
+
+Simplify
+   Number of simplify steps to apply to the boundary line. Higher values reduce the accuracy of the final filled area.
+
 .. _bpy.types.BrushGpencilSettings.show_fill:
 .. _bpy.types.BrushGpencilSettings.fill_threshold:
 
@@ -86,6 +92,8 @@
 
    The value slider controls the threshold to consider a material transparent.
 
+Limit to Viewport
+   When enabled, fill only visible areas in the viewport.
 
 Usage
 =====
@@ -149,7 +157,33 @@
 When you are satisfied with the fill result you can delete the Boundary strokes using
 the *Clean Up* tool in the :doc:`Grease Pencil Menu </grease_pencil/modes/edit/grease_pencil_menu>` in Edit Mode.
 
+Stroke Extension
+-----------------
 
+A more automatic way to close gaps in an area that you want fill is using temporarily extended lines.
+*Stroke Extension* are temporary extended help lines for closing open shapes.

@@ Diff output truncated at 10240 characters. @@


More information about the Bf-docboard-svn mailing list