===============================
----- IntyOS - v0.2 Alpha -----
===============================

Thank you for downloading IntyOS.

Sorry, there's currently no real documentation but the use of 
this thing should be pretty intuitive. Don't hesitate to send 
any question, comment or suggestion to a_chevallier@yahoo.com.
I will answer ASAP.

Have fun!

Arnauld

-------------------------------
Main URL: http://intyos.free.fr
Mirror:   http://intyos.spatula-city.org



===============================
+ How to run it
===============================

This is an "all-in-one" version which does not yet require 
bankswitching features. That means that it should be happy on 
any emulator (of course, it should also work on a real Inty). 
That also means that it's not yet possible to run several
instances of the same program simultaneously.

Next versions will allow to add any program or 'file' to the 
IntyOS ROM image before running it. They will require an 
Intellicart or Intellicart emulation.

On emulators, IntyOS should run fine with original Exec/Grom 
images or with the MiniExec and MiniGrom files included in 
Joe Z' SDK-1600 v4.


===============================
+ Core components
===============================

IntyOS includes the following core components:
- Multitasked kernel
- API functions
- GUI (the 'desk')
- Built-in tools

For now, here are just a few words below about the GUI and
the built-in tools.


===============================
+ GUI
===============================

Mouse pointer
-------------------------------
Use the disc to move it. Use any action button to 'click'.

Windows
-------------------------------
Use the title bar to move a window. Click on any part of the 
window to give it focus. Use the '(X)' button to close it.

Technical note: each window has its own 'device context' and 
own 'shadow GRAM', which means that a process has just to write 
data into these 2 areas and wait for the OS to load its cards 
into GRAM and render the window for it.

Menus
-------------------------------
They're currently used exclusively by the IntyOS desktop. But 
as they are built dynamically, it will be rather easy to have 
them used by any other process asking for that.

Texts
-------------------------------
IntyOS includes a variable-width system font and is able to 
generate GRAM cards on the fly to draw small texts with more 
than one character per card. This feature is mainly 
demonstrated with the menu bar and menu popups.


===============================
+ Built-in tools
===============================

Version 0.2 includes the following tools:
- Clock
- CPU load
- Hello
- IntyAmp

Clock
-------------------------------
A simple "HH:MM:SS" clock. It's currently not possible to set 
it at the correct time, so what you get is the time elapsed 
since last IntyOS startup.

CPU load
-------------------------------
This program will show the number of processes running on the 
system (P) and an estimation of the average number of free CPU 
cycles (F) during the last 32 frames. Actual value = displayed 
value x 25 (it may be completely wrong on some emulators).

Hello
-------------------------------
A simple 'Hello World' program. It will just open a window, 
display this relevant message and wait for the M_CLOSE message 
to be sent by the OS ;-)

IntyAmp
-------------------------------
Kind of Winamp :-) This is currently the most sophisticated 
example (and also the one which is using most CPU cycles). 
However, the 'open' button is not yet working and only one tune 
is included (that's the Stonix title).


===============================
+ Known bugs and limits
===============================

- IntyAmp (and potentially other tools) may crash after approx. 
9 minutes of use (timer counter overflow)

- Backtab rendering is in its infancy -- some flickers and 
latencies may be noted

