Options

From PDF XChange PDF SDK
Jump to: navigation, search
(Mono Table)
 
(38 intermediate revisions by 2 users not shown)
Line 2: Line 2:
 
{{#customTitle:Options}}
 
{{#customTitle:Options}}
 
{{#parentPage:PXV:op_document_optimize|Options|property}}
 
{{#parentPage:PXV:op_document_optimize|Options|property}}
{{ToWrite}}
 
 
{{ToReview}}
 
{{ToReview}}
  
Line 22: Line 21:
 
| class="op_param_name" | [[#Transparency|Transparency]]
 
| class="op_param_name" | [[#Transparency|Transparency]]
 
| style="text-align:center" | Dictionary
 
| style="text-align:center" | Dictionary
| Don't used yet.
+
| Not yet implemented.
 
|-
 
|-
 
| class="op_param_name" | [[#DiscardObjects|DiscardObjects]]
 
| class="op_param_name" | [[#DiscardObjects|DiscardObjects]]
Line 41: Line 40:
 
For receive a valid value use conctruction  
 
For receive a valid value use conctruction  
  
val = (DWORD)(((major) << 16) | ((minor) & 0xFFFF)
+
<tt>'''val = ((major) << 16) | ((minor) & 0xFFFF)'''</tt>
  
(for example version 1.7 = (DWORD)(((1) << 16) | ((7) & 0xFFFF))  
+
(for example version 1.7 = ((1) << 16) | ((7) & 0xFFFF)  
  
 
If you want to leave current version set this parameter to 0.
 
If you want to leave current version set this parameter to 0.
 +
 +
We recommend to use higher or the same version of original document.
  
 
Default value: <tt>'''0'''</tt>
 
Default value: <tt>'''0'''</tt>
Line 51: Line 52:
 
| class="op_param_name" | PresetID
 
| class="op_param_name" | PresetID
 
| style="text-align:center" | String
 
| style="text-align:center" | String
| Specifies...
+
| Specifies an unique identifier of special preset of options that exists in Editor's settings. End-user may create multiple presets for different operations to enhance convenience of using. If specified preset already exists then operation will use preset's options to show dialog or perform its work.
 
Default value: <tt>'''Empty String'''</tt>
 
Default value: <tt>'''Empty String'''</tt>
 
|-
 
|-
Line 73: Line 74:
 
| class="op_param_name" | Enabled
 
| class="op_param_name" | Enabled
 
| style="text-align:center" | Boolean
 
| style="text-align:center" | Boolean
| Specifies...
+
| If <tt>'''Enabled == false'''</tt> then optimize will not be use for images.
 
Default value: <tt>'''true'''</tt>
 
Default value: <tt>'''true'''</tt>
 
|-
 
|-
 
| class="op_param_name" | ReducedOnly
 
| class="op_param_name" | ReducedOnly
 
| style="text-align:center" | Boolean
 
| style="text-align:center" | Boolean
| Specifies...
+
| If <tt>'''ReducedOnly == true'''</tt> then optimize images only if there is reduction in size.
 
Default value: <tt>'''true'''</tt>
 
Default value: <tt>'''true'''</tt>
 
|-
 
|-
 
| class="op_param_name" | [[#Scale|Scale]]
 
| class="op_param_name" | [[#Scale|Scale]]
 
| style="text-align:center" | Dictionary
 
| style="text-align:center" | Dictionary
| Specifies...
+
| Specifies parameters for scaling images.
 
|-
 
|-
 
| class="op_param_name" | [[#Comp|Comp]]
 
| class="op_param_name" | [[#Comp|Comp]]
 
| style="text-align:center" | Dictionary
 
| style="text-align:center" | Dictionary
| Specifies...
+
| Specifies parameters for compressing images.
 
|}
 
|}
  
Line 97: Line 98:
 
! '''Value'''
 
! '''Value'''
 
|-
 
|-
| class="op_param_name" | [[#Color|Color]]
+
| class="op_param_name" | [[#ColorScale|Color]]
 
| style="text-align:center" | Dictionary
 
| style="text-align:center" | Dictionary
| Specifies...
+
| Specifies parameters for scaling fullcolor images.
 
|-
 
|-
| class="op_param_name" | [[#Grayscale|Grayscale]]
+
| class="op_param_name" | [[#GrayscaleScale|Grayscale]]
 
| style="text-align:center" | Dictionary
 
| style="text-align:center" | Dictionary
| Specifies...
+
| Specifies parameters for scaling grayscale images.
 
|-
 
|-
| class="op_param_name" | [[#Indexed|Indexed]]
+
| class="op_param_name" | [[#IndexedScale|Indexed]]
 
| style="text-align:center" | Dictionary
 
| style="text-align:center" | Dictionary
| Specifies...
+
| Specifies parameters for scaling images with indexed palette.
 
|-
 
|-
| class="op_param_name" | [[#Mono|Mono]]
+
| class="op_param_name" | [[#MonoScale|Mono]]
 
| style="text-align:center" | Dictionary
 
| style="text-align:center" | Dictionary
| Specifies...
+
| Specifies parameters for scaling monochrome images (1bit color).
 
|}
 
|}
  
== Color Table ==
+
== Color Table(Scale) ==
  
{| class="wikitable op_options" id="Color"
+
{| class="wikitable op_options" id="ColorScale"
 
! style="width:120pt;" | '''Name'''
 
! style="width:120pt;" | '''Name'''
 
! style="width:60pt;" | '''Type'''
 
! style="width:60pt;" | '''Type'''
Line 123: Line 124:
 
| class="op_param_name" | Method
 
| class="op_param_name" | Method
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| Specifies a method which will be used for downsampling fullcolor images.
 +
 
 +
Valid values are:
 +
 
 +
<tt>'''0- No downsampling'''</tt>
 +
 
 +
<tt>'''1- Average downsampling'''</tt>
 +
 
 +
<tt>'''2- Subsampling'''</tt>
 +
 
 +
<tt>'''3- Bicubic downsampling'''</tt>
 +
 
 
Default value: <tt>'''3'''</tt>
 
Default value: <tt>'''3'''</tt>
 
|-
 
|-
 
| class="op_param_name" | To
 
| class="op_param_name" | To
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| Specifies DPI for resulting images.
 
Default value: <tt>'''150'''</tt>
 
Default value: <tt>'''150'''</tt>
 
|-
 
|-
 
| class="op_param_name" | IfAbove
 
| class="op_param_name" | IfAbove
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| All fullcolor images with DPI above this value will be optimized.
 
Default value: <tt>'''225'''</tt>
 
Default value: <tt>'''225'''</tt>
 
|}
 
|}
  
== Grayscale Table ==
+
== Grayscale Table (Scale) ==
  
{| class="wikitable op_options" id="Grayscale"
+
{| class="wikitable op_options" id="GrayscaleScale"
 
! style="width:120pt;" | '''Name'''
 
! style="width:120pt;" | '''Name'''
 
! style="width:60pt;" | '''Type'''
 
! style="width:60pt;" | '''Type'''
Line 146: Line 158:
 
| class="op_param_name" | Method
 
| class="op_param_name" | Method
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| Specifies a method which will be used for downsampling grayscale images.
 +
 
 +
Valid values are:
 +
 
 +
<tt>'''0- No downsampling'''</tt>
 +
 
 +
<tt>'''1- Average downsampling'''</tt>
 +
 
 +
<tt>'''2- Subsampling'''</tt>
 +
 
 +
<tt>'''3- Bicubic downsampling'''</tt>
 +
 
 
Default value: <tt>'''3'''</tt>
 
Default value: <tt>'''3'''</tt>
 
|-
 
|-
 
| class="op_param_name" | To
 
| class="op_param_name" | To
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| Specifies DPI for resulting images.
 
Default value: <tt>'''150'''</tt>
 
Default value: <tt>'''150'''</tt>
 
|-
 
|-
 
| class="op_param_name" | IfAbove
 
| class="op_param_name" | IfAbove
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| All grayscale images with DPI above this value will be optimized.
 
Default value: <tt>'''225'''</tt>
 
Default value: <tt>'''225'''</tt>
 
|}
 
|}
  
== Indexed Table ==
+
== Indexed Table (Scale) ==
  
{| class="wikitable op_options" id="Indexed"
+
{| class="wikitable op_options" id="IndexedScale"
 
! style="width:120pt;" | '''Name'''
 
! style="width:120pt;" | '''Name'''
 
! style="width:60pt;" | '''Type'''
 
! style="width:60pt;" | '''Type'''
Line 169: Line 192:
 
| class="op_param_name" | Method
 
| class="op_param_name" | Method
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| Specifies a method which will be used for downsampling images with indexed palette.
 +
 
 +
Valid values are:
 +
 
 +
<tt>'''0- No downsampling'''</tt>
 +
 
 +
<tt>'''1- Subsampling'''</tt>
 +
 
 
Default value: <tt>'''1'''</tt>
 
Default value: <tt>'''1'''</tt>
 
|-
 
|-
 
| class="op_param_name" | To
 
| class="op_param_name" | To
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| Specifies DPI for resulting images.
 
Default value: <tt>'''150'''</tt>
 
Default value: <tt>'''150'''</tt>
 
|-
 
|-
 
| class="op_param_name" | IfAbove
 
| class="op_param_name" | IfAbove
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| All images with indexed palette with DPI above this value will be optimized.
 
Default value: <tt>'''225'''</tt>
 
Default value: <tt>'''225'''</tt>
 
|}
 
|}
  
== Mono Table ==
+
== Mono Table (Scale) ==
  
{| class="wikitable op_options" id="Mono"
+
{| class="wikitable op_options" id="MonoScale"
 
! style="width:120pt;" | '''Name'''
 
! style="width:120pt;" | '''Name'''
 
! style="width:60pt;" | '''Type'''
 
! style="width:60pt;" | '''Type'''
Line 192: Line 222:
 
| class="op_param_name" | Method
 
| class="op_param_name" | Method
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| Specifies a method which will be used for downsampling monochrome images (1bit color).
 +
 
 +
Valid values are:
 +
 
 +
<tt>'''0- No downsampling'''</tt>
 +
 
 +
<tt>'''1- Average downsampling'''</tt>
 +
 
 +
<tt>'''2- Subsampling'''</tt>
 +
 
 +
<tt>'''3- Bicubic downsampling'''</tt>
 +
 
 
Default value: <tt>'''3'''</tt>
 
Default value: <tt>'''3'''</tt>
 
|-
 
|-
 
| class="op_param_name" | To
 
| class="op_param_name" | To
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| Specifies DPI for resulting images.
 
Default value: <tt>'''300'''</tt>
 
Default value: <tt>'''300'''</tt>
 
|-
 
|-
 
| class="op_param_name" | IfAbove
 
| class="op_param_name" | IfAbove
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| All monochrome images with DPI above this value will be optimized.
 
Default value: <tt>'''450'''</tt>
 
Default value: <tt>'''450'''</tt>
 
|}
 
|}
Line 213: Line 254:
 
! '''Value'''
 
! '''Value'''
 
|-
 
|-
| class="op_param_name" | [[#Color|Color]]
+
| class="op_param_name" | [[#ColorComp|Color]]
 
| style="text-align:center" | Dictionary
 
| style="text-align:center" | Dictionary
| Specifies...
+
| Specifies parameters for compressing fullcolor images.
 
|-
 
|-
| class="op_param_name" | [[#Grayscale|Grayscale]]
+
| class="op_param_name" | [[#GrayscaleComp|Grayscale]]
 
| style="text-align:center" | Dictionary
 
| style="text-align:center" | Dictionary
| Specifies...
+
| Specifies parameters for compressing grayscale images.
 
|-
 
|-
| class="op_param_name" | [[#Indexed|Indexed]]
+
| class="op_param_name" | [[#IndexedComp|Indexed]]
 
| style="text-align:center" | Dictionary
 
| style="text-align:center" | Dictionary
| Specifies...
+
| Specifies parameters for compressing images with indexed palette.
 
|-
 
|-
| class="op_param_name" | [[#Mono|Mono]]
+
| class="op_param_name" | [[#MonoComp|Mono]]
 
| style="text-align:center" | Dictionary
 
| style="text-align:center" | Dictionary
| Specifies...
+
| Specifies parameters for compressing monochome images (1bit color).
 
|}
 
|}
  
== Color Table ==
+
== Color Table (Comp) ==
  
{| class="wikitable op_options" id="Color"
+
{| class="wikitable op_options" id="ColorComp"
 
! style="width:120pt;" | '''Name'''
 
! style="width:120pt;" | '''Name'''
 
! style="width:60pt;" | '''Type'''
 
! style="width:60pt;" | '''Type'''
Line 239: Line 280:
 
| class="op_param_name" | Method
 
| class="op_param_name" | Method
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| Specifies a method which will be used for compressing fullcolor images.
 +
 
 +
Valid values are:
 +
 
 +
<tt>'''0- Retain existing'''</tt>
 +
 
 +
<tt>'''1- JPEG2000'''</tt>
 +
 
 +
<tt>'''2- JPEG'''</tt>
 +
 
 +
<tt>'''3- ZIP'''</tt>
 +
 
 
Default value: <tt>'''2'''</tt>
 
Default value: <tt>'''2'''</tt>
 
|-
 
|-
 
| class="op_param_name" | JPEGQuality
 
| class="op_param_name" | JPEGQuality
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| Used if JPEG or JPEG2000 compression method selected.
 +
 
 +
Valid values are:
 +
 
 +
<tt>'''0= Minimum'''</tt>
 +
 
 +
<tt>'''1= Low'''</tt>
 +
 
 +
<tt>'''2= Medium'''</tt>
 +
 
 +
<tt>'''3= High'''</tt>
 +
 
 +
<tt>'''4= Maximum'''</tt>
 +
 
 +
<tt>'''5= Lossless'''</tt> (only for JPEG2000)
 +
 
 
Default value: <tt>'''2'''</tt>
 
Default value: <tt>'''2'''</tt>
 
|-
 
|-
 
| class="op_param_name" | JPEG2000Tile
 
| class="op_param_name" | JPEG2000Tile
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| Don't used.  
 
Default value: <tt>'''256'''</tt>
 
Default value: <tt>'''256'''</tt>
 
|}
 
|}
  
== Grayscale Table ==
+
== Grayscale Table (Comp) ==
  
{| class="wikitable op_options" id="Grayscale"
+
{| class="wikitable op_options" id="GrayscaleComp"
 
! style="width:120pt;" | '''Name'''
 
! style="width:120pt;" | '''Name'''
 
! style="width:60pt;" | '''Type'''
 
! style="width:60pt;" | '''Type'''
Line 262: Line 329:
 
| class="op_param_name" | Method
 
| class="op_param_name" | Method
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| Specifies a method which will be used for compressing grayscale images.
 +
 
 +
Valid values are:
 +
 
 +
<tt>'''0- Retain existing'''</tt>
 +
 
 +
<tt>'''1- JPEG2000'''</tt>
 +
 
 +
<tt>'''2- JPEG'''</tt>
 +
 
 +
<tt>'''3- ZIP'''</tt>
 +
 
 
Default value: <tt>'''2'''</tt>
 
Default value: <tt>'''2'''</tt>
 
|-
 
|-
 
| class="op_param_name" | JPEGQuality
 
| class="op_param_name" | JPEGQuality
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| | Used if JPEG or JPEG2000 compression method selected.
 +
 
 +
Valid values are:
 +
 
 +
<tt>'''0= Minimum'''</tt>
 +
 
 +
<tt>'''1= Low'''</tt>
 +
 
 +
<tt>'''2= Medium'''</tt>
 +
 
 +
<tt>'''3= High'''</tt>
 +
 
 +
<tt>'''4= Maximum'''</tt>
 +
 
 +
<tt>'''5= Lossless'''</tt> (only for JPEG2000)
 +
 
 
Default value: <tt>'''2'''</tt>
 
Default value: <tt>'''2'''</tt>
 
|-
 
|-
 
| class="op_param_name" | JPEG2000Tile
 
| class="op_param_name" | JPEG2000Tile
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| Don't used.  
 
Default value: <tt>'''256'''</tt>
 
Default value: <tt>'''256'''</tt>
 
|}
 
|}
  
== Indexed Table ==
+
== Indexed Table (Comp) ==
  
{| class="wikitable op_options" id="Indexed"
+
{| class="wikitable op_options" id="IndexedComp"
 
! style="width:120pt;" | '''Name'''
 
! style="width:120pt;" | '''Name'''
 
! style="width:60pt;" | '''Type'''
 
! style="width:60pt;" | '''Type'''
Line 285: Line 378:
 
| class="op_param_name" | Method
 
| class="op_param_name" | Method
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| Specifies a method which will be used for compressing images with indexed palette.
 +
 
 +
Valid values are:
 +
 
 +
<tt>'''0- Retain existing'''</tt>
 +
 
 +
<tt>'''1- ZIP'''</tt>
 +
 
 +
<tt>'''2- Run Length'''</tt>
 +
 
 +
<tt>'''3- LZW'''</tt>
 +
 
 
Default value: <tt>'''1'''</tt>
 
Default value: <tt>'''1'''</tt>
 
|}
 
|}
  
== Mono Table ==
+
== Mono Table (Comp) ==
  
{| class="wikitable op_options" id="Mono"
+
{| class="wikitable op_options" id="MonoComp"
 
! style="width:120pt;" | '''Name'''
 
! style="width:120pt;" | '''Name'''
 
! style="width:60pt;" | '''Type'''
 
! style="width:60pt;" | '''Type'''
Line 298: Line 402:
 
| class="op_param_name" | Method
 
| class="op_param_name" | Method
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| Specifies a method which will be used for compressing monochrome images.
 +
 
 +
Valid values are:
 +
 
 +
<tt>'''0- Retain existing'''</tt>
 +
 
 +
<tt>'''1- JBIG2'''</tt>
 +
 
 +
<tt>'''2- CCIT Croup 3'''</tt>
 +
 
 +
<tt>'''3- CCIT Croup 4'''</tt>
 +
 
 +
<tt>'''4- ZIP'''</tt>
 +
 
 +
<tt>'''5- Run Length'''</tt>
 +
 
 
Default value: <tt>'''1'''</tt>
 
Default value: <tt>'''1'''</tt>
 
|-
 
|-
 
| class="op_param_name" | JBIG2Quality
 
| class="op_param_name" | JBIG2Quality
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| Don't used.
 
Default value: <tt>'''0'''</tt>
 
Default value: <tt>'''0'''</tt>
 
|}
 
|}
Line 316: Line 435:
 
| class="op_param_name" | Enabled
 
| class="op_param_name" | Enabled
 
| style="text-align:center" | Boolean
 
| style="text-align:center" | Boolean
| Specifies...
+
| If <tt>'''Enabled == false'''</tt> then optimize will not be use for fonts.
 
Default value: <tt>'''true'''</tt>
 
Default value: <tt>'''true'''</tt>
 
|-
 
|-
 
| class="op_param_name" | NotUnembed
 
| class="op_param_name" | NotUnembed
 
| style="text-align:center" | Boolean
 
| style="text-align:center" | Boolean
| Specifies...
+
| For 5.5(Build 316.1) or early version only.
 +
 
 +
Is unavailable in newest version.
 +
 
 +
If <tt>'''true'''</tt> then do not unembed any font.
 +
 
 +
If <tt>'''false'''</tt> then unembed fonts listed in [[#UnembedFonts|UnembedFonts]] list.
 +
 
 +
If UnembedFonts list is empty and this value is  <tt>'''false'''</tt> then unembed recommendable fonts.
 +
 
 
Default value: <tt>'''false'''</tt>
 
Default value: <tt>'''false'''</tt>
 +
|-
 +
| class="op_param_name" | UnembedType
 +
| style="text-align:center" | Integer
 +
| Specified a way for unembedding fonts.
 +
 +
<tt>'''0 - do not unembed any font.'''</tt>
 +
 +
<tt>'''1 - unembed recommendable fonts only.'''</tt>
 +
 +
<tt>'''2 - unembed all fonts.'''</tt>
 +
 +
<tt>'''3 - unembed fonts listed in [[#UnembedFonts|UnembedFonts]] list.'''</tt>
 +
 +
Unavailable in old version.
 +
 +
Default value: <tt>'''1'''</tt>
 
|-
 
|-
 
| class="op_param_name" | SubsetAll
 
| class="op_param_name" | SubsetAll
 
| style="text-align:center" | Boolean
 
| style="text-align:center" | Boolean
| Specifies...
+
| Don`t used.
 
Default value: <tt>'''true'''</tt>
 
Default value: <tt>'''true'''</tt>
 
|-
 
|-
 
| class="op_param_name" | MergeSubsets
 
| class="op_param_name" | MergeSubsets
 
| style="text-align:center" | Boolean
 
| style="text-align:center" | Boolean
| Specifies...
+
| If  <tt>'''true'''</tt> then all font`s subsets will be merged.
 
Default value: <tt>'''true'''</tt>
 
Default value: <tt>'''true'''</tt>
 
|-
 
|-
 
| class="op_param_name" | UnembedFonts
 
| class="op_param_name" | UnembedFonts
 
| style="text-align:center" | Array
 
| style="text-align:center" | Array
| Array of <tt>'''[[#UnembedFonts|Dictionary]]'''</tt>
+
| Array of <tt>'''[[#UnembedFonts|Dictionary(UnembedFonts)]]'''</tt>
Specifies...
+
Specifies an array of fonts which will be unembeded.
 +
 
 +
Take effect if <tt>'''UnembedType=3'''</tt> only (or NotUnembed=false for old version).
 +
 
 +
Otherwise is ignored.  
 
|}
 
|}
  
Line 349: Line 497:
 
| class="op_param_name" | FontObjNom
 
| class="op_param_name" | FontObjNom
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| Specifies a font handle from document.
 
Default value: <tt>'''0'''</tt>
 
Default value: <tt>'''0'''</tt>
 
|-
 
|-
 
| class="op_param_name" | FontName
 
| class="op_param_name" | FontName
 
| style="text-align:center" | String
 
| style="text-align:center" | String
| Specifies...
+
| Specifies a font name.
 
Default value: <tt>'''Empty String'''</tt>
 
Default value: <tt>'''Empty String'''</tt>
 
|}
 
|}
  
== Transparency Table ==
+
== Transparency Table (Not yet implemented) ==
  
 
{| class="wikitable op_options" id="Transparency"
 
{| class="wikitable op_options" id="Transparency"
Line 445: Line 593:
 
| class="op_param_name" | Enabled
 
| class="op_param_name" | Enabled
 
| style="text-align:center" | Boolean
 
| style="text-align:center" | Boolean
| Specifies...
+
| Specifies if discard objects is enabled.
 
Default value: <tt>'''true'''</tt>
 
Default value: <tt>'''true'''</tt>
 
|-
 
|-
 
| class="op_param_name" | Flags
 
| class="op_param_name" | Flags
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| <tt>'''0x001 = Discard all form submission, import and reset actions'''</tt>
 +
 
 +
<tt>'''0x002 = not used'''</tt>
 +
 
 +
<tt>'''0x004 = Discard all JavaScript actions'''</tt>
 +
 
 +
<tt>'''0x008 = Discard all alternate images'''</tt>
 +
 
 +
<tt>'''0x010 = Discard embedded page thumbnails'''</tt>
 +
 
 +
<tt>'''0x020 = not used'''</tt>
 +
 
 +
<tt>'''0x040 = not used'''</tt>
 +
 
 +
<tt>'''0x080 = Detect and merge image fragments'''</tt>
 +
 
 +
<tt>'''0x100 = Discard embedded print setting'''</tt>
 +
 
 +
<tt>'''0x200 = not used'''</tt>
 +
 
 +
<tt>'''0x400 = Discard bookmarks'''</tt>
 +
 
 
Default value: <tt>'''8'''</tt>
 
Default value: <tt>'''8'''</tt>
 
|}
 
|}
Line 463: Line 632:
 
| class="op_param_name" | Enabled
 
| class="op_param_name" | Enabled
 
| style="text-align:center" | Boolean
 
| style="text-align:center" | Boolean
| Specifies...
+
| Specifies if discard user`s data is enabled.
 
Default value: <tt>'''true'''</tt>
 
Default value: <tt>'''true'''</tt>
 
|-
 
|-
 
| class="op_param_name" | Flags
 
| class="op_param_name" | Flags
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| <tt>'''0x001 = Discard all Comments, forms and multimedia'''</tt>
 +
 
 +
<tt>'''0x002 = Discard document information and metadata'''</tt>
 +
 
 +
<tt>'''0x004 = not used'''</tt>
 +
 
 +
<tt>'''0x008 = Discard file attachments'''</tt>
 +
 
 +
<tt>'''0x010 = Discard external cross references'''</tt>
 +
 
 +
<tt>'''0x020 = Discard private data of other applications'''</tt>
 +
 
 +
<tt>'''0x040 = Discard hidden layer content and flatten visible layers'''</tt>
 +
 
 
Default value: <tt>'''0'''</tt>
 
Default value: <tt>'''0'''</tt>
 
|}
 
|}
Line 481: Line 663:
 
| class="op_param_name" | Enabled
 
| class="op_param_name" | Enabled
 
| style="text-align:center" | Boolean
 
| style="text-align:center" | Boolean
| Specifies...
+
| Specifies if cleanup document is enabled.
 
Default value: <tt>'''true'''</tt>
 
Default value: <tt>'''true'''</tt>
 
|-
 
|-
 
| class="op_param_name" | CleanUpCompress
 
| class="op_param_name" | CleanUpCompress
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| Don't used.
 
Default value: <tt>'''0'''</tt>
 
Default value: <tt>'''0'''</tt>
 
|-
 
|-
 
| class="op_param_name" | Flags
 
| class="op_param_name" | Flags
 
| style="text-align:center" | Integer
 
| style="text-align:center" | Integer
| Specifies...
+
| <tt>'''0x001= Use Flate to encode streams that are not encoded'''</tt>
 +
 
 +
<tt>'''0x002= In streams that use LZW encoding use Flate instead'''</tt>
 +
 
 +
<tt>'''0x004= Discard invalid bookmarks'''</tt>
 +
 
 +
<tt>'''0x008= Discard invalid links'''</tt>
 +
 
 +
<tt>'''0x010= Discard unreferenced named destinations'''</tt>
 +
 
 +
<tt>'''0x020= not used'''</tt>
 +
 
 +
<tt>'''0x040= not used'''</tt>
 +
 
 +
<tt>'''0x080= Discard duplicates of Fonts'''</tt>
 +
 
 +
<tt>'''0x100= Discard duplicates of Images'''</tt>
 +
 
 +
<tt>'''0x200= Discard duplicates of XForms'''</tt>
 +
 
 +
<tt>'''0x400= Find and Remove the content outside of crop box'''</tt>
 +
 
 
Default value: <tt>'''1007'''</tt>
 
Default value: <tt>'''1007'''</tt>
 
|}
 
|}

Latest revision as of 05:49, 19 April 2016


Options Table

Name Type Value
Images Dictionary Specifies parameters for optimize images.
Fonts Dictionary Specifies parameters for optimize fonts.
Transparency Dictionary Not yet implemented.
DiscardObjects Dictionary Specifies parameters for discard objects.
DiscardUserData Dictionary Specifies parameters for discard user`s data.
CleanUp Dictionary Specifies parameters for cleanup document.
VersionForSave Integer Specifies a PDF document`s version wich will be used for save.

For receive a valid value use conctruction

val = ((major) << 16) | ((minor) & 0xFFFF)

(for example version 1.7 = ((1) << 16) | ((7) & 0xFFFF)

If you want to leave current version set this parameter to 0.

We recommend to use higher or the same version of original document.

Default value: 0

PresetID String Specifies an unique identifier of special preset of options that exists in Editor's settings. End-user may create multiple presets for different operations to enhance convenience of using. If specified preset already exists then operation will use preset's options to show dialog or perform its work.

Default value: Empty String

Progress IUnknown Specifies a object based on IProgressMon interface. This object realise progress bar for operation.
SubProgress Boolean Specifies whether the Progress is a top-level progress, or a part of another progress bar.

Default value: false

Images Table

Name Type Value
Enabled Boolean If Enabled == false then optimize will not be use for images.

Default value: true

ReducedOnly Boolean If ReducedOnly == true then optimize images only if there is reduction in size.

Default value: true

Scale Dictionary Specifies parameters for scaling images.
Comp Dictionary Specifies parameters for compressing images.

Scale Table

Name Type Value
Color Dictionary Specifies parameters for scaling fullcolor images.
Grayscale Dictionary Specifies parameters for scaling grayscale images.
Indexed Dictionary Specifies parameters for scaling images with indexed palette.
Mono Dictionary Specifies parameters for scaling monochrome images (1bit color).

Color Table(Scale)

Name Type Value
Method Integer Specifies a method which will be used for downsampling fullcolor images.

Valid values are:

0- No downsampling

1- Average downsampling

2- Subsampling

3- Bicubic downsampling

Default value: 3

To Integer Specifies DPI for resulting images.

Default value: 150

IfAbove Integer All fullcolor images with DPI above this value will be optimized.

Default value: 225

Grayscale Table (Scale)

Name Type Value
Method Integer Specifies a method which will be used for downsampling grayscale images.

Valid values are:

0- No downsampling

1- Average downsampling

2- Subsampling

3- Bicubic downsampling

Default value: 3

To Integer Specifies DPI for resulting images.

Default value: 150

IfAbove Integer All grayscale images with DPI above this value will be optimized.

Default value: 225

Indexed Table (Scale)

Name Type Value
Method Integer Specifies a method which will be used for downsampling images with indexed palette.

Valid values are:

0- No downsampling

1- Subsampling

Default value: 1

To Integer Specifies DPI for resulting images.

Default value: 150

IfAbove Integer All images with indexed palette with DPI above this value will be optimized.

Default value: 225

Mono Table (Scale)

Name Type Value
Method Integer Specifies a method which will be used for downsampling monochrome images (1bit color).

Valid values are:

0- No downsampling

1- Average downsampling

2- Subsampling

3- Bicubic downsampling

Default value: 3

To Integer Specifies DPI for resulting images.

Default value: 300

IfAbove Integer All monochrome images with DPI above this value will be optimized.

Default value: 450

Comp Table

Name Type Value
Color Dictionary Specifies parameters for compressing fullcolor images.
Grayscale Dictionary Specifies parameters for compressing grayscale images.
Indexed Dictionary Specifies parameters for compressing images with indexed palette.
Mono Dictionary Specifies parameters for compressing monochome images (1bit color).

Color Table (Comp)

Name Type Value
Method Integer Specifies a method which will be used for compressing fullcolor images.

Valid values are:

0- Retain existing

1- JPEG2000

2- JPEG

3- ZIP

Default value: 2

JPEGQuality Integer Used if JPEG or JPEG2000 compression method selected.

Valid values are:

0= Minimum

1= Low

2= Medium

3= High

4= Maximum

5= Lossless (only for JPEG2000)

Default value: 2

JPEG2000Tile Integer Don't used.

Default value: 256

Grayscale Table (Comp)

Name Type Value
Method Integer Specifies a method which will be used for compressing grayscale images.

Valid values are:

0- Retain existing

1- JPEG2000

2- JPEG

3- ZIP

Default value: 2

JPEGQuality Integer Used if JPEG or JPEG2000 compression method selected.

Valid values are:

0= Minimum

1= Low

2= Medium

3= High

4= Maximum

5= Lossless (only for JPEG2000)

Default value: 2

JPEG2000Tile Integer Don't used.

Default value: 256

Indexed Table (Comp)

Name Type Value
Method Integer Specifies a method which will be used for compressing images with indexed palette.

Valid values are:

0- Retain existing

1- ZIP

2- Run Length

3- LZW

Default value: 1

Mono Table (Comp)

Name Type Value
Method Integer Specifies a method which will be used for compressing monochrome images.

Valid values are:

0- Retain existing

1- JBIG2

2- CCIT Croup 3

3- CCIT Croup 4

4- ZIP

5- Run Length

Default value: 1

JBIG2Quality Integer Don't used.

Default value: 0

Fonts Table

Name Type Value
Enabled Boolean If Enabled == false then optimize will not be use for fonts.

Default value: true

NotUnembed Boolean For 5.5(Build 316.1) or early version only.

Is unavailable in newest version.

If true then do not unembed any font.

If false then unembed fonts listed in UnembedFonts list.

If UnembedFonts list is empty and this value is false then unembed recommendable fonts.

Default value: false

UnembedType Integer Specified a way for unembedding fonts.

0 - do not unembed any font.

1 - unembed recommendable fonts only.

2 - unembed all fonts.

3 - unembed fonts listed in UnembedFonts list.

Unavailable in old version.

Default value: 1

SubsetAll Boolean Don`t used.

Default value: true

MergeSubsets Boolean If true then all font`s subsets will be merged.

Default value: true

UnembedFonts Array Array of Dictionary(UnembedFonts)

Specifies an array of fonts which will be unembeded.

Take effect if UnembedType=3 only (or NotUnembed=false for old version).

Otherwise is ignored.

UnembedFonts Table

Name Type Value
FontObjNom Integer Specifies a font handle from document.

Default value: 0

FontName String Specifies a font name.

Default value: Empty String

Transparency Table (Not yet implemented)

Name Type Value
Enabled Boolean Specifies...

Default value: true

Quality Integer Specifies...

Default value: 2

LowTransLevel Integer Specifies...

Default value: 75

LowLineArtText Integer Specifies...

Default value: 288

LowGradientMeshes Integer Specifies...

Default value: 144

LowFlags Integer Specifies...

Default value: 10

MediumTransLevel Integer Specifies...

Default value: 75

MediumLineArtText Integer Specifies...

Default value: 300

MediumGradientMeshes Integer Specifies...

Default value: 150

MediumFlags Integer Specifies...

Default value: 14

HightTransLevel Integer Specifies...

Default value: 100

HightLineArtText Integer Specifies...

Default value: 1200

HightGradientMeshes Integer Specifies...

Default value: 300

HightFlags Integer Specifies...

Default value: 12

DiscardObjects Table

Name Type Value
Enabled Boolean Specifies if discard objects is enabled.

Default value: true

Flags Integer 0x001 = Discard all form submission, import and reset actions

0x002 = not used

0x004 = Discard all JavaScript actions

0x008 = Discard all alternate images

0x010 = Discard embedded page thumbnails

0x020 = not used

0x040 = not used

0x080 = Detect and merge image fragments

0x100 = Discard embedded print setting

0x200 = not used

0x400 = Discard bookmarks

Default value: 8

DiscardUserData Table

Name Type Value
Enabled Boolean Specifies if discard user`s data is enabled.

Default value: true

Flags Integer 0x001 = Discard all Comments, forms and multimedia

0x002 = Discard document information and metadata

0x004 = not used

0x008 = Discard file attachments

0x010 = Discard external cross references

0x020 = Discard private data of other applications

0x040 = Discard hidden layer content and flatten visible layers

Default value: 0

CleanUp Table

Name Type Value
Enabled Boolean Specifies if cleanup document is enabled.

Default value: true

CleanUpCompress Integer Don't used.

Default value: 0

Flags Integer 0x001= Use Flate to encode streams that are not encoded

0x002= In streams that use LZW encoding use Flate instead

0x004= Discard invalid bookmarks

0x008= Discard invalid links

0x010= Discard unreferenced named destinations

0x020= not used

0x040= not used

0x080= Discard duplicates of Fonts

0x100= Discard duplicates of Images

0x200= Discard duplicates of XForms

0x400= Find and Remove the content outside of crop box

Default value: 1007