AminetAminet
Search:
83627 packages online
About
Recent
Browse
Search
Upload
Setup
Services

util/cdity/ToolsMenu.lha

Mirror:Random
Showing:m68k-amigaosgeneric
No screenshot available
Short:Add tools to the Workbench Tools menu
Author:Kim Fastrup Larsen
Uploader:kimflarsen hotmail com (Kim Fastrup Larsen)
Type:util/cdity
Version:1.11.1
Architecture:m68k-amigaos >= 2.0
Date:2021-08-13
Download:http://aminet.net/util/cdity/ToolsMenu.lha - View contents
Readme:http://aminet.net/util/cdity/ToolsMenu.readme
Downloads:3828

New in version 1.11.1
---------------------

- Now includes German translation by Stefan Haubenthal.
- List can now be scrolled with the cursor keys if using
  Kickstart 3 or newer.


New in version 1.11
-------------------

- Now able to look for tools in the command search path even
  when started from the Workbench.
- Now comes with an installer that can also update an exist-
  ing installation without losing menu definitions.
- Added the DONOTWAIT tool type to the program icon so users
  won't get a confusing message from the Workbench when they
  boot.
- Will now scroll the list to make sure the menu item cur-
  rently being edited or moved is in view.
- More keyboard shortcuts.
- Messages can now be dismissed with the Esc key.
- Now checks for the presence of the CLI tool type.
- Documentation is (hopefully) more helpful now.

IT IS NO LONGER NECESSARY TO RUN TOOLSMENU FROM A CLI TO GET
FULL FUNCTIONALITY!

If you are currently running ToolsMenu from the User-startup
rather than WBStartup, do not forget to remove it from there
if you use the installer! To keep your current menu defini-
tions, copy your old ToolsMenu version into WBStartup before
using the installer. Just make sure the program name is
ToolsMenu and that the icon has the tool type DONOTWAIT.


What is ToolsMenu?
------------------

ToolsMenu is a commodity that will let you add tools and
projects to the Tools menu on your Workbench screen. Once an
item has been added, you can launch it by selecting it from
the menu. Any icons selected on the Workbench at that moment
become arguments for the launched tool.

For example, if you add MultiView, you can select the icon
of an image on the Workbench, then select MultiView from the
menu to view that image.

Tools will be run as if started by the Workbench. You will
not be able to open tools or projects that do not have
icons, nor tools or projects with the CLI tool type present
in their icons!

If the menu item is a project, the project icon's Default
Tool will be launched, and the project itself will become
the first argument.

ToolsMenu requires Kickstart 2 or newer. Full source code is
included.


Installation
------------

To have ToolsMenu start automatically whenever you boot your
system, simply run the installer included. This will install
ToolsMenu in SYS:WBStartup, or update it there if it is al-
ready installed. This will also install language files in
SYS:Locale/Catalogs for existing languages. The languages
currently provided are English, Danish, German and Italian.

You should reboot after installing to make sure the newly
installed program is running and using the updated language
files.

The behaviour of ToolsMenu can be adjusted via tool types in
the program's icon in your WBStartup drawer.

To prevent ToolsMenu from opening its window when it starts
up, set the following tool type:

 CX_POPUP=NO

The default hot key for bringing up the ToolsMenu window is
control alt t. You can change it by using the tool type
CX_POPKEY, like this:

 CX_POPKEY=<your hotkey>

Your menu definitions are stored in the icon as tool types,
so if you replace the icon, be aware that you will lose your
definitions!


Operation
---------

Adding items should be pretty self explanatory. Drag icons
into the window to add them, after which you can edit their
names if you like. You can also click the "New" button to
manually enter an item. You then write the name of the item
(as you would like it to appear in the menu) under the list,
and type in the full path of the tool or project over on the
right where it says "Tool". The path must include the name
of the tool or project.

You can move the currently selected item up and down using
the Edit menu. You can also sort the items alphabetically.
Note that the order of items will not be reflected in the
Workbench menu until you close the window.

ToolsMenu features keyboard shortcuts for its gadgets that
are mostly self explanatory. The one for the list, however,
may surprise in that, if an item is currently selected,
pressing the shortcut key will go to the NEXT item. This
lets you step through the items by alternating the shortcut
key with Enter/Return (to get out of the editing gadget).
You can hold shift to step in the opposite direction.

