MediaBox, CropBox, BleedBox: 지금 보고 있는 페이지 박스는 무엇인가
PDF 페이지에는 MediaBox, CropBox, BleedBox, TrimBox가 저장됩니다. PDF123 Crop은 MediaBox와 CropBox를 같은 사각형으로 맞춰 뷰어와 매체 크기가 어긋나지 않게 합니다.

PDF 페이지는 사각형 하나가 아닙니다. 형식 안에는 여러 페이지 박스가 저장되어 있어, 프린터와 뷰어, 편집기가 “페이지 크기”를 두고 서로 다르게 볼 수 있습니다. 자른 결과가 이상하거나 인쇄소에서 재단 여백을 요구할 때, 다투는 대상은 보통 지금 어느 박스가 기준인가입니다.
박스들을 쉬운 말로
- MediaBox: 전체 페이지 캔버스이자 매체 크기를 정의하는 가장 큰 박스입니다. 모든 페이지에 있어야 합니다.
- CropBox: 뷰어가 보이는 페이지로 삼는 영역입니다. 생략하면 MediaBox가 기본값입니다.
- BleedBox: 상업 인쇄에서 재단선 밖으로 넘어가는 재단 여백을 포함하는 영역입니다.
- TrimBox: 재단 후 의도한 완성 크기입니다.
- ArtBox: 의미 있는 콘텐츠의 범위입니다(사무용 PDF에서는 드뭅니다).
뷰어는 거의 항상 CropBox를 그립니다. 인쇄 전 소프트웨어는 BleedBox와 TrimBox를 신경 씁니다. 둘을 혼동하면 고전적인 불만이 나옵니다. “분명 잘랐는데 인쇄기에서는 옛 여백이 그대로 보인다”는 것입니다. 화면의 창은 움직였지만 MediaBox나 TrimBox는 여전히 옛 캔버스를 알리는 경우입니다.
좌표는 PDF 사용자 공간을 씁니다. 1포인트는 1/72인치입니다. 원점은 설명하는 박스의 왼쪽 아래이고, 화면 창의 왼쪽 위가 아닙니다. “X, Y, 너비, 높이”를 받는 도구는 그 공간의 사각형을 서술하는 것입니다.
자르기는 보이는 경계를 바꿉니다
PDF123에서 PDF 자르기은 X, Y, 너비, 높이를 포인트로 받아, 모든 페이지의 MediaBox와 CropBox 양쪽에 그 사각형을 씁니다. 따라서 CropBox를 존중하는 뷰어와 MediaBox를 읽는 도구가 작업 후 같은 페이지 크기를 봅니다. 새 박스 밖의 내용은 화면에서 숨겨질 뿐, 아래 깔린 콘텐츠 스트림이 반드시 삭제되는 것은 아닙니다. 기하가 먼저이고, 쓰이지 않는 그리기 연산자를 잘라 내는 일은 별개입니다.
다른 앱은 때때로 CropBox만 바꾸고 MediaBox는 그대로 둡니다. 그런 파일을 다른 곳에서 다시 열면 실제로는 박스 불일치인데 “자르기 실패”처럼 보입니다. 파일이 깨졌다고 단정하기 전에 각 도구가 어느 박스를 표시하는지 확인하세요.
Crop은 BleedBox, TrimBox, ArtBox를 다시 쓰지 않습니다. 인쇄 워크플로가 그 딕셔너리들을 여전히 읽는다면, 인쇄 전 도구가 갱신하기 전까지는 자르기 이전 페이지를 계속 설명합니다. “메일로 보내려고 여백만 잘라 내는” 사무용 작업은 보통 MediaBox와 CropBox 정렬만 신경 쓰면 되고, 이 Crop 경로가 바로 그것을 설정합니다.
크기 조정은 다른 지렛대
페이지 크기 조정은 현재 캔버스 안에서 창을 잘라 내는 대신 페이지 크기(A4, Letter, 배율)를 바꿉니다. 역시 MediaBox와 CropBox를 목표 크기로 설정하고, 페이지 내용을 배율 변환으로 감싸 새 캔버스에 그림이 맞게 합니다. 영역을 남기고 나머지를 숨기려면 자르기를, 페이지 전체를 목표 용지 크기에 맞추려면 크기 조정을 쓰세요.
Letter 크기 페이지를 200×200 pt 창으로 자르는 것과 같은 Letter 페이지를 A4로 조정하는 것은 서로 대체할 수 없습니다. 하나는 사각형 밖의 모든 것을 화면에서 버리고, 다른 하나는 페이지 전체를 새 매체 크기로 다시 매핑합니다.
“크기가 잘못된” 파일 진단하기
다른 앱에서 “잘랐는데” 인쇄소가 여전히 Letter 크기라고 할 때는 MediaBox와 CropBox를 따로 내보내거나 확인하세요. CropBox만 바꾼 파일은 뷰어에서는 맞아 보여도 MediaBox는 여전히 옛 캔버스를 임포지션 소프트웨어에 알립니다. PDF123 Crop은 같은 사각형을 양쪽에 써서 이 분기를 피합니다.
병합이나 가져오기 후 페이지가 잘린 것처럼 보인다면, 상위 도구가 둘을 함께 갱신하지 않고 CropBox를 MediaBox보다 작게 설정했는지 확인하세요. 문서 정보는 페이지 수와 암호화 여부를 알려 줄 뿐 박스 좌표는 주지 않습니다. 숫자가 필요하면 PDF 검사기나 crop UI의 포인트 입력 필드를 쓰세요.
실전 정리
화면의 밀리미터를 믿기 전에 “지금 어느 박스를 보고 있나”를 먼저 물으세요. 두 도구가 페이지 크기를 다르게 말하면 손상으로 몰아가기 전에 MediaBox와 CropBox를 비교하세요. 브라우저에서 대화형으로 다듬으려면 PDF 자르기를 쓰면 되고 계정은 필요 없습니다. 자동화에는 같은 기하 필드가 POST /api/v1/general/crop에 있습니다. 개발자를 보세요.