Skip to content

Wide screen

The DS has two 256 × 192 screens, one above the other. On a desktop monitor that is a tall, narrow shape with a lot of black around it. PokeLoom can instead show a game on desktop as one wide picture that fills a 16:9 display, so it feels like a desktop game. The DS build is always the DS: two screens. The wide form is desktop only, and the two-screen form stays the default and the reference for feel (decisions 70, 72).

The wide picture is a canvas of 320 × 180 pixels, scaled by a whole number to the display:

Scale Display
×4 1280 × 720
×6 1920 × 1080
×8 2560 × 1440
×12 3840 × 2160

Other shapes are letterboxed. Two reasons fix the size:

  • Whole numbers. 320 × 180 divides every common 16:9 resolution exactly, so every pixel of the art is a square of screen pixels and stays crisp.
  • The DS’s scale. At one unit of the world a pixel, the canvas shows 20 × 11¼ cells where the DS shows 16 × 12. Characters, tiles and textures are the same size as on the DS, so one set of art serves both. A larger canvas, such as 480 × 270, would draw everything at half or a third of its size and need different art.

The 3D field is drawn at the canvas’s resolution, with the same pixel look as on the DS. Drawing it sharper is a separate matter of the presentation settings.

Part Two screens (ds) One screen (wide)
The field the top screen, 16 cells across the whole canvas, 20 cells across, with the same tilt and scale
What is drawn around the player ground and props within the DS’s reach a little further to each side, inside the same loaded chunks
The text box the bottom of the top screen the bottom of the canvas, the same box widened, with the same lines, speed and behaviour
Yes or no, a script’s choices above the text box’s right end the same rule
The Start menu at the right edge of the top screen at the right edge of the canvas
The options screen on the top screen across the canvas, centred
The touch screen the lower screen not shown

The 3D view, the culling of what is drawn and the layer maps all take their size from the form, so the world beyond the DS’s edges is drawn, never stretched.

Everything is reachable with the keys or a gamepad alone. Nothing in the field needs the pen on the DS either, so nothing is lost.

Planned (plan 16): the Start menu sliding in from the right as a panel; the pointer acting on whatever is under it; menu screens with their two areas side by side (list on the left, detail on the right) or centred over a dimmed field; a battle whose scene fills the canvas, with the action and move menus as panels over the text box, and doubles shown wider than the DS can.

Planned (plan 45): menu records laid out on a canvas, ds or wide, with a [profile.wide] part of a record moving what needs to move; a DS pack carries only ds.

The wide form changes what is drawn where, and nothing else. Game logic, maps, scripts, data, battles, saves and timing are identical in both forms. Every checked-in input log is replayed in both and must give the same game. Feel measured from the originals (text speed, menu timing, walking speed) applies to both.

On the DS the form costs nothing: the platform answers “two screens” as a constant, so the compiler leaves out every wide table and branch.

On desktop the form is chosen when the program starts:

--profile wide one 320 × 180 screen, full screen by default
--profile ds the two DS screens, in a window (the default)
--windowed, --fullscreen, --scale N

F11 switches between full screen and a window, and the choice is kept in the config file for the next run. The test programs refuse the wide form: the DS comparisons are of the two-screen form.

Planned (plan 16): a project states the forms it supports, ["ds"] (the default), ["wide"] or both. A DS ROM can only be built from a project that includes ds, and the build says so clearly. Maps, sprites, scripts and data are authored once; menu skins and battle backgrounds get a wide form where they need one. Until then any game can be run in either form on desktop.

The widescreen presentation row is a different thing: it widens the 3D view inside the two-screen layout to 16:9 or 21:9, keeping the lower screen. It is planned (plan 42). The wide form replaces both screens with one canvas.