[Bf-docboard-svn] bf-manual: [8997] branches/blender-3.1-release/blender_docs/manual: GPencil: New Shrinkwrap modifier
Aaron Carlisle
noreply at blender.org
Wed Feb 23 19:55:13 CET 2022
Revision: 8997
https://developer.blender.org/rBM8997
Author: Blendify
Date: 2022-02-23 19:55:13 +0100 (Wed, 23 Feb 2022)
Log Message:
-----------
GPencil: New Shrinkwrap modifier
rB459af75d1ed586f08cd43e2aec7a3b270e809132
Modified Paths:
--------------
branches/blender-3.1-release/blender_docs/manual/grease_pencil/modifiers/deform/index.rst
Added Paths:
-----------
branches/blender-3.1-release/blender_docs/manual/grease_pencil/modifiers/deform/shrinkwrap.rst
branches/blender-3.1-release/blender_docs/manual/images/grease-pencil_modifiers_deform_shrinkwrap_nearest-surface-point.png
branches/blender-3.1-release/blender_docs/manual/images/grease-pencil_modifiers_deform_shrinkwrap_project.png
Modified: branches/blender-3.1-release/blender_docs/manual/grease_pencil/modifiers/deform/index.rst
===================================================================
--- branches/blender-3.1-release/blender_docs/manual/grease_pencil/modifiers/deform/index.rst 2022-02-22 10:51:14 UTC (rev 8996)
+++ branches/blender-3.1-release/blender_docs/manual/grease_pencil/modifiers/deform/index.rst 2022-02-23 18:55:13 UTC (rev 8997)
@@ -11,5 +11,6 @@
lattice.rst
noise.rst
offset.rst
+ shrinkwrap.rst
smooth.rst
thickness.rst
Added: branches/blender-3.1-release/blender_docs/manual/grease_pencil/modifiers/deform/shrinkwrap.rst
===================================================================
--- branches/blender-3.1-release/blender_docs/manual/grease_pencil/modifiers/deform/shrinkwrap.rst (rev 0)
+++ branches/blender-3.1-release/blender_docs/manual/grease_pencil/modifiers/deform/shrinkwrap.rst 2022-02-23 18:55:13 UTC (rev 8997)
@@ -0,0 +1,156 @@
+.. index:: Grease Pencil Modifiers; Shrinkwrap Modifier
+.. _bpy.types.ShrinkwrapGpencilModifier:
+
+*******************
+Shrinkwrap Modifier
+*******************
+
+The *Shrinkwrap* modifier allows a Grease Pencil object to "shrink" to the surface of another object.
+It moves each point of the object being modified to the closest position on the surface of the given mesh.
+
+.. seealso::
+
+ :doc:`Shrinkwrap Constraint </animation/constraints/relationship/shrinkwrap>`.
+
+
+Options
+=======
+
+.. figure:: /images/grease-pencil_modifiers_deform_shrinkwrap_nearest-surface-point.png
+ :align: right
+ :width: 300px
+
+ The Shrinkwrap modifier in Nearest Surface Point mode.
+
+Wrap Method
+ This selector specifies the method to be used to determine the nearest
+ point on the target's surface for each point of the modified object.
+ Some options will add some extra, specific controls to the panel.
+ See :ref:`modeling_modifiers_deform_shrinkwrap_methods` for an explanation of each method.
+
+Snap Mode
+ Most modes support an additional setting to control how the point
+ is moved to the target point selected by the methods described above.
+ Some of the choices only differ if *Offset* is not zero.
+
+ :On Surface:
+ The point is always moved. The offset is applied along the projection line
+ connecting the original point and selected target point towards the original position.
+ :Inside:
+ The point is not moved if it is already inside the target.
+ Offset shrinks the allowed volume towards the inside along the projection line.
+ :Outside:
+ The point is not moved if it is already outside the target.
+ Offset expands the exclusion volume towards the outside along the projection line.
+ :Outside Surface:
+ Like *On Surface*, but the offset is always applied towards the outside of the target.
+ :Above Surface:
+ Like *On Surface*, but the offset is applied along the smooth normal of the target.
+
+ .. note::
+
+ The *Inside* and *Outside* options can be used for very crude collision detection.
+ The inside vs outside determination is done based on the target normal and
+ is not always stable near 90 degree and sharper angles in the target mesh.
+
+Target
+ Shrink target, the mesh to shrink to/wrap around.
+
+Offset
+ The distance that must be kept from the calculated target position.
+
+Smooth Factor
+ Amount of smoothing to apply.
+
+Repeat
+ The number of time to apply smoothing.
+
+
+Influence
+---------
+
+See :ref:`grease-pencil-modifier-influence-filters`.
+
+
+.. _modeling_modifiers_deform_shrinkwrap_methods:
+
+Wrap Methods
+============
+
+Nearest Surface Point
+---------------------
+
+This will select the nearest point over the surface of the shrunk target.
+
+
+Project
+-------
+
+.. figure:: /images/grease-pencil_modifiers_deform_shrinkwrap_project.png
+ :align: right
+ :width: 300px
+
+ Project mode.
+
+This will project vertices along a chosen axis until they touch the shrink target.
+Vertices that never touch the shrink target are left in their original position.
+
+Limit
+ This is a distance limit between original point and surface.
+ If the distance is larger than this limit point would not be projected onto the surface.
+
+Subdivision Levels
+ This applies a (temporary) *Catmull-Clark* subdivision to the modified object's geometry,
+ before computing the wrap.
+
+Axis
+ Along which local axis of the modified object the projection is done.
+ These options can be combined with each other, yielding a "median axis" of projection.
+ If none are selected, the normal direction is used.
+
+Negative/Positive
+ This allows you to select the allowed direction(s) of the shrink along the selected axis.
+ If both options are enabled, both ways are evaluated and the closest hit is selected.
+
+Face Cull
+ Allows you to prevent any projection over the "front side"
+ (respectively the "back side") of the target's faces. The "side" of a face is determined
+ by its normal (front being the side "from where" the normal "originates").
+
+Invert Cull
+ If *Cull Faces* is enabled, and *Negative* direction along axis is allowed,
+ this option can be used to invert the *Front* or *Back* cull choice
+ for the *Negative* direction. This is useful when projecting in both directions.
+
+Auxiliary Target
+ An additional object to project over.
+
+
+Nearest Vertex
+--------------
+
+.. figure:: /images/grease-pencil_modifiers_deform_shrinkwrap_nearest-vertex.png
+ :align: right
+ :width: 300px
+
+ Nearest Vertex mode.
+
+This will snap vertices to the nearest vertex of the shrunk target. It adds no extra options.
+
+This method doesn't support the *Snap Mode* setting.
+
+.. container:: lead
+
+ .. clear
+
+
+Target Normal Project
+---------------------
+
+This mode is similar to *Nearest Surface Point*, but produces a much smoother
+projection in return for being significantly slower.
+
+Instead of finding the closest point, it searches for the nearest point
+that has its interpolated smooth normal pointing towards or away from the original point position.
+Non-manifold boundary edges are specially handled as infinitely thin cylinders
+that emit normals in all perpendicular directions. Ignores flat shading and auto smooth settings.
Property changes on: branches/blender-3.1-release/blender_docs/manual/grease_pencil/modifiers/deform/shrinkwrap.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: branches/blender-3.1-release/blender_docs/manual/images/grease-pencil_modifiers_deform_shrinkwrap_nearest-surface-point.png
===================================================================
(Binary files differ)
Index: branches/blender-3.1-release/blender_docs/manual/images/grease-pencil_modifiers_deform_shrinkwrap_nearest-surface-point.png
===================================================================
--- branches/blender-3.1-release/blender_docs/manual/images/grease-pencil_modifiers_deform_shrinkwrap_nearest-surface-point.png 2022-02-22 10:51:14 UTC (rev 8996)
+++ branches/blender-3.1-release/blender_docs/manual/images/grease-pencil_modifiers_deform_shrinkwrap_nearest-surface-point.png 2022-02-23 18:55:13 UTC (rev 8997)
Property changes on: branches/blender-3.1-release/blender_docs/manual/images/grease-pencil_modifiers_deform_shrinkwrap_nearest-surface-point.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Added: branches/blender-3.1-release/blender_docs/manual/images/grease-pencil_modifiers_deform_shrinkwrap_project.png
===================================================================
(Binary files differ)
Index: branches/blender-3.1-release/blender_docs/manual/images/grease-pencil_modifiers_deform_shrinkwrap_project.png
===================================================================
--- branches/blender-3.1-release/blender_docs/manual/images/grease-pencil_modifiers_deform_shrinkwrap_project.png 2022-02-22 10:51:14 UTC (rev 8996)
+++ branches/blender-3.1-release/blender_docs/manual/images/grease-pencil_modifiers_deform_shrinkwrap_project.png 2022-02-23 18:55:13 UTC (rev 8997)
Property changes on: branches/blender-3.1-release/blender_docs/manual/images/grease-pencil_modifiers_deform_shrinkwrap_project.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
More information about the Bf-docboard-svn
mailing list