ToolsMenu can be iconified from the Project menu. In this
state, items can be added by dragging their icons onto the
commodity icon.

When you are happy with your selection of items, you must
remember to save them from the pull down menu. The defini-
tions will be saved as tool types in ToolsMenu's icon.

Please be aware that when you close the ToolsMenu window,
there can be a period of several seconds where not all menu
items are visible, as it can take some time to update the
menu.


Running ToolsMenu from a CLI
----------------------------

Should you wish to start ToolsMenu from a CLI, you can use
the CX_POPUP argument to prevent its window from opening.
For example:

 Run >NIL: <path>/ToolsMenu CX_POPUP=NO

When started from a CLI, ToolsMenu will wait for three sec-
onds before installing its menu items. This is to give Work-
bench time to initialize in case we are starting from the
User-startup or Startup-sequence.

If this proves to be too short of a delay (you don't see
your menu items after booting), you can specify a delay as a
number seconds. For example, to specify a delay of five sec-
onds, do this:

 Run >NIL: <path>/ToolsMenu CX_POPUP=NO DELAY=5

You can use DELAY=0 to prevent any delay.


Miscellaneous
-------------
Thanks go to Samir Hawamdeh and Stefan Haubenthal for their
translations, and to everyone who provided me with feedback
and helpful suggestions!

Check out some of my other Amiga software on Aminet:

Harmonics - mus/edit/harmonics.lha

- A simple additive synthesizer.

KoalaView - gfx/show/KoalaView.lha

- View and convert Commodore 64 images with authentic
  looking colors.

Labyrinth - game/misc/labyrinth64.lha

- Remake of the Commodore 64 game Labyrinth published by
  Commodore in 1983.

ScreenTime - util/time/ScreenTime.lha

- Highly configurable digital clock on any public screen,
  with locale support and calendar.

Space Invaders - game/shoot/spaceinv.lha

- Arcade perfect and system friendly.


History
-------

1.11.1 (Aug 13, 2021)

- Now includes German translation by Stefan Haubenthal.
- List can now be scrolled with the cursor keys if using
  Kickstart 3 or newer.

1.11 (Jul 23, 2021)

- Now able to look for tools in the command search path even
  when started from the Workbench.
- Now comes with an installer that can also update an exist-
  ing installation without losing menu definitions.
- Added the DONOTWAIT tool type to the program icon so users
  won't get a confusing message from the Workbench when they
  boot.
- Will now scroll the list to make sure the menu item cur-
  rently being edited or moved is in view.
- More keyboard shortcuts.
- Messages can now be dismissed with the Esc key.
- Now checks for the presence of the CLI tool type.
- Documentation is (hopefully) more helpful now.

1.10.2 (Sep 20, 2019)

- Now ignores case when sorting menu items.

1.10.1 (Sep 6, 2019)

- Now ignores case when parsing YES/NO values in tool types
  and command line arguments.

1.10 (Aug 30, 2019)

- When started from the Startup-Sequence (or any other CLI),
  ToolsMenu will now delay before installing its menu items,
  since Workbench may need time to initialize. If the de-
  fault delay of three seconds proves to be too short (or
  too long), a different one can be specified as a command
  line argument. One advantage of this delay is that you no
  longer need to place the Run command after LoadWB, and can
  therefore put it in User-Startup.
- Will now show a helpful error message if menu items cannot
  be saved.
- Fixed a bug when parsing the CX_PRIORITY command line ar-
  gument.

1.9.1 (Jun 11, 2019)

- Fixed an issue introduced in 1.8 where changes made to the
  Tool Types of ToolsMenu's icon would be undone if you were
  to save your menu definitions in the same session.

1.9 (Jun 2, 2019)

- It is now possible to add projects as well as tools. When
  selecting a project, the project icon's Default Tool will
  be launched with the project itself as the first argument.
- If ToolsMenu has been started from a CLI, it can now look
  through the command search path for tools.
- Will now look for the TOOLPRI tool type to set the execu-
  tion priority in the same way that Workbench does.
- Fixed potential null pointer dereferences in case
  ToolsMenu's icon has been replaced by a freshly created
  icon with no tool types.

