extracted from STarCall manual.

STarCall Pro includes full manual and a hypertext!

---

6   STARFAX

6.1 About STarFax

With STarFax and a CLASS 2 / 2.0 compatible FAX modem (TKR, ACCEX, 
ELSA, ZYXEL, USR ...) you can use your ATARI to create,send and 
receive FAX documents.
You can use STarFax together with STarCall, or as a single 
application.
STarFax can be used in your own programs, and a tool for own fax 
drivers is also included.

6.1.1    How to install STarFax

STarFax can be installed on your Harddisc the same way as StarCall 
using the installation program on the origininal disk. You can skip 
this passage when STarFax is installed this way.
When you do not have the original disc, or you want to install STarFax 
manually, read this chapter, otherwise you can skip the next lines.

- Unpack STarFax in any folder
- When you have worked with STarCall you should find the file 
STARCALL.SET on your boot disk (C: )
- If you can not find it, restart the INSTALL program, or copy the 
file "STARCALL.SET" to your root directory ('C:\'). This file contains 
some global settings for STarCall. Use any editor to change the entrys  
REGNAME and REGCODE, which are reserved for name and registration 
code. Read the file "REGISTER.TXT" for more information how to 
register to get this code. Now save the file. STarFax is prepared for 
work now.

6.1.2    Configuration of STarFax

Run the STARFAX.PRG. Before you can send a fax, STarFax must be 
configured for your system.
When you are using STarFax the first time, it will automatically ask 
for your settings, later you can find it in the "option" menu.

Path:
Firstyou have the choice, where STarFax puts the files on cour 
harddisc. STarFax has a folder for uutgoing fax, incoming fax, text 
files and archives. You can confirm the default settings with OK or 
chosse your own directorys.

Modem setup:
First choose the "Port", your modem is connected with, for example 
MODEM1. Now you can use the "Autoconfiguration", which allows STarCall 
to detect your modem type and maximum bps.

The "dial command" is "ATDT" for tone and "ATDP" for puls dialing. If 
your modem is connected to a local telephone system, use "ATX3DTn, " 
or "ATX3DPn, " where the "n" is the number for getting a line.

You can change this and other options with the option buttton in the 
main menu.

6.2 Receive a Fax

There are two ways to receive a FAX with STarFax:
1.) Use the answering options of  STarCall. This enables you to 
receive modem and fax, perhaps even voice, with one telephone line.
2.) Use STarFax as ACCessorie. Then you may receive FAX every time, 
independend from STarCall, but you can not receive modem calls.

6.2.1    Receive a Fax with STarCall

You have to check and perhaps to change the following parameters of 
STarCall (!).
- Path: You must set the path for STARFAX.
- answer calls: Enable MODEM+FAX and the number of rings.
- The "AA" - LED of your modem should be off ! When it is on, please 
enter in your terminal window:
    "ATS 0 = 0 &W".


STarCall now is prepared for receiving FAX + MODEM.
When someone calls, STarCall will...

- answer the call after the selected number of rings.
- send a carrier sound and check whether this is a modem or fax call.
- When this is a modem call, STarCall will call STARBOX, when it is 
installed.
- In case of a fax call, STarCall will run "STARFAX" and receive the 
fax.
    The fax will be saved to your harddisc.
- When you have a voice modem (ZyXEL o.e.) , the voice option will be 
used.

STarCall can only answer a fax, while it is loaded into memory. When 
you quit STarCall, or when you switch off your compter, STarCall of 
course is not able to answer a fax.
When your computer supports multitasking, for example with MultiTos or 
MagiC, you can run STarCall as task in the background and load other 
programs.

Hint: When you only have one telephone line, and you want to use it 
for FAX, MODEM and normal calls: Set STarCall to answer calls after 5 
or more rings. Then you can use your phone as usual. When you hear 
that the call is a fax call ( it will beep) , you can answer the fax 
manually.

6.2.2    Receive a Fax with STarFax

You can answer a fax directly with STarFax, you can choose manual and 
automatical operation.

Manually: Run STarFax and click "Answer"

HINT: When you are in STarCall, you can call STarFax by pressing "ALT 
+ F10" and receive a FAX manually.

HINT: You may use this for changing from a voice call to FAX. You only 
habe to click "ANSWER".

Auto-Answer a call: Copy the file STARFAX.PRG to your boot partition 
C:\ and rename it to STARFAX.ACC. After restarting the system you will 
find STarFax in the desktop menu. Select this menu to call STarFax, 
and choose the button for "OPTIONS". There you habe to enable "FAX 
ACC-mode". STarFax is able to answer FAX only, you can not answer 
modem calls.

