StartRenderPageJob

문서 검사, 렌더링

설명

호출자 스레드를 차단하지 않고 PDF 파일의 한 페이지를 렌더링하는 백그라운드 작업을 시작합니다

TPDFlib은 스레드로부터 안전하지 않으므로 작업은 동일한 원본 파일에서 격리된 인스턴스를 만들고 시스템 작업에서 실행하며, 이에 따라 큰 페이지가 완료될 때까지 호스트 스레드를 점유하지 않습니다

작업은 취소 플래그와 수동 재설정 일시 중지 게이트를 렌더러에 전달하며, 렌더러는 콘텐츠 스트림 연산자 사이에서 이를 폴링합니다. 이 방식으로 PauseRenderJob, ResumeRenderJob 및 CancelRenderJob가 처리 중인 단일 페이지를 중단할 수 있습니다

구문

Delphi

Function TPDFlib.StartRenderPageJob(Const FileName, Password, OutputFileName: WideString; DPI: Double; Page, Options: Integer): Integer;

DLL

int DLStartRenderPageJob(int InstanceID, const wchar_t* FileName, const wchar_t* Password, const wchar_t* OutputFileName, double DPI, int Page, int Options);

ActiveX

Function PDFlib::StartRenderPageJob(FileName As String, Password As String, OutputFileName As String, DPI As Double, Page As Long, Options As Long) As Long

매개변수

FileName	원본 PDF 파일 경로
Password	문서 암호이며 PDF가 암호화되지 않았으면 빈 문자열
OutputFileName	대상 이미지 경로이며 형식은 `Options`를 따르고 `RenderPageToFile`에서와 같습니다
DPI	렌더링 해상도
Page	렌더링할 1부터 시작하는 페이지 번호
Options	`RenderPageToFile`에 그대로 전달되는 이미지 형식 옵션

반환 값

>0	렌더 작업 제어 메서드에서 사용할 1 기반 작업 핸들
0	작업을 시작할 수 없습니다

비고

GetRenderJobState로 진행 상황을 폴링하고 WaitForRenderJob로 차단합니다. 두 함수 모두 RENDER_JOB_STATE_* 코드를 반환합니다

작업자 스레드를 잃지 않고 실행 중인 페이지를 중단하려면 PauseRenderJob, ResumeRenderJob 및 CancelRenderJob을 사용합니다

작업을 시작한 인스턴스가 작업을 소유합니다. 인스턴스를 해제하면 미완료 작업에 참가하므로 반쯤 완성된 페이지가 소유자보다 오래 남지 않습니다