AddPolygonAnnotation

Merkinnät ja hotspot-linkit

Kuvaus

Lisää suljetun monikulmion markkimerkinnän (PDF /Subtype /Polygon) valitulle sivulle annetulla kärkiluettelolla. Monikulmio sulkeutuu implisiittisesti — katselimet yhdistävät viimeisen kärjen ensimmäiseen renderöidessään. Muodon voi halutessaan täyttää tasaisella sisäisellä värillä. Värikomponentit ja peittävyys ilmoitetaan skaalalla 0–1; Transparency ilmoitetaan skaalalla 0–100 (0 = täysin peittävä, 100 = täysin läpinäkyvä). Kirjasto korottaa asiakirjan version PDF 1.5:een, kun Polygon-merkintä tuotetaan alemman vähimmäisversion lukon alla. Määritelty standardissa ISO 32000-1 §12.5.6.9

Syntaksi

Delphi

Function TPDFlib.AddPolygonAnnotation(Const VertexCoords: WideString; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parametrit

VertexCoords — kärkikoordinaatit yhtenä merkkijonona vuorottelevia x/y-arvoja, jotka erotellaan välilyönneillä, pilkuilla, puolipisteillä tai sarkaimilla. Esimerkki: "100 100 200 100 200 200 100 200" määrittää neliön. Vaatii vähintään kaksi paria (neljä lukua) ja parillisen kokonaismäärän lukuja, muuten kutsu palauttaa arvon 0

BorderWidth — monikulmion ääriviivan viivan leveys nykyisessä yksikössä

BorderRed, BorderGreen, BorderBlue — ääriviivavärin RGB-komponentit (0–1), kirjoitetaan /C-tietueeseen

Filled — 1 tuottaa monikulmion rungolle sisäisen täyttövärin (/IC), 0 jättää sen täyttämättä

FillRed, FillGreen, FillBlue — sisäisen täyttövärin RGB-komponentit (0–1). Ohitetaan, kun Filled on 0

Title — merkinnän /T-tietueeseen kirjoitettava tekijän nimi. Ohita antamalla tyhjä merkkijono

Contents — merkintään liittyvän ponnahduksen sisältö. Ohita antamalla tyhjä merkkijono

Transparency — läpinäkyvyys prosentteina (0–100). Kirjasto muuntaa arvon muotoon PDF /CA = 1 - Transparency/100 ja rajaa sen sallitulle alueelle

Paluuarvo

1 onnistuessaan, 0 jos asiakirjaa ei ole valittuna, kärkimerkkijonoa ei voi jäsentää tai merkinnän luonti epäonnistui

Huomautukset

Merkinnän /Rect lasketaan automaattisesti kärkien laajuudesta plus reunuksen leveyteen suhteutettu täyte, jotta ääriviivan viiva pysyy merkinnän rajaus­laatikon sisällä

Valinnaisia edistyneitä tietueita, joita PDF-määritys kuvaa — /BE (reunusefekti, mukaan lukien pilvinen ääriviivatyyli), /IT (tarkoitus, mukaan lukien PolygonCloud ja PolygonDimension) ja /Measure — ei tuoteta tässä pisteessä. Ne voi liittää luonnin jälkeen kirjoittamalla ne suoraan merkintäsanakirjaan

Ääriviivavärin, reunuksen, sisällön tai suorakulmion ylikirjoittamiseen luonnin jälkeen käytä funktioita SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents ja SetAnnotRect