Backgrounds
Where to find it
You can find Backgrounds in the sidebar, under Dynamic Components. The list shows every Background in this book, each card with its picture or colour. Add Background creates a new one, and pressing a card opens it for editing.
Before you start
Nothing has to exist first: a flat colour needs no file at all. Two things make it easier:
- A picture or a short video. The window picks from the book's Media library, and it can upload a new file straight into it. The Media page lists the formats and sizes it accepts. A video can be at most 30 seconds.
- A place for it to start. A Background reaches the page through a Trigger in a Chapter. It helps to know which scene it is for before you name it.
The editor
The window opens with a folded question at the top, What is a Background? The name comes under it, then a Steps line that says what to do next. Pressed, Steps shows the whole list: choose a picture or colour, frame it, place the words, save, and raise it from a Trigger. On a wide screen, the settings scroll on their own on the left and the picture stays put on the right. On a smaller screen the picture comes first, except on a locked Background, which shows its settings first. The canvas is the same square, type size and shape your Reader gets, so what you arrange there is what they see. Every label with a dotted underline explains itself when pressed. The ? in the corner opens the questions writers ask about it.
A new Background, nothing picked yet. Steps, under the name, says what to do next: choose a picture, a video or a colour. Pressed, it lists the whole job in order. Choose or upload opens the gallery, which holds The Spouter-Inn at dusk. Once a picture is in the square, the Frame and Text area tools appear above it. The last step stays out of reach until the Background has been saved once. Nothing can point at a Background that does not exist yet.
- Name: only you see it, in your list and in the Trigger that raises this Background. It is required, up to 70 characters. A name for the scene, such as "the deck at night", is easy to find later.
- Steps: folded to one line with the count and the next thing to do. Pressed, it shows every step. Framing and placing the words are marked (optional) and are not counted. A picture left centred, with the words in the usual column, is already a finished Background. On a colour, framing says not needed. The last step is the only one done somewhere else, and the window keeps count of it for you. More in Is it raised yet?
Is it raised yet?
Saving a Background keeps it. It does not put it anywhere.
The last step in the list answers it: Raise it from a Trigger. Until a Trigger raises it, this is the next step. The folded Steps line then says what to do, and names this Background so you can find it in the Trigger's result. Once a Trigger raises it, the step ticks. It names the Chapters the Triggers sit in, with a count where a Chapter has more than one.
Picture, video, or colour
Background: [Picture or video] [Colour]
A Background shows either a picture or a flat colour, never both at once. The Picture or video and Colour buttons switch between the two. Switching keeps the side you left. You can try a colour and come back to your picture with the framing intact.
- Picture or video: Choose or upload opens the book's Media library, the same picker the rest of the editor uses. Change swaps the picture and keeps the text area you drew. Clear takes the picture off and leaves it in your gallery. Video plays muted and on a loop. Readers who ask their device for reduced motion get the first frame, held still. A Background video can be up to 30 seconds. The window says so as soon as you pick a longer clip, and Save refuses it.
- Colour: the colour box opens a picker. There are also eight named presets (Midnight, Deep sea, Forest, Ember and so on), and a colour code can be pasted in. No file is uploaded, so nothing counts against your media quota. A colour suits a blackout or a dream.
The frame
One square, every screen
Every Background is composed in the same square. Frame, above the picture, lets you drag the picture around inside the square. The Zoom slider or the mouse wheel pushes in, and the slider shows how far in you are. Whatever ends up outside the square is cut off.
Your Reader's page is not square. The square is scaled up until it covers their whole page, and the overflow is cropped away. A phone keeps a tall slice of the middle, and a laptop keeps a wide one. The dashed Phone and Desktop boxes on the picture show both slices over your composition. You can see what survives on each before you save. Faint lines appear while you drag, to help balance the picture.
The text area
Draw where the words go
Optional. Text area, above the picture, lets you drag a loop around the part of the picture your words should sit in. Prose flows into the loop as you draw, so you can judge it. The prose can be your own (see Your own words in the preview). Dragging a dot reshapes the loop, and dragging from the middle moves the whole thing. A new loop has to begin outside the shape you have, because a drag that begins inside it moves it instead. Clear text area removes it. Without a loop, the words keep the usual centred column, still over your Background.
A freehand loop comes back as eight dots, so it stays easy to edit. The text follows the shape line by line. A loop drawn around a doorway fills the doorway with words, and a shape pinched in the middle pinches the lines too. A shape that zigzags, top right then bottom left, cannot hold words, and the window says so. One side kept roughly straight from top to bottom avoids that.
Preview as: [Phone] [Desktop]
The words on the picture are laid out for one screen at a time. Preview as, above the picture, switches which one. Pressing a box's label on the picture does the same. The other box is drawn fainter, and your words reflow into it when a Reader arrives on that kind of screen.
About 60% of the sample passage fits
The demo at the top of this page opens on Start blank, where nothing is picked and the canvas has no tool bar at all. Its A picture with a place for the words tab already has a loop drawn over the water. Text area there shows this line on a real shape.
Under the picture, the window says how much fits. The sample passage is a fixed paragraph of roughly a hundred words. It is poured in at the Reader's real type size for the screen you are previewing. So the same shape holds a different amount on phone and on desktop. With your own prose poured in, the line counts against that and names it (see Your own words in the preview). Two notes can appear beside it, and neither blocks saving:
- The lines are narrow. It gives the longest line the shape can hold, in letters. 45 to 75 reads comfortably for a whole page. Narrower is fine for a few lines and tiring for a page.
- A full passage does not fit. Nothing is lost and nothing is squeezed. Your Reader gets the passage a page at a time, every page in this same shape. A bigger area lets them see it in one go.
Your own words in the preview
Pour in: [The sample passage]
The words on the picture start as the sample passage: a fixed paragraph nobody wrote. It is the same for every Background, so the percentage under it means the same thing each time you draw a shape.
Pour in, under the picture in Text area, swaps the sample passage for your own words. The list holds every Chapter in this book and every heading inside them. With one picked, the longest paragraph in that section flows into the shape you drew. It is set at the Reader's real type size for the screen you are previewing. The line under it then counts against what you poured in, not the sample passage, and says so by name.
- One paragraph, the longest. A heading takes everything under it, down to the next heading of the same size or bigger. The longest paragraph in there is the one poured in. Your Reader gets each paragraph on a screen of its own, so that one is the hardest test of the shape. A paragraph that runs past about a page is cut off, and the line says the start of it. That way the number can still be compared.
- Nothing written there yet. If the section you picked has no paragraphs in it, the window says so and keeps the sample passage. You are never left thinking the sample passage is your own words.
Strength, backing, gap
- Image strength: how vivid the picture is under the words. 100% is the picture as uploaded. Lower fades it towards a pale wash, which is calmer to read over. Pictures and video only.
- Text backing: a see-through dark layer over the picture, under your words. A higher value helps when the words fight a busy picture. 0% is no layer at all, and it starts at 40%. Pictures and video only.
- Text gap: the breathing room between the edge of the shape you drew and the words, measured on the Reader's page. It does nothing until a shape is drawn. Pushed too far, it leaves no room for text at all, and the window says so.
Your own story colours
Story text, Headings, Mentions
With Your own story colours on, you can set three colours separately. One is the story text itself. One is the Headers and Subheaders that break a Chapter into scenes. The third is the mentions: the words in your prose linked to a Glossary Item. Headings can sit brighter than the text under them. Mentions stay a different colour on purpose, so a Reader can still pick them out. Each row has the same picker, the same named presets, and a Reset that puts it back to the usual colour.
With the switch off, your Reader gets the usual near-white words with a soft shadow. That suits most Backgrounds, because the text backing above already does that work. These colours help when the picture is pale or warm enough that near-white text disappears into it. Over a flat colour, the window compares the two and says when your words will be hard to read. Over a picture it cannot, because a photograph has no one colour. There, the words on the canvas are drawn in your Story text colour, and that is what to judge by. Turning the switch off clears all three.
Raising and removing one
A Background reaches your Reader through a Trigger result pointed at it. The Trigger goes in the Chapter where the scene starts. In its result, the Background is under Dynamic Component, then Backgrounds, by name. Once raised, it stays up. It follows your Reader through the rest of the Chapter and into the next one, until something changes it.
Two things change it. Another Trigger raising a different Background replaces it. The Remove the background option takes it down and leaves the page plain. That option sits at the top of the Background list in a Trigger result, and only there. It is something a Trigger does, not something you build.
What your Reader sees
The Background fills the page the story is printed on. The Reader's own menus and buttons stay where they were. Unless you chose your own story colours, the words go near-white with a soft shadow, so they hold against a busy picture. With a text area drawn, each passage is set into that shape. Without one, the usual column sits on top.
A passage longer than the shape arrives a page at a time. Each page is cut to the same shape and lands in the same place over the picture. Your Reader scrolls through it the way they scroll through everything else. The picture itself does not scroll or change until a Trigger says so.
See it as a Reader is the button with an eye at the top of the window. It shows your Background the way a Reader gets it on a phone or a desktop screen. The picture is cut to that screen. The sample passage, or the paragraph you poured in, sits in your text area in the Reader's own type and colour. There is nothing to drag there, and no dashed boxes. Back returns you to the window.
Published Backgrounds
Once a Background is published, it locks. Its card in the list shows a lock and no longer opens. Duplicate, which appears when you hover over the card, makes a copy with (Copy) added to the name, and the copy can be edited.
The published one changes in an Edition, started from your Published page. There it opens while the Edition works on the part it was published with, and your change goes out with the Edition when you publish it. The Publishing page says what Readers in the middle of the book see.
Validation
The list marks a broken Background on its card and sorts it to the top. The publish check rejects any book with one.
- No picture yet. A Background with neither a picture nor a colour shows nothing. Save stays grey until it has one, and the card says so.
- The picture was deleted. Deleting a file from your Media library flags every Background that uses it. Saving is blocked until it has another picture or a colour. Those are the only two ways out: a Background is one or the other, and with neither it shows a Reader nothing. The text area you drew is kept.
- The text area is unusable. It has to be a single loop that does not cross itself. It must cover at least 10% of the picture, and be at least 30% of the picture wide somewhere. The window names whichever rule is broken while you are still drawing.
- The video is too long. A clip over 30 seconds is flagged the moment you pick it and refused when you save, with the reason.
Before a Background is deleted, a question over its window lists the Triggers that still raise it. "Keep it" changes nothing. "Delete anyway" leaves each of them marked broken until it raises another Background. The book can't be published while one is broken.
Questions writers ask
The same questions and answers sit behind the "?" in the Background window.
How this fits your story
What is a Background, and what does my Reader actually see?
A picture, a short video, or a flat colour that fills the page behind the story for one scene. Your Reader's menus and buttons stay where they were. The words sit over it, in the usual centred column or in a shape you draw.
Nothing opens. There is no window for the Reader to close and no outcome to wait for. The page changes, and the story carries on. A Background is one of two Dynamic Components that open nothing. The other is the Calculation.
I saved my Background and nothing happened. How does it get onto the page?
Saving only keeps it. A Trigger in a Chapter is what raises it. A Trigger is an invisible checkpoint, placed from the "+" menu like any other block. In the Trigger's result, this Background is listed under Dynamic Component, then Backgrounds. When your Reader passes that line, the page changes.
So the Background is built and saved here. Its Trigger goes in a Chapter such as The Ship, at the moment the scene starts. The Background stays up until another Trigger replaces or removes it.
You do not have to remember whether you did. Steps, under the name, ends with Raise it from a Trigger. That step ticks once a Trigger raises this Background, and names the Chapters those Triggers sit in. Folded, Steps shows only the next thing to do. Pressing it shows them all.
How do I take a Background off again when the scene ends?
With another Trigger. The Background list inside a Trigger result starts with a special entry, "Remove the background". A Trigger set to it where the scene ends puts the page back to plain.
Otherwise the Background follows the Reader into the next Chapters. A cellar set in chapter three is still there in chapter nine. Raising a different Background replaces it too.
What does the last step, Raise it from a Trigger, count, and why is it not ticked yet?
It counts the Triggers in this book whose result raises this Background. Not ticked means no Trigger does yet. Ticked, it names the Chapters those Triggers sit in. A Chapter with more than one gets a count.
Only a Trigger ticks it, because only a Trigger can be set to raise a Background. A reply in a Dialogue Template cannot, and neither can what happens after a roll or a fight. Some older roll or fight results still raise one. The step names those too, ticked or not.
The step cannot tick until the Background has been saved once. A Trigger picks a Background by name from a list, and an unsaved one is not on it yet.
This window's own settings
Why is my picture forced into a square?
Every Background is composed in one square, so it means the same thing on every screen. Phones show a tall slice of it and desktops a wide one. The dashed Phone and Desktop boxes on the picture show which slice each keeps.
Frame, above the picture, lets you drag and zoom it until the square keeps what matters. What sits inside both boxes shows on every screen. While you drag, faint lines divide the square in thirds to help you balance the picture.
What do the dashed Phone and Desktop boxes do, and why can I press their labels?
Each box is the part of the square that kind of screen keeps. There is only one composition. What you leave inside the phone's box is what a phone shows, and the same goes for the desktop's.
The words on the picture are laid out for one screen at a time. Preview as, above the picture, picks the screen, and so does pressing a box's label. The other box is drawn fainter, so you can tell them apart.
"See it as a Reader", the button with an eye at the top of the window, shows it as a Reader gets it. The picture is cut to a phone or a desktop screen, with the words in your text area. There are no boxes and nothing to drag.
What is the "Text area" and do I need one?
Optional. It is a loop you drag on the picture to mark where your words go. The sample passage flows into it once it is drawn, so you can judge it. It works best over a quiet part of the picture, such as the sky, so the interesting part stays visible.
Without one, the words use the usual centred column over the picture. That suits a plain colour or a soft, even image. A picture with a face or a horizon in it is the one that needs a shape.
How do I redraw or move the shape? Dragging inside it moved it instead.
Dragging a dot reshapes it. Dragging from the middle moves the whole shape. A new loop started outside the shape replaces it. Clear text area removes it.
A freehand loop comes back as 8 dots on purpose, so it stays easy to edit. The words only ever follow the outline as horizontal bands, so finer detail would change nothing.
What does "About 58% of the sample passage fits" mean?
The canvas pours the sample passage, a fixed paragraph, into your shape. It is set at the Reader's real type size for the screen being previewed. The percentage is how much of the sample passage fits before the shape is full. A shape that is too small shows up here before your Readers find it.
A line above it may add that the longest line is narrow. Lines of 45 to 75 letters read comfortably for a whole page. Narrower is fine for a short passage.
Pour in, under the percentage, swaps the sample passage for your own writing. The percentage then measures what you poured in, and names it.
Can I see my own writing on the picture instead of the sample passage?
Yes. Pour in, under the picture while Text area is on, lists every Chapter in this book and every heading inside them. The longest paragraph in the section you pick goes into the shape you drew, at the Reader's real type size.
A heading takes everything under it, down to the next heading of the same size or bigger. Only one paragraph goes in, the longest. Your Reader gets each paragraph on a screen of its own, so the longest is the hardest test of the shape. A paragraph that runs past about a page is cut off. The line under the picture then says the start of it. That keeps the percentage a number you can compare between Backgrounds. A section you have not written yet says so, and the sample passage stays.
Nothing is saved and nothing about the Background changes. It is the same preview reading a different passage.
If a passage is longer than my shape, is it cut off?
No. The Reader gets it a page at a time, every page in the same shape, in the same place on the picture. Nothing is lost or squeezed.
A bigger area lets them see it in one go.
What are Image strength and Text backing, and why did they vanish when I chose Colour?
Two ways of keeping words readable on a picture. Image strength fades the whole picture towards a pale wash. At 100% the picture is as uploaded. Text backing leaves the picture alone and lays a see-through dark layer between it and your words. It starts at 40%, and 0% is no layer at all.
Both only make sense on a picture, so a flat colour hides them. There is nothing to fade, and a wash over a colour would only turn it into a different colour.
What is Text gap?
The breathing room between the edge of the shape you drew and the words inside it, measured on the Reader's page. It does nothing without a shape.
Set too high, it leaves no room for any text, and the canvas says so. A smaller gap or a bigger area fixes that.
What are Story text, Headings and Mentions under Your own story colours?
The three kinds of text on a page, so you can colour each for this Background. Left off, the Reader gets the usual near-white story text and white Headers with a soft shadow. That is what the words on the canvas show, and it suits most pictures.
Mentions are words in your prose linked to a Glossary Item, a name your Reader can tap to look up. They keep a different colour on purpose, so they can be spotted. That is why they get their own setting. This row only matters if your text mentions Glossary Items.
These help when the picture is pale or warm enough that near-white words disappear into it. Reset on any row puts it back to the usual colour.
Can I use a video? How long can it be?
Yes, through the same picker as a picture. It plays muted, on a loop, for as long as the scene lasts. A Reader who asked their device for reduced motion gets the first frame, held still.
A Background video can be at most 30 seconds. The window says so as soon as you pick a longer clip, and Save refuses it. A shorter clip, or a trimmed one uploaded again, gets through.
When something looks wrong
Why is the Save button greyed out?
The button says why when you hover over it or press it. It is one of five reasons. Nothing has changed since the last save. There is neither a picture nor a colour yet. The picture was deleted from your gallery. A colour code is not complete. The drawn shape is too small, too narrow, or crosses itself.
Two things do not grey the button. A colour that is hard to read on is your call. A video that is too long is refused when you press Save, with the reason.
Can I change a Background after it is published?
Not as it is. A published Background is locked, and its card in the list no longer opens. "Duplicate" makes a copy you can change. The published one changes in an Edition, started from your Published page. There it opens while the Edition works on the part it was published with, and saves like any other.
I deleted the picture from my gallery. What happens to the Background?
It is flagged, and Save is greyed until you choose another picture or switch to Colour. A Background is one picture or one flat colour, so those are the only two ways out. With neither, it shows your Readers nothing. The text area you drew is kept.
The list says "No picture yet" or "The picture was deleted" next to my Background.
That is the Background column on the card. "No picture yet" means this one has no picture, video or colour, so it has nothing to put on the page. Choosing one clears it, and a flat colour counts.
"The picture was deleted" is the flag from the question above. The book will not publish with it. The Words column beside it is not a warning. "Usual column" means you drew no shape, and "In the shape you drew" means you did.