LearnIntermediate GuideControl Outputs

Control Outputs

We provide ways to control which macros in a recipe file should have their outputs displayed. Also, we have a “preview” pane that assists in demonstrating what the final recipe outputs will like.

Preview

To get a quick preview of what the output would look like, consult the “preview pane”. Click the following button in the top right corner

Create recipe image

Here is a sample recipe

Create recipe image

The preview for this recipe looks like the following

Create recipe image

We haven’t run the recipe yet. The preview only shows what outputs to expect in advance. Notice that any plain text you write will be preserved in the final outputs.

Toggle Display Output

Clicking the drag handle, on the left side of the editor, opens a dropdown of configurable options. Clicking “Display Output” controls whether the output is displayed. In this example there is a check mark, which means it will be shown in the final outputs.

Create recipe image

Simple example

Let’s do a walkthrough of a simple example, where we toggle the display output option. We’ll do a side by side comparision of one recipe with different display toggle settings.

Recipe ARecipe B
Create recipe imageCreate recipe image

The first macro in recipe A doesn’t have “Display output” enabled.

Both macros in recipe B have their “Display output” enabled.

Notice the “Display output” toggle settings for the recipes. This can also be seen through the “eye” icon on the macros.

Recipe ARecipe B
Create recipe imageCreate recipe image

The first macro doesn’t have “Display output” checked.

The first macro has “Display output” checked.

This is the final output of the recipes.

Recipe ARecipe B
Create recipe imageCreate recipe image
Has only one output.Has two outputs.

Nested Example

The sample toggle logic applies when macros are nested. We’ll do a side by side comparision of one recipe with different display toggle settings.

Recipe ARecipe B
Create recipe imageCreate recipe image

Middle macro is has “Display output” disabled. Slashed “eye” icon.

Middle macro has “Displayed output” enabled. Normal “eye” icon.

The results look like the following

Recipe ARecipe B
Create recipe imageCreate recipe image

Intermediate output is hidden, only final macro is displayed.

All intermediate outputs are displayed.

Additional Notes

  • “Input” macros always output a display for the user to provide input (images, pds, audios, etc).
  • Plain text (anything that isn’t a macro) is always displayed by default (this may change in the future)
Chain Macros