DefineStatusAreaFlags

From WikiPrizm
Jump to: navigation, search


Synopsis

Header: fxcg/display.h
Syscall index: 0x02B8
Function signature: int DefineStatusAreaFlags(int P1, int flags, void* P3, void* P4)

Defines what items are to be shown on the status area.

Parameters

  • P1 - If 0, the syscall will set the char system variables at 0x8804F48C and 0x8804F48D to 7, and the status flags to 0, while ignoring flags, P3 and P4.
    If 1, it will set the char system variables at 0x8804F48C and 0x8804F48D to 7, and the status flags to 0x303, while ignoring flags, P3 and P4.
    If 2 and P3 is not null, the char system variable at 0x8804F48C is returned in *P3; if 2 and P4 is not null, the char system variable at 0x8804F48D is returned in *P4. Whenever P1 is 2, flags is ignored.
    If 3 and P3 is not null, the char system variable at 0x8804F48C is set to *P3; if 3 and P4 is not null, the char system variable at 0x8804F48D is set to *P4. Finally, and still assuming P1 is 3, the status-icon-display-flags are set to flags.
    If 4, the status flags are set to be the result of (current flags | flags) (OR operation - this results in setting any previous flags plus the ones set in flags).
    If 5, the status icon display flags are set to be the result of ~(current flags & flags) (NAND operation - this results in setting all the previous flags minus the ones set in flags).
  • flags - status area flags to operate with, when P1 is 3, 4 or 5. See the end of this page for a table of valid flags.
  • P3 and P4 are pointers to buffers that will be copied to system variables or will receive their contents, depending on each of the pointers being null or not, and on the values of P1.

Example

The following line of code will set the following items to appear on the status bar: the battery meter, text (to be set with DefineStatusMessage), custom glyphs (to be set with DefineStatusGlyph) and the keyboard input method (shown to the right of the battery icon when any Alpha, Clip or Shift mode is enabled).

DefineStatusAreaFlags(3, SAF_BATTERY | SAF_TEXT | SAF_GLYPH | SAF_ALPHA_SHIFT, 0, 0);

Appendix

Table of status bar flags:

define value meaning
SAF_BATTERY 0x0001 Battery icon
SAF_ALPHA_SHIFT 0x0002 Alpha/Shift/Clip keyboard modifier indicator
SAF_SETUP_INPUT_OUTPUT 0x0004 Input/Output mode (Math or Line)
SAF_SETUP_FRAC_RESULT 0x0008 Fraction display mode
SAF_SETUP_ANGLE 0x0010 Angle (trigonometry) mode
SAF_SETUP_COMPLEX_MODE 0x0020 Complex number mode (Real, a+bi, r<O)
SAF_SETUP_DISPLAY 0x0040 Number display mode (Norm1, Norm2, Fix, Sci...)
SAF_TEXT 0x0100 Custom text, to be set with DefineStatusMessage
SAF_GLYPH 0x0200 Custom glyph, to be set with DefineStatusGlyph