eMozPrint  V1.81T
=================
24.12.2010, hanno



1.) Introduction
2.) Requirements
3.) Installation
4.) Usage
5.) Remarks and hints
6.) ToDo
7.) Contact/Thanks
8.) Disclaimer
9.) History



1.) Introduction:
-----------------
This utility helps to fill the lack of some Mozilla Firefox, Thunderbird and Seamonkey versions which do not offer "direct-print" support under eCS or OS/2 - they just create PDF files.
eMozPrint scans the desktop for PDF files created by Firefox, Thunderbird or Seamonkey. When a PDF is found, eMozPrint prints this files automatically or offers a dialog to print this files.

eMozPrint was built using "WDSibyl" (www.wdsibyl.org).



2.) Requirements:
-----------------
- OS/2 or eComStation (eCS).
- Ghostscript (latest available version: http://download.smedley.info/ghostscript-9.00-os2-20100919.zip - please do not forget to donate to Paul Smedley.)
REM: Without Ghostscript you may be able to print using a PDF-Viewer like Lucide. Use the eMozPrint option "View PDF" and print within the viewer (see also "Remarks and hints").



3.) Installation:
-----------------
- Ghostscript has to be properly installed 
- simply start eMozPrint in a directory of your choice and run it (a INI file will be created within the program directory during operation)
- to start eMozPrint during systemstart, put a shadow into your starup-folder (see possibility to create a shadow on setup page 2)

* eMozPrint does not make any changes or entries in config.sys or the os/2-ini files!



4.) Usage:
----------
The program should be self-explanatory :-)
See also the hints for some buttons and labels ("on mouse over" for 2 seconds) and read through this file.

There are 3 main possibilities for using eMozPrint (see setup page 1):
1. NO "auto print" and NO "auto view": eMozPrint will popup when a PDF is found and you can do the desired steps manually: printing, viewing, canceling
   (good choice if using "Universal Print")

2. "auto print": when a PDF is found, eMozPrint will immediately print your document, using the choosen options. (Disadvantage: you cannot interactively change the printer)
   (When using the addon "Universal Print", this option is not really useful except you will get absolutely no popup windows.) 

3. "auto view": eMozPrint will automatically open the PDF within you browser. This is a kind of preview with some advantages:
   You can choose the pages to print and you do not have to install Ghostscript. (Maybe you also want to choose the option 'after "View PDF" perform settings of "delete" and "restart scan")


It is recommended to use the addon Universal Print to avoid the FireFox popup for printing (popup is "senseless", because FireFox does not take care which printer and which options you choose: it will
always produce a PDF on the desktop).

Have a quick look at all three setup pages and tune the options to meet your requirements. (For example eMozPrint and scanner start behaviour, deleting the temporary PDFs, ...)



5.) Remarks and hints:
----------------------
!! IMPORTANT:
When "printing as image", some printers (printer queues) have problems with quality set to "Fine" and/or with "Fit print-out  to page". Do not use this options if your printer does not print although eMozPrint shows no errors!

* Seems that Firefox, Thunderbird and Seamonkey always produce PDF files in letter format and a fixed resolution, no matter what the user specifies within the printing dialog. (This might be changed for later versions of FF, TB and SM ...?)

* Thunderbird: Some versions do not allow to print using the menu option "print" (error message), so use the "preview" function and then print your document.

* Ghostscript installation is not needed if you print using a PDF-Viewer like Lucide. Use the eMozPrint option "View PDF" (or "auto view" - setup page 2) and print within the viewer.
  (Of course, "auto print" or printing directly within eMozPrint is not possible, if Ghostscript is not installed.)

* After "View PDF" and "auto view" it is possible to initiate the behaviour for restarting eMozPrint or deleting the PDF-file reflecting the actual settings.
  So it is possible to view the PDF, then do the desired actions (printing, saving, ...) within the viewer and, when leaving the viewer, there is no need for additional user intervention, the already choosen options will be executed.
  You can also use this procedure if Ghostscript is not installed. 

* "Universal Print": If you do not like to get the Firefox print-dialog and you want to use only the dialog offered by eMozPrint, there is an addon available for Firefox called "Universal Print" (Thanks to Ralph for this hint.)
  It is possible to install this addon within eMozPrint, see setup-page 2.
  Suggested settings:
    for Universal Print:"Always hide" and "Show print progress: enabled". This will suppress the FireFox printing dialog and show only the progress bar so no user intervention is needed.
    for eMozPrint: Autoprint: NOT enabled, Autostart scanning on programm start: enabled, restart scanning after printing: enabled. This will popup eMozPrint when a PDF was found and offer the possibility to view, print or cancel the PDF.

