NoteWorthy Composer Forum

Forums => Tips & Tricks => User Tools => Topic started by: Rick G. on 2013-01-25 09:54 pm

Title: rg_CloneStaff.php - an enhanced AddStaff
Post by: Rick G. on 2013-01-25 09:54 pm
This works like New Staff (http://ntworthy.com/nwc2/help/MNU_NEWSTAFF.htm) except that the staff is created immediately below the selected staff and inherits all its attributes. Any notation in the selection is added to the staff. Select nothing to create an empty staff. Any lyrics present are added regardless of the selection.

The tool requires:

Like all User Tools that return File Text, NWC will prompt you to save your work. This should not be necessary as the tool's action can be undone by deleting the staff it creates.
Title: Re: rg_CloneStaff.php - an enhanced AddStaff
Post by: Lawrie Pardy on 2013-01-25 10:14 pm
I like this one Rick, thanks :)
Title: Re: rg_CloneStaff.php - an enhanced AddStaff
Post by: Richard Woodroffe on 2013-01-25 10:19 pm
Rick,

Long needed !  Brilliant, thank you.

Have tested with a few examples and all works very well.  There are so many times I have wanted to clone a staff and as far as I can see, this does all that might be needed,  either a clone as a new staff without anything else, or a clone with all the music and everything else. I particularly like the fact that lyrics are included. This is useful when needing to have a second set of lyrics for formatting purposes.

Will continue testing over the next few days but from what I have seen so far, I do not expect any problems.


Title: Re: rg_CloneStaff.php - an enhanced AddStaff
Post by: Rick G. on 2013-01-25 10:35 pm
Thanks, guys.

I particularly like the fact that lyrics are included.
The NWC UI makes it so easy to remove lyrics that I figured that an option to exclude them would just add unneeded confusion.
Title: Re: rg_CloneStaff.php - an enhanced AddStaff
Post by: Richard Woodroffe on 2013-01-25 11:19 pm
I figured that an option to exclude them would just add unneeded confusion.

Over and above that, before your script, selecting and copying an entire staff would not copy lyrics and having to go back to the original staff, edit and copy the lyrics, go to the new staff, configure and then paste was such an annpying set of actions. This will be a well loved script.
Title: Re: rg_CloneStaff.php - an enhanced AddStaff
Post by: Haymo on 2013-01-26 10:09 am
Rick, this tool is what I've been waiting for!

Unfortunately, being a bit backward and dense,
I need help to translate your instruction:

The tool requires:
  • Input Type: File Text
  • Options: Returns File Text

into exactly what I have to do
to install and run the tool.

On trying to use it in the same way as (say) "GlobalMod",
without selecting anything on the staff,
I got the following error message:

Error: [in C:\Program Files\Noteworthy Software\NoteWorthy Composer 2\Scripts\rg_CloneStaff.php, at line 14]
--> NWC User Tool Input Type: File Text is required.

Your help will be most appreciated.
Title: Re: rg_CloneStaff.php - an enhanced AddStaff
Post by: Warren Porter on 2013-01-26 12:17 pm
Haymo, the tool is great and performs exactly as advertised.

After you have created the command line, there are two radio buttons and four checkboxes.  Under Input Type, select File Text.  Under Options, check Returns File Text.  Then click OK.

To run it select what you want replicated on a new staff and start his tool.
Title: Re: rg_CloneStaff.php - an enhanced AddStaff
Post by: Rick G. on 2013-01-26 02:17 pm
Haymo, I hope Warren has answered your questions. Thanks Warren.
Title: Re: rg_CloneStaff.php - an enhanced AddStaff
Post by: Warren Porter on 2013-01-27 01:19 pm
Haymo, I hope Warren has answered your questions. Thanks Warren.
You're welcome.

It should be noted that good programmers and technical writers don't make their instructions any longer or more complex than they have to--I was just echoing what Rick had already posted.  When someone posts a new tool in this forum, please read all of their installation instructions if you decide to use it.
Title: Re: rg_CloneStaff.php - an enhanced AddStaff
Post by: Haymo on 2013-02-11 08:27 pm
Rick and Warren,
please be patient with me.

I do read the instructions, but that does not necessarily mean that I've understood them.
In this case,
"The tool requires:

•Input Type: File Text
•Options: Returns File Text"

Fine, brief, concisely put.
Problem is, as I do not know what "File Text" is - the whole instruction is lost on me.

Title: Re: rg_CloneStaff.php - an enhanced AddStaff
Post by: Flurmy on 2013-02-11 08:56 pm
Don't worry, Haymo, it's very easy: when you want to add a new tool you must do Insert->User tools->New

There you have the "Input type" radio buttons "Clip text" and "File text".
And also an "Options" check box called "Returns File Text".

You have to select what's suggested by the tool autor.
That's all.

If the tool is old or bears no indications then select "Clip text" and not "Returns File Text"-