Flags - for viewing and setting Wimp flags
by Graham Crow

Double-clicking on this application installs an application for viewing and setting Wimp flags.

The Wimp uses 32-bit flags to control various aspects of its operation; notably icons, windows, menus, and the Wimp poll. For example, the background colour of an icon is just one of many aspects governed by the value of the Icon flags.

Setting and altering the value of the flags can be tricky, since every bit is important, either as an individual value or in a group. This utility simplifies the process, giving a full display of the composition of the flags, and allowing all or part of them to be changed dynamically. Any display may be saved as a text file for printing or future reference.

Using Flags
-----------

Double-click on the application Flags to install it on the icon bar. The window opens showing the icon flags with an initial value of zero. To change the display to window flags, menu flags or poll mask, click on the appropriate radio button. The particular features of each are described below, but in every display the state of the flags may be altered in any of the following ways:
 
(1) Edit the hex value for Flags then press Return or click OK

(2) Edit any of the hex nibble values in the white vertical icons and press Return

(3) Click on any of the option icons for the individual bits.

Clicking on the word ADJUST causes any 'illogical' settings to be changed. For example, any 'reserved' bits are set to zero. The flags may be saved as a text file via the Save option in the menu.

To finish, close the window or (finally) click Menu on the icon bar menu, and choose 'Quit'.


Icon Flags (RISC OS 2 PRM pp. 1181-1182)
----------------------------------------

The menu allows you to enter the following values by clicking:
 
- button type (&0-&F)
- exclusive selection group (ESG) (0-31)
- foreground/background colours (&0-&F), when bit 6 is unset
- font handle, when bit 6 (anti-aliased) is set

  Clicking on the word ADJUST sets bit 0 (text) if either bit 6 (anti-aliased) or bit 9 (R justified) is set; and sets bit 1 (sprite) if bit 11 (half size) is set.
 
 
Window Flags (RISC OS 2 PRM pp. 1175-1177)
------------------------------------------ 
 
Clicking on the word ADJUST unsets bit 24 (back icon) and bit 25 (close icon) if bit 26 (title bar) is unset. If bit 31 (ignore 'Arthur only') is set then all Arthur-only bits are unset. All reserved and feedback bits (bracketed) are unset.

Menu Flags (RISC OS 2 PRM pp. 1226-1227)
----------------------------------------
 
Clicking on the word ADJUST causes all reserved bits (bracketed) to be unset.

 
Poll Mask (RISC OS 2 PRM pp. 1193-1194)
---------------------------------------

Clicking on the word ADJUST causes all reserved bits (bracketed) to be unset. Any bits for reason codes which may not be masked (2,3,7,9,10) are also unset.
 

 RISC User 1993
