Short:        Convert numbers between bin/oct/dec/hex
Author:       Kim Fastrup Larsen
Uploader:     kimflarsen hotmail com (Kim Fastrup Larsen)
Type:         util/wb
Version:      1.2.1
Architecture: m68k-amigaos

New in version 1.2.1
--------------------

- Will now suppress DOS requesters asking to insert ENV: or
  ENVARC: if these are not mounted.
- Now activates a "busy" state while saving settings.
- Fixed not checking whether atexit succeeds.
- For those interested in the source code, the requester
  code now lays out buttons like EasyRequest, ie. equally
  spaced apart.


Base Converter
--------------

This is a little Workbench utility that lets you convert
numbers between binary, octal, decimal and hexadecimal. Sim-
ply enter a number in one of the string gadgets, press the
Return key, and the other three will be updated.

Using the settings menu, you can choose, for each base,
whether the current number should be displayed as a signed
or unsigned value.

When you save your settings, the size and position of the
window is saved as well.

The program was designed for Kickstart 1.2/1.3, but runs
cleanly on later releases, and when doing so will take ad-
vantage of certain features, such as tab cycling, input fil-
tering and new look menus. You can also specify the public
screen upon which you want the utility to appear, and it
will use the font of whatever screen on which it is running.

The program can also be localized on Workbench 2.1 or later.
A translation to Danish is included.


Source code included
--------------------

This program is written in C with a bit of assembler as
well. Full source code is included. In fact, one of the main
purposes of this release is to provide quality source code
to anyone trying to write similar tools for the Amiga, or as
a sort of document on how such programs work.

I originally wrote a simple version of this utility way back
in the early 1990s (never released), but have rewritten it
completely to incorporate what I've learned over the years
about writing modular, reusable and adaptable code.


Configuration
-------------

You can use the SETTINGS tool type or Shell argument to
specify a file or directory in which settings should be
saved (and from which they will be loaded if found).

On Kickstart 2 and later, you can use the PUBSCREEN tool
type or argument to specify the public screen on which you
want to program's window to open.


More stuff
----------

I have released several projects on Aminet. Almost all of
them include source code, but the newer ones are probably
the most useful, so allow me to highlight them here.

ScreenTime - A highly configurable screen clock with a popup
calendar:

 https://aminet.net/package/util/time/ScreenTime

ToolsMenu - Add tools and projects to the Workbench Tools
menu with a simple graphical user interface:

 https://aminet.net/package/util/cdity/ToolsMenu

Labyrinth - Remake of a Commodore 64 game:

 https://aminet.net/package/game/misc/labyrinth64

You can get a list of all my projects with this link:

 https://aminet.net/search?readme=kimflarsen


History
-------

1.2.1 (Jul 21, 2024)

- Will now suppress DOS requesters asking to insert ENV: or
  ENVARC: if these are not mounted.
- Now activates a "busy" state while saving settings.
- Fixed not checking whether atexit succeeds.
- For those interested in the source code, the requester
  code now lays out buttons like EasyRequest, ie. equally
  spaced apart.

1.2 (Jun 28, 2024)

- Gadget labels now indicate a gadget's shortcut key by
  underlining a character à la GadTools.
- Now works better on public screens with unusual pen ar-
  rangements.
- Now updates the font used for menus when preferences are
  changed on Workbench 1.2/1.3.

1.1 (May 30, 2024)

- Now refreshes the window when preferences are changed on
  Workbench 1.2/1.3.

1.0 (May 10, 2024)

- Initial release.