Required Commands

The following command line arguments to Image to PDF are always required:

  -Output
Parameters: PDF filename - specifies the name and location of the produced PDF document, if spaces are required in the filepath then enclose it within quotes. Specify *.pdf to force the creation of a separate PDF for each image (instead of all images being in one PDF) which is created in the same directory as the source image.
option - is an optional parameter which can only be specified if the PDF filename is *.pdf AND only one wildcarded image name is used - the only possible value for this option is PerDirectory which forces the creation of a single PDF file (with the name of that directory and saved in that directory) for the entire contents of a directory rather than one per image.
Notes: Please note the following when using a PDF filename of *.pdf:
  • If the -OpenPDF command is also used then your default PDF viewer may restrict the number of PDFs that can be opened at one time or then again it may possibly even try and open every one in which case there may not be enough memory available.
  • If the -Recurse command is also used together with wildcard filenames then there is no limit to the number of images that will be converted into PDF - this is only limited by the number of images that are found to match the wildcard pattern in every directory that is recursed.
  • The -Output and -Recurse commands MUST be specified before any -Image or -ImageList commands containing wildcard filenames.

  •   -Image
    Parameters: image filename - specifies the name and location of an image to embed within the output PDF document, if spaces are required in the filepath then enclose it within quotes.
    Notes:
  • Images can be one of the following types: JPEG/JPG, TIFF/TIF, PNG, GIF, BMP, WMF, EMF, TGA or PCX.
  • Up to 1000 images can be included.
  • Images are embedded in the output PDF document in the order that they are referenced.
  • Image filenames can contain the wildcard characters * and ? that allow multiple images to be referenced in one go. These characters can only be in the filename and not in any part of the filepath before the filename.
  • WMF and EMF image meta files are rendered into an image (unless you use the -MetaToNativePDF command) - any text that was in them is also rendered into the image which means that this text will not be searchable text in the output PDF.
  • You may find it more convenient to use the -ImageList command detailed below if you have a lot of images to add.

  •   -ImageBookmark
    Parameters: image filename - specifies the name and location of an image to embed within the output PDF document, if spaces are required in the filepath then enclose it within quotes.
    bookmark name - specifies the bookmark name to be shown in the outline. A maximum of 256 characters can be used, if spaces are required in the bookmark name then enclose it within quotes.
    Notes:
  • Images can be one of the following types: JPEG/JPG, TIFF/TIF, PNG, GIF, BMP, WMF, EMF, TGA or PCX.
  • Up to 1000 images with bookmarks can be included.
  • Using this command will ensure that an outline is created for the PDF and if the -Outline command is also specified then the bookmark name specified will override the automatic outline bookmark name that would have been used.
  • You can still use the -Image and -ImageList commands and mix them in any order with -ImageBookmark commands - images added using these other commands will have default bookmark names if the -Outline command has been specified - or no bookmark names otherwise.
  • Images are embedded in the output PDF document in the order that they are referenced.
  • Currently it is not possible to specify filenames that contain wildcard characters - if you do the bookmark name will be ignored.
  • WMF and EMF image meta files are rendered into an image (unless you use the -MetaToNativePDF command) - any text that was in them is also rendered into the image which means that this text will not be searchable text in the output PDF.
  • You may find it more convenient to use the -ImageList command detailed below if you have a lot of images to add.

  •   -ImageList
    Parameters: image list filename - specifies the name and location of a text file that contains a list of images to embed within the output PDF document, if spaces are required in the filepath then enclose it within quotes. Each line within the text file must contain one image filename - quotes are not required even when spaces are used as each line contains just one image filename.
    Notes:
  • Images can be one of the following types: JPEG/JPG, TIFF/TIF, PNG, GIF, BMP, WMF, EMF, TGA or PCX.
  • Up to 1000 images can be included.
  • Images are embedded in the output PDF document in the order that they are referenced.
  • Image filenames can contain the wildcard characters * and ? that allow multiple images to be referenced in one go. These characters can only be in the filename and not in any part of the filepath before the filename.
  • WMF and EMF image meta files are rendered into an image - any text that was in them is also rendered into the image which means that this text will not be searchable text in the output PDF.
  • You can include one or many of both types of image command, i.e. -Image or -ImageList.

  •   -License
    Parameters: license code - this is required to remove the "Evaluation Mode" message that is stamped over the top of every page.
    Notes:
  • To purchase a license code please visit the Image to PDF Command Line Tool Utility Warrior web page which has the latest information and prices on the licenses that are currently available.

  •   -RegistryLicense
    Parameters: license code - this is required to remove the "Evaluation Mode" message that is stamped over the top of every page.
    Notes:
  • This command only needs to be used once as the license key is stored in the Windows Registry and will be retrieved from the registry the next time that the utility is run.
  • To purchase a license code please visit the Image to PDF Command Line Tool Utility Warrior web page which has the latest information and prices on the licenses that are currently available.