NoteWorthy Composer Forum

• NWC2 User Tool Starter Kit Download Page

• User Tools are accessed from the Tools, User Tool command, or from the keyboard using Alt+F8.
• A User Tool processes notation contained in a single staff, or selected portion of a staff.
• When a User Tool is invoked, NWC2 passes a text description of the staff notation to the tool. This text is commonly called NWC2 Clip Text. Each line of text represents a single object on the NWC2 staff, such as a chord, note, text expression, or tempo item.
• Each User Tool is actually a stand alone program or script that accepts NWC2 Clip Text as input, and can output new or updated Clip Text back to NWC2.
• NWC2 fully supports the User Tool mechanism out of the box, but it does not come prepackaged with any actual tools. A starter kit built around the PHP scripting language can be downloaded from this topic.

• About Starter Kit (nwsw)
  This script simply displays a message describing the start kit and the currently installed version of the utility library.
  
• Arpeggiate (nwsw)
  This script adds leading grace notes into selected quarter, half, or whole note chords in order to create an arpeggio sound effect during play back.
  
• Retrograde (nwsw)
  This script is used to retrograde selected notation in a staff.
  
• Statistics (nwsw)
  This simple script counts the items in the selection and reports back the results.
  
• Unjazzify (nwsw)
  This script will find note pairs where the first note is a dotted note, and the second is half the notehead duration of the first and is not dotted. It will convert the pair into two notes of equal duration.
  
• Variable Dump for Developers (nwsw)
  Targetted at script writers, this script enables a developer to explore the array tree built by the nwc2clips.inc library included in this package.
  

• Compound Autobeam (adp)
  Beams complex time sigs according to user-specified template.
  
• Global Modification (adp)
  Permits you to globally modify particular components in a staff.
  
• Parts (adp)
  Permits you to separate a part in polyphony.
  
• Ranges (adp)
  Script that returns the note ranges in a selection.
  
• Transpose Chords (adp)
  A script which will automatically transpose chords written as text.
  

<?php
// nwsw_PromptExample.php Version 1.0
//
// This script demonstrates the prompting mechanism in NWC2 User Tools.
//
// Copyright © 2004 by NoteWorthy Software, Inc.
// All Rights Reserved
//
// History:
// 2004-12-12: Initial release (1.0)
//
require_once("lib/nwc2clips.inc");

$clip = new NWC2Clip('php://stdin');

$raw_argv = print_r($argv,true);

echo <<<___EOTEXT
This script demonstrates one method for passing command line
arguments into a user tool. This demonstration accepts three 
options, each of which are prompted on the scripts behalf 
by NWC2.

The built-in argc and argv variables are set as follows:
\$argc = $argc
\$argv = $raw_argv

The result of the example processing of the options is 
shown below. To see how this was done, simply look at
the source for this script.

___EOTEXT;

// Below is an example of one technique for evaluating the arguments passed 
// to the script
$opts = array();
foreach ($argv as $k => $v) {
  if (!$k) continue;

  if (preg_match('/^\/(opt[1-3])\=(.*)$/',$v,$m)) {
    $optname = $m[1];
    $optvalue = $m[2];
    $opts[$optname] = $optvalue;
    }
  }

if (isset($opts["opt1"])) {
  echo "\nOption 1 is set with the following data: $opts[opt1]\n";
  }

if (isset($opts["opt2"])) {
  echo "\nOption 2 is set with the following data: $opts[opt2]\n";
  }

if (isset($opts["opt3"])) {
  echo "\nOption 3 is set with the following data: $opts[opt3]\n";
  }

exit(NWC2RC_REPORT);
?>

'php\php.exe scripts\nwsw_PromptExample.php "/opt1=<PROMPT:Prompt 1: Select an option from this list:=|Quarter|8th|16th|32nd>" "/opt2=<PROMPT:Prompt 2: Enter a number=#[0,15]>" "/opt3=<PROMPT:Prompt3: Enter some text=*>"'

• You manually moved the NWC2 program files from the original location where they were installed.
• You manually removed the NWC2 uninstall key from the registry.

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\NoteWorthy Composer 2

• Working with *.nwctxt files
• User Tool Command