[Bf-docboard-svn] bf-manual: [9724] trunk/blender_docs/manual: Merge branch 'blender-3.4-release'
Aaron Carlisle
noreply at blender.org
Sun Nov 27 22:08:33 CET 2022
Revision: 9724
https://developer.blender.org/rBM9724
Author: Blendify
Date: 2022-11-27 22:08:33 +0100 (Sun, 27 Nov 2022)
Log Message:
-----------
Merge branch 'blender-3.4-release'
Modified Paths:
--------------
trunk/blender_docs/manual/files/media/video_formats.rst
trunk/blender_docs/manual/modeling/geometry_nodes/curve/sample_curve.rst
trunk/blender_docs/manual/modeling/meshes/editing/mesh/index.rst
trunk/blender_docs/manual/modeling/meshes/tools/index.rst
trunk/blender_docs/manual/render/cycles/object_settings/cameras.rst
Added Paths:
-----------
trunk/blender_docs/manual/images/node-types_GeometryNodeSampleCurve.png
trunk/blender_docs/manual/modeling/meshes/editing/mesh/knife_topology_tool.rst
Removed Paths:
-------------
trunk/blender_docs/manual/images/node-types_GeometryNodeSampleCurve.webp
trunk/blender_docs/manual/modeling/meshes/tools/knife.rst
Property Changed:
----------------
trunk/blender_docs/
Index: trunk/blender_docs
===================================================================
--- trunk/blender_docs 2022-11-27 21:00:47 UTC (rev 9723)
+++ trunk/blender_docs 2022-11-27 21:08:33 UTC (rev 9724)
Property changes on: trunk/blender_docs
___________________________________________________________________
Modified: svn:mergeinfo
## -4,5 +4,5 ##
/branches/blender-3.1-release/blender_docs:8904-9230
/branches/blender-3.2-release/blender_docs:9236-9417
/branches/blender-3.3-release/blender_docs:9438-9611
-/branches/blender-3.4-release/blender_docs:9673-9715
+/branches/blender-3.4-release/blender_docs:9673-9723
/trunk/blender_docs:9673-9675
\ No newline at end of property
Modified: trunk/blender_docs/manual/files/media/video_formats.rst
===================================================================
--- trunk/blender_docs/manual/files/media/video_formats.rst 2022-11-27 21:00:47 UTC (rev 9723)
+++ trunk/blender_docs/manual/files/media/video_formats.rst 2022-11-27 21:08:33 UTC (rev 9724)
@@ -138,9 +138,13 @@
Original format of QuickTime videos. Supports an alpha channel.
`Theora <https://en.wikipedia.org/wiki/Theora>`__
A free open-standard lossy codec designed together with the :ref:`Ogg container <files-video-containers>`.
-`WEBM / VP9 <https://en.wikipedia.org/wiki/VP9>`__:
+`WEBM / VP9 <https://en.wikipedia.org/wiki/VP9>`__
A free open-standard lossy video compression format.
One of the most recent codecs, it is widely used for internet streaming.
+`AV1 <https://en.wikipedia.org/wiki/AV1>`__
+ A free open-standard lossy video compression format, designed as a successor to *VP9*.
+ AV1 offers great compression rates and visual quality,
+ *AV1* produces video files that that are about 30% more space efficient than *VP9*
.. _files-audio-codecs:
Copied: trunk/blender_docs/manual/images/node-types_GeometryNodeSampleCurve.png (from rev 9723, branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSampleCurve.png)
===================================================================
(Binary files differ)
Deleted: trunk/blender_docs/manual/images/node-types_GeometryNodeSampleCurve.webp
===================================================================
(Binary files differ)
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/curve/sample_curve.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/curve/sample_curve.rst 2022-11-27 21:00:47 UTC (rev 9723)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/curve/sample_curve.rst 2022-11-27 21:08:33 UTC (rev 9724)
@@ -5,7 +5,7 @@
Sample Curve Node
*****************
-.. figure:: /images/node-types_GeometryNodeSampleCurve.webp
+.. figure:: /images/node-types_GeometryNodeSampleCurve.png
:align: right
:alt: Sample Curve node.
@@ -24,19 +24,31 @@
Inputs
======
-Curve
+Curves
Standard geometry input with a curve component.
-Factor
+Input
+ A field input to evaluate custom attributes.
+ The evaluation is outputted through the *Value* output.
+
+Factor :guilabel:`Factor mode`
The portion of the total length used to determine the sample position.
-Length
+Length :guilabel:`Length mode`
A length in distance units used to determine how far along the curve to travel before sampling.
+Curve Index
+ An index to only evaluate specific splines, these indices can be specified manually
+ or from the :doc:`/modeling/geometry_nodes/input/input_index`.
+ This input is ignored when the *All Curves* property is enabled.
+
Properties
==========
+Data Type
+ The :ref:`data type <attribute-data-types>` used for the evaluated data.
+
Mode
How to find endpoint positions for the trimmed spline.
The option acts the same as it does in the :doc:`/modeling/geometry_nodes/curve/trim_curve`.
@@ -48,10 +60,16 @@
Find the endpoint positions using a length from the start of each spline.
The input values should be between 0 and the length of the splines.
+All Curves
+ Sample lengths based on the total length of all curves, rather than using a length inside each selected curve.
+
Outputs
=======
+Value
+ The value of the input *Value* at the sample point.
+
Position
The position at the sample along the spline.
Modified: trunk/blender_docs/manual/modeling/meshes/editing/mesh/index.rst
===================================================================
--- trunk/blender_docs/manual/modeling/meshes/editing/mesh/index.rst 2022-11-27 21:00:47 UTC (rev 9723)
+++ trunk/blender_docs/manual/modeling/meshes/editing/mesh/index.rst 2022-11-27 21:08:33 UTC (rev 9724)
@@ -15,6 +15,7 @@
separate.rst
bisect.rst
knife_project.rst
+ knife_topology_tool.rst
convex_hull.rst
symmetrize.rst
snap_symmetry.rst
Copied: trunk/blender_docs/manual/modeling/meshes/editing/mesh/knife_topology_tool.rst (from rev 9723, branches/blender-3.4-release/blender_docs/manual/modeling/meshes/editing/mesh/knife_topology_tool.rst)
===================================================================
--- trunk/blender_docs/manual/modeling/meshes/editing/mesh/knife_topology_tool.rst (rev 0)
+++ trunk/blender_docs/manual/modeling/meshes/editing/mesh/knife_topology_tool.rst 2022-11-27 21:08:33 UTC (rev 9724)
@@ -0,0 +1,193 @@
+.. _bpy.ops.mesh.knife:
+.. _tool-mesh-knife:
+
+*******************
+Knife Topology Tool
+*******************
+
+.. reference::
+
+ :Mode: Edit Mode
+ :Tool: :menuselection:`Toolbar --> Knife`
+ :Menu: :menuselection:`Mesh --> Knife Topology Tool`
+ :Shortcut: :kbd:`K`
+
+The Knife tool can be used to interactively subdivide (cut up)
+geometry by drawing lines or closed loops to create holes.
+
+
+Usage
+=====
+
+When using *Knife*, the cursor changes to an icon of a scalpel
+and the header changes to display options for the tool.
+You can draw connected straight lines by clicking :kbd:`LMB`,
+marked with small green squares. Red squares are already defined cuts.
+Surrounding red squares mean that there is a cut already in that position,
+so no additional vertex will be created (besides the first one).
+
+If multiple objects are selected before entering Edit Mode,
+then knife cuts will affect all of those objects.
+
+.. list-table::
+
+ * - .. figure:: /images/modeling_meshes_tools_knife_line-before.png
+
+ Mesh before knife cut.
+
+ - .. figure:: /images/modeling_meshes_tools_knife_line-active.png
+
+ Knife cut active.
+
+ - .. figure:: /images/modeling_meshes_tools_knife_line-after.png
+
+ After confirming knife cut.
+
+
+Tool Settings
+=============
+
+Occlude Geometry
+ Only cut geometry visible on screen.
+
+Only Selected :kbd:`Shift-K`
+ Only cuts through selected geometry.
+
+X-Ray
+ Show cut points on non-visible geometry too, when *Occlude Geometry* is deactivated.
+
+Measurement
+ Which visible measurements to show.
+
+ Distance, Angle, None, Both
+
+Angle Snapping
+ Whether or not dragged lines should be constrained to particular angles, and if so,
+ which coordinate system the angle is relative to.
+
+ None, Screen, Relative
+
+Angle Snapping Increment
+ When angle snapping is on, the angle will be constrained to a multiple of this angle.
+
+
+Controls
+========
+
+Confirm :kbd:`Spacebar` or :kbd:`Return`
+ Confirms the cut.
+ :kbd:`Return` will leave selected every edge except the new edges created from the cut.
+
+Cancel :kbd:`Esc`
+ Cancels the cut.
+
+Draw a Continuous Line :kbd:`LMB` drag.
+ So you can draw a free-hand line over a surface,
+ points will be created at edge intersections.
+
+Close Loop double-click :kbd:`LMB`
+ This is a quick way to close the loop you are currently cutting.
+
+New Cut :kbd:`RMB`
+ Begins a new cut. This allows you to define multiple distinct cut lines.
+ If multiple cuts have been defined, they are recognized as new snapping points.
+
+ .. list-table::
+
+ * - .. figure:: /images/modeling_meshes_tools_knife_multiple-before.png
+
+ Creating multiple cuts.
+
+ - .. figure:: /images/modeling_meshes_tools_knife_multiple-after.png
+
+ Result of starting new cuts while in the tool.
+
+Midpoint Snap :kbd:`Shift`
+ Hold to snap the cursor to the midpoint of edges,
+ meaning that all cuts will be performed at the exact center of each cut edge.
+
+Ignore Snap :kbd:`Ctrl`
+ Hold to make the tool ignore snapping,
+ unlike the default where mouse cursor snaps to near edges.
+
+Cut Through: :kbd:`C`
+ Allow the Cut tool to cut through to occluded faces, instead of only the visible ones.
+
+Angle Constrain :kbd:`A`
+ Constrains the cut line to certain degree increments.
+ The increment can be specified in the Tool Settings (see above), or can be typed
+ when angle constraining is active.
+ The default angles are in the plane of the screen, but typing :kbd:`A` again
+ makes it relative to the last cut edge.
+ If the last cut edge is ambiguous (because the cut was on a vertex),
+ typing :kbd:`R` cycles through the possible reference edges.
+
+ .. list-table::
+
+ * - .. figure:: /images/modeling_meshes_tools_knife_angle-before.png
+ :width: 320px
+
+ Constraining cut angle.
+
+ - .. figure:: /images/modeling_meshes_tools_knife_angle-after.png
+ :width: 320px
+
+ Result of constraining cut angle.
+
+Axis Constrain :kbd:`X`, :kbd:`Y`, or :kbd:`Z`
+ Constrains the cut line to one of the coordinate system axes.
+ Initially it will be the global axis with the given name,
+ but pressing the same key again switches to the object's local axis system.
+ Additionally, if the scene transformation orientation is set to
+ a custom orientation (e.g. from a face), the constraints will be in that coordinate system.
+
+Visible Measurements :kbd:`S`
+ Shows measurements of the cuts being made: angles with respect to a mesh edge, lengths, or both.
+ Pressing :kbd:`S` repeatedly cycles between what can be shown.
+
+ Only Distance, Only Angles, Both, None
+
+ .. list-table::
+
+ * - .. figure:: /images/modeling_meshes_tools_knife-measurement-distance.png
+ :width: 640px
+
+ Only Distance.
+
+ - .. figure:: /images/modeling_meshes_tools_knife-measurement-angles.png
+ :width: 640px
+
+ Only Angles.
+
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list