THPDFComplexGraphicsFlattenInfo Record
Reports the outcome of flattening a page's complex graphics: status, mesh shading and complex pattern counts, chosen and reference DPI, measured perceptual error, tile and memory telemetry, output colour space and spot colourants
Declaration
THPDFComplexGraphicsFlattenInfo= record
Status: THPDFComplexGraphicsFlattenStatus;
MeshShadingCount: Integer;
ComplexPatternCount: Integer;
SelectedDPI: Integer;
ReferenceDPI: Integer;
MeasuredPerceptualError: Double;
SampleCount: Int64;
TileCount: Integer;
PeakTilePixels: Int64;
PeakWorkingBytes: Int64;
OutputColorSpace: AnsiString;
SpotColorants: THPDFAnsiStringArray;
end;Unit
HPDFDoc
Fields
| Field | Purpose |
|---|---|
Status | THPDFComplexGraphicsFlattenStatus outcome: nothing to flatten, flattened to calibrated RGB, flattened with spot colours preserved, or render failed |
MeshShadingCount | Number of type 4-7 mesh shading resources detected on the page |
ComplexPatternCount | Number of complex pattern resources detected on the page |
SelectedDPI | Rasterisation DPI the search settled on for the flattened image |
ReferenceDPI | Upper DPI bound of the search (the caller-supplied MaximumDPI) used as the quality reference |
MeasuredPerceptualError | Perceptual error measured between the selected rendering and the reference; set to 100.0 when rendering failed |
SampleCount | Number of sample pixels compared during the error measurement |
TileCount | Number of tiles rendered during the flattening pass |
PeakTilePixels | Largest single tile produced, in pixels |
PeakWorkingBytes | Peak working-set bytes reached while rasterising |
OutputColorSpace | Colour space of the written image, for example CalRGB |
SpotColorants | Spot colorant names preserved on the page, reported via the page spot-colorant inspector |
Usage notes
- Filled by
THotPDF.FlattenLoadedPageComplexGraphics; the record is reset at entry and remains inspectable when the function returnsfalse - Compare
SelectedDPIagainstReferenceDPIandMeasuredPerceptualErroragainst the caller-suppliedMaximumPerceptualErrorto judge the quality trade-off - Use
Statusto distinguish a page that needed no flattening from one where spot colours were preserved or rendering failed