From Retrosoftware

Revision as of 08:50, 8 March 2008 (edit) Steveo (Talk | contribs) (→SWIFT) ← Previous diff		Revision as of 08:52, 8 March 2008 (edit) (undo) Steveo (Talk | contribs) (→Download) Next diff →
Line 47:		Line 47:
	|Changes:		|Changes:
	* Sprite Editor added		* Sprite Editor added
		+	* Data format for Sprite Collections included as PDF
	Limitations:		Limitations:

---

Revision as of 08:52, 8 March 2008

Contents 1 SWIFT 1.1 Introduction 1.2 Download 1.3 Download 1.4 Additional Software 1.5 Tutorials 1.6 Feedback

SWIFT

A BBC Micro Integrated Development Environment, for Windows

Click for larger picture

Introduction

Swift is a Project Management tool for handling BBC Micro Machine Code.

These are its main features:

• Project based (you can have many sources files in your project, assembler,sprite collections and raw binary data)
• Built in code editor
• Built in Sprite Editor
• Built in hex editor (for raw data files)
• As many code,sprite and hex windows open as you wish
• Multiple assemblers can be installed into Swift, although at present only the P65 is tested as working (and is the recommended install)
• One click assembly (just click a button to get the assembler associated with your project to assemble the source) with all errors and reporting coming back into an error window within the IDE
• Supports error throwback - double clicking an error opens the appropriate code window and highlights the line
• All project items have their own properties and you can assign notes to them
• Multiple emulators can be installed into Swift and each project you have can have a different emulator assigned to it (although only tested and guaranteed to work with BeebEm at present)
• Assembled code can be written direct to a DFS disk image of your choice (which can be set for individual projects)
• One Click Testing: you can click one button that will assemble your source code, write it to your projects DFS disk, auto launch the emulator you've chosen for this project, load the disk and, if required, make the emulator run your code ... all in one click from the IDE!
• Assembler editor windows can be configured for background colour and font
• Supports extra options for merging various files within your project together to produce one object file, yet allowing you to keep logical parts of your project in seperate files
• Supports projects where code is placed in seperate areas of the BBC's memory, allowing them to be easily referenced from other code in your project via use of calling labels... no need to remember hex addresses anymore!
• Search facility for both assembler source and binary files. Allowing searching of all files in project with an easy to access search results window
• Code Limits: allows you to set warnings if your grows in size beyond a given memory address.

---

Download

Download

Date:	8-Mar-2008
Filename:	Swift V2_5.zip
Filesize:	671kb
Release Notes:	Changes: Sprite Editor added Data format for Sprite Collections included as PDF Limitations: Only supports Mode 2 with or without logical coloutr mask

Date:	1-Feb-2008
Filename:	Swift-V2.zip
Filesize:	610kb
Release Notes:	Changes: Project Manager control window All files in project viewable and accessible from floating Project Manager window New files can be added/linked to/copied and added via the Project Manager All labels in source files are listed in Project Manager After succesful assembly labels will have address values Double clicking labels takes you to that label in the source file Print function for source code windows. Support for BeebASM 0.6 Open Project item removed Default editor colours changed for colours that show up well on a colour printer Bugs fixed from previous version that prevented new items being added to new projects

Date:	1-Jan-2008
Filename:	Swift-v1.1.zip
Filesize:	544kb
Release Notes:	Changes: BeebASM profile added, can now handle projects written in BeebASM Editor has had a major revamp and now has the following user settable options: Line Numbers Page width indicator (right margin indicator) Tab amount (number of spaces inserted when tab pressed) The colours and styles of the following elements can be set: Comments Instructions (i.e. LDA, STA) Strings Selections Keys to indent blocks of text has changed from [CTRL]+[SHIFT] + (> or <) to [CTRL]+[SHIFT] + (I or U) the undo limit previously was 1, now it's for practical purposes unlimited [Bug-Fix] Swift could save files in the wrong place if many projects were opened and closed in one session.

Date:	15-Dec-2007
Filename:	Swift-v1.0.zip
Filesize:	470kb
Release Notes:	Changes: N/A (initial release).

---

Additional Software

You must also install the following software applications/utilities, which complement Swift:

• Python

  http://www.python.org/download/releases/2.5.1/python-2.5.1.msi

  Just run the installer and select any default items.

• P65 assembler

  http://hkn.berkeley.edu/~mcmartin/P65/py/P65-Ophis-0.7.2.tar.gz

  Extract the files to a folder on your hard disk, perhaps C:\P65. No further installation is required as Swift will handle the interaction between it and Python

• BeebEm

  http://www.mikebuk.dsl.pipex.com/beebem

---

Tutorials

Several tutorial videos are available to guide you through the Swift set up and features of Swift.

It is recommended that you download the P65 assembler documentation from http://hkn.berkeley.edu/~mcmartin/P65 as the videos are not really a tutorial in P65 6502 assembler; rather a tutorial in the use of Swift (although some areas of P65 are highlighted).

• FirstRun (3.5mb zipped)

  How to set up Swift when you run it for the very first time

• Tutorial 1 (10mb zipped)

  Creating a new project.

  Assembling

  Running and auto booting your code in BeebEm

  Changing "General Settings" - text editor colours and fonts

• Tutorial 2 (16mb zipped)

  Copying existings files into your project

  Searching files

  Aliases

• Tutorial 3 (15mb zipped)

  Error Throwback

  Writing more modular code, the "require" pragma statement.

  Label clashes

• Tutorial 4 (25mb zipped)

  More on writing modular code using extra Swift facilities

  Curing variable name clashes

  The Swift "merge" facility

  Scattering code throughout the BBC's memory map

  Cross referencing labels in other project items and memory locations

  Raw data (binary) files and the Hex editor

  Creating user defined Boot files

  Setting code limits

• Tutorial 5 (21mb zipped)

  Macros

  Limitations of the Swift "Merge" facility

• Tutorial 6 (22mb zipped)

  Including Binary (raw data) files in a project

  Indeting code

• Tutorial 7 (23mb zipped)

  New Project manager window in Swift Ver. 2.0

  Using label values in the BeebEm debugger

  Using Swift with BeebASM 0.6

• Tutorial 8 (23mb zipped)

  Using the Sprite Editor

---

Feedback

I would be very grateful for any feedback from users of Swift.

To contact me, please leave a message in the appropriate forum on this site or email me, Steve O'Leary, at navalenigma AT hotmail.com