Practice Set Scenes

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

Declare it in the Practice Set metadata:

[scene:office]

Persistent Context

For example:

[id:office-vocabulary]
[cat:office, vocabulary]
[scene:office]

- ¿Qué hay en la oficina?
- ¿Dónde está el escritorio?
- ¿Hay una silla?

The same office remains available as visual context while the learner moves through the Practice Set.

This is useful when several questions refer to the same environment.

Image-Only Scenes

An image can serve directly as the Practice Set scene.

Kx image assets follow this form:

public/assets/<language>/<path>.png

The corresponding scene name uses:

image.<language>.<path>

For example:

public/assets/es/ch2/book-1.png

becomes:

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

Nested paths follow the same pattern.

For example:

public/assets/es/ch5/restaurant/menu-2.png

becomes:

[scene:image.es.ch5.restaurant.menu-2]

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

Composed Scenes

A registered scene can represent a composed environment.

For example:

[scene:office]

might resolve an office containing a background, furniture, and other objects.

The Practice Set refers only to the scene name. The scene definition is responsible for assembling and presenting the environment.

Authored Practice Lines

A Practice Set scene does not imply generated questions.

This is valid:

[id:book-image-practice]
[cat:book, image]
[scene:image.es.ch2.book-1]

- ¿Qué ves?
- ¿Cuántas personas hay?
- Describe la imagen.

The scene supplies persistent visual context.

The Practice Set supplies its own authored practice content.

Generated Practice

Some Practice Set scenes can also participate in generated practice.

In that case, the scene’s resolved state can be shared with a question system so that the displayed scene, generated question, and generated answer agree.

That behavior is explicit rather than automatic.

See Generated Scenes for details.

Practice Set Scene vs. Line Scene

A Practice Set scene remains outside the individual practice card.

A line scene belongs to one card face.

Conceptually:

Practice Set scene
      │
      │ persistent context
      │
      ├──────────────┐
      │              │
    Front           Back
    fscene           bscene

The Practice Set scene establishes the larger environment while individual practice lines can provide their own more focused scene presentations.