Status Bar

The status bar with no project open: a red tB Services: UNAVAILABLE badge and a red tB Licence: NOT READY badge at the left, each with a warning triangle, then the Ko-fi, Discord, Twitter and GitHub icons, and dimmed text reading tbProject_Close at the far right.The status bar with no project open: a red tB Services: UNAVAILABLE badge and a red tB Licence: NOT READY badge at the left, each with a warning triangle, then the Ko-fi, Discord, Twitter and GitHub icons, and dimmed text reading tbProject_Close at the far right.

With no project open, no compiler is connected: the services badge reads UNAVAILABLE and the licence badge reads tB Licence: NOT READY. Both change once a project has loaded and the compiler has answered.

The Status Bar runs along the bottom of the IDE window. From left to right it holds the services badge, the licence badge, the links to community resources, a PROCESS box for each program that your program started, the progress bar, the command name, the memory box and the line and column box. The progress bar, the memory box and the line and column box show only in some states.

The status bar cannot be hidden. It is not a panel, so no panel layout removes it, Full Screen Editor Layout included, and no option or command hides it. The one option that changes it is Show memory and resource usage, which adds the memory box.

Services

A red status bar badge with a warning triangle, reading tB Services: UNAVAILABLE.A red status bar badge with a warning triangle, reading tB Services: UNAVAILABLE.
The tooltip that badge shows on hover, four lines giving COMPILER, FS, LSP and DEBUGGER each as Not initialized.
An olive status bar badge, orange in the light theme, with a warning triangle, reading tB Services: LIMITED.An olive status bar badge, orange in the light theme, with a warning triangle, reading tB Services: LIMITED.
A green status bar badge with a tick, reading tB Services: OPERATIONAL.A green status bar badge with a tick, reading tB Services: OPERATIONAL.
The tooltip that badge shows on hover, four lines giving COMPILER, FS, LSP and DEBUGGER each as OPERATIONAL.

The badge’s tooltip has one line for each of the four connections between the IDE and the compiler: COMPILER, FS (the project’s files), LSP (the editor’s language features, over the Language Server Protocol) and DEBUGGER. Each line gives that connection’s state:

  • Not initialized — the connection has not been made, because no project has loaded since the IDE started;
  • Connecting or Disconnecting — the connection is being opened or closed;
  • OPERATIONAL — the connection is open;
  • Disconnected — the connection has closed, as it has after Close Project;
  • Error occured — the connection failed. The IDE spells it this way.

The badge reads OPERATIONAL when all four are open, LIMITED when one to three are open, as they are for a moment while a compiler starts, and UNAVAILABLE when none is. A running program does not change it. The badge cannot be clicked. Compiler services says what to do when it does not return to OPERATIONAL, and what a crash looks like.

Licence

The licence badge reads tB Licence: NOT READY until the compiler answers. After that it reads the edition alone, without the prefix:

The badge reads Look Meaning
PERSONAL EDITION green, with a tick A Personal licence.
PROFESSIONAL EDITION green, with a tick A Professional licence.
ULTIMATE EDITION green, with a tick An Ultimate licence.
COMMUNITY EDITION orange or olive, with a warning triangle No key, an invalid key, or any other answer.
An olive status bar badge, orange in the light theme, with a warning triangle, reading COMMUNITY EDITION.An olive status bar badge, orange in the light theme, with a warning triangle, reading COMMUNITY EDITION.

Pointing at the badge shows the edition again. Clicking it opens the Enter Licence Key dialog, once a project is loaded; Help → Enter Licence Key… opens the same dialog at any time, and Help → Purchase A Licence… opens the pre-order page. First launch describes the dialog and the editions.

When the compiler reports that a licence has expired or has been revoked, the badge keeps its text, and a box titled Licence Problem! says so. The licence lists what else can go wrong.

Four icons in the status bar, after its badges: a Ko-fi coffee cup holding a heart, the Discord face, the Twitter bird and the GitHub cat.Four icons in the status bar, after its badges: a Ko-fi coffee cup holding a heart, the Discord face, the Twitter bird and the GitHub cat.

A click on an icon opens a page in your default browser. Nothing opens inside the IDE.

  • Ko-fi: https://ko-fi.com/twinbasic
  • Discord: https://discord.gg/UaW9GgKKuE
  • Twitter: https://twitter.com/waynephillipsea
  • GitHub: https://github.com/twinbasic/twinbasic — the repository’s front page, not the form for a new issue

The same four are items of the Help menu. See Reporting a problem.

Other boxes

  • PROCESS boxes — one green box, PROCESS <pid>: RUNNING, for each program that your program started. See Programs that your program starts.
  • The progress bar — a bar with the compiler’s own text on it. It shows only while the compiler reports progress, for example while LLVM compiles.
  • The memory box — <n>MB in use | <n> ui objects | <n> gdi objects, the figures of the running program. It shows only when the IDE Option IDE: Show memory and resource usage is on and a project is loaded. See IDE Options.
  • The line and column box — Ln <n>, Col <n>, shown only while a code editor is the active tab. A click opens the editor’s own box for going to a line. It is hidden for a form designer, an image’s preview and a Settings editor.

The four counters of errors, warnings, hints and infos are not in the status bar. They are in the header of the DIAGNOSTICS panel.

Status

The region left of the memory box names the command a click would trigger — the command under the mouse cursor. It gives the IDE’s internal command identifier rather than the menu caption, so pointing at Close Project on the File menu shows tbProject_Close, as in the screenshot at the top of this page.

The name goes when the pointer leaves the icon or the menu item. It stays only when the item goes away under the pointer: a menu that closes on a click or on Esc leaves the name of the last item it showed, until the pointer enters another item that has a command.

These are the same identifiers the keyboard shortcut map is keyed by — see Keyboard Shortcuts for the list and the keys bound to each one.

See Also