app.notepad¶

Graphical text editor application with full file management and text selection.

Overview¶

app.notepad provides a windowed GUI text editor built on LVGL. It is registered with the desktop environment and launched from the application launcher. The editor supports opening, saving, and creating new documents via an integrated file picker dialog. Text selection is implemented manually on top of LVGL's textarea widget using a selection anchor and direct label selection API calls.

The application runs as a desktop program and creates an associated process entry visible in PS.

Dependencies¶

driver.video.desktop, driver.video.lvgl, driver.video, driver.video.windows
app.filepicker
driver.hid.keyboard
memory.heap
driver.storage.types, driver.storage.vfs
core.strings, io.syslog, debug.tracer
core.util, arch.x86.util
proc.mgr, proc.types

Constants¶

WIN_W / WIN_H¶

700 / 500 — Window dimensions in pixels.

TOOLBAR_H / STATUSBAR_H¶

40 / 24 — Heights of the toolbar and status bar in pixels.

FILE_BUF_SIZE¶

65536 — Maximum file read/write buffer size (64 KB).

LV_NO_SEL¶

$FFFF — Sentinel returned by LVGL when no text selection is active.

LV_EVT_STOP_OFF / LV_EVT_STOP_BIT¶

24 / 2 — Byte offset and bitmask used to set the stop_processing flag in an lv_event_t struct, preventing LVGL's default textarea key handler from also processing a key event.

Types¶

TNotepadState / PNotepadState¶

Per-instance state record allocated on the heap.

Field	Type	Description
`win_id`	`uint32`	LVGL window identifier
`pid`	`uint32`	Process ID of the associated notepad process
`ta`	`Plv_obj`	LVGL textarea widget
`status_label`	`Plv_obj`	Status bar label showing line, column, and filename
`dirty_label`	`Plv_obj`	Dirty-flag indicator label
`currentPath`	`pchar`	Heap-allocated path of the open file, or `nil` for untitled
`isDirty`	`boolean`	Whether the document has unsaved changes
`sel_anchor`	`sint32`	Byte offset of the selection anchor; `-1` means no selection

Functions and Procedures¶

init¶

procedure init();

Registers the application with driver.video.desktop under the name Notepad.

launch (internal)¶

Creates the LVGL window, toolbar (New, Open, Save, Save As buttons), main textarea, and status bar. Registers keyboard event callbacks and spawns the notepad process.

saveFile (internal)¶

Writes the textarea content to currentPath via VFS. Opens for read-write rewrite first; falls back to write-only new for new files. Shows an error message box on failure.

loadFile (internal)¶

Reads a file from VFS into the textarea. Resets dirty state and selection anchor after loading.

performNew (internal)¶

Clears the textarea, resets currentPath to nil, and updates the status bar.

updateStatusBar (internal)¶

Computes the 1-based line and column from the current cursor byte offset and updates the status label text.

buildSplicedString (internal)¶

Returns a new heap-allocated string with a range [from_idx, to_idx) replaced by an optional insertion string. Used for selection deletion and text replacement.

applyIndent (internal)¶

Applies or removes 4-space indentation from every line overlapping a selection range. Returns a new heap-allocated string.

Notes¶

Only one Notepad window may be open at a time. Closing with unsaved changes shows a discard confirmation dialog. The Shift+Arrow selection mechanism uses lv_label_set_text_selection_start/end directly rather than LVGL's built-in selection, because user key callbacks fire before the default widget handler, allowing stopEvent to suppress unwanted default behaviour.