Language support for Integer BASIC in Visual Studio Code.
If you are viewing this on github, you can install the extension from VS Code by searching the Marketplace for
- Semantic highlights true to Apple ][ ROM parsing
- Completions and hovers for all statements
- Completions and hovers for soft switches, ROM routines, etc.
- Diagnostics to identify errors and gotchas
- Renumber lines in a selection or full document
- Transfer programs to and from Apple ][ emulators (see below)
- View tokenized program as hex dump and unicode text
- Options : see
- Commands: see
- Activates for file extensions
Apple ][ Special Addresses
The extension knows hundreds of special address locations relevant to Integer BASIC, Applesoft, DOS 3.3, ProDOS, and the Apple ][ ROM. Hovering over a literal address argument of
POKE will display information about any address in the database. Completions for special addresses are triggered when the
space key is pressed following
POKE. A convenient way to do this is to select the snippet with the
special annotation, and then immediately press
Using with AppleWin
You can transfer programs to and from AppleWin. One way is to use the emulator's own clipboard functions. The extension also provides the following save state interactions:
- To transfer a program to AppleWin, first use AppleWin to create a state file (press
F11). Then in the editor use
Ctrl-P to select
integerbasic: Store program in AppleWin save state, and select the state file. Then go to AppleWin and press
F12 to load the modified state file. Type
LIST to verify success.
- Any program or variables already in the state file are lost.
- The state file used for this should be a "safe state," e.g., machine awaiting line entry.
HIMEM are retained. If the program would break
LOMEM the operation is aborted.
- To transfer a program from AppleWin, make sure the program is in the emulated machine's memory, and create a state file by pressing
F11. Once you have the state file, return to the editor, position the cursor at the insertion point, and use
Ctrl-P to select
integerbasic: Insert program from AppleWin save state. Select the state file and the program should be inserted.
Operations with the state file are the same on any platform, but AppleWin itself is native to Windows. Note that AppleWin is not part of the extension, and must be installed separately.
Using with Virtual ][
You can transfer programs to and from the Virtual ][ emulator. One way is to use the emulator's own clipboard functions. The extension also provides the following commands (
integerbasic: Enter in Virtual ][ new machine: creates a new virtual machine, exits the Monitor to BASIC, and enters the program. There will be no DOS commands available. This is suitable for self-contained programs.
integerbasic: Run in Virtual ][ new machine: same as above, except the program is also run in the same step.
integerbasic: Enter in Virtual ][ front machine: attempts to enter program into the machine in the front window. This allows you to configure the machine any way you like, but is more dangerous, since we cannot know what the machine is doing at the moment you give the command. Existing program and variables are erased.
integerbasic: Run in Virtual ][ front machine: same as above, except the program is also run in the same step.
integerbasic: Insert program from Virtual ][ front machine: extracts the Integer program currently in the memory of the virtual machine, and inserts it at the position of the cursor or selection.
This capability only applies to MacOS. Note that Virtual ][ is not part of the extension, and must be installed separately.