AddAlternateImage
이미지 처리, 선택적 콘텐츠
설명
ISO 32000-1 §8.9.5.4에 정의된 기본 이미지 XObject의 대체 표현 하나를 추가하거나 업데이트합니다
대체 이미지는 페이지 콘텐츠를 복제하지 않고 고해상도 인쇄 표현 또는 선택적 콘텐츠로 제어되는 표시 표현을 제공할 수 있습니다
구문
Function TPDFlib.AddAlternateImage(BaseImageID, AlternateImageID: Integer; DefaultForPrinting: Boolean; OptionalContentID: Integer= 0): Integer;매개변수
| BaseImageID | 페이지 리소스와 콘텐츠 스트림 Do 연산자가 사용하는 이미지 |
|---|---|
| AlternateImageID | 변형으로 연결할 이미지 XObject |
| DefaultForPrinting | 이 변형을 기본 인쇄 이미지로 표시하고 같은 기본 이미지의 다른 변형에서는 해당 플래그를 지웁니다 |
| OptionalContentID | 이 변형의 선택을 제어하는 선택적 OCG 또는 OCMD 핸들이며, 선택적 콘텐츠 조건이 없으면 0 |
반환 값
1부터 시작하는 대체 인덱스를 반환하며 같은 이미지를 업데이트하면 기존 인덱스를 반환하고 검증에 실패하면 0을 반환함
비고
기본 이미지와 대체 이미지는 선택한 문서에서 서로 다른 이미지 객체여야 합니다
이미 대체 이미지로 사용된 이미지는 자체 /Alternates 배열을 소유할 수 없으며 대체 이미지를 소유한 이미지는 다른 대체 이미지로 연결할 수 없습니다
OCG 또는 OCMD를 전달하면 최소 PDF 버전이 1.5로 올라가며 그렇지 않으면 최소 버전은 PDF 1.3입니다
ISO 19005가 이미지 사전의 /Alternates를 금지하므로 모든 PDF/A 모드에서 이 작업을 거부합니다
기본 이미지에 /OC 항목이 있으면 기본 제공 렌더러는 해당 이미지가 보이는 동안 기본 이미지를 표시하고, 그렇지 않으면 /OC가 있는 대체 이미지 중 첫 번째로 보이는 이미지를 선택합니다
예제
BaseImageID := PDF.AddImageFromFile('preview.png', 0);
PrintImageID := PDF.AddImageFromFile('print-600dpi.tif', 0);
AlternateIndex := PDF.AddAlternateImage(BaseImageID, PrintImageID, True);참고 항목
AlternateImageCount, GetAlternateImageInfo, RemoveAlternateImage, SetImageOptional, TPDFlibAlternateImageInfo