RenderPageToFileA
Renderowanie i drukowanie
Opis
Końcowa litera A oznacza punkt wejścia DLL ANSI (char); powierzchnia ActiveX/COM udostępnia wyłącznie postać Unicode. Zachowanie jest identyczne jak w RenderPageToFile, a argumenty ciągów są interpretowane przy użyciu bieżącej strony kodowej SetAnsiMode
Ta funkcja renderuje stronę z wybranego dokumentu do pliku na dysku. Dane zapisywane na dysku zależą od parametru Options
Domyślnie renderowanie korzysta z systemu GDI+, dostępnego standardowo w systemie Windows XP i nowszych
Mechanizmy renderujące GDI+ i Cairo obsługują cieniowania PDF typów 1 oraz 4–7 z adaptacyjnym próbkowaniem funkcji, interpolacją kolorów w przestrzeni źródłowej, przycinaniem BBox, wypełnieniami Background, przezroczystością i ograniczonym podziałem siatki
Opcja 10, dane wyjściowe TIFF (G4), jest dostępna tylko w systemach Windows Vista i Windows Server 2008 lub nowszych
Renderowanie można także wykonywać za pomocą Cairo, używając SetCairoFileName i SelectRenderer
functions
W przypadku obrazów z /Alternates wbudowany mechanizm renderujący zachowuje widoczny obraz bazowy lub wybiera pierwszy widoczny wariant zawartości opcjonalnej zgodnie z wymaganiami ISO 32000-1
Składnia
Delphi
Function DLRenderPageToFileA(InstanceID: Integer; DPI: Double; Page, Options: Integer; FileName: PAnsiChar): Integer;
DLL
int DLRenderPageToFileA(int InstanceID, double DPI, int Page, int Options, const char * FileName);
Parametry
| DPI | DPI używane podczas renderowania strony. Wartości powyżej 300 powodują nadmierne zużycie pamięci |
|---|---|
| Page | Numer strony do renderowania |
| Options | 0 = wyjście BMP 1 = wyjście JPEG 2 = wyjście WMF 3 = wyjście EMF 4 = wyjście EPS 5 = wyjście PNG 6 = wyjście GIF 7 = wyjście TIFF (LZW) 8 = wyjście EMF+ 9 = wyjście HTML5 10 = wyjście TIFF (G4) 11 = wyjście EMF+ Dual |
| FileName | Ścieżka i nazwa tworzonego pliku, w którym zostaną zapisane dane obrazu wyrenderowanej strony |
Wartości zwracane
| 0 | Nie udało się wyrenderować strony |
|---|---|
| 1 | Strona została poprawnie wyrenderowana, a plik obrazu zapisano na dysku Nie można zapisać pliku na dysku 2 |