문서 변환과 페이지 렌더링
문서를 PDF로 바꾸거나 PDF의 페이지 범위를 선택할 때는 documentToDocument를 사용합니다. 이미지를 반환하려면 documentToImage를 사용합니다.
slicePdfRange는 0부터 시작하는 반열린 범위입니다. 예를 들어 3쪽 이상인 PDF에서 startPageInclusive=0, endPageExclusive=3이면 첫 세 페이지를 선택합니다. strictlyEnforceEndPage는 기본적으로 true이므로 문서의 페이지 수를 넘어가는 끝 지정을 거부합니다. false이면 문서 끝에서 범위를 제한합니다.
PDF 이미지 렌더링의 pageNumber도 0부터 시작하며 생략하면 첫 페이지입니다. renderPageToFitBoundingBox는 너비와 높이가 모두 필수이고 비율을 유지합니다. renderPage는 한쪽 치수만 지정하면 비율에 따라 나머지를 계산합니다.
각 분기의 객체를 변환 요청의 transformation 값으로 사용합니다. type으로 분기를 선택한 다음 해당 분기의 필수 필드를 제공합니다.
변환 documentToDocument
문서의 형식을 변환하거나 페이지 범위를 선택합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: documentToDocument. | documentToDocument |
encoding | union<pdf> | 필수 | 문서 결과의 인코딩 형식입니다. | |
operation | union<slicePdfRange, convertDocument> | 필수 | 문서에 적용할 작업입니다. |
encoding의 구조
필드는 공통 문서 인코딩을 따릅니다.
operation의 구조
분기 slicePdfRange
PDF에서 지정한 페이지 범위를 선택합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: slicePdfRange. | slicePdfRange |
startPageInclusive | integer | 필수 | 0부터 시작하는 시작 페이지이며 범위에 포함합니다. | |
endPageExclusive | integer | 필수 | 0부터 시작하는 끝 페이지이며 범위에서 제외합니다. | |
strictlyEnforceEndPage | boolean | 선택 | 기본값은 true이며 끝 페이지가 문서 페이지 수를 초과하면 실패합니다. false이면 문서 끝에서 범위를 제한합니다. |
분기 convertDocument
문서를 PDF로 변환합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: convertDocument. | convertDocument |
변환 documentToImage
문서 페이지를 이미지로 렌더링합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: documentToImage. | documentToImage |
encoding | union<jpg, tiff, png, webp> | 필수 | 이미지 결과의 인코딩 형식입니다. | |
operation | union<renderPageToFitBoundingBox, renderPage> | 필수 | 문서를 이미지로 변환할 작업입니다. |
encoding의 구조
필드는 공통 이미지 인코딩을 따릅니다.
operation의 구조
분기 renderPageToFitBoundingBox
가로세로 비율을 유지하면서 경계 상자에 최대한 맞도록 PDF 페이지를 렌더링합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: renderPageToFitBoundingBox. | renderPageToFitBoundingBox |
pageNumber | integer | 선택 | 0부터 시작하는 렌더링 대상 페이지 번호입니다. 생략하면 첫 페이지를 사용합니다. | |
width | integer | 필수 | 경계 상자의 너비이며 단위는 픽셀입니다. | |
height | integer | 필수 | 경계 상자의 높이이며 단위는 픽셀입니다. |
분기 renderPage
PDF 페이지를 이미지로 렌더링합니다. 너비와 높이 중 하나만 지정하면 비율을 유지하도록 나머지를 계산합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: renderPage. | renderPage |
pageNumber | integer | 선택 | 0부터 시작하는 렌더링 대상 페이지 번호입니다. 생략하면 첫 페이지를 사용합니다. | |
height | integer | 선택 | 원하는 높이이며 단위는 픽셀입니다. | |
width | integer | 선택 | 원하는 너비이며 단위는 픽셀입니다. |