6.3 Create a Fax

Before you can send a fax, you firstly have to create it. You can use 
nearly every text, graphic or publishing program, or a simple ASCII-
editor.
Write your document as usual, and save it. How you have to continue 
depends on your program now:

6.3.1    Ascii, 1st Word Plus 2.x / 3.x

Use the fax driver "ASCII.PRG".
This program converts ASCII and 1ST WORD documents to STARFAX-files. 
When using 1st Word, text attributes will be converted. Pictures can 
not be used.
Every page will automatically begin with the FAX_HEAD.FAH file.

Again you have two possibilties:

-1- Run "ASCII.PRG" and choose your text file with the file selector.

or...

-2- Use the desktop and move your text file onto the ASCII-program.

Your text will be converted to a fax, this will need 10-30 secons with 
a 8 MHZ ST.
The FAX can be send now using STARFAX or STARCALL.

6.3.2    Tempus Word

Call the menu "File - Print". Select the output device "QFAX". Then 
run printing. The document will not be printed now, but saved as a fax 
file. It can be sent now with STARFAX.

6.3.3    Calamus

Install the driver found with STARFAX "CAL_FAX.CDT". 

CAL_FAX will convert calamus documents into fax files. "CAL_FAX.CDT" 
has to be installed as a printer driver in "Calamus", you should copy 
it into your calamus printer folder.
Now select the driver with Calamus. When calling the function "Print", 
your file will be converted to a FAX file.
The FAX now can be sent with STARFAX.

6.3.4    Script

Offers, like Tempus Word, an internal FAX function.

6.3.5    Signum 3

Offers, like Tempus Word, an internal FAX function.

6.3.6    Stad / Degas / Doodle

Use the converting program "BILDER.PRG".
This program converts pictures to STARFAX files. The following formats 
can be used:

DOODLE   (.PIC , 32000 Bytes)
STAD          (.PAC)
DEGAS    (.PI1)

You have two possibilities:
-1- Run "BILDER.PRG". Select your file you want to convert. Or...
-2- Use the desktop and move your picture file onto the BILDER.PRG.

Your text will be converted to a fax, this will need 10-30 secons with 
a 8 MHZ ST.
The FAX can be sent now using STARFAX or STARCALL.


6.3.7    IMG Grafikprogramme

Most graphic programs and many text programs are able to create IMG-
files. You can read and convert these files with VIEWFAX or the IMG-
driver.

6.3.8         QFAX

When you did not find your program, please check, whether your text 
program offers an internal Fax function. STarFax is compatible to 
QFAX, many programs support QFAX.

6.3.9         Other Programs

When your program does not offer a FAX or IMG export, and there is no 
driver for converting, you may try to use the HPFAX emulator, please 
read the document file.
When you still do not have success, please contact your distributer or 
our support line.

6.4      Send a Fax

To send a FAX call the STARFAX modul:


 

When calling STARFAX it will display the number of ready pages.. Now 
enter the Fax number and click "SEND". You can define a start time, or 
send soon Starfax will dial the number now and send the fax after 
connection.
You want to send more than one Fax? No Problem! Click the Fax icon and 
enter more numbers.


6.4.1    The list of numbers

STarFax offers like STarCall a list of phone numbers for managing your 
FAX numbers. The dialog of STARFAX is like the dialog of STARCALL. 
Select an entry at the left side.

 

Then you can enter name, number and informations in the right dialog 
and accept with "OK".

6.4.2    Select FAX

When you have created more than one FAX file, but want to send only 
some of them, click the "Select" button. Now you can choose fax files.

6.4.3    Jobs

The Job list contains a list of outgoing fax. You can delete single 
jobs, or save the full job list for a later use. This is a nice tool 
for fax server, sending infos and adverts at night.

6.5 Fax Options

You can select some options for sending a fax:

 

Modem Setup
was allready described with the configuration.

Path
dito.

Stamp line:
This will enable STARFAX to send a short information line with every 
Fax. This can contain you name and FAX-ID and the receiver's name.

Send cover:
With every FAX you can send a cover sheet including a short message.


Erase Fax after quit:
This will erase all fax files, after you quit STARFAX.

 

High resolution:
Here you can select the quality when sending a FAX. A FAX allways has 
a horizontal resolution of 200 dpi, and a vertical resolution of 98 
dpi (low) or 196 dpi (high). So sending a high resolution fax will 
take more time than a low resolution fax.

Retries:
Here you can select the number of retries for dialing.

Pause seconds:
This defines the time between 2 tries of dialing. I recommend to enter 
a value between 30 and 60 seconds, because the called fax will need a 
pause, too.

