Define a crop box for selected pages.
The crop box is a region to which the contents of a page shall be clipped (cropped) when displayed or printed.
The media box is mandatory and serves as default for the crop box and as its parent box.
The crop box serves as default for art box, bleed box and trim box and as their parent box.
Please refer to the PDF Specification 14.11.2 Page Boundaries for details.
Have a look at some examples.
pdfcpu crop [-p(ages) selectedPages] -- description inFile [outFile]
|v(erbose)||turn on logging|
|c(onf)||config dir||$path, disable|
|description||box configuration string||yes|
|inFile||PDF input file||yes|
|outFile||PDF output file||no|
Given the following page with a sole media box represented by the rectangular region [0 0 400 600]:
Crop a 200 x 200 points region located in lower left corner of media box:
pdfcpu crop -- "[0 0 200 200]" in.pdf cropped.pdf
Margins and offsets may be expressed in any display unit you like (po,cm,mm,in). Crop a region located in the bottom left corner of the media box with dimension expressed as relative width and height of the media box applying a horizontal/vertical offset of 1 cm:
pdfcpu crop -u cm -- "pos:bl, off:1 1, dim:25% 25%" in.pdf cropped.pdf
Crop relative to media box using 100 points for each of the four margins:
pdfcpu crop -- "100" in.pdf cropped.pdf
The following command would set display unit to mm in order to express top, left/right and bottom margins relative to the media box defining the rectangular regions that we want to use as crop box:
pdfcpu crop -u mm -- "15 10 15" in.pdf cropped.pdf
The following command uses negative margins for cropping and therefore expands the media box:
pdfcpu crop -- "-10" in.pdf cropped.pdf