DrawPath

Vector graphics, Path definition and drawing

Description

Disegna il tracciato corrente — assemblato da StartPath, AddLineToPath, AddCurveToPath, AddArcToPath e ClosePath — utilizzando la regola di riempimento del numero di giri diverso da zero; dopo che il tracciato è stato disegnato, lo stato del tracciato viene ripristinato, in modo che il successivo StartPath inizi una nuova forma

Syntax

Delphi

Function TPDFlib.DrawPath(PathOptions: Integer): Integer;

ActiveX

Function PDFlib::DrawPath(PathOptions As Long) As Long

DLL

int DLDrawPath(int InstanceID, int PathOptions);

Parameters

PathOptions	Modalità di disegno: 0 — Solo contorno (tratto con le impostazioni correnti della linea). 1 — Solo riempimento (con il colore di riempimento corrente e la regola del numero di giri diverso da zero). 2 — Riempimento e contorno

Return values

0	Non riuscito — PathOptions è fuori intervallo, nessun documento è aperto o nessun tracciato è stato iniziato
1	Il percorso è stato disegnato con successo

Remarks

Imposta i colori di tratto e riempimento e gli attributi di linea (SetLineWidth, SetLineCap, SetLineDash) prima di chiamare DrawPath; lo stato grafico corrente viene campionato al momento della chiamata

Per i tracciati sovrapposti o autointersecanti, la regola dell'avvolgimento diverso da zero tratta ogni sotto-tracciato come parte della stessa regione: un foro ritagliato da una forma più grande richiede che il sotto-tracciato interno si avvolga nella direzione opposta a quello esterno; quando ciò non è conveniente, chiamare invece DrawPathEvenOdd — la regola pari-dispari si limita ad alternare l'interno e l'esterno a ogni incrocio, il che rende i fori ritagliati banali

Example

// Filled outlined diamond
PDF.SetStrokeColor(0, 0, 0);
PDF.SetFillColor(0.6, 0.8, 1);
PDF.SetLineWidth(1.5);

PDF.StartPath(150, 100);
PDF.AddLineToPath(200, 150);
PDF.AddLineToPath(150, 200);
PDF.AddLineToPath(100, 150);
PDF.ClosePath;
PDF.DrawPath(2);                       // 2 = fill and outline