S.U.P.E.R. HP 200LX Archive
← Back to the catalogue

FORTHPAL Toolkit

Version 1 · Peniel Romanelli

Programming
Download 11.7 KB

Description

This is a small toolkit for use with the HP-Pygmy Forth. It assumes that you have the HP-Pygmy Rel. 2 and are reasonably familiar with the Forth language. It's meant to make it easier to create Forth apps with the look and feel of the LX's built-in programs or those created using PAL.

Technical details

File
forthpal.zip
Size
11.7 KB
Format
.zip
Year
1999
Added to S.U.P.E.R.
1999-09-16
Files inside
3
Author
Peniel Romanelli
Path
anonftp/pub/forthpal.zip

How to install it

What to send to the palmtop saves 60.4 KB

No need to put FORTHPAL.DOW, FORTHPAL.TXT, FORTHPAL.SCR: they are manuals, source code or supporting material. Read them here and save 60.4 KB on a 1 MB disk.

Steps
  1. This package has no recognisable executables. Download it and look at its contents: it may be documentation, source code or supporting material.

Derived from the package contents and the 200LX conventions. It installs to A: on purpose: C: is a RAM disk and every byte there is memory taken from the system.

The author's instructions 
INSTALLATION AND SETUP

Just copy FORTHPAL.SCR and FORTHPAL.DOW to your directory with HP-Pygmy
Forth.  FORTHPAL.DOW is the shadow block file with explanations of the
words in FORTHPAL.SCR

To use these together open FORTHPAL.SCR in a free even-numbered slot,
and FORTHPAL.DOW in the following odd-numbered one.  e.g.
" FORTHPAL.SCR" 8 OPEN
" FORTHPAL.DOW" 9 OPEN
To switch between these use CTRL-A when in the editor.

The extensions nust be loaded before loading FORTHPAL.  Graphic scroll
from the extensions (Block 3011) must also be loaded.  It's not loaded
by default.

The load block assumes you installed FORTHPAL as unit 8 (starting at
block# 8000).  Do 8001 LOAD to load the toolkit.  If you install it in
a different unit #, you'll need to edit the load block.  There's also
a useless demo/test of the tools called SAMPLE - and a simple Forth
source viewer that's faster than the editor, and could eventually be
the basis for a graphic mode editor (or maybe not...)

Files:

forthpal.txt      This document
forthpal.scr      Forth source block file
forthpal.dow      The shadow block file


THE TOOLS

The tools are described here.  There are many variables, arrays, and
support words not listed here.  See the source and shadow blocks for
info...


PADDING ( n  -) Sets interline padding (blank pixel lines between text
       lines).  Limited to 5 lines max - default = 0.

SETPOS ( x y  -) Stores the coordinates (in pixels) in text position
       variables.
G-TAB  ( x    -) Stores X-coordinate in a text position variable -
       keeps existing Y coord.
G-AT   ( r c  - x y) Converts row/column coordinates to pixel coords.
       Applies in the working area between the title bar and function
       key labels.  (Pixel coords  0,13 to 639,188).  Also stores x,y
…

Literal excerpt from FORTHPAL.TXT, exactly as it came in the package.

Send to my palmtop

The palmtop must be waiting before you press the button, or the transfer will fail. It is the palmtop that announces it is ready, not the other way round.

First time? How to connect the palmtop, step by step →

Related