Page – Aspose FOSS API Reference

Page

Обзор

Page является типом в Aspose.PDF FOSS для Go.

Page — это живой просмотр одной страницы внутри Document.

Этот тип предоставляет 58 методов для работы с объектами Page в Go-программах. Доступные методы включают: AddFloatingBox, AddForm, AddImage, AddImageFromStream, AddInlineImage, AddInlineImageFromStream, AddMarkdown, AddSVG, AddSVGFromStream, AddSVGObject, AddStamp, AddTOC и ещё 46 методов. Все публичные члены доступны любой Go-приложению после установки пакета Aspose.PDF FOSS for Go.

Методы

Подпись	Описание:
`RenderBMP(w: io.Writer, opts: RenderOptions)` → `error`	RenderBMP рендерит страницу и записывает её как несжатый BMP.
`AddFloatingBox(box: *FloatingBox, rect: Rectangle)` → `error`	AddFloatingBox рисует коробку в абсолютной позиции внутри rect: она закрашивает фон и границу, затем размещает содержимое коробки внутри rect за вычетом padding (содержимое, выходящее за пределы коробки, обрезается).
`Forms()` → `[]*XForm`	Forms возвращает Form XObjects, на которые ссылаются ресурсы страницы — уже присутствующие переиспользуемые группы контента (например.
`AddForm(form: *XForm, rect: Rectangle)` → `error`	AddForm размещает форму на странице так, чтобы её рамка соответствовала rect, сохраняя собственный масштаб формы по каждой оси.
`ExtractImages()` → `([]Image, error)`	ExtractImages возвращает все изображения, найденные на странице.
`ImageInfos()` → `([]ImageInfo, error)`	ImageInfos возвращает метаданные всех изображений, найденных на странице, без декодирования пиксельных данных.
`AddImage(path: string, rect: Rectangle)` → `error`	AddImage добавляет изображение из файла на страницу в пределах заданного прямоугольника.
`AddImageFromStream(r: io.Reader, rect: Rectangle)` → `error`	AddImageFromStream добавляет изображение из reader на страницу в заданном прямоугольнике.
`AddInlineImage(path: string, rect: Rectangle)` → `error`	AddInlineImage рисует небольшое изображение непосредственно в поток содержимого страницы как встроенное изображение (BI … ID … EI, ISO 32000-1 §8.9.7), а не как Image XObject.
`AddInlineImageFromStream(r: io.Reader, rect: Rectangle)` → `error`	AddInlineImageFromStream — вариант AddInlineImage с использованием io.Reader.
`AddMarkdown(md: string, rect: Rectangle, opts: ...MarkdownOptions)` → `error`	AddMarkdown отображает фрагмент Markdown внутри прямоугольника.
`BeginLayer(layer: *Layer)` → `error`	BeginLayer начинает секцию помеченного контента на странице, назначенной слою: контент, отрисованный после этого вызова (AddText, Draw*, AddImage, …) принадлежит слою до EndLayer.
`EndLayer()` → `error`	EndLayer закрывает раздел отмеченного содержимого, открытый BeginLayer.
`Number()` → `int`	Number возвращает номер страницы в документе, начинающийся с 1.
`Annotations()` → `*AnnotationCollection`	Annotations возвращает коллекцию аннотаций страницы.
`Size()` → `(PageSize, error)`	Size возвращает размеры страницы из её MediaBox.
`Rotation()` → `RotationAngle`	Rotation возвращает эффективный поворот страницы в градусах (0, 90, 180, 270).
`MediaBox()` → `(Rectangle, error)`	MediaBox возвращает MediaBox страницы в виде Rectangle в пользовательском пространстве PDF.
`CropBox()` → `(Rectangle, error)`	CropBox возвращает crop box страницы в виде Rectangle.
`TrimBox()` → `(Rectangle, error)`	TrimBox возвращает trim box страницы в виде Rectangle.
`BleedBox()` → `(Rectangle, error)`	BleedBox возвращает bleed box страницы в виде Rectangle.
`ArtBox()` → `(Rectangle, error)`	ArtBox возвращает art box страницы в виде Rectangle.
`SetMediaBox(rect: Rectangle)` → `error`	SetMediaBox задает MediaBox страницы (полный прямоугольник страницы) в пользовательском пространстве PDF.
`SetCropBox(rect: Rectangle)` → `error`	SetCropBox задает CropBox страницы (видимая область).
`SetTrimBox(rect: Rectangle)` → `error`	SetTrimBox устанавливает TrimBox страницы (предполагаемые конечные размеры).
`SetBleedBox(rect: Rectangle)` → `error`	SetBleedBox устанавливает BleedBox страницы (область вылета при печати).
`SetArtBox(rect: Rectangle)` → `error`	SetArtBox устанавливает ArtBox страницы (границы значимого содержимого).
`SetPageSize(width: float64)` → `error`	SetPageSize изменяет размер страницы, устанавливая её MediaBox в [0 0 width height] (точки).
`Label()` → `string`	Label возвращает отформатированную метку страницы для этой страницы, как определено в дереве номеров /PageLabels документа (PDF spec §12.4.2).
`Paragraphs()` → `(PageMarkup, error)`	Paragraphs возвращает текст страницы, сгруппированный в колонки (sections) и абзацы.
`RenderImage(opts: RenderOptions)` → `(image.Image, error)`	RenderImage растеризует страницу в *image.RGBA с запрошенным DPI.
`RenderPNG(w: io.Writer, opts: RenderOptions)` → `error`	RenderPNG рендерит страницу и записывает её как PNG.
`RenderJPEG(w: io.Writer, opts: RenderOptions, quality: int)` → `error`	RenderJPEG отображает страницу и сохраняет её в формате JPEG.
`RenderGIF(w: io.Writer, opts: RenderOptions)` → `error`	RenderGIF отображает страницу и сохраняет её в формате GIF (256 цветов, с квантизацией).
`ReplaceText(old: string, opts: ...ReplaceOptions)` → `(int, error)`	ReplaceText заменяет каждое вхождение old на replacement на странице и возвращает количество выполненных замен.
`AddStamp(s: Stamp)` → `error`	AddStamp наносит штамп на страницу.
`AddSVG(path: string, rect: Rectangle)` → `error`	AddSVG считывает файл SVG и отображает его в заданном прямоугольнике на странице.
`AddSVGFromStream(r: io.Reader, rect: Rectangle)` → `error`	AddSVGFromStream рендерит SVG из любого io.Reader в указанный прямоугольник на странице.
`AddSVGObject(svg: *SVG, rect: Rectangle)` → `error`	AddSVGObject рендерит предварительно разобранный SVG в указанный прямоугольник на странице.
`AddTable(t: *Table, rect: Rectangle)` → `(int, error)`	AddTable рендерит таблицу внутри заданного прямоугольника.
`TagContent(parent: StructElement, t: StructType, draw: func() error)` → `(StructElement, error)`	TagContent рисует блок содержимого страницы (всё, что выдаёт draw-callback) внутри последовательности помеченного контента и добавляет соответствующий листовой структурный элемент типа t как дочерний элемент parent (nil = корень документа).
`TagArtifact(draw: func() error)` → `error`	TagArtifact заключает блок рисования страницы в последовательность отмеченного содержимого /Artifact, поэтому он рассматривается как декорация и исключается из дерева логической структуры.
`AddTaggedList(tc: TaggedContent, parent: StructElement, items: []string, style: TextStyle, rect: Rectangle, ordered: bool)` → `(*StructElement, error)`	AddTaggedList создает маркированный (ordered=false) или нумерованный (ordered=true) список элементов внутри rect и формирует его доступную структуру: элемент /L под родителем (nil = корень документа), с элементом /LI для каждого пункта, содержащим /Lbl (маркер/номер) и /LBody (текст пункта).
`AddTaggedTable(tc: TaggedContent, parent: StructElement, t: Table, rect: Rectangle)` → `(StructElement, int, error)`	AddTaggedTable отображает t внутри rect так же, как AddTable, и одновременно строит логическую структуру таблицы (/Table → /TR → /TH/TD) под родителем (nil = корень документа), помечая содержимое каждой ячейки как отмеченное содержимое и заключая фоны и границы ячеек в /Artifact.
`ExtractText(opts: ...TextExtractOptions)` → `(string, error)`	ExtractText возвращает текстовое содержимое страницы.
`AddText(text: string, style: TextStyle, rect: Rectangle)` → `error`	AddText рисует текст внутри прямоугольника, используя заданный стиль.
`ExtractTextWithLayout()` → `([]TextLine, error)`	ExtractTextWithLayout возвращает структурированные строки текста, отсортированные в визуальном порядке чтения (сверху вниз, слева направо).
`SearchText(query: string, opts: ...SearchOptions)` → `([]TextMatch, error)`	SearchText ищет каждое вхождение запроса на странице и возвращает совпадения в визуальном порядке чтения (сверху вниз, слева направо).
`RenderTIFF(w: io.Writer, opts: RenderOptions)` → `error`	RenderTIFF рендерит страницу и сохраняет её как одностраничный Deflate TIFF.
`AddTOC(entries: []TOCEntry, rect: Rectangle, opts: ...TOCOptions)` → `(int, error)`	AddTOC создает таблицу содержания из предоставленного списка записей в rect на этой странице.
`DrawLine(from: Point, style: LineStyle)` → `error`	DrawLine рисует один отрезок от→до с заданным стилем.
`DrawRectangle(rect: Rectangle, style: ShapeStyle)` → `error`	DrawRectangle рисует и/или заполняет прямоугольник, выровненный по осям.
`DrawCircle(center: Point, radius: float64, style: ShapeStyle)` → `error`	DrawCircle рисует и/или заполняет круг.
`DrawEllipse(center: Point, rx: float64, style: ShapeStyle)` → `error`	DrawEllipse обводит и/или заполняет эллипс, выровненный по осям.
`DrawPolyline(points: []Point, style: LineStyle)` → `error`	DrawPolyline обводит открытую полилинию (первая и последняя точки НЕ соединены).
`DrawPath(path: *Path, style: ShapeStyle)` → `error`	DrawPath обводит и/или заполняет ранее построенный путь.
`DrawRoundedRectangle(rect: Rectangle, radius: float64, style: ShapeStyle)` → `error`	DrawRoundedRectangle обводит и/или заполняет прямоугольник, выровненный по осям, с закруглёнными углами заданного радиуса.
`DrawPolygon(points: []Point, style: ShapeStyle)` → `error`	DrawPolygon рисует штрихи и/или заполняет закрытый многоугольник (последняя точка соединяется с первой через `h`).

См. также:

Aspose.PDF — Enterprise API Reference