Download List

Descripción del Proyecto

Developing multi-platform and international edition of ISO Full BASIC.

System Requirements

System requirement is not defined

Publicado: 2022-04-15 12:58
BASICAcc 1.2.1.2 REv. 1 (4 files Ocultar)

Release Notes

BASIC Accelerator Ver. 1.2.1.2 REvision 1 (2022.04.15)

Summary

BASICAcc is a Full BASIC to Object Pascal translator.
Translated programs shall be executed using FPC + Lazarus.
Numerical operation shall be considerably faster than Binary mode of Decimal BASIC.
This verision is applicable for Lazarus 1.6.4 ~2.2.0.



Windows

Set up (Lazarus)

Download Win32 Lazarus2.2.0 and install it into the folder that has no space characters on its path name.
Lazarus Download (SourceForge)
Mirror

Set up (BASICAcc)

Download BASICAcc1211.zip from Decimal BASIC Open Source Project Download
BASICAcc should be extracted into a regular folder on which the user has write permission.
The name of the folder must not contain any space characters.
For example, Desktop may not be suitable. USB flush drives shall be suitable.
When the system is updated by overwriting, the OUTPUT folder must be cleared.
Afterward, execute BASICAcc.exe, and set up two paths.
Click "Set Up" and select "Path".
"fpc path" is the path to the folder on which fpc.exe exists.
"Lazarus path" is the full path name of the folder "lazarus".

If you have installed win32 Lazarus + fpc 3.0.4 on C drive, the two paths are following.

C:\Lazarus\fpc\3.0.4\bin\i386-win32
C:\Lazarus

Note.
If you use 64 bit Windows, Lazarus win64 also can be used.
Lazarus Win64
Select Setup - Path menu to set Target CPU to 64bit and set the paths.
When you use lazarus-1.8.4-fpc-3.0.4-win64.exe, for instance, the fpc path is like as follows.
C:\lazarus\fpc\3.0.4\bin\x86_64-win64
However when cros-x86_64 add-on is installed to 32 bit Lazarus, the fpc path is same as the path to 32 bit fpc.

Note that FPC does not support 80 bit extended precision floating point arithmetic on Win64, power operation and some transcendental functions may perform inaccurate.
If you require accuracy on 64bit code, use Linux 64bit version.



Linux (x86_64)

Set up (fpc and Lazarus)

Download and install fpc 3.0.2, fpc-src 3.0.2 and Lazarus 1.6.4 from
Lazarus x86_64 RPM,
Lazarus AMD64 DEB.

Set up (BASICAcc)

Download BASICAcc1211_linux64.tar.xz from Decimal BASIC Open Source Project Download.
This system must be installed into the folder on which the user has write permission.

Troubleshootings

Can't find unit fileutil
When you see this error, modify Lazarus Path on the SetUp menu.
Folders such as components and units are put on the folder that the Lazarus Path directs.
That may as follows.
/usr/lib/lazarus/0.9.30.4/
or
/usr/share/lazarus/1.0


Note.
On Cent OS 7, FPC 3.0.4 does not work properly. Try FPC 3.0.2 + Lazarus 1.6.4.
See Lazarus Forum


MAC(Intel) 

Set up(Xcode tools)

Set up(Xcode tools)

Install XCode Command Line Tools.
In the terminal, type
sudo xcode-select --install
sudo xcodebuild -license accept
Otherwise download "Command Line Tools for Xcode" from Apple Developer .
See Installing Lazarus on MacOS X.
See also Installing Lazarus on Mac OS X - Free Pascal(PDF)
Note. BASICAcc does not require GDB. So you do not have to install GDB.

Set up(fpc and Lazarus)

Install FPC 3.0.4 and Lazarus 2.0.8, downloading from Lazarus Download

Set up(fpc and Lazarus)

Install FPC 3.0.4 and Lazarus 2.0.6, downloading from Lazarus Download

Set up (BASICAcc)

Download BASICAcc1211_Mac64.dmg from Decimal BASIC Open Source Project Download,
and then extract the contents.

Note 1. Overwriting update is undesirable. Old files must be erased before update.

