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 rajauslaatikon 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