function RenderPageBandedToStream(Stream: TStream; Width,
Height: Integer; const StreamOptions: TPdfBandedImageStreamOptions;
Rotation: TRotation = ro0; Options: TRenderOptions = [];
Color: TColor = clWhite): TPdfBandedImageReport;
| Stream | TStream. Kalder-ejet skrivbar output positioneret der, hvor billedet begynder |
| StreamOptions.Format | pbifPng for komprimeret 8-bit RGB PNG eller pbifTiff for ukomprimerede little-endian klassiske TIFF-striber |
| StreamOptions.BandHeight | Positiv bånd- og TIFF-stribehøjde; standard er 256 rækker |
| StreamOptions.CompressionLevel | PNG zlib-niveau fra 0 til 9; standard er 6, og TIFF ignorerer det |
| StreamOptions.MaxOutputBytes | Hårt kodet byte-loft; nul betyder ubegrænset |
| Rotation | TRotation. Visningsrotation anvendt på siden |
| Options | TRenderOptions. Rendering-flag |
| Color | TColor. Baggrundsfyld anvendt på hvert bånd før rendering |
| Result | TPdfBandedImageReport. Båndantal, kodede rækker, peak båndbytes, output-bytes, fuldførelsesflag og det valgte format |
Metoden pakker streamen ind i den anmodede indbyggede encoder, TPdfPngBandedImageEncoder eller TPdfTiffBandedImageEncoder, og driver den fælles banded pipeline fra RenderPageBandedToEncoder. Den returnerede rapport bærer det valgte Format i stedet for pbifCustom
PNG-encoderen komprimerer hver scanline direkte til sekventielle IDAT-chunks, mens TIFF-encoderen skriver én RGB-stribe pr. render-bånd og tilføjer sin image file directory efter pixeldataene. Begge encoders skriver kun fremad og seek'er aldrig kalderens stream
Peak sidepixel-lagring er én Width x BandHeight BGRA-bitmap i stedet for Width x Height. Rapporten eksponerer de målte PeakBandBytes, så eksportører kan auditere hukommelsespolitikken, og OutputBytes afspejler, hvad der faktisk blev skrevet til streamen
Brug TPdfBandedImageStreamOptions.Default(pbifPng) eller Default(pbifTiff), før individuelle grænser tilsidesættes; standarderne er BandHeight = 256, CompressionLevel = 6 og MaxOutputBytes = 0
En nil-stream, en ikke-positiv BandHeight eller en negativ MaxOutputBytes udløser EPdfError, og pbifCustom afvises, fordi et indbygget PNG- eller TIFF-format er påkrævet
Når det kodede billede ville overstige MaxOutputBytes, udløser skrivningen EPdfError med beskeden Encoded image exceeds the output byte budget
Brug RenderPageBandedToEncoder med en tilpasset TPdfBandedImageEncoder-nedkomst til ethvert andet containerformat eller eksterne codecs
StreamOptions := TPdfBandedImageStreamOptions.Default(pbifTiff);
StreamOptions.BandHeight := 256;
StreamOptions.MaxOutputBytes := Int64(512) * 1024 * 1024;
Report := Pdf.RenderPageBandedToStream(OutputStream, 4960, 7016,
StreamOptions);
if not Report.Completed then
RaiseBandedExportIncomplete;