HPDFSampleDataMatrixQuadrilateral
Unità: HPDFDataMatrixGeometry
function HPDFSampleDataMatrixQuadrilateral(const Mask: TBytes;
Width, Height, Rows, Columns, RegionRows, RegionColumns: Integer;
const Corners: THPDFBarcodeQuadrilateral;
CancellationToken: THPDFCancellationToken; StartTick: Cardinal;
out Grid: THPDFBarcodeModuleGrid): Boolean;
Campiona un quadrilatero Data Matrix ECC 200 con validazione dei bordi finder prima del campionamento dei data module; l'output riuscito corrisponde alla regola di maggioranza a cinque campioni usata da HPDFSampleBarcodeQuadrilateral
Mask contiene un byte per pixel raster, con byte non nulli che rappresentano pixel scuri; Width e Height descrivono quel raster, Rows e Columns descrivono la griglia moduli completa compresi i bordi finder, e RegionRows e RegionColumns contano le regioni dati in verticale e in orizzontale
I conteggi delle regioni devono essere positivi e dividere le corrispondenti dimensioni modulo; ogni regione deve essere larga e alta almeno tre moduli, le dimensioni modulo vanno da 8 a 144, le dimensioni raster sono al massimo 4096 per 4096 e sono accettati al massimo 4.194.304 pixel raster
Corners segue l'ordine normalizzato alto-sinistra, alto-destra, basso-destra, basso-sinistra del simbolo candidato, orientamento inteso e riflessione inclusi; il sampler controlla i bordi solidi sinistro e inferiore e i bordi alternati superiore e destro di ogni regione
Il numero consentito di moduli finder scorretti è Max(1, BorderModuleCount div 50), in linea con la consueta verifica finder ECC 200 del decoder; un pattern finder rifiutato o un input non valido restituiscono false con Grid vuota e il campionamento riuscito non stabilisce un payload decodificato né code word Reed–Solomon valide
StartTick è il valore GetTickCount di Windows dall'inizio dell'operazione completa; il consueto deadline di 2.000 ms include campionamento finder e dati e la cancellazione si propaga come EHPDFOperationCancelled
La funzione generica HPDFSampleBarcodeQuadrilateral continua a campionare griglie moduli arbitrarie senza imporre semantiche finder ECC 200