FLIP2PDF

Setting up your profile

Your JSON profile file (or files) should include a list of settings that define exactly what kind of PDF output document you want to produce.  We provide a default JSON file called “standard.json.” You can edit this JSON profile as you like or use it as a template for creating your own.

If you want to create your own custom profile, we recommend that you save a copy of this default JSON file and rename it, and then edit this copy instead.  This way you will preserve the original JSON profile for later reference.  Also, if you install an updated version of the software, the installation process will overwrite the original standard.json file, and any changes you made to that file will be lost.  Besides saving your own copy of the profile, you might also want to create a backup your edited JSON profile in a different directory.

Every setting for FLIP2PDF is optional.  That means then that a setting is only applied if it is included in the JSON profile. Flag settings must be set to “on” to be activated.  Settings that are turned off do not need to be defined in the JSON profile file.

You can use the JSON validator JSONLint to check your JSON syntax.

The standard.json profile

This is what the standard.json profile looks like, with all options provided.

{
    "postscript": {
        "color-images": {
          "downsample" : "on",
          "downsampling-dpi" : 300,
          "compression" : "jpeg"
        },
        "gray-images": {
          "downsample" : "on",
          "downsampling-dpi" : 300,
          "compression" : "jpeg"
        },
        "mono-images": {
          "downsample" : "on",
          "downsampling-dpi" : 300
        },
        "pdf-output-type" : "PDF"
    },
    "office": {
        "images": {
          "downsample" : "on",
          "downsampling-dpi" : 300,
          "compression" : "jpeg"
        },
        "tagged-pdf" : "off",
        "pdf-output-type" : "PDF"
    },
    "html": {
        "images": {
          "downsample" : "on",
          "downsampling-dpi" : 300,
          "compression" : "jpeg"
        },
        "web-layout" : "desktop",
        "page-size" : "letter",
        "page-margin" : "1.0in",
        "page-orientation" : "portrait"
    }
}

Converting PostScript Files

JSON profile parameters:

downsample Set this value to “on” if you want to enable the ability to select a resolution value for downsampling graphics images in a PostScript file.
downsampling-dpi Enter a resolution value, in Dots per Inch, if you want to reduce the resolution of the graphics embedded in a PostScript file.  This may result in a smaller PDF output document. The available options are 75, 150, 300, 600, and 1200. Defaults to 300 DPI.
compression Enter a compression method to use for graphics images in PostScript files.  Enter jpeg or flate. Defaults to jpeg.
pdf-output-type Enter an output type, PDF, or use, PDF/X-1a or PDF/X-3a for graphics use. Defaults to PDF.

If you wanted to convert a PostScript file with embedded color images, reduce the resolution for these images to 600 DPI while using the default “jpeg” compression method, and save the PDF output documents as PDF/X files, the PostScript section of your JSON profile might look like this:

{
    "postscript": {
        "color-images": {
            "downsample" : "on",
            "downsampling-dpi" : 600,
        },
        "pdf-output-type" : "PDF/X-1a"
    }
}

If you weren’t planning to convert any PostScript files into PDF documents, you could leave the PostScript parameters out of your JSON profile.

Converting Microsoft Office Files

JSON profile parameters:

downsample Set this value to “on” if you want to enable the ability to select a resolution value for downsampling graphics images in a Microsoft Office file.
downsampling-dpi Enter a resolution value, in Dots per Inch, if you want to reduce the resolution of the graphics embedded in an Office file.  This may result in a smaller PDF output document. The available options are 75, 150, 300, 600, and 1200. Defaults to 300 DPI.
compression Enter a compression method to use for graphics images in Office files.  Enter jpeg or flate. Defaults to jpeg.
tagged-pdf Set to “on” to create a tagged PDF document. The tagged PDF feature only works with Office documents. If you enable the tagged-pdf option, FLIP2PDF creates a tagged PDF document corresponding to the semantic structures found in the Office source file. Titles, headings, lists and other structures in the Office document are expressed in the output PDF. Defaults to off.
Note that if you select PDF/A as the pdf-output-type parameter, the software will generate a tagged PDF document as the output file. It will ignore the setting for the tagged-pdf parameter.
pdf-output-type Enter an output type, PDF or PDF/A-1. FLIP2PDF can generate PDF/A-1a conforming output. Defaults to PDF.

