NAME

  HGR macro

SYNOPSIS

  Revive the past!  Use Apple II High Resolution Graphics (HGR) as assets on
  your WebGUI system.  No conversion needed!

DESCRIPTION

  The HGR macro displays Apple II High Resolution Graphics image files stored
    on ProDOS formatted disk images as PNG files on your WebGUI system.
    
    No image conversion is required.  No disk images need to be unpacked or
    otherwise harmed.  Safe for children under 3.
    
    Bring your classic art collection into the future!

EXAMPLE

  Toss the following macro wherever you feel the need to awe your visitors:

    ^HGR(/url/to/diskImage,FILENAME);
        
    The first parameter is the URL you assigned to the ProDOS formatted disk
    image in your asset manager.
    
    The second parameter is the Apple II ProDOS filename of the image file to
    display.  HGR files are 8192 bytes in length.  It does not matter if the
    image was saved on page 1 ($2000) or 2 ($4000).  HGR is smart like that.
    
    The sample disk image has a fantastic out-the-window view of Megs Field in
    Chicago from the cockpit of a Piper single-engine aircraft.  To gaze upon
    it in amazement, use the following:
    
      ^HGR(/url/of/Graphics.po,FLIGHT);
        
    You can almost feel the wind in your hair, can't you?  Just check out the
    majestic Sear's Tower off to the left of the runway!

INSTALLATION

  - Place HGR.pm in /data/WebGUI/lib/WebGUI/Macro.
    - Add HGR to your site's configuration file.
    - Give it the old /data/wre/sbin/rc.webgui restart
  - Put all your ProDOS por^H^Hhoto disks in the asset manager.
    - Go wild!

CREDITS

  First, I'd like to thank my brain.  It's responsible for most of this macro.
    A lot of very important Apple II technical information is still kept there.
    You can find more of my brain at http://www.jaegertech.com and at
    http://www.duensing.com

    Christopher J. Madsen for the LibA2 module.  I really didn't want to have
    to write the disk reading code myself!  http://www.cjmweb.net/perl/
    
    David M. Cotter for assistance with my broken color decoding routine.  His
    Apple II image tool, a2pix, can be found on his web site at
    http://www.lazilong.com/apple_II/a2pix/
    
    Bob Bishop for detailed information on how the Apple II maps RAM to the
    display.  Not all of this information stayed in my head over the last 25
    years.  http://rich12345.tripod.com/aiivideo/softalk.html
    
    I can't forget all the people I pestered in #WebGUI on FreeNode while trying
    to learn the API calls I needed to make this work.  Thanks again!