Short:        Chunkygraphics library v1.51 for Blitz Basic 2
Author:       Paul West
Uploader:     paul stationone demon co uk
Type:         dev/blitz
Replaces:     Mildred.lha
Requires:     68020+ CPU, preferably some fastram, and prior knowledge of blitz
Architecture: m68k-amigaos

NB: This archive is a replica of the entire contents of the Mildred website.

Mildred is a 2D chunkygraphics library for Blitz Basic 2. It attempts to replace
most of the existing planar graphics system and also add new features and
capabilities, the main difference being that everything is done in `chunky' data
format rather than planar. This has many advantages in various areas and a
comprehensive range of blit and other routines are provided as well as many
custom objects (chunky bitmaps, shapes, queues, tables, c2pwindows, etc..)

Mildred brings you 219 new tokens, with the functionality of 407 via syntax
variations and God knows how many variations of blit modes and switches, in a
custom library which has full runtime errochecking routines. The library is the
largest ever made for blitz but probably you will not mind the byte overhead
when you consider what it will make possible for you in your software. Working
in chunky allows easy graphics-card support and output to AGA via a flexible
chunky-to-planar system.

The Mildred library was written in 1998-2000 by Paul West. Full copyright has
been reclaimed from Pagan Games. You are permitted to use the lib in any and
all of your blitz software, be it freeware, shareware, licenseware,
commercialware or whatever. I do not ask for any fee in return unless you are
feeling generous. If you are using it in an commercial product that is
retailing for more than 5 UK-pounds per item, then I wouldn't mind a mention or
some cash. :-D

The original aminet archive was a collection of archives from the official Mildred
support site, which is at http://www.stationone.demon.co.uk and the same trend
continues with this update. There have been a number of revisions since the
previous update and some more example programs added. The full sourcecode to the
library is also now available in ascii and BB2 format! Loading up index.html
you will be greeted with a copy of the front page of the support site, which will
allow you to read the comments about each of the archives to give you some idea
of what they are. The main Mildred library is in the Mildred.lha archive. See the
documentation for how to install it.

If you are on the internet I suggest you just go to the support site, and also
recommend joining the blitz mailing list if you haven't already done so which
can be achieved by sending an empty message to blitz-list-subscribe@netsoc.ucd.ie
where you will find a number of blitz addicts and Mildred users.

The previous aminet release was v1.50.

This library is now v1.51. This may not be the last release as I still have
ideas for future optimisations and tokens. The following changes to the library
itself have occured since the release of v1.50:

v1.51 - Work resumed 27/02/2000 for the first time since 22/05/1999, copyright ownership has been reclaimed
      - Bug identified in PerformBlit1/2/3_16[b] MSimpleReMapMode. Masking isn't working right, shape's cookie is blocks of 4!
      - Macro RemakeStencil optimised by changing SNE.b to SEQ.b and removing the NOT.l, slight speedup making cookie/stencil
      - Fixed bug in PerformBlit1/2/3_16[b] MSimpleReMapMode. Replaced TST.l with CMP.l #-1, as it was skipping 4 instead of 1
      - Design flaw: Programmers should beware that cludged cookies/stencils must share the same linemodulo as the main data
      - Optimised macro PerformYFlip for improved speed Yflipping if width is multiple of 16
      - Optimised/recoded macro PerformXFlip for improved speed Xflipping if width is multiple of 4 or 16. ScrollDemo is 1fps+

Note that this release includes new example programs, the full library
sourcecode, and a spruced up website.

Probs/comments/suggestions/worldly praise to paul@stationone.demon.co.uk

Also check out http://www.stationone.demon.co.uk for the support site.

Cheers,
Paul.