[Bf-docboard-svn] bf-manual: [9663] trunk/blender_docs/manual: Sculpt/Paint: Add RNA links for brush properties
Aaron Carlisle
noreply at blender.org
Thu Nov 3 02:48:46 CET 2022
Revision: 9663
https://developer.blender.org/rBM9663
Author: Blendify
Date: 2022-11-03 02:48:45 +0100 (Thu, 03 Nov 2022)
Log Message:
-----------
Sculpt/Paint: Add RNA links for brush properties
Also improve the layout of some text
Modified Paths:
--------------
trunk/blender_docs/manual/grease_pencil/modes/draw/tools/draw.rst
trunk/blender_docs/manual/sculpt_paint/brush/brush.rst
trunk/blender_docs/manual/sculpt_paint/brush/cursor.rst
trunk/blender_docs/manual/sculpt_paint/brush/falloff.rst
trunk/blender_docs/manual/sculpt_paint/brush/stroke.rst
trunk/blender_docs/manual/sculpt_paint/brush/texture.rst
trunk/blender_docs/manual/sculpt_paint/brush/texture_mask.rst
Modified: trunk/blender_docs/manual/grease_pencil/modes/draw/tools/draw.rst
===================================================================
--- trunk/blender_docs/manual/grease_pencil/modes/draw/tools/draw.rst 2022-11-02 18:27:43 UTC (rev 9662)
+++ trunk/blender_docs/manual/grease_pencil/modes/draw/tools/draw.rst 2022-11-03 01:48:45 UTC (rev 9663)
@@ -213,13 +213,8 @@
delaying and correcting the location of points.
You can toggle the use of *Stabilize Stroke* using the checkbox in the section panel header.
-.. _bpy.types.Brush.smooth_stroke_radius:
-
Radius
Minimum distance from the last point before the stroke continues.
-
-.. _bpy.types.Brush.smooth_stroke_factor:
-
Factor
A smooth factor, where higher values result in smoother strokes but the drawing sensation
feels like as if you were pulling the stroke.
Modified: trunk/blender_docs/manual/sculpt_paint/brush/brush.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/brush/brush.rst 2022-11-02 18:27:43 UTC (rev 9662)
+++ trunk/blender_docs/manual/sculpt_paint/brush/brush.rst 2022-11-03 01:48:45 UTC (rev 9663)
@@ -1,7 +1,5 @@
.. _bpy.types.Brush:
.. _bpy.ops.brush:
-.. _bpy.types.Brush.use_custom_icon:
-.. _bpy.types.Brush.icon_filepath:
.. _bpy.types.UnifiedPaintSettings:
*******
@@ -28,17 +26,20 @@
Add Brush
When you add a brush, the new brush is a clone of the current one.
- Brush Specials
- Enabled Modes
- Todo.
- Tool Selection
- Todo.
- Reset Brush
- Todo.
+Brush Specials
+ Enabled Modes
+ Todo.
+ Tool Selection
+ Todo.
+ Reset Brush
+ Todo.
- Custom Icon
- Allows definition of a custom brush icon.
+.. _bpy.types.Brush.use_custom_icon:
+.. _bpy.types.Brush.icon_filepath:
+Custom Icon
+ Allows definition of a custom brush icon.
+
.. note::
In order to save a custom brush in a blend-user, enable Fake User.
Modified: trunk/blender_docs/manual/sculpt_paint/brush/cursor.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/brush/cursor.rst 2022-11-02 18:27:43 UTC (rev 9662)
+++ trunk/blender_docs/manual/sculpt_paint/brush/cursor.rst 2022-11-03 01:48:45 UTC (rev 9663)
@@ -1,9 +1,5 @@
.. _sculpt-paint-brush-display:
.. _bpy.types.Paint.show_brush:
-.. _bpy.types.Brush.cursor_overlay_alpha:
-.. _bpy.types.Brush.use_cursor_overlay:
-.. _bpy.types.Brush.texture_overlay_alpha:
-.. _bpy.types.Brush.use_primary_overlay:
******
Cursor
@@ -37,6 +33,11 @@
In some paint/sculpt modes the brush can be negative and subtract information from the paint target;
these brushes can be given a separate color.
+.. _bpy.types.Brush.cursor_overlay_alpha:
+.. _bpy.types.Brush.use_cursor_overlay:
+.. _bpy.types.Brush.texture_overlay_alpha:
+.. _bpy.types.Brush.use_primary_overlay:
+
Opacity Options
Depending on the paint or sculpt mode different overlays are shown within the cursor
to give information on how the brush is textured.
Modified: trunk/blender_docs/manual/sculpt_paint/brush/falloff.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/brush/falloff.rst 2022-11-02 18:27:43 UTC (rev 9662)
+++ trunk/blender_docs/manual/sculpt_paint/brush/falloff.rst 2022-11-03 01:48:45 UTC (rev 9663)
@@ -13,8 +13,11 @@
Brush curve example.
+.. _bpy.ops.brush.curve_preset:
+.. _bpy.types.Brush.curve:
+
Curve Preset
- Custom
+ :Custom:
You can choose how the strength of the falloff is determined from the center of the brush
to the borders by manually manipulating the control points within the curve widget.
There are also a couple of preset custom curves displayed at the bottom of the curve widget
@@ -46,26 +49,26 @@
Constant.
- Smooth
+ :Smooth:
The center strength, the border strength, and the falloff transition between them are evenly distributed.
- Smoother
+ :Smoother:
Similar to *Smooth* but produces a wider center point of the brush before tapering off.
- Sphere
+ :Sphere:
The strength of the brush is predominately at its strongest point
with a steep falloff near the border of the brush.
- Root
+ :Root:
Similar to a Sphere but the center is a more concentrated point.
- Sharp
+ :Sharp:
The center of the brush is the strongest point
then exponentially tapers off to a lower strength, creating a fine point.
- Linear
+ :Linear:
With the center being the strongest,
the strength will consistently weaken as it reaches the border of the brush.
- Sharper
+ :Sharper:
Similar to *Sharp* but the center point is more condensed.
- Inverse Square
+ :Inverse Square:
A hybrid between *Smooth* and *Sphere*.
- Constant
+ :Constant:
The strength of the brush remains unified across the entire brush.
This will create a sharp edge at the border of the brush.
@@ -74,6 +77,8 @@
(From Left to Right) Smooth, Smoother, Sphere, Root,
Sharp, Linear, Sharper, Inverse square, Constant.
+.. _bpy.types.Brush.falloff_shape:
+
Falloff Shape
Use projected or spherical falloff.
Note, this is not supported in Texture Paint Mode.
@@ -85,10 +90,14 @@
It can be used along the outline of a mesh to adjust its silhouette.
+.. _bpy.types.ImagePaint.use_normal_falloff:
+
Normal Falloff
==============
As faces point away from the view the brush strokes fade away to prevent harsh edges.
+.. _bpy.types.ImagePaint.normal_angle:
+
Angle
The angle at which the falloff begins.
Modified: trunk/blender_docs/manual/sculpt_paint/brush/stroke.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/brush/stroke.rst 2022-11-02 18:27:43 UTC (rev 9662)
+++ trunk/blender_docs/manual/sculpt_paint/brush/stroke.rst 2022-11-03 01:48:45 UTC (rev 9663)
@@ -8,110 +8,156 @@
Stroke panel.
+.. _bpy.types.Brush.stroke_method:
+
Stroke Method :kbd:`E`
Defines the way brush strokes are applied to the canvas.
- Dots
+ .. container:: lead
+
+ .. clear
+
+ :Dots:
Apply paint on each mouse move step.
- Drag Dot
+ :Drag Dot:
Leaves only one dab on the canvas which can be placed by dragging.
- Space
+ :Space:
Creates brush stroke as a series of dots,
whose distance (spacing) is determined by the *Spacing* setting.
+ .. _bpy.types.Brush.spacing:
+ .. _bpy.types.Brush.use_pressure_spacing:
+
Spacing
- Represents the percentage of the brush radius.
-
- Limits brush application to the distance specified by spacing.
- Airbrush
+ Limits brush application to the distance specified by the percentage of the brush radius.
+ :Airbrush:
Flow of the brush continues as long as the mouse click is held (spray),
determined by the *Rate* setting.
With other methods the brush only modifies the color when the brush changes its location.
This option is not available for the *Grab* sculpting brush.
+ .. _bpy.types.Brush.rate:
+
Rate
Interval between paints for airbrush.
- Anchored
+ :Anchored:
Creates a single dab at the brush location.
Clicking and dragging will resize the dab diameter.
+ .. _bpy.types.Brush.use_edge_to_edge:
+
Edge to Edge
The brush location and orientation are determined by a two point circle,
where the first click is one point, and dragging places the second point, opposite from the first.
- Line
+ :Line:
Clicking and dragging lets you define a line in screen space.
The line dabs are separated by *Spacing*, similar to space strokes.
With :kbd:`Alt` the line stroke is constrained to 45 degree increments.
- Curve
+ :Curve:
Defines the stroke curve with a Bézier curve (dabs are separated according to *Spacing*).
+ This Bézier curve is stored in Blender as a "Paint Curve" data-block.
+
Use :kbd:`Ctrl-RMB` to create the initial control point of the curve.
Paint Curves
- Stroke Curves are reusable and can be stored and selected by using the :ref:`ui-data-block` menu.
- Add Points
- You can define additional curve control points by using :kbd:`Ctrl-RMB`.
- The handles can be defined by dragging the mouse.
- The stroke flows in the direction of the first control point to the second control point.
- If another control point is added after the second control point,
- instead of extending it from the first control point in a different direction,
- it will become the initial control point,
- and thus the stroke still flows in the direction of the first to the second.
- Transforming Points
- The control points and handles can be dragged with :kbd:`LMB`.
- To make sure that the handles of a control point are symmetrical,
- drag them using :kbd:`Shift-RMB`.
- A few transform operators are supported such as moving, scaling and rotating.
- Selection
- The handles can be selected individually by using :kbd:`RMB`,
- extend the selection by :kbd:`Shift-RMB` and deselect/select all by using :kbd:`A`.
- Delete Points :kbd:`X`
- To delete a curve point, use :kbd:`X`.
+ Paint Curves are reusable and can be stored and selected by using the :ref:`ui-data-block` menu.
+
+ .. _bpy.ops.paintcurve.new:
+
+ - **Add Points:**
+ Use :kbd:`Ctrl-RMB` to create the initial control point of the curve.
+ You can define additional curve control points by using :kbd:`Ctrl-RMB`.
+ The handles can be defined by dragging the mouse.
+ The stroke flows in the direction of the first control point to the second control point.
+ If another control point is added after the second control point,
+ instead of extending it from the first control point in a different direction,
+ it will become the initial control point,
+ and thus the stroke still flows in the direction of the first to the second.
+
+ - **Transforming Points:**
+ The control points and handles can be dragged with :kbd:`LMB`.
+ To make sure that the handles of a control point are symmetrical,
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list