Apple-2-SW/prog8
1
0
Fork 0
mirror of https://github.com/irmen/prog8.git synced 2024-11-20 03:32:05 +00:00
Code Issues Projects Releases Wiki Activity

library source links

Browse Source
This commit is contained in:
Irmen de Jong 2023-06-18 02:31:45 +02:00
parent ff7f3484e4
commit 4bb9ae61f2
2 changed files with 28 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
docs/source/libraries.rst
View File

@ -140,6 +140,9 @@ Routines to convert strings to numbers or vice versa.
- numbers to strings, in various formats (binary, hex, decimal) - numbers to strings, in various formats (binary, hex, decimal)
- strings in decimal, hex and binary format into numbers (bytes, words) - strings in decimal, hex and binary format into numbers (bytes, words)
Read the `source code <https://github.com/irmen/prog8/tree/master/compiler/res/prog8lib/conv.p8>`_
to see what's in there.
textio (txt.*) textio (txt.*)
-------------- --------------
@ -152,6 +155,9 @@ dealing with text-based input and output (to the screen). Such as
- scrolling the text on the screen - scrolling the text on the screen
- placing individual characters on the screen - placing individual characters on the screen
Read the `source code <https://github.com/irmen/prog8/tree/master/compiler/res/prog8lib/cx16/textio.p8>`_
to see what's in there. (Note: slight variations for different compiler targets)
diskio diskio
------ ------
@ -172,6 +178,9 @@ Also contains a helper function to calculate the file size of a loaded file (alt
to 16 bits, 64Kb) to 16 bits, 64Kb)
Als contains routines for operating on subdirectories (chdir, mkdir, rmdir) and to relabel the disk. Als contains routines for operating on subdirectories (chdir, mkdir, rmdir) and to relabel the disk.
Read the `source code <https://github.com/irmen/prog8/tree/master/compiler/res/prog8lib/cx16/diskio.p8>`_
to see what's in there. (Note: slight variations for different compiler targets)
string string
------ ------
@ -313,7 +322,7 @@ point variables. This includes ``print_f``, the routine used to print floating
graphics graphics
-------- --------
Monochrome bitmap graphics routines, fixed 320*200 resolution: Bitmap graphics routines:
- clearing the screen - clearing the screen
- drawing individual pixels - drawing individual pixels
@ -322,7 +331,10 @@ Monochrome bitmap graphics routines, fixed 320*200 resolution:
This library is available both on the C64 and the Cx16. This library is available both on the C64 and the Cx16.
It uses the ROM based graphics routines on the latter, and it is a very small library because of that. It uses the ROM based graphics routines on the latter, and it is a very small library because of that.
That also means though that it is constrained to 320*200 resolution on the Cx16 as well. That also means though that it is constrained to 320*200 resolution on the Cx16 as well.
Use the ``gfx2`` library if you want full-screen graphics or non-monochrome drawing (only on Cx16). Use the ``gfx2`` library if you want full-screen graphics or non-monochrome drawing (only on Cx16). See below for that one.
Read the `source code <https://github.com/irmen/prog8/tree/master/compiler/res/prog8lib/c64/graphics.p8>`_
to see what's in there. (Note: slight variations for different compiler targets)
math math
@ -395,6 +407,11 @@ cx16logo
Just a fun module that contains the Commander X16 logo in PETSCII graphics Just a fun module that contains the Commander X16 logo in PETSCII graphics
and allows you to print it anywhere on the screen. and allows you to print it anywhere on the screen.
``logo ()``
prints the logo at the current cursor position
``logo_at (column, row)``
printss the logo at the given position
prog8_lib prog8_lib
--------- ---------
@ -414,6 +431,9 @@ Full-screen multicolor bitmap graphics routines, available on the Cx16 machine o
- drawing text inside the bitmap - drawing text inside the bitmap
- in monochrome mode, it's possible to use a stippled drawing pattern to simulate a shade of gray. - in monochrome mode, it's possible to use a stippled drawing pattern to simulate a shade of gray.
Read the `source code <https://github.com/irmen/prog8/tree/master/compiler/res/prog8lib/cx16/gfx2.p8>`_
to see what's in there.
palette (cx16 only) palette (cx16 only)
-------------------- --------------------
@ -422,6 +442,9 @@ There are also a few better looking Commodore 64 color palettes available here,
because the Commander X16's default colors for this (the first 16 colors) are too saturated because the Commander X16's default colors for this (the first 16 colors) are too saturated
and are quite different than how they looked on a VIC-II chip in a C64. and are quite different than how they looked on a VIC-II chip in a C64.
Read the `source code <https://github.com/irmen/prog8/tree/master/compiler/res/prog8lib/cx16/palette.p8>`_
to see what's in there.
psg (cx16 only) psg (cx16 only)
---------------- ----------------
@ -429,5 +452,7 @@ Available for the Cx16 target.
Contains a simple abstraction for the Vera's PSG (programmable sound generator) to play simple waveforms. Contains a simple abstraction for the Vera's PSG (programmable sound generator) to play simple waveforms.
It includes an interrupt routine to handle simple Attack/Release envelopes as well. It includes an interrupt routine to handle simple Attack/Release envelopes as well.
See the examples/cx16/bdmusic.p8 program for ideas how to use it. See the examples/cx16/bdmusic.p8 program for ideas how to use it.
Read the source of this library module for details about the API.
Read the `source code <https://github.com/irmen/prog8/tree/master/compiler/res/prog8lib/cx16/psg.p8>`_
to see what's in there. (Note: slight variations for different compiler targets)

2
docs/source/todo.rst
View File

@ -1,8 +1,6 @@
TODO TODO
==== ====
- document some library modules better (diskio, etc)
... ...