You might, for example, want to convert a folder containing Microsoft Word documents with embedded images and downsample those images to 600 DPI using the JPEG compression method while saving the output files as PDF/A output files. The Microsoft Office section of your JSON profile might look like this:

    }
    "office": {
        "images": {
          "downsample" : "on",
          "downsampling-dpi" : 600,
          "compression" : "jpeg"
        },
        "pdf-output-type" : "PDF/A-1",
    }

If you weren’t planning to convert any Office files into PDF documents, you could leave the Office parameters out of your JSON profile.

Converting HTML Files and Web Site Pages

downsample Set this value to “on” if you want to enable the ability to select a resolution value for downsampling graphics images found on a web site.
downsampling-dpi Enter a resolution value, in Dots per Inch, if you want to reduce the resolution of the graphics found on a web site.  This may result in a smaller PDF output document. The available options are 75, 150, 300, 600, and 1200. Defaults to 300 DPI.
compression Enter a compression method to use for graphics images on a web site. Enter jpeg or flate. Defaults to jpeg.
web-layout Select an option for the web layout to use for responsive HTML pages— desktop, tablet, or mobile.  Defaults to desktop. In Responsive Web Design, a web page can be designed to appear differently depending on the screen size of the device used to display that web page. It is easier to read and navigate a web site on a mobile phone if that web site is specifically designed to present on a mobile phone. With this option in FLIP2PDF, you can select the layout for responsive pages that is best suited for your needs. Each option provided corresponds to a set of pixel measurements that sets the web viewport. The default for desktop viewing, for example, is 1280 x 1024 pixels.
page-size Defaults to letter. Enter the size for the page in the PDF output document, letter, legal, ledger, A3, A4, or A5.
page-margin Defaults to one inch margins on each PDF output page. Enter a number and unit (inches or millimeters) to set a page margin. For example, enter “2.0in” for two inches or “10mm” for ten millimeters.
page-orientation Defaults to portrait.  Set this value to “landscape” to generate landscape PDF documents instead.

You might, for example, want to convert a web page and downsample the images shown on that page to 600 DPI using the JPEG compression method. You could set the page margins 10 millimeters for a standard A4 page size and use the landscape orientation while using the tablet web page layout. The HTML section of your JSON profile might look like this:

    },
    "html": {
        "images": {
          "downsample" : "on",
          "downsampling-dpi" : 600,
          "compression" : "jpeg"
        },
        "web-layout" : "tablet",
        "page-size" : "A4",
        "page-margin" : "10mm",
        "page-orientation" : "landscape"
    }
}

If you weren’t planning to convert any HTML files or web sites to PDF documents, you could leave the HTML parameters out of your JSON profile.

Converting Graphics Files

Your command line statement for converting graphics files might look like this:

flip2pdf --input TestImage.jpg --output TestImage.pdf

There are no options to enter in the JSON profile for converting graphics image files.

FLIP2PDF does not downsample graphics files when converting them to PDF documents. The product will use the resolution assigned to each BMP, JPEG, TIFF, or PNG file when creating the PDF output.  Sometimes, however, an image file does not have resolution information saved with that file. If an image does not have a defined resolution, FLIP2PDF writes it to 72 DPI when generating the output PDF document.

FLIP2PDF uses the flate compression method when converting BMP, PNG, and TIFF graphics files to PDF documents. For JPEG files, the product uses jpeg compression.

FLIP2PDF preserves transparencies in PNG and TIFF images in the PDF output and preserves the color space for raster images that are RGB, CMYK, or Grayscale. FLIP2PDF does not process TIFF files that use color spaces other than Grayscale, RGB or CMYK.