AddImageFromFile

이미지 처리

설명

파일의 이미지를 선택한 문서에 추가합니다

이미지를 문서에 추가하면 PDF 파일 크기를 더 늘리지 않고도 어느 페이지에서든 여러 번 그릴 수 있습니다

지원되는 이미지 파일 유형은 BMP, TIFF, JPEG, PNG, GIF, WMF, EMF 및 WebP이며 최신 이미지 디코더가 있으면 AVIF, HEIF, HEIC 및 JPEG XL도 지원합니다

PDF 버전 동작: 구성 요소당 16비트 이미지 데이터를 가져오려면 PDF 1.5가 필요합니다. 문서가 PDF 1.4 이하로 설정되어 있고 저장 버전이 잠기지 않은 경우 AddImageFromFile은 문서를 PDF 1.5로 자동 상향하고 16-bit image samples를 AutoBumpedFeatures에 기록합니다. 호출자가 더 낮은 저장 버전을 잠그면 호환성 게이트가 LastErrorCode 602와 함께 저장을 거부합니다

BMP 및 TIFF 이미지의 경우 이 함수를 호출하기 전에 CompressImages 함수를 호출하여 이미지 데이터를 압축할 수 있습니다 다른 이미지 유형은 자동으로 압축됩니다

구문

Delphi

Function TPDFlib.AddImageFromFile(Const FileName: WideString; Options: Integer): Integer;

ActiveX

Function PDFlib::AddImageFromFile(FileName As String, Options As Long) As Long

DLL

int DLAddImageFromFile(int InstanceID, const wchar_t * FileName, int Options);

매개변수

FileName	추가할 이미지의 파일 이름
Options	다중 페이지 TIFF 이미지의 경우 이 매개변수는 로드할 페이지 번호를 지정합니다. PNG 이미지: 0 = 평소와 같이 이미지 로드 1 = 알파 채널을 회색조 이미지로 로드 2 = 이미지와 알파 채널 로드(알파를 8비트로 제한) 3 = 이미지 로드(이미지를 채널당 8비트로 제한) 4 = 알파 채널 로드(채널당 8비트로 제한) 5 = 알파 채널이 있는 이미지 로드(둘 다 채널당 8비트로 제한) 6 = 이미지와 알파 채널 로드 7 = 이미지와 ICC 색상 프로필 로드 8 = 높은 비트 심도를 유지하면서 이미지, 알파 채널 및 ICC 색상 프로필 로드 다른 이미지 형식에서는 이 매개변수를 0으로 설정해야 합니다. Options를 -1로 설정하면 TIFF, EMF 및 WMF 이미지가 GDI+ 그래픽 라이브러리를 사용하여 강제로 로드됩니다. Options 매개변수를 -PageNumber로 설정하면 다중 페이지 TIFF 이미지도 GDI+로 로드할 수 있습니다(예: 3페이지는 -3)

FileName

추가할 이미지의 파일 이름

Options

다중 페이지 TIFF 이미지의 경우 이 매개변수는 로드할 페이지 번호를 지정합니다. PNG 이미지: 0 = 평소와 같이 이미지 로드 1 = 알파 채널을 회색조 이미지로 로드 2 = 이미지와 알파 채널 로드(알파를 8비트로 제한) 3 = 이미지 로드(이미지를 채널당 8비트로 제한) 4 = 알파 채널 로드(채널당 8비트로 제한) 5 = 알파 채널이 있는 이미지 로드(둘 다 채널당 8비트로 제한) 6 = 이미지와 알파 채널 로드 7 = 이미지와 ICC 색상 프로필 로드 8 = 높은 비트 심도를 유지하면서 이미지, 알파 채널 및 ICC 색상 프로필 로드 다른 이미지 형식에서는 이 매개변수를 0으로 설정해야 합니다. Options를 -1로 설정하면 TIFF, EMF 및 WMF 이미지가 GDI+ 그래픽 라이브러리를 사용하여 강제로 로드됩니다. Options 매개변수를 -PageNumber로 설정하면 다중 페이지 TIFF 이미지도 GDI+로 로드할 수 있습니다(예: 3페이지는 -3)

반환 값

0	이미지를 추가할 수 없습니다. 이미지를 찾을 수 없거나 지원되지 않는 형식입니다
Non-zero	이미지가 성공적으로 추가되었습니다. SelectImage 및 DrawImage 같은 함수에 전달할 수 있는 ImageID가 반환됩니다