[Bf-docboard-svn] bf-manual: [8385] trunk/blender_docs/manual/render/freestyle: UI: Freestyle UI Upgrade
Aaron Carlisle
noreply at blender.org
Wed Sep 15 05:06:17 CEST 2021
Revision: 8385
https://developer.blender.org/rBM8385
Author: Blendify
Date: 2021-09-15 05:06:13 +0200 (Wed, 15 Sep 2021)
Log Message:
-----------
UI: Freestyle UI Upgrade
rB6f52ebba192b8a9c5fc1e211e4968ebb42ea8408
rB94dd30208e3f54ac2a6863b858fdb81dd840feca
Todo: Image updates
Modified Paths:
--------------
trunk/blender_docs/manual/render/freestyle/index.rst
trunk/blender_docs/manual/render/freestyle/introduction.rst
trunk/blender_docs/manual/render/freestyle/material.rst
trunk/blender_docs/manual/render/freestyle/python.rst
trunk/blender_docs/manual/render/freestyle/render.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/alpha.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/color.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/geometry.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/introduction.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/alpha/along_stroke.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/alpha/crease_angle.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/alpha/curvature_3d.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/alpha/distance_from_camera.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/alpha/distance_from_object.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/alpha/material.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/alpha/noise.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/alpha/tangent.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/color/along_stroke.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/color/crease_angle.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/color/curvature_3d.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/color/distance_from_camera.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/color/distance_from_object.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/color/material.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/color/noise.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/color/tangent.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/geometry/2d_offset.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/geometry/2d_transform.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/geometry/blueprint.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/thickness/along_stroke.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/thickness/crease_angle.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/thickness/curvature_3d.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/thickness/distance_from_camera.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/thickness/distance_from_object.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/thickness/material.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/thickness/noise.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/modifiers/thickness/tangent.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/strokes.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/thickness.rst
Added Paths:
-----------
trunk/blender_docs/manual/render/freestyle/view_layer/
trunk/blender_docs/manual/render/freestyle/view_layer/freestyle.rst
trunk/blender_docs/manual/render/freestyle/view_layer/index.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_set.rst
trunk/blender_docs/manual/render/freestyle/view_layer/line_style/
Removed Paths:
-------------
trunk/blender_docs/manual/render/freestyle/parameter_editor/
trunk/blender_docs/manual/render/freestyle/view_layer.rst
Modified: trunk/blender_docs/manual/render/freestyle/index.rst
===================================================================
--- trunk/blender_docs/manual/render/freestyle/index.rst 2021-09-13 21:51:48 UTC (rev 8384)
+++ trunk/blender_docs/manual/render/freestyle/index.rst 2021-09-15 03:06:13 UTC (rev 8385)
@@ -10,15 +10,6 @@
introduction.rst
render.rst
- view_layer.rst
+ view_layer/index.rst
material.rst
-
-
-Control Modes
-=============
-
-.. toctree::
- :maxdepth: 1
-
- parameter_editor/index.rst
python.rst
Modified: trunk/blender_docs/manual/render/freestyle/introduction.rst
===================================================================
--- trunk/blender_docs/manual/render/freestyle/introduction.rst 2021-09-13 21:51:48 UTC (rev 8384)
+++ trunk/blender_docs/manual/render/freestyle/introduction.rst 2021-09-15 03:06:13 UTC (rev 8385)
@@ -8,13 +8,17 @@
Various line styles can be added to produce artistic ("hand drawn", "painted", etc.)
or technical (hard line) looks.
-The two operating modes: :doc:`Python Scripting </render/freestyle/python>` and
-:doc:`Parameter Editor </render/freestyle/parameter_editor/index>` --
-allow a powerful diversity of line styles and results. Line styles such as Japanese big brush, cartoon, blueprint,
-thickness-with-depth are already pre-scripted in Python. The Parameter Editor mode allows intuitive editing of
-features such as dotted lines and easy setup of multiple line types and edge definitions.
+Freestyle can generate a powerful diversity of line styles and results.
+There are currently, two ways to define the way lines look;
+the first uses a series of parameter to create a :doc:`Line Style </render/freestyle/view_layer/line_style/index>`
+This mode allows intuitive editing of features such as dotted lines
+and easy setup of multiple line types and edge definitions.
On top of all of that, with line style modifiers, the sky is the limit!
+The second method of generating lines is by using :doc:`Python Scripting </render/freestyle/python>`.
+This method is much more advanced but Blender includes many pre-scripted syles
+such as Japanese big brush, cartoon, blueprint, and thickness-with-depth.
+
.. list-table::
* - .. figure:: /images/render_freestyle_introduction_example-1.png
Modified: trunk/blender_docs/manual/render/freestyle/material.rst
===================================================================
--- trunk/blender_docs/manual/render/freestyle/material.rst 2021-09-13 21:51:48 UTC (rev 8384)
+++ trunk/blender_docs/manual/render/freestyle/material.rst 2021-09-15 03:06:13 UTC (rev 8385)
@@ -9,6 +9,7 @@
Line Color
Specifies the line colors on a per-material basis.
+
Priority
Specify the ordering of competing line colors at material boundaries.
Modified: trunk/blender_docs/manual/render/freestyle/python.rst
===================================================================
--- trunk/blender_docs/manual/render/freestyle/python.rst 2021-09-13 21:51:48 UTC (rev 8384)
+++ trunk/blender_docs/manual/render/freestyle/python.rst 2021-09-15 03:06:13 UTC (rev 8385)
@@ -1,8 +1,8 @@
.. _bpy.types.FreestyleModuleSettings:
-*********************
-Python Scripting Mode
-*********************
+****************
+Python Scripting
+****************
The Python Scripting mode offers full programmable line stylizes.
In this control mode, all styling operations are written as Python scripts referred to as
Modified: trunk/blender_docs/manual/render/freestyle/render.rst
===================================================================
--- trunk/blender_docs/manual/render/freestyle/render.rst 2021-09-13 21:51:48 UTC (rev 8384)
+++ trunk/blender_docs/manual/render/freestyle/render.rst 2021-09-15 03:06:13 UTC (rev 8385)
@@ -18,9 +18,9 @@
Line Thickness Mode
There are two different modes for defining the base line thickness:
- Absolute
+ :Absolute:
The line thickness is given by a user-specified number of pixels.
- Relative
+ :Relative:
The unit line thickness is scaled by the proportion of the present vertical image resolution to 480 pixels.
For instance, the "unit line thickness" is 1.0 when the image height set to 480px, 1.5 with 720px
and 2.0 with 960px.
Copied: trunk/blender_docs/manual/render/freestyle/view_layer/freestyle.rst (from rev 8384, trunk/blender_docs/manual/render/freestyle/view_layer.rst)
===================================================================
--- trunk/blender_docs/manual/render/freestyle/view_layer/freestyle.rst (rev 0)
+++ trunk/blender_docs/manual/render/freestyle/view_layer/freestyle.rst 2021-09-15 03:06:13 UTC (rev 8385)
@@ -0,0 +1,80 @@
+.. _bpy.types.ViewLayer.use_freestyle:
+.. _bpy.types.FreestyleSettings:
+
+*********
+Freestyle
+*********
+
+.. reference::
+
+ :Panel: :menuselection:`Properties --> View Layer --> Freestyle`
+
+There is only one view map per view layer. It controls the edge detection parameters.
+Freestyle can be enabled/disabled per View Layer by toggling the checkbox in the panel header.
+
+.. figure:: /images/render_freestyle_view-layer_freestyle-panel.png
+ :align: center
+ :width: 50%
+
+ View Layer: Freestyle panel.
+
+Control Mode
+ Which detected edges are actually rendered, and how, can be controlled either through:
+
+ :Parameter Editor Mode:
+ Lines are rendered via parameters defined in a user-friendly interface
+ to define and control Line Sets and line styles.
+
+ A view map (hence a view layer) can have multiple Line Sets,
+ and each line set is linked to one line style.
+ :Python Scripting Mode:
+ Lines are rendered via :doc:`Python scripting </render/freestyle/python>`, powerful but complex.
+
+View Map Cache
+ An option to reuse a previously computed view map for subsequent rendering.
+ The cache is automatically updated when the mesh geometry of the input 3D scene has been changed.
+
+ This functionality offers a major performance boost for Freestyle animation rendering
+ when the camera-space mesh geometry is static, as well as for repeated still renders
+ with updates of line stylization options.
+
+ Although the ''View map cache'' checkbox is a view layer option,
+ the cache memory is shared by all view layers and scenes.
+ This means that if Freestyle is used for two or more view layers
+ (possibly in different scenes through the Compositor),
+ then the cached view map for one view layer is replaced by a new view map
+ for another view layer and hence no performance gain is expected.
+
+As Render Pass
+ Freestyle lines will not immediately be visible on top of the render image.
+ Instead, Freestyle lines are rendered as a :doc:`Render Pass </render/layers/passes>`
+ which can be composited with the rendered image with an Alpha Over node.
+
+
+Edge Detection
+==============
+
+Crease Angle
+ If two adjacent faces form an angle less than the defined *Crease Angle*,
+ the edge between them will be rendered when using *Crease* edge type selection in a line set.
+ The value also affects *Silhouette* edge type selection.
+
+Culling
+ Ignore the edges that are out of view.
+ (Saves some processing time and memory, but may reduce the quality of the result in some cases.)
+
+Face Smoothness
+ Takes *Smooth Shading* into account for edges calculation.
+
+Sphere Radius
+ Affects the calculation of curvatures for *Ridge*, *Valley*
+ and *Suggestive Contour* edge type selection in a line set.
+ The curvature at each vertex is computed by averaging the shape
+ of the surface within the specified radius.
+ Increasing the value reduces noise and detail.
+
+Kr Derivative Epsilon
+ Controls the threshold on the minimum rate of change of curvature used to filter the output
+ of the *Suggestive Contour* edge type selection. Increasing the value reduces the amount of
+ rendered lines, starting from smoother areas of the object (further information in
+ `this pdf <https://wiki.blender.org/wiki/File:Manual-2.6-Render-Freestyle-PrincetownLinestyle.pdf>`__).
Added: trunk/blender_docs/manual/render/freestyle/view_layer/index.rst
===================================================================
--- trunk/blender_docs/manual/render/freestyle/view_layer/index.rst (rev 0)
+++ trunk/blender_docs/manual/render/freestyle/view_layer/index.rst 2021-09-15 03:06:13 UTC (rev 8385)
@@ -0,0 +1,11 @@
+
+#########################
+ View Layer Properties
+#########################
+
+.. toctree::
+ :maxdepth: 2
+
+ freestyle.rst
+ line_set.rst
+ line_style/index.rst
Property changes on: trunk/blender_docs/manual/render/freestyle/view_layer/index.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Copied: trunk/blender_docs/manual/render/freestyle/view_layer/line_set.rst (from rev 8384, trunk/blender_docs/manual/render/freestyle/parameter_editor/line_set.rst)
===================================================================
--- trunk/blender_docs/manual/render/freestyle/view_layer/line_set.rst (rev 0)
+++ trunk/blender_docs/manual/render/freestyle/view_layer/line_set.rst 2021-09-15 03:06:13 UTC (rev 8385)
@@ -0,0 +1,235 @@
+.. _bpy.types.Linesets:
+.. _bpy.types.FreestyleLineSet:
+
+********
+Line Set
+********
+
+.. reference::
+
+ :Panel: :menuselection:`Properties --> View Layer --> Freestyle Line Set`
+
+A line set selects, among the lines (edges) detected by Freestyle,
+which ones will be rendered using its attached
+:doc:`line style </render/freestyle/view_layer/line_style/introduction>`, through various methods.
+
+.. figure:: /images/render_freestyle_parameter-editor_line-set_panel.png
+
+ Freestyle Line Set panel.
+
+
+Select By
+ Image Border
+ Causes Freestyle to only take geometry within the image border into consideration for line calculation.
+ This reduces render times but increases continuity problems when geometry is moved out of and
+ into camera view.
+
+
+Visibility
+==========
+
+Type
+ Determine how to use visibility for feature edge selection.
+
+ :Visible:
+ Only lines occluded by no surfaces are rendered.
+ :Hidden:
+ Lines occluded by at least one surface are rendered.
+
+ .. figure:: /images/render_freestyle_parameter-editor_line-set_visibility-hidden-edges.png
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list