1.8.1 (Feb 13, 2019)

- Fixed button shortcuts not working

1.8 (Feb 10, 2019)

- Menu items can now be moved up and down using commands in
  the Edit menu; in order to make this run at a reasonable
  speed on all Amigas, the order of items will not be re-
  flected in the Workbench menu until you close the Commodi-
  ty window
- The commodity can now be iconified from the Project menu;
  in this state, tools can be added by dragging their icons
  onto the commodity's icon
- New and Delete buttons can now have keyboard shortcuts
- About-requester can now be closed by pressing the left
  Amiga key with V or B, like system requesters
- Includes Italian catalog by Samir Hawamdeh

1.7 (Feb 5, 2019)

- Added a function to sort items alphabetically
- The commodity's menu shortcut keys can now be localized

1.6 (Nov 26, 2018)

- Minor UI adjustments
- New, "proper" requester for About
- Modularized the source code

1.5 (Jul 28, 2015)

- Busy pointer for Kickstart 2
- Optimized and cleaned up a few things, made code more
  portable

1.4 (Apr 22, 2015)

- Improved layout for big fonts.
- Added "About..."

1.3 (Feb 12, 2015)

- Fixed an issue that caused some commodities (and possibly
  other tools) to crash.

1.2 (Feb 3, 2015)

- Use the user's preferred screen font.

1.1 (Jan 19, 2015)

- Fixed an issue where trying to run a tool with an empty
  path would cause a Guru Meditation.

1.0 (Jan 12, 2015)

- Initial release


