Replace

The Replace mechanism is used to replace some objects with other objects (or values with other values), using the With keyword, and it might be limited to a defined scope using the If keyword.

The syntax is:

Replace [search for objects/values] ( With [replace with objects/values]  ( If  [search in objects] ))

Details about the syntax can be read in the Replace keyword topic. The Replace command can be accessed by pressing the Move key twice.

 

The replace will search for the objects (could be fixtures, groups, presets, or any object) or values and the search result will be exchanged with similar objects or values. Just like the regular search function, it might be limited to a certain area in the show (for instance a specific sequence, group, world, or any object).

All this might sound complex but it does not have to be.

 

Replacing objects

If Fixture 1 needs to be replaced by Fixture 2 in the entire show then type the following:

Doing the replace will open a confirmation pop-up like this:

Tapping the Ok button will perform the replace action.

Tapping the Ok Create Report button will also perform the replace, but in addition it will create and open a report showing what the replace action did - it is similar to the search report described in the Search topic.

Tapping the Cancel button will cancel the replace action - it is same result if the X in the upper left corner is tapped.

If the replace action is performed, then the result is that the values fixture number 1 had is now transferred to fixture number 2 and fixture number 1 is no longer used in the show.

If the replace is only supposed to happen in sequence number 3 then use the following command:

 

If a fixture is replaced by nothing then the stored values are just removed.

The following two commands will remove any stored data from fixture 1:

The With keyword is optional when the object is not replaced with something else.

 

Presets can also be changed with replace. For example replacing position preset 2 with preset 4 in sequence 5 can be written like this:

 

If the preset is only suppose to be replaced for fixture 8 in sequence 5 then it is a two step process:

1. First do a search for fixture 8 in sequence 5
   [Channel]> Search Fixture 8 If Sequence 5
2. Then use the SearchResult (the virtual world created by a search action) as the limiting object in the replace:
   [Channel]> Replace Preset 2.1 With Preset 2.4 If SearchResult

 

Replacing values

Values can also be replaced by other values.

A single value can be replaced by another:

This would change all the places where the dimmer value 50 are stored to a value of 55.

 

What is perhaps more interesting is changing value ranges with a different value range. For instance if all dimmer values should be raised 20% in sequence 4 (a dimmer value of 10 will become 12) then the following command can be used:

Or if only fixture 1 and 2 are suppose to get a 20% (a dimmer value of 100 will become 80) lower value in sequence 4:

Remember that when using more complex limitations it might be a good idea to used the SearchResult from a limiting search as the limiting scope.

 

Other attributes can also be replaced.

Making the stored Pan range smaller for a fixture range of 1 through 10, can be done like this:

Or it can be shifted +20 degrees:

 

The attributes are different depending on what fixture types are patched in the show. The list of attributes and their (screen)names can be seen using the List keyword:

The names listed in the column called LibraryName needs to be used with the replace function - do not use the ScreenName.

 

Replacing values with presets (objects)

As a rule it is only possible to replace values with values and objects with objects. So replacing a stored value with a preset is not possible as a direct action. But there is a way by first searching the value maybe limited to a specific object like a sequence.

In this example the stored dimmer value of 50 is to be replaced by a dimmer preset. First the value is searched in sequence number 8:

Then the result is used to limit where the replace is performed and the dimmer attribute (object) is replaced with the preset: