AddInkAnnotation

Merkinnät ja hotspot-linkit

Kuvaus

Lisää mustemerkkimarkkimerkinnän (PDF /Subtype /Ink), joka esittää yhtä tai useampaa käsin piirrettyä viivaa, vapaata merkintää tai vapaakätistä luonnosta sivulla. Sanakirjatietue /InkList sisältää viivojen taulukon; jokainen viiva on vuorottelevia x/y-koordinaatteja sisältävä taulukko, joka esittää osoitinlaitteen kulkemaa polkua kynän laskun ja nousun välillä. 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ä). Koska tämä piste tuottaa PDF 1.4:n merkintäavaimen /CA, kirjasto korottaa vanhemmat lukitsemattomat asiakirjat PDF 1.4:ään ennen tallennusta; lukitut alemmat kohteet hylätään yhteensopivuusportissa. Määritelty standardissa ISO 32000-1 §12.5.6.13

Syntaksi

Delphi

Function TPDFlib.AddInkAnnotation(Const InkPaths: WideString; BorderWidth: Double; InkRed, InkGreen, InkBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parametrit

InkPaths — yksi tai useampi viiva yhtenä merkkijonona koodattuna. Viivat erotellaan merkillä '|' tai rivinvaihdolla (CR / LF / CRLF). Kunkin viivan sisällä koordinaattiparit noudattavat samaa erottimikäytäntöä kuin AddPolygonAnnotation: vuorottelevat x/y-arvot eroteltuina välilyönneillä, pilkuilla, puolipisteillä tai sarkaimilla. Esimerkki: "100 100 110 105 120 110 | 200 200 210 205" kuvaa kaksi erillistä viivaa. Jokaisen viivan on sisällettävä vähintään kaksi koordinaattiparia (neljä lukua) ja parillinen kokonaismäärä arvoja, muuten kutsu palauttaa arvon 0

BorderWidth — mustteen viivan leveys nykyisessä yksikössä

InkRed, InkGreen, InkBlue — mustteen värin RGB-komponentit (0–1), kirjoitetaan /C-tietueeseen

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 mikään asiakirja ei ole valittuna, mustemerkkijonoa ei voi jäsentää kelvolliseksi viivaluetteloksi tai merkinnän luonti epäonnistui

Huomautukset

Merkinnän /Rect lasketaan automaattisesti kaikkien viivojen yhteisestä laajuudesta plus pieni reunuksen leveyteen suhteutettu täyte, jotta renderöidyt viivat pysyvät merkinnän rajaus­laatikon sisällä

Tämä piste sopii sekä kosketus- tai kynälaitteesta kaapatulle käsialalle että ohjelmallisesti luoduille vapaakätisille muodoille kuten tussauksille tai muista työkaluista tuoduille merkinnöille. Mustteen värin, reunuksen, sisällön tai suorakulmion voi ylikirjoittaa luonnin jälkeen funktioilla SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents ja SetAnnotRect