Tutorial:Getting Started

This page is available in german

Installation

Check the installation guide for your platform:

• Amiga 68k
• Amiga OS4
• AROS
• MorphOS

In Short:

• download the archive, unpack it where you want to have it, add the FreePascal: assign and the path to your user-startup (or use package installer for AROS)

Basic use

Commandline based

Usually one use the favorite editor and compile via command line compiler. In this Tutorial we will mainly use the FP-IDE but here is a short introduction how to use the command line compiler.

• open a shell
• type fpc -l freepascal will return with some informations about the installed freepascal compiler. That means it is installed and working.
• to compile a Pascal source file just type fpc sourcefile.pas usually pascal source have the extension .pas other pascal compiler also use .pp or .p
• to compile a Lazarus project compile the .lpr file fpc lazarusproject.lpr if it is a delphi compatible project it also can be .dpr

FP-IDE

The FreePascal IDE is ANSI based editor with embedded pascal compiler like the well known Turbo Pascal on MS-DOS. It uses the FreeVision package which is a open source package comparable to TurboVision of TurboPascal. It needs at least a 8 color screen, it works with 4 color screen as well, but looks a little bit strange, some texts maybe not easy to read. To start the IDE navigate to the PP folder and find the FP-IDE Icon.

Double click the FP-IDE Icon to start the Editor. It greets you with the FP-IDE Desktop. It also opens a Shell window where outputs of programs we write will appear later. So it would be good to move the windows that you can see both.

In the window at top you can see the the menu line, it's an old DOS based program. The menu using is different than Amiga typical. You can use the mouse and left mouse button to open and select menu entries. Or press Left Alt-Key and one of the red chars of the Menu entries to open the Menu, select an Entry again with the red marked char or use cursor keys and enter key to select a Menu Entry. In the Middle section later we will have our editor Windows. The lower hotkey line shows some shortcuts, very useful like open and Compile.

We want to create a new file so we navigate to the File</code Menu and select New An editor window opens (you can open some more to play around to get to know how they work).

On the left upper side we have the close Button (the little green square). The title line with the current file name can be used to move the window around and double click maximize or restore the window (of course the size has to be reduced before to see an effect, just keep reading). The one at the upper right side indicates the number of the editor window. The green arrow next to it is used to maximize and restore the window. On the right side you can see a checkered area with two arrow which represents the scrollbar for the editor text, it works exactly like the Amiga one (But it is not proportional just a blue square represent the current position as visible at the lower border). The lower border as the same scroll bar for the horizontal direction. Between the two scrollbars in the lower left corner is the size gadget, click and drag to resize the window. on the left lower side the current line and char in line is shown, 1:1 at the moment. In the editor you can see the blinking cursor where you can type program. We want to type in out very first program, of course "Hello World"

program helloworld;
begin
  writeln('Hello World');
end.

Sometimes it's difficult to find the right quotation mark, especially on UAE (on a german keyboard seems Alt+Ä does work, for english it should be the single quotation mark directly on the keyboard). If you found the right key it should show the quotation mark in turquoise color, if it is yellow then it's the wrong one. Notice that behind the last end there should be a point.

Before we can compile and run that, we have to save it. To Save the file one can use the Menu entry or press F2. The save as dialog Window will open. To navigate type the path into the edit field for Name and press Enter key e.g. work: the contents of the Drawer/Device will be shown in the area underneath. Use Mouse or cursorkeys + Enter to navigate where you want to save your file (../ means parent directory and is always at the end of the list). e.g. Work:Sources in this example as you can see in the lower part of the dialog window. In the Name edit field the currently selected file name is written delete the name and type in helloworld.pas and press enter or press OK.

Now we can compile our program, press F9 or choose Compile from the Compile Menu. Depending on your computer (especially Hardrive speed) it will need some time to compile (a real Amiga around 30 s, NG Amiga should be only some seconds). FP-IDE should now tell you "Compile successfully: Press any key" if not, it found some errors. A green window opens with the error messages. Try to check the source carefully for typing errors (also care about the colors, which can give you a hint about wrong chars). The compiler should tell you the position of error, navigate to the error and press enter to jump to the position of the error. If you have no idea maybe you want to ask me on Forum or IRC whats wrong.

To run our program press Ctrl-F9 or choose Run from the Run Menu. The Editor window closes very fast and opens again. The Output of the program can be seen in the second window.

Congratulation you managed to write, compile and run your first Program on Amiga using Freepascal and FP-IDE. Now you can extend your program for a more meaningful program. Do not forget to save your progress (with F2 or Menu) compile (with F9) and run it (Ctrl-F9). This Tutorial should not be a complete pascal tutorial. If you are not used to Pascal you should try to find one of the many pascal Tutorial and try some parts on your Amiga (CRT and GRAPH units are not available so jump over parts using graphics for now). If you found a good Pascal tutorial you should announce the link to it here for other people.