Mildred v1.38. Copyright (c) 1998-1999 Paul West and Pagan Software. Mildred.obj is the actual Mildred chunky-graphics library. Put it into your Blitzlibs:Userlibs/ drawer. Then remake your deflibs file with either BlitzLibsMan, or the MakeDefLibs program. If you encounter a crash when attempting to recreate your deflibs with Mildred.obj installed, try using the modified version that I have also supplied. Then you can reload blitz/ted and Mildred's commandset should be available. A suggested installation from CLI is as follows: Lha x ram:Mildred.lha ram: Copy ram:Mildred.obj Blitzlibs:userlibs/ ram:MakeDefLibs.exe EndCli then load up blitz. History v1.1 - First public release v1.11 - Fixed bug in MUseShapeBank and altered ShapesTotal size to word as it was incorrectly a longword - Fixed bug in the errorchecking of Mc2pCPUmode that was checking d3 instead of d0 v1.12 - Fixed bug in MUnQueue that would only do two lines of code if wrapping was active, but should have been done always v1.13 - MBoxF, MBoxFShape, MBoxFStencil and MBoxFCookie added - MBox, MBoxShape, MBoxStencil and MBoxCookie added v1.14 - MPlanar16ToBitmap, MPlanar16ToShape added v1.15 - Planar-to-chunky converter optimised further using addx and reverse bitplane order, twice as fast as roxr.b #n,dn - MGenericPtr added - A shape's handle is unconditionally added (actually subtracted) to Xpos,Ypos in shape-to-bitmap type blits (MBlit etc) v1.16 - Fixed small bug in !PerformPoint macro, d6.l should have been d6.w. - Fixed small but ineffective bug in MPlotCookie, d6.l should have been d6.w v1.17 - Added MCludgeCookie and MCludgeStencil, also needed to add two macros - Fixed bug in macro used by MCludgeCookie and MCludgeStencil, as it was not setting `SHere' to 0 to indicate cludge. v1.18 - Added MUnQueueRange for unqueuing a range of items and without flushing the queue v1.19 - Fixed bug in data for shape banks, was using structures of 8 bytes but only were 6 bytes in mem - Fixed bug in MReserveShapes, was shifting bank number 8 places instead of 3 v1.2 - Added MReMap and MReMapShape v1.21 - Fixed bug in macro DeallocStencil, was killing the whole object v1.22 - Commented-out line in MShapeClip and MBitmapClip to make X leftedge unaligned (width is still multiple of 4) - Commented-out line in Macro CludgeResourceWindow to make X leftedge unaligned (width of window is still multiple of 4) v1.23 - Added mode to MBlit so that if a cookie is not present it will just blit the graphic in `replace'-mode (unmasked) - Minor pipeline improvement in macros !PerformPlot and !PerformPoint - Added code to the init routine to reserve default amounts of all objects at runtime (doesn't need much mem) - Added `BankToUse' parameter to MReserveShapes so that you don't have to do a seperate MUseShapeBank - Changed BoxF and Box routines to use X2,Y2 instead of Width,Height and had to add macro CCheckWindowFits4 v1.24 - Made the colour parameter in MPlot,MPlotShape,MPlotStencil and MPlotCookie optional, assuming 0 if not specified - *Partially* Added MLine, MLineShape, MLineStencil and MLineCookie - Modified shapebank-related routines to provide 32 shape banks numbered 0..31, instead of 0..9. - Fixed bugs in macros ShuffleRegs1, ShuffleRegs2 and ShuffleRegs3 v1.25 - Addred MReMapUsingShape and MReMapShapeUsingShape v1.26 - Optimised routine PerformReMapUsing for slight speed gain - Optimised routine PerformReMap for 25% speed gain in table mode - Fixed bug in macro CCheckWindowFits4, which affected runtime errorchecking of MBox/MBoxF and related routines v1.27 - Added MInk for setting a currently-used pen colour. Defaults to 1 which is a bit more logical than 0 - Added MColourMode function to accompany CookieMode/SolidMode etc, but for `colour' drawing mode in blits - Added `colour' mode to MBlit, MQBlit, MSBlit, MQSBlit and MMaskScroll routines - Removed redundant instruction in routine PerformBlit3's loop, for cookie-mode stencil-blits (slight speedup) - Adjusted graphics routines to use the ink colour if assuming which colour to use, rather than 0 - Further optimised routine PerformReMapUsing for slight speedup (about 1-2fps) - Changed order of tables being used for MReMap[Shape]UsingShape, for consistency with `MReMapMode' blit mode - Added support for new Table objects - Added MReserveTables, MFreeTables, MFreeTable, MAddrTable, MTable - Added MFlushTable, MAutoUseTables, MUseTables, MUseTable, MUsedTable - Added MTablePtr, MReMapMode - Added new blit mode `ReMap' to the MBlit, MQBlit, MSBlit, MQSBlit and MMaskScroll routines for table-based remapping v1.28 - Optimised MPictureDissolveIn for speed gain (a good few fps) - Added MSimpleReMapMode - Added new blit mode `SimpleReMap' to the MBlit, MQBlit, MSBlit, MQSBlit and MMaskScroll routines for 1-dim remapping - Fixed bug in definitions, MPointStencil and MPointCookie were defined as statements, but should have been functions - Changed the !PerformPoint macro to initialise d0 before grabbing the byte, in case it causes corrupt return value v1.29 - Optimised non-cut routine used by MSMaskScrolls (PerformGenericBlit6[b]) - Slight optimisation to non-cut plain copy routine used by M[Q]SBlits (PerformBlit2) - Finished MLine, MLineShape, MLineStencil and MLineCookie v1.30 - Redirected routine PerformGenericBlit3[b] to use PerformBlit1[b], to save code redundancy, and made gen3b into 1b - Added MSMaskScrollMode to support blit modes for MSMaskScrolls (previously only MMaskScrolls) - Redirected routine PerformGenericBlit6[b] to use PerformBlit2[b], to prepare for shared sblit blit-mode code - Redirected routine PerformGenericBlit9[b] to use PerformBlit3[b], to prepare for shared sblit cut blit-mode code - Completed support for MSMaskScrolls in `copy' mode with blit modes, by adding PerformBlit2b (2 backwards) - Completed support for MSMaskScrolls in `cut' mode with blit modes, by adding PerformBlit3b (3 backwards) - Modified runtime errorchecking routines for MSMaskScrolls to check that tables are available in M[Simple]ReMapMode v1.31 - Modified MScroll routines to support any width (non multiple, as low as 1). - Modified MSScroll routines to support any width (non multiple, as low as 1) in both `paste' and `cut' modes. v1.32 - Fixed bugs in routine PerformBlit2[b] for non-cut output to stencil. Some OR's should have been AND's, and vice versa. v1.33 - Fixed bug in routine PerformLine, sometimes d5 was plotted rather than d6 v1.34 - Added MPlotParticles for plotting list of pixels to a colour. List items are X.w,Y.w - Added MGrabParticles for grabbing list of pixels to a buffer. List items are X.w,Y.w. Buffer is Pixel.b's - Added MDrawParticles for drawing grabbed list of pixels from a buffer. List items are X.w,Y.w. Buffer is Pixel.b's - Added MGrabParticlesAndPlot for grabbing and plotting pixels to a colour. List items are X.w,Y.w. Buffer is Pixel.b's - Fixed bug in initialisation, auto-clip for bitmaps and shapes shouldn't have been automatically On! - Added MPlotParticlesA, MGrabParticlesA, MDrawParticlesA, MGrabParticlesAndPlotA, for actual-address list items - Added MPlotParticlesQ, MGrabParticlesQ, MDrawParticlesQ, MGrabParticlesAndPlotQ, for X.q,Y.q items [*16*.16][*16*.16] - Added MAddToParticles, MAddToParticlesA, MAddToParticlesQ, for adding values to particle list items - Added MAdd2ToParticles, MAdd2ToParticlesA, MAdd2ToParticlesQ, for more efficient multiple adds to list items v1.35 - Added MWrapParticles, MWrapParticlesA, MWrapParticlesQ, to wrap coords around edges of bitmap/clip (within reason) - Fixed bugs in clip routine of MAddToParticlesQ and MAdd2ToParticlesQ, offsets and adders and adding were wrong - Fixed bugs in clip routine of MWrapParticles and MWrapParticlesQ, 2 conditional branches to loop missing v1.36 - Added MReboundParticles and MReboundParticlesQ, for bouncing particless off the edges. No `A' version, not possible - Fixed bugs in MLine, MLineShape, MLineStencil, MLineCookie, short version used wrong colour - Added MProcessor function, to replace blitz's `Processor' instruction and support 060 - Modified various cpu-related routines (c2p and 040 choices) to support possible 060 cpu number - Modified init routine to check for cpu availability and set MCPU, Mc2pCPUmode and M040c2pUsage to appropriate defaults v1.37 - Added MAddXYToParticles and MAddXYToParticlesQ for adding X and Y constants to X and Y components in a particle list - Added MAddXYToParticlesA to add constant value to list of Ptr.l particles - Added MAddXToParticles, MAddYToParticles, MAddXToParticlesQ and MAddYToParticlesQ for further adding to particle lists v1.38 - Removed unnecessary code from MPlotParticlesA, MGrabParticlesA, MDrawParticlesA and MGrabParticlesAndPlotA - Added MParticleMode to choose MColourMode, MReMapMode or MSimpleReMapMode for particle plot/draw - Added MSimpleReMapMode and MReMapMode support to MPlotParticles, MPlotParticlesA and MPlotParticlesQ (clipping also!) - Added MSimpleReMapMode and MReMapMode support to MDrawParticles, MDrawParticlesA and MDrawParticlesQ (clipping also!) - Added MSimpleReMapMode and MReMapMode support to MGrabParticlesAndPlot[A/Q] for remap plot and normal grab (and clip!) - Merged MAdd2ToParticles[A/Q] into extension of MAddToParticles[A/Q] to make friendlier interface & cut down on tokens - Token order has been compromised due to removal of MAdd2ToParticles, MAdd2ToParticlesA and MAdd2ToParticlesQ !!! - Fixed errornumber bugs in errorchecking routines of MShapePtr and MCookiePtr. Was Error28, should have been Error27 - Added support to MBitmapPtr, MStencilPtr, MShapePtr and MCookiePtr to assume currently used objects if no params - Merged MAddXToParticles[Q] into special-case routine of MAddXYToParticles[Q] (called if Y is 0) - Merged MAddYToParticles[Q] into special-case routine of MAddXYToParticles[Q] (called if X is 0) - Token order has been compromised due to removal of MAddXToParticles[Q] and MAddYToParticles[Q] !!! Blitz library 'blitzlibs:userlibs/Mildred.obj' (#15) Mc2pRowLacing State.b ; Toggle row-lacing in c2p On/Off. NonZero=On Mc2pColumnLacing State.b ; Toggle column-lacing in c2p On/Off Mc2pRowToggle ; Toggle c2p row lacing between Even/Odd rows Mc2pColumnToggle ; Toggle c2p column lacing between Even/Odd columns Mc2pToggleSingle ; Toggle c2p lacing for single-buffered display Mc2pToggleDouble Buf.b ; 0 or 1. Toggle c2p lacing for double-buffered display Mc2pToggleTriple Buf.b ; 0, 1 or 2. Toggle c2p lacing for triple-buffered display Mc2pToggle Buffers.b,Buf.b ; 1, 2 or 3, and 0, 1 or 2. Toggle c2p lacing. M040c2pUsage Status.b ; On/Off - Availability of 040 c2p. Overrides Mc2pCPUmode Mc2pCPUmode CPU.b ; Set cpu c2p uses. Use `MProcessor' or `Processor'. <4=030-, >3=040+ Mc2pWindow c2pWindow#.w,OpWidth.w,OpHeight.w[,SourceBWidth.w[,Processor.b],PlanarWidth.w,PlanarHeight.w] Mc2pWindowWidth (c2pWindowNumber.w) ; Returns width of c2pWindow Mc2pWindowHeight (c2pWindowNumber.w) ; Returns height of c2pWindow Mc2pWindowNewHeight c2pWindow#.w,NewHeight.w ; Change height of already defined c2p object Mc2p [[c2pWindow#.w],Chunky.l],Planar.l ; Convert chunky to planar (Use Mc2pWindow first) MReservec2pWindows [(]NumberOfWindows.w[)] ; Reserve structure-memory for c2pWindows MReserveShapes [(]NumberOfShapes.w[,ShapeBankToUse.w][)] ; Reserve structure-memory for Shapes MReserveBitmaps [(]NumberOfBitmaps.w[)] ; Reserve structure-memory for Bitmaps MInitShape [(]ShapeNumber.w,Width.w,Height.w[)] ; Allocmem for shape data MShape [(]ShapeNumber.w,Width.w,Height.w[)] ; Allocmem for shape data MBitmap [(]BitmapNumber.w,Width.w,Height.w[)] ; Allocmem for bitmap data MAutoCookie On/Off ; Autocreation of ByteForByte cookies MAutoStencil On/Off ; Autocreation of ByteForByte stencils MFreec2pWindows [Firstc2pWindow.w,Lastc2pWindow.w] ; Free/delete all/range of c2pwindows MFreec2pWindow Free/delete a pre-existing c2pWindow MFreeShapes [FirstShape.w,LastShape.w] ; Free/delete all/range of Shapes MFreeShape ShapeNumber.w ; Free/delete a pre-existing Shape MFreeBitmaps [FirstBitmap.w,LastBitmap.w] ; Free/delete all/range of Bitmaps MFreeBitmap BitmapNumber.w ; Free/delete a pre-existing Bitmap MShapeWidth (ShapeNumber.w) ; Returns width of Shape MBitmapWidth (BitmapNumber.w) ; Returns width of Bitmap MShapeHeight (ShapeNumber.w) ; Returns height of Shape MBitmapHeight (BitmapNumber.w) ; Returns height of Bitmap MAddrc2pWindow (c2pWindowNumer.w} ; Returns address of c2pWindow structure MAddrShape (ShapeNumber.w) ; Returns address of Shape structure MAddrBitmap (BitmapNumber.w) ; Returns address of Bitmap structure MHandle ShapeNumber.w,XOffset.w,YOffset.w ; Set handle of Shape MBitmapOrigin BitmapNumber.w,XOffset.w,YOffset.w ; Set origin of Bitmap MMidHandle ShapeNumber.w ; Set handle to middle of Shape MBitmapMidOrigin BitmapNumber.w ; Set origin to middle of Bitmap MUsec2pWindows Mainc2pWindowNum.w[,Secondc2pWindowNum.w[,Thirdc2pWindowNum.w]] ; Current to use MUsec2pWindow c2pWindowNumber.w ; Current to use MUseShapes MainShapeNum.w[,SecondShapeNum.w[,ThirdShapeNum.w]] ; Current Shape(s) to use MUseShape ShapeNumber.w ; Current Shape to use MUseBitmaps MainBitmapNum.w[,SecondBitmapNum.w[,ThirdBitmapNum.w]] ; Current Bitmap to use MUseBitmap BitmapNumber.w ; Current Bitmap to use MUsedc2pWindow ; Returns currently used c2pWindow MUsedShape ; Returns currently used Shape MUsedBitmap ; Returns currently used Bitmap MCludgeShape ShapeNumber.w,Width.w,Height.w,Memory.l ; Cludge shape from existing mem MCludgeBitmap BitmapNumber.w,Width.w,Height.w,Memory.l ; Cludge bitmap from existing mem MAutoUsec2pWindows True/False ; Automatically `use' new c2pWindows. <>0=True MAutoUseShapes True/False ; Automatically `use' new shapes. <>0=True MAutoUseBitmaps True/False ; Automatically `use' new bitmaps. <>0=True MMakeCookies [FirstShape.w,LastShape.w] ; Make cookies for all/range of shapes MMakeCookie ShapeNumber.w ; Make a cookie for a shape MMakeStencils [FirstBitmap.w,LastBitmap.w] ; Make stencils for all/range of bitmaps MMakeStencil BitmapNumber.w ; Make a stencil for a bitmap MFreeCookies [FirstShape.w,LastShape.w] ; Free all/range of cookies MFreeCookie ShapeNumer.w ; Free's the Shape's cookie MFreeStencils [FirstBitmap.w,LastBitmap.w] ; Free all/range of stencils MFreeStencil BitmapNumber.w ; Free's the Bitmap's stencil MAutoShapeWrap On/Off ; Auto X&Y Handle-wrapping for Shapes MAutoBitmapWrap On/Off ; Auto X&Y Handle-Wrapingp for Bitmaps MShapeWrap ShapeNumber.w,On/Off ; De/Activate X&Y Handle-Wrap for Shape MBitmapWrap BitmapNumber.w,On/Off ; De/Activate X&Y Handle-Wrap for Bitmap MCludgeShapeStruct [(]SourceShape.w,DestShape.w[)] ; Copy definition-data only MCludgeBitmapStruct [(]SourceBitmap.w,DestBitmap.w[)] ; Copy definition-data only MCopyc2pWindow Sourcec2pWindow.w,Destc2pWindow.w ; Copy definition-data only MShapeWindow [(]SourceShape.w,DestShape.w,X.w,Y.w,Width.w,Height.w[)] ; Cludge Shape within a Shape MBitmapWindow [(]SourceBitmap.w,DestBitmap.w,X.w,Y.w,Width.w,Height.w[)] ; Cludge Bitmap within a Bitmap MBitmapShape [(]SourceBitmap.w,DestShape.w[)] ; Copy definition-data only MShapesBitmap [(]SourceShape.w,DestBitmap.w[)] ; Copy definition-data only MCopyHandle SourceShapeNumber.w,DestShapeNumber.w ; Copy a shape's handle to another shape MCopyOrigin SourceBitmapNumber.w,DestBitmapNumber.w ; Copy a bitmap's origin to another bitmap MAutoCookieXFlip On/Off ; Auto X-Flip for Shape's cookie MAutoCookieYFlip On/Off ; Auto Y-Flip for Shape's cookie MAutoStencilXFlip On/Off ; Auto X-Flip for Bitmap's stencil MAutoStencilYFlip On/Off ; Auto Y-Flip for Bitmap's stencil MAutoCookieFlip On/Off ; Auto X&Y Cookie-Flip for Shapes MAutoStencilFlip On/Off ; Auto X&Y Stencil-Flip for Bitmaps MShapeXFlip ShapeNumber.w ; Horizontally flip a Shape (see MAutoCookieFlip) MShapeYFlip ShapeNumber.w ; Vertically flip a Shape (see MAutoCookieFlip) MBitmapXFlip BitmapNumber.w ; Horizontally flip a Bitmap (see MAutoStencilFlip) MBitmapYFlip BitmapNumber.w ; Vertically flip a Bitmap (see MAutoStencilFlip) MCookieXFlip ShapeNumber.w ; Horizontally flip a Shape's cookie MCookieYFlip ShapeNumber.w ; Vertically flip a Shape's cookie MStencilXFlip BitmapNumber.w ; Horizontally flip a Bitmap's stencil MStencilYFlip BitmapNumber.w ; Vertically flip a Bitmap's stencil MAutoShapeClip Status.b ; Auto-clip new Shapes. On/Off MAutoBitmapClip Status.b ; Auto-clip new Bitmaps. On/Off MShapeClip ShapeNumber.w[,X.w,Y.w,Width.w,Height.w][,Active] ; Active=On/Off. Define Shape's clip window MBitmapClip BitmapNumber.w[,X.w,Y.w,Width.w,Height.w][,Active] ; Active=On/Off. Define Bitmap's clip window MGetaShape ShapeNumber.w,X.w,Y.w,Width.w,Height.w[,Block?,StencilIsCookie?] ; Grab shape from bitmap MGetaBitmap BitmapNumber.w,X.w,Y.w,Width.w,Height.w[,Block?,CookieIsStencil?] ; Grab bitmap from shape MScroll X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceBitmapNum.w] ; Copy graphic MScrollShape X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceShapeNum.w] ; Copy graphic MScrollStencil X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceBitmapNum.w] ; Copy stencil to stencil only MScrollCookie X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceShapeNum.w] ; Copy cookie to cookie only MMaskScroll X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceBitmapNum.w] ; Copy bitmap graphic with stencil-cut MMaskScrollShape X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceShapeNum.w] ; Copy shape graphic with cookie-cut MMaskScrollStencil X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceBitmapNum.w];Copy stencil2stencil & stencil-cut MMaskScrollCookie X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceShapeNum.w] ; Copy cookie to cookie & cookie-cut MScrollBitmapToShape X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceBitmapNum.w] ; Copy bitmap to shape MScrollShapeToBitmap X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceShapeNum.w] ; Copy shape to bitmap MScrollStencilToCookie X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceBitmapNum.w] ; Copy stencil to cookie MScrollCookieToStencil X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceShapeNum.w] ; Copy cookie to stencil MMaskScrollBitmapToShape X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceBitmapNum.w] ; Copy bitmap to shape & cut MMaskScrollShapeToBitmap X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceShapeNum.w] ; Copy shape to bitmap & cut MMaskScrollStencilToCookie X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceBitmapNum.w] ;Copy stencil2cookie & cut MMaskScrollCookieToStencil X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceShapeNum.w] ; Copy cookie2stencil & cut MBlockScroll X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceBitmapNum.w] ; BlockCopy graphic MBlockScrollShape X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceShapeNum.w] ; BlockCopy graphic MBlockScrollStencil X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceBitmapNum.w] ; BlockCopy stencil to stencil MBlockScrollCookie X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceShapeNum.w] ; BlockCopy cookie to cookie MBlockScrollBitmapToShape X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceBitmapNum.w] ; BlockCopy bitmap to shape MBlockScrollShapeToBitmap X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceShapeNum.w] ; BlockCopy shape to bitmap MBlockScrollStencilToCookie X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceBitmapNum.w];BlockCopy stencil2cookie MBlockScrollCookieToStencil X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceShapeNum.w] ; BlockCopy cookie2stencil MCPU Processor.b ; Set cpu routines allowed to use. CAREFUL!! Try using `MProcessor' or `Processor' MCls [Colour] Clear a bitmap to colour 0 or the specified colour MClsShape [Colour] Clear a shape to colour 0 or the specified colour MClsStencil [Colour] Clear a stencil to colour 0 or the specified colour MClsCookie [Colour] Clear a cookie to colour 0 or the specified colour MPlot Xpos.w,Ypos.w[,Colour] ; Plot a single pixel in the bitmap [to the specified colour] MPlotShape Xpos.w,Ypos.w[,Colour] ; Plot a single pixel in the shape [to the specified colour] MPlotStencil Xpos.w,Ypos.w[,Colour] ;Plot a single pixel in the stencil to *represent* the [specified] colour MPlotCookie Xpos.w,Ypos.w[,Colour] ; Plot a single pixel in the cookie to *represent* the [specified] colour MPoint (Xpos.w,Ypos.w) ; Return the colour of a single pixel in a bitmap MPointShape (Xpos.w,Ypos.w) ; Return the colour of a single pixel in a shape MPointStencil (Xpos.w,Ypos.w) ; Return the status of a single pixel in a stencil. -1=Data, 0=Background MPointCookie (Xpos.w,Ypos.w) ; Return the status of a single pixel in a cookie. -1=Data, 0=Background MSScroll X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceBitmapNum.w] ; Copy bm 2 bm and st 2 st MSScrollShape X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceShapeNum.w] ; Copy sh 2 sh and ck 2 ck MSScrollBitmapToShape X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceBitmapNum.w] ; Copy bm 2 sh and st 2 ck MSScrollShapeToBitmap X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceShapeNum.w] ; Copy sh 2 bm and ck 2 st MSMaskScroll X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceBitmapNum.w] ; Stencil-Copy bm 2 bm and st 2 st MSMaskScrollShape X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceShapeNum.w] ; Cookie-Copy sh2sh and ck2ck MSMaskScrollBitmapToShape X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceBitmapNum.w] ;Sten-Copy bm2sh&st2ck MSMaskScrollShapeToBitmap X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceShapeNum.w] ; Cook-Copy sh2bm&ck2st MSBlockScroll X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceBitmapNum.w] ; Block-Copy bm 2 bm and st 2 st MSBlockScrollShape X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceShapeNum.w] ; Block-Copy sh2sh and ck2ck MSBlockScrollBitmapToShape X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceBitmapNum.w];BlockCopy bm2sh&st2ck MSBlockScrollShapeToBitmap X1.w,Y1.w,Width.w,Height.w,X2.w,Y2.w[,SourceShapeNum.w];BlockCopy sh2bm&ck2st MSScrollCut On/Off ; 0=Paste stencil/cookie, <>0=Cut using stencil/cookie MUseShapeBank BankNumber.w ; Current shape bank, 0..31 MPictureDissolveIn PictureBitmapNum.w,Colour.b ; Do a picture-based colour-number dissolve-in of a bitmap MMaskScrollMode Mode.w ; CookieMode/EraseMode/InvMode/SolidMode/MColourMode/MReMapMode/MSimpleReMapMode MBlitMode Mode.w ; CookieMode/EraseMode/InvMode/SolidMode/MColourMode/MReMapMode/MSimpleReMapMode MBlit [ShapeNumber.w,]Xpos.w,Ypos,w ; Blit shape to bitmap, any coords MBlock [ShapeNumber.w,]Xpos.w,Ypos.w ; Block-blit shape to bitmap, align Xpos and width in multiples of 16! MTile16x16 [ShapeNumber.w,]Xpos.w,Ypos.w ; Block-blit 16x16 shape to bitmap, size must be 16x16, align x/y MTile32x32 [ShapeNumber.w,]Xpos.w,Ypos.w ; Block-blit 32x32 shape to bitmap, size must be 32x32, align x/y MSTile16x16 [ShapeNumber.w,]Xpos.w,Ypos.w ; Block-blit 16x16 shape&cook 2 bitmap, size 16x16, align x/y MSTile32x32 [ShapeNumber.w,]Xpos.w,Ypos.w ; Block-blit 32x32 shape&cook 2 bitmap, size 32x32, align x/y MSTile16x16Store [ShapeNumber.w,]Xpos.w,Ypos.w ; Block-blit 16x16 shape&cook 2 bitmaps, size 16x16, align x/y MSTile32x32Store [ShapeNumber.w,]Xpos.w,Ypos.w ; Block-blit 32x32 shape&cook 2 bitmaps, size 32x32, align x/y MTile16x16Store [ShapeNumber.w,]Xpos.w,Ypos.w ; Block-blit 16x16 shape to 2 bitmaps, size 16x16, align x/y MTile32x32Store [ShapeNumber.w,]Xpos.w,Ypos.w ; Block-blit 32x32 shape to 2 bitmaps, size 32x32, align x/y MReserveQueues [(]NumberOfQueues.w[)] ; Reserve structure-memory for Queues MFreeQueues [FirstQueue.w,LastQueue.w] ; Free/delete all/range of Queues MFreeQueue QueueNumber.w ; Free/delete a pre-existing Queue MAddrQueue (QueueNumber.w} ; Returns address of Queue structure MQueue [(]QueueNumber.w,NumberOfItems.w[)] ; Allocmem for Queue list items MFlushQueue QueueNumber.w ; Empties the queue to contain no items MQBlitMode Mode.w ; CookieMode/EraseMode/InvMode/SolidMode/MColourMode/MReMapMode/MSimpleReMapMode MAutoUseQueues True/False ; Automatically `use' new Queues. <>0=True MUseQueues MainQueueNum.w[,SecondQueueNum.w[,ThirdQueueNum.w]] ; Current to use MUseQueue QueueNumber.w ; Current to use MUsedQueue ; Returns currently used Queue MQBlit [[Queue.w,]ShapeNumber.w,]Xpos.w,Ypos,w ; QBlit shape to bitmap, any coords MQBlock [[Queue.w,]ShapeNumber.w,]Xpos.w,Ypos.w ; QBlock-blit shape 2 bitmap, align Xpos & width in mult of 16 MUnQueue QueueNumber.w[,BitmapNumber.w] ; UnQueue the queued objects and flush the queue MBitmapPtr [Xpos.w,Ypos.w][,BitmapNumber.w] ; Return data address calculated using bitmap [and coords] MShapePtr [Xpos.w,Ypos.w][,ShapeNumber.w] ; Return data address calculated using shape [and coords] MStencilPtr [Xpos.w,Ypos.w][,BitmapNumber.w] ; Return address calculated using stencil [and coords] MCookiePtr [Xpos.w,Ypos.w][,ShapeNumber.w] ; Return address calculated using cookie [and coords] MQDummy [Queue.w,]Xpos.w,Ypos.w,Width.w,Height.w ; Add an item to a queue without having to do a blit MSBlitMode Mode.w ; CookieMode/EraseMode/InvMode/SolidMode/MColourMode/MReMapMode/MSimpleReMapMode MSBlit [ShapeNumber.w,]Xpos.w,Ypos,w ; Blit shape to bitmap and cookie to stencil, any coords MSBlock [ShapeNumber.w,]Xpos.w,Ypos.w ; Block-blit shape to bitmap & cookie 2 stencil, Xpos&Width in 16's MSBlitCut On/Off ; 0=Paste stencil/cookie, <>0=Cut using stencil/cookie MQSBlitMode Mode.w ; CookieMode/EraseMode/InvMode/SolidMode/MColourMode/MReMapMode/MSimpleReMapMode MQSBlit [[Queue.w,]ShapeNumber.w,]Xpos.w,Ypos,w ; QBlit shape to bitmap and cookie to stencil, any coords MQSBlock [[Queue.w,]ShapeNumber.w,]Xpos.w,Ypos.w ; QBlock-blit shape 2 bitmap, Xpos&width mult of 16 MQSBlitCut On/Off ; 0=Paste stencil/cookie, <>0=Cut using stencil/cookie. Adds entry to queue MBoxF Xpos.w,Ypos.w,Xpos2.w,Ypos2.w[,Colour] Draw a filled box in a bitmap [to specified colour] MBoxFShape Xpos.w,Ypos.w,Xpos2.w,Ypos2.w[,Colour] Draw a filled box in a shape [to specified colour] MBoxFStencil Xpos.w,Ypos.w,Xpos2.w,Ypos2.w[,Colour] Draw a filled box in a stencil [to specified colour] MBoxFCookie Xpos.w,Ypos.w,Xpos2.w,Ypos2.w[,Colour] Draw a filled box in a cookie [to specified colour] MBox Xpos.w,Ypos.w,Xpos2.w,Ypos2.w[,Colour] Draw an unfilled box in a bitmap [to specified colour] MBoxShape Xpos.w,Ypos.w,Xpos2.w,Ypos2.w[,Colour] Draw an unfilled box in a shape [to specified colour] MBoxStencil Xpos.w,Ypos.w,Xpos2.w,Ypos2.w[,Colour] Draw an unfilled box in a stencil [to specified colour] MBoxCookie Xpos.w,Ypos.w,Width.w,Height.w[,Colour] Draw an unfilled box in a cookie [to specified colour] MPlanar16ToBitmap BitmapNum.w,PlanarAddr.l[,OpWidth.w,OpHeight.w,PlanarWidth.w,PlanarHeight.w] ; Convert p2c MPlanar16ToShape ShapeNum.w,PlanarAddr.l[,OpWidth.w,OpHeight.w,PlanarWidth.w,PlanarHeight.w] ; Convert p2c MGenericPtr Xpos.w,Ypos.w,BaseAddress.l,RowWidth.w ; Calculate and return address based on inputs MCludgeCookie ShapeNumber.w,Memory.l ; Cludge shape's cookie from existing mem MCludgeStencil BitmapNumber.w,Memory.l ; Cludge bitmap's stencil from existing mem MUnQueueRange QueueNumber.w,FirstItem.w,LastItem.w[,BitmapNumber.w] ; UnQueue a range of queued objects MReMap [Colour#0.b,Colour#1.b,BitmapNum.w] *or* [RemapTable.l[,BitmapNum.w]] ; Remap #0 to #1 or with table MReMapShape [Colour#0.b,Colour#1.b,ShapeNum.w] *or* [RemapTable.l[,ShapeNum.w]] ; Remap #0 to #1 or with table MLine [Xpos.w,Ypos.w,]Xpos2.w,Ypos2.w[,Colour.b] ;Draw a line from X1,Y1 to X2,Y2 in a Bitmap [in Colour] MLineShape [Xpos.w,Ypos.w,]Xpos2.w,Ypos2.w[,Colour.b] ;Draw a line from X1,Y1 to X2,Y2 in a Shape, [in Colour] MLineStencil [Xpos.w,Ypos.w,]Xpos2.w,Ypos2.w[,Colour.b];Draw a line from X1,Y1 to X2,Y2 in a stencil, [in Col] MLineCookie [Xpos.w,Ypos.w,]Xpos2.w,Ypos2.w[,Colour.b] ;Draw a line from X1,Y1 to X2,Y2 in a cookie, [in Col] MReMapUsingShape RemapTable.l[,SourceShapeNum.w[,DestBitmapNum.w]] ;Merge shape to bitmap using 2xWay Table MReMapShapeUsingShape RemapTable.l[,SourceShapeNum.w[,DestShapeNum.w]] ;Merge shape to shape using 2xWay Table MInk Colour.b ; Set what colour to assume as currently used. 0..255 MColourMode ;Returns value 4 which represents `colour' mode in the blit modes MReserveTables [(]NumberOfTables.w[)] ; Reserve structure-memory for Tables MFreeTables [FirstTable.w,LastTable.w] ; Free/delete all/range of Tables MFreeTable TableNumber.w ; Free/delete a pre-existing Table MAddrTable (TableNumber.w} ; Returns address of Table structure MTable [(]TableNumber.w,SizeInBytes.l[)] ; Allocmem for Table list items MFlushTable TableNumber.w ; Empties the table to contain no items MAutoUseTables True/False ; Automatically `use' new Tables. <>0=True MUseTables MainTableNum.w[,SecondTableNum.w[,ThirdTableNum.w]] ; Current to use MUseTable TableNumber.w ; Current to use MUsedTable ; Returns currently used Table MTablePtr [TableNum.w] ; Returns pointer to base of the table itself MReMapMode ;Returns value 5 which represents `ReMap' mode in the blit modes (uses current 2-dimensional table) MSimpleReMapMode ;Returns value 6 which is `SimpleReMap' mode in blit modes (uses current 1-dimensional table) MSMaskScrollMode Mode.w ; CookieMode/EraseMode/InvMode/SolidMode/MColourMode/MReMapMode/MSimpleReMapMode MPlotParticles CoordinateList.l,NumPoints.l[,Colour.b] ; Plot lots of points from an X.w,Y.w table of coords MGrabParticles CoordinateList.l,NumPoints.l,Buffer.l ; Grab lots of points from X.w,Y.w table, into buffer mem MDrawParticles CoordinateList.l,NumPoints.l,Buffer.l ; Draw lots of previously grabbed points, using X.w,Y.w's MGrabParticlesAndPlot CoordinateList.l,NumPoints.l,Buffer.l[,Colour.b]; Grabs points X.w,Y.w to buffer & plots MPlotParticlesA AddressList.l,NumPoints.l[,Colour.b] ; Plot lots of points from an Ptr.l table of coords MGrabParticlesA AddressList.l,NumPoints.l,Buffer.l ; Grab lots of points from Ptr.l table, into buffer mem MDrawParticlesA AddressList.l,NumPoints.l,Buffer.l ; Draw lots of previously grabbed points, using Ptr.l's MGrabParticlesAndPlotA AddressList.l,NumPoints.l,Buffer.l[,Colour.b] ; Grabs points Ptr.l to buffer & plots MPlotParticlesQ CoordinateList.l,NumPoints.l[,Colour.b] ; Plot lots of points from an X.q,Y.q table of coords MGrabParticlesQ CoordinateList.l,NumPoints.l,Buffer.l ; Grab lots of points from X.q,Y.q table, to buffer mem MDrawParticlesQ CoordinateList.l,NumPoints.l,Buffer.l ; Draw previously grabbed points, using X.q,Y.q's MGrabParticlesAndPlotQ CoordinateList.l,NumPoints.l,Buffer.l[,Colour.b];Grabs points X.q,Y.q to buffer & plots MAddToParticles CoordinateList.l,NumPoints.l,IncA.l[,IncB.l] ; Add X.w,Y.w to X.w,Y.w items in particle list MAddToParticlesA AddressList.l,NumPoints.l,IncA.l[,IncB.l] ; Add Ptr.l to Ptr.l items in particle list MAddToParticlesQ CoordinateList.l,NumPoints.l,IncA.l[,IncB.l] ; Add X.q,Y.q to X.q,Y.q items in particle list MWrapParticles CoordinateList.l,NumPoints.l ; Bring particles in from opposite edge to which they left MWrapParticlesA CoordinateList.l,NumPoints.l ; Bring particles in from opposite edge to which they left MWrapParticlesQ CoordinateList.l,NumPoints.l ; Bring particles in from opposite edge to which they left MReboundParticles CoordinateList.l,NumPoints.l,DirectionList.l,DetectSize.w ; Bounce particles off edges MReboundParticlesQ CoordinateList.l,NumPoints.l,DiectionList.l,DetectSize.w ; Bounce particles off edges MProcessor ; Returns value 0..6 representing MC68000..MC68060 cpu according to exec\AttnFlags MAddXYToParticles CoordinateList.l,NumPoints.l,XToAdd.w,YToAdd.w ; Add constants to all particles MAddXYToParticlesA CoordinateList.l,NumPoints.l,ValueToAdd.l ; Add constant to all particle pointers MAddXYToParticlesQ CoordinateList.l,NumPoints.l,XToAdd.q,YToAdd.q ; Add constants to all particles MParticleMode Mode.w ; MColourMode, MSimpleReMapMode or MReMapMode - to use in particle plot/draw Any problems/suggestions/bugs, contact paul@stationone.demon.co.uk