Trouble Shooting
1. For the First Time
(1) Unabe to create file "/private/var/folders/0b ……  
Move BASICAcc icon (BASICAcc.app) into the Application folder or another location, and then run BASICAcc.
Once normally performed, BASICAcc icon can be retured into the original folder.
For details, search "App Translocation" on the internet.
< Note. >
This system should be installed into the folder on which the user has write permission.
And the folder must not contain a space character. Note that when you use a USB drive, if it has a name such as "NO NAME", it must be renamed.

(2) For the first tme, NoName must be executed by clicking with control-key pressed .

(3) Empty ReportForm shown
If the first Run comannd yields empty ReportForm, this may caused by Unexecuted XCode license agreement.
On the terminal, run sudo xcrun cc and enter agree at the end.

(4) ReportForm shows PPU Source :synedit.pp not found.
Launch Lazarus IDE and select Package menu - Open Loaded packages.
And then Open and Compile the followings:
Synedit
Printer4lazarus

(5) "do setup Lazarus Path" shown.
 Select path on the setup menu, and then rewrite Lazarus path correctly.
Lazarus path is
Library/lazarus
on Lazarus 2.0.6, while lazarus path was
Developer/lazarus
on former versions.

Known Faults
SET DRAW MODE (NOTXOR, MASK, MERGE, XOR) do not work.
MOUSE POLL statement does not work properly.
Behaviors of some graphics statements are no good as in Decimal BASIC Mac(Intel).


Specifications

Language Specifications are in accordance with the Graphics module, the modules module, and the individual character input module of ISO Full BASIC .

Known Faults

EXTYPE,RETRY and CONTINUE do not work properly for exceptrions raised in an exception handler.

Restrictions

On the following cases, GOTO statements and IF-THEN-line_number statements can not be executed.
branches from inside to outside of when-body (i.e. inside of WHEN~USE)
branches from inside to outside of a DO block that contains a protection block that contains a EXIT DO.
branches from inside to outside of a FOR block that contains a protection block that contains a EXIT FOR.

If a routine (or the main program) has a when-in block that has an exception-handler containing a GOSUB~RETURN subroutine, the routine can not have a GOSUB~RETURN subroutine that is not contained in any protection block.

RETRY and CONTINUE do not work properly for exceptrions raised in exception handlers.

Parameters of PROGRAM or CHAIN statements should be simple variables (Arrays not allowed).

When an exception occurs while executing an INPUT or READ statement that has multiple variables, those variables remain all unchanged.

Maximum length declaration for string variables is ignored. (no cut off done.)

Incompatibilities with Decimal BASIC

Character Encoding

The character encoding is UTF-8.
This is a problem when non-ASCII characters such as © , µ , ° , ± , Ä or Æ are used.
ORD-functions and CHR$-functions are defined under Unicode.
File I/O assumes the character encoding is UTF-8.
Executing a line like
SET #n: CODING "SYSTEM"
just after the execution of the OPEN-statement enables files of system default encoding to be read or written.
Even in such a case, the internal encoding remains to be UTF-8.
PRINT USING-statements and USING$-functions need the formatting characters as many as the byte length of the string.

If you want to manipulate byte files, you can change the internal character encoding to byte encoding by adding a line
OPTION CHARACTER BYTE
into each program unit, or change the setting of "Unit of string manipulation" to "byte" in the Option Compatibility menu.
In such a case, no ANSI encoded non-ASCII characters can be displayed on the screen.

UTF-8 encoding slows some string manipulation such as s$(m:n).
If you use only ASCII 7-bit characters, consider to change the "Unit of string manipulation" to "byte" in the Option Compatibility menu.

Program Encoding

Programs shall be encoded to the system default encoding on saving and decoded on loading.
That is, program files have compatibility with Decimal BASIC.
If you want programs to be saved and loaded remaining the character encoding UTF-8, change the Editor Option setting in the Option menu.

CHAIN statements

A CHAIN statement launches a file of extension ".BAS" with file association. The destination programs shall not be compiled.
No CHAIN or EXECUTE statement can have array parameters.

BREAK

Any BREAK statement will do, but it only breaks the program.

GOSUB

When GOSUB statements are used, each line must has a line number.

Bugs which Decimal BASIC has

Decimal BASIC has a fault that an internal procedure of the mainprogram can be invoked from an external procedure, but BASICAcc does not allow such a program.

Decimal BASIC Original Enhancement

DRAW MODE NOTXOR (MASK, MERGE, XOR),which are Decimal BASIC original enhancement, do not work properly.
On Mac, they are neglected. On Windows and Linux, then won't work until a PLOT LINES is executed.

