Anzio version 16 readme file This edition is dated Oct. 8, 2007 Applies to Beta 16 (and later) This file is available at: http://www.anzio.com/~ras/anzio16/readme16.txt Check frequently for updated versions. This file contains information on installing, configuring, programming, and using AnzioWin and Anzio Lite version 16. Please direct all questions via email to support@anzio.com Your question and our answer to it will be sent to all beta testers, if we deem that appropriate. =============================================================================== THE BETA TEST PROCESS There are no rules or requirements for the beta testers. The download will run as a demo until early December. If you have a license to an earlier Anzio, that will NOT apply to version 16. The benefit for you is early access to new features, as well as a chance to influence product direction. The benefit to us is good technical feedback. =============================================================================== ANZIOWIN vs. ANZIO LITE Most of this document refers to AnzioWin. Anzio Lite version 16 is also now available, at: http://www.anzio.com/~ras/anzio16/anzio32r.exe Most of the new features described below are available only in AnzioWin. However, in version 16 of Anzio Lite we have added in some features that formerly existed in AnzioWin only. Specifically they are: a) Change logged directory menu, CD & LOG commands b) PLAYSOUND from host (requires WinInet) c) PRINTER-SETUP command d) Background bitmap, BMP* commands e) Toolbar setup f) KILL g) MKDIR/S h) COPY (file to file) i) FIND/S, FINDNEXT/S j) TIME/S, DATE/S k) WIDTH l) RENAME m) CALC n) MERGE o) Monitor menu item p) CLONE q) SCREENMODE/S r) Cursor line & position in Gauge Testing instructions for Anzio Lite are parallel to those for AnzioWin. =============================================================================== INSTALLATION The program file for AnzioWin version 16 is available at: http://www.anzio.com/~ras/anzio16/anzio32.exe and it is updated frequently. However, this is only the main executable, with none of the supporting files, and no installer. (Note: It is possible to run AnzioWin from this location, without doing any installation at all.) To get started: IF: you have an existing version of AnzioWin, you can install the new Anzio in such a way that it does not impact your current operation, as follows: 1. Update it to version 15.2j from our website at http://www.anzio.com/pub/anzio15/anziowinsetup.exe 2. Make a directory off root, such as c:\anzio16beta 3. Copy everything from the install directory of Anzio 15.2 into the new directory 4. Download the new anzio32.exe from the location above into the new directory, over the top of the old anzio32.exe. 5. Manually create a desktop icon to run the new Anzio32.exe ELSE: (if you don't have an existing AnzioWin) 1. Do a fresh install of AnzioWin from our website, at http://www.anzio.com/pub/anzio15/anziowinsetup.exe For ease of access, and to avoid some restrictions, particularly in Vista, install it off of "\", such as in c:\anzio16beta 2. Download the new anzio32.exe from the location above into the new directory, over the top of the old anzio32.exe. =============================================================================== CONFIGURATION By default, AnzioWin will use as its settings file anziowin.def, in the same directory you start AnzioWin from. Older versions of the settings file can be moved forward into version 16. However, settings files saved from 16 can not be used by versions before 15. The settings file contains the pathname of the keys file. To reset this setting to point to a keys file in the new Anzio's directory, do File:Read Keys, and navigate appropriately. The settings file is a plain text file, and can be edited with Notepad. Some features can be activated only by editing the settings file, until we add user interface support for them. Feel free to browse this file, and ask us questions. Note also that it is possible to compare two different settings files with the command-line program "FC", such as fc anziowin.def testfile.def =============================================================================== WHAT IS *NOT* READY YET Just so you don't waste time, here are some notes on things that are not ready to go yet: * User interface translations into Spanish, Italian, and French are not yet updated. * Some items do not yet have a user interface, and must be enabled via a "back door". =============================================================================== NEW FEATURE EXPLANATION As a reminder, many of the following descriptions refer to Anzio commands. Anzio commands can be a) sent from the server, b) executed from a macro, or c) typed manually into the "FUNCTION:" prompt generated by "Macros:Enter commands". The syntax used here to indicate optional arguments, etc., follows that used in the Anzio manual. References to menu sequences use colons to separate menus, submenus, tabs, and actual items to change, such as "Edit:Advanced Options:Print Wizard:Auto orientation". ------------------------------------------------------------------------------- * Initial Language Prompt At startup, when there is NOT a settings file (i.e., you're starting from scratch), if the Windows default language is other than English, Anzio will ask you what menu language you want to use. ------------------------------------------------------------------------------- * Settings File Import It is now easier to move your Anzio settings file(s) from one computer to another, such as during updating Anzio or when replacing PCs. The feature that allows this may also help those installing Anzio on many PCs. On an existing Anzio, do File:Save Settings As, and navigate to a thumb drive, for instance. This will save your settings file (normally anziowin.def) onto that drive. Eject that drive and take it to the new PC with Anzio 16. If you start up Anzio version 16 and don't have an anziowin.def settings file, or if you go to the File menu and select the new "Import Settings" item, you can navigate to the thumb drive and pull the settings file off of it. Then you'll want to store that data on the local hard disk, which you can do by simply quitting from Anzio, and answering "yes" to "do you want to save...". As with all up-migrations, Anzio uses the settings that you already have, and assigns default values to all newly implemented settings. ------------------------------------------------------------------------------- * Image Viewer The new image viewer window can form the foundation of an image enabled application. You could, for instance, view a scanned invoice in one window while doing data entry in the main Anzio window. You can scan directly into the viewer window. You can page through a multi-page document. You can even display a PCL-5 document in that window, and page through it! Here are some initial points on how to use this feature: + Go to the File menu, and click "View an Image File". + Choose an eligible file. Supported are BMP, GIF, JPG, JPEG, TIF, TIFF, PCX, DCX, image PDF, and PCL. + Initially, the window will open in a default location, to the right of the main Anzio window and down a little. + You can move, resize, and zoom the window. The image will resize automatically. + If you have a multiple monitor setup, you can move the image window to a different monitor, and possibly zoom it there. + If View:Track Window Position is checked, this window placement will be saved and used automatically next time (but you can override that with a command). + If the image file contains multiple pages, click on the image window, then use and to move through the pages. Other methods will be added in the future. + The Anzio command for this is IMAGEBOX FLOAT You can use this command and variations from a macro or issued from the host. + The can be a URL, so that the file is pulled from an FTP, HTTP, or HTTPS server. + Also in the File menu is Scan:Scan and View. This will scan a page from the scanner (possibly more, if the scanner has a page feeder), and place it in the viewer. (More to come) ------------------------------------------------------------------------------- * Scanning from the Menu and Toolbar The File menu now has a Scan submenu, with "Scan and Print", "Scan and Save", "Scan and Send", and "Scan and View". The default toolbar now contains "Scan and Print" and "Scan and View". Scan and View is described above. The others are, we hope, self-evident. The "Scan and Send" will send the scanned image to the server, using the default protocol selected under Transfer:Transfer Options. The file is sent to the current server. The name used for the file on the server is as configured in the settings file under "scanfile-name". The file extension on this name will determine the file format in which it is saved (.TIF, .BMP, etc.). Note: Scan and Send currently works only with FTP and SFTP. ------------------------------------------------------------------------------- * Emailing with AnzioWin In addition to the ability to automatically email created PDF and TIF files (see below), AnzioWin now has a general purpose MAILTO command. The syntax is: MAILTO [= [=...]] (More to come) ------------------------------------------------------------------------------- * Toolbar Improvements Anzio has long had a configurable toolbar. In the View menu, click "Configure Toolbar". You can turn the toolbar on and off, and you can specify up to 20 toolbuttons, each with some text and an action. In the past, these actions could only be macros to run. But macros are stored in the keys file, which can get changed, and it wasn't a good design. Now it's better. Each action can now be an Anzio command. All configuration is maintained in the settings file. We have developed a set of standard toolbuttons, and those are enabled by default. You can also reset all the toolbuttons to the standard by clicking a new "default" button in the toolbar configuration window. (Existing settings files will be brought forward in a compatible manner, with each macro ID converted to a command to do "invoke ".) The standard toolbuttons perform actions that would be most common in everyday operation of Anzio, plus some things that users might not otherwise discover. They do NOT do configuration actions, except "Printer Setup". ------------------------------------------------------------------------------- * Expandable Filenames for PDF, TIF Now when you "print" to a PDF or TIF file, the name does not need to be static. After all, that would lead to repeatedly wiping out the previous file. The file name can now contain replacement variables, that AnzioWin will "expand" into a final filename. In addition, filenames can be serialized; that is, they can include a decimal number that will be incremented until the overall filename is not already present. Replacements parameters are coded as ${} such as ${ANZ_WINNAME} This entire string will be replaced by the Windows user name. Most of the available variables are as listed in section 9.3 of the Anzio manual. The following have been added: + ANZ_DOCNAME + ANZ_DOCPATH + ANZ_DOCEXT + ANZ_DATE + ANZ_DATE_ + ANZ_TIME + ANZ_TIME_ (More to come) ------------------------------------------------------------------------------- * New "Print a File..." in File Menu This new menu item will prompt the user for a file to print, and print it according to how Anzio is configured. That is, it could generate a PDF (and email it), generate a fax, etc. While this sounds simple, the beauty is in how many file types Anzio can handle, notably: + Image files (.TIF, .JPG, .GIF, .BMP, .PNG, .PCX, .DCX) + Image PDF files + Windows spool files (.SPL) + Windows meta files (.EMF, .WMF) + PCL files (does not require a PCL printer) + Plain text files, including .BAT strings, scripts, program source files, log files + Tab-separated-values files + Some .htm, .html files + Print Wizard Markup Language (PWML) files ------------------------------------------------------------------------------- * PDF as Input File AnzioWin can now read certain PDFs as input for display and printing. PDFs must be of images only, such as from some scanner software. Also, the file must not be password protected. You can print a PDF with PRINTFILE, use it as a form overlay, display it with IMAGEBOX, or use it as a screen background with BMP. ------------------------------------------------------------------------------- * Reading PC File Info, from a Host Script or Program The ability of a program on the server to control the PC environment through Anzio had a serious shortcoming: the host program could not find out if certain files existed on the PC, or anything about them. Now a new command helps with that. The command FILEINFO/S will return to the host a string containing information about the file, if it exists. You would issue this command as explained in section 12 of the current manual, then read an input string from the terminal. Anzio will respond with a string. For details, see the Change History section below. ------------------------------------------------------------------------------- * Cleaning Up Old Files A new command in Anzio allows you to clean up old files: FILE-CLEANUP This will search through the files meeting the pattern in . Any that it finds, that are at least old, it will delete. You could use this to clean up an image download directory, for instance. ------------------------------------------------------------------------------- * Transferring Files Only If Needed Suppose you want a client PC to use a certain overlay file for printing, but you don't know if it exists on the client PC. And you don't want to transfer it every time. Now you can do SFTPREGET [] This will function like SFTPGET, but it will "re-get" the file. That is, it will do the transfer only if the host has a newer version or the PC doesn't have the file at all. ------------------------------------------------------------------------------- * Superfiles Many of the descriptions below rely on an underlying concept called "superfiles" which we have invented. A superfile is a file, or something that acts like a file, which can be an input, an output, or both. For instance, Anzio's PRINTFILE command can print a file: PRINTFILE somefile.txt But it can also reference a URI (URL) for a file stored on an HTTP server: PRINTFILE http://www.somesite.com/somefile.txt It can even refer to a scanner: PRINTFILE scan:// This will pop up the scanner interface, allow the user to select a scanner, and scan a document, then will print that document. Obviously we have taken the format of the URI and extended it. Like the URI, there can be optional parameters in the form ?vbl=value?vbl=value... (in some cases the "=value" is not needed). So here's another example: tif://myfile.tif?density=300?format=color Note that Anzio's COPY command, which normally copies one file to another, can refer to a file or a superfile as source and destination. This means you can > copy a file from an HTTP server to the local disk > copy from the scanner to the printer > copy from the scanner to a PDF > copy from the local disk to an FTP server > copy from an HTTPS server to the printer and much more. ------------------------------------------------------------------------------- * Printing to PDF AnzioWin has a built-in PDF generator, and can route any print job to PDF. New in this version, the user has easy control over many aspects of the PDF file to be generated. To configure PDF output, go to File:Printer Setup. Make sure Print Wizard is checked. Then, under Destination, choose "PDF file named". If the name slot is blank, AnzioWin will use a default file name. Or, put in the name of the file you want to create, including the ".PDF" extension. Or, this slot can contain the name and options. This is the equivalent of a superfile name without the "PDF://" at the front (see superfile description above). For an easy way to build this string, click the Setup button. A PDF Setup dialog will be presented, in which you can configure various aspects of how you want to create your PDF. The PDF filename can contain replacement parameters as described above. You can get to the same form programmatically by using the command PDFSETUP (that's all). ------------------------------------------------------------------------------- * Configuring Email AnzioWin now has emailing client software built in, which can send out emails using any of four methods. Most typically, this will be done with generated PDFs or TIFs. In order to use email, you must set up some information on how email should be sent. This is done one time. There is now a dialog box to do this, or it can be done only manually. Use the EMAILSETUP command. The format is EMAILSETUP =[ =...] where each specifies one variable to be set to the corresponding . Variables are: TYPE The type of email sending to do. Options are SMTP, CDO, MAPI, and OUTLOOK SERVER The name or IP address of the email server PORT The port number on the server USER The username for the server AUTH Set to ON or TRUE to do authentication to the server, otherwise OFF ot FALSE PASSWORD The password to use for authentication FROM The name of the sender that should appear in the emails FROMADDRESS The email address of the sender that should appear in the emails PROFILE The profile where required, such as for MAPI So for instance, here is a command to setup email: EMAILSETUP type=smtp server=nimbus.anzio.com user=ras password=fatchance "from=Bob Rasmussen" fromaddress=ras@anzio.com Or, just use the command EMAILSETUP (with no parameters). Anzio will present a dialog box asking for the necessary information. ------------------------------------------------------------------------------- * Printing to TIF AnzioWin's printing engine can "print" to a TIF file, which can be multiple pages. You have control over size, density, format (color, gray, black-and-white), etc. The user interface to TIF generation parallels that of PDF generation described above, including the ability to email the generated TIF. Note that the default format of TIFs generated by AnzioWin is so-called "class F", meaning it is easily faxable. In Windows, these files can be sent directly to the fax engine without conversion. ------------------------------------------------------------------------------- * Emailing Generated PDFs and TIFs When AnzioWin converts a print job into a PDF or TIF, it can then email the file to a particular address. This requires some initial setup to be done, using the EMAILSETUP command above. Then do PDF setup or TIF setup as in "Printing to PDF" above, and checkmark "Email the PDF" or "Email Tif". This will expand the dialog box to include an email section. Simply fill in the dialog box with the information on how the email should be generated. ------------------------------------------------------------------------------- * Printing to Fax, Fax Server AnzioWin's printing engine can "print" to a fax, directed to a certain fax number. You have control over subject, "from", cover page, etc. Faxing can be through Windows support on the same PC or on a PC acting as a fax server. This feature works with the fax support built into Windows version 2000 and later. We refer to this fax engine as "Fax32". Some initial setup must be done the first time you send or receive a fax on a particular PC. This is all handled by Windows. Go to File:Printer Setup, make sure Print Wizard is checkmarked, and select "Fax to number:". In the slot, you can enter at least a fax number for the recipient. There must be a fax number provided. The entry can, however, contain additional parameters, in the format ?=[?=...] to set each variable to a certain value. Note that some variables are relevant only if a cover page is used. Variables are: TO The name of the person to receive the fax SUBJECT The subject of the fax NOTE Some text to be included in the body of the cover page. Any pipe symbols ("|") in the note will be replaced by line breaks. FROMNAME The name of the person sending the fax FROMNUMBER The fax number of the person sending the fax COVERPAGE The name of the cover page file. If a file extension is not provided, ".COV" will be appended. If the no directory is specified, Anzio will look in the user's personal cover page directory (as specified by Windows), and if that fails, in the directory for cover pages for all users (as specified by Windows). SHOWDIALOG Causes AnzioWin to prompt the user for this information whenever a fax is generated. You can click the "Setup" box next to the fax number slot to prompt for all of these fields and build your destination string for you. If you wish to use a fax server, such as that available on Windows 2003, you must tell Anzio the name of the server. Manually edit your settings file, and set the variable fax-server (in the [Printwiz] section), to the name of the server. ------------------------------------------------------------------------------- * Programming Printer Setup If you wish to programmatically change printing parameters, so you don't rely on the user to send things to the right place. But there are many settings that affect printing. Fortunately, there is way to learn the Anzio commands that are necessary to configure print output, as follows: 1. Go to the Macros menu and click "Record". 2. In the File menu, click Printer Setup. 3. Do all the necessary changes to set the printing how you want it. 4. Go back to Macros, and click Record again to stop recording. 5. You will be prompted for a keystroke to assign the macro to. Hit a keystroke that you don't ordinarily use, such as alt-F12. You have now created an alt-F12 macro that sets up the printing. 6. Go to Macros, hit Edit, and hit your keystroke (alt-F12). The macro you recordeded will be displayed. You can see the syntax of every command that is part of the setup. 7. You can now use this macro to configure the printing parameters in this way. For instance, just hit alt-F12. 8. If you are programming a host system, and you wish to send commands from the host to configure Anzio for printing like this, use each command line that shows in the Macro Edit and build that command into a host command, as explained in the manual. ------------------------------------------------------------------------------- * Gesture Recognition on Tablet PC & Vista AnzioWin can take advantage of the gesture recognition capability of the Tablet PC, which has now been extended into some versions of Vista. When enabled on the main Anzio window, certain penstrokes will be recognized and translated into keystrokes to be sent to the server. This can work with in conjunction with other pen functions or alone. Gesture recognition can be turned on and off by right-clicking in the main window to bring up the popup menu, and selecting "Recognize gestures". If this item is grayed, your system does not support gesture recognition. The following gestures are recognized: Gesture Action ---------------- ------------------------------- ChevronUp key ChevronDown key ChevronLeft key ChevronRight key ArrowUp key ArrowDown key DownRightLong key Right key Left key UpRightLong key DownLeftLong key RightLeft CLIP function (copy to clipboard) DoubleCurlicue CLIP function (copy to clipboard) DoubleCirlce PASTE function (paste from clipboard) LeftRight key UpLeft key For pictures of these gestures, see http://msdn2.microsoft.com/en-us/library/ms697513.aspx To debug what is happening with gesture recognition, see the DEBUGKEYS command described herein. ------------------------------------------------------------------------------- * Handwriting Input on Tablet PC & Vista Anzio ties into the Tablet PC's (and now Vista's) ability to convert handwriting with the stylus on the screen into text input. Just right-click on the main window, and checkmark "Allow handwriting" (if it is grayed, your system does not support pen input). Then, when you use the stylus near your screen, a small icon button will appear. Click that button to get the pen input popup. Use it as per Windows instructions. ------------------------------------------------------------------------------- * Markup and Shape Recognition on Tablet PC & Vista Anzio has had the ability to mark up (draw with a mouse or stylus) both the Print Preview window and the main screen. On the main screen, this could be used to add some notes, circles, arrows, etc. Then you can print the screen. Or you can copy this screen into the clipboard, and paste it into an email for tech support, or into your own user manual for the application Anzio is talking to. On the main screen, we have now added the ability to do shape recognition. When this is turned on, and you draw something that looks like a circle, Anzio will convert it to a perfect circle. To turn this on, right-click on the main window, and select "Allow ink markup". Then right-click again and select "Recognize shapes". Note that some shapes are recognized only if "Recognize gestures" is also on. Shapes that are recognized include: + square + circle or ellipse + rectangle + corner + chevron + horizontal or vertical line + diagonal line + straight segments of a multi-segment figure In general, if a segment is not straight enough, or otherwise not recognized, it will remain on the screen as a freehand segment. Recognized shapes will in many cases auto-connect to nearby ends, corners, and cusps. Shape recognition has not yet been applied to the Print Preview window. ------------------------------------------------------------------------------- * New passthru.c A new version (2.0) of the passthru.c program is available. This program does passthrough printing from a Unix/Linux host through Anzio. Changes in this version include: + The command line can now specify one or more files to be printed. (Previously, passthru accepted only piped input). + A parameter "-" says to send stdin as a print job. + Environment variables SLAVEON and SLAVEOFF can define printer on/off codes, overriding everything else. Encode Escape character as "\E". + Parameter "-f" will now cause Anzio to save its flushtimer setting, set that to zero, print the file, flush the job, then restore the flushtimer. Requires Anzio 15.3 or later. + Properly handle termname = C332, even if not in terminfo. + Parameter "-n" will send each input file name to Anzio with a PRINTDOCNAME command. + Parameter "-q" will make the program run in quiet mode, with no error messages. + Parameter "-s" will send to Anzio using secondary passthrough print. + Parameter "-i " will send the to Anzio before each print job. This command can initialize some settings in Anzio. + Parameter "-z " will send the to Anzio after each print job. This command can accomplish a store-and-forward effect. If you need this program, please let us know on what Unix/Linux you want to run it. ------------------------------------------------------------------------------- * Scanner Superfile Name Scanner support has been greatly improved. You can scan multiple-page documents as one entity, manage 2-sided scanning, and more. You can use an Anzio command to control scanning parameters, such as density and format (color, gray, B&W) without presenting the scanner's user interface. The scanner is always referenced with a superfile name starting with "SCAN://". Specifically, the syntax is SCAN://[][?=[?=...]] If is not provide, the default scanner will be used. The series of = pairs, separated by question marks, set several variables for the scan to appropiate values. Variables are: FORMAT Set to MONO (for black and white), GRAY, or COLOR RESOLUTION Set the scan density, in dots per inch TOP Set the distance from the top of page to the top of the area to be scanned, in inches LEFT Set the distance from the left edge of the page to the left edge of the area to be scanned, in inches BOTTOM Top of page to bottom of scan area, in inches RIGHT Left of page to right of scan area, in inches PAGES The number of pages to be scanned FEEDER Set to TRUE or FALSE, indicating if auto document feeder (ADF) should be used DUPLEX Set to OFF for one-sided scanning. Set to AUTO for automatic 2-sided scanning on a scanner that can do that. Set to MANUAL to have the user scan all of one side, then all of the other side. Set to REVERSE it MANUAL puts the pages in the wrong order SHOW Set to TRUE or FALSE to specify whether the scanner driver's user interface should show Note that most of these settings will have an effect (on most scanners) ONLY if SHOW is set to FALSE. That is how you accomplish programmatic scanning, minimizing operator intervention. To get started with this syntax, record a macro that does a scan. For instance, begin recording a macro, do the command COPY SCAN:// WPRN then stop recording and specify a key to attach the macro to. Go to Macros:Edit and pull up the macro you have just defined. Change the "show=true" to "show=false". Now you have a macro that should do the same scan operation. ------------------------------------------------------------------------------- * Scanner Operation As described above, a scanner is treated as an input file with a name starting with "SCAN://", and possibly other parameters after it. As an input file, it can be used almost any place an input file can be used. A scanner input is one or more images. Usually multiple images are derived from multiple pages, but it is also possible to pull multiple images from one page. Inside AnzioWin, though, multiple images are treated as a multi-page document. In the operations below, where it makes sense to think about only one image, only the first image (page) of a multiple-image scan will be used. Following are some Anzio commands that use the scanner as input. Generally, where "SCAN://" is shown, additional variable options would be supported as well. PRINTFILE SCAN:// Scans a document and prints it, on the currently selected printer destination. COPY SCAN:// WPRN Same as PRINTFILE SCAN:// COPY SCAN:// filename.bmp Scans a document, saves it with the indicated filename COPY SCAN:// filename.tif Scans a document, converts it to a TIF (because of the file extension) and saves it to the name given. COPY SCAN:// TIF://test.tif?view Scans to a TIF, then views it in Windows' designated TIF viewer SFTPPUT filename.BMP scan:// Scans a document, sends it via SFTP to the server, stores it as "filename.BMP" SFTPPUT filename.TIF scan:// Scans a document, converts it to a TIF (because of the file extension) and sends it via SFTP to the server as "filename.TIF" FTPPUT filename.TIF scan:// Scans a document, stores it as a TIF on the server COPY SCAN:// FAX32://503-555-1234 Scans a document, faxes it to the number given COPY SCAN:// PDF://myscan.pdf Scans a document, "prints" it to a PDF COPY SCAN:// PDF://myscan.pdf?email=joe@somesite.com Scans a document, converts it to a PDF, emails it to Joe BMP SCAN:// Scans a document, uses it as a screen background bitmap (other variations could place it on only one part of the screen) IMAGEBOX SCAN:// CELL FLOAT 41 5 80 20 Scans a document, displays it in a floating window in the indicated cell location In a Print Wizard print job, a SCAN:// could be specified as an OVERLAY. Also, a scan could be used as an IMG (image), to be placed at a certain place on the page. In these cases, the scanning operation would take place at the time the print engine encountered that name. If there are multiple IMG takes referencing SCAN://, multiple scanning operations would take place, in the order they were encountered in the print job. You would not want to do a Print Preview in this case. ------------------------------------------------------------------------------- * Printing Fullpage Images Anzio can print fullpage images, from files with extensions: .bmp .gif .tif or .tiff .jpg or .jpeg .pcx .dcx .png .pdf (image format) and also scanner input ("scan://"). These will be printed as large as possible on the page, with automatic orientation. This can be done with the PRINTFILE command. In TIF and PDF files, and scans, this can be a multiple-page job. ------------------------------------------------------------------------------- * Image Conversion During certain COPY commands, Anzio will detect from the file extensions that a graphics format conversion should be done, and will do it automatically. (More to come) ------------------------------------------------------------------------------- * Running Anzio with an Initial Command The command line that starts Anzio can specify an initial command, with: /I This command will be sent to the server once the authentication process is completed. This allows a command done in Windows to launch Anzio and run a particular command on the server. The command consists of all the characters after the "I", up to a space. Note that an is NOT assumed. If you want one, use "|". If you have a "|" and/or embedded spaces, put the whole parameter in quotes. For instance, the command line: anzio32 "/Ils -l|" will start AnzioWin, and after login is accomplished, it will send "ls -l" followed by . ------------------------------------------------------------------------------- * Multiple Backchannel Printing It is now possible, in an SSH connection, to open multiple printing sessions. This means a program running on the host can output to several printers on the (or visible from) the PC, with encryption as provided by SSH. Each printer channel can address the same or different printers, with differing printing characteristics. (More to come) ------------------------------------------------------------------------------- * Backchannel Serial Devices It is now possible, in an SSH connection, to open multiple serial device sessions. Each one can control one serial port on the PC, which can be connected to various devices such as PIN pads, pole displays, truck scales, mag-stripe readers, etc. (More to come) ------------------------------------------------------------------------------- * Local Port Forwarding This version of AnzioWin introduces local port forwarding under SSH. This means that, once an SSH session is opened to the server, a local (on the PC) TCP/IP port can be forwarded to a TCP/IP port on the server, or on another machine reachable from the server. There is no user interface for this yet. To turn on forwarding overall, edit the settings file to change ssh-forward to "1". To add a forward, use the command SSHPORT-ADD You can add multiple forwards. Forwarding configuration is, of course, stored in the settings file. To remove forwards (for now), edit the settings file. Note that AnzioWin creates a "static" forward. AnzioWin does NOT act as a SOCKS proxy server, as some other SSH clients do. (More to come) ------------------------------------------------------------------------------- * Keyboard-interactive SSH Authentication Previously, Anzio has supported SSH authentication using the password method or the public/private key pair method. With this version, we support authentication using "keyboard-interactive", which is used (even required) on some server systems. Operation should be automatic and obvious. ------------------------------------------------------------------------------- * The DEBUGKEYS Diagnostic If you are having trouble with keyboard input, mouse events, etc., you can go to Diagnose:Debug keys, or can use the command DEBUGKEYS to open a debug window. This will show you a wide variety of information on the input events that Anzio receives, while still allowing normal operation of Anzio. Just drag the window out of your way. Debug information includes: > conditions at startup including ANSI and ISO codepages, keyboard language, locale, etc. > keystrokes received > Tablet PC gestures recognized and converted to keystrokes > dead keys entered, dead keys processed > numeric Unicode characters entered > extended mouse buttons (4 and 5) clicked > mouse horizontal wheel events > changes of video resolution or screensize > characters received from Input Method Editor (for Far East) > changes to keyboard input language > menu and system keystrokes > commands sent from extended keyboards (appcommands) ------------------------------------------------------------------------------- * Using Cleartype Font Smoothing Anzio now works with Windows' Cleartype font smoothing mechanism, which makes text appear smoother especially on LCD screens. To enable, go to Edit:Advanced options:Screen, and check "ClearType font smoothing". Microsofts's web site explains how Cleartype works, and has a setup wizard you can use to tune your Cleartype display. Note that Cleartype's operation is dependent on the order of color dots on your screen, in a horizontal direction. However, this changes (for the worse) if you rotate the screen to a portrait orientation. Anzio is smart enough to turn Cleartype OFF when the screen is rotated to portrait, and back ON when rotated to landscape. ------------------------------------------------------------------------------- * Transferring Multiple Files in FTP & SFTP In the FTP and SFTP dialog boxes, it is now possible to select multiple files and transfer them at once. This is more efficient as well as easier for the operator. Also, the Anzio commands to do these transfers, FTPGET, FTPPUT, SFTPGET, and SFTPPUT now allow multiple files to be specified. In the interactive FTP/SFTP window, hold or while making multiple selections. Then click the transfer button. For programmed transfers, use a comma-separated list of files or wildcard entries. ------------------------------------------------------------------------------- * Using the APPDATA Directory Anzio now has some support for storing and reading files, notably the settings file (anziowin.def) from the user's application data directory, which is equivalent to the environment variable APPDATA. (More to come) ------------------------------------------------------------------------------- * The Image Window A new IMAGEBOX command allows Anzio to open and control a separate window to display an image, which can be loaded from a variety of places. This can be the foundation of an image-enabled application. The format of the command is IMAGEBOX [CELL | SCREEN] [FLOAT] [] The parameters define the left, top, right, and bottom of the rectangle in which the image will appear. By default, these are in pixels, relative to the top left corner of the client area of AnzioWin, below the toolbar if displayed. If CELL is stated, they are in units of character cells, where "1" is the top (left) character position. If SCREEN is stated, they are in units of pixels relative to the top left edge of the video screen (desktop). If FLOAT is stated, the image window is made moveable and sizeable, by wrapping it with a suitable Windows frame, while keeping the client area in the same place. It is possible to specify a negative , etc. The available include: REFRESH= Causes AnzioWin to reload the image by rereading every seconds (which can have decimals). This can reread a file written by a web camera, for instance. ASPECT=FIXED | VARIABLE Specifies whether the aspect ratio of the image is maintained (fixed), which is the default. VARIABLE allows the user to distort the image. PAGE= Specifies which page of a multi-page file will be shown in the window. Note that, as with most filenames in Anzio, this one can be a superfile name. You can, for instance, specify a file from an HTTP or FTP source. Or, you can specify "SCAN://" to tell Anzio to scan an image and display it. To close the image window, do just IMAGEBOX One image box at a time can be open in AnzioWin. Opening a new one will close the old one. ------------------------------------------------------------------------------- * The Movie Window The PLAYMEDIA command has been able to play movies (videos) on the Anzio screen. Now, with additional parameters on this command, you can specify that the movie be played in a separate, floating window. There are other enhancements to this feature as well. You might want to use a video window to run a training video, for instance, all controlled by Anzio. The syntax of the PLAYMEDIA command is identical to that of IMAGEBOX above, although the are different. In this case, the are those allowed by Windows' command "mciSendString play" when referencing a digitalvideo device. The most likely option is "repeat". If you have an extended keyboard with media control keys "stop", "play", "pause", and/or "play/pause", these will affect the video playback (unless disabled in Advanced Options). ------------------------------------------------------------------------------- * New Mouse Events It is now possible to assign actions to additional mouse events, including: > mouse button 4 > mouse button 5 > mouse horizontal wheel tilt Also, wheel events can now invoke macros. Note that if your PC has mouse management software, that software may capture these events and not pass them through to Anzio. In that case you would need to reconfigure that software. Also, some events may require Vista. To configure these events, go to Edit:Advanced options:Mouse. ------------------------------------------------------------------------------- * Test Print In the Print Preview window, there is a new button labelled "Test Print". This will print the first page only of the current print job, allowing you to check for margins, alignment, etc. If it is not right, you can then readjust the margins in the Print Preview window. ------------------------------------------------------------------------------- * Telephone Control Anzio has a number of commands for controlling and reacting to telephone devices, such as might be used in a call center. These were added in version 15.2f, so you might not be aware of them. These operations will be done using the first (or only) modem installed in Windows, or you can specify which modem to use by editing the settings file's voice-modem entry, in the [Comm] section. This string can be a wildcard, such as "winm*". To dial an outgoing call, do DIALCALL where is in canonical format as "+ () " Include the quotes. If an existing call is in progress, it will be terminated. To terminate a call, use the command DROPCALL To dial additional digits, if the DIALCALL's number ended in ";", do CALLDIGITS AnzioWin can also react to incoming calls. Use the following commands: EVENT ONDIALIN The indicated macro will be triggered when the modem detects a ring. EVENT ONCALLERID ) characters. This provides a quick way of editing many common data entry errors. ------------------------------------------------------------------------------- Things You Might Have Missed Finally, here are a few things from more recent versions of AnzioWin that you might have missed. Some are in the manual, and others are described only in the file "readme.txt" that comes with the full Anzio install. TAKEFOCUS command KILL of process started with WINSTART or WINPRINT EVENT ONIDLE EVENT ONHOSTPRINT EVENT ONCONNECT EVENT ONLOGIN EVENT ONWAKEUP EVENT ONBEEP EVENT ONQUIT INTERACTIVE-PRINT Decimal-is-period =============================================================================== CHANGE HISTORY Following is a list of changes in version 16, at a very low level. Items with "..." will be expanded upon soon. * 1. PRINTWIZ: a) Bugs fixed in handling ambiguous-width Unicode characters. b) Linecount used for REPLACE operations and pagefeed testing is more accurate. c) ... d) REPLACE can replace with nothing... e) REPLACE can find \r, \n, etc... f) PXL translation... ... 2. Bugs fixed in gesture recognition (TabletPC, Vista). 3. TabletPC/Vista: bugs fixed in ink when toolbar is displayed. 4. Warning about F-key will be presented only if sending device is the keyboard (not mouse, tablet, etc.). 5. Inking with mouse doesn't cause highlighting also. 6. FLUSHTIMER command can take environment variables. 7. Restore ability to have parentheses in command line parameters. 8. Variables added: ANZ_APPDATA Usually c:\Documents and Settings\\Application Data ANZ_COMMON_APPDATA Usually C:\Documents and Settings\All Users\Application Data 9. Give message on failure to register as telnet or SSH handler. 10. Allow quotes in command CHOOSEPRINTER "DEFAULT" 11. Allow UTF-8, variable substitution in CHOOSEPRINTER command. 12. New command (AnzioWin only): SETCOOKIE Sets an Internet cookie 13. New option on GetCookie/s (AnzioWin only): GETCOOKIE will return the associated with 14. Bug fixed re. empty passthrough print segments causing multiple printer-setup screens. 15. New command: FLASH Causes Anzio's entry on the task bar (bottom of screen) to flash, indicating Anzio needs attention. 16. New command: CHOOSEPRINTER/S Returns to host the Windows name of the currently selected printer, or "DEFAULT" if none is established yet. 17. New command: SHOW-COMMAND [ON] | OFF | TOGGLE If ON, commands from the host, command in macros, and their responses sent back to the host will be shown on the screen. This was previously governed by "RECEIVE QUIET". 18. New commands: SAVEPARAM RESTOREPARAM 19. In a command string from the host, allow multiple commands, separated by hex-1C (octal-034). So for instance, from the Unix command line: printf "\034first command\034second command\035" 20. New passthru.c program ... 21. GETPARAM/S, SAVEPARAM can now take a section name, such as "[print]" * 22. Can now do PRINTFILE of .TIF, .TIFF files. 23. Can now have TIF files as background bitmaps. 24. Can now do COPY SCAN:// TIF:// 25. Bug fixed that caused faults when accessing certain scanners. 26. COPY with image format conversion... * 27. FTPPUT, SFTPPUT of SCAN:// with image format conversion... * 28. New command line parameter: /I After authentication, the characters in will be sent. A pipe symbol, "|", will be converted to an . No is assumed. Generally, put the whole parameter in quotes, such as: "/Ils -l|" 29. New command variations: CLONE [/nosave] [] The "/nosave" option tells Anzio not to save the settings, even if they have changed. The will be sent to the new Anzio as in the "/I" command above; that is, as a command to run after authentication. 30. The END command now has options: END [/NOSAVE] [] If /NOSAVE is given, will not prompt to save keys or settings. Will simply quit. A numeric will be returned to the calling program (default is zero). 31. Raw print filenames can contain date elements... * 32. From the "Do you wish to save parameters" dialog, you can now click "What changed" and see the names of all parameters that have changed. 33. Backchannel printing changes: a) The command to send to the host gets its variables expanded. So you can do, for instance rm anzp${anz_computername}.${anz_process_id} 2> /dev/null; ln -s `tty` anzp${anz_computername}.${anz_process_id}; cat b) Allow commands SLAVE, TTY... 34. Added superfile type print:// ... 35. Bug fixed in deadkey combined with numeric entry. * 36. Report more information in DEBUGKEYS dialog. 37. Bugs fixed in window sizing. * 38. FAX32:// parameters... 39. Smooth (antialiased) fonts, such as ClearType. Turn on in Edit:Advanced Options:Screen. ClearType will be turned off if the screen is rotated. 40. PIPE://... 41. Other graphics files supported: DCX, PCX, PNG. * 42. Playmedia movie window... (& keyboard control) 43. Multiple file selection in FTP/SFTP. In interactive mode, select multiple files with or . In transfer commands, use a comma-separated list of files or wildcards. * 44. SSH local port forwarding... 45. Allow screen width to go less than 80, such as for ultra portable devices. * 46. Email of PDFs... 47. PDFSETUP command... 48. EMAILSETUP command, to specify permanent email parameters. Format is: EMAILSETUP =[ =...] where each specifies one variable to be set to the corresponding . Variables are: TYPE The type of email sending to do. Options are SMTP, CDO, MAPI, and OUTLOOK SERVER The name or IP address of the email server PORT The port number on the server USER The username for the server AUTH Set to ON or TRUE to do authentication to the server, otherwise OFF ot FALSE PASSWORD The password to use for authentication FROM The name of the sender that should appear in the emails FROMADDRESS The email address of the sender that should appear in the emails PROFILE The profile where required, such as for MAPI 49. Changes in logic for finding the settings (.DEF) file: a) No longer look in parent of working directory b) If not found, assume user's APPDATA c) Search sequence is now: CWD APPDATA\AnzioWin or APPDATA\Anzio Lite COMMON_APPDATA\AnzioWin or APPDATA\Anzio Lite Program directory 50. When changing terminal type through menu, if needed keys file is the same, don't prompt to reload it. 51. Changes in FTP/SFTP dialog a) Invalid popup menu items are grayed, not removed. b) Local side hint will show what are special folders. c) Bugs fixed re. hidden directories. 52. STAYALIVE now defaults to 60 seconds. 53. Setting FLUSHTIMER to -1 causes immediate flush of print data. 54. Make FONT LARGER, FONT SMALLER work better, especially with Consolas font. 55. Make WINDOW ROTATE work on multiple-monitor systems. The monitor that Anzio is (mostly) on will be rotated. 56. Support faxing (via Fax32) through a fax server. 57. Include bitmap characters for Unicode values: 2610 Empty checkbox 2611 Checkmark in checkbox 2612 X in checkbox (Used if characters aren't found in any font) * 58. SSHPORT-ADD... * 59. IMAGEBOX... * 60. SSHAUX-ADD... 61. New highlighting keys ctrl-shift-left : highlight word left ctrl-shift-right : highlight word right 62. Bug fixed in C332 for CUSA. 63. New mouse events (some dependent on Vista): Button 4, Button 5, and horizontal wheel (left and right). Set up in Advanced Options. Also, wheel can now initiate macros. 64. Test Print... 65. Shapes... 66. TIFSETUP... 67. PRINTDOCNAME... Changes in beta 2: 68. Show DCX, PCX, PNG in overlay selection window. 69. Ignore PNG warnings. 70. Track and use preferred scanner name. 71. New item in Diagnose menu: Debug keystrokes (does command DEBUGKEYS). 72. New item in ink popup menu on main window (when ink is enabled): Recognize shapes Enables shape recognition. Certain drawing strokes are recognized and cleaned up. Some shapes (square, circle) will not be recognized unless gesture recognition is on also. 73. Add user interface for mouse buttons 4 and 5, horizontal (tilt) wheel. See Edit:Advanced options:Mouse. May require Vista. 74. Mouse wheel actions can invoke macros. 75. User control over ClearType font, in Edit:Advanced Options:Screen. 76. Font smoothing now defaults to on (ClearType). 77. Bug fixed in View checkboxes for PDFs, TIFs, in Printer Setup. 78. Provide more room in About box for long pathnames. 79. Variables added: ANZ_USERDATA Usually c:\Documents and Settings\\Application Data\ ANZ_COMMON_USERDATA Usually C:\Documents and Settings\All Users\Application Data\ where is "AnzioWin" or "Anzio Lite" 80. Don't offer to read keys file it it isn't there. * 81. Smart keystroke: delete word left. Counts characters to start of word, to the left from the cursor, and sends that many backspace characters. Changes in beta 3: 82. Bug fixed in control of font smoothing. 83. SSH: handle case where keyboard-interactive authentication gives us an instruction but no prompt. * 84. New command: FILEINFO/S returns to the host an ASCII string containing information on the file. If is a wildcard, it returns info on the first one it finds that matches the wildcard. If no file is found, returns "\\". Info is four fields, separated by commas, representing: a) file size, in decimal b) attribute flags, as defined by DOS c) last change time, in local time zone, as yyyymmddhhmmss d) last change time, in UTC time, same format 85. New command DIR-TERMINATOR Specifies the indicator string to send when DIR/S, FINDFIRST/S, or FILEINFO/S fails or terminates. Defaults to "\\". * 86. New command: FILE-CLEANUP Searches for files meeting the , that are at least old, and deletes them. Can be used to clean up downloaded files, for instance. USE WITH CAUTION. * 87. New command: SFTPREGET [] This uses SFTP to "re-get" a file. If the file already exists on the PC, and it has a date/time the same as or late than that on the host, the transfer will NOT happen. So the transfer happens only if the host has a newer file. Changes in beta 4: 88. Improvements in SSH keyboard-interactive prompt dialog. 89. Bugs fixed in printing PNG, DCX, PCX. 90. Enhancement to IMAGEBOX: a) can now contain page= 91. Included option for faxsetup as command and added new dialog to match fax32:// options. 92. Internationalized pdfsetup form. 93. Internationalized faxsetup form. 94. Made faxsetup dialog show if flag is set before a print job is faxed. 95. Added faxsetup button to printer setup dialog. * 96. Can now display and print certain PDF files, namely those containing only images of the page, as might be produced from a scanner. File can not be password protected. Changes in beta 5: 97. Misc. things in fax setup. 98. Bugs fixed in saving SSH local forwarding parameters. 99. SSHPORT-ADD requires that "portforward" be on. Set this in settings file. Changes in beta 6: 100. Bug fixed in setting TIF:// options. 101. Bug fixed in printing SPL to PDF. 102. FTP/SFTP: display hourglass cursor while updating host treeview. 103. FLASH command now can take an argument: FLASH [] indicates number of times to flash. Default is 3. *104. Print-to-TIF can now be emailed. 105. Misc. fixes to TIF and fax output. Changes in beta 7: 106. The command PRINTFILE [/U | /I | /O] (with no filename given) will open a standard dialog box to prompt the user for a file to print. *107. New menu item in File menu: Print a File... presents user a standard dialog box to choose a file to print. Handles many kinds of files. Changes in beta 8: 108. Advanced Options, Keys now has "show commands" checkbox. 109. SSH Keyboard-interactive: don't show empty dialog box. 110. Emailing failures now report back an error string into Debug Printing dialog. *111. PDF and TIF filenames can now contain replacement parameters... Changes in beta 9: 112. When recording a macro, and you do PRINTFILE, FAXSETUP, TIFSETUP, or PDFSETUP, make recorded macro show the results of settings in the dialog box. Changes in beta 10: 113. Bug fixed in tracking preferred printing resolution. 114. Pass along document name to printer driver, such as in PRINTFILE. *115. Added "View an Image File" to the File menu. Prompts for a file to load, then feeds into new IMAGEBOX function. 116. Bugs fixed in PDF output of unfilled rectangles. 117. Improvements on PCL pattern and gray brushes. 118. Allow cancel from popup PDF, TIF, or FAX setup. 119. When recognizing ink shapes, auto-connect lines. 120. SSH: don't retry a connection if server closes the socket. Changes in beta 11: 121. SSH: Anzio's ENVIRONMENT is sent to server for backchannels, also. 122. Note on OpenSSH: the configuration file, sshd_config, can indicate which environment variables the client can pass to the server. We suggest using: ACCEPTENV=ANZ* 123. Improvements in SSH AUX support. 124. Note: Emailing via SMTP allows multiple recipients, separated by commas. Other email methods do not allow multiple recipients. 125. Do early verification that attachments exist. 126. Printer Setup will not require a fax number when fax output is selected. In the absence of a fax number, the user will be asked for one later in the print process. *127. Command EMAILSETUP (with no parameters) will bring up an email configuration dialog box. 128. In Communication Settings, under "serial", show only ports that are installed in Windows, and are not attached to a modem. 129. Get docname into fax32. Changes in beta 12: *130. Added menu item in Edit menu: Setup Email. 131. Bugs fixed in docname for print-screen. 132. Grand Abort (alt-A) aborts a SPEAK operation in progress. 133. New command variation: RECORD TOGGLE switches macro recording on/off. 134. New command: SENDFILE [] Sends a file according to the default protocol. Gets translated to ZSEND [] for instance. *135. Toolbar enhancements: a) Toolbar can now store command text, not just macro names (old settings files that referenced macros are converted). b) Toolbar is now ON, by default. c) Toolbar has several default buttons. d) In Toolbar Setup (from View:Configure toolbar), there is now a "Default" item that loads the dialog with the default values. Changes in beta 13: 136. Translate PCL now defaults to ON (main file and overlay). 137. If user runs the CONNECT command, and a connection is already in place, and "disable quit" is set or File:Exit is not available, don't allow. 138. Bug fixed in scrolling screen with toolbar and background bitmap. 139. Bug fixed in high-level, non-wizard, text. 140. In Debug Printing, eliminate redundant messages. 141. DIROUT/S... *142. File:Scan submenu, with "Scan and Print", "Scan and Save", "Scan and Send"... 143. After using the CALC function, status line will reset after 5 seconds. 144. Command DIALCALL with no parameters will pick up screen highlight. 145. New command: SENDFILE ... 146. More items on toolbar. 147. ANZ_VERSION... 148. New "mailto" command (see below) for funcs2... New MAILTO command with the following parameters to=<> cc=<> bcc=<> subject=<> notes=<> attach=<> show=true/false from=<> fromaddress=<> Examples: MAILTO "to=\"my name\" " "subject=my subject" "notes=my note|line 2|line 3" When sending multiple emails for To, From, CC, BCC direct to various methods CDO: Multiple emails should be separated by commas and names in quotes. Examples: bee@abc.com "Bobby Ezell" "Bobby Ezell" , bobby.ezell@xyz.com, MAPI/Outlook: Multiple emails should be seperated by semi-colons (same CDO rules) SMTP: Multiple emails should be separated by commas (same CDO rules) MAPI: This is not working yet... When will form popup? There is an "email send" form (from Print Wizard, that will pop-up when a) there is no parameters, just "mailto" b) when there is no "to" c) if you include the "show=true" parameter. 149. Menu item: File:Scan:Scan and View Changes to beta 15 150. "Move up", "move down" arrows in toolbar configuration. 151. RESTART command... 152. File:Import settings file... 153. Language setup on startup... Changes in beta 16 154. Bug fixed in language setup. *155. Features added into Lite (previously only in AnzioWin): a) Change logged directory menu, CD & LOG commands b) PLAYSOUND from host (requires WinInet) c) PRINTER-SETUP command d) Background bitmap, BMP* commands e) Toolbar setup f) KILL g) MKDIR/S h) COPY (file to file) i) FIND/S, FINDNEXT/S j) TIME/S, DATE/S k) WIDTH l) RENAME m) CALC n) MERGE o) Monitor menu item p) CLONE q) SCREENMODE/S r) Cursor line & position in Gauge =============================================================================== end of file