Search provides a means to filter the central display to a selection of stamps to better refine the timeline to your current task. To create a search, one or more different type of searches can be combined to predicate on, providing a very simple and expressive method of defining search criteria. For example, to filter the timeline to display all cue stamps labeled and set to be a snap blackout:
/cue blackout /cue/upTime==0 /cue/downTime==0
To quickly select the search field, use the keyboard shortcut Option
⌘
J
and begin typing.
The most basic Stamp search accepts text and compares the following attributes of a stamp on it. Text searches are case and diacritic insensitive.
The following attributes of each stamp is predicated on the text: session.title
, flag.title
, note.label
, cue.label
, cue.number
, eos.label
, eos.cueNumber
, hog.cueNumber
, qlab.cueNumber
and disguise.sectionName
.
Sessions are used to organise the timeline into periods of time.
To filter the timeline to show all stamps within a session; a "Session Search" can be built by using the desired session's title enclosed by `
. For example:
`Start of Day 1`
Specific words prefixed with /
can be used to allow for quick generalised searching.
Every stamp created has a Type property. To filter the central display to include stamps of a certain type, use the following keywords:
/session
/flag
/timecode
/note
/cue
/osc
/midi
/serial
/eos
/qlab
/disguise
/mitti
/hog
/edit
The /edit
keyword filters the cetral display to include stamps that are editable.
Note: "/edit" is the equivilent of "/flag /note /cue".
/connection
The /connection
keyword filters the central display to include stamps that are made from a connection.
Note: "/connection" is the equivilent of "/timecode /osc /midi /serial /eos /qlab /disguise /mitti /hog".
Each Stamp has a colour property. To filter the central display to include the stamps with a specific colour, use the following keywords:
Stamps can be asssigned to team members or categories.
Use the name of a person or category prefixed by an @
symbol to filter the central display to include stamps assigned to them.
@person
The @person
wildcard will predicate on the first, last or company name associated with the team member and filter the central display to include the result.
@Sam @Smallman @artificers
@category
The @category
wildcard will predicate on the category name associated with the category and filter the central display to include the result.
@Lighting @Sound @Automation
@team
The @team
keyword filters the central display to include stamps that are assigned to a person.
@categories
The @categories
keyword filters the central display to include stamps that are assigned to a category.
@everyone
The @everyone
keyword flters the central display to include stamps that are assigned to either a person or a category.
Note: "@everyone" is the equivilent of "@team @categories".
To allow for expressive and scalable searching, wildcards can be utilised in conjuction with relational operators. For example, to filter the timeline to display all Cue Stamps with a number greater than or equal to 10:
/cue/number>=10
/cue/number
/cue/upTime
/cue/downTime
/eos/list
/eos/number
/qlab/number
/hog/list
/hog/number
==
Equals toThe ==
operator can be used to compare if a stamps property is equal to a given value and filters the central display to include the results.
/cue/number==1
This search would filter the central display to include all cue stamps that have their cue.number
property set to 1
.
!=
Not Equals toThe !=
operator can be used to filter out and not include stamps in the central display.
/eos/list!=2
This search would filter the central display to not include any eos stamps with their eos.list
property set to 2
.
<=
Less Than or Equals toThe <=
operator can be used to compare if a stamps property is less than or equal to a given value and filters the central display to include the results.
/cue/number<=50
This search would filter the central display to include any cue stamps with their cue.number
property set to anywhere below and including 50
. For example you may want to see all your cue stamps for Act 1 of the production and the cue number for the interval is 50
.
>=
Greaten Than or Equals toThe >=
operator can be used to compare if a stamps property is greater than or equal to a given value and filters the central display to include the results.
/cue/number>=51
This search would filter the central display to include any cue stamps with their cue.number
property set to anywhere above and including 51
. For example you may want to see all your cue stamps for Act 2 of the production and the cue number for ending the interval is 51
.
<
Less ThanThe <
operator can be used to compare if a stamps property is less than a given value and filters the central display to include the results.
/cue/number<10
This search would filter the central display to include any cue stamps with their cue.number
property set to anywhere below 10
. For example you may want to see all your cue stamps for the opening sequence of the production which ends at cue 9
.
>
Greater ThanThe >
operator can be used to compare if a stamps property is greater than a given value and filters the central display to include the results.
/cue/number>999
This search would filter the central display to include any cue stamps with their cue.number
property set to anywhere greater than 999
. For example you may want to see all your cue stamps that deal with the rig check of the production which starts at cue 1000
.