The decimal 1000 digit mode and the rational arithmetic mode, which Decimal BASIC has, are also not avaialable.

The Microsoft BASIC compatible mode is not available.
Also Metafiles, OLE, ActiveX and CallBack functions are not available.


About System

The executable file is generated as 'NoName.exe' or 'NoName' in the 'output' folder. This can be renamed and used for the destination of a CHAIN statement.

BASIC Accelerator Ver. 1.2.1.2 Rev.1 (2022.04.15)

概要

Full BASICのプログラムをObject Pascalのプログラムに変換し,FPC + Lazarusを利用して実行します。
数値計算が主体のプログラムは,十進BASICの2進モード,複素数モードより高速です。
Lazarus 1.6.4~ 2.2.0 に対応します。


Windows

Set up(fpc + Lazarus)

32ビット版Lazarus 2.2.0をダウンロードしてインストールしてください。
インストール先は,パス名に空白や日本語文字を含まない所を選択してください。
Lazarus Download (SourceForge)
Mirror

Set up(BASICAcc)

BASICAcc1211.zipを Decimal BASIC Open Source Projectからダウンロードし,ユーザーの書込み権限のあるところに展開してください。
ただし,パス名に空白や日本語文字を含むところは避けてください。 (たとえば,デスクトップやマイドキュメントは不可。USBメモリは可。)
既存のBASICAccフォルダに上書きでアップデートしたときは,一旦,OUTPUTフォルダを空にしてください。

Lazarusのインストール時にインストール先を変更したときは,BASICAcc.exeの起動後, Set upメニューのpathの設定を書き換えてください。
fpc path は,fpc.exe が存在するフォルダです。
Lazarus path は,lazarusインストール先のフォルダを指定してください。
なお,win32 Lazarus + fpc 3.0.4 をCドライブにインストールした場合,それら2つのPathは

C:\Lazarus\fpc\3.0.4\bin\i386-win32
C:\Lazarus

です。

Note.
Lazarus 1.6.4でも使えますが,SetUpメニューのPathでFPC pathのバージョン番号の部分を正しく書き換えてください。

Note.
内部文字コード,ファイル入出力ともにUTF-8です。shift-JISファイルを使用する場合は,OPEN文に続けて
SET #n CODING "SYSTEM"
を実行してください。
プログラムファイルの入出力はshift-JISですが,Optionメニューの"Editor Option"でプログラムファイル入出力をUTF-8に変えることができます。
プログラム中にユニコード文字を書くときは,Editor Optionを変更してください。

64ビット
Windowsが64ビットの場合,64ビット版Lazarusを使うこともできます。
Lazarus Win64
SetupメニューのPathで「64bit」を選択し,FPC pathの末尾が \x86_64-win64 であることに注意して FPC PathとLazarus Pathを設定してください。
これらのpathは32bitと独立しています。随時,切り替えて使用することができます。
ただし,lazarus64ビット版でなく,32ビット版Lazarusにadd onのcross-x86-64をインストールしたとき,FPC pathは32ビット版FPCのところです。
Note.
Win64版のFPCでは拡張精度浮動小数点演算が利用できないので,べき乗演算や一部の超越関数の計算結果に無視できない誤差を生じます。
64ビットのプログラムで計算結果の正確さを求めるときは,Linux 64ビット版をご利用ください。
ASSIGN文で64ビットDLLを利用する場合は,BASICAcc64ビット版(BASICAcc1202_Win64.zip)を使用してください。


既知の不具合

画像の保存ダイアログで保存形式を変えても拡張子が変化せず,手動で書き換える必要がある。

Linux (64ビット)

Set up(fpc, Lazarus)

x86_64版 fpc 3.0.2, fpc-src 3.0.2 , Lazarus 1.6.4 をダウンロードしてインストールしてください。
Lazarus Download (SourceForge) (rpm)
Lazarus Download (SourceForge) (deb)


Set up(BASIC Acc)

BASICAcc1205_Linux64.tar.xzを Decimal BASIC Open Source Projectからダウンロードし,ユーザーの書込み権限のあるフォルダに展開してください。

既知の不具合

Cent OS(64ビット)でFPC 3.0.4が動作しません。FPC 3.0.2 + Lazarus 1.6.4で実行してください。

トラブル対策

