release <- dev (2.4.1)

release <- dev (2.4.1)

docs/README.md

@@ -18,6 +18,7 @@
 <h3><b>Tools:</b></h3>
 <ul>
   <li><a href="#-gt-renamer-">GT Renamer</a></li>
+  <li><a href="#-gt-outliner-sorter-">GT Outliner Sorter</a></li>
   <li><a href="#-gt-selection-manager-">GT Selection Manager</a></li>
   <li><a href="#-gt-path-manager-">GT Path Manager</a></li>
   <li><a href="#-gt-color-manager-">GT Color Manager</a></li>
@@ -385,6 +386,41 @@ In case you need/want to manually install the scripts. It's easy..
 <br>
 </div>
 
+<!-- GT Outliner Sorter -->
+<div>
+<h1> GT Outliner Sorter </h1>
+<img src="./media/gt_outliner_sorter.jpg" align="right"
+     alt="GT Renamer GUI">
+
+<p>Script for sorting outliner hierarchies. Options will not re-parent objects, only change their order.</p>
+
+<p><b>Utilities / Settings: </b>
+<br>- Move Up: Moves the selected objects up in the hierarchy order.
+<br>- Move Down: Moves the selected objects down in the hierarchy order.
+<br>- Move Front: Moves the selected objects to the top of the hierarchy order.
+<br>- Move Back: Moves the selected objects to the bottom of the hierarchy order.
+<br>- Shuffle: Randomizes the order of the selected objects.</p>
+
+<p><b>Sort Ascending/Descending:</b>
+<br>Determines if the output of the operations will be in an increasing order or decreasing.
+</p>
+
+<p><b>Sort by Name: </b>
+<br>- Re-order selected elements based on their names. For example:
+<br>"Object_B", "Object_C", "Object_A", would become:
+<br>"Object_A", "Object_B", "Object_C"
+<br>This also works with numbers. It reads the letters from left to right.</p>
+
+<p><b>Sort by Attribute: </b>
+<br>- Re-order selected elements based on an attribute. For example:
+<br>"Object_B.ty" = 5, "Object_C.ty" = 10, "Object_A" = 1, would become:
+<br>"Object_C.ty" = 10, "Object_B.ty" = 5, "Object_A" = 1 (matching the order of the values)
+<br>You can also use user-defined/custom attributes by filling the text-field on top of the "Sort by Attribute" button.</p>
+
+<br>
+
+</div>
+
 <!-- GT Selection Manager-->
 <div>
 <h1> GT Selection Manager </h1>

mel-scripts/gt_tools_menu.mel

@@ -173,6 +173,10 @@
 //   2.2.1 - 2022-08-06
 //   Changed "Delete Unused Nodes" Utility Order
 //
+//   2.4.1 - 2022-08-31
+//   Added Outliner Sorter
+//   Added "Open File Directory" utlity
+//
 //----------------------------------------------------------------------------
 
 // Globals 
@@ -230,6 +234,12 @@ menuItem -l "Tools" -sm true -to true -image "toolSettings.png";
     -ann ("Script for renaming multiple objects.") 
     -image "renamePreset.png" ;
 
+    menuItem 
+    -l ("Outliner Sorter") 
+    -c ("python(\"gt_tools.execute_script('gt_outliner_sorter', 'build_gui_outliner_sorter')\");") 
+    -ann ("Manages the order of the elements in the outliner.") 
+    -image "outliner.png" ;
+
     menuItem 
     -l ("Selection Manager") 
     -c ("python(\"gt_tools.execute_script('gt_selection_manager', 'build_gui_selection_manager')\");") 
@@ -457,12 +467,22 @@ menuItem -l "Rigging" -sm true -to true -image "kinReroot.png";
 // -----------------------------------------UTILITIES------------------------------------
 
 menuItem -l "Utilities" -sm true -to true -image "bsd-head.png";
-
+
+    // File Utilities
     menuItem 
     -l ("Reload File")
     -c ("python(\"gt_tools.execute_script('gt_maya_utilities', 'force_reload_file')\");")
-    -ann ("Reopens the opened file (to revert back any changes done to the file since it was first opened)") 
+    -ann ("Forces the re-opening of an opened file. (Changes are ignored)") 
+    -image "openScript.png";
+
+    menuItem 
+    -l ("Open File Directory")
+    -c ("python(\"gt_tools.execute_script('gt_maya_utilities', 'open_file_dir')\");")
+    -ann ("Opens the directory where the scene is located.") 
     -image "openLoadGeneric.png";
+
+    // General
+    menuItem -divider true ;
 
     menuItem 
     -l ("Resource Browser")

python-scripts/__init__.py

@@ -6,7 +6,7 @@
 import os
 
 # Global Vars
-PACKAGE_VERSION = "2.3.3"
+PACKAGE_VERSION = "2.4.1"
 
 # Initial Setup - Add path and initialize logger
 if __name__ != '__main__':