chore: autopublish 2024-08-12T13:14:45Z

Author: github-actions[bot]

dist/articulation_autoposition_rolled_chords.lua

@@ -351,6 +351,13 @@ package.preload["library.articulation"] = package.preload["library.articulation"
         end
         return text_mets:CalcWidthEVPUs(), text_mets:CalcHeightEVPUs()
     end
+
+    function articulation.reset_to_default(artic, artic_def)
+        artic_def = artic_def or artic:CreateArticulationDef()
+        artic.StackingMode = finale.ARTICSTACKING_USEDEFINITION
+        artic.PlacementMode = finale.ARTICPLACEMENT_AUTOMATIC
+        artic:ResetPos(artic_def)
+    end
     return articulation
 end
 function plugindef()

dist/articulation_reset_auto_positioning.lua

@@ -1,8 +1,8 @@
 function plugindef()
     finaleplugin.Author = "Robert Patterson"
     finaleplugin.Copyright = "CC0 https://creativecommons.org/publicdomain/zero/1.0/"
-    finaleplugin.Version = "1.0.1"
-    finaleplugin.Date = "February 28, 2020"
+    finaleplugin.Version = "1.1"
+    finaleplugin.Date = "July 29, 2024"
     finaleplugin.CategoryTags = "Articulation"
     finaleplugin.MinFinaleVersionRaw = 0x1a000000
     finaleplugin.MinJWLuaVersion = 0.58
@@ -23,27 +23,31 @@ logic to manage the stacking context.
         }
     ]]
     finaleplugin.HashURL = "https://raw.githubusercontent.com/finale-lua/lua-scripts/master/hash/articulation_reset_auto_positioning.hash"
-    return "Reset Automatic Articulation Positions", "Reset Automatic Articulation Positions", "Resets the position of automatically positioned articulations while ignoring those with manual positioning."
+    return "Reset Automatic Articulation Positions", "Reset Automatic Articulation Positions",
+        "Resets the position of automatically positioned articulations while ignoring those with manual positioning."
 end
+local articulation = require("library/articulation")
 function articulation_reset_auto_positioning()
     for note_entry in eachentry(finenv.Region()) do
         local articulations = note_entry:CreateArticulations()
-        for articulation in each(articulations) do
+        for artic_assign in each(articulations) do
             local articulation_def = finale.FCArticulationDef()
-            if articulation_def:Load(articulation.ID) then
+            if articulation_def:Load(artic_assign.ID) then
                 local do_save = false
                 if articulation_def.CenterHorizontally then
-                    articulation.HorizontalPos = 0
+                    artic_assign.HorizontalPos = 0
                     do_save = true
                 end
                 if finale.ARTPOS_MANUAL_POSITIONING ~= articulation_def.AutoPosSide then
-                    local save_horzpos = articulation.HorizontalPos
-                    articulation:ResetPos(articulation_def)
-                    articulation.HorizontalPos = save_horzpos
+                    local save_horzpos = artic_assign.HorizontalPos
+                    local save_flip = artic_assign.PlacementMode
+                    articulation.reset_to_default(artic_assign, articulation_def)
+                    artic_assign.HorizontalPos = save_horzpos
+                    artic_assign.PlacementMode = save_flip
                     do_save = true
                 end
                 if do_save then
-                    articulation:Save()
+                    artic_assign:Save()
                 end
             end
         end

dist/articulation_reset_positioning.lua

@@ -1,8 +1,8 @@
 function plugindef()
     finaleplugin.Author = "Robert Patterson"
     finaleplugin.Copyright = "CC0 https://creativecommons.org/publicdomain/zero/1.0/"
-    finaleplugin.Version = "1.0.1"
-    finaleplugin.Date = "February 28, 2020"
+    finaleplugin.Version = "1.1"
+    finaleplugin.Date = "July 29, 2024"
     finaleplugin.CategoryTags = "Articulation"
     finaleplugin.MinFinaleVersionRaw = 0x1a000000
     finaleplugin.MinJWLuaVersion = 0.58
@@ -25,13 +25,13 @@ logic to manage the stacking context.
     finaleplugin.HashURL = "https://raw.githubusercontent.com/finale-lua/lua-scripts/master/hash/articulation_reset_positioning.hash"
     return "Reset Articulation Positions", "Reset Articulation Positions", "Resets the position of all selected articulations."
 end
+local articulation = require("library/articulation")
 function articulation_reset_positioning()
     for note_entry in eachentry(finenv.Region()) do
         local articulations = note_entry:CreateArticulations()
-        for articulation in each(articulations) do
-            local artic_def = articulation:CreateArticulationDef()
-            articulation:ResetPos(artic_def)
-            articulation:Save()
+        for artic_assign in each(articulations) do
+            articulation.reset_to_default(artic_assign)
+            artic_assign:Save()
         end
     end
 end

dist/note_automatic_jete.lua

