Using DOCIMGPRT to Print Images with Text Annotation Overlays
From Support
Contents |
Overview
Listed below are instructions for printing text annotation overlays on top of an image when printing a document with the RJS Document Imaging Viewer.
The DOCIMGPRT command can now be passed annotation text and optional coordinates on where to print the annotation text. You can also set a default annotation location setting for each document type by editing a document type definition from the RJSIMAGE menu. If entered in the document type, the document type settings will automatically select the coordinates to use for annotation overlay printing from the document type record.
We would suggest testing the DOCIMGPRT command with a TIF image that has been scanned or uploaded into WebDocs - iSeries Edition. You can do this by logging into WebDocs and viewing the document details for an existing document to determine the document ID. Then from the AS/400 command line you can run the DOCIMGPRT command with library RJSIMAGE in your library list.
The iSeries Office Integrator must also be installed on your PC as well as the RJS Document Imaging Viewer.
Software Requirements
iSeries Software
- WebDocs - iSeries Edition (RJSIMAGE) Version 1.77 or above.
- iSeries Office Integrator (RJSOFFICE) Version 1.19 or above.
PC Software on Target Workstation
- RJS Document Imaging Viewer V1.0.45 or above. (VB 5 Runtime Files) (Base Install) (Update to Base Install)
- iSeries Office Integrator PC Component Version 1.1.54 or above.
Printing Text Overlays with the DOCIMGPRT Command
When printing an image document from the iSeries via WebDocs, the DOCIMGPRT command is used.
When printing annotation text overlay, the ANNLEFT - ANNFONTSIZ parameters can be used.
Note: If not passed, the document type table for the selected document ID will check to see if coordinates were set at the document type level.
Document type settings for annotation positioning can be set via the "Edit Document Type" program from the RJSIMAGE menu.
The following settings can be stored at the document type level:
Annotation Left Position
Annotation Top Position
Annotation Height/BottomPosition
Annotation Width
Annotation Font Size
Override Field - This is a custom text field where customers can store their own special settings if they have custom settings they want to store with the document type. it is a freeform text field and is not used by any RJS code.
Getting the right printer name to use in the DOCIMGPRT command The printer name specified in the PRTDRIVER parameter must match exactly a printer on the PC where Office Integrator and the Document Image Viewer are running. One way to do this is to open an image in the Document Image Viewer and then take the Print option of the File menu.
In the Print dialog you see next, select a printer. Highlight the name and copy it to the clipboard. Then paste it into the PRTDRIVER parameter of the DOCIMGPRT command. Here is an example that uses a printer on a network printer share.
Note: The name must be an exact match, including case.
Note: Some Windows applications use a different syntax for the printer name. E.g., the name shown here is also referred to as
DUPLEX - HP LaserJet 2200 Series PCL 6 on MULTIMEDIA
in Notepad and in the list of printers in Control Panel. This form of the name will NOT work.
Examples of using DOCIMGPRT for printing annotations
DOCIMGPRT RMTSYS(*CURRENT) DOCID('AS400DOC-0000000001') PRTDRIVER(WIN2PDF) STARTPAGE(1) ENDPAGE(999999) ORIENT(1) AUTOROTATE(1) AUTOCENTER(1) DUPLEX(1) PAPERWIDTH(8.5) PAPERHEIGH(11) TOPBOTMGN1(.25) LFTRGTMGN1(.25) TOPBOTMGN2(.25) LFTRGTMGN2(.25) CRLEFT('0') CRTOP('0') CRWIDTH('0') CRHEIGHT('0') DSPMSGONPC(0) DELETEDOC(1) VERSION(*LAST) USR(USER) ANNLEFT(0) ANNTOP(0) ANNWID(0) ANNHGT(0)
ANNFONTSIZ(0) ANNTEXT('This is a test line')
Some Image Printing Sample Coordinates for Various Image Resolutions
Inbound or Outbound Fax - 8.5 x 11 Portrait (Resolution 204 x 196 Pixels Per Inch) (1735 pixels(X-Width) x 2156 pixels (Y-Height))
Print Annotation at Top of Page Example parms to print at top of page: Left:0, Top:0, Width/Right: 1735, Height/Bottom:100, Font size: 15
Print Annotation at Bottom of Page Example parms to print at top of page: Left:0, Top:2106, Width/Right: 1735, Height/Bottom:2156, Font size: 15
Inbound or Outbound Fax - 11 x 8.5 Landscape (Resolution 196 x 204 Pixels Per Inch) (2156 pixels(X-Width) x 1735 pixels (Y-Height))
Print Annotation at Top of Page Example parms to print at top of page: Left:0, Top:0, Width/Right: 2156, Height/Bottom:100, Font size: 15)
Print Annotation at Bottom of Page Example parms to print at top of page: Left:0, Top:1655, Width/Right: 2156, Height/Bottom:1735, Font size: 15)
200 x 200 Image Document - 8.5 x 11 Portrait (Resolution 200 x 200 Pixels Per Inch) (1700 pixels(X-Width) x 2200 pixels (Y-Height))
Print Annotation at Top of Page Example parms to print at top of page: Left:0, Top:0, Width/Right: 1700, Height/Bottom:100, Font size: 15)
Print Annotation at Bottom of Page Example parms to print at top of page: Left:0, Top:2100, Width/Right: 1700, Height/Bottom:2200, Font size: 15)
200 x 200 Image Document - 11 x 8.5 Landscape (Resolution 200 x 200 Pixels Per Inch) (2200 pixels(X-Width) x 1700 pixels (Y-Height))
Print Annotation at Top of Page Example parms to print at top of page: Left:0, Top:0, Width/Right: 2200, Height/Bottom:100, Font size: 15)
Print Annotation at Bottom of Page Example parms to print at top of page: Left:0, Top:1600, Width/Right: 2200, Height/Bottom:1700, Font size: 15)
300 x 300 Image Document - 8.5 x 11 Portrait (Resolution 300 x 300 Pixels Per Inch) (2550 pixels(X-Width) x 3300 pixels (Y-Height))
Print Annotation at Top of Page Example parms to print at top of page: Left:0, Top:0, Width/Right: 2550, Height/Bottom:100, Font size: 15)
Print Annotation at Bottom of Page Example parms to print at top of page: Left:0, Top:3200, Width/Right: 2550, Height/Bottom:3300, Font size: 15)
300 x 300 Image Document - 11 x 8.5 Landscape (Resolution 300 x 300 Pixels Per Inch) (3300 pixels(X-Width) x 2550 pixels (Y-Height))
Print Annotation at Top of Page Example parms to print at top of page: Left:0, Top:0, Width/Right: 3300, Height/Bottom:100, Font size: 15)
Print Annotation at Bottom of Page Example parms to print at top of page: Left:0, Top:2450, Width/Right: 3300, Height/Bottom:2550, Font size: 15)
Sample Image File Attachments
Attached are a couple of sample TIFF images with various printing resolutions.
test100dpi.tif - A 100 DPI Test Sample Image File test200dpi.tif - A 200 DPI Test Sample Image File test300dpi.tif - A 300 DPI Test Sample Image File test204196.tif - A 204 x 196 DPI Test Sample Fax Image File