Can't find unit fileutil のエラーになるとき。
lazarus pathを設定し直してください。
Lazarus pathで指定するフォルダにはcomponentsやunitsなどのフォルダが置かれています。
/usr/lib/lazarus/0.9.30.4/
のようにlazarusフォルダ内のバージョン番号名のフォルダになっている場合や,
/usr/share/lazarus/1.0
などのようになっていることがあります。

NoName.errが見つからないという趣旨のエラーになるとき。
fpcが正しくインストールされていません。/etc/fpc.cfgが存在することを確認してください。
--scriptsを指定せずにalienを用いてrpmパッケージをdeb形式に変換してfpcをインストールすると,この問題を引き起こします。

その他,プログラムの実行結果が現れないとき。
runメニューからcodeを選択し,Pascalコードが表示されたら,そのウィンドウでrunを選ぶとfpcが出すエラーが読めると思います。


MAC(Intel) 

Set up(Xcode)

以下の手順にしたがって,XCode Command Line Tools をインストールしてください。

ターミナルを起動して以下の2つのコマンドを打つ。ただし,OS 11,12では2つめは不要。
  ターミナルは,「アプリケーション」フォルダ内の「ユーティリティ」フォルダにあります。
 sudo xcode-select --install
 sudo xcodebuild -license accept  

OSのバージョンが古いと上の手順と異なることがあります。
また,1つ目のコマンドでダウンロードが進まないときは,Apple developer サイトからダウンロードしてください(Apple Idの入力が必要)。
参照  Installing Lazarus on MacOS X.
See also Installing Lazarus on Mac OS X - Free Pascal (PDF)
Note. GDBのインストールは不要です。

Set up(fpc, Lazarus)

fpc 3.0.4 と Lazarus 2.0.6 をダウンロードしてインストールしてください。
Lazarus Download

Set up(BASICAcc)

BASICAcc1205_Mac64.dmgを Decimal BASIC Open Source Projectからダウンロードし,インストール先のフォルダに展開してください。

トラブルシューティング
1.初めて実行するとき
(1) Unabe to create file "/private/var/folders/0b ……  のエラーが出て実行できない。あるいは,ファイルOpenができない。
アイコンで表示されるBASICAcc(BASICAcc.app) をアプリケーションフォルダなど他のフォルダに移してください。一度,正しく実行できることを確認した後は元のフォルダに移すことが可能ですが,パス名に空白を含むと正しく動作しません。USBメモリを使うときは,ドライブ名を空白を含まないものに変えてください。
なお,BASICAccの実行には,インストール先フォルダの書き込み権限が必要です。 
 一度,正常に動作すれば,元のフォルダに戻しても大丈夫なようです。
 アイコンで表示されるBASICAccのみをアプリケーションフォルダにコピーしてもよいようです(フォルダごとのコピーでは駄目)。
 詳細は,"App Translocation"を検索して調べてください。

(2) NoNameアイコンが点滅し実行を開始しない。
 controlを押しながら NoNameアイコンをクリックして実行を許可してください。
(3) ReportFormに何も表示されず,プログラムも実行されない。
 ターミナルでsudo xcrun ccを実行し,最後にagreeを入力する。
 参照 Agreeing to the Xcode/iOS license... のエラーがでた時の対処法

(4) ReportFormに,
 PPU Source :synedit.pp not found.
 が出る。
 Lazarus IDEを起動して,パッケージメニューから,「読み込まれているパッケージを開く」を選択し,
 以下の各パッケージのコンパイルを実行する。
 SynEdit
 Printer4Lazarus

(5) do setup Lazarus Path が表示されて実行しない。
 setupメニューでpathを選択し,Lazarus pathを正しく書き換えてください。
Lazarus 2.0.6のとき,lazarus pathは,
Library/lazarus
ですが,Lazarusの以前のバージョンでは,
Developer/lazarus
でした。

2. プログラムを続けて実行できない
  Mac版BASICAccでは,次のプログラムの実行前にNoNameを終了させてください。

3.プログラムの実行を途中で打ち切りたい
 Mac版はBASICAccの側から中止できないので,画面左上のアップルメニューで「強制終了」してください。

既知の不具合
MOUSE POLL文は正しく動作しないことがある。
SET DRAW MODE (NOTXOR, MASK, MERGE, XOR)は機能しない。


言語仕様

言語仕様は,JIS Full BASIC (図形機能単位+モジュール+単文字入力)に準拠します。

