Scenes and Visuals

Kx Markdown supports both visuals and scenes.

They overlap in purpose, but they represent different levels of visual content.

A useful distinction is:

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

Use a Visual

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

For example:

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

The clock itself is the visual content needed for the exercise.

Other examples include numbers, calendars, spelling displays, and individual objects.

Use a Scene

Use a scene when the visual represents an environment or composition.

For example:

- ¿Qué ves? [fscene:office]

The office can contain a background and multiple positioned objects that together form one environment.

Practice Set Context

Scenes also have a capability that ordinary line visuals do not: a scene can belong to the Practice Set itself.

[scene:office]

This lets one environment remain available while the learner moves through several practice lines.

Generated State

A Practice Set scene can also participate in generated practice when its resolved state is shared with a question set.

That allows the displayed scene and generated answer to describe the same state.

See Generated Scenes.

Choosing Between Them

Choose a visual when the learner needs one object, diagram, display, or other focused visual.

Choose a scene when the learner needs an environment, composition, or persistent visual context.

Choose a Practice Set scene when several practice items should share that context.

Choose a line scene when the scene belongs specifically to the front or back of one card.