Difference between revisions of "PDFX"

From Wiki
Jump to navigation Jump to search
(OSCOLORDIR should be ICCPROFILES)
 
(15 intermediate revisions by 9 users not shown)
Line 5: Line 5:
 
More info will be made available at a later date.
 
More info will be made available at a later date.
  
First things first. The following parameter must be set for any PDF/X version.
+
First things first. The following parameter should be set for any PDF/X version.
  
 
<texcode>
 
<texcode>
Line 28: Line 28:
  
  
The two parameter '<tt>format</tt>' and '<tt>intent</tt>' are sufficient for most cases.
+
The two parameter <tt>format</tt> and <tt>intent</tt> are sufficient for most cases.
  
The '<tt>format</tt>' parameter simply defines the '''PDF/X version''',
+
The <tt>format</tt> parameter simply defines the '''PDF/X version''',
while the '<tt>intent</tt>' parameter sets the so called '''output intent'''.
+
while the <tt>intent</tt> parameter sets the so called '''output intent'''.
  
Currently the following PDF/X versions (enter without quotes) are supported:
+
Currently the following PDF/X versions are supported:
  
 
<code>format =</code>
 
<code>format =</code>
  
      'PDF/X-1a:2001'
+
<texcode>
      'PDF/X-1a:2003'
+
                                              gray  rgb  cmyk  spot  transp. notes
      'PDF/X-3:2002'
+
PDF/X-1a:2001 % PDF Version 1.3 (Acrobat 4.x) *          *    *   
      'PDF/X-3:2003'
+
PDF/X-1a:2003 % PDF Version 1.4 (Acrobat 5.x) *          *    *   
       'PDF/X-4'
+
PDF/X-3:2002   % PDF Version 1.3 (Acrobat 4.x) *    *    *    *
       'PDF/X-4p'
+
PDF/X-3:2003   % PDF Version 1.4 (Acrobat 5.x) *    *    *    *
 +
PDF/X-4        % PDF Version 1.6 (Acrobat 7.x) *    *    *    *    *    PDF layers
 +
PDF/X-4p       % PDF Version 1.6 (Acrobat 7.x) *    *    *    *    *    PDF layers; ICC externally supplied
 +
PDF/X-5g      % PDF Version 1.6 (Acrobat 7.x) *    *    *    *    *    PDF layers; graphics can be outside pdf
 +
PDF/X-5n       % PDF Version 1.6 (Acrobat 7.x) *    *    *    *    *    PDF layers; ICC externally supplied
 +
PDF/X-5pg      % PDF Version 1.6 (Acrobat 7.x) *    *    *    *    *    PDF layers; p + g
 +
</texcode>
  
 +
* PDF/X-1 uses device dependent colors, i.e. your pictures must be converted into the output color space (gray or CMYK).
 +
* PDF/X-3+ uses device '''in'''dependent colors, i.e. the color space of your pictures doesn’t matter, but it must be defined by a color profile.
 +
* It makes no sense to use CMYK pictures with PDF/X-3+, because color conversions between CMYK profiles are more lossy than any RGB-to-CMYK conversion!
 +
* It makes sense to use PDF/X-1a:2003 for bw printing.
 +
* Even if they’re allowed in X/4+, don’t use PDF layers for print projects – your printshop will not be able to handle them.
  
Predefined output intents (also without quotes):
+
Predefined output intents:
  
 
<code>intent =</code>
 
<code>intent =</code>
 +
    Coated FOGRA39 (ISO 12647-2:2004)
 +
    GRACoL2006_Coated1v2.icc
 +
    ISO Coated v2 300% (ECI)
 +
    ISO Coated v2 (ECI)
 +
    ISOnewspaper26v4
 +
    ISOnewspaper26v4_gr
 +
    ISO Uncoated
 +
    ISO Uncoated Yellowish
 +
    ISO Web Coated
 +
    Japan Color 2001 Coated
 +
    Japan Color 2002 Newspaper
 +
    Japan Web Coated (Ad)
 +
    SNAP 2007
 +
    SWOP2006_Coated3v2.icc
 +
    SWOP2006_Coated5v2.icc
 +
    Uncoated FOGRA29 (ISO 12647-2:2004)
 +
    Web Coated FOGRA28 (ISO 12647-2:2004)
 +
    PSR_LWC_PLUS_V2_PT
 +
    PSR_LWC_STD_V2_PT
 +
    PSR_SC_PLUS_V2_PT
 +
    PSR_SC_STD_V2_PT
 +
    PSRgravureMF
 +
 +
