Attachment Basics

Camelot is mostly about managing your MIDI controllers, virtual and hardware instruments, and audio mixing and processing, but it also includes other features to put your live performances completely under your control. One of the most useful of these features is the ability to attach PDF, PNG, or JPG files containing chords, score, lyrics, or notes to each Scene in Camelot.

An attached file is displayed whenever the Scene to which it is attached is recalled - whether automatically from the timeline or manually - if the Attachments view was active when the Scene was last exited. This means that chords or lyrics can appear onscreen for each section of a song, or that cue notes can appear when the first Scene of a new Song is recalled.

Camelot’s attachments features are versatile, allowing zooming and scrolling documents, even adding notes on top of them.

For iPad users: wherever you see the word “click” in this tutorial, substitute the word “tap.”

Attachments view

All operations related to attachments take place in the Attachments view, which is opened by clicking the Attachments button in the footer.

_{Figure 1 - The Attachments view allows adding image files that can be viewed while playing.}

Adding an Attachment

1.    Since documents are attached to Scenes, be sure that the Scene to which you want to make an attachment is the current Scene before you click the Attachments button to add a new attachment.

2.    Click the Attachments button in the footer to open the Attachments view. If an attachment has already been made to this Scene, it will be displayed when you open the Attachments view, otherwise you’ll see this screen:

_{Figure 2 - The first step in adding an attachment is simply to click or tap in this screen.}

3.    Click in the window and the Create new attachment panel will open and display a list of attachments that have previously been loaded into Camelot.

_{Figure 3 - The Create new attachment window allows you to select from previously used attachments, import a new file as an attachment, or go directly to the Annotation Board. Importantly, it is also the only place that offers the option to attach the same image file to every Scene in a Song.}

4.    Click any document shown in the list of files used in Camelot before to attach that document. If the list is long, the Search field at the top can be useful in finding the document you want in the list quickly.

5.    To attach a document that is not in the list, click the Load file button, navigate to the file you want to attach, and select it.

6.    The file will open in the Configure attachment screen.

Files in the list shown in the Create new attachment panel can be renamed or deleted by clicking on the “three dots” (“…”) menu to the right of the document name and choosing Rename File or Delete File.

_{Figure 4 - The "three dots" menu allows renaming an attachment or removing it from Camelot.}

Attaching a document to every Scene in a Song

Documents are attached to Scenes, sometimes you want to see an attachment for the duration of an entire Song, such as if the attachment contains complete lyrics for the song. To make this easy, there is a simple mechanism by which the document can be attached to every Scene in a Song.

_{Figure 5 - A document can be attached to every Scene in a Song, so that it is displayed the entire time the Song plays, simply by clicking the Song button in this screen.}

1.    While in the Create new attachment panel, click the Set attachment on current button at the bottom of the panel.

2.    Click the Song button. The document will be attached to all Scenes in the Song.

Note that these options are only available when adding an attachment in the Create new attachment panel.

Configuring an attachment

_{Figure 6 - This attachment configuration screen offers a number of options for setting up how an attachment will appear onscreen.}

When a document is selected for attachment to a Scene, it opens in a configuration window that offers a number of display options.

Zoom

_{Figure 7 - The left and right buttons zoom the display in and out, while the middle button returns the display to its original zoom level.}

In the lower left of the screen are three buttons for zooming. Click the magnifying glass icon with the plus sign (“+”) to zoom in, the button with the minus sign (“-“) to zoom out, or the button in the center with the four arrows icon to restore the attachment to the default size. Note that it is not possible to zoom out from the default size; zooming out is only allowed if the Zoom In button has been used to enlarge the display. Similarly, the Restore to Default Size button only functions when the display is not already at the default size. The zoom level is remembered when you click the Done button on the Configure screen, so the document will be recalled at that zoom level when the Scene is loaded.

Navigate pages

_{Figure 8 - You can use the up and down arrows to go to the next or previous page of an attachment with multiple pages. The current page is displayed in the center.}

