CHAPTER 6

6.1	Receive Fax

STarCall can receive faxes, when you have got a CLASS-2 compatible FAX-Modem, and is able to receive FAX and MODEM at the same time.
STarFax is a modul for the Terminalprogram STarCall, but it can be used as "stand-alone" programm, too.
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

When you do now 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
- Copy the file "STARCALL.SET" to your root directory ('C:\'). This file contains some global settings for STarCall.
- Use any editor to change the path "SEND" and "RECEIVE" for sending and receiving fax files. The lines REGNAME and REGCODE are reserved for name and registration code. Read the file "REGISTER.TXT" for more information how to get this code.

Now save the file. STarFax is prepared for work now.

6.2.1 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.2	Receive a Fax with STarCall

You have to check and perhaps to change the following parameters:
- Path: You must set the path for STARFAX.
- answer calls: Enable MODEM+FAX and the number of rings.
- The file "STARCALL.SET" should be installed.
- 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 you, 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 Mag!x, 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.3	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-Texte, 1st Word Plus 2.x / 3.x Texte

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". Starfax will dial the number now and send the fax after connection.


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

When you want to send same or different Fax files to many people, the JOBS will help you:



Select a name from the number list. You should enter the names to the list before using this function. In the middle you can select the fax files, which will be send. You may use "VIEW FAX" to look into your Fax, when you do now know, whether you have the right file.
Then click ADD to add it to the job list. The number of jobs will increase. Now you can select a different name, again some files etc... When you are ready click "OK". You can save your jobs, when you want to use them later.

6.5	Fax Options

You can select some options for sending a fax:


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 receivers 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 logo" to save it. You will find some demo images on your disc.

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

6.7	Using STarFax for own programs

When you are a programmer, you can use STARFAX for your own programs. 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".

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.




The functions:

Load incoming fax:
This will show you a list of all FAX files you have received.New fax files are marked with a clock symbol. You now can select some FAX files with the mouse and display them by clicking "OK". You also can print or erase a fax, or use the GEM fileselector to load a fax file.

View outgoing fax:
This will load a fax you have prepared for sending.

Load IMG-Graphic:
This loads a graphic file.

Save as logo:
This will save the current document under the default logo file name.

Save as signature:
Saves the current window as signature.

Save as any fax:
This will save the current window using any filename. This can be used to save a IMG as FAX file, or to copy a incoming fax for sending.

Print:

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

Print all Fax files:
This will print all received fax files. Especially when you have received many fax files, this will be usefull.

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.

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

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.

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.

6.8	Using the Fax-modul for programing own programs

Please send a letter or e-mail for more information.

