Getting Started

설치, Delphi 설정, 첫 프로그램

PDF Library for Delphi는 Delphi PDF 라이브러리입니다. 코드에서 사용하려면 라이브러리 유닛을 프로젝트에 추가하고 PDF 문서를 작성하거나 수정해야 할 때 TPDFlib 인스턴스를 생성함

경로 설정

PDF Library for Delphi 소스 파일 또는 컴파일된 DCU 파일을 찾을 위치를 Delphi에 알려 주세요. 전역 Library Path를 한 번 설정하거나 라이브러리를 사용하는 각 프로젝트의 Search Path를 설정할 수 있습니다

전역 Library Path를 설정하려면 다음 Delphi 메뉴 경로를 사용합니다:

Tools -> Options -> Language -> Delphi -> Library -> Library path

이전 Delphi 릴리스에서는 이 설정이 다음 위치에 나타날 수 있습니다:

Tools -> Environment Options -> Library -> Library path

설치된 소스 경로 또는 일치하는 컴파일 바이너리 경로를 추가합니다. 예:

%UserProfile%\Documents\losLab\PDFlibPas\Lib
%UserProfile%\Documents\losLab\PDFlibPas\Lib\37.0\Win32\Release
%UserProfile%\Documents\losLab\PDFlibPas\Lib\37.0\Win64\Release

첫 번째 경로는 기본 소스 에디션 경로입니다. 버전이 포함된 경로는 RAD Studio 13 Florence 컴파일 DCU의 예입니다. 설치된 Delphi 또는 C++Builder 버전과 일치하는 BDS 버전 폴더를 사용합니다

현재 프로젝트의 Search Path만 설정하려면 다음을 사용합니다:

Project -> Options -> Building -> Delphi Compiler -> Search path

이전 Delphi 릴리스에서는 이 설정이 다음 위치에 나타날 수 있습니다:

Project -> Options -> Directories/Conditionals -> Search path

Windows의 Free Pascal 및 Lazarus

i386-win32와 x86_64-win64가 모두 지원되며, Win64 크로스 컴파일러를 갖춘 Win32 컴파일러 설치도 포함됩니다

build-Lazarus-Lib.cmd win32
build-Lazarus-Tests.cmd win32
build-Lazarus-Demo.cmd win32
build-Lazarus-Lib.cmd win64

디버그 빌드에는 debug를, 콘솔 테스트를 실행하지 않고 빌드하려면 norun을 쓰십시오. 커스텀 컴파일러 설치를 쓸 때는 FPC에 fpc.exe의 전체 경로를 설정하십시오

컴파일된 유닛은 Lib\FPC\i386-win32 또는 Lib\FPC\x86_64-win64에 기록됩니다. 일치하는 디렉터리와 Lib\FPC\compat를 프로젝트 유닛 검색 경로에 추가하고, Delphi 구문 모드를 쓰며, 번들된 Lib\thirdparty 객체를 링커가 쓸 수 있게 유지하십시오. Lazarus 런타임 패키지는 Lib\FPC\PDFlibPasLaz.lpk입니다

테스트 실행 파일은 Tests\Lazarus\bin\<target>을, 데모 실행 파일은 각 데모의 bin\<target> 디렉터리를 씁니다. Win32 AES와 JPEG 2000은 Lib\thirdparty\Win32f의 제공된 정적 COFF 객체를 쓰며 코덱 DLL이 필요 없습니다. Win32는 외부 인코더 옵션이 요청된 경우에도 내장 Pascal JBIG2 인코더를 쓰고, 외부 PDFlibJBIG2EncC 백엔드는 Win64에서 사용할 수 있습니다

트라이얼 설치에는 프리컴파일된 유닛이 포함됩니다. 일치하는 컴파일러 버전과 대상으로 데모를 빌드하려면 build-Lazarus-Demo-TRIAL.cmd win32를 실행하거나 win64를 고르십시오. 소스 트리에서 트라이얼 바이너리를 준비할 때는 먼저 build-Lazarus-Lib-TRIAL.cmd win32나 win64로 유닛을 빌드하십시오

클래스 및 유닛 이름

주 라이브러리 유닛은 PDFlibrary.pas이며, 바이너리 패키지에서는 PDFlibrary.dcu입니다. 주 클래스는 TPDFlib입니다

클래스 선언

PDF Library for Delphi는 VCL 컴포넌트가 아닌 Delphi 라이브러리이며 IDE 컴포넌트 팔레트에 설치되지 않습니다. PDFlibrary를 유닛의 uses 절에 추가하고 TPDFlib 유형 변수를 선언한 뒤 Create 생성자를 호출하세요. 작업을 마치면 Free를 호출하며 보통 try..finally 블록 안에서 수행합니다

첫 번째 PDF Library 프로그램

새 VCL Forms 애플리케이션을 시작하고 양식에 TButton을 추가합니다. Delphi용 PDF Library 유닛을 양식 유닛에 추가합니다:

uses
  Windows, Messages, SysUtils, Variants, Classes, Graphics,
  Controls, Forms, Dialogs, PDFlibrary;

버튼을 두 번 클릭하고 이 이벤트 처리기를 추가하십시오:

procedure TForm1.Button1Click(Sender: TObject);
var
  PDFlib: TPDFlib;
begin
  PDFlib := TPDFlib.Create;
  try
    PDFlib.DrawText(100, 500, 'Hello from Delphi');
    PDFlib.SaveToFile('.\HelloFromDelphi.pdf');
  finally
    PDFlib.Free;
  end;
end;

전체 워크플로

첫 PDF 이후에는 함께 제공되는 Demo/Delphi, Demo/C++Builder, Demo/Lazarus 포트폴리오를 둘러보십시오. Showcase는 시각 투어를 제공하고 각 도메인 랩은 하나의 실행 파일로 전문 시나리오를 엽니다

페이지 인벤토리와 진단 보고서는 DocumentLab --scenario DocumentInspectionWorkbench로 실행하거나, 시나리오가 문서화한 명령줄 인수로 직접 준비한 PDF를 지정하십시오

표, 주석, 인수인계 체크리스트, HTTP 출력, 저장 파일 검증이 있는 문서 전달 워크플로는 ContentLab --scenario WorkflowGallery로 실행합니다

DLL 사용자는 보고서 생성, 추출, 페이지 구성, 바이너리 메모리 전송을 위해 Demo/CSharp/DLL/WorkflowWorkbench나 Demo/VB.NET/DLL/WorkflowWorkbench로, 검증된 링크와 내비게이션은 Demo/VC++/DLL/LinkDemo로 시작할 수 있습니다

설치된 패키지에서 Demo/DLL.en-us.html을 열면 DLL 워크플로 카탈로그와 아키텍처별 빌드 안내를 볼 수 있습니다

추가 정보

자세한 API 문서는 이 HTML 참조를 사용합니다. 탐색 창에서 함수 이름, 범주 또는 주제 키워드로 검색할 수 있습니다

제품 소식과 추가 정보를 보려면 PDF Library for Delphi 제품 페이지를 방문하십시오