AddAlternateImage

Obsługa obrazów, zawartość opcjonalna

Opis

Dodaje lub aktualizuje jedną alternatywną reprezentację bazowego obrazu XObject zgodnie z ISO 32000-1 §8.9.5.4

Obrazy alternatywne mogą zapewniać reprezentację do drukowania w wysokiej rozdzielczości lub reprezentację wyświetlaną pod kontrolą zawartości opcjonalnej bez powielania zawartości strony

Składnia

Function TPDFlib.AddAlternateImage(BaseImageID, AlternateImageID: Integer; DefaultForPrinting: Boolean; OptionalContentID: Integer= 0): Integer;

Parametry

BaseImageID	Obraz używany przez zasoby strony i operatory `Do` strumienia zawartości
AlternateImageID	Obraz XObject do dołączenia jako wariant
DefaultForPrinting	Oznacza ten wariant jako preferowany obraz do drukowania i usuwa tę flagę z innych wariantów tego samego obrazu bazowego
OptionalContentID	Opcjonalny uchwyt OCG lub OCMD sterujący wyborem tego wariantu albo 0, gdy warunek zawartości opcjonalnej nie jest używany

Wartość zwracana

Zwraca indeks alternatywy liczony od 1, w tym istniejący indeks, gdy ten sam obraz jest aktualizowany, albo 0 w przypadku niepowodzenia walidacji

Uwagi

Obraz bazowy i alternatywny muszą być różnymi obiektami obrazu w wybranym dokumencie

Obraz już używany jako alternatywa nie może posiadać własnej tablicy /Alternates, a obrazu posiadającego alternatywy nie można dołączyć jako kolejnej alternatywy

Przekazanie OCG lub OCMD podnosi minimalną wersję PDF do 1.5; w przeciwnym razie minimalną wersją jest PDF 1.3

Wszystkie tryby PDF/A odrzucają tę operację, ponieważ ISO 19005 zabrania wpisu /Alternates w słownikach obrazów

Gdy obraz bazowy ma wpis /OC, wbudowany renderer wyświetla obraz bazowy, kiedy jest on widoczny, a w przeciwnym razie wybiera pierwszą widoczną alternatywę, której wpis zawiera /OC

Przykład

BaseImageID := PDF.AddImageFromFile('preview.png', 0);
PrintImageID := PDF.AddImageFromFile('print-600dpi.tif', 0);
AlternateIndex := PDF.AddAlternateImage(BaseImageID, PrintImageID, True);

Zobacz również

AlternateImageCount, GetAlternateImageInfo, RemoveAlternateImage, SetImageOptional, TPDFlibAlternateImageInfo