* If the links to "WDSibyl" or installing "Universal Print" or "Search for updates" do not work, maybe you have a FireFox version opened which is NOT the default browser. So close the active browser and try again.



6.) ToDo:
---------
(only if there is response ;-)  )
- automatic search for Ghostscript
- update data of "info"-button to reflect the latest Ghostscript version
- handling of errors during converting and printing (when using "device based" printing)
- progress bar (or percentage or page numbers) for printing
- solve possible problems concerning the startup shadow (when the mystery how to handle shadows in eCS is disclosed ...)
- button to filter/defilter eMozPrint on eCenter (as altering the OS/2.INI file is neccessary, this function will maybe never be implemented for security reasons)
- possibility for "reset to defaults ..."



7.) Send bugs, tips and hints to:
---------------------------------
xeSoftx@xaonx.xatx (without x)

PLEASE DO NOT ASK FOR SUPPORT FOR GHOSTSCRIPT!!!!!!!!!!!!!!


Thanks to Wolfgang Draxler, V. Ehlert (ehtron), Doug Bissett and Andreas Rderer for supporting and testing!
(see www.wdsibyl.org and www.ehlertronic.de)



8.) Disclaimer:
---------------
You are using this program at your own risk. The author gives no
warranty for the function or any others things affected by this program.
Under no circumstances the author is liable for any loss or damage supposed
to derive from the use of the program.



9.) History:
------------

V1.0T	15.03.2010
  *first "test"-version, useable until 31.10.2010

V1.01T	16.03.2010
  *eMozPrint-Form shows scan status in title/header (and therefore in eCenter)
  *added "Firefox" to search for
  *Icon for eMozPrint
  *thanks to Volker Ehlert "for testing"!
  *Info for printer/device implemented (new form)

V1.02T	19.03.2010
  *Device-list extended to ALL possible devices (based on GS8.71)
  *correct comparison of date for german/english date format

V1.03T	22.03.2010
  *-dSafer added as option
  *copy PDF always to temp (and ev. delete it in temp)
  *check included to test for ending of PDF creation (Copy-nach-Temp-Schleife)
  *Layout (and colors) changed
  *EncodeDate or date check
  *BringToFront for Form1-popup

V1.04T	25.03.2010
  *changed from tcFolders to tcSysInfo

V1.05T 26.03.2010
  *PDF-file-handling: changed from "CopyFile; DeleteFile" to PMWP-Object-handling
   (==> no problems with delayed reaction of WPS!)
  *PDF file not automatically moved to Temp
  *link to www.wdsibyl.com now based on tcExec functionality
  *Added and implemented: button "view PDF"
  *locked-check now based on TFileStream.Create

----------------

V1.06T	28.03.2010 (released on WDSibyl.org)
  *ScanThread-loop now based on "terminated" (not repeat-until endlessloop) - important for stability ==> mTScanThread.Destroy removed
  *signalsound changed
  *removed: comparing of LastFoundPDF (not needed because of "PMWP-Object-handling" since 1.05T)
  *added DosSleep after delete/move PDF (TCancel)
  *solved: wrong color for info line on program start when PFD scanner is stopped
  *scan-interval extended
  *reflect also "PDF file found" status in title 

V1.07T	02.04.2010
  *Form2 opening NOT modal
  *Disclaimer added to readme file
  *view/print/cancel buttons are disabled when no PDF is available ==>no need for error messages
  *moved location of "DosSleep" after delete/move PDF to make userinput more responsive
  *inserted DosSleep before moving or deleting a PDF
  *Form.Caption reflects printing status

V1.08T	08.04.2010
  *window popup: now works in any situation
  *scanthread: no f.free on timeout (printing of PDF)
  *scanthread: on timeout: abort scanning, close search, terminate scanthread

V1.09T	09.04.2010
  *removed: "Form1.ActiveControl:=GlyphButton_StartStopScan" to avoid wrong status of button
  *raised DosSleep (after delete/move) before restarting scanner

V1.20T	08.04.2010
  *printing is now "bitmap based" (i.e. no device to choose for Ghostscript - GS alsways produces a bitmap)
  *removed: pulldown menu and info form concerning GS-devices
  *readme added as separate tab
  *included: printing options (set number of copies, orientation, ...)
  *new layout (separate tab for setup and readme, smaller main window, text within scrollable memofield)

