Table of Contents

1. Getting Started

1.1 What is Cogsys?
1.2 Setting Up Cogsys

1.2.1 Requirements

A note on Windows

1.2.2 Getting Cogsys
1.2.3 Installation
1.2.4 Testing the Installation
1.2.5 Installation Problems
1.2.6 Uninstalling Cogsys

1.3 Running Cogsys

1.3.1 The cogsys program
1.3.2 Network installation

1.3.2.1 Serial Connection
1.3.2.2 Ethernet Connection

2. Command Reference

2.1 The cogsys program

2.1.1 Invoking Cogsys
2.1.2 Global Settings

2.2 Runtime Operation

2.2.1 Breakout Character
2.2.2 Saving Ouput on Error

2.3 Command Categories

2.3.1 Control Commands

2.3.1.1 Wait (#W)
2.3.1.2 Output (#S)
2.3.1.3 Assign Variable ($A)
2.3.1.4 Assign Variable from Console ($G)
2.3.1.5 Arithmetic ($M)
2.3.1.6 If Control (#I)
2.3.1.7 Define Macro ($$x)
2.3.1.8 Run Macro ($x)
2.3.1.9 Exec and Return to Cogsys (%E)
2.3.1.10 Load External Routine (%X)

2.3.2 Direct Keyboard Input

2.3.2.1 Get Key Response (#R)
2.3.2.2 Get Timed Key Response (#C)
2.3.2.3 Echo Keyboard to Output ($L)

2.3.3 Video Control

2.3.3.1 Mode (%M)
2.3.3.2 Refresh Rate (#F)

2.3.4 Text Output

2.3.4.1 Text-Mode Display Text
2.3.4.2 Text-Mode Escape Character (\x)
2.3.4.3 Graphics-Mode Display Text (#G)
2.3.4.4 Clear Screen, Cursor Home (@C)
2.3.4.5 Clear Screen, Cursor Stays (@R)
2.3.4.6 Text-Mode Move Cursor (@xxyy)
2.3.4.7 Text-Mode Cursor Down (@D)
2.3.4.8 Text-Mode Newline (@N)
2.3.4.9 Graphics-Mode Text Attributes (%A)
2.3.4.10 Display Last Response Time ($R)
2.3.4.11 Display Variable Value ($S)
2.3.4.12 Wait-Present-Response (#P)

2.3.5 Picture Output

2.3.5.1 Reset Picture List/Type (%C)
2.3.5.2 Load Picture List (%Q)
2.3.5.3 Load Picture References (%B)
2.3.5.4 Display Picture (#B)
2.3.5.5 Create Pictures from CXR (%I)
2.3.5.6 Multiframe Picture Display (%J)
2.3.5.7 Multiframe Cycling Picture Response (%K)
2.3.5.8 Multiframe Picture Response (%L)

2.3.6 Scope (Digital Display) Commands

2.3.6.1 Set Scope Attributes (#A)
2.3.6.2 Scope Display (#U)
2.3.6.3 Scope Response (#Y)
2.3.6.4 Scope Timed Response (#T)

2.3.7 Game Port Commands

2.3.7.1 Wait Any Button (#K)
2.3.7.2 Wait for J1B1 (+/- J2B1) (#L)
2.3.7.3 Button Response (#V)
2.3.7.4 Timed Button J1B1 (+/- J2B1) Response (#M)
2.3.7.5 Timed Response Any Button (#Q)

2.4 Error Messages

3. Extensions

3.1 Introducing Extensions

3.1.1 What is a Cogsys Extension Routine (CXR) ?
3.1.2 Why would you need a CXR?
3.1.3 How do I use a CXR?
3.1.4 How do Cogsys Extensions Work?

3.1.4.1 Programs and Linking
3.1.4.2 Cogsys Extensions

3.2 Creating Extensions

3.2.1 Making the Extension
3.2.2 Writing a New Extension

3.2.2.1 Passed Arguments
3.2.2.2 Main Program Objects
3.2.2.3 Data Segments

3.3 Extension Reference

3.3.1 Extension Use
3.3.2 SQUAREXT

SQUAREXT Implementation

3.3.3 CIRCEXT

CIRCEXT Implementation

3.3.4 RANDEXT

3.3.4.1 RANDEXT Subfunction 1: random-dot square
3.3.4.2 RANDEXT Subfunction 2: random-dot square series
3.3.4.3 RANDEXT Subfunction 3: solid picture
3.3.4.4 RANDEXT Subfunction 4: alternating checkerboard
3.3.4.5 RANDEXT Subfunction 5: grayscale square
RANDEXT Implementation

3.3.5 TXTEXT

3.3.5.1 TXTEXT Subfunction 1: draw text
3.3.5.2 TXTEXT Subfunction 2: Mask - random image clip
3.3.5.3 TXTEXT Subfunction 3: Mask - random white dots
3.3.5.4 TXTEXT Subfunction 4: Mask - random flipped dots
TXTEXT Implementation

4. Internals

4.1 Compiling Cogsys

4.1.1 Setting Cogsys Constants

4.2 New Directions

A. Standard Palette
Concept Index
Command Characters Index