=============================================================================
PinsInSpace 1.00 by Pervect of Topix, 2001
=============================================================================
name: PinsInSpace
author: Eli-Jean R. Leyssens (pervect@topixweb.com)
size: 1021 bytes
needs: RISC OS 3 (StrongARM recommended)
descr.: Have an animated starfield for the Pinboard backdrop
-----------------------------------------------------------------------------
PinsInSpace
~~~~~~~~~~~
PinsInSpace gives you a nice animated starfield for the Pinboard backdrop.
The program was originally going to be called StarBoard, but unfortunately
somebody had already written a RISC OS program called StarBoard, so I had to
come up with another name. In case you hadn't noticed yet, PinsInSpace is a
wordplay on "Pigs In Space", the name of a recurring sketch in The Muppet
Show.
Usage
~~~~~
To start PinsInSpace just double-click the PinInSpace file or follow the
installation instructions below. You can quit PinsInSpace in two ways:
- press F12 or open a taskwindow and type: *RMKill PinsInSpace
- open the Tasks window, press the menu button over the Pinboard entry and
then choose Task 'Pinboard' -> Quit. This will only quit PinsInSpace, not the
actual Pinboard task. Note: selecting that Quit entry a second time will of
course quit the actual Pinboard task.
The speed at which one flies through the starfield can be controlled via the
CLI command "warp". Just press F12 or open a taskwindow and then type:
*Warp 1, Mr Sulu
*Warp 9, Let's rock!
Accepted speeds range from 0 to 9 and all text, including numbers, after the
first digit are simply ignored. So, *Warp 1000 is the same as *Warp 1.
The number of stars drawn will depend on the current speed of your computer.
That is, it is not only dependant upon the speed of the CPU, but also on the
current load. PinsInSpace always tries to reach at least 20 frames per
second. When it can not reach that because other programs are putting a heavy
load on the machine then it will reduce the number of stars until it either
reaches 20 frames per second again or until the minimum number of stars has
been reached.
Once the load on the machine by other applications drops, PinsInSpace will
start increasing the number of stars again until it either falls below 20
frames per second again or until it reaches the maximum number of stars.
Installation
~~~~~~~~~~~~
To install PinsInSpace just copy the PinInSpace file to your PreDesk
directory. Next time you reboot your computer PinsInSpace will automatically
be loaded.
Copyright notice and disclaimer
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
Archive contents
~~~~~~~~~~~~~~~~
Files included in this archive are:
PinInSpace ; The program itself
ReadMe ; This file
GPL ; Version 2 of the GNU General Public License
Source.!SetPaths ; Sets the PinsInSpaceWork$Dir
Source.!Squash ; Turns the PinInModul file into an absolute file
; called PinInAbs and then compresses that file
Source.ModToAbs ; Takes the PinInModul file and turns it into an
; absolute file called PinInAbs
Source.Build ; Build instructions (Sources->Final)
Greetings
~~~~~~~~~
Greetz go out to ARM'sTech, BASS, Devine Nature, DFI, GUS, Icebird, Kulture,
Moving Pixels, Reactive, TXP and of course to all CodeCraft participants!
Contact address
~~~~~~~~~~~~~~~
If you want to contact me or want to know more about Topix or Topix
productions:
TopixWEB: http://www.topixweb.com
Pervect : pervect@topixweb.com
Schivelbeinerstr. 5
10439 Berlin
Germany