Mako 6.1.1 Release Notes

MAKO-3320

Add equivalent of PDFLib's SetPageFilterRange to IDistiller

Three new API functions are added to IDistiller to specify which pages in a PostScript job are processed.

• setPageFilterLow() sets a lower page limit

• setPageFilterHigh() sets an upper page limit

• setPageFilterRange() sets a range of pages to output

Use it in this way.

const auto mako = IJawsMako::create();
IJawsMako::enableAllFeatures(mako);
auto distiller = IDistiller::create(mako);

// High & Low
distiller->setPageFilterLow(10);
distiller->setPageFilterHigh(20);
distiller->distill(
    IInputStream::createFromFile(mako, "test100.ps"),
    IOutputStream::createToFile(mako, "test10-20.pdf")
);

// Range
distiller->setPageFilterRange(10, 20);
distiller->distill(
    IInputStream::createFromFile(mako, "test100.ps"),
    IOutputStream::createToFile(mako, "rangeTest10-20.pdf")
);

// Additionally setParameter() is also available to set the lower and upper limits. 
// This API expects values as strings, useful for command-line apps etc., e.g.
distiller->setParameter("PageFilterLow", "10");
distiller->setParameter("PageFilterHigh", "20");

using JawsMako;

namespace MakoDistillerCheck
{
    class Program
    {
        static void Main(string[] args)
        {
            var mako = IJawsMako.create();
            IJawsMako.enableAllFeatures(mako);
            var distiller = IDistiller.create(mako);

            // High & Low
            distiller.setPageFilterLow(10);
            distiller.setPageFilterHigh(20);
            distiller.distill(
            IInputStream.createFromFile(mako.getFactory(), "test100.ps"),
            IOutputStream.createToFile(mako.getFactory(), "test10-20.pdf")
            );

            // Range
            distiller.setPageFilterRange(10, 20);
            distiller.distill(
            IInputStream.createFromFile(mako.getFactory(), "test100.ps"),
            IOutputStream.createToFile(mako.getFactory(), "rangeTest10-20.pdf")
            );

            // Additionally setParameter() is also available to set the lower and upper limits. 
            // This API expects values as strings, useful for command-line apps etc., e.g.
            distiller.setParameter("PageFilterLow", "10");
            distiller.setParameter("PageFilterHigh", "20");
        }
    }
}

import java.math.*;

import com.globalgraphics.JawsMako.jawsmakoIF.*;

public class MakoDistillerCheck
{
   public static void main (String[] args)
    {
      var mako = IJawsMako.create();
      IJawsMako.enableAllFeatures(mako);
      var distiller = IDistiller.create(mako);

      // High & Low
      distiller.setPageFilterLow(BigInteger.valueOf(10));
      distiller.setPageFilterHigh(BigInteger.valueOf(20));
      distiller.distill(
         IInputStream.createFromFile(mako.getFactory(), "test100.ps"),
         IOutputStream.createToFile(mako.getFactory(), "test10-20.pdf")
      );

      // Range
      distiller.setPageFilterRange(BigInteger.valueOf(10), BigInteger.valueOf(10));
      distiller.distill(
         IInputStream.createFromFile(mako.getFactory(), "test100.ps"),
         IOutputStream.createToFile(mako.getFactory(), "rangeTest10-20.pdf")
      );

      // Additionally setParameter() is also available to set the lower and upper limits.
      // This API expects values as strings, useful for command-line apps etc., e.g.
      distiller.setParameter("PageFilterLow", "10");
      distiller.setParameter("PageFilterHigh", "20");
   }
}

MAKO-3350

IJPDS Performance improvement

In response to a customer request, the IJPDS input class has undergone significant refactoring that has resulted in an average performance increase of 71%. In particular, the method for obtaining the number of pages now returns almost immediately.

MAKO-335X

IJPDS input class: additional options to control assembly of output pages

The method to instantiate the class remains the same, but the available parameters have changed.

IIJPDSInputPtr input = IIJPDS::create(jawsMako);
input->setParameter("ripsetup", "cmyk");

var input = IIJPDS.create(jawsMako);
input.setParameter("ripsetup", "cmyk");

A complete list of the available parameters follows. Items marked with an asterisk are new in this version.

Parameter

Possible values

Description

ripsetup

mono

Default. Each RIP generates its own page.

cmyk

Groups RIPs together in blocks of four to generate a composite page.

riporder*

fromjob

RIPs are arranged in the order the job defines them. Default.

ordinal

RIPs are arranged sequentially in their ordinal numbering (starting from 0, for example, Rip0, Rip1, Rip2, Rip3, and so on).

0,1,2,3…

A comma-separated sequence of RIP IDs (a number from 0 to 15, or -1 if a blank is desired for that slot). This controls the sequence in which the RIPs are processed. By default, the order in which the RIP is defined by the job is followed.

0,1,3,2

Example: For CMYK output it is sometimes necessary to change the plate order (here 0,1,3,2 is specified) to obtain the correct composite output.

-1,2,-1,-1

Example: If -1 is encountered in CMYK output, then that separation is interpreted as a blank. This is useful to see a separation in a specific color. For example, specifying -1,2,-1,-1 uses the page from RIP 2 as the magenta plane with all other color planes blank. This results in a CMYK composite output where only RIP 2 comes out in a magenta color. For non-composite output, -1 is ignored, as it does not make sense to output a blank page.

Parameter

Possible values

Description

ripinterleave

Removed. Replaced by riporder.

collation*

bypage

Default. Output is ordered in page number major order. All the first pages from each RIP are output followed by the second pages, and so on.

byrip

Output is ordered by RIP major order. All the pages for RIP 1 are output followed by all the pages for RIP 2, and so on.

riprotate*

0

This denotes the rotation of a RIP separation in the output page.

The value is an angle in degrees, counter-clockwise.

Possible values are 0, 90, 180, and 270; the default value is 0.

90

180

270

stitch*

true (or 1)

Individual RIP separations are combined into one page by stitching them together. Default.

The orientation of the stitching can be controlled by the stitchhorizontal parameter.

false (or 0)

Individual RIP separations are each output as separate pages.

stitchhorizontal*

true (or 1)

The RIP separations are stitched in a horizontal orientation.

false (or 0)

The RIP separations are stitched in a vertical orientation. Default.

resourcedirectory

<path to resources folder>

Sets the directory where remote resources are located (that is, resources referenced by the IJPDS but external to it).