Edit cover:
Here you can edit the cover which is send with every fax.

6.6 Cover 

STarCall is able to send a cover sheet with every fax file. It is 
possible to send a cover sheet without a fax file, too, this is 
usefull for sending a quick, short message.

 

You can enter your message into the text lines. Use the arrow buttons 
to scroll the text. You can use some variables:

%Name    Dialed name
%Nummer  Dialed number
%Myname  Your name
%Myid         Your number
%Date         Date
%Time         time
%Pages   Number of pages

With every cover sheet you can send a logo, for example a header for 
your letter, and a signature. Enable the buttons LOGO and SIGNATURE 
for this function.
You can create logos and signatures using a graphic program. Save it 
as IMG and import the file with VIEWFAX. Then select the function 
"Save as..." to save it. You will find some demo images on your disc.

You can export the covers text to a text file using "EXPORT", and 
import a text file using "IMPORT". You can edit the default cover 
sheet with the option menu.

6.7 Viewfax

Viewfax is a modul which can be used for viewing received and outgoing 
fax files, for modifying them, printing and erasing. It also can be 
used to convert graphic files (.IMG) into FAX, into logos and 
signatures.


 


6.7.1    View Fax documents

After loading Viewfax you will see a list of all received fax 
documents.

 

You can use the mouse or cursor keys to select some fax documents. You 
can now select to show, print or erase the file.
If you want to print all new fax documents, you can select the 
automatically with "select new fax".
You can change to the outgoing or any other folder with the left three 
icons.
When you have selected a fax, you can use the "display" icon to view 
and edit it with the following functions:

MENU FILE

New fax:
This will open a new, empty document. You can choose between 3 
predefined formats for a full A4 page, covers and logos, or define 
your own size.
A fax page has allways a width of 1728 pixels and maximum hight of 
2400 pixels for a full page.

Load fax:
You can use this function to load any fax from your harddisc. But you 
should prefer the fax window to load a fax.

Load IMG / PAC
This opens a graphics file in IMG or PAC (STAD) format.

Insert file
opens a graphics or text file and adds it to a open document. After 
selecting a file, a border will appear. Use the mouse to select the 
position.

Save:
Stores the current fax on your harddisc.

Save as...:
Save the current document under a new name on the hard disc. This way 
you can store fax files in other directorys or as logo file.

Move -> Outgoing:
Moves the current fax from the incoming to the outgoing folder. This 
is nice for sending a fax to a third party.

Print:

This will print the current Fax. You can choose 3 usual internal 
printer types: 9 PIN, 24 PIN and HP Laser. It is possible and better 
to use GDOS drivers, too.

Delete:
This will erase the current window and the fax file. There will be no 
security question to enable you to erase old fax files very fast.

Quit:
This will quit VIEWFAX.

MENU WORK

Viewfax offers many functions for modifying a fax image. Use the menu 
"Work" or the icons to select a drawing function.


Mark block:
This tool can be used to mark a rectangle area of your fax. Select the 
menu and move the mouse cursor to the upper left corner. Press the 
left button and move the mouse cursor down.

Eraser:
You may use this for erasing parts of an image.

Scroll:
Now you can use the mouse cursor to scroll the window.

MENU EXTRAS

Erase single Pixels:
This will erase single pixels, often a result from bad scanns of 
incoming fax files. You will get a better image after this.

Double high / width:
This will double the size of the current image, this is usefull for 
small picture files.

Display 1:2 / 1:3
This will zoom out the current window to enable you to see a bigger 
area of the fax.

Show info:
This will display some information about the current file. You can 
edit the information line and add your own infos.

6.8 Using the Fax-modul for programing own programs

Hello software developers! You can use Starfax and the modules with 
your own program this way:

STARFAX:
Receive a Fax:
Configure your modem with "AT+FCLASS=2" to enable FAX/MODEM detection. 
When you receive a "RING", send "ATA" to modem. Now wait for "CONNECT" 
or "+FCON". When you receive "CONNECT", a modem connection is done. 
When you receive "+FCON" execute "STARFAX.PRG" with parameter "A".

Send a Fax:
Create a job file and save it. A job file is just a list of name, 
number and fax files, look at it and you will understand. Then call 
STarFax with job name as parameter.

VIEWFAX:
As Parameter use a name of a fax file, it will be loaded.
Other parameters:
- O for Outgoing Fax
- I for incoming fax
- P print all new fax
- Q quit
Example: VIEWFAX.PRG   -O TEST.FAX

For more information about writing a fax driver, see the folder 
FDDKIT.

