AddImageFromString

이미지 처리

설명

메모리에서 선택한 문서로 이미지를 추가합니다

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

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

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

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

구문

Delphi

Function TPDFlib.AddImageFromString(Const Source: AnsiString; Options: Integer): Integer;

DLL

int DLAddImageFromString(int InstanceID, const char * Source, int Options);

매개변수

Source	이미지 데이터가 포함된 문자열입니다. 라이브러리의 ActiveX 버전에서는 이 문자열에 16비트 문자가 들어 있어야 하며 각 문자의 하위 8비트만 사용됩니다
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)

Source

이미지 데이터가 포함된 문자열입니다. 라이브러리의 ActiveX 버전에서는 이 문자열에 16비트 문자가 들어 있어야 하며 각 문자의 하위 8비트만 사용됩니다

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	이미지 데이터가 잘못되었거나 이미지 형식이 지원되지 않습니다 이미지를 성공적으로 추가했습니다. 반환값은 SelectImage 및 DrawImage 같은 함수에서 사용할 수 있는 ImageID입니다
1