Find
All data that can be found within a pattern can be searched for here.
Query Fields
A query contains:Search for note values.
Search for instrument numbers.
Search for volume values.
Search for effect type.
Search for effect value.
Match Types
All fields have the following choices for what data will be found:- ignore: Ignore this field in the search
- equals: Match the given value exactly
- not equal: Match everything but the given value
- between: Match anything between and including the given values
- not between: Match anything outside the given range of values
- any: Match all values
- none: Match blanks only
Query Management
Remove query. If only one query exists, it is cleared.
Adds another Effect and Value to the query, each set representing additional effects columns.
Removes last Effect and Value from the query.
Adds another query.
Search Options
Restricts search range.
- Song: Search entire song
- Selection: Search current selection only
- Pattern: Search currently viewed pattern only
Restricts to the selected channels and the channels between them.
Chooses how the order of effect types and effect values will matter when finding them.
- No: No attention is paid to what order the effects appear in
- Lax: Matches effects if they appear in the same order as selected above
- Strict: Effects may only match in their corresponding effects columns
Find Button
The Find button finds everything that matches the query and displays it in a list.- The order, row, and channel columns show the location of each match
- The go column buttons will take you to the location of the result
Replace
You may select any of these fields to replace:
- Note: Note
- Ins: Instrument
- Volume: Volume
- Effect: Effect type
- Value: Effect value
Replacement Modes
All fields have the following choices for how they alter matches:set
set
Changes matched data to this value.
add
add
Adds this value to matched data. It may be negative for subtraction. Notes are calculated in semitones.
add (overflow)
add (overflow)
As “add” above, but values will wrap around; for example, adding 13 to
FF will result in 0C.scale
scale
Multiply value to this percentage; for example, scaling
1A by 150 results in 27. Not available for “note”.clear
clear
Erases matched data.
Replace Options
Adds another Effect and Value to be replaced according to how they were found.
Removes last Effect and Value.
Controls how effects are replaced.
- Replace matches only: Replaces only the effect columns that match
- Replace matches, then free spaces: Replaces matched effects; if there are effect columns without data, those will be filled in with the additional effect replacements
- Clear effects: Overwrites effect data with replacement effects
- Insert in free spaces: Replaces nothing; replacement effects are inserted in free effects columns when available