ippsc

ippsc

IPPSC converts plain text file to a simple PostScript or PDF file.

Note the 'simple' : it is NOT a full in-line markup -> PostScript/PDF
translator. It is used mainly for non-precision work like proof printing.

It either leaves the output files in an output queue, sends them to a printer
using 'lpr' or routes them back to spool/2go for further distribution.

The original files are normally deleted.

The FipHdr field 'DF' is used to find a parameter file in tables/setup.

In the data a series of markup commands can be used to modify the presentation
of the text. These commands use a start escape chr (and an optional trailing
end chr or size too).

Modes. pointsize and leading can be interpreted from in-line markup or escape
codes. {M0 - start mode 0 - can be used to switch a particular PDF/PostScript
font.

These escape strings have the format (presy chr) (type letter) (numbers).
The presy is normally a '{' but can be changed in the parameter file.
The numbers may be decimals.
The type letter is case IN-sensitive and is :
        'm' for mode or font
        'p' for pointsize
        'l' for leading
        'c' for approximate column width
        'z' for a raw postScript command to pass through to the data
The end of an escape string is EITHER an (endpresy chr) or a non-digit or dot.
If the endpresy is used, it is stripped while any other chr is left in the
text.

100 mode/font switches are catered for in the range {m0 to {m9999999 unless
restricted by the modesize: parameter which states the number of digits the
font can be in the incoming data.
Modesize is especially useful where Font changes do NOT have a trailing end Chr
(like a '}').

You MUST use a 'endpchr' to define an endpresy  chr if using PASSTHRUS.

Pointsize, defaults to 9pt, can be changed with {p22} or {p9.9}

Setsize (ie the width of the characters), if different from pointsize, can be
changed with 's' keyword - {p32}{s21} will produce 32pt text with a width of 21
(which will normally look awful!).

Note that a 'p' for pointsize will automatically reset the setsize at the same
time; so the sequence must always be to change pointsize then setsize - eg
{p12}{s11} is fine while {s11}{p12} will ignore the 's11'.

The PDF/PostScript output file is just left in the output queue (spool/pscdone
by default). Normally an 'lpr' is added as a 'script' parameter. In any case,
please remember to purge the output queue in the nightly purge or whenever
appropiate.

The parameter file in tables/setup is normally called POSTSCRIPT or PDF if the
-PDF input swith is set. It has the following parameters :

    ; comment line is preceeded by a semi-colon.
    font: (unique number) (Font Name)
        Map a mode to this PDF/PostScript name. There can be up to 100 fonts
        The name must be EXACTLY that which is used by your Rip.
        The number must be unique but the name can be duplicated.
        eg: font:6  Frutiger-Bold
        If there is a Font with a number of Zero, this is assumed to be the
        font to use for the beginning of data.
    deffont: (unique number) (Font Name)
        Actual PDF/PostScript name of the font to use as default.
        The font number should be unique and not used by any other but the name
        can duplicated another font.
        The default font is used for banners and headings.
        eg :    deffont:9999    Helvetica
        The default default is no.9999 name.Times-Roman
    pdfhdr: (file name)
    pshdr: (file name)
        The PostScript Header file in tables/setup
        The default is PSHDR for PostScript and PDFHDR for PDF.
        pshdr:normal
    pdftlr: (file name)
    pstlr: (file name)
        The PostScript Trailer file in tables/setup
        The default is PSTLR for PostScript and PDFTLR for PDF.
        pstlr:3copies
    pdfinclude: (file name)
    psinclude: (file name)
        An optional PostScript Include file in tables/setup
        There is no default. Use this to add specifics for this job
        such as postscript routines for drawing boxes, circles etc.
        psuser:LH_USERS
    margin: (left hand indent)
        The Left hand margin in points. The default is 12pt.
        margin:24
    top:    (space at the top of the page)
        The Space at the top of the page in points. The default is 12pt.
        top:24
    width:  (page width)
        Page width of the output printer in points.
        This defaults to 576 for 8 inches of 72 points per inch.
        width:792       A3 width
    depth:  (page depth)
        Page Depth of the output printer in points.
        This defaults to 792 for 11 inches of 72 points per inch.
        depth:1152      A3 depth
    defpoint: (PointSize)
        Default pointsize - normal value is 9pt.
        defpoint:22
    defset: (SetSize)
        Default setsize - normal value is 9pt.
        defset:22
    deflead: (leading in points)
        Default leading - normal value is 9pt.
        deflead:16
    newname: (FipSeq)
        Derive a new name for the output file using FipSeq.
        newname:\SN.\$j     for name with a julian date extension
    script: (script name)
        Run a script against the output file when finished.
        If you are not sure whether the script is in you path,
        specify the full path name. The name of the output file is
        given as the last parameter to the script.
            script:/usr/ucb/lpr -h -r -P \QS
        or  script:/fip/local/printit
        This script is parsed so may contain FipSeq :
        script:/fip/local/printit "\ZO" "\PG"
        The actual file is the last parameter - $3 in this case.
        Always quote parameters if there is a chance of nothing in the field.
        To strip quotes in a script use 'sed' :
            new2=`echo $2 | sed /"//g`
    banner: (FipSeq banner)
        Custom heading for the top of Page 1.
        banner:Printed at \$h:\$n \$d-\$m-\$y, File \SN-\AQ-\QG Page.1
        default is "File.(newname)   Page.1    (Date Time)"
        Note that the newname is added as \PN.
        Remember to stick a NL at the end of the line if needed - \n.
        If several lines are required, add \n where you need.
    nobanner:
        Do NOT add a banner.
    page: (FipSeq page top)
        Custom heading for Page 2 and all following pages.
        page:Continuation of File \SN-\AQ-\QG Page.\PX
        default is "File.(newname)   Page.(pageno)   (Date Time)"
        Note that the newname is added as '\PN' and page as '\PX'.
        Remember to stick a NL at the end of the line if needed - '\n'.
        If several lines are required, add '\n' where you need except
        preceding end-of-lines are ignored.
    nopage:
        Do NOT add a page top.
    endpage: (FipSeq page ending or continuation line)
        Custom continuation line for the bottom of Page 1 
            and all following pages.
        eg  endpage:...File Continues
        The default is NOT to print anything.
        The text from this prints in the end zone NOT in the data part.
        Preceeding end-of-lines '\n' are ignored.
    fini: (FipSeq end of documuent)
        Custom End-of-document string.
        fini:-fini-
        default is "\t\t\t--- end ---"
        Preceeding end-of-lines '\n' are ignored.
    nofini:
        Do NOT add an end of document.
    pchr:   (FipSeq chr)
        Escape precedence chr in place of the default '{'
        for changing fonts, pointsize and leading ( {m0, {p5.5)
        pchr:~      or pchr:\377
    endpchr:  (FipSeq chr)
        End of Escape precedence chr in place of the default '}'
        for changing fonts, pointsize and leading ( {m0, {p5.5)
        endpchr:|   or endpchr:\011
    modesize: max number of digits in a mode change where there is no endpchr,
        eg if modesize:2, then {m8755.. will change to font 87 and output 55...
        otherwise it will change to font 8755 and output ..
        default is unlimited size.
    bboxx:  Bounding Box width of whole document
    bboxy:  Bounding Box depth of whole document
        Normally the bounding box of the output PDF/PostScript file is set to
        unknown (ie ? ? ? ?) which is fine for most printers.
        But if you are going to embed the file(s) in another document, it will
        need to know what the dimemsions it really are. The problem is that
        'ippsc' knows only the printable area, not the bounding box - so you
        have to tell it.  The values are in whole points.
        eg for A4 page      bboxX:595
                            bboxY:842

    log-line: Custom log line
    logeachfile:(dest) Send a Success/failed msg to this destination for each
file.
            There is no default.
            This log file is just a FipHdr with the following extra fields :
                DR-File Sent OK  DR:ok or DR:error
                DG-Will Retry later DG:retrying or DG:stopped
                DT-Some message text    DT:No connection
                DO-Number of last attempt   DO:5
                HT-Date and Time    HT:25 Nov 98 15:35:25
            default: no log created.
            The DR and DG messages can be changed by using :
                log-dr-ok:(FipSeq)
                log-dr-error:(FipSeq)
                log-dg-stop:(FipSeq)
                log-dg-retry:(FipSeq)
            eg: log-dr-ok:File \VN Printed (\$h:\$n)
    msgeachfile:(FipSeq) Additional information to add to the FipHdr of the
'logeachfile'
            msg. This should be in FipHdr format and be in FipSeq. It can be
            used to pass FipHdr fields in the outgoing file into the log file.
            eg  msgeachfile:    DF:logdial\nSS:\SS\n
            default: nothing added
    logo-file: Filename of an EPS logo (in FipSeq)
    logo-x: X position of the bottom left of the EPS
    logo-y: Y position of the bottom left of the EPS
    logo-type:  Type of logo
            'every' logo is on every page
            'first' logo is on first page only
            'other' logo is on all pages after the first
            'cover' logo is on the cover page only
            The default is 'every'.
            Note that these are additional - the first page may have
            logos under type:first and type:every.
    There can be up to 9 logos per type of page by specifying :
        logoZ-name, logoZ-x, logoZ-y and logoZ-type
        where Z is 1 to 9
        eg  logo7-x:

    If you specify one or more logos, you will also need to adjust the
    printable area using -
    first-page-top: Y position of the start of text (overrules 'top:')
    first-page-depth: depth of text (overrules 'depth:' if a logo exists)
    every-page-top: Y position of the start of text (overrules 'top:')
    every-page-depth: depth of text (overrules 'depth:' if a logo exists)
    other-page-top: Y position of the start of text (overrules 'top:')
    other-page-depth: depth of text (overrules 'depth:' if a logo exists)

    cover-sheet:    FipSeq for a cover sheet banner
    cover-page-top: Y position of the start of text (overrules 'top:')
    cover-page-depth: depth of text (overrules 'depth:' if a logo exists)

    epsf-path:  Path to where Logos etc are held.   default: /fip/tables/logos
    opi-stub-file: If the EPSFs are really OPI includes, this is the stub file
            holding the actual ALDUS include statements.    default:none 

    All the logos, x and y can be in FipSeq if the data is held in FipHdr fields
of the incoming data. X and Y are in points and default to 0. There is no
default logo names.
        eg  logo6-file:/fip/tables/logos/\WL
            logo6-x:0
            logo6-x:\QY
            combie:QY   WY,300
        This places the logo named in FipHdr WL at posn x0, y either whatever is in
WY or 300.

Where parameter fields can be FipSeq, the usual optional, combie, repeat,
style, newdate and partial fields are available (see System Admin Guide for
more information on FipSeq)

Input Switches, all optional :
    -1 : filename for a single shot         default: spooled
        In this case the input file is NOT deleted and the program
        stops after processing the file.
    -PDF : output PDF       default: postscript
    -i : input queue to scan    default: spool/2psc if postscript
                    default: spool/2pdf if pdf
    -o : output queue for postscript files.     default: spool/pscdone
    -l : do NOT log outgoings           default: log outgoing
    -y : fipHdr field to use for the        default: DF
        parameter file
    -d : done queue for sent files          default: none
        Normally files are deleted after sending.
    -T : log the trace of each transaction      default: do not
        This generates a one line log of each file sent is stored in
        log/remote_trace with a name of 'date_(DF)'.
    -z : name of default parameter file in tables/setup
                    default: POSTSCRIPT or PDF
    -Z : folder for parameter files     default: /fip/tables/setup
        Use this to organise lots of parameters files.
            eg -Z setup/psc
    -v : version no and stop

Just one note ... Sometimes - at random - you may get the font change not
working. Stop 'ippsc' and resend a file that generates the problem. The bet is
that the font change - something like {M8 - is actually just in front of some
other numbers like :
    {M812 days of Christmas
So either use a 'modesize' to restrict the number of digits (if possible) or
add and 'endpchr' to finish it. What you want is :
    {M8}12 Days of Christmas

(copyright) 2017 and previous years FingerPost Ltd.