@@ -351,6 +351,13 @@ package.preload["library.articulation"] = package.preload["library.articulation"
         end
         return text_mets:CalcWidthEVPUs(), text_mets:CalcHeightEVPUs()
     end
+
+    function articulation.reset_to_default(artic, artic_def)
+        artic_def = artic_def or artic:CreateArticulationDef()
+        artic.StackingMode = finale.ARTICSTACKING_USEDEFINITION
+        artic.PlacementMode = finale.ARTICPLACEMENT_AUTOMATIC
+        artic:ResetPos(artic_def)
+    end
     return articulation
 end
 package.preload["library.utils"] = package.preload["library.utils"] or function()

dist/pitch_transform_harmonics_fifth.lua

@@ -43,6 +43,13 @@ package.preload["library.articulation"] = package.preload["library.articulation"
         end
         return text_mets:CalcWidthEVPUs(), text_mets:CalcHeightEVPUs()
     end
+
+    function articulation.reset_to_default(artic, artic_def)
+        artic_def = artic_def or artic:CreateArticulationDef()
+        artic.StackingMode = finale.ARTICSTACKING_USEDEFINITION
+        artic.PlacementMode = finale.ARTICPLACEMENT_AUTOMATIC
+        artic:ResetPos(artic_def)
+    end
     return articulation
 end
 package.preload["library.transposition"] = package.preload["library.transposition"] or function()

dist/pitch_transform_harmonics_fourth.lua

@@ -43,6 +43,13 @@ package.preload["library.articulation"] = package.preload["library.articulation"
         end
         return text_mets:CalcWidthEVPUs(), text_mets:CalcHeightEVPUs()
     end
+
+    function articulation.reset_to_default(artic, artic_def)
+        artic_def = artic_def or artic:CreateArticulationDef()
+        artic.StackingMode = finale.ARTICSTACKING_USEDEFINITION
+        artic.PlacementMode = finale.ARTICPLACEMENT_AUTOMATIC
+        artic:ResetPos(artic_def)
+    end
     return articulation
 end
 package.preload["library.transposition"] = package.preload["library.transposition"] or function()

dist/pitch_transform_harmonics_major_third.lua

@@ -43,6 +43,13 @@ package.preload["library.articulation"] = package.preload["library.articulation"
         end
         return text_mets:CalcWidthEVPUs(), text_mets:CalcHeightEVPUs()
     end
+
+    function articulation.reset_to_default(artic, artic_def)
+        artic_def = artic_def or artic:CreateArticulationDef()
+        artic.StackingMode = finale.ARTICSTACKING_USEDEFINITION
+        artic.PlacementMode = finale.ARTICPLACEMENT_AUTOMATIC
+        artic:ResetPos(artic_def)
+    end
     return articulation
 end
 package.preload["library.transposition"] = package.preload["library.transposition"] or function()

docs/library/articulation.md

@@ -5,6 +5,7 @@
 - [delete_from_entry_by_char_num(entry, char_num)](#delete_from_entry_by_char_num)
 - [is_note_side(artic, curr_pos)](#is_note_side)
 - [calc_main_character_dimensions(artic_def)](#calc_main_character_dimensions)
+- [reset_to_default()](#reset_to_default)
 
 ### delete_from_entry_by_char_num
 
@@ -57,3 +58,17 @@ Uses `FCTextMetrics:LoadArticulation` to determine the dimensions of the main ch
 | Return type | Description |
 | ----------- | ----------- |
 | `number, number` | the width and height of the main articulation character in (possibly fractional) evpus, or 0, 0 if it failed to load metrics |
+
+### reset_to_default
+
+```lua
+articulation.reset_to_default()
+```
+
+[View source](https://github.com/finale-lua/lua-scripts/tree/refs/heads/master/src/library/articulation.lua#L84)
+
+Implements all calls necessary to reset the articulation to default positioning. These settings achieve
+the same result as hitting the Clear key for the Articulation in the Finale UI.
+
+@artic (FCArticulation)
+@artic_def (FCArticulationDef) optional definition for this articulation (calculated if not supplied)

hash/articulation_autoposition_rolled_chords.hash

@@ -1 +1 @@
-47cc1a393c0a5ace6ee580fd0d911cf7602e072fc557b0a0a2e8a93d785a21d1efb35e29fe065eef8ad01bfc73c7315cade87eeb1d51a5f342859a9bcc45c4b3  articulation_autoposition_rolled_chords.lua
+3f240c15b9d06b603b35d08e5c755724ea1e34fa5d6a6c7e4eb061c580484883e86339379d660edd87c492187faa1bc6b81b109bf6a74ada8ad960c9f44a9c80  articulation_autoposition_rolled_chords.lua

hash/articulation_reset_auto_positioning.hash

@@ -1 +1 @@
-9fe5b834d0183b9f153436421b0b7f1420ed96e0d875867d84f4e4936d1148fac71c9d7fb9f76e3ea115889a8e0e1f19fab8c2a9fa4361da17ef652ee07580df  articulation_reset_auto_positioning.lua
+a4c59e5d267b3d1045887304d9aa5c3421af5bf119b5b0f4ee87de9918ab7ece31d74f208ee56b129d479d80526790e2df883e24698e7229ad2c55be29e27b34  articulation_reset_auto_positioning.lua