If the document you attach has more than one page, there are two different ways to move between pages:

• Place the cursor over the document and use the scroll wheel, or
• Use the page change buttons at the bottom of the screen.

The page being displayed is remembered when you click the Done button on the Configure screen, so the document will be recalled with that page displayed when the Scene is loaded.

Scrolling

_{Figure 9 - The button on the right, shown engaged in this figure, allows continuous scrolling of a zoomed in or multipage attachment. The button on the left restores standard mode, in which continuous scrolling is not possible.}

When an attachment is zoomed in or has multiple pages, it can be continuously scrolled by clicking the Scroll button at the bottom and then either using a scroll wheel or dragging to the desired vertical placement.

If an attachment is zoomed in far enough that it does not fit within the screen, it can be scrolled vertically or horizontally by dragging without need to click the Scroll button.

The vertical position being displayed is remembered when you click the Done button on the Configure screen, so the document is scrolled to that position when the Scene is loaded. Note, however, that if you click away from the Scroll button (that is, to the fixed display mode), the display will jump to the top or bottom of the current page, so be sure to be in scroll mode when you click the Done button to preserve the scroll position.

One/Two Paage Display

_{Figure 10 - Multi Page attachments can be displayed in a two-up format (two pages side by side). This is particularly useful for performance notes, and for lyrics in a large font.}

If an attachment has two or more pages, the display can be set to show either a single page (“one up”) or two pages side-by-side (“two up”) by clicking the page layout button. If there are more than two pages, the additional pages will continue beneath the first two.

_{Figure 11 - This three-page attachment is shown in two-up display, with the top of the third page just visible at the bottom of the screen.}

Full-Screen Display

Clicking the frame icon in the upper left of the Attachments view hides all of Camelot’s controls so that the attachment can use the entire window for maximum visibility.

_{Figure 12 - Full-screen display mode is particularly useful when running Camelot on an iPad.}

Annotations

Notes (“annotations”) can be added on top of an attached document with comments or reminders, similar to old-school “sticky notes” that would get stuck onto paper documents. When no attachment is present, the Annotation Board allows notes to be added anyway by simulating an empty document.

To access the Annotation Board:

_{Figure 13 - In situations where you want a note, but no image is attached,, the Annotation Board button in the Create new attachment panel provides the means for adding it.}

• Click the Annotation board button in the Create new attachmennt screen.

To add a note on top of a document or on the Annotation Board:

_{Figure 14 - This button, found in the lower left corner of the attachment configuration screen, allows adding a note on top of an image file or the Annotation Board.}

• Click the Add Annotation button in the lower right of the Configure screen. The screen will turn blue-green.
• To add a note, click at the location where you want it located. The annotation configure controls will appear, along with a note in the spot where you clicked. Here are the available configuration controls:

_{Figure 15 - Notes can have one of three background colors, one of three font sizes, and be sized as needed.}

• Drag the note to reposition it.
• Drag the handle on any corner to resize the note.
• To add text, click in the note, select or delete the default text, and type in the new text. Click anywhere outside of the note to exit text entry mode.
• Click the color select button (with the “ink drop” icon) to choose one of the three available background colors for the note.
• Click the font size button to choose one of the three available font sizes for the note.
• Click the trash icon to delete the note.
• Click the exit button in the lower left corner when your note is set up as you want to return to configuration mode.

Editing an Attachment

To return to editing an attachment after leaving configuration mode:

• Do a long press (click and hold) on the Attachment icon in the footer until edit mode is entered.

OR

1.    Click the “three dots” icon in the upper right to access the main wizard menu.

2.    Click the Edit button, then click the Attachment button.

_{Figure 16 - Edit mode for an attachment can be accessed with a long press on the attachment icon or by using the wizard.}

Removing an Attachment

To remove an attachment:

1.    Enter configuration mode as described in the Editing an Attachment section above.

2.    Click the Remove button in the upper left corner.

_{Figure 17 - Well, this is kind of obvious, isn't it?}