[Bf-extensions-cvs] [0d527ca6] master: Cleanup: Removed usage notes, moved to wiki page

NBurn noreply at git.blender.org
Thu May 25 05:17:55 CEST 2017


Commit: 0d527ca61c58aece2ed5cbc6c7b4d8ce7d13b4c3
Author: NBurn
Date:   Wed May 24 22:19:51 2017 -0400
Branches: master
https://developer.blender.org/rBAC0d527ca61c58aece2ed5cbc6c7b4d8ce7d13b4c3

Cleanup: Removed usage notes, moved to wiki page

===================================================================

M	mesh_xoffsets.py

===================================================================

diff --git a/mesh_xoffsets.py b/mesh_xoffsets.py
index d1ae12a1..223ec396 100644
--- a/mesh_xoffsets.py
+++ b/mesh_xoffsets.py
@@ -17,120 +17,18 @@ Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 
 END GPL LICENSE BLOCK
 
-#############################################################################
+#============================================================================
 
-xoffsets.py (alpha version 005)
-
-Performance Note:
-The Add-On's vertex finding code is still mostly a proof-of-concept without 
-any performance optimizations. During trial runs the Add-On worked fine 
-with basic models, but once vertex counts reached the 10K to 30K range 
-performance took a major hit. Using the Add-On with anything more complex 
-than that might still be possible, but is not recommended.
+mesh_xoffsets.py (alpha version 005)
 
 Install instructions (if downloaded separately from Blender):
-1) Save the xoffsets.py file to your computer.
+1) Save the mesh_xoffsets.py file to your computer.
 2) In Blender, go to File > User Preferences > Add-ons
-3) Press Install From File and select the xoffsets.py file you
+3) Press Install From File and select the mesh_xoffsets.py file you
     just downloaded.
-4) Enable the Add-On by clicking on box to the left of Add-On's name
-
-Basic Usage: 
-Launch the Add-On from the Spacebar menu by typing in: Exact Offsets
-After launching the addon, it will be in "Point Select" mode where you can 
-select 2 or 3 "reference points" using the Left Mouse Button. Points are 
-selected by left clicking on/near the vertices of a mesh model in the 
-3D View. A point will be placed at the vertex closest to the location you 
-clicked (except when there are no vertices near the mouse cursor). The order 
-in which you selected the points determines their function and color:
-
-* 1st point set is the "Anchor" (red)
-* 2nd point set is the "Free" (green)
-* If a 3rd point is set, the 2nd point becomes the "Pivot" (blue) and the 
-   3rd point (last) becomes the "Free" point
-
-Unselecting points:
-If you click on an already "selected" reference point it will become 
-"unselected". For "unselecting" points, the Anchor > Pivot > Free 
-association works in reverse from when you selected points. 
-
-Examples:
-* If 2 points are selected and the Anchor is unselected, the Free point 
-   (being the only point selected) becomes the "new" Anchor.
-* If 3 points are selected and the Pivot is unselected, the Free and Anchor 
-   remain unchanged and the Pivot is removed.
-* If 3 points are selected and the Free is unselected, the Anchor remains
-   unchanged and the Pivot becomes the "new" Free.
-
-Entering a new measurement
-After you select 2 or 3 points, a "button" will appear in the 3D View 
-displaying the distance or rotation value between the selected points. If 
-you click on the button a "Measure Input" dialog box will appear displaying 
-the current measure between the points. If you change the measure in the 
-dialog box and click "OK", a translation (move), scale, or rotation will be
-performed depending on which mode was active.
-
-Available transform modes: 
-Translate, Scale (Object mode only), and Rotation.
-Translate mode is active when only 2 points are selected.
-Scale mode is active if 2 points are selected and attached to same object.
-Rotate mode active when 3 points are selected.
-
-Direction of Movement
-When a new measurement is input with the dialog box, the Free point will 
-move away from or towards the Anchor point to match the updated measurement. 
-If Blender was in Object Mode, the Object the "Free" point was attached to 
-will be moved. If Blender was in Edit Mode, the "Free" point's vertex will 
-be moved. If the Free point was part of a selection set, all other selected 
-vertices (if in Edit Mode) or Mesh Objects (if in Object Mode) will be moved 
-along with the Free point (except when in scale mode).
-
-Translate mode:
-Without an axis lock set, the Free point will move along the slope between 
-the Anchor and Free points. 
-With an axis lock set, Free is moved along set axis.
-
-Rotation mode:
-When an axis lock is set, the Free point will rotate around that axis where 
-it passes through the Pivot point's location. The displayed angle measurement
-(in degrees) represents the smallest angle created starting from the 
-Anchor-Pivot line (at 0 degrees) to the Pivot-Free line. Because the smallest
-angle is used to determine the direction to move the Free point, if the angle 
-measured 0 or 180 degrees before entering a new rotation value, the new 
-location for the Free point will have to be manually selected with the 
-Left Mouse Button. When no axis lock is set, the Free point will rotate 
-around the "face normal" of Anchor-Pivot-Free "face" coming off the Pivot's 
-location. You will not be able to do a rotation without an axis lock set if 
-the original rotation value was 0 or 180 degrees.
-
-Scale mode (Object Mode Only):
-If scale mode is active and no axis lock set, the whole object is scaled up 
-or down so the distance between the Anchor and Free points matches the 
-distance input with the dialog box. If an axis lock was set, the object will 
-scale only along the selected axis. Note that the object is scaled in the 
-direction of the Free point with the Anchor point maintaining its 
-original location.
-
-Notes: 
-* You cannot select more than 1 point in a given 3D location (Points can't 
-   share the same coordinates).
-* If Objects have an unapplied scale or rotation, transforms may not work as
-   intended (scale in particular).
-* Entering negative values will reverse the direction of the transformation.
-   For example, If a Z axis lock was applied, the Free vertex was 2 units 
-    above the Anchor, and -3 was entered, the Free vertex would be moved down
-    5 units to sit 3 units below the Anchor.
-
-Hotkeys:
-LMB = Left Mouse Button, RMB = Right Mouse Button
-
-ESC      exits the add-on
-LMB+RMB  exits the add-on
-LMB      selects points and activates button
-X        sets X-axis lock
-Y        sets Y-axis lock
-Z        sets Z-axis lock
-C        clears axis lock (sets "Spherical" lock in rotation mode)
+4) Enable the Add-On by clicking on the box to the left of Add-On's name
+
+#============================================================================
 
 todo:
   [?] rewrite/refactor code to optimize for modal operation
@@ -143,7 +41,7 @@ todo:
   [ ] better measurement input panel
   [ ] add hotkey reference info into 3D View ?
 
-#############################################################################
+#============================================================================
 '''
 
 bl_info = {



More information about the Bf-extensions-cvs mailing list