Installing BCX

Software Requirements

First, the official BCX distribution package, can be found at Kevin Diggins' BCX website.

http://www.BcxBasicCoders.com/

The BCX distribution package includes examples for Windows GUI, console, and dynamic libraries, complete documentation, the BASIC to C translator, and several utilities including a text editor with syntax highlighting.

After installing the BCX distribution, the bc.exe BCX translator in the BCX\bin folder should be replaced with the latest version of the translator. The latest release and beta versions of the BCX translator are available from the Announcements section of the BCX BASIC Forum website at

https://bcxbasiccoders.com/smf/index.php?board=4.0

If you wish to compile the translated code, a C compiler system is required. BCX is capable of producing C code that will compile with many C/C++ compilers.

Setting environment PATH

BCX, by default, installs to "C:\Program Files\bcx\bin".

Regardless whether you install BCX to the default folder or another, YOU will have to manually modify your computer's environment PATH variable to point to the \bcx\bin subfolder on the drive where you installed BCX.

Modifying the PATH for Windows 95, 98 or ME Users

Start your favorite text editor and open the file autoexec.bat. Normally, it is located in your root folder of your C drive. If you dual-boot, the location may be different.

In the autoexec.bat file, modify the PATH to add the location of your BCX executable. If, for example, the BCX executable is in the C:\Program Files\bcx\bin folder, the PATH variable in the autoexec.bat file would be modified to include C:\Program Files\bcx\bin.

If your PATH to bcx\bin contains any spaces, be sure to include quotation marks around the entry, for example, "C:\Program Files\bcx\bin" or else use the short name for the PATH, for example, C:\Progra~1\bcx\bin.

Save the autoexec.bat file and reboot. The PATH modifications you made will not take effect until Windows is restarted.

Modifying the PATH for Windows XP, Vista, 7, 8 and 8.1 Users

To modify the PATH, you will need to bring up the Environment Variables dialog, so do this by holding down the Windows key and then press the Pause/Break key.

On XP, left mouse click on the tab labeled Advanced. On newer operating systems, left mouse click on the 'Advanced System Settings' in the 'Control Panel Home' sidebar. You should see the “Environment Variables� button at the lower right of the System Properties dialog. Click the “Environment Variables� button and the Environment Variables dialog will appear.

There will be two frames, one for the current user and the other for the system.

If the current user variable PATH does not exist, create it by clicking on the New button. Set the Variable name to PATH and the Variable value to the path to your bcx\bin folder, for example, C:\Program Files\bcx\bin.

If the current user variable PATH exists, modify it by clicking on the variable “PATH� and then on the Edit button. Modify the Variable value by adding a semi-colon and then the path to your bcx\bin folder, for example, ;C:\Program Files\bcx\bin.

BCX Registry entry

The full BCX distribution installation creates the Registry entry

HKEY_LOCAL_MACHINE\Software\BCX-32\BCX\Settings\Path

Each time BCX is run, it looks to see if that registry entry exists and, if it does not, BCX creates and sets it to the path from which BC.EXE was run.

You can also update the BCX path registry entry anytime by running BC.EXE using the -r switch.

BCXLIB Environmental Variable

The BCXLIB environmental variable can be set at the operating system level to point to the folder holding BCX $INCLUDE files. See the $INCLUDE directive for more details about BCXLIB.

BCX generated programs have been tested on Windows 95/98/ME/NT4/2000/XP.