M68K Trap Tasks

Displays D1.W characters of the string at (A1), at most 255, stopping early at a NUL, then a new line. See task 13 for the NUL terminated form.

Displays D1.W characters of the string at (A1), at most 255, stopping early at a NUL, without a new line. See task 14 for the NUL terminated form.

Reads a line of input, typed in the console, or on the screen once the program has used it, and ended with Enter; a testcase answers it from its scripted input. Its first 79 characters are stored, then a NUL (zero byte). Text is converted to Windows-1252, a single-byte encoding; a character it cannot represent is stored as ?.

Displays D1.L in decimal, in the smallest field it fits. See tasks 15 and 20.

Reads a line and converts it by skipping leading spaces, reading an optional sign, then taking digits up to the first other character. 12abc is 12, and a line with no number, an empty one included, is 0, never an error.

Reads one key as soon as it is typed, without waiting for Enter, in the console or on the screen once the program has used it. Enter is $0D. Check task 7 first to poll instead of waiting.

Displays one character.

Ends the program.

The text cursor is where printed text lands, in character cells counted from the top left. Clearing with $FF00 clears text and graphics together, since they share one image, and homes the cursor. Positions outside the screen are clamped to it.

Whether input read by tasks 2, 4, 5 and 18 is echoed in the console and on the screen. With echo off, a line read still moves to a new line when Enter ends it, and a key read shows nothing. Echo is on when a program starts, and Undo restores the previous setting.

Displays the NUL terminated string at (A1), then a new line.

Displays the NUL terminated string at (A1) without a new line.

Displays D1.L as an unsigned number in the base in D2.B, using upper case digits past 9: 255 in base 16 is FF.

Controls the prompt shown while input is waiting and whether a key read of Enter adds a line feed. The waiting prompt appears as a caret and question in the console; the screen does not draw a flashing cursor. Without the line feed, Enter takes the screen text cursor back to the start of its line. Line and number reads always start a new line when Enter ends them, even with echo or line-feed settings off. Both settings are on when a program starts, and Undo restores the previous setting.

Task 14 then task 3: the NUL terminated string, then the signed number.

Task 14 then task 4: the NUL terminated string as a prompt, then a number.

Task 3 right justified in a field D2.B columns wide. D2.B is signed, and a negative width left justifies the number in a field that wide instead. A number too long for the field is displayed in full.

Resizes the screen and clears it. The minimum is 640 by 480, which is also the size a program starts with. Windowed and full-screen requests are accepted and ignored because the screen is an editor panel.

The color lines, outlines, pixels and text are drawn in.

The color the insides of rectangles and ellipses and a flood fill are drawn in.

One pixel in the pen color. The pen width does not apply and the drawing point does not move.

Reads the pixel of the image being drawn on, which with double buffering is the off screen one. Outside the screen it answers with the background color.

A line in the pen color, leaving the drawing point at X2, Y2.

A line in the pen color from the drawing point to X, Y, which becomes the new drawing point: a polyline is one task per point.

Moves the drawing point without drawing.

Filled with the fill color and outlined with the pen. The right and bottom edges are excluded, so a rectangle whose edges meet draws nothing.

The ellipse inscribed in that rectangle, filled with the fill color and outlined with the pen. A square bounding rectangle draws a circle.

Spreads the fill color from X, Y over every neighbouring pixel of the color that was there, four ways.

The outline of task 87 in the pen color, with nothing inside.

The outline of task 88 in the pen color, with nothing inside.

Mode 4 draws normally and is the default; mode 2 moves the drawing point without changing any pixel; mode 16 turns double buffering off and mode 17 turns it on, so drawing goes to an off screen image until task 94 shows it.

The width of lines and of the outlines of rectangles and ellipses. A single pixel (task 82) ignores it.

Shows the off screen image drawn under mode 17. With double buffering off it does nothing but ask for a repaint.

Draws the string in the pen color with its top left corner at X, Y, over whatever is already there, so a label can sit on a drawing. Control characters are ignored. Text printed with the text tasks lands at the text cursor instead (task 11).

Where the next line-to would start.

Polls without consuming anything: the character it reports is the one task 5 or task 2 reads next. A testcase reports its remaining scripted input the same way.

Reads whether up to four keys are held right now, one byte of the answer per key code in the same order; with D1.L = 0 it answers with the last key released and the last key pressed instead. A key held down is reported at least once however briefly it was tapped, so a polling loop never misses one.

Accepted and ignored: the screen panel already hands every key it takes to the program, so there are no simulator shortcuts to give up.

The pointer position is in screen pixels with the same origin drawing uses, whatever the panel’s zoom. The release and press states persist until the next one, so a program that polls slowly still sees every click; the double bit is only ever set on a press.

The time the program has been running, in hundredths of a second.

Lets D1.L hundredths of a second of program time pass. The editor stays responsive throughout, and the screen is repainted, so this is how an animation paces itself.

Closes every file the program has open.

Opens the existing File at the path at its start. D0.W is 0 when it opens for reading and writing, or 3 when it opens for reading only. A path with no File, a Directory, or a ninth open file is an error.

Creates the File at the path, or empties the one that is there, and opens it for reading and writing. The Directories on its path are created with it.

Reads up to D2.L bytes from the file’s position into the buffer, and moves the position past them. Fewer bytes than asked for is a success, with their count in D2.L; none at all is the end of the file, which leaves D2.L as it was.

Writes the D2.L bytes at (A1) at the file’s position, growing the File as needed, and moves the position past them. A write of no bytes, and one to a file opened for reading only, report 2.

Moves the file’s position to D2.L bytes from its start. A position past the end reads as the end of the file until a write there fills the gap with zeros; a negative one is an error.

Closes the file, so that its number can be given to the next one opened.

Removes the File at the path from the Project. A file the program still has open stays readable and writable through its number until it is closed.

Asks for the path of a File, for the program to open with task 51 or create with task 52. Cancel, or an empty answer, leaves (A3) alone and puts 0 in D1.L. A testcase answers it with its next scripted input.

Whether there is a File at the path. A Directory is not one, so it answers 2.