AMOS Professional extension for Visual Studio Code

AMOS Professional for Visual Studio Code is a extension to support AMOS language for the Amiga machines and emulators.

Visit the AMOS Professional MANUAL pages to discover more about AMOS. This extension comes with a full package of help files for most of the functions that AMOS Pro offers.

Demo

Why make this?

I loved AMOSPro back in the days. I coded lots of stuff. Games and utilities. I later found my living in AmigaE, so. I parted from AMOS and started on a new journey. Now, decades later I have been wondering to pick up AMOSPro again. And do some Amiga games coding and probably port some of my C64 games. But, I felt like not using the editor AMOSPro is using, since I love to use VSCode for like; Everything. So, I kind of dropped the idea of porting anything. Until lately when a friend of mine from the Amiga twitch community said; It would be cool having an AMOSPro extension. So.. That got me interested. And since I have made a vscode extension before, it felt like a possible project to finish up.

So here it is, for you to use. Hope you like this extension.

Features

This extension supports/features the following:

• Syntax Highlighting

  • Full syntax highlighting for AMOS commands, functions, structures, and directives.

  • Includes support for both AMOSPro and AMOS 1.3 syntax.

• Code Snippets

  • Handy one-line and block snippets for common AMOS structures.

  • Easily insert templates for loops, procedures, graphics commands, and more.

• Command Hover Help

  • Hover over any AMOS command to see inline documentation.

  • Help text is loaded from Markdown files stored in the extension’s /docs folder.

• File Association

  • Automatically recognizes .amos and .asc files as AMOS code.

• Custom Keywords Support

  • Built-in flexibility to add support for additional commands or variations (e.g., AMOSPro extensions).

• Lightweight and Fast

  • Minimal dependencies and optimized for performance, even on low-end or emulated systems.

• Smart Snippet Auto-completion
  • Start typing any AMOS keyword (e.g. spri) to get a list of matching commands.
  • Choose from categorized suggestions like Sprite Base, Sprite Col, etc.
  • Selected snippets insert the full command with argument placeholders for quick editing.

Need to know

So, this extension do not import any amos basic files or interpret functions to AMOS basic. The extension .amos is mostly meant for telling you what file this is. I would recommend that you to use .asc instead, since you will be needing to "merge" the source code into AMOS/AMOSPro for testing.

This extension is probably not 100% done, and there may be lots of functionality that is missing, or missing parts of the documntation. This extension is a project of "work in progress". And will be updated when I find things that is missing. Or you as the user finds things you want to be included or fixed.

Requirements

• Windows/Linux/Mac.. Well, what ever system that is supported by VSCode.
• AMOSPro
• VSCode
• Amiga Emulator/Amiga hardware that you can test on.

Now what?

Well, start coding and have fun. How? Well. Lets get moving.

1. Create a new folder for your AMOS coding. Preferable in a folder that can be reached by WinUAE/FS-UAE/Hardware.
2. Create a file called eg: helloworld.asc
3. Make sure that the language mode in VSCode is set to AMOS after you have made the file with .amos or .asc file extension.
4. Write up some code
5. Save it
6. Start WinUAE/FS-UAE, fire opp AMOSPro.
7. When AMOSPro is running, watch this demo how to import it to AMOS. Make sure it's an .ASC file.

If you can't see the gif file above for some reasons, follow these steps how to import the file into AMOSPro.

1. In AMOSPro - right click to get the menus. Go into the Project menu.
2. From here move the mouse downwards till find Merge ASCII, select this.
3. Find your file and import it.
4. Thats it.

The code if you don't want to write the helloworld.asc yourself.

'
' AMOS/AMOS Professional extension test
'

Screen Open 0,320,200,16,Lowres
Cls 0 : Paper 0: Flash Off
Print "Hello world!"

Who am I and how to reach me?

I'm Docster, a retro coder, mainly coding games for the C64 and Amiga. I do also code utilities and what ever I need for my projects. If you like to checkout my itch page, you are welcome to do so. You can find me (Docster) on Discord or itch.io, under any of the following Discord servers/itch account:

Discord servers:

Amiga Code - Photon Of Scoopex, Amiga coding and fun

Retro32UK - Amiga and other platform coding (home of TTE)

OldskoolCoder - C64/Amiga and other platforms coding

Phaze101 - C64/Amiga and other platforms coding

itch.io:

Docster's Hideout

Thanks and credits

All documentation in this extension is from the amospro webpage.

Thanks to François Lionet for creating AMOS/AMOSPro and made many of us very happy back in the 90s. Thanks to Fredrik Rambris for creating the manual webpage. Thanks to Princephaze for talking me "into it" to make this extension.

Greetings to everybody I know from the C64 and Amiga scene