Custom Filter

Version 01.70.00
Added 05 Oct 2007 (last updated 13 Sep 2021)

For use with Sibelius 6, Sibelius 7.1, Sibelius 7.5, Sibelius 8.x, Sibelius 18.x, Sibelius 19.x, Sibelius 20.x, Sibelius 21.x, Sibelius 22.x, Sibelius 23.x and Sibelius 24.x

A filter that will filter lines as written, but which is designed to be modified. Change the condition in the IsDesiredObject method. The remaining code will filter objects that pass the IsObjectDesired test.

Updated October 10, 2007 to filter for Highlights rather than lines (Edit-Filter can filter lines).

Updated 17 April 2016 to check for empty selections as ask to select entire score.

Updated 03 October 2019. Version 01.40.00. This plugin now will run only in Sibelius version 6.2 or later. It is now completely in the public domain, so that any code within the file may be used in and other plugins without attribution (or support).

As before this plugin is intended to be a template for making your own filtering plugins. I recommend making a copy of the plugin and changing the value of the variable "_PluginMenuName" to be the new plugin name. If you install the plugin "Copy Plugin", it will make a copy of any other plugin and update _PluginMenuName if that variable is available.

In most cases all you should need to change is the code in the method "IsDesiredObject" to produce a new filter. This trick is knowing exactly what to ask for, but at least the structure of getting objects and selecting them will be taken care of by the existing code. Happy filtering!

Updated 10 October 2019. Version 01.50.00. Changed default code to filter for Text, System Text, and Lyrics.

Updated 22 August 2021. Version 01.60.00. Made tracing of results options based on the global variable g_fTraceResults. Made results a Trace call rather than a message box. Made minor code cleanups.

Updated 13 September 2021. Version 01.70.00. Fixed crashing bug when the plugin was run with no selection and user asked to select the entire score.

Plug-in written by Bob Zawalich.