'''Which one to use?'''
 +
* In Europe, use FOGRA profiles.
 +
* In the USA, use SWOP profiles.
 +
* In Japan, use Japan profiles.
 +
* Use Coated for image printing paper.
 +
* Use Uncoated for natural paper (e.g. "offset").
 +
* "Web" means "web offset", i.e. big volume printing from a roll of paper (vs. sheet paper).
  
      'Coated FOGRA39 (ISO 12647-2:2004)'
 
      'GRACoL2006_Coated1v2.icc'
 
      'ISO Coated v2 300% (ECI)'
 
      'ISO Coated v2 (ECI)'
 
      'ISOnewspaper26v4'
 
      'ISOnewspaper26v4_gr'
 
      'ISO Uncoated'
 
      'ISO Uncoated Yellowish'
 
      'ISO Web Coated'
 
      'Japan Color 2001 Coated'
 
      'Japan Color 2002 Newspaper'
 
      'Japan Web Coated (Ad)'
 
      'SNAP 2007'
 
      'SWOP2006_Coated3v2.icc'
 
      'SWOP2006_Coated5v2.icc'
 
      'Uncoated FOGRA29 (ISO 12647-2:2004)'
 
      'Web Coated FOGRA28 (ISO 12647-2:2004)'
 
      'PSR_LWC_PLUS_V2_PT'
 
      'PSR_LWC_STD_V2_PT'
 
      'PSR_SC_PLUS_V2_PT'
 
      'PSR_SC_STD_V2_PT'
 
      'PSRgravureMF'
 
  
 
Some examples:
 
Some examples:
Line 89: Line 108:
 
'''All remaining parameter are kind of special.'''
 
'''All remaining parameter are kind of special.'''
  
'<tt>profile</tt>'
+
<tt>profile</tt>
 
sets the ICC based default color space profile (option for color management);
 
sets the ICC based default color space profile (option for color management);
 
this setting is document wide and currently only one profile
 
this setting is document wide and currently only one profile
 
per color space is allowed
 
per color space is allowed
  
'<tt>level</tt>'
+
<tt>level</tt>
 
sets the PDF compress level (values of 0..9 are allowed). Normally no need to change the
 
sets the PDF compress level (values of 0..9 are allowed). Normally no need to change the
 
default value.
 
default value.
  
'<tt>option=always|never</tt>'
+
<tt>option=always|never</tt>
     'always': force embedding of the output intent profile (useful only in case of PDF/X-1a)
+
     <tt>always</tt>: force embedding of the output intent profile (useful only in case of PDF/X-1a)
     'never' : don't embed the output intent profile; no useful practise
+
     <tt>never</tt> : don't embed the output intent profile; no useful practise
  
'<tt>file</tt>'
+
<tt>file</tt>  
 
name of an external file with predefined color profiles
 
name of an external file with predefined color profiles
  
Line 108: Line 127:
  
 
The predefined color profiles can be found in
 
The predefined color profiles can be found in
<tt>.../<context-path>/color/icc/context/colorprofiles.xml|.lua.</tt>
+
<tt>.../<context-path>/colors/icc/context/colorprofiles.xml|.lua.</tt>
  