V1.21T	09.04.2010
  *added "stretch letter to A4" option
  *removed DosSleep after printing (cancel section) - not needed in bitmap-version
  *changed: draft=150x150, normal=200x200, fine=400x400
  *heap stack set to 100MB
  *GS: options for image interpolation and subsample antialiasing added to improve quality
  *set main window not sizeable
  *error handling after printing implemented
  *error handling implemented when no temp-bitmap available (in case of problems with GS)

V1.22T 09.04.2010
  *Ini saved after tab change
  *changed priority for GS while creating bmp
  *inserted DosSleep after GS thread
  *mFileFoundYN stuff removed (obsolete)
  *scanthread loop optimized (if no PDF was found)
  *releasing of find-resouces after GS/bitmap error
  *removed DosSleep after timeout-check

----------------

V1.50T	10.04.2010 (released on WDSibyl.org)
  ***merged functionality of V1.09T and V1.22T
  *button and handling for "print as image" implemented
  *layout changed
  *separate thread for GS and printing to manage priority
  *on first start of eMozPrint goes to "Setup" tab (next starts go to "Print" tab)

V1.60T	14.04.2010
  *added: possibility to abort printing
  *"ProcessActive" instead of "DosExitCode" used to check if GS has ended (should be more reliable)
  *changed background color of readme and buttons
  *deleting of temp bitmaps using "DelPath" at end of printing
  *double click on info-bar starts/stops scanner
  *second setup tab for GS settings and some infos
  *new button: path of Ghostscript can be changed (to support multiple GS installations )
  *user can define path to additional fonts
  *always go to print tab after finding a PDF

----------------

V1.61T	15.04.2010 (released on WDSibyl.org)
  *Moz-PDF searchname no more case sensitive (problem with "Seamonkey" to "SeaMonkey" solved)
  *bugfix: checkbox BitmapOrDevice not recognized
  *"WriteIni" OnDestroy instead of OnClose (to prevent from blocking shutdown)
  *device-based printing now detects papersize
  *TabbedNotebook-hint disabled
  *FitToPapersize also for device-based printing (formerly called "Stretch to ...")

V1.62T 23.05.2010
  *Hint how to suppress FF print dialog added to readme (thanks to Ralph)
  *small layout changes

----------------

V1.70T (REM: ini-vers 1.70T)	20.08.2010 (released on WDSibyl.org)
  *Additional setup-page with new features (s. changes below), setup page2 changed to page3
   *possibility to enter and store user defined search patterns for PDF filenames
   *new option "View PDF": after viewing a PDF restart eMozPrint or delete a PDF according to the current settings
   *possibility to easily install the addon "Univeral Print" (within eMozPrint)
  *button behaviour during "View PDF" improved
  *small layout change (concerning "Abort" button)
  *error-handling for corrupt PDF files (size=0, mainly in case of a crash of FireFox while printing), such files will be deleted
  *added hints to some more fields
  *default for "hide eMozPrint on scanner start" changed to checked
  *version check to suggest deletion of EMOZPRINT.INI implemented
  *info-box at first start of eMozPrint
  *possibility to open "readme" with standardeditor (within eMozPrint)

----------------

V1.71T (REM: ini-vers 1.71T)	22.9.2010 (released on WDSibyl.org)
  *improved check for corrupt PDF (size=0): changed from checking "searchresult" to filegetsize (=> renewed/independend check)
  *setup page 2: possibility to create/remove shadow in startup folder to autostart eMozPrint on system start
  *revision of ini_read/write-, first_start- and new_version-behaviour
  *tested with latest Ghostscript version 9.0 - seems to work o.k. (link is mentioned at top of this readme)
  *quick link to search for latest eMozPrint version on "About"-tab
  *small layout changes

----------------

V1.80T (REM: ini-vers 1.80T)	30.10.2010 (released on WDSibyl.org)
  ***changed useabilty to "31.12.2010"
  *additional option "auto view": automatically open PDF with standard viewer (useful when no Ghostscript  is installed or to check PDFs permanently)
  *startup shadow will be deleted if a new version is detected and "Exit eMozPrint" is choosen (avoids "zombie"-shadow)
  *marking the checkboxes "auto print" and "auto view" stops the scanning for files
  *improvements on readme
  *printer icon added (double click starts/stops scanning), eMozPrint-Icon (about tab) and some other layout changes
  *added within PrintThread: update of info label for Ghostscript-path
  *form control "Maximize" removed
  *settings for windowsize (Ghostscript path) moved from "first_start" to general startup settings (now all relevant calls are covered)

----------------

V1.81T (REM: ini-vers 1.80T)	24.12.2010 (released on WDSibyl.org)
  ***changed useabilty to "30.04.2011"
  *check value for "corrupt PDF" changed from =0 to <=1000 Bytes
