[Bf-docboard-svn] bf-manual: [9052] branches/blender-3.1-release/blender_docs/manual: Add Precision Drawing Tools from trunk branch
Aaron Carlisle
noreply at blender.org
Mon Feb 28 18:44:39 CET 2022
Revision: 9052
https://developer.blender.org/rBM9052
Author: Blendify
Date: 2022-02-28 18:44:38 +0100 (Mon, 28 Feb 2022)
Log Message:
-----------
Add Precision Drawing Tools from trunk branch
Modified Paths:
--------------
branches/blender-3.1-release/blender_docs/manual/addons/3d_view/index.rst
Added Paths:
-----------
branches/blender-3.1-release/blender_docs/manual/addons/3d_view/precision_drawing_tools/
branches/blender-3.1-release/blender_docs/manual/addons/3d_view/precision_drawing_tools/begin.rst
branches/blender-3.1-release/blender_docs/manual/addons/3d_view/precision_drawing_tools/book_scanner.rst
branches/blender-3.1-release/blender_docs/manual/addons/3d_view/precision_drawing_tools/command.rst
branches/blender-3.1-release/blender_docs/manual/addons/3d_view/precision_drawing_tools/design_tools.rst
branches/blender-3.1-release/blender_docs/manual/addons/3d_view/precision_drawing_tools/download.rst
branches/blender-3.1-release/blender_docs/manual/addons/3d_view/precision_drawing_tools/examples.rst
branches/blender-3.1-release/blender_docs/manual/addons/3d_view/precision_drawing_tools/holes_in_faces.rst
branches/blender-3.1-release/blender_docs/manual/addons/3d_view/precision_drawing_tools/index.rst
branches/blender-3.1-release/blender_docs/manual/addons/3d_view/precision_drawing_tools/introduction.rst
branches/blender-3.1-release/blender_docs/manual/addons/3d_view/precision_drawing_tools/library.rst
branches/blender-3.1-release/blender_docs/manual/addons/3d_view/precision_drawing_tools/operations.rst
branches/blender-3.1-release/blender_docs/manual/addons/3d_view/precision_drawing_tools/pivot_point.rst
branches/blender-3.1-release/blender_docs/manual/addons/3d_view/precision_drawing_tools/trig_waves.rst
branches/blender-3.1-release/blender_docs/manual/addons/3d_view/precision_drawing_tools/view_control.rst
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_command_1.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_command_2.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_command_3.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_command_4.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_command_5.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_command_6.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_command_7.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_design_10.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_design_11.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_design_12.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_design_13.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_design_14.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_design_15.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_design_16.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_design_17.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_design_18.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_design_19.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_design_20.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_design_21.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_design_22.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_design_23.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_design_24.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_design_25.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_design_7.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_design_8.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_design_9.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_examples_1.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_examples_2.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_examples_3.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_examples_4.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_examples_5.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_examples_6.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_examples_7.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_examples_8.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_examples_9.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_holes_1.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_holes_2.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_holes_3.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_holes_4.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_install.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_library_1.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_library_2.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_library_3.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_library_4.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_main.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_msg_edit.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_op_1.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_op_2.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_op_3.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_pivot_1.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_pivot_2.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_pivot_3.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_pivot_4.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_pivot_5.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_scan_1.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_scan_10.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_scan_11.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_scan_12.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_scan_13.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_scan_14.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_scan_2.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_scan_3.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_scan_4.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_scan_5.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_scan_6.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_scan_7.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_scan_8.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_scan_9.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_setup_1.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_setup_2.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_setup_3.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_setup_4.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_trig_1.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_trig_2.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_trig_3.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_trig_4.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_trig_5.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_ui_menu.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_view_1.png
branches/blender-3.1-release/blender_docs/manual/images/addons_pdt_view_2.png
Modified: branches/blender-3.1-release/blender_docs/manual/addons/3d_view/index.rst
===================================================================
--- branches/blender-3.1-release/blender_docs/manual/addons/3d_view/index.rst 2022-02-28 09:49:09 UTC (rev 9051)
+++ branches/blender-3.1-release/blender_docs/manual/addons/3d_view/index.rst 2022-02-28 17:44:38 UTC (rev 9052)
@@ -11,5 +11,6 @@
3d_navigation.rst
math_vis_console.rst
measureit.rst
+ precision_drawing_tools/index.rst
stored_views.rst
vr_scene_inspection.rst
Added: branches/blender-3.1-release/blender_docs/manual/addons/3d_view/precision_drawing_tools/begin.rst
===================================================================
--- branches/blender-3.1-release/blender_docs/manual/addons/3d_view/precision_drawing_tools/begin.rst (rev 0)
+++ branches/blender-3.1-release/blender_docs/manual/addons/3d_view/precision_drawing_tools/begin.rst 2022-02-28 17:44:38 UTC (rev 9052)
@@ -0,0 +1,135 @@
+
+****************
+Before You Begin
+****************
+
+There are a number of principles to be aware of before you begin working with PDT:
+
+.. _latest-menus: https://github.com/Clockmender/Precision-Drawing-Tools/wiki/98-PDT-Latest-Release-Menus
+
+Be sure to check out `Latest Release Menus <latest-menus>`__ to see current layouts.
+
+#. PDT is split into several sections and this list will grow as the add-on develops.
+#. PDT has a concept of a ``Working Plane`` that applies in all Operations,
+ i.e. those defined in the Design section and some in the Pivot Point section.
+#. PDT has been designed to work as far as possible in Edit and
+ Object modes with many commands equally applicable to both.
+#. Certain Operations relating to ``Cursor Placement`` and ``Pivot Point Placement``
+ have been set to work in either Selected, or Relative Modes, these will be explained later.
+#. PDT can be driven from its own Command Line input for **most** operations.
+
+The first thing to establish is the ``Working Plane``, here a number of choices are available:
+
+#. ``Front(X-Z)`` - Uses Global X and Z axes, if you want to work from the Back view,
+ the working plane is also this as the axes remain the same.
+#. ``Top(X-Y)`` - Uses Global X and Y axes, if you want to work from the Bottom view,
+ the working plane is also this as the axes remain the same.
+#. ``Right(Y-Z)`` - Uses Global Y and Z axes, if you want to work from the Left view,
+ the working plane is also this as the axes remain the same.
+#. ``View`` - This uses axes relative to your screen, no matter how the 3D View is rotated,
+ X is always view-horizontal, Y is always view-vertical and Z is always view-depth.
+
+.. figure:: /images/addons_pdt_setup_1.png
+ :align: left
+ :width: 300px
+
+.. container:: lead
+
+ .. clear
+
+
+Setting the Working Plane.
+==========================
+
+Whatever your ``View`` is set to other than **View**,
+it does not matter how the view is oriented, inputs are always along global axes.
+
+The second thing is whether you want Cursor, or Pivot Point locations to be based upon ``Selected``,
+or ``Current`` values. Set ``Selected`` if you want the Cursor to be placed relative to selected geometry,
+or ``Current`` if you want it to be placed relative to its current location.
+For example, moving the cursor in ``Current`` mode by a ``Delta``
+input of 1,3,2 will move the cursor relative to itself,
+so it moves this amount every time you activate the command.
+
+.. figure:: /images/addons_pdt_setup_2.png
+ :align: left
+ :width: 300px
+
+.. container:: lead
+
+ .. clear
+
+
+Setting the Cursor/Pivot Point Movement Mode.
+=============================================
+
+Then you can set the type of Operation you want to undertake,
+these will be discussed on another page. There are a number of Operations, shown below:
+
+1) Cursor.
+2) Pivot Point.
+3) Move.
+4) New Vertex.
+5) Extrude Vertices.
+6) Split Edges.
+7) Duplicate Geometry.
+8) Extrude Geometry.
+
+.. figure:: /images/addons_pdt_setup_3.png
+ :align: left
+ :width: 300px
+
+.. container:: lead
+
+ .. clear
+
+
+Setting the Operation Mode.
+===========================
+
+Setting the `Operation` mode determines what the buttons below this command actually do,
+so for example to **move** the ``Cursor`` to ``Absolute`` location, you would select ``Cursor`` operation,
+set the input values for **X, Y & Z** then click the ``Absolute`` button.
+
+Below is a table showing which options are available in which Modes, including Edit, or Object Modes in Blender:
+
+.. figure:: /images/addons_pdt_setup_4.png
+ :align: left
+ :width: 720px
+
+.. container:: lead
+
+ .. clear
+
+Note! Only Edit and Object Modes are supported by PDT at present,
+Further, only Mesh Objects are supported, not Curves for now.
+
+Note! From Version 1.1.8, Menu widths will affect how the menus are arranged,
+with less items per row as the width decreases below a threshold set in the PDT Add-on's Preferences.
+Here are two sample Images:
+
+.. figure:: /images/addons_pdt_op_1.png
+ :align: left
+ :width: 250px
+
+.. container:: lead
+
+ .. clear
+
+.. figure:: /images/addons_pdt_op_2.png
+ :align: left
+ :width: 300px
+
+.. container:: lead
+
+ .. clear
+
+Note! PDT Add-on Preferences now also sets the Parts Library location and Debug mode.
+
+.. figure:: /images/addons_pdt_op_3.png
+ :align: left
+ :width: 420px
+
+.. container:: lead
+
+ .. clear
Property changes on: branches/blender-3.1-release/blender_docs/manual/addons/3d_view/precision_drawing_tools/begin.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: branches/blender-3.1-release/blender_docs/manual/addons/3d_view/precision_drawing_tools/book_scanner.rst
===================================================================
--- branches/blender-3.1-release/blender_docs/manual/addons/3d_view/precision_drawing_tools/book_scanner.rst (rev 0)
+++ branches/blender-3.1-release/blender_docs/manual/addons/3d_view/precision_drawing_tools/book_scanner.rst 2022-02-28 17:44:38 UTC (rev 9052)
@@ -0,0 +1,256 @@
+
+****************************************
+Worked Example - Building A Book Scanner
+****************************************
+
+In this page we will show how to make complex parts of this book scanner using PDT.
+
+.. figure:: /images/addons_pdt_scan_1.png
+ :align: left
+ :width: 450px
+
+.. container:: lead
+
+ .. clear
+
+This is considered a typical CAD design and consists of many parts
+that can be made by extruding a profile to make the 3D mesh.
+It should be noted that this is a preferred manner to work in the CAD environment,
+rather than starting with a 3D mesh and carving bits out of it.
+We will start with a component that has a hole in it so that process is explained properly.
+
+**Making the End Panels.**
+
+.. figure:: /images/addons_pdt_scan_2.png
+ :align: left
+ :width: 450px
+
+.. container:: lead
+
+ .. clear
+
+The End Panel in Edit Mode
+
+For this we will start with a single vertex object at 0,0,0 (You will need to load the "Extra Objects" Add-on).
+
+I placed all objects, apart from the wheels at the World Centre for ease,
+so the start point for this component is 0.39,-0.32,-0.3.
+The first thing to do therefore is move this single vertex in Edit mode to that location.
+For this there are two choices:
+
++ Set Cartesian Coordinates to 0.39,-0.32,-0.3 respectively, set operation to ``Move`` and click ``Delta``.
++ **OR** Key gd0.39,-0.32,-0.3 into Command Line.
+
+Now we need to extrude this vertex 0.64 in Y:
+
++ Set Cartesian Coordinates to 0,0.64,0 respectively, set operation to ``Extrude Vertices`` and click ``Delta``.
++ **OR** Key vd,0.64, into Command Line.
+
+Select both vertices and extrude 0.7 in Z:
+
++ Set Cartesian Coordinates to 0,0,0.7 respectively, set operation to **Extrude Vertices** and click ``Delta``.
++ **OR** Key vd,,0.7 into Command Line.
+
+Copy leftmost of the new vertices 0,0.65,0.14:
+
++ Set Cartesian Coordinates to 0,0.65,0.14 respectively, set operation to ``Duplicate Geometry`` and click ``Delta``.
++ **OR** Key dd,0.65,0.14 into Command Line.
+
+Extrude new vertex -0.04 in Z:
+
++ Set Cartesian Coordinates to 0,0,-0.04 respectively, set operation to ``Extrude Vertices`` and click ``Delta``.
++ **OR** Key vd,,0.04 into Command Line.
+
+You should now have this:
+
+.. figure:: /images/addons_pdt_scan_3.png
+ :align: left
+ :width: 450px
+
+.. container:: lead
+
+ .. clear
+
+I have selected two vertices, join these two together with **Join 2 Verts** Tool.
+
+Select Top Left vertex and extrude it 0.02 in Y:
+
++ Set Cartesian Coordinates to 0,0.02,0 respectively, set operation to ``Extrude Vertices`` and click ``Delta``.
++ **OR** Key vd,0.02, into Command Line.
+
+Extrude 0.16 in Z:
+
++ Set Cartesian Coordinates to 0,0,0.16 respectively, set operation to ``Extrude Vertices`` and click ``Delta``.
++ **OR** Key vd,,0.16 into Command Line.
+
+You should now have this:
+
+.. figure:: /images/addons_pdt_scan_4.png
+ :align: left
+ :width: 450px
+
+.. container:: lead
+
+ .. clear
+
+Duplicate the selected vertices to the other side:
+
+Set 3D Cursor, SHIFT+D, CTRL+M Y - standard Blender commands.
+
+Join the gaps using ``Join 2 Verts`` and you get this:
+
+.. figure:: /images/addons_pdt_scan_5.png
+ :align: left
+ :width: 450px
+
+.. container:: lead
+
+ .. clear
+
+Select the vertices shown, they need filleting:
+
++ Set ``Radius`` to 0.03, ``Profile`` to 0.5 and ``Segments`` to 6, click ``Fillet``.
++ **OR** Key fv0.03,6,0.5 into Command Line.
+
+This is the result:
+
+.. figure:: /images/addons_pdt_scan_6.png
+ :align: left
+ :width: 450px
+
+.. container:: lead
+
+ .. clear
+
+Copy bottom left vertex 0.12 in Y & 0.1 in Z:
+
++ Set Cartesian Coordinates to 0,0.12,0.1 respectively, set operation to ``Duplicate Geometry`` and click ``Delta``.
++ **OR** Key dd,0.12,0.1 into Command Line.
+
+Extrude 0.45 in Z:
+
++ Set Cartesian Coordinates to 0,0,0.45 respectively, set operation to ``Extrude Geometry`` and click ``Delta``.
++ **OR** Key vd,,0.45 into Command Line.
+
+Extrude 0.15 in Y, 0.31 in Z:
+
++ Set Cartesian Coordinates to 0,015,0.31 respectively, set operation to ``Extrude Geometry`` and click ``Delta``.
++ **OR** Key vd,0.15,0.31 into Command Line.
+
+Duplicate these new vertices to the other side:
+
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list