Verwendung von QuickFix auf der Kommandozeile

Auf der Kommandozeile (CLI) bietet pdfToolbox die Möglichkeit ein QuickFix zu verwenden ohne das ganze pdfToolbox Executable aufzurufen, stattdessen wird von der pdfToolbox nur der Teil geladen und ausgeführt, der das QuickFix verwendet. Dies hat zu Folge eine kürzere Ladezeit. Zusätzlich beim zusammenspiel mit mehreren müssen keine Daten kopiert oder neugeschrieben werden, dies reduziert wiederum die Verarbeitungszeit

Im einfachsten Fall, würde ein Aufruf auf der Kommandozeile wie folgt aussehen:

./pdfToolbox --quickfix my_quickfix_config.json my_pdf_file.pdf

Verwenden Sie ./pdfToolbox --help quickfix auf der Kommandozeile für mehr Informationen (dabei sind alle Parameter für quickfix generische für pdfToolbox Parameter und nicht specific to QuickFixes).

Der zweite Parameter – genannt my_pdf_file.pdf in dem Beipsiel – gibt die Eingabe-PDF an welche verarbeitet werden soll. Es ist beabsichtigtin diesem Beispiel, dass keine Ausgabedatei angegeben ist. Stattdessen wird die Eingabedatei verändert (in Form eines inkrementellen Updates). Dies garantiert die schnellstmöglichste Ausführung. Wenn eine Ausgabedatei angegeben ist, Wird die Eingangsdatei zunächst zum Zielort kopiert und dann wird die Kopie 'am Ort' verarbeitet.

Der erste Parameter – genannt my_quickfix_config.json in dem Beispiel, enthält einen JSON_Ausdruck und definiert den QuickFix-Befehl die übermittelt werden. Die Syntax für jedes QuickFix-Feature ist in folgendem Artikel beschrieben: QuickFix features.

Verwenden von "Profilausführung protokollieren" um eine JSON-Representation eines QuickFixes in pdfToolbox Desktop aufzunehmen

Die einfachste Art eine QuickFix-Konfigurationsdatei zu erzeugen als JSON-Ausdruck ist einen Prozessplan zu erstellen mit einem QuickFix-Schritt in pdfToolbox Desktop. Bei ausführen dieses Prozessplanes mit aktivierter "Profilausführung protokollieren", wird die Log-Ausgabe auch die QuickFix-Definition als JSON-datei enthalten:

Verwendung eines Code Beispieles

Eine weitere Option ist eine QuickFix-Konfigurationsdatei zu erstellen, um diese wie im darunter angezeigten Code-Block verwenden und nach Bedarf jederzeit bearbeiten und anpassen zu können, wenn erforderlich.

JSON Code Beispiele mit Erklärungen für alle QuickFix-Features

