[Bf-docboard-svn] bf-manual: [9555] branches/blender-3.3-release/blender_docs/manual: LineArt: Shadow and related functionalities
Aaron Carlisle
noreply at blender.org
Mon Sep 12 06:23:35 CEST 2022
Revision: 9555
https://developer.blender.org/rBM9555
Author: Blendify
Date: 2022-09-12 06:23:34 +0200 (Mon, 12 Sep 2022)
Log Message:
-----------
LineArt: Shadow and related functionalities
rB6dd8ceef2a21f64cbb61a96560c50c162f9dae39
Modified Paths:
--------------
branches/blender-3.3-release/blender_docs/manual/grease_pencil/modifiers/generate/line_art.rst
branches/blender-3.3-release/blender_docs/manual/render/materials/line_art.rst
branches/blender-3.3-release/blender_docs/manual/scene_layout/collections/collections.rst
branches/blender-3.3-release/blender_docs/manual/scene_layout/object/properties/line_art.rst
Modified: branches/blender-3.3-release/blender_docs/manual/grease_pencil/modifiers/generate/line_art.rst
===================================================================
--- branches/blender-3.3-release/blender_docs/manual/grease_pencil/modifiers/generate/line_art.rst 2022-09-12 00:50:07 UTC (rev 9554)
+++ branches/blender-3.3-release/blender_docs/manual/grease_pencil/modifiers/generate/line_art.rst 2022-09-12 04:23:34 UTC (rev 9555)
@@ -63,6 +63,118 @@
The strokes generated by line art are given this Opacity.
+Edge Types
+----------
+
+Line Art can identify different edge types. Selected edge types will be included in the result.
+
+.. _bpy.types.LineartGpencilModifier.shadow_region_filtering:
+
+Illumination Filtering
+ Select feature lines that comes from lit or shaded regions.
+ Will not affect cast shadow and light contour since they are at the border.
+
+ :None: Not filtering any lines based on illumination region.
+ :Illuminated: Only selecting lines from illuminated regions.
+ :Shaded: Only selecting lines from shaded regions.
+ :Illuminated (Enclosed Shapes):
+ Selecting lines from lit regions, and make the combination of contour,
+ light contour and shadow lines into enclosed shapes.
+
+.. rubric:: Create
+
+.. _bpy.types.LineartGpencilModifier.use_contour:
+.. _bpy.types.LineartGpencilModifier.silhouette_filtering:
+.. _bpy.types.LineartGpencilModifier.use_invert_silhouette:
+
+Contour
+ Generate strokes from contour lines.
+ Where the edge becomes the separation line of front/backfacing faces.
+ The silhouette can also be inverted by clicking the invert button.
+
+ :None: Not filtering any lines based on illumination region.
+ :Illuminated: Only selecting lines from illuminated regions.
+ :Shaded: Only selecting lines from shaded regions.
+ :Illuminated (Enclosed Shapes):
+ Selecting lines from lit regions, and make the combination of contour,
+ light contour and shadow lines into enclosed shapes.
+
+.. _bpy.types.LineartGpencilModifier.use_crease:
+
+Crease
+ Generate strokes where the edge angle is small enough.
+
+ .. _bpy.types.LineartGpencilModifier.crease_threshold:
+
+ Crease Threshold
+ Angles smaller than this will be treated as creases.
+ Crease angle priority: object line art crease override > mesh auto smooth angle > line art default crease.
+
+.. _bpy.types.LineartGpencilModifier.use_intersection:
+
+Intersections
+ Generate stokes where lines intersect between faces.
+
+.. _bpy.types.LineartGpencilModifier.use_material:
+
+Material Borders
+ Generate strokes where the edge separates faces with different materials.
+
+.. _bpy.types.LineartGpencilModifier.use_edge_mark:
+
+Edge Marks
+ Generate strokes from freestyle edge marks.
+
+.. _bpy.types.LineartGpencilModifier.use_loose:
+
+Loose
+ Generate strokes for edges that do not form a :term:`Face`.
+
+.. _bpy.types.LineartGpencilModifier.use_light_contour:
+
+Light Contour
+ Generate light/shadow separation lines from a reference
+ :ref:`Light Object <bpy.types.LineartGpencilModifier.light_contour_object>`.
+
+.. _bpy.types.LineartGpencilModifier.use_shadow:
+
+Cast Shadow
+ Project contour lines using a light source object.
+
+.. rubric:: Options
+
+.. _bpy.types.LineartGpencilModifier.use_overlap_edge_type_support:
+
+Allow Overlap
+ Allow an edge to have multiple overlapping types.
+ This will create a separate stroke for each overlapping type.
+
+
+Light Reference
+---------------
+
+.. _bpy.types.LineartGpencilModifier.light_contour_object:
+
+Light Object
+ Use this light object to generate :ref:Light Contour <bpy.types.LineartGpencilModifier.use_light_contour>.
+
+.. _bpy.types.LineartGpencilModifier.shadow_camera_size:
+
+Shadow Camera Size
+ This value represent the "Orthographic Scale" of an ortho camera.
+ If the camera is put at the lamps position with this scale, it will represent the coverage of the shadow "camera".
+
+.. _bpy.types.LineartGpencilModifier.shadow_camera_near:
+
+Near
+ Near clipping distance of shadow camera.
+
+.. _bpy.types.LineartGpencilModifier.shadow_camera_far:
+
+Far
+ Far clipping distance of shadow camera
+
+
Geometry Processing
-------------------
@@ -103,41 +215,6 @@
Note, removing back faces will create edges in different occlusion levels than when disabled.
-Edge Types
-----------
-
-Line Art can identify different edge types. Selected edge types will be included in the result.
-
-Contour
- Where the edge becomes the separation line of front/backfacing faces.
-
-.. _bpy.types.LineartGpencilModifier.use_loose:
-
-Loose
- Generate strokes for edges that do not form a :term:`Face`.
-
-Material Borders
- Where the edge separates faces with different materials.
-
-Edge Marks
- Freestyle edge marks.
-
-Intersections
- Intersection lines between faces.
-
-Crease
- Where the edge angle is small enough. Controlled by *Crease Threshold* property.
-
- Crease Threshold
- Edge angles that are smaller than this value will be treated as crease.
-
-.. _bpy.types.LineartGpencilModifier.use_overlap_edge_type_support:
-
-Allow Overlap
- Allow an edge to have multiple overlapping types.
- This will create a separate stroke for each overlapping type.
-
-
Occlusion
---------
@@ -248,7 +325,7 @@
Loose Edges
Allow floating Edges that do not form a face to be chained together.
- Loose as Contour
+ Loose Edges as Contour
Edges that do not form a face will be classified as contour lines.
Preserve Details
Modified: branches/blender-3.3-release/blender_docs/manual/render/materials/line_art.rst
===================================================================
--- branches/blender-3.3-release/blender_docs/manual/render/materials/line_art.rst 2022-09-12 00:50:07 UTC (rev 9554)
+++ branches/blender-3.3-release/blender_docs/manual/render/materials/line_art.rst 2022-09-12 04:23:34 UTC (rev 9555)
@@ -28,3 +28,12 @@
Levels
Faces with this material will behave as if it has set number of layers in occlusion.
+
+.. _bpy.types.MaterialLineArt.use_intersection_priority_override:
+.. _bpy.types.MaterialLineArt.intersection_priority:
+
+Intersection Priority
+ Assigns an intersection priority value for this material.
+ Note that this priority takes precedent over :ref:`Object <bpy.types.ObjectLineArt.intersection_priority>`
+ or :ref:`Collection <bpy.types.Collection.lineart_intersection_priority>` priority values.
+ The intersection line will be included into the object with the higher intersection priority value.
Modified: branches/blender-3.3-release/blender_docs/manual/scene_layout/collections/collections.rst
===================================================================
--- branches/blender-3.3-release/blender_docs/manual/scene_layout/collections/collections.rst 2022-09-12 00:50:07 UTC (rev 9554)
+++ branches/blender-3.3-release/blender_docs/manual/scene_layout/collections/collections.rst 2022-09-12 04:23:34 UTC (rev 9555)
@@ -89,7 +89,14 @@
Mask
Intersections generated by this collection will have this mask value.
+.. _bpy.types.Collection.use_lineart_intersection_priority:
+.. _bpy.types.Collection.lineart_intersection_priority:
+Intersection Priority
+ Assigns an intersection priority value for this collection.
+ The intersection line will be included into the object with the higher intersection priority value.
+
+
Custom Properties
-----------------
Modified: branches/blender-3.3-release/blender_docs/manual/scene_layout/object/properties/line_art.rst
===================================================================
--- branches/blender-3.3-release/blender_docs/manual/scene_layout/object/properties/line_art.rst 2022-09-12 00:50:07 UTC (rev 9554)
+++ branches/blender-3.3-release/blender_docs/manual/scene_layout/object/properties/line_art.rst 2022-09-12 04:23:34 UTC (rev 9555)
@@ -46,3 +46,10 @@
Crease
Override crease value for the object.
+
+.. _bpy.types.ObjectLineArt.use_intersection_priority_override:
+.. _bpy.types.ObjectLineArt.intersection_priority:
+
+Intersection Priority
+ Assigns an intersection priority value for this object.
+ The intersection line will be included into the object with the higher intersection priority value.
More information about the Bf-docboard-svn
mailing list