Scenes

Scenes provide visual context for a Practice Set.

A scene can be as simple as an image or as rich as a composed environment containing a background, objects, and generated state.

Kx Markdown supports scenes at two levels:

Practice Set
└── scene

Practice line
├── fscene
└── bscene

The distinction is important.

A Practice Set scene establishes visual context for the Practice Set as a whole.

A front or back scene belongs to one side of an individual practice card.

Practice Set Scene

Use scene in the Practice Set metadata:

[id:office-practice]
[cat:office]
[scene:office]

- ¿Qué ves?
- ¿Dónde está la silla?

The office scene remains visible while the learner works through the Practice Set.

Several practice lines can therefore refer to the same visual environment.

See Practice Set Scenes for details.

Front Scene

Use fscene when a scene belongs to the front of one practice line:

- ¿Qué ves? [fscene:office, ans: "Describe what you see."]

The scene appears with the front of the card.

When the card flips, the front scene flips away with the front content.

Back Scene

Use bscene when a scene belongs to the back:

- Describe la oficina. [bscene:office, ans: "La oficina."]

The scene appears with the back of the card.

Different Front and Back Scenes

A practice line can use different scenes on its two sides:

- ¿Qué cambió? [fscene:image.es.ch2.book-1, bscene:image.es.ch2.book-2, ans: "Describe lo que cambió."]

The first scene appears on the front.

After the card flips, the second appears on the back.

See Line Scenes for details.

Scene Types

Scenes can represent different kinds of visual content.

Image-Only Scenes

An image can serve directly as a scene:

[scene:image.es.ch2.book-1]

or:

- ¿Qué ves? [fscene:image.es.ch2.book-1]

Image-only scenes preserve the natural aspect ratio of their source image.

Composed Scenes

A composed scene combines a background with positioned objects.

An office scene, for example, might contain:

• an office background
• a desk
• a chair
• a phone
• books
• a stapler
• an in/out box

The Practice Set does not need to describe how these pieces are assembled.

It simply refers to the registered scene:

[scene:office]

The scene definition controls its composition and presentation.

Generated Scenes

Some Practice Set scenes can resolve generated state and use that same state to produce matching practice content.

For example, a generated clock can display a particular time while the generated question and answer refer to that same time.

See Generated Scenes for details.

Greater and Lesser Scenes

It can be useful to think of Kx scenes at two levels.

The Practice Set scene is the greater scene:

[scene:office]

It establishes the larger visual environment.

Line scenes are lesser scenes:

fscene:office
bscene:office

They participate in an individual card:

Front
├── fscene
└── front content

Back
├── bscene
└── back content

The front scene disappears when the front flips away. The back scene appears with the back.

The greater Practice Set scene remains outside the card and continues to establish the larger context.

Scenes and Visuals

Scenes and visuals are related, but they serve different purposes.

A useful distinction is:

visual = an individual visual object or display
scene  = an environment or composition

For example, a clock display can be a visual:

- ¿Qué hora es? [visual:clock.01-15]

An office environment can be a scene:

- ¿Qué ves? [fscene:office]

See Scenes and Visuals for more guidance.

Choosing a Scene Form

Use [scene:] when the visual environment belongs to the Practice Set as a whole.

Use fscene: when a scene belongs specifically to the front of one practice card.

Use bscene: when a scene belongs specifically to the back of one practice card.

Use a generated Practice Set scene when the scene’s resolved state needs to drive generated questions and answers.

Use a visual when a single visual primitive or display is sufficient.