<p>{
	"quickfixes": [
// "rename_spot"
//		"operator": "regex|begins_with|contains|does_not_begin_with|does_not_contain|does_not_end_with|ends_with|equal_to|is_contained_in|is_not_contained_in|unequal_to"
//		"old_spot":<text>
//		"new_spot":<text>
		{
			"quickfix": "rename_spot",
			"version": 1.0,
			"instructions": [
				{
					"operator": "regex",
					"old_spot": ".*",
					"new_spot": "Prefix_$0"
				}
			]
		},
// "adjust_spot"
//		"operator": "regex|begins_with|contains|does_not_begin_with|does_not_contain|does_not_end_with|ends_with|equal_to|is_contained_in|is_not_contained_in|unequal_to"
//		"old_spot":<text>
//		"new_spot":<text>
//		"alt": "DeviceGray|DeviceRGB|DeviceCMYK|Lab_D50|Lab_D65|sRGB|<icc-profil-file-path>"
//		"c0":<number>
//		"c1":<number>
//		"c2":<number>
//		"c3":<number>
		{
			"quickfix": "adjust_spot",
			"version": 1.0,
			"instructions": [
				{
					"operator": "equal_to",
					"old_spot": "Pantone 101 C alt",
					"new_spot": "Cyan",
					"alt": "DeviceCMYK",
					"c0": 1.0,
					"c1": 0,
					"c2": 0,
					"c3": 0
				}
			]
		},
// "merge_spot"
//		"operator1": "regex|begins_with|contains|does_not_begin_with|does_not_contain|does_not_end_with|ends_with|equal_to|is_contained_in|is_not_contained_in|unequal_to"
//		"master_spot":<text>
//		"operator2": "regex|begins_with|contains|does_not_begin_with|does_not_contain|does_not_end_with|ends_with|equal_to|is_contained_in|is_not_contained_in|unequal_to"
//		"slave_spot":<text>
		{
			"quickfix": "merge_spot",
			"version": 1.0,
			"instructions": [
				{
					"operator1": "equal_to",
					"master_spot": "Orange",
					"operator2": "equal_to",
					"slave_spot": "PANTONE 485 CVC"
				}
			]
		},
// "adjust_pages_tree"
//		"pages_size": <integer>"
		{
			"quickfix": "adjust_pages_tree",
			"version": 1.0,
			"instructions": [
				{
					"pages_size": 100
				}
			]
		},
// "remove_page_box"
//		"page_selector": "all|even|odd|<splitscheme_expression>"
//		"which_box": "CropBox|BleedBox|TrimBox|ArtBox"
		{
			"quickfix": "remove_page_box",
			"version": 1.0,
			"instructions": [
				{
					"page_selector": "even",
					"which_box": "BleedBox"
				},
				{
					"page_selector": "odd",
					"which_box": "TrimBox"
				}
			]
		},
// "set_mediabox_to_origin"
//		"page_selector": "all|even|odd|<splitscheme_expression>"
		{
			"quickfix": "set_mediabox_to_origin",
			"version": 1.0,
			"instructions": [
				{
					"page_selector": "all"
				}
			]
		},
// "apply_rotate_key"
//		"page_selector": "all|even|odd|<splitscheme_expression>"
		{
			"quickfix": "apply_rotate_key",
			"version": 1.0,
			"instructions": [
				{
					"page_selector": "all"
				}
			]
		},
// "set_page_box"
//		"page_selector": "all|even|odd|<splitscheme_expression>"
//		"which_box": "CropBox|BleedBox|TrimBox|ArtBox"
//		"from_box_or_absolute": "CropBox|BleedBox|TrimBox|ArtBox|absolute"
//		"left": <number>
//		"bottom": <number>
//		"right": <number>
//		"top": <number>
//		"unit": "pt|mm|inch"
//		"when": "always|if_missing"
		{
			"quickfix": "set_page_box",
			"version": 1.0,
			"instructions": [
				{
					"page_selector": "all",
					"which_box": "TrimBox",
					"from_box_or_absolute": "BleedBox",
					"left": -100,
					"bottom": -100,
					"right": -100,
					"top": -100,
					"unit": "pt",
					"when": "always"
				}
			]
		},
// "set_page_box_by_dimensions"
//		"page_selector": "all|even|odd|<splitscheme_expression>"
//		"which_box": "CropBox|BleedBox|TrimBox|ArtBox"
//		"relative_to": "lower_left_corner|left_center|upper_left_corner|top_center|lower_right_corner|right_center|upper_right_corner|upper_right_corner|bottom_center|center"
//		"from_box_or_origin": "CropBox|BleedBox|TrimBox|ArtBox|origin"
//		"hor_offset": <number>
//		"vert_offset": <number>
//		"width": <number>
//		"width_is_relative": true|false
//		"height": <number>
//		"height_is_relative": true|false
//		"unit": "pt|mm|inch"
//		"when": "always|if_missing"
		{
			"quickfix": "set_page_box_by_dimensions",
			"version": 1.0,
			"instructions": [
				{
					"page_selector": "all",
					"which_box": "TrimBox",
					"relative_to": "center",
					"from_box_or_origin": "BleedBox",
					"hor_offset": 0,
					"vert_offset": 0,
					"width": 50,
					"width_is_relative": true,
					"height": 20,
					"height_is_relative": true,
					"unit": "pt",
					"when": "always"
				}
			]
		},
// "scale_pages"
//		"page_selector": "all|even|odd|<splitscheme_expression>"
//		"short_edge": <number>
//		"long_edge": <number>
//		"unit": "percent|pt|mm|inch"
//		"page_scale_mode": "fit_from_inside_add_white_space|fit_from_inside_scale_page_edge_proportionally|fit_from_outside_cut_page|fit_from_outside_scale_page_edge_proportionally|stretch_to_fill"
		{
			"quickfix": "scale_pages",
			"version": "1.0",
			"instructions": [
				{
					"page_selector": "all",
					"short_edge": 100,
					"long_edge": 80,
					"unit": "mm",
					"page_scale_mode": "fit_from_inside_add_white_space"
				}
			]
		},
// "enlarge_pages"
//		"page_selector": "all|even|odd|<splitscheme_expression>"
//		"which_edges": "left|bottom|right|top|left_and_right|top_and_bottom|all"
//		"enlarge_by": <number>
//		"unit": "pt|mm|inch"
		{
			"quickfix": "enlarge_pages",
			"version": "1.0",
			"instructions": [
				{
					"page_selector": "all",
					"which_edges": "all",
					"enlarge_by": 10,
					"unit": "mm"
				}
			]
		},
// "scale_page_content_only"
//		"page_selector": "all|even|odd|<splitscheme_expression>"
//		"relative_to": "lower_left_corner|left_center|upper_left_corner|top_center|lower_right_corner|right_center|upper_right_corner|upper_right_corner|bottom_center|center"
//		"scale_to_percent": <number>
		{
			"quickfix": "scale_page_content_only",
			"version": "1.0",
			"instructions": [
				{
					"page_selector": "all",
					"relative_to": "lower_left_corner",
					"scale_to_percent": 75
				}
			]
		},
// "rotate_pages"
//		"page_selector": "all|even|odd|<splitscheme_expression>"
//		"rotate_by": <number>
		{
			"quickfix": "rotate_pages",
			"version": "1.0",
			"instructions": [
				{
					"page_selector": "all",
					"rotate_by": 90
				}
			]
		},
// "flip_pages"
//		"page_selector": "all|even|odd|<splitscheme_expression>",
//		"flip_direction": "horizontally|vertically"
		{
			"quickfix": "flip_pages",
			"version": "1.0",
			"instructions": [
				{
					"page_selector": "all",
					"flip_direction": "horizontally"
				}
			]
		},
// "auto_correct_page_boxes"
//		"page_selector": "all|even|odd|<splitscheme_expression>",
		{
			"quickfix": "auto_correct_page_boxes",
			"version": "1.0",
			"instructions": [
				{
					"page_selector": "all"
				}
			]
		},
// "insert_empty_page"
//		"page_selector": "all|even|odd|<splitscheme_expression>",
//		"where": "before|after"
		{
			"quickfix": "insert_empty_page",
			"version": "1.0",
			"instructions": [
				{
					"page_selector": "all",
					"where": "before"
				}
			]
		},
// "duplicate_page"
//		"page_selector": "all|even|odd|<splitscheme_expression>",
		{
			"quickfix": "duplicate_page",
			"version": "1.0",
			"instructions": [
				{
					"page_selector": "2"
				}
			]
		},
// "remove_page"
//		"page_selector": "all|even|odd|<splitscheme_expression>",
		{
			"quickfix": "remove_page",
			"version": "1.0",
			"instructions": [
				{
					"page_selector": "odd"
				}
			]
		},
// "set_ocg_visibility"
//		"operator": "regex|begins_with|contains|does_not_begin_with|does_not_contain|does_not_end_with|ends_with|equal_to|is_contained_in|is_not_contained_in|unequal_to"
//		"ocg_name": "<optional_content_group_name_>",
//		"interpret_ocg_name_as_processsing_steps_name": true|false <optional: default false>,
//		"visibility": "on|off"
		{
			"quickfix": "set_ocg_visibility",
			"version": "1.0",
			"instructions": [
				{
					"operator": "equal_to",
					"ocg_name": "Structural:Bleed",
					"interpret_ocg_name_as_processsing_steps_name": true,
					"visibility": "on"
				}
			]
		},
// "set_processing_steps_metadata_for_ocg"
//		"operator": "regex|begins_with|contains|does_not_begin_with|does_not_contain|does_not_end_with|ends_with|equal_to|is_contained_in|is_not_contained_in|unequal_to"
//		"ocg_name": "<optional_content_group_name_>",
//		"processing_steps_group": "<custom>|Structural|Dimensions|Braille|Legend|Positions|White|Varnish",
//		"processing_steps_type": "<custom>|Cutting|PartialCutting|ReversePartialCutting|Creasing|ReverseCreasing|CuttingCreasing|ReverseCuttingCreasing|PartialCuttingCreasing|ReversePartialCuttingCreasing|Drilling|Gluing|FoilStamping|ColdFoilStamping|Embossing|Debossing|Perforating|Bleed|VarnishFree|InkFree|InkVarnishFree|Folding|Punching|Stapling|Hologram|Barcode|ContentArea|CodingMarking|Imprinting"
		{
			"quickfix": "set_processing_steps_metadata_for_ocg",
			"version": "1.0",
			"instructions": [
				{
					"operator": "equal_to",
					"ocg_name": "Cutline",
					"processing_steps_group": "Structural",
					"processing_steps_type": "Cutting"
				}
			]
		},
// "embed_outputintent"
//		"outputintent_name": "<internal use>",
//		"outputintent_filepath": "<file_path_to_pdf_file_with_valid_output_intent_information>",
//		"outputintent_type": "A|E|X|AE|AX|EX|AEX|X5n",
//		"retain_existing_outputintent": true|false
		{
			"quickfix": "embed_outputintent",
			"version": "1.0",
			"instructions": [
				{
					"outputintent_name": "",
					"outputintent_filepath": "C:\\user\\Max\\OutputIntent\\ISOUncoated(ECI).pdf",
					"outputintent_type": "X",
					"retain_existing_outputintent": false
				}
			]
		},
// "remove_outputintents"
		{
			"quickfix": "remove_outputintents",
			"version": "1.0",
			"instructions": [
				{
				}
			]
		},
// "inject_dpart"
//		"grouping_expression": "all|even|odd|<splitscheme_expression>",
//		"node_name": "<nodenamelist entry>",
		{
			"quickfix": "inject_dpart",
			"version": "1.0",
			"instructions": [
				{
					"grouping_expression": "3*",
					"node_name": "photobook"
				}
			]
		}
	]
}
</nodenamelist></splitscheme_expression></file_path_to_pdf_file_with_valid_output_intent_information></internal></custom></custom></optional_content_group_name_></optional:></optional_content_group_name_></splitscheme_expression></splitscheme_expression></splitscheme_expression></splitscheme_expression></splitscheme_expression></number></splitscheme_expression></number></splitscheme_expression></number></splitscheme_expression></number></number></splitscheme_expression></number></number></number></number></splitscheme_expression></number></number></number></number></splitscheme_expression></splitscheme_expression></splitscheme_expression></splitscheme_expression></integer></text></text></number></number></number></number></icc-profil-file-path></text></text></text></text></p>