Document

Přehled

Document je typ v Aspose.PDF FOSS pro Go.

Document je PDF dokument.

Tento typ poskytuje 88 metod pro práci s objekty Document v programech Go. Dostupné metody zahrnují: AddBlankPage, AddBlankPageFromFormat, AddLayer, AddSVGObjectWatermark, AddSVGWatermark, AddSVGWatermarkFromStream, AddStamp, AddTextWatermark, Append, ApplyRedactions, Booklet, ChangePassword a 76 dalších metod. Všichni veřejní členové jsou přístupní jakékoli aplikaci Go po instalaci balíčku Aspose.PDF FOSS pro Go.

Metody

Podpis:	Popis:
`PageCount()` → `int`	PageCount vrací počet stránek v dokumentu.
`Pages()` → `[]*Page`	Pages vrací živý pohled na všechny stránky v dokumentu.
`Page(n: int)` → `(*Page, error)`	Page vrací živý pohled na stránku na daném čísle počínaje jedničkou.
`Append(others: ...*Document)`	Append přidává všechny stránky z ostatních do tohoto dokumentu a slučuje jejich objekty.
`RemoveUnusedObjects()` → `int`	RemoveUnusedObjects odstraňuje objekty z dokumentu, které nejsou dosažitelné z žádné stránky.
`SetPassword(userPassword: string)`	SetPassword nastavuje, aby byl dokument šifrován při uložení.
`SetPermissions(p: Permissions)`	SetPermissions nastavuje, jaké operace může prohlížeč provádět na šifrovaném dokumentu (tisk, kopírování, úpravy atd.).
`Permissions()` → `(Permissions, bool)`	Permissions vrací nastavení oprávnění prohlížeče aktuálně nakonfigurovaná v tomto dokumentu, plus pravdivostní hodnotu, která udává, zda je dokument vůbec nastaven na šifrování.
`RemoveEncryption()`	RemoveEncryption vymaže jakékoli dříve nastavené šifrování (hesla a oprávnění), takže další uložení vytvoří PDF v prostém textu.
`ChangePassword(newUserPassword: string)` → `error`	ChangePassword znovu zašifruje dokument novými hesly při dalším uložení, přičemž zachová aktuální šifrovací algoritmus a oprávnění.
`SetEncryption(opts: EncryptionOptions)`	SetEncryption nakonfiguruje všechna nastavení související s šifrováním najednou ze struktury EncryptionOptions.
`WriteTo(w: io.Writer)` → `(int64, error)`	WriteTo zapíše dokument do w.
`Save(outputPath: string)` → `error`	Save zapíše dokument do outputPath.
`AddBlankPage(width: float64)` → `error`	AddBlankPage přidá prázdnou stránku na konec dokumentu.
`AddBlankPageFromFormat(format: PageFormat)` → `error`	AddBlankPageFromFormat přidá prázdnou stránku pomocí předdefinovaného formátu stránky.
`InsertBlankPage(position: int, width: float64)` → `error`	InsertBlankPage vloží prázdnou stránku na zadanou pozici číslovanou od jedné.
`InsertBlankPageFromFormat(position: int, format: PageFormat)` → `error`	InsertBlankPageFromFormat vloží prázdnou stránku na zadanou pozici pomocí předdefinovaného formátu stránky.
`Rotate(angle: RotationAngle, pageNums: ...int)` → `error`	Rotate otáčí vybrané stránky po směru hodinových ručiček o úhel (Rotate90, Rotate180 nebo Rotate270).
`SetRotation(angle: RotationAngle, pageNums: ...int)` → `error`	SetRotation nastaví vybrané stránky na přesný úhel (Rotate0, Rotate90, Rotate180 nebo Rotate270), nahrazuje jakoukoli existující rotaci.
`Reorder(order: []int)` → `error`	Reorder přeuspořádá stránky podle pořadí, což je výřez čísel stránek číslovaných od jedné.
`DeletePage(n: int)` → `error`	DeletePage odstraňuje stránku na zadaném čísle (počítáno od 1).
`DeletePages(pageNums: ...int)` → `error`	DeletePages odstraňuje stránky na zadaných číslech (počítáno od 1).
`Split()` → `([]*Document, error)`	Split vrací každou stránku dokumentu jako samostatný *Document.
`Extract(ranges: ...PageRange)` → `(*Document, error)`	Extract vrací nový Document, který obsahuje pouze stránky ve specifikovaných rozsazích.
`EmbeddedFiles()` → `*EmbeddedFiles`	EmbeddedFiles vrací kolekci vložených souborů na úrovni dokumentu.
`Flatten()` → `error`	Flatten zakóduje interaktivní formulářová pole dokumentu do statického obsahu stránky a odstraní AcroForm, takže výsledek se vykresluje identicky, ale již není vyplnitelný.
`NewFlow(opts: FlowOptions)` → `*Flow`	NewFlow vytvoří tok, který se vykreslí do dokumentu d.
`LoadFont(path: string)` → `(Font, error)`	LoadFont načte soubor TTF, parsuje jej, vloží jej do dokumentu a vrátí písmo, které lze použít v TextStyle.Font.
`LoadFontFromStream(r: io.Reader)` → `(Font, error)`	LoadFontFromStream je jako LoadFont, ale čte z io.Readeru.
`LoadFontByName(family: string, bold: bool)` → `(Font, error)`	LoadFontByName vyhledá font podle názvu rodiny (s volitelným tučným / kurzívním stylem) prostřednictvím FontRepository — nejprve složky a soubory zaregistrované v AddFontFolder / AddFontFile, poté adresáře fontů operačního systému — vloží odpovídající typ písma do dokumentu a vrátí objekt Font použitelný v TextStyle.Font.
`SubsetFonts()` → `(int, error)`	SubsetFonts zmenšuje každý vložený TTF (načtený přes LoadFont) pouze na skutečně vykreslené glyfy, nahrazuje každý /FontFile2 přestavěným podmnožinovým programem a přepíná /CIDToGIDMap CIDFontu z /Identity na stream, který mapuje původní ID glyfů (stále používána doslovně jako CID v obsahových streamech) na kompaktní ID glyfů podmnožiny.
`Form()` → `*Form`	Form vrací AcroForm dokumentu.
`CreateForm(width: float64)` → `*XForm`	CreateForm vytvoří prázdný Form XObject dané velikosti (v bodech).
`ImportForm(form: XForm)` → `(XForm, error)`	ImportForm kopíruje Form XObject (a celý jeho graf zdrojů: fonty, obrázky, vnořené formuláře, …) z jiného dokumentu do tohoto, a vrací nový XForm připravený k umístění pomocí Page.AddForm.
`ConvertToGrayscale()` → `error`	ConvertToGrayscale převádí dokument na odstíny šedé přímo: každá zařízení barva nastavená v obsahovém proudu (text, vektorová grafika), každý rastrový obrázek, stínování a barva anotace jsou mapovány na jejich luminanční šedou.
`SaveHTML(outputPath: string, opts: ...HTMLSaveOptions)` → `error`	SaveHTML zapisuje dokument jako soubor HTML — ve výchozím nastavení samostatný; s ResourceDir/ResourceWriter se těžké části stanou externími soubory a s SplitPages se každá stránka stane vlastním _p.html.
`WriteHTML(w: io.Writer, opts: ...HTMLSaveOptions)` → `error`	WriteHTML zapisuje dokument jako jediný samostatný soubor HTML do w: na stránku, rastrové pozadí pod textovou vrstvou (průhledné v HTMLModeFaithful, viditelné v HTMLModeText) a překryvy odkazových anotací.
`ExtractImages()` → `([][]Image, error)`	ExtractImages vrací obrázky ze všech stránek (jeden řez na stránku).
`ImageInfos()` → `([][]ImageInfo, error)`	ImageInfos vrací metadata obrázku pro všechny stránky (jedna část na stránku) bez dekódování pixelových dat.
`OptimizeImages(opts: OptimizeImageOptions)` → `(int, error)`	OptimizeImages optimalizuje všechny obrázky v dokumentu, aby snížil velikost souboru.
`NUp(opts: NUpOptions)` → `(*Document, error)`	NUp vrací nový Document, který umisťuje stránky tohoto dokumentu na větší listy v mřížce Řádky×Sloupce (např.
`Booklet(opts: BookletOptions)` → `(*Document, error)`	Booklet vrací nový Document, který umisťuje stránky tohoto dokumentu po dvou, přeuspořádané pro vazbu typu saddle-stitch: tisknout oboustranně, složit hromádku na polovinu a stránky se čtou v pořadí.
`JavaScript()` → `*JavaScriptCollection`	JavaScript vrací kolekci JavaScript na úrovni dokumentu.
`SaveLinearized(outputPath: string)` → `error`	SaveLinearized zapisuje dokument do outputPath jako linearizovaný („fast web view“) PDF (ISO 32000-1 Annex F): objekty první stránky a tabulka nápověd jsou umístěny na začátku, aby si prohlížeč mohl vykreslit stránku 1 před stažením celého souboru.
`WriteToLinearized(w: io.Writer)` → `(int64, error)`	WriteToLinearized zapisuje dokument jako linearizovaný PDF do w (implementuje kontrakt ve stylu io.WriterTo).
`Info()` → `(DocumentInfo, error)`	Info vrací metadata slovníku Info z tohoto dokumentu.
`SetInfo(info: DocumentInfo)`	SetInfo nahrazuje Info slovník dokumentu danými metadaty.
`ClearInfo()`	ClearInfo odstraňuje slovník Info úplně.
`NamedDestinations()` → `*NamedDestinations`	NamedDestinations vrací kolekci pojmenovaných destinací dokumentu.
`OpenAction()` → `Action`	OpenAction vrací akci, kterou prohlížeč spustí při otevření dokumentu (/Catalog/OpenAction podle ISO 32000-1 §12.3.2 / §12.6.1), nebo nil, pokud není nastavena.
`SetOpenAction(act: Action)`	SetOpenAction nastaví akci, která se spustí při otevření dokumentu.
`RemoveOpenAction()`	RemoveOpenAction vymaže jakýkoli /Catalog/OpenAction.
`AddLayer(name: string)` → `*Layer`	AddLayer vytvoří novou vrstvu (OCG) s názvem name a zaregistruje ji v dokumentových vlastnostech volitelného obsahu.
`Layers()` → `[]*Layer`	Layers vrací vrstvy (OCG) dokumentu v pořadí /OCProperties/OCGs.
`Outlines()` → `*OutlineItemCollection`	Outlines vrací kořenovou kolekci osnov dokumentu.
`SetPageLabels(ranges: []PageLabelRange)` → `error`	SetPageLabels nainstaluje číslicové stromové uspořádání dokumentu /PageLabels, aby PDF prohlížeče zobrazovaly štítky jako “i, ii, 1, 2, …” v navigačním panelu a ukazatelích stránek.
`ClearPageLabels()`	ClearPageLabels odstraňuje položku /PageLabels v dokumentu.
`Paragraphs()` → `([]PageMarkup, error)`	Paragraphs vrací strukturovaný text každé stránky.
`ConvertToPDFA(format: PDFAFormat)` → `(*PDFAValidationReport, error)`	ConvertToPDFA upravuje dokument směrem k PDF/A “b”-level profilu shody a vrací validační zprávu popisující veškerá zbývající porušení.
`ValidateRedactions()` → `error`	ValidateRedactions provádí předběžnou suchou kontrolu parsovatelnosti na každé stránce, která obsahuje alespoň jeden RedactAnnotation.
`ApplyRedactions()` → `error`	ApplyRedactions destruktivně odstraňuje obsah (textové glyfy, obrazové XObjecty, cesty) uvnitř každé anotace /Redact v /QuadPoints (nebo /Rect, pokud je /QuadPoints prázdný).
`RenderImage(pageNum: int, opts: RenderOptions)` → `(image.Image, error)`	RenderImage vykresluje číslo stránky počítané od jedné do obrázku.
`RenderTIFF(w: io.Writer, opts: RenderOptions, pageNums: ...int)` → `error`	RenderTIFF vykresluje dokument do jediného více-stránkového TIFF souboru zapsaného do w.
`ReplaceText(old: string, opts: ...ReplaceOptions)` → `(int, error)`	ReplaceText nahrazuje každý výskyt řetězce old řetězcem replacement na všech stránkách a vrací celkový počet nahrazení.
`Sign(opts: SignOptions)` → `error`	Sign konfiguruje digitální podpis aplikovaný na následující Save/WriteTo.
`VerifySignatures()` → `([]SignatureVerification, error)`	VerifySignatures ověřuje každý digitální podpis v dokumentu a vrací jeden výsledek na pole podpisu, v pořadí dokumentu.
`AddStamp(s: Stamp, pageNums: ...int)` → `error`	AddStamp vykreslí razítko na zadané stránky číslované od 1 (všechny stránky, pokud nejsou zadány) — praktické pro vodoznaky, záhlaví, zápatí a čísla stránek.
`LoadSVG(path: string)` → `(*SVG, error)`	LoadSVG načte a parsuje SVG soubor jednou, vrací *SVG, které může být předáno do Page.AddSVGObject nebo Document.AddSVGObjectWatermark vícekrát bez opětovného parsování.
`LoadSVGFromStream(r: io.Reader)` → `(*SVG, error)`	LoadSVGFromStream je varianta LoadSVG typu io.Reader.
`AddSVGWatermark(path: string, pageNums: ...int)` → `error`	AddSVGWatermark aplikuje SVG vodoznak na všechny stránky (když je pageNums prázdný) nebo na specifikovaná čísla stránek číslovaná od 1.
`AddSVGWatermarkFromStream(r: io.Reader, pageNums: ...int)` → `error`	AddSVGWatermarkFromStream je varianta io.Reader pro AddSVGWatermark.
`SetSVGFontResolver(fn: SVGFontResolver)`	SetSVGFontResolver instaluje vlastní resolver.
`AddSVGObjectWatermark(svg: *SVG, pageNums: ...int)` → `error`	AddSVGObjectWatermark používá předem parsovaný *SVG pro obsah vodoznaku.
`TaggedContent()` → `*TaggedContent`	TaggedContent vrací fasádu označeného obsahu dokumentu, při první volání vytváří strom struktury a katalogové položky /MarkInfo, /ViewerPreferences a /StructTreeRoot.
`ExtractText(opts: ...TextExtractOptions)` → `([]string, error)`	ExtractText vrací textový obsah každé stránky (jeden záznam na stránku, indexováno od nuly).
`AddTextWatermark(text: string, style: TextStyle, pageNums: ...int)` → `error`	AddTextWatermark přidá textový vodoznak na vybrané stránky dokumentu.
`ExtractTextWithLayout()` → `([][]TextLine, error)`	ExtractTextWithLayout vrací strukturované textové řádky pro každou stránku.
`SearchText(query: string, opts: ...SearchOptions)` → `([]TextMatch, error)`	SearchText najde všechny výskyty dotazu ve všech stránkách dokumentu a vrátí shody stránka po stránce v pořadí čtení.
`GenerateTOC(opts: ...TOCOptions)` → `(int, error)`	GenerateTOC vytvoří obsah z osnovy (záložky) dokumentu a vloží jej jako novou stránku (stránky) na začátek dokumentu.
`ValidatePDFA(format: PDFAFormat)` → `*PDFAValidationReport`	ValidatePDFA kontroluje dokument vůči PDF/A konformačnímu profilu úrovně „b“ a vrací zprávu o porušeních.
`ValidatePDFUA()` → `*PDFUAValidationReport`	ValidatePDFUA kontroluje dokument vůči podmnožině PDF/UA-1 (ISO 14289-1, univerzální přístupnost) a vrací zprávu o porušeních.
`CreateTilingPattern(width: float64)` → `*TilingPattern`	CreateTilingPattern vytvoří prázdný dlaždicový vzor, jehož buňka je width×height bodů.
`XMP()` → `(XMPMetadata, error)`	XMP vrací XMP metadata dokumentu načtená ze streamu /Catalog/Metadata.
`XMPRaw()` → `([]byte, error)`	XMPRaw vrací surové bajty XMP paketu ze /Catalog/Metadata, nebo nil, pokud dokument nemá XMP stream.
`SetXMP(meta: XMPMetadata)` → `error`	SetXMP serializuje metadata do standardního XMP balíčku a ukládá je jako stream /Catalog/Metadata (nekomprimovaný, /Type /Metadata /Subtype /XML podle ISO 32000-1 §14.3.2).
`SetXMPRaw(data: []byte)` → `error`	SetXMPRaw ukládá data doslovně jako stream /Catalog/Metadata — únikovou cestu pro volající, kteří vytvářejí vlastní XMP balíček.
`ClearXMP()`	ClearXMP odstraňuje položku /Catalog/Metadata.
`SyncInfoToXMP()` → `error`	SyncInfoToXMP vytvoří XMP balíček ze současného slovníku /Info dokumentu a nainstaluje jej, aby si oba úložiště metadat byla v souladu (ISO 32000-1 §14.3.2 doporučuje konzistenci, když jsou přítomny oba).

Viz také:

Aspose.PDF — Enterprise API Reference