Keyboard shortcuts

Press ← or → to navigate between chapters

Press ? to show this help

Press Esc to hide this help

문서 변환과 페이지 렌더링

문서를 PDF로 바꾸거나 PDF의 페이지 범위를 선택할 때는 documentToDocument를 사용합니다. 이미지를 반환하려면 documentToImage를 사용합니다.

slicePdfRange는 0부터 시작하는 반열린 범위입니다. 예를 들어 3쪽 이상인 PDF에서 startPageInclusive=0, endPageExclusive=3이면 첫 세 페이지를 선택합니다. strictlyEnforceEndPage는 기본적으로 true이므로 문서의 페이지 수를 넘어가는 끝 지정을 거부합니다. false이면 문서 끝에서 범위를 제한합니다.

PDF 이미지 렌더링의 pageNumber도 0부터 시작하며 생략하면 첫 페이지입니다. renderPageToFitBoundingBox는 너비와 높이가 모두 필수이고 비율을 유지합니다. renderPage는 한쪽 치수만 지정하면 비율에 따라 나머지를 계산합니다.

각 분기의 객체를 변환 요청의 transformation 값으로 사용합니다. type으로 분기를 선택한 다음 해당 분기의 필수 필드를 제공합니다.

변환 documentToDocument

문서의 형식을 변환하거나 페이지 범위를 선택합니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: documentToDocument.documentToDocument
encodingunion<pdf>필수문서 결과의 인코딩 형식입니다.
operationunion<slicePdfRange, convertDocument>필수문서에 적용할 작업입니다.

encoding의 구조

필드는 공통 문서 인코딩을 따릅니다.

operation의 구조

분기 slicePdfRange

PDF에서 지정한 페이지 범위를 선택합니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: slicePdfRange.slicePdfRange
startPageInclusiveinteger필수0부터 시작하는 시작 페이지이며 범위에 포함합니다.
endPageExclusiveinteger필수0부터 시작하는 끝 페이지이며 범위에서 제외합니다.
strictlyEnforceEndPageboolean선택기본값은 true이며 끝 페이지가 문서 페이지 수를 초과하면 실패합니다. false이면 문서 끝에서 범위를 제한합니다.

분기 convertDocument

문서를 PDF로 변환합니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: convertDocument.convertDocument

변환 documentToImage

문서 페이지를 이미지로 렌더링합니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: documentToImage.documentToImage
encodingunion<jpg, tiff, png, webp>필수이미지 결과의 인코딩 형식입니다.
operationunion<renderPageToFitBoundingBox, renderPage>필수문서를 이미지로 변환할 작업입니다.

encoding의 구조

필드는 공통 이미지 인코딩을 따릅니다.

operation의 구조

분기 renderPageToFitBoundingBox

가로세로 비율을 유지하면서 경계 상자에 최대한 맞도록 PDF 페이지를 렌더링합니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: renderPageToFitBoundingBox.renderPageToFitBoundingBox
pageNumberinteger선택0부터 시작하는 렌더링 대상 페이지 번호입니다. 생략하면 첫 페이지를 사용합니다.
widthinteger필수경계 상자의 너비이며 단위는 픽셀입니다.
heightinteger필수경계 상자의 높이이며 단위는 픽셀입니다.

분기 renderPage

PDF 페이지를 이미지로 렌더링합니다. 너비와 높이 중 하나만 지정하면 비율을 유지하도록 나머지를 계산합니다.

이름자료형필수 여부의미와 조건예시 값
typeenum필수허용값: renderPage.renderPage
pageNumberinteger선택0부터 시작하는 렌더링 대상 페이지 번호입니다. 생략하면 첫 페이지를 사용합니다.
heightinteger선택원하는 높이이며 단위는 픽셀입니다.
widthinteger선택원하는 너비이며 단위는 픽셀입니다.