GFXLIB v2.06 new additions and important changes
New graphics routines
The GFXLIB_lib folder currently contains the following items:
New core PROCs and FNs defined in GFXLIB2.BBC
Changes to GFXLIB
The following members of the dispVars structure have now been officially abolished:
As of GFXLIB v2.06, the dispVars structure will contain only the following five members:
FNLoadImg3() takes the following parameters: pathname, destAddr, width, height, aspectFlag, flipFlag
Previously, width and height could be passed by value, for example:
myImg% = FNLoadImg3(myImgFile$, myImg%, 0, 0, TRUE, FALSE)
(load an image, preserving its original dimensions)
myImg% = FNLoadImg3(myImgFile$, myImg%, 320, 200, FALSE, FALSE) (load an image, scaling it 320x200 - the image's aspect ratio is not preserved)
myImg% = FNLoadImg3(myImgFile$, myImg%, 550, 0, TRUE, FALSE) (load an image, scaling the width to 550 pixels and preserving the aspect ratio (i.e. the height will depend on the images original aspect ratio)
Now the width and height parameters must be passed by reference:myImg% = FNLoadImg3(myImgFile$, myImg%, imgW%, imgH%, FALSE, FALSE) (load an image; if imgW% and imgH% are previously undeclared, then they are created as new variables, and the function returns with imgW% and imgH% containing the unscaled width and height of the image, respectively.)
See the documentation of FNLoadImg3() for more details.
Deprecated subroutines and functions
As of GFXLIB v2.06, the following PROCs and FNs (defined in GFXLIB2.BBC) are deprecated:
Although very unlikely to be removed in the next few releases of GFXLIB, I cannot guarantee that they will be included in future releases of GFXLIB.
The above deprecated subroutines are still available in GFXLIB v2.06, but please use the following alternative image and data loaders instead:
Compatibility with previous versions of GFXLIB
Most programs that worked with versions 2.03 to 2.05 of GFXLIB should work without modifications with v2.06.