This list contains the profiles recommended by the [http://www.gwg.org GWG],
+
This list contains the profiles recommended by the [http://www.gwg.org GWG] (Ghent PDF Workgroup) in 2008,
 
the set of profiles bundled with [http://pages.cs.wisc.edu/~ghost/ ghostscript]
 
the set of profiles bundled with [http://pages.cs.wisc.edu/~ghost/ ghostscript]
and three test only profiles from www.color.org [http://www.color.org/probeprofile.xalter].
+
and three test only profiles from the [http://www.color.org ICC] (International Color Consortium).
 +
 
 +
''' Ghent PDF Workgroup (GWG) recommendations: '''
 +
* [http://dl.contextgarden.net/misc/iccprofiles/GWG_recommended_ICC_profiles_v13.pdf 2008 version]
 +
* [https://gwg.org/technical-specifications/gwg-2015-specifications/ 2015 version] (no profiles mentioned)
  
Special thanks must go to the '''Ghent PDF Workgroup (GWG)'''
+
There are a few contradictions to the PDF/X standards (by [https://www.pdfa.org PDF Association]) to assure a better quality, see the [https://www.pdfa.org/further-quality-requirements-pdfx-plus/ article by Stephan Jaeggi].
for making a list of recommended profiles. Please have a look at the
 
[http://dl.contextgarden.net/misc/iccprofiles/GWG_recommended_ICC_profiles_v13.pdf official documentation]
 
first (will take you only a minute).
 
The origin of this document (and some more info)
 
is located [http://www.gwg.org/recommended_ICC_profiles.phtm here].
 
  
All predefined ICC profiles are also available in the download section.
+
Nearly all predefined ICC profiles are also available in the download section.
 
Output intents are bound to very specific printing conditions (which vary worldwide),
 
Output intents are bound to very specific printing conditions (which vary worldwide),
so it's very likely that you only need one or two ICC profiles (and not all of them).
+
so it’s very likely that you only need one or two ICC profiles (and not all of them).
Therefore the profiles are also available as 'localised' versions.
+
Therefore the profile ZIPs come in 'localized' versions.
  
 
GWG recommend ICC profiles  
 
GWG recommend ICC profiles  
Line 130: Line 148:
 
[http://dl.contextgarden.net/misc/iccprofiles/GWG_recommended_ICC_profiles_Europe.zip (Europe)]
 
[http://dl.contextgarden.net/misc/iccprofiles/GWG_recommended_ICC_profiles_Europe.zip (Europe)]
 
[http://dl.contextgarden.net/misc/iccprofiles/GWG_recommended_ICC_profiles_India.zip (India)]
 
[http://dl.contextgarden.net/misc/iccprofiles/GWG_recommended_ICC_profiles_India.zip (India)]
[http://dl.contextgarden.net/misc/iccprofiles/GWG_recommended_ICC_profiles_Japan.zip Japan)]
+
[http://dl.contextgarden.net/misc/iccprofiles/GWG_recommended_ICC_profiles_Japan.zip (Japan)]
 
[http://dl.contextgarden.net/misc/iccprofiles/GWG_recommended_ICC_profiles_USA.zip (USA)]
 
[http://dl.contextgarden.net/misc/iccprofiles/GWG_recommended_ICC_profiles_USA.zip (USA)]
  
Probe profiles:
+
Probe profiles (external link):
[http://dl.contextgarden.net/misc/iccprofiles/Probe_ICC_profiles_(www.color.org).zip here]
+
[http://www.color.org/probeprofile.xalter here]
  
ghostscript profiles:
+
Ghostscript profiles:
 
[http://dl.contextgarden.net/misc/iccprofiles/ghostscript_ICC_profiles.zip here]
 
[http://dl.contextgarden.net/misc/iccprofiles/ghostscript_ICC_profiles.zip here]
  
Line 148: Line 166:
 
The profiles are normally stored under
 
The profiles are normally stored under
  
.../<context-path>/colors/icc/profiles
+
    .../<context-path>/colors/icc/profiles
  
 
All profiles in the zip archive are already located in the correct sub path,
 
All profiles in the zip archive are already located in the correct sub path,
 
so you only have to unpack them right in your ConTeXt directory
 
so you only have to unpack them right in your ConTeXt directory
(normally 'texmf-context').
+
(normally `texmf-context`).
  
 
In case you use these profiles also with other software, it is
 
In case you use these profiles also with other software, it is
 
possible to share them with ConTeXt. Simply set the environment
 
possible to share them with ConTeXt. Simply set the environment
variable '''$OSCOLORDIR''' to that special software related directory.
+
variable '''$ICCPROFILES''' to that special software related directory.
  
 
E.g. for Adobe Acrobat on Windows Vista this special directory is
 
E.g. for Adobe Acrobat on Windows Vista this special directory is
  
<code>'C:\Program Files (X86)\Common Files\Adobe\Color\Profiles\Recommended'</code>
+
    C:\Program Files (X86)\Common Files\Adobe\Color\Profiles\Recommended
 +
 
 +
Store the needed profiles there (without any TeX directory) and
 +
set $ICCPROFILES to that path.
 +
 
 +
On MacOS use `~/Library/ColorSync/Profiles` for your own profiles; the following setup makes sense in `.bashrc` or `.profile`:
 +
 
 +
    export ICCPROFILES="~/Library/ColorSync/Profiles//:/System/Library/ColorSync/Profiles//:/Library/Application Support/Adobe/Color/Profiles//:"
 +
    # /Library/ColorSync/Profiles// doesn’t contain anything useful
  
Store the needed profiles there (without any tex directory) and
+
The double slashes at the end mean “all subdirectories”.
set $OSCOLORDIR to that path.
 
  
All you need now is a final 'luatools --generate' to update the file database.
+
All you need now is a final <tt>mtxrun --generate</tt> to update the file database.
  
 
In case of problems you should add
 
In case of problems you should add
Line 174: Line 199:
 
</texcode>
 
</texcode>
  
right in front of <tt>\setupbackend</tt> to get
+
right in front of {{cmd|setupbackend}} to get
 
all possible debugging info.
 
all possible debugging info.
  
And that's it for the moment...
+
And that’s it for the moment...
 +
 
 +
[[Category:PDF]]
 +
[[Category:Tools]]

Latest revision as of 14:30, 7 February 2024

PDF/X

This text is a first draft and will give you only the basic information needed to create PDF/X compatible documents. More info will be made available at a later date.

First things first. The following parameter should be set for any PDF/X version.

\setupinteraction
  [title=TITLE,
   subtitle=SUBTITLE,
   author=AUTHOR,
   keyword={{KEYWORD1, KEYWORD2}, KEYWORD3}]

Coming to the quite simple interface.

\setupbackend
  [format=valid pdf/x name,
   profile=name.icc,
   intent=name.icc,
   level=compresslevel, % default 3
   file=optional specification file,
   option=always|never]


The two parameter format and intent are sufficient for most cases.

The format parameter simply defines the PDF/X version, while the intent parameter sets the so called output intent.

Currently the following PDF/X versions are supported:

format =

                                               gray  rgb  cmyk  spot  transp. notes
PDF/X-1a:2001  % PDF Version 1.3 (Acrobat 4.x) *          *     *     
PDF/X-1a:2003  % PDF Version 1.4 (Acrobat 5.x) *          *     *     
PDF/X-3:2002   % PDF Version 1.3 (Acrobat 4.x) *     *    *     *
PDF/X-3:2003   % PDF Version 1.4 (Acrobat 5.x) *     *    *     * 
PDF/X-4        % PDF Version 1.6 (Acrobat 7.x) *     *    *     *     *    PDF layers
PDF/X-4p       % PDF Version 1.6 (Acrobat 7.x) *     *    *     *     *    PDF layers; ICC externally supplied
PDF/X-5g       % PDF Version 1.6 (Acrobat 7.x) *     *    *     *     *    PDF layers; graphics can be outside pdf
PDF/X-5n       % PDF Version 1.6 (Acrobat 7.x) *     *    *     *     *    PDF layers; ICC externally supplied
PDF/X-5pg      % PDF Version 1.6 (Acrobat 7.x) *     *    *     *     *    PDF layers; p + g
  • PDF/X-1 uses device dependent colors, i.e. your pictures must be converted into the output color space (gray or CMYK).
  • PDF/X-3+ uses device independent colors, i.e. the color space of your pictures doesn’t matter, but it must be defined by a color profile.
  • It makes no sense to use CMYK pictures with PDF/X-3+, because color conversions between CMYK profiles are more lossy than any RGB-to-CMYK conversion!
  • It makes sense to use PDF/X-1a:2003 for bw printing.
  • Even if they’re allowed in X/4+, don’t use PDF layers for print projects – your printshop will not be able to handle them.

Predefined output intents:

intent =

   Coated FOGRA39 (ISO 12647-2:2004)
   GRACoL2006_Coated1v2.icc
   ISO Coated v2 300% (ECI)
   ISO Coated v2 (ECI)
   ISOnewspaper26v4
   ISOnewspaper26v4_gr
   ISO Uncoated
   ISO Uncoated Yellowish
   ISO Web Coated
   Japan Color 2001 Coated
   Japan Color 2002 Newspaper
   Japan Web Coated (Ad)
   SNAP 2007
   SWOP2006_Coated3v2.icc
   SWOP2006_Coated5v2.icc
   Uncoated FOGRA29 (ISO 12647-2:2004)
   Web Coated FOGRA28 (ISO 12647-2:2004)
   PSR_LWC_PLUS_V2_PT
   PSR_LWC_STD_V2_PT
   PSR_SC_PLUS_V2_PT
   PSR_SC_STD_V2_PT
   PSRgravureMF

Which one to use?

  • In Europe, use FOGRA profiles.
  • In the USA, use SWOP profiles.
  • In Japan, use Japan profiles.
  • Use Coated for image printing paper.
  • Use Uncoated for natural paper (e.g. "offset").
  • "Web" means "web offset", i.e. big volume printing from a roll of paper (vs. sheet paper).


Some examples:

\setupbackend
  [format=PDF/X-1a:2001,
   intent=SWOP2006_Coated3v2.icc]

or

\setupbackend
  [format=PDF/X-4,
   intent={ISO Coated v2 300\letterpercent\space (ECI)}]


All remaining parameter are kind of special.

profile sets the ICC based default color space profile (option for color management); this setting is document wide and currently only one profile per color space is allowed

level sets the PDF compress level (values of 0..9 are allowed). Normally no need to change the default value.

option=always|never

   always: force embedding of the output intent profile (useful only in case of PDF/X-1a)
   never : don't embed the output intent profile; no useful practise

file name of an external file with predefined color profiles

ICC profiles

The predefined color profiles can be found in .../<context-path>/colors/icc/context/colorprofiles.xml|.lua.

This list contains the profiles recommended by the GWG (Ghent PDF Workgroup) in 2008, the set of profiles bundled with ghostscript and three test only profiles from the ICC (International Color Consortium).

Ghent PDF Workgroup (GWG) recommendations:

There are a few contradictions to the PDF/X standards (by PDF Association) to assure a better quality, see the article by Stephan Jaeggi.

Nearly all predefined ICC profiles are also available in the download section. Output intents are bound to very specific printing conditions (which vary worldwide), so it’s very likely that you only need one or two ICC profiles (and not all of them). Therefore the profile ZIPs come in 'localized' versions.

GWG recommend ICC profiles (complete) (Europe) (India) (Japan) (USA)

Probe profiles (external link): here

Ghostscript profiles: here

All predefined profiles in one zip file


Profile installation:

The profiles are normally stored under

   .../<context-path>/colors/icc/profiles

All profiles in the zip archive are already located in the correct sub path, so you only have to unpack them right in your ConTeXt directory (normally texmf-context).

In case you use these profiles also with other software, it is possible to share them with ConTeXt. Simply set the environment variable $ICCPROFILES to that special software related directory.

E.g. for Adobe Acrobat on Windows Vista this special directory is

   C:\Program Files (X86)\Common Files\Adobe\Color\Profiles\Recommended

Store the needed profiles there (without any TeX directory) and set $ICCPROFILES to that path.

On MacOS use ~/Library/ColorSync/Profiles for your own profiles; the following setup makes sense in .bashrc or .profile:

   export ICCPROFILES="~/Library/ColorSync/Profiles//:/System/Library/ColorSync/Profiles//:/Library/Application Support/Adobe/Color/Profiles//:"
   # /Library/ColorSync/Profiles// doesn’t contain anything useful

The double slashes at the end mean “all subdirectories”.

All you need now is a final mtxrun --generate to update the file database.

In case of problems you should add

\enabletrackers[backend.pdfx]

\setupbackend[...

right in front of \setupbackend to get all possible debugging info.

And that’s it for the moment...