Short:        Menu/full-screen Workbench plasma
Author:       ShK
Uploader:     shk sci fi
Type:         gfx/misc
Version:      1.49
Replaces:     gfx/misc/PlasmaWB.lha
Requires:     AmigaOS 3.1+, Picasso96; 68k: 68020+ and FPU; PPC: WarpOS
Architecture: m68k-amigaos >= 3.1.0; ppc-warpup

PlasmaWB is an interactive and autonomous plasma trail effect for AmigaOS
Workbench and Picasso96 RTG screens.

It opens a resizable window on a public screen and renders a colourful,
CPU-generated glowing trail. The trail can follow the mouse or use one of
five evolving autonomous paths: Lissajous, Rose, Spiro, Orbit and Harmono.

Version 1.49 ships two binaries built from the same C source:

  PlasmaWB        68k (68020+ with FPU)
  PlasmaWB.ppc    PowerPC (CyberStorm/Blizzard PPC with WarpOS)

The animation is time-normalized, so faster machines render more frames of
the same motion. The final update uses a Picasso96 friend bitmap when
possible, allowing a board-local blit, with packed and true-colour fallback
paths.

Controls:

  Mouse move       Draw the trail when autonomous mode is Off
  A                Select the next autonomous mode
  Mouse wheel      Adjust autonomous speed while a mode is active
  Hold MMB + move  Adjust autonomous speed vertically
  Hold LMB         Temporarily use tighter trail spread
  Space            Toggle tighter trail spread
  F                Toggle FPS display/HUD where available
  R                Clear and reseed at the current control position
  Enter            Toggle full screen
  Esc              Quit windowed mode or leave full screen
  Q                Quit
  RMB              Leave full screen

Icon ToolTypes and equivalent Shell options:

  FullscreenMode=<DisplayID>
  StartFullScreen=On|Off
  ShowFPS=On|Off
  AutonomousMode=Off|Lissajous|Rose|Spiro|Orbit|Harmono
  AutonomousSpeed=25..400
  TrailWidth=Tight|Thin|Normal|Bold|Huge
  Fade=Fast|Normal|Slow

FullscreenMode accepts decimal, 0x hexadecimal or Amiga-style $ hexadecimal
DisplayIDs. It selects the mode used by Enter and Global/Full screen but does
not itself start full screen; use StartFullScreen=On for that. Option names
and named values are case-insensitive.

Installation:

  Copy the PlasmaWB drawer anywhere. Start the 68k binary from its icon or
  Shell. PlasmaWB.ppc intentionally has no icon and is started from Shell.

  PlasmaWB uses a 102400-byte stack cookie and should have a matching icon
  stack. PlasmaWB.ppc switches to its own internal 128 KB PPC stack.

Source code:

  The C source and dual-target GNU Makefile are included. README.txt contains
  full usage, ToolType, command-line and cross-compilation instructions.

Notes:

  PlasmaWB is intended for AmigaOS 3.x systems with Picasso96. The gradients
  look best in 24-bit or 32-bit modes; 16-bit modes show some banding. A
  screenshot is included in the archive.

History:

  1.00  First public release.
  1.02  Added a Picasso96 off-screen bitmap presentation path. When the
        bitmap is placed in board memory, the final window update can use
        the graphics board blitter. The CPU-rendered plasma effect itself
        is unchanged.
  1.10  The same source now builds both the 68k and WarpOS/PPC binaries.
        The animation is time-normalized, the trail rasterizer is faster,
        and the WarpOS binary manages its own PPC stack.
  1.21  Added an autonomous mode and an A-key mode cycle: Lissajous, Rose,
        Spiro, Orbit, Harmono and Off. Added wheel and middle-button drag
        speed control, mode names and speed in the title, A-key repeat
        suppression, Intuition V47 extended-wheel input with a legacy
        RAWKEY fallback, and corrected the non-Lissajous motion scaling.
  1.49  Added Project, Global and Options menus; icon ToolTypes and matching
        command-line options for display, FPS, autonomous and trail settings;
        and full-screen operation with mode selection, Enter toggle, restored
        window geometry, pointer auto-hide and an optional status HUD.