home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Gold Fish 1
/
GoldFishApril1994_CD1.img
/
d2xx
/
d246
/
labelprint
/
english_doc
/
documentation
< prev
next >
Wrap
Text File
|
1989-09-13
|
25KB
|
573 lines
Documentation of LabelPrint
---------------------------
LabelPrint v2.5 (c) 6/1989 by Andreas Krebs
Following files and drawers are parts of the LabelPrint package and have
to be copied, when you copy LabelPrint.
-LabelPrint (The program itself)
-LabelPrint.info (Icon for LabelPrint)
-Deutsche_Anleitung (Drawer with the German Documentation)
-English_Doc (Drawer with the English Documentation)
The program LabelPrint was written to allow you easily to print Labels for
your disks. For that you have a great variety of options you can use
to design your Labels.
I wrote the program, because I was fed up with writing my Labels by hand.
And so I decided to write a program making this task almost alone.
The version 2.5 of LabelPrint works together with all printers, so far as
a suitable printer driver is used.
The program contains some spezial features for the Epson LQ-850 and
compatible printers. (explained later)
How to start LabelPrint:
------------------------
You can start LabelPrint as well from the CLI as from the Workbench by
a double click on the icon.
The menu-functions of LabelPrint:
---------------------------------
Afer starting LabelPrint the LabelPrint-window appears.
In its menu bar you see this menues:
(c), Spezial, Label, Print, Clear, Input, Output, Block
(c):
----
This menu has no use, it only contains the Copyright-notice.
Spezial:
--------
-About: ...opens the information-window.
-Prefs: ...opens the preferences-window. (explained later)
-Config: ...contains ab submenu for controling all parameters of LabelPrint.
The program tries automatical to read this parameters, when you
start it.
-Load: Load the parameters from the File
'SYS:devs/LP-Configuration'.
-Save: Save the current parameters to the File
'SYS:devs/LP-Configuration'.
-Pause: ...closes the LabelPrint-window, opens a small window
in the left top edge and puts the program into a waiting state.
To continue the program click on the CONTINUE-gadget.
(This function is of great value if you want to work with the
workbench.)
-Quit: ...quits the program, but before you are asked, if you really want
to quit it.
Label:
------
-Append: ...opens a submenu with subitem 'ASCII' in it.
This function opens a File-Requester, which allows you to
select a file, for saving the current entries to an ASCII-file.
(The File-Requester is described below.)
This function helps you to create great lists containing the files
of a lot of disks.
-Save: ...contains a subitem with following functions:
(They also open the File-Requester.)
-Data: Saves all entries and parameters to the spezified file.
-ASCII: Saves all entries to the spezified ASCII-file.
-Load: ...contains a submenu with the subitem 'Data' in it.
This function also opens the File-Requester to select a file, from
which old entries and parameters should be load.
You can only load files, that were save with the Data-function of
the Save submenu. (When you load entries the old ones get lost,
so make sure that you don't need them any more !)
Print:
------
-Sort List: With this menuitem you can define whether the program should
sort the entries or only remove the empty entries, when the
function SORT is activated.
The function can be activated or deactivated by choosing the
subitem ON or OFF.
-First: With this function you can determine, if the files or dirs should
be printed first. When no type is selected, the entries are
printed without considering their type.
-Dirstyle / Filestyle: With this two items you can determine how the
dirs / files are written.
If capital is activated, then all entries of the selected type
are written in capital letters. The small item effects, that
all entries of the selected type are written in small letters.
Mixed allows as well small letters as capital letter.
-n times: ...opens a requester to determine how often the
label shoud be printed. (1 - 99)
The current number is written behind the menuitem ( ).
Clear:
------
-All: ...clears all entries after asking you, if you really want to clear
them.
-Types: ...contains a submenu with following items:
-Files: ...clears all entries of the type file after a request.
-Dirs: ...clears all entries of the type dir after a request.
-.info: ...clears all entries with the ending '.info' (icons)
after a request.
-Double: ...clears all entries being ot the same type and having the same
name. (There's no difference made between small and capital
letters.)
-Type: With this function you can determine of which type the cleared
entries should be.
-Kill: With this function you can determine how the entries should be
killed when using the Kill-function (described below).
'Remove entry' removes the entry from the list, whereas
'Clear entry' only clears the string-gadget.
Input:
------
-Import: ...imports the current entries of the File-Requester to the
LabelPrint-window with rereading the directory. (Attention:
the old entries are clear automatically.)
This function is a very comfortable way of reading in a disk
or directory.
-Add: ...has a similar function as Import, except it didn't clear the old
entries, but appends the new ones to the old ones.
With this function you can create lists containing the files of
some directories.
-ReadIn: With this submenu you can determine what LabelPrint should
read in.
Possible types are:
-Files
-Dirs (directories)
-.info (files ending with '.info')
At least one type should be activated, because otherwise nothing
will be read in.
-Sort: ...determines in which way the entries should be sorted.
If UP is selected, the entries are sorted in alphabetical order.
If DOWN is selected, the entries are sorted against alphabetical
order.
Output:
-------
-Comment: ...opens the Comment-window for writing comments to the filelist.
(explained later)
-Sign: With this submenu you can determine which sign should be printed
before the entries:
You can choose between: - o
+ =
< >
# ' '
The selected sign is shown in front of the Entry-Gadgets.
-In: With this function you can determine, either the entries should be
printed in 'Columns' or in 'Lines'.
This function only changes the sequence of the entries, but not the
number of columns and lines.
Block:
------
-Last: ...shows the last block (4). As LabelPrint is only able to show 30
entries at onces on the screen, I've created 4 blocks, so that you
can control 120 entries.
-First: ...shows the first block (1).
-'+': ...shows the next block.
-'-': ...shows the block before.
The gadget-functions of LabelPrint:
-----------------------------------
On the LabelPrint-window you can see a lot of different gadgets. The
following section of the documentation explains their functions.
-Close-gadget: This gadget is placed in the left part of the top border.
This gadget quits the programm. (same function as Quit in the Spezial-
menu)
-DiskName-gadget: This string-gadget shows the name of the actual drawer.
In this gadget you can put in the name of a drawer or volume to read
in.
-Drive-gadgets: This 6 gadgets are placed in the right bottom of the
LabelPrint-window. They contain the names of different volumes, that
are read in by clicking on the gadget. Attention, this will clear all
entries. (This function helps you to save work, because you don't need
to use the File-Requester.)
-About-gadget: This gadget is placed in the right top of the window.
It will open the information-window. (same function as About of the
Spezial-menu)
-Prefs-gadget: This gadget is placed right of the About-gadget and has
the function to open the Preferences-window. (same function as Prefs
of the Spezial-menu)
-Entry-gadgets: This are 30 long gadgets in the middle of the window.
Each of this gadgets contains one entry, which you can change the way
you like it. The length of each entry is limited to 17 characters.
The maximum number of entries is 120 in 4 blocks.
-EntryType-gadgets: Behind each Entry-gadget you see a small gadget with
a D or F in it. This 30 gadgets are the EntryType-gadgets, with this
gadgets you can change the type of each entry.
When clicking on one of the gadgets, there alternately appears a D or
F. D stands for directory, whereas F stands for file, so that you can
easily change or create a entry type.
The type of the empty Entry-gadgets is determined by the Type-item of
the Clear-menu.
-'+'- / '-'-gadget: This two gadgets are placed in the left bottom of the
window. They have the function to increase / decrease the block number.
(same function as '+' / '-' in the Block-menu)
-No.-gadget: This gadgets is placed right of the '-'-gadget and shows the
number of the active block (shown on the window). By typing in a number
between 1 and 4 you can change the active block.
-'Kill Entries'-gadget: This gadget makes it possible to kill easily one
spezial entry. When clicking on the OFF-text, a ON-text appears showing
that the Kill-mode is active. When this mode is active you can kill an
entry by a click on its EntryType-gadget.
Make sure that you turn off this mode after use, or you could kill an
entry when you try to change its type.
-Insert-gadget: This gadget makes it possible to insert an entry before
another. When clicking on the OFF-text, a ON-text appears showing that
the Insert-mode is active. When this mode is active you can insert an
entry before another by clicking on its EntryType-gadget.
The 'Insert'- and the 'Kill entries'-function exclude each other, so
that when you activate one the other is automtical deactivated.
-Print-gadget: This gadget starts the printing of your labels. To print
them the program uses the current parameters. The number of prints is
determined by the function 'n times' of the Print-menu.
-Sort-gadget: This gadget has the function to sort all entries.
The way and the direction can be determined by the menuitems 'Sort List'
and 'Sort' of the Input-menu.
-Clear-gadget: This gadget has the function to clear all entries, after
asking you, if you really want it. (same function as All of the
Clear-menu)
-'Append to'-gadget: This gadget contains the name of the file to that
the actual enties are appended in the ASCII-format.
Is automatically set after using 'Append ASCII' of the Label-menu.
-Append-gadget: This gadget appends the actual entries to the file named
in the 'Append to'-gadget. If the file doesn't exist, the program will
create it. This function was made to create huge lists with the entries
of some disks by appending the entries several times to the same file.
(Saves work, because you don't have allways to use the File-Requester.)
-'Read In'-gadget: This gadgets reads in the drawer named in the
DiskName-gadget. Before reading in a volume you have to add a double
point. (The same you can achieve in a more comfortable way by using the
Import-function of the Input-menu.)
The File-Requester:
-------------------
A lot of functions of LabelPrint working together with disks start the
File-Requester.
The File-Requester keeps the last directory and shows it, when started
again. Has no directory been selected, then the File-Requester shows a
list of the disks in your drives. This list also appears when clicking
on the gadget 'VOL'.
To read in a directory or volume you only have to click on its name.
The name of the directory read in is shown in the string-gadget 'Drawer:'.
When clicking on a file, the name is shown in the string-gadget 'File:'.
You also can type in a name direct in the 'File:'- or 'Drawer:'-gadget.
To read in a directory press <RETURN> after typing the name in the
'Drawer:'-gadget.
By clicking on the gadget '/ DIR' the parent directory is read in, if it
exists.
As the File-Requester is only able to show 6 names at onces, you can scroll
the list up and down by clicking on the arrow-gadgets or by dragging the
proportional-gadget up and down.
To leave the File-Requester you can use the 2 gadgets at the bottom of the
window. The right gadget ('CANCEL'-gadget) breaks the function of.
The left gadget continues the function. The text shown in the left gadget
changes according to the function, that started the File-Requester.
The Preferences-window:
-----------------------
This window appears when you click on the Prefs-gadgets or select Prefs
from the Spezial-menu. This window has a similar function as the
preferences-window of the workbench. It has the function to define the
parameters for the printing of your labels.
The Preferences-gadgets:
------------------------
(from the left top of the window to the right bottom)
-Columns-gadget: With this gadget you can define the number of columns
used for printing the entries. The number has to be between 1 and 6.
-'Left / Right Margin'-gadget: With this two gadgets you can define the
left/right margin of your printing area. But when changing the numbers
you must consider that each printing column is 19 characters wide.
Be careful and don't make the distance to small. LabelPrint is able to
set the right margin automatically. (See below)
-'LINE FEED'-gadget: ...defines the number of free lines before starting
the print. (This functions is very useful when you are printing labels
for 3.5"-disks.)
-'Lines to print'-gadget: ...defines the minimum of lines to print.
The 'LINE FEED'-lines and the line for the disk name are not counted.
(This function is of importance, when you use continuous labels to
make sure that the printer stops printing at the beginning of the next
label)
-PrintStyle-gadgets: ...define the way in that directories and files are
printed. You can choose between 4 possibilities:
Normal: no spezial printing effects
Italic: print italic
Bold: print bold
Ita+Bo: print italic and bold
-'Form Feed'-gadget: When this function is activated, LabelPrint makes
after each printing a form feed. This function is very usefull when
you are using a cut sheet feeder to make sure that each printing starts
with a new label. When this function is activated, LabelPrint neglects
the 'Lines to print'-function.
-'Char Set'-gadget: ...defines the international char set used by the
printer for printing Labels:
Possible char sets are:
-German
-UK
-Danish I
-Swedish
-Italian
-Spanish
-Japanese
-Norwegian
-Danish II
-US
-French
-'Defines Name'-gadget: ...contains the name of the file used for saving
your own defined parameters. (see below)
-Quality-gadget: ...defines the printing quality. You can choose between
Draft and Letter quality.
-Spacing-gadget: ...defines the line spacing. You can choose between
6 or 8 LPI in Standart-mode (see below) or from 5 to 15 LPI in the
'Epson LQ-850'-mode.
-Pitch-gadget: ...defines the size of the characters.
There are 3 sizes you can choose:
10-Pica: In this size 10 characters were printed per inch.
12-Elite: In this size 12 characters were printed per inch.
15-Fine: In this size 15 characters were printed per inch.
(only in the 'Epson LQ-850'-mode)
-Doublestrike-gadget: When this function is active, each line is printed
twice. This makes it look better, but it slows down the printer.
-Condensed-gadget: ...activates or deactivates the condensed print mode.
When this mode is activated each character is printed about 40% smaller
than normal.
-Script-gadget: With this gadget you can define the position of the text.
The selected way of printing is not used for the title-line.
You can choose between these ways:
-Normal: normal position
-Super: the characters are printed a 1/3 smaller and in superscript
-Sub: the characters are printed a 1/3 smaller and in subscript
This function is very usefull, when you want to print extrem small text.
-Defines-gadgets: With this gadgets you can activate predefined parameters
for 3.5"- or 5.25"disks. At the beginning the defines for 3.5"-disks are
active. The 3.5"-disk parameters are for normal continuous labels (7x7cm).
The 5.25"-disk parameters are not for the normal 5.25"-disk labels,
because I think they are to small for printing all contents of a disk on
them. So I decided to use greater labels, that use the whole breadth of
the disks. But I couldn't buy them as continuous labels so use a cut
sheet feeder for printing on them.
-OK-gadget: With this gadget you can close the Preferences-window, at which
LabelPrint uses the new defined parameters for printing.
-Cancel-gadget: With this gadget you can close the Preferences-window, at
which LabelPrint neglects the new defined parameters and still uses the
old ones.
The Preferences-menus:
----------------------
Defines:
--------
-Save: ...saves your parameters determined by the 'Set'-function using
the name shown in the 'Define Name'-gadget as file name.
-Load: With function you can load your saved parameters. As file name
LabelPrint uses the name shown in the 'Defines Name'-gadget.
(You can't use Defines of earlier versions of LabelPrint because
version 2.5 saves and loads them in a different way.)
-Use: ...allows you to activate one out of four defines by selecting it.
-Set: ...allows you to set four defines, that you can recall afterwards
by using the Use-item.
To set a define you only have to select one of the four defines. It
automatical will save all parameters in the Preferences-window to its
buffer. (The old define of this number will be lost.)
Title-Style: With this menu you can define how the disk name should be
------------ printed.
-Underlined: When this function is active, the disk name is printed
underlined.
-Normal: ...deactivates the three following functions (Italic, Bold,
Enlarged). It has no effect on the Underlined-function.
-Italic: When this function is active, the disk name is printed italic.
-Bold: When this function is active, the disk name is printed bold.
-Enlarged: When this function is active, the disk name is printed enlarged.
-'Double Height': When this function is active, the disk name is printed
double as heigh as normal.
(Only in the 'Epson LQ-850'-mode)
Other:
------
-'Set right margin': When this function is active, the right margin is
set automatically.
This function should only be turned of, when realy required, because
a wrong set right margin can have fatal effects.
-'Test title size': When this function is active, LabelPrint automatically
tests the size of the titleline and commentlines according to the way
of printing (Enlarged on or off ?).
This function makes sure that each line is printed on the label and
not on the platen of your printer.
-Printer: With this function you can choose the printer you use.
At the time there are only two possibilities:
-Standart: only commands of the printer device
-Epson LQ-850: some spezial commands of this printer are use
additionally
If you own a printer, that is not compatible to the Epson LQ-850,
then write me a letter with following information:
1. Command for Micro-Print (15 CPI: Fine):
(Epson LQ-850: ESC g or $1B $67)
2. Command for n/60" (or n/180") line spacing:
(Epson LQ-850: ESC A n or $1B $41 n)
3. Command for double high characters:
-on: (Epson LQ-850: ESC w 1 or $1B $77 $01)
-off: (Epson LQ-850: ESC w 0 or $1B $77 $00)
(Best would be you send me a complete list of all commands
of your printer, because I don't know now which further
functions LabelPrint in future may have.)
If you send me a list, I'll put your printer to the printer-list,
so that new version of LabelPrint also use your printer as good as
possible.
The Comment-window:
-------------------
This window opens,when you select the menuitem 'Comment' from the Output-
menu. The Comment-function allows you to write up to 10 lines of comment
for your labels.
Comment-gadgets: The Comment-gadgets are the 10 long gadgets, that are
placed in 2 blocks of 5 gadgets.
In this gadgets you can type in the Comment for your labels.
(Attention: Empty lines (with no characters in it) will be automatically
removed before printing a label, so if you want to have a free line
you have to type in at least one space ' '.)
Style-gadgets: The Style-gadgets are the 3 gadgets placed behind each
Comment-gadget. They allow you to define the printing style for the
Comment-gadget, that to it belongs. You activate / deactivate them by
clicking on the gadget. The gadgets are:
1. gadget (Bol): bold
2. gadget (Ita): italic
3. gadget (Enl): enlarged
If the function 'Test title size' is activ, LabelPrint tests the
size of text in the Comment-gaget. If the text is to long, it'll
be simply cut off.
Reset-gadgets: ...are place above the 2 blocks of Style-gadgets.
They turn of all Style-gadgets of the block below, so that the text in
this block is printed normal.
Pos-gadgets: ...are placed in front of the 2 Comment-blocks.
They define the position of your comment on the label, at which you can
choose between 2 posaitions.
- (B)egin: The Comment-block is printed after the title-line, but
before the entries.
- (E)nd: The Comment-block is printed at the end of the labels.
(after the entries)
You can change the status of the gadget by clicking on it.
If both blocks have the same status, the first block will be printed
at first.
'Kill Comment'-gadget: ...activates the Kill-mode, which allows you to kill
a commentline by clicking one on of the to it belonging Style-gadget.
The killed commentline will be removed from the list.
(Deactivate this mode after use !)
Insert-gadget: .activates the Insert-gadget, which allows you to insert a
commentline before another by clicking on the to it belonging Style-
gadget. The Style-gadgets on the new commentline will be automatically
turned off. (Deactivate this mode after use !)
The Insert- and the Kill-mode exclude each other, so that when you
activate one the other is automtical deactivated.
Exchange-gadget: ...exchanges the contents of the 2 Comment- and Style-
blocks. The Pos-gadgets stay the same.
(This function is of great value, when both blocks have the same status.)
Remove-gadget: ...removes all empty lines from the comment. It is a test,
whether all empty lines are really empty, that should be removed.
CANCEL-gadget: With this gadget you can leave the Comment-window, at which
all commentlines are cleared, so that at the printing no Comment
appears.
OK-gadget: With this gadget you can leave the Comment-window, at which the
Comment is use by the main-program, so that the Comment appears at the
printing.
I hope LabelPrint will help you to print your labels faster and better,
and don't forget to send me $10 US or 20 DM, when you decide to use it.
(read README-first)
If you have comments or bug reports please send them also to me.
(Please add a detailed description of it)
Send your comments or bug reports also to
Andreas Krebs
Mittelweg 9
7110 Oehringen 2
FRG
Tel.: 07948/2101