*************************************** * * FILCON.BAS instructions. V1.1 * * File Conversion program for use with * CBterm/C64 (c) 1985 Chrisdos * *************************************** IMPORTANT ! For converted file to correctly load into CBterm/C64, you must make the following small patch to CBterm/C64 V2.0 1) Load CBterm/C64 (do not run it) 2) type in: POKE 7150,0 3) SAVE CBterm/C64 back to disk. (scratch the old version) (Ok, so I had a 1 where I should have had a 0. No one is perfict.) This patch tells CBterm/C64 to load files made by FILCON to the correct locations in memory. --------------------------------------- Filcon has 3 main functions. 1) Converting of file types. (PRG/SEQ) 2) Converting ASCII/PETSCII 3) Printing or displaying. Operation: Filcon.bas is a basic program with a M/L routine in data statements. Load and run Filcon and it will poke the M/L part into memory. The screen will clear and you will be presented with the menu. 1) File Type Conversion. The first 4 menu selections allow you to load or save either a PRG type text file, (like ones created by CBterm/C64) or SEQ files (like those from text editors or what ever). Filcon is a GENERAL file converion program and may work with other program's text files also, not only CBterm/C64's. Options 1 and 2 load and save PRG type text files. 3 and 4 do the same for SEQ type text files. Simply select the option you need to load or save the text file you are working on, you will be prompted for the file name. If you hit one of these options by mistake, just hit <RETURN> for the file name and you will abort the operation. 2) Case conversion. Once you have loaded the file into memory, you can convert the characters as needed to conform to your application. That is, you may convert the file in any of the following ways: ASCII to PETSET2 PETSET2 to ASCII PETSET2 to PETSET1 ASCII to PETSET1 ALL to Upper Case ASCII ALL to Lower Case ASCII Of the 6 options, the first 2 are the most usefull as these are the ones are convert ASCII to U/L case PETSCII and back again. The others are included for those special times when nothing else will do. This is a list of what each conversion does: (65-90 to 193-218 means that characters 65 thru 90 are mapped to characters 193-218. These are ASCII Cap. A-Z to PETSCII Set 2 Cap. A-Z. IE. 128 is added to the code.) 5 ASCII to PETSET2 65-90 to 193-218 97-122 to 65-90 6 PETSET2 to ASCII 65-90 to 97-122 193-218 to 65-90 7 PETSET2 to PETSET1 193-218 to 65-90 8 ASCII to PETSET1 97-122 to 65-90 9 ALL to UPPER Case ASCII 193-218 to 65-90 97-122 to 65-90 10 ALL to LOWER Case ASCII 193-218 to 65-90 65-90 to 97-122 (65-90 are ASCII and PETSET1 CAP. A-Z and also PETSET2 LOWER a-z. 97-122 are ASCII LOWER a-z. 193-218 are PETSET2 CAP. A-Z. Of course some codes display as graphics in PETSET1.) Remember: FILCON and be used on just about any TEXT file you can load in to it. So it could be used to convert files from other programs. The conversion process is all M/L so it is FAST. Once the file has been converted you should SAVE it back to disk in what ever format (PRG or SEQ) that you require. 3) The P option on the menu allows you to Display or Print the file. After hitting P you will be asked for Screen or Printer. (If you just press <RETURN> output will be to the screen.) If output is to the printer, you are asked for a secondary address. This is needed for some printer interfaces. If you do not need a secondary address just hit <RETURN>. You are then asked if you wish to Print or Display in FAST mode. If you enter "Y" then FILCON will dump to the Printer or Screen via a M/L routine. There is no way to halt the Display untill the end of the file is reached. If output is to the printer, you may abort the printing by taking the printer fully off line. There are no Line Feed controls in FAST mode, it is a fast dump of RAM to the device. At the end, you are returned to the menu. If you do not select FAST mode you continue the these next questions and the outputing is done by a basic loop. In normal mode, you are given the option of including a LINE FEED after a <RETURN> code or stripping the LINE FEEDS. If the file you are working on does not have LINE FEEDS included and your printer needs them, then hit "Y" to the Add LINE FEEDS question. If your file has LINE FEEDS and your printer does not need them, hit "Y" to the Strip LINE FEEDS question. The file located in memory will then print or display as required. Pressing any key during a normal print or display will abort the routine. --------------------------------------- The program FILCON.BAS (c) 1985 by Chrisdos. All rights reserved. Usage notes: To convert a file created with CBterm/C64 to a standard SEQ file, load the CBterm/C64 file with option 1 then save it with option 4. To convert a SEQ file to CBterm/C64 format, load with 3 and save with 2. You may also have to use one of the Case Convert options depending on the kind of characters in your files. CBterm/C64 PRG files are TRUE ASCII. Please also not that the largest file FILCON.BAS can handle is 21,502 characters long. (Same length as CBterm/C64) One other IMPORTANT note on CBterm/c64 V2.0 At any time when you LOAD a file into CBterm/C64 it shold not exceed 21502 characters in lenght. A file 21502 long will just fill the alloted buffer in CBterm/C64 and cause the RAM messages to show $0000 room left in memory, this is normal. HOWEVER, DO NOT OPEN (C= O) the RAM buffer if the file you loaded compleatly fills the buffer. A minor bug in V2.0 fails to tell the program that the buffer has been fully loaded. This ONLY occures on a load from DISK and the buffer is compleatly filled. Everything is fine in the operation of recived modem data and the buffer closes automaticly when the limit is reached. It is also ok to open the buffer to append data after a disk load if the disk load did not compleatly fill the buffer. Of cousre, you may reset the buffer at anytime with the (C= Z) zero fnction. This bug will be corrected in later versions of CBterm/C64 Thnak you ! -Chrisdos
Amiga7878