Aminet 18/aminetcdnumber181997.iso/Aminet/dev/misc/Gfx4PCQ.lha/WindowLib/Gfx4PCQ.readme

Text File | 1997-02-09 | 5.8 KB | 164 lines

Short:    Easy graphic support for the PCQ pascal compiler
Uploader: [e-mail] (Thomas Richter)
Author:   [e-mail] (Thomas Richter)
Type:     dev/misc

Windowlib is a link module for use with the fine PD PCQ pascal compiler on
the amiga. It provides useful functions to do graphics with this compiler,
together with some intuition support (menus & gadgets). This is mostly
maintained for the beginner in Pascal, to have nice graphics without much
efford, and can be (and has been) used to teach pascal.

Together with the library itself and one include file which defines all its
functions, several examples have been included to demonstrate the functions.

This package has been inspired by the graphics functions of the Atari XL
basic and later on the GFABASIC (which used the syntax and the functions of
the XL basic version). The gap that most pascal compilers do not come with
graphic functions has been filled by this, giving higher attractivity to
start with this language rather than with the (UGLY) basic. But don't expect
too much, since this library goes not much behind the GFABASIC standards.
In special, no "sprite" related graphics have been added yet.

Most of these examples has been worked out to teach pascal to my neighbor,
Ernst Besser, who is a teacher in arts. Since the usual pascal teach program
(calculate the area of an rectangle) is quite boring, I started this project,
resulting in a higher motivation for learning a computer language. After
all, I think pascal should be the first language to start with, although
I'm not a fan of (it's to "german" compared to C.... :-).

____________________________________________________________________________

                        The THOR-Software Licence


This License applies to the computer programs known as "WindowLib" and
its example programs, contained in this archive.
The "Program", below, refers to such program.


The programs and files in this distribution are freely distributable
under the restrictions stated below, but are also Copyright (c)
Thomas Richter.


Distribution of the Program by a commercial organization without written
permission from the author to any third party is prohibited if any payment
is made in connection with such distribution, whether directly
(as in payment for a copy of the Program) or indirectly (as in payment
for some service related to the Program, or payment for some product
or service that includes a copy of the Program "without charge";
these are only examples, and not an exhaustive enumeration of prohibited
activities). However, the following methods of distribution involving
payment shall not in and of themselves be a violation of this restriction:


(i) Posting the Program on a public access information storage and
retrieval service for which a fee is received for retrieving information
(such as an on-line service), provided that the fee is not
content-dependent (i.e., the fee would be the same for retrieving the same
volume of information consisting of random data).



(ii) Distributing the Program on a CD-ROM, provided that the files
containing the Program are reproduced entirely and verbatim on such
CD-ROM, and provided further that all information on such CD-ROM be
redistributable for non-commercial purposes without charge.



Everything in this distribution must be kept together, in original
and unmodified form.




Limitations.

THE PROGRAM IS PROVIDED TO YOU "AS IS," WITHOUT WARRANTY. THERE IS NO
WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
SERVICING, REPAIR OR CORRECTION.



IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE ALL FILES CONTAINED IN
THIS ARCHIVE.

_____________________________________________________________________________


Usage:
        Unpack this archive.

        Copy the contents of LIB to the library drawer of PCQ,
        usually assigned to LIB:

        Copy the contents of the "Examples" folder whereever you
        keep your sources.

        Copy the contents of the "Utils" drawer to the "Utils"
        subdirectory of the PCQ include folder.

        Copy this file whereever you want it.


To compile pascal programs with windowlib and the PCQ compiler, add the line

{$I "Include:Utils/windowlib.i"}

to your pascal program directly under the PROGRAM statement. Add the lines

    InitGraphics;

    {your main program goes here}

    ExitGraphics;

to your main program to initialize and shut down the windowlib, where your
private code that does the graphics should go between.

Compile your program as usual, but link your code with LIB:window.o like
in the following line:

BLink FROM  "prog.o"  TO "prog" LIB LIB:window.o LIB:PCQ.lib SC ND

where "prog" is the name of your program.


To make live even easier, the examples come with setting files for the
graphical make utility "ClickMake", which is also available from THOR or
from the aminet, but not contained in this archive. You may download it from
the aminet sides or from my home page, given at the end of this text.

Using ClickMake, you can compile these examples with one click of a button.


Besides the compiler, these examples are setup to work with:

1) the most popular CED editor.
2) the PCQ compiler (-:
3) the PhxAss assembler. This one can be also downloaded from the AmiNet
4) the BLink PD linker. Again, this can be found on the net.

Each of them has been tested, but if you have trouble, contact me:


        Thomas Richter

EMail:  [e-mail]

WWW:    http://www.math.tu-berlin.de/~thor/thor/index.html


To find out more about the functions of the windowlib, read the include file
in Utils/windowlib.i or study the examples.


    Thomas Richter        , February 1997