Table of Contents
Usage
The button 'Find All' adds a functionality, which I always wished for director. It lists all occurrences of the searchstring instead of repeatedly needing Cmd-G... In the same dialog you have the option to 'Replace All', which does the same as directors 'Replace ALL' except that it can use regular expressions.
Search scope
You can choose in which strings you want the search to happen:
- the scripttexts of your movie
- the contents of textmembers
- the contents of fieldmembers
- the names of all members
- the comments of all members
- the behavior initializers (-> GPDL)
Features
- The recent terms you used for searching or replacing are provided in a drop down menu.
- Constrain the search to the selected members only.
- Choose to skip comments in scripts
- Choose to search case sensitive.
Methods
After a search with 'Find All' a list will be displayed with all the matches found listed by scriptmember, handler and line number. You can expand/collapse the listing entries by either clicking on the triangle next to the list entry or doubleclick on its name. Holding down the Option key while expanding/collapsing a hierarchie, expands/collapses all subentries.
Move the mousecursor over an item for a tooltip with the context of the match.
Click on a match to open the member and highlight the matched chunk.
Cmd-click on an item to select it and all its subnodes in the cast (score in case of GPDL)
Select one or several matches (hold down the shift key for multiple selection) to mark them for replace. The 'Replace' button is available as soon as something is selected.
The 'Replace' button only replaces the selected items with the expression you enter in the upcoming dialog. Selecting a handler name replaces all occurrences inside the selected handler, as well as selecting a script member name replaces all occurrences found in this script.
Since I used the PRegEx Xtra there is also the option to search/replace using a regular expression. Please read in the docs of PRegEx what a regular expression is and how to use it.
The button 'Select in Score' selects all occurrences of the first selected castmember in the score. Unlike directors own function ALL occurrences are selected at once. This can be handy for replacing all members or changing the behavior initializers of all sprites with the selected behvior attached at once.
----
The button 'New instance' opens a new instance of the FindAll window, so that you can work with the results of different searches. Note, that this functionality on the Windows platform only works, if the xtra file is set to read-only. Right click the file 'FindAll.dcr' in your xtras folder and choose 'Properties'. In the dialog select 'read-only'.
Notes
You must confirm the change for each scriptmember. After the first confirm another alert comes up giving the option to 'Say Yes to All' and all members get changed without further alert.
