Cues

A cue is the descriptive part of a prompt (prompt = cue + modifiers).

Cues in Scripthea are list of descriptive texts in *.cues files in cues folder. There are two types of cues' folders: Scripthea own and External collections with tens of thousands of cues.   

In Single mode, you can use one cue and more than one modifier in a row.
  • You can make an use one of three auto-refresh modes:

    - In Both auto-refresh mode all the selections (cue and modifiers) you make will automatically be updated in respected text boxes.

    - In Cue only auto-refresh mode - only selected cue is updated automatically for the modifiers to be updated you need to press Complete button

    - In Modif only auto-refresh mode - only selected modifiers is updated automatically for the cue to be updated you need to press Complete button
     

  • In manual mode (None auto-refresh mode) after you select text and modifiers you need to press Compose prompt button in order to update (refresh) the prompt. After the cue is updated you can make some last changes.

In any of the modes here after you let Scripthea update both or some fields you have the final word of editing before the prompt is used in generation of an image. The crossed arrow button top/right allows you to randomly select a cue if you are tired or believe in your good fortune.

After the desired prompt is composed you either click on Generate image if you are connected to Stable Diffusion or any other image generator OR click on blue copy button to use the clipboard to transfer the prompt to a image generator (usually on the web).

In scan mode in front of each cue there is a square check box. In this case any number of cues can be selected. Cue lists are organized in tabs (lists) grouped in two pools (A & B). When select for scan mode, any number of cues from one pool can be selected.

When you scan, the list of selected cues is combined with modifiers following the simple rule: a prompt = one cue + all fixed modifiers + some scannable modifiers. The number of scannable modifiers is defined by modifiers sample number in modifier options.

To make your life easier there is a menu (three teal bars button - top/right) with Check All; Uncheck All, Invert Checking and Check with a Mask commands in it.

As you probably notice the prompt view will go under in scan mode. That is done not to mislead you what the prompt is (they are many).

After you have made your selection there are two ways to continue. If you are connected to Stable Diffusion you can do Scan directly or via Scan Preview. Scan preview allows you the browse the candidate prompts and select a subset of them. Another way to use Scan Review is go for some image generator (SD including) that accepts a list of prompts. From Scan Preview panel you can copy chosen prompts into the clipboard or save as text file, in order to feed the image generator.


 
Image Depot as cue list

You can open an image depot as cue list and it will function as one. Selection (in blue) will function in single mode as radio checkbox (from regular cue list) and the square checkbox as cue list check boxes in scan mode.

The feature is very useful when you are trying modifiers incrementally. After some random or not so random experiments you reach to a point where you have a set of images you like but you would like to experiment further (or even improve upon). In that case, you take the chosen set in a image depot and open it in cues panel, after some experimentation (e.g. scanning)  you will have another set you like even better and open it here... and on and on.

Along with the cues in API mode of SD you can copy SD parameters of selected image with set SD params button to parameters Stable Diffusion tab.

Cue Editor

Cue list (here interchangeable with cues) can be created manually (using Notepad or any plain text editor). All the *.cues files are in cues folder of Scripthea data folder (next to config and images folders).

The cues file format is simple text file containing multi-line texts separated by "---".
Single # is a comment shown in cues user interface but ignored when composing. Double ## comment is ignored when reading the .cues file.

In the editor you can start from scratch (an empty one) or use existing one or use image depot description.idf as a base. +/- buttons top left will add/remove a cue. Use commands by selecting command from the left combo-box and sub-command from the right one. Then click DO IT !  to execute. Browse commands here to see what is available:

  • Open - opens existing cues file, image depot (with or without modifiers), plain text file (each line is a cue) or plain text from the clipboard.
  • Append - add to a cues file content to current list
  • Remove checked - to use this, select first command then check/uncheck cue and then execute (Do it !)
  • Clear - that will create an empty cues list (and dispose the current content)
  • Save As - save current cue list as *.cues file

The most convenient way to add new cue is just select it in your browser or editor and then drag and drop in the next empty cue box.

If you select a word or phrase from the cue and right click, from the popup menu you can Copy or Cut the selected section to the clipboard OR Google for synonyms or the meaning of it.