VR presentations

A VR presentation is a walk through a 3D space: each slide is a round platform with its words on a card, and the viewer moves from one platform to the next. You write the slides as Markdown, and draw the platforms on the plan (or leave the plan empty and they are laid out for you). Each example below is real: in Jollify, Insert puts it in the script you are writing, at the cursor.

Slides are headings

Each # heading is a slide: its own platform, with the heading and the lines under it on its card. The slides are visited in the order they are written.

# Welcome

This tour takes five minutes.

# The collection

Three rooms, one for each century.

Try it in Jollify

You get two platforms, "Welcome" first, with a card on each.

Sub-slides

A ## heading under a # is a sub-slide: its own platform, placed near its parent's and a little higher, visited straight after it. Sub-slides of the same slide stand side by side.

# The planets

Four rocky ones close to the Sun.

## Mercury

The smallest planet.

## Venus

The hottest planet.

Try it in Jollify

You get "The planets", then Mercury and Venus beside each other just past it.

Choose a height

Add {level=…} to a heading to set how high its platform stands: 0 is the ground, and each step up is one level higher.

# Down on the forest floor {level=0}

Hardly any sunlight reaches down here.

# Up in the treetops {level=2}

This is where most of the animals live.

Try it in Jollify

You get the first platform on the ground and the second two levels up. The {level=2} does not show on the card.

What goes on a card

A card takes the same Markdown as a deck's slide: bold, italic, lists and links. Keep it short: it is read standing up, from a metre away.

# Opening times

- **Weekdays:** 10am to 5pm
- **Weekends:** 10am to 6pm

Entry is *free*.

Try it in Jollify

You get a card with a two-line list and a sentence under it.

A scene for a slide

A line ![scene](presets/…) under a heading puts a ready-made scene round that slide's platform. There are five: basic (nothing added: the card is the slide), solar-system (the Sun and four planets ahead of you), gallery-room (a room round the platform, open towards the next stop), classroom (desks either side and a whiteboard beyond the card) and forest-clearing (a clearing with trees round it, open towards the next stop). Insert › Scene adds the line for the slide under the cursor.

# The Solar System
![scene](presets/solar-system)

The Sun holds nearly all of the Solar System's mass.

# The gallery
![scene](presets/gallery-room)

Our newest room.

Try it in Jollify

You get the Sun and planets round the first platform, and a room round the second.

A 360° photo round a slide

A slide's scene can be a 360° photo from your files: one taken all the way round, twice as wide as it is high. While the viewer stands on that platform, the photo is all round them. Insert › Scene › 360° photo… picks it and writes the line.

# On the beach
![scene](photos/beach.jpg)

Listen to the waves.

Try it in Jollify

You get a platform with the beach all round it. The photo travels with the presentation when you export it.

A slide can stand in a plan of your own too. In Insert › Scene, choose Draw a new plan… and draw rooms, walls, trees and the rest with the same tools as a Virtual layout. Change a plan opens it again later, and Rename a plan gives it another name (the slides that use it follow). Or pick one of your Virtual layouts, or Plan from a file… for an annotated .svg. Plans you draw here stay in this presentation and travel with its package. The plan is drawn with its middle on the slide's platform, so leave room for the platform and its card there. If a building or anything else solid stands over the platform, a door doesn't get through its wall, or the plan reaches another platform, a warning at the foot of the page says so. A layout is found by its name: rename it, and the slide's line needs changing too.

Moving round

The viewer moves by looking at the next platform's ring and holding still for a moment, by clicking it, or with Previous and Next over the scene. There is nothing to write for this: every VR presentation has it.

Put it online

Export › Put it online… downloads the presentation as a website, with the steps for three hosts that put a website online. Paste the address the host gives you and you get a QR code for it: scan it with a phone or a headset to open the presentation, or Download the code to print it for a class. On a headset, choose Enter VR in the scene. Headsets need an address that starts https:// (all three hosts give one).

Platforms on the plan

Draw a Platform on the plan to place a slide yourself; its Slide field in the inspector says which slide it shows. Slides with no platform drawn carry on along a path past the drawn ones, so a plan can place only the slides that matter and leave the rest.