org.faceless.pdf2
Class OutputProfile

java.lang.Object
  extended byorg.faceless.pdf2.OutputProfile
All Implemented Interfaces:
Cloneable

public class OutputProfile
extends Object
implements Cloneable

An Output Profile allows you to limit the PDF to use only certain features, or to enable features that are not on by default. By default documents use the Default profile, but at any point before the document is rendered, a profile may be set by calling the PDF.setOutputProfile method.

If an attempt is made to use a feature of the PDF specification that is not allowed by the documents profile, an IllegalStateException is thrown.

Note that if a PDF is loaded via the PDFReader class, no attempt is made to ascertain which features are used. For instance, it's quite possible to load a document containing RGB colors, set the profile to PDF/X-1a and save it again without the software complaining. If you are going to load a document from disk and require that it meets a certain profile, we suggest that you ensure it meets that profile before it's loaded.

Since:
2.0
See Also:
PDF.setOutputProfile(org.faceless.pdf2.OutputProfile)

Field Summary
static OutputProfile Acrobat4Compatible
          Force the document to be Acrobat 4.0 compatible.
static OutputProfile Acrobat5Compatible
          Force the document to be Acrobat 5.0 compatible.
static OutputProfile Default
          This is the default Output Profile.
static OutputProfile ImageOnly
          Add some features to the PDF that are useful when the PDF simply consists of one big JPEG image.
static OutputProfile NoCompression
          Save the document with no additional compression done.
static OutputProfile PDFX1a
          Save the document so that it conforms to the PDF/X-1a (ISO15390-1:2001) prepress specification.
static OutputProfile PDFX3_ICC
          Save the document so that it conforms to the PDF/X-3 (ISO15390-3:2002) prepress specification.
static OutputProfile PDFX3_NoICC
          Save the document so that it conforms to the PDF/X-3 (ISO15390-3:2002) prepress specification, with the proviso that ICC profiles may not be used in the document.
 
Method Summary
 Object clone()
           
 void setUseCalibratedColorSpaceInsteadOfICC(boolean calibrated)
           
 String toString()
           
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

Default

public static final OutputProfile Default
This is the default Output Profile. All features are enabled by default. The resulting document may not be readable in Acrobat 4 or 5, depending on which features are used (128-bit encryption, for instance).


Acrobat4Compatible

public static final OutputProfile Acrobat4Compatible
Force the document to be Acrobat 4.0 compatible. An error will be thrown if any non-Acrobat 4.x compatible actions are performed. Specifically this includes using alpha transparency or encrypting the document with 128-bit encryption


Acrobat5Compatible

public static final OutputProfile Acrobat5Compatible
Force the document to be Acrobat 5.0 compatible. An error will be thrown if any non-Acrobat 5.x compatible actions are performed. Currently the only Acrobat 6 specific features are setting unencrypted metadata in the StandardEncryptionHandler, and using characters requiring the UTF-16 encoding in StandardCJKFont


NoCompression

public static final OutputProfile NoCompression
Save the document with no additional compression done. This is useful for debugging or when speed really matters over filesize. Objects that are already compressed, (e.g. some images) are not decompressed but are saved as-is.


ImageOnly

public static final OutputProfile ImageOnly
Add some features to the PDF that are useful when the PDF simply consists of one big JPEG image. This adds several options when the document is loaded in Acrobat 6.x - specifically the ability to edit and print pictures using the standard "print picture" settings, and also the ability to order photographic prints of the specified image. This only works if the document pages contain a single JPEG image - if not, this setting is the same as Default


PDFX1a

public static final OutputProfile PDFX1a
Save the document so that it conforms to the PDF/X-1a (ISO15390-1:2001) prepress specification. This places a number of restrictions on the document, including no RGB colors (including RGB alternates for spot colors), only embedded fonts, no encryption/annotations/actions/javascript/transparency, and the "Title" and "Trapped" fields must be set in the documents info dictionary.


PDFX3_NoICC

public static final OutputProfile PDFX3_NoICC
Save the document so that it conforms to the PDF/X-3 (ISO15390-3:2002) prepress specification, with the proviso that ICC profiles may not be used in the document. This is essentially the same as PDF/X-1a, except Spot colors may have RGB alternates.


PDFX3_ICC

public static final OutputProfile PDFX3_ICC
Save the document so that it conforms to the PDF/X-3 (ISO15390-3:2002) prepress specification. ICC color profiles may be used and embedded in the document. See PDFX3_NoICC for more information.

Method Detail

clone

public Object clone()

setUseCalibratedColorSpaceInsteadOfICC

public void setUseCalibratedColorSpaceInsteadOfICC(boolean calibrated)

toString

public String toString()


Copyright © 2001-2004 Big Faceless Organization