Contents of util/cdity/ToolsMenu.lha
PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]                  252     628  40.1% -lh5- 2c51 Aug 13 19:57 ToolsMenu.info
[unknown]                  411     656  62.7% -lh5- e723 Aug 13 19:57 ToolsMenu/Catalogs/dansk/toolsmenu.catalog
[unknown]                  446     718  62.1% -lh5- 9aef Aug 13 19:57 ToolsMenu/Catalogs/deutsch/toolsmenu.catalog
[unknown]                  486     782  62.1% -lh5- 2f11 Aug 13 19:57 ToolsMenu/Catalogs/italiano/toolsmenu.catalog
[unknown]                12641   35147  36.0% -lh5- 7994 Aug 13 19:57 ToolsMenu/gpl-3.0.txt
[unknown]                  246     477  51.6% -lh5- 7440 Aug 13 19:57 ToolsMenu/gpl-3.0.txt.info
[unknown]                  280     795  35.2% -lh5- 6593 Aug 13 19:57 ToolsMenu/Install
[unknown]                  207     836  24.8% -lh5- e67b Aug 13 19:57 ToolsMenu/Install.info
[unknown]                 4265   10809  39.5% -lh5- d505 Aug 13 19:57 ToolsMenu/ReadMe
[unknown]                  246     477  51.6% -lh5- 7f30 Aug 13 19:57 ToolsMenu/ReadMe.info
[unknown]                 1266    3049  41.5% -lh5- 72d3 Aug 13 19:57 ToolsMenu/Source/args.c
[unknown]                  647    1077  60.1% -lh5- 3db8 Aug 13 19:57 ToolsMenu/Source/args.h
[unknown]                 1465    3499  41.9% -lh5- b1cb Aug 13 19:57 ToolsMenu/Source/broker.c
[unknown]                  565     959  58.9% -lh5- 7296 Aug 13 19:57 ToolsMenu/Source/broker.h
[unknown]                  847    1594  53.1% -lh5- 55a9 Aug 13 19:57 ToolsMenu/Source/catalog.c
[unknown]                  569     933  61.0% -lh5- 678c Aug 13 19:57 ToolsMenu/Source/catalog.h
[unknown]                 1437    3349  42.9% -lh5- 3c73 Aug 13 19:57 ToolsMenu/Source/cli.c
[unknown]                  679    1140  59.6% -lh5- 23a8 Aug 13 19:57 ToolsMenu/Source/cli.h
[unknown]                 1091    2522  43.3% -lh5- fa3c Aug 13 19:57 ToolsMenu/Source/common.c
[unknown]                  834    1545  54.0% -lh5- cf15 Aug 13 19:57 ToolsMenu/Source/common.h
[unknown]                  569     939  60.6% -lh5- 175f Aug 13 19:57 ToolsMenu/Source/compiler.h
[unknown]                 1632    4904  33.3% -lh5- f903 Aug 13 19:57 ToolsMenu/Source/cx.c
[unknown]                  799    1562  51.2% -lh5- 5382 Aug 13 19:57 ToolsMenu/Source/cx.h
[unknown]                  639    1146  55.8% -lh5- a2f5 Aug 13 19:57 ToolsMenu/Source/dansk.ct
[unknown]                  674    1204  56.0% -lh5- a2ad Aug 13 19:57 ToolsMenu/Source/deutsch.ct
[unknown]                  885    1669  53.0% -lh5- dafc Aug 13 19:57 ToolsMenu/Source/error.c
[unknown]                  699    1171  59.7% -lh5- f811 Aug 13 19:57 ToolsMenu/Source/error.h
[unknown]                 6695   23213  28.8% -lh5- b90a Aug 13 19:57 ToolsMenu/Source/gui.c
[unknown]                  667    1219  54.7% -lh5- fd0e Aug 13 19:57 ToolsMenu/Source/gui.h
[unknown]                 2271    6903  32.9% -lh5- 594d Aug 13 19:57 ToolsMenu/Source/guitools.c
[unknown]                  715    1296  55.2% -lh5- be5e Aug 13 19:57 ToolsMenu/Source/guitools.h
[unknown]                 1740    4478  38.9% -lh5- 1420 Aug 13 19:57 ToolsMenu/Source/io.c
[unknown]                  572     943  60.7% -lh5- 2fd7 Aug 13 19:57 ToolsMenu/Source/io.h
[unknown]                 1330    3372  39.4% -lh5- d1f7 Aug 13 19:57 ToolsMenu/Source/lists.c
[unknown]                  854    1677  50.9% -lh5- 596e Aug 13 19:57 ToolsMenu/Source/lists.h
[unknown]                 1390    3785  36.7% -lh5- b41c Aug 13 19:57 ToolsMenu/Source/main.c
[unknown]                  486     782  62.1% -lh5- 2f11 Aug 13 19:57 ToolsMenu/Source/Resources/Catalogs/italiano/ToolsMenu.catalog
[unknown]                  287     581  49.4% -lh5- 9b51 Aug 13 19:57 ToolsMenu/Source/Resources/ToolsMenu.info
[unknown]                 2304    5906  39.0% -lh5- e7d9 Aug 13 19:57 ToolsMenu/Source/run.c
[unknown]                 1164    2407  48.4% -lh5- 4d80 Aug 13 19:57 ToolsMenu/Source/run.h
[unknown]                  113     155  72.9% -lh5- 9431 Aug 13 19:57 ToolsMenu/Source/SCOPTIONS
[unknown]                  787    2138  36.8% -lh5- e63f Aug 13 19:57 ToolsMenu/Source/smakefile
[unknown]                  890    1678  53.0% -lh5- 024d Aug 13 19:57 ToolsMenu/Source/snprintf.c
[unknown]                  844    1490  56.6% -lh5- 58d4 Aug 13 19:57 ToolsMenu/Source/snprintf.h
[unknown]                  843    1638  51.5% -lh5- af37 Aug 13 19:57 ToolsMenu/Source/toolsmenu.cd
[unknown]                 2944    8901  33.1% -lh5- 7270 Aug 13 19:57 ToolsMenu/Source/wb.c
[unknown]                  604    1071  56.4% -lh5- 5414 Aug 13 19:57 ToolsMenu/Source/wb.h
[unknown]                 9377   15044  62.3% -lh5- bc92 Aug 13 19:57 ToolsMenu/ToolsMenu
[unknown]                  287     581  49.4% -lh5- 9b51 Aug 13 19:57 ToolsMenu/ToolsMenu.info
[unknown]                 2328    2328 100.0% -lh0- e97f Aug 13 19:57 ToolsMenu/ToolsMenu_ITA.lha
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        50 files   74269  175173  42.4%            Aug 14 02:43

Aminet © 1992-2021 Urban Müller and the Aminet team. Aminet contact address: <aminetaminet net>