THotPDF.BuildLoadedPageSVG Method

Poskytuje správanie zostavenia SVG načítanej stránky pre pracovný postup geometrie stránky. Použite ho, keď okolitá rodina API potrebuje explicitnú kontrolu nad objektmi PDF, obsahom stránok, prostriedkami, zhodou s normami alebo diagnostikou

Deklarácia

function BuildLoadedPageSVG(PageIndex: Integer): AnsiString; overload;
function BuildLoadedPageSVG(PageIndex: Integer;
  EmbedFonts: boolean): AnsiString; overload;

Jednotka

HPDFDoc

Parametre

Návratová hodnota

Vráti hodnotu AnsiString

Poznámky k použitiu

• Cesty, dekódovaný text, image XObjects, inline obrázky a rekurzívne Form XObjects sa emitujú cez zdieľaný content-device interpreter; Form XObject začína s farbami platnými v mieste, kde sa kreslí
• Plátno pokrýva viditeľnú časť strany, jej /CropBox orezaný na jej /MediaBox (viď GetLoadedPageVisibleBox), otočený o /Rotate; ľavý dolný roh boxu sa mapuje na roh plátna aj vtedy, keď box nezačína v počiatku
• Text sa zapisuje ako UTF-8 s jednou pozíciou x na znak a xml:space="preserve", takže medzery zostávajú zachované; ligatúrové glyfy sa rozvinú na všetky znaky, ktoré zastupujú, a kódy, ktoré XML 1.0 nepripúšťa, sa stanú U+FFFD
• Umiestnenie textu rešpektuje celú textovú maticu vrátane character a word spacing, horizontálneho škálovania, rise a úprav TJ; renderovacie režimy 0 až 2 vypĺňajú, kreslia obrys alebo oboje, režim 3 nekreslí nič a glyfy textu zobrazeného v režimoch 4 až 7 sa navyše stanú orezávacou cestou od konca textového objektu (ET) po koniec graphics state
• Štandardne text používa nainštalované fonty: štandardných 14 rodín a ich TrueType náprotivky sa mapujú na Helvetica alebo Arial, Times New Roman a Courier New a ďalšie fonty sa pomenúvajú podľa svojej rodiny, aj s medzerami medzi slovami (MyriadPro, Myriad Pro), nasledované všeobecnou rodinou odvodenou z príznakov font descriptoru alebo z názvu. Tučný a kurzívny text dostáva font-weight a font-style zo štýlovej časti názvu fontu (Arial-BoldMT, Helvetica-Oblique, MinionPro-It) a z váhy, príznakov a italic angle font descriptoru
• S EmbedFonts nastaveným na True sa text vo fonte, ktorého TrueType alebo CFF program je vložený v PDF, kreslí z obrysov glyfov tohto programu. Každý glyf je definovaný raz ako <path> v <defs> a umiestnený cez <use> všade, kde sa vyskytuje, takže opakované znaky neopakujú svoje obrysy; režimy výplne a obrysu, šírky čiar a orezávanie textu nasledujú text rovnako ako pri SVG texte. Samotný text zostáva ako priehľadný SVG text nad obrysmi, takže ho možno stále vyberať, vyhľadávať v ňom a čítať asistívnymi technológiami
• Fonty, ktoré nie sú vložené, programy fontov Type 1 (/FontFile), vertikálny zápis CJK a behy s kódom, ktorý nemá vo vloženom programe glyf, zostávajú SVG textom aj s nastaveným EmbedFonts. Obrysy zväčšujú súbor, často dvojnásobne až trojnásobne pri stránkach s veľa textom
• Farby výplne a obrysu nastavené v ľubovoľnom farebnom priestore (DeviceGray, DeviceRGB, DeviceCMYK, ICCBased, kalibrované, Lab, Indexed, Separation a DeviceN) sa konvertujú na sRGB rovnako, ako ich konvertuje renderér strany
• Cesty vyplnené tiling patternom sa vyplnia SVG <pattern>, ktorý opakuje bunku patternu po každých XStep a YStep, orezanú na jeho /BBox; neofarbené patterny maľujú bunku farbou zadanou spolu s patternom. Cesty vyplnené shading patternom dostanú gradient alebo mesh svojho shadingu, orezané na cestu. Matica patternu sa aplikuje v priestore strany alebo formy, ktorá pattern používa. Ťahy s patternom používajú jeho farbu, pri farebných patternoch čiernu
• Osové shadingy Type 2 a radiálne shadingy Type 3 používajú prechody SVG s ohraničeným počtom vzorkovaných zarážok; koniec, ktorý Extend nerozširuje, zostáva nezakreslený, rovnako ako v PDF
• Mesh shadingy Type 4 až Type 7 používajú ohraničené priehľadné PNG ako data URI s maximálne 16 miliónmi pixelov
• Vložené obrázky sa dekódujú rovnakou cestou ako obrázky načítaného dokumentu a vkladajú sa ako PNG data URI
• Image masky, vrátane inline, sa stanú PNG obrázkami v aktuálnej farbe výplne, priehľadnými tam, kde nie je nič zakreslené; /SMask a /Mask stencil dajú obrázku alfa kanál, v rozlíšení masky, keď je jemnejšia než obrázok. Polia /Mask s farebným kľúčom urobia zodpovedajúce pixely priehľadnými pre Flate, LZW a nefiltrované obrázky
• Orezávacie cesty W a W* sa stanú prvkami SVG <clipPath>, ktoré končia spolu s grafickým stavom, v ktorom boli nastavené; Form XObjects sa orežú na svoj /BBox a osové a radiálne shadingy na svoj
• Text vo fontoch Type 3 sa kreslí glyfovými procedúrami fontu, umiestnenými cez jeho /FontMatrix, namiesto ako SVG text; glyfy začínajúce d1 maľujú aktuálnou farbou výplne. Glyfy Type 3 nepridávajú do orezávacej cesty renderovacích režimov 4 až 7
• Farebná položka Background shadingu vyplní oblasť shading patternu pred shadingom, takže je viditeľná všade, kde shading nekreslí; ako v PDF, ignoruje sa, keď sa shading kreslí cez sh
• Shadingy Type 1 založené na funkciách sa vzorkujú cez svoj Domain do PNG data URI s najviac 256 × 256 vzorkami, umiestnené cez Matrix shadingu; prehliadač ich pri škálovaní vyhladzuje

Súvisiace API

• THotPDF
• THPDFPage
• Obsah