規格との相違

OPTION ARITHMETIC文を省いた場合には,ARITHMETIC NATIVEが指定されたものと解釈します。

十進演算も選択可能ですが,十進演算の正確さに関する規定を満たしません。

次の場合,行番号分岐(GOTO文,IF ・・・ THEN 行番号) は実行できません。

WHEN本体内から保護区の外への分岐
保護区を含み,その保護区内にEXIT DO文を持つDO区の内から外への分岐(fpcコンパイラのエラーになります)
保護区を含み,その保護区内にEXIT FOR文を持つFOR区の内から外への分岐(fpcコンパイラのエラーになります)

WHEN-IN区に属する例外処理区がGOSUB~RETURNを持つと,いずれの保護区にも属さないGOSUB~RETURNを書くことができません。(fpcコンパイラのエラーになります)

PROGRAM文,CHAIN文の引数は単純変数に限ります(配列不可)。

文字列変数の最大長指定を無視します(切り詰めを行わない)。

その他,十進BASICのJIS非互換項目は, ほぼそのまま本システムの非互換項目になります。

既知の不具合

例外処理区で発生した例外に対してEXTYPE関数,RETRY文,CONTINUE文は正しく機能しません。

CHARACTER INPUT文(画面からの入力)は日本語入力に対応しません。

十進BASIC独自拡張のDRAW MODE NOTXOR (MASK, MERGE, XOR) は,正常に機能しないことがあります。
 (Macでは,無視されます。Windows,Linuxでは,PLOT LINES文を実行しないと機能しません。)

十進BASIC(Windows版)との非互換

識別名に使える文字は英数字のみです。

内部の文字コードはUTF-8です。ORD関数,CHR$関数はユニコードで定義されます。書式指定は漢字1文字に対し # 3文字を必要とします。
ファイル入出力もUTF-8ですが,OPEN文実行後,
SET #n: CODING "SYSTEM"
を実行すると,ファイル入出力をShift-JISで行います(日本語Windowsの場合)。

プログラムの保存形式の初期設定はshift-JISになっていますが,Optionメニューの「Editor Option」でUTF-8に変更することができます。

文字列処理の単位の初期値は,Option メニューのCompatibilityで設定します。

CHAIN文に 拡張子が".BAS"のファイルを指定すると関連付けで起動します。

EXECUTE文の引数に配列を指定することはできません。

BREAK文は動作しますが,プログラムを中断するだけの機能しか持ちません。

GOSUB文を含むプログラムは行番号が必須です。

十進BASICでは主プログラムの外部から主プログラムの内部手続きを呼び出すプログラムが実行できてしまいますが,その種のプログラムは実行できません。

独自拡張命令 SET BITMAP SIZEの挙動は Windows版十進BASICと少し異なります(拡張部分の色が異なる)。

画像の保存形式にGIFを選ぶことができません(読み込みは可)。

ASSIGN文でDLLの作業領域として用いる文字列変数はREPEAT$関数等を用いてその場で作成したものに限ります(文字列定数不可)。

その他,DelphiとLazarusの非互換のために動作が異なるところがあります。

未対応の機能

十進BASIC独自拡張の10進1000桁,有理数の演算に対応しません。

Microsoft BASIC互換モードに対応しません。
また,Windows版十進BASICが対応するメタファイル,OLE,ActiveX,CallBack,TextWindow にも未対応です。


システム詳細

実行ファイルはoutputフォルダに NoName.exe として生成されます。CHAIN文の連鎖先として用いたいときには,適宜,名称を変更してください。

生成したPascalプログラムは,outputフォルダに BASICunit.pas という名称で保存されます。
runメニューのcodeを選択して表示されるコードビューから書き換えて実行させることができます。
BASICの識別名は,数値型の場合は直前に _ を,文字列型の場合は 末尾の $ を除去して直前に s_ を付加した名前に変わります。
ただし,PUBLICまたはSHARE宣言された変数の名前は,_を2個重ねます。
主プログラムの内部手続きの名前は,_0,または,s_0 を付加した名前になります。
BASICのmoduleは,(古い型の)静的オブジェクトに変換されます。
詳細 Full BASICのObject Pascalへの埋め込み

 

Changelog

Fixed the bug on READ statements which read to string variables.

文字列変数に対するREAD文のバグを修正。