Search


Introduction

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.


Basic Searching

Text

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.

Session

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`

Keywords

Specific words prefixed with / can be used to allow for quick generalised searching.

Type

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

Special Type Keywords

/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".

Colour

Each Stamp has a colour property. To filter the central display to include the stamps with a specific colour, use the following keywords:

/green /red /yellow /purple

Assignment

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

Special Assignment Keywords

@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".

Wildcard Comparison

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

Variables

/cue/number /cue/upTime /cue/downTime /eos/list /eos/number /qlab/number /hog/list /hog/number

Operators

== != <= >= < >

== Equals to

The == 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 to

The != 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 to

The <= 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 to

The >= 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 Than

The < 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 Than

The > 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.