mirror of
https://github.com/cc65/cc65.git
synced 2025-08-10 04:25:21 +00:00
Corrected minor spelling errors
git-svn-id: svn://svn.cc65.org/cc65/trunk@3103 b7a2c559-68d2-44c3-8de9-860c34a00d81
This commit is contained in:
@@ -9,7 +9,7 @@
|
|||||||
<date>v1.5, 26.12.1999, 2000, 2001, 2002, 2003
|
<date>v1.5, 26.12.1999, 2000, 2001, 2002, 2003
|
||||||
<abstract>
|
<abstract>
|
||||||
This is the documentation of cc65's GEOSLib, but information contained here may be also
|
This is the documentation of cc65's GEOSLib, but information contained here may be also
|
||||||
useful for writting GEOS applications in general.
|
useful for writing GEOS applications in general.
|
||||||
</abstract>
|
</abstract>
|
||||||
|
|
||||||
<!-- Table of contents -->
|
<!-- Table of contents -->
|
||||||
@@ -68,7 +68,7 @@ cc65 to simple <tt/lda/ and <tt/sta/. Don't be afraid to use C syntax.
|
|||||||
<sect1>Requirements
|
<sect1>Requirements
|
||||||
<p>
|
<p>
|
||||||
You will not need c64 or c128 for development. The only hardware requirement is a PC capable of
|
You will not need c64 or c128 for development. The only hardware requirement is a PC capable of
|
||||||
runing cc65. You will however need c64 or c128 emulator and GEOS image disks (.d64) to test your
|
running cc65. You will however need c64 or c128 emulator and GEOS image disks (.d64) to test your
|
||||||
programs.
|
programs.
|
||||||
|
|
||||||
The software needed:
|
The software needed:
|
||||||
@@ -86,7 +86,7 @@ The software needed:
|
|||||||
disk image files.
|
disk image files.
|
||||||
<item><em/cbm4linux/ A Linux kernel module that allows for communication with 1541 and
|
<item><em/cbm4linux/ A Linux kernel module that allows for communication with 1541 and
|
||||||
other Commodore IEC bus drives. It can be replacement for Star Commander if
|
other Commodore IEC bus drives. It can be replacement for Star Commander if
|
||||||
you want only to transfer files to a disk and uncovert using GEOS program for
|
you want only to transfer files to a disk and unconvert using GEOS program for
|
||||||
this purpose. Check out: <htmlurl url="http://www.lb.shuttle.de/puffin/cbm4linux/"
|
this purpose. Check out: <htmlurl url="http://www.lb.shuttle.de/puffin/cbm4linux/"
|
||||||
name="http://www.lb.shuttle.de/puffin/cbm4linux">
|
name="http://www.lb.shuttle.de/puffin/cbm4linux">
|
||||||
</itemize>
|
</itemize>
|
||||||
@@ -123,7 +123,7 @@ This chapter describes some rules you ought to obey, and how to use GEOSLib.
|
|||||||
<p>
|
<p>
|
||||||
Apart from this file, which merely describes only standard GEOS library functions, you should read
|
Apart from this file, which merely describes only standard GEOS library functions, you should read
|
||||||
<tt/grc/ (GEOS resource compiler) documentation. There are informations about necessary resource
|
<tt/grc/ (GEOS resource compiler) documentation. There are informations about necessary resource
|
||||||
files (each GEOS application neeeds at least one) and the building process - what should be done
|
files (each GEOS application needs at least one) and the building process - what should be done
|
||||||
and in what order. Please also read cc65's documentation on how to compile C, assembler and link
|
and in what order. Please also read cc65's documentation on how to compile C, assembler and link
|
||||||
everything together.
|
everything together.
|
||||||
<p>
|
<p>
|
||||||
@@ -177,7 +177,7 @@ wanted to avoid unnecessary pushing and popping arguments from stack because cc6
|
|||||||
Do not try to compile in strict ANSI mode. Library uses cc65 extensions which are not available in
|
Do not try to compile in strict ANSI mode. Library uses cc65 extensions which are not available in
|
||||||
ANSI.
|
ANSI.
|
||||||
<p>
|
<p>
|
||||||
It is possible to use dynamicaly loaded modules, three such modules are provided:
|
It is possible to use dynamically loaded modules, three such modules are provided:
|
||||||
GEOS TGI driver, GEOS EMD driver (for VDC extended memory) and GEOS JOY driver.
|
GEOS TGI driver, GEOS EMD driver (for VDC extended memory) and GEOS JOY driver.
|
||||||
Just make sure that their filenames appear UPPERCASE in DeskTop. There are no more special
|
Just make sure that their filenames appear UPPERCASE in DeskTop. There are no more special
|
||||||
recommendations, read cc65 documentation about modules and demo programs source code.
|
recommendations, read cc65 documentation about modules and demo programs source code.
|
||||||
@@ -407,7 +407,7 @@ Here you will find information about functions related with menus and icons.
|
|||||||
|
|
||||||
<sect2>Menus
|
<sect2>Menus
|
||||||
<p>
|
<p>
|
||||||
Menus are essencial for GUI. GEOS can handle only one menu at a time, but each menu can call
|
Menus are essential for GUI. GEOS can handle only one menu at a time, but each menu can call
|
||||||
another one, which results in submenu tree. There can be up to 8 menu levels, each one with up
|
another one, which results in submenu tree. There can be up to 8 menu levels, each one with up
|
||||||
to 32 items.
|
to 32 items.
|
||||||
<p>
|
<p>
|
||||||
@@ -462,7 +462,7 @@ same as <tt/DoPreviousMenu/.
|
|||||||
Icons are working similar to menus except the fact that there is only one level. Icons are
|
Icons are working similar to menus except the fact that there is only one level. Icons are
|
||||||
defined as a screen area filled with a bitmap, but if you would setup icons and erase the
|
defined as a screen area filled with a bitmap, but if you would setup icons and erase the
|
||||||
screen they are still active and clicking in the place where formerly an icon was will cause
|
screen they are still active and clicking in the place where formerly an icon was will cause
|
||||||
an effect. Similary if you would setup icons and then turn them off with <tt/ClearMouseMode/
|
an effect. Similarly if you would setup icons and then turn them off with <tt/ClearMouseMode/
|
||||||
the bitmap will be still on the screen but clicking on it would not cause any action.
|
the bitmap will be still on the screen but clicking on it would not cause any action.
|
||||||
There is only one, but powerful icon function.
|
There is only one, but powerful icon function.
|
||||||
|
|
||||||
@@ -573,7 +573,7 @@ calls <tt/MouseUp/.
|
|||||||
<p>
|
<p>
|
||||||
<tt/void ClearMouseMode (void)/
|
<tt/void ClearMouseMode (void)/
|
||||||
<p>
|
<p>
|
||||||
This function disables all mouse actitivies - icons and menus stop to respond to mouse events,
|
This function disables all mouse activities - icons and menus stop to respond to mouse events,
|
||||||
but they are not cleared from the screen.
|
but they are not cleared from the screen.
|
||||||
|
|
||||||
<sect3>MouseUp and MouseOff
|
<sect3>MouseUp and MouseOff
|
||||||
@@ -696,8 +696,8 @@ enabled. <tt/ReadBlock/ assumes that it is already enabled thus being slightly f
|
|||||||
<p>
|
<p>
|
||||||
<tt/char VerWriteBlock (struct tr_se *myTrSe, char *buffer)/
|
<tt/char VerWriteBlock (struct tr_se *myTrSe, char *buffer)/
|
||||||
<p>
|
<p>
|
||||||
Similar to previous but needed for writting the disk. <tt/VerWriteBlock/ verifies the data after
|
Similar to previous but needed for writing the disk. <tt/VerWriteBlock/ verifies the data after
|
||||||
writting. In case of error five tries are attempted before error code is returned.
|
writing. In case of error five tries are attempted before error code is returned.
|
||||||
|
|
||||||
<sect2>Directory header
|
<sect2>Directory header
|
||||||
<p>
|
<p>
|
||||||
@@ -718,7 +718,7 @@ Note that passed pointer must point to an array of at least 17 bytes.
|
|||||||
<p>
|
<p>
|
||||||
<tt/char PutDirHead (void)/
|
<tt/char PutDirHead (void)/
|
||||||
<p>
|
<p>
|
||||||
These functions are reading and writting the directory header. You should use <tt/GetDirHead/ before
|
These functions are reading and writing the directory header. You should use <tt/GetDirHead/ before
|
||||||
using any functions described below, and you should use <tt/PutDirHead/ to save the changes on the
|
using any functions described below, and you should use <tt/PutDirHead/ to save the changes on the
|
||||||
disk. Otherwise they will be lost. Operating area is the <tt/curDirHead/.
|
disk. Otherwise they will be lost. Operating area is the <tt/curDirHead/.
|
||||||
|
|
||||||
@@ -769,7 +769,7 @@ Anyway, I feel that this function is too low-level.
|
|||||||
<p>
|
<p>
|
||||||
Both functions are allocating enough disk sectors to fit the number of <tt/length/ in them. You
|
Both functions are allocating enough disk sectors to fit the number of <tt/length/ in them. You
|
||||||
will find output in <tt/output/ which is table of <tt/struct tr_se/. The last entry will have the
|
will find output in <tt/output/ which is table of <tt/struct tr_se/. The last entry will have the
|
||||||
number of track equal to 0 and sector equal to 255. The simpliest way of using them is to use
|
number of track equal to 0 and sector equal to 255. The simplest way of using them is to use
|
||||||
predefined space in GEOS data space and pass <tt/fileTrScTab/, which is a predefined table.
|
predefined space in GEOS data space and pass <tt/fileTrScTab/, which is a predefined table.
|
||||||
<p>
|
<p>
|
||||||
The difference between those two is that <tt/NextBlkAlloc/ will start allocating from given sector,
|
The difference between those two is that <tt/NextBlkAlloc/ will start allocating from given sector,
|
||||||
@@ -963,7 +963,7 @@ want to skip before searching for a free slot for directory entry. In most cases
|
|||||||
<tt/0/ there.
|
<tt/0/ there.
|
||||||
<p>
|
<p>
|
||||||
You have to declare a <tt/struct fileheader/ and fill it with proper values. There is only one
|
You have to declare a <tt/struct fileheader/ and fill it with proper values. There is only one
|
||||||
difference - the first two bytes which are link to nonexistant next sector are replaced by a
|
difference - the first two bytes which are link to nonexistent next sector are replaced by a
|
||||||
pointer to the DOS filename of the file.
|
pointer to the DOS filename of the file.
|
||||||
<p>
|
<p>
|
||||||
When saving sequential files two most important fields in <tt/struct fileheader/ are <tt/fileheader.load_address/
|
When saving sequential files two most important fields in <tt/struct fileheader/ are <tt/fileheader.load_address/
|
||||||
@@ -1076,7 +1076,7 @@ are replacement for those like <tt/memset, memcpy, strcpy/ etc. from standard li
|
|||||||
If you are dealing with short strings (up to 255 characters) you should use these functions
|
If you are dealing with short strings (up to 255 characters) you should use these functions
|
||||||
instead of standard ones. E.g. <tt/CopyString/ instead of <tt/strcpy/. It will work faster.
|
instead of standard ones. E.g. <tt/CopyString/ instead of <tt/strcpy/. It will work faster.
|
||||||
<p>
|
<p>
|
||||||
However some of them have slighty different calling convention (order of arguments to be specific),
|
However some of them have slightly different calling convention (order of arguments to be specific),
|
||||||
so please check their syntax here before direct replacing.
|
so please check their syntax here before direct replacing.
|
||||||
<p>
|
<p>
|
||||||
Please note that the memory areas described here as <em/strings/ are up to 255 characters (without
|
Please note that the memory areas described here as <em/strings/ are up to 255 characters (without
|
||||||
@@ -1367,7 +1367,7 @@ This structure describes a font in one pointsize. There is current font - <tt/st
|
|||||||
bound to <tt/curFontDesc/. You can also force GEOS to use your own fonts by calling
|
bound to <tt/curFontDesc/. You can also force GEOS to use your own fonts by calling
|
||||||
<tt/LoadCharSet/. You just need to open a VLIR font file and load one record - one pointsize -
|
<tt/LoadCharSet/. You just need to open a VLIR font file and load one record - one pointsize -
|
||||||
somewhere. At the start of this area you already have all data for <tt/fontdesc/ so you can
|
somewhere. At the start of this area you already have all data for <tt/fontdesc/ so you can
|
||||||
pass a pointer to the load adress of that pointsize to <tt/LoadCharSet/. (Note that although
|
pass a pointer to the load address of that pointsize to <tt/LoadCharSet/. (Note that although
|
||||||
it has 'Load' in the name, that function loads only GEOS internal data structures, not data
|
it has 'Load' in the name, that function loads only GEOS internal data structures, not data
|
||||||
from disk).
|
from disk).
|
||||||
|
|
||||||
|
Reference in New Issue
Block a user