PDF3DAnnotation
Overview
PDF3DAnnotation is a class in Aspose.PDF FOSS for .NET.
Inherits from: Annotation.
A 3D annotation that shows 3D artwork (U3D or PRC data) in a rectangle on the page.
This class declares 15 methods for PDF3DAnnotation objects in .NET programs.
Available methods include: Accept, BaseParagraph, ChangeAfterResize, ClearImagePreview, Clone, Flatten, GetImagePreview, GetRectangle, PDF3DAnnotation, SetDefaultViewIndex, SetImagePreview, UpdateAppearances, and 1 additional methods.
Public members are accessible to any .NET application after installing the Aspose.PDF FOSS for .NET package.
Properties: Action, Actions, ActiveState, Alignment, AnnotationFlags, AnnotationState, and 47 more.
Properties
| Name | Type | Access | Description |
|---|---|---|---|
AnnotationType | AnnotationType | Read | Gets the annotation type. |
Pdf3DArtwork | PDF3DArtwork? | Read | The 3D artwork behind this annotation. |
DefaultView | PDF3DView? | Read | Default (annotation-level) 3D view: the 1-based SetDefaultViewIndex selection, the annotation’s own /3DV view, or the artwork’s first view. |
Content | PDF3DContent? | Read/Write | Gets or sets the 3D model data of the artwork, or null when there is no artwork. |
LightingScheme | PDF3DLightingScheme? | Read | Gets the lighting scheme of the artwork, or null when there is no artwork. |
RenderMode | PDF3DRenderMode? | Read | Gets the render mode of the artwork, or null when there is no artwork. |
ViewArray | PDF3DViewArray | Read | The artwork’s views; an annotation with no resolvable artwork (e.g. |
Rect | Rectangle? | Read/Write | The annotation rectangle (position on page). |
InnerRect | Rectangle? | Read | The annotation rectangle inset by the /RD (rectangle differences) entry — the region actually drawn inside Rect. |
Width | double | Read/Write | The width of the annotation rectangle. |
Height | double | Read/Write | The height of the annotation rectangle. |
ActiveState | string? | Read/Write | Currently-active appearance state (/AS entry). |
Alignment | TextAlignment | Read/Write | Text alignment (for free-text / widget annotations carrying rich text). |
HorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Read/Write | Horizontal alignment (exposed in addition to Alignment; the two are independently settable). |
TextHorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Read/Write | Text-specific horizontal alignment override. |
Appearance | AppearanceDictionary | Read | Appearance dictionary (/AP entry) — keyed by appearance stream name (N, D, R). |
States | AppearanceDictionary | Read | Appearance-state dictionary (the per-state sub-dict of AP/N, e.g. |
NormalAppearance | XForm? | Read | The annotation’s normal (/AP /N) appearance as an XForm, or null when it has none. |
Contents | string? | Read/Write | The annotation contents (text). |
Opacity | double | Read/Write | Annotation opacity (0.0 = transparent, 1.0 = opaque). |
Border | Border? | Read/Write | Annotation border. |
Color | Color | Read/Write | The annotation border color (/C entry). |
InteriorColor | Color? | Read/Write | The annotation interior color (/IC entry, for circle/square/line annotations). |
Title | string? | Read/Write | The annotation title (author for markup annotations). |
Name | string? | Read/Write | The annotation name (unique identifier — the /NM entry). |
FullName | string? | Read | Fully-qualified annotation name. |
Subject | string? | Read/Write | The annotation subject (/Subj entry). |
ModifiedDate | string? | Read | The modification date. |
Modified | DateTime | Read/Write | The /M (modified) date as a typed DateTime. |
Flags | AnnotationFlags | Read/Write | Annotation flags (/F entry) — used as the storage backing for both the int and typed forms. |
AnnotationFlags | AnnotationFlags | Read/Write | Typed alias of Flags matching the public surface that exposes AnnotationFlags as a property. |
Action | PdfAction? | Read/Write | The action associated with this annotation (/A entry). |
Actions | PdfActionCollection | Read | Collection of actions associated with this annotation. |
Author | string? | Read | The annotation author (/T entry). |
AnnotationState | string? | Read | The annotation state (/State entry), e.g. |
AnnotationStateModel | string? | Read | The annotation state model (/StateModel entry), e.g. |
ReplyType | string? | Read | The reply type (/RT entry), e.g. |
InReplyTo | Annotation? | Read/Write | The annotation this one is replying to (/IRT entry). |
QuadPoints | Point[] | Read/Write | QuadPoints as an array of Point values. |
PageIndex | int | Read | 1-based index of the page that owns this annotation. |
Page | Page? | Read | The page that owns this annotation, or null when it can’t be resolved (e.g. |
UpdateAppearanceOnConvert | bool | Read/Write | Whether to regenerate the appearance stream when an annotation is saved into a converted document. |
UseFontSubset | bool | Read/Write | Whether the embedded font (if any) should be subsetted. |
Characteristics | Characteristics | Read | Appearance characteristics (border color, background color, rotation). |
VerticalAlignment | VerticalAlignment | Read/Write | Vertical alignment applied to this paragraph. |
Margin | MarginInfo | Read/Write | Outer-margin info applied to this paragraph. |
IsFirstParagraphInColumn | bool | Read/Write | Force the paragraph to start a new column. |
IsKeptWithNext | bool | Read/Write | Keep this paragraph on the same page as the next one. |
IsInNewPage | bool | Read/Write | Force the paragraph to start on a new page. |
IsInLineParagraph | bool | Read/Write | Inline paragraph flag (does not start a new line). |
HyperlinkText | string? | Read/Write | Legacy string-typed hyperlink target. |
Hyperlink | Hyperlink? | Read/Write | Typed hyperlink decoration applied to the paragraph. |
ZIndex | int | Read/Write | Z-order index used by the DOM renderer. |
Methods
| Signature | Description |
|---|---|
PDF3DAnnotation(page: Page, rect: Rectangle, pdf3DArtwork: PDF3DArtwork) | Creates a 3D annotation (/3D) on page at rect that shows the given 3D artwork. |
PDF3DAnnotation(page: Page, rect: Rectangle, pdf3DArtwork: PDF3DArtwork, activation: PDF3DActivation) | Creates a 3D annotation on page at rect for the given artwork. |
Accept(visitor: AnnotationSelector) | Calls Accept(visitor) on this PDF3DAnnotation instance. |
SetDefaultViewIndex(index: int) | Selects which view of the artwork’s view array is the default view, by 1-based index; an out-of-range index is ignored. |
GetImagePreview() | The annotation’s poster image. |
SetImagePreview(image: Stream) | Sets the poster (preview) image from the bytes of image; null clears it. |
SetImagePreview(filename: string) | Sets the poster (preview) image from the file at filename; a missing file clears it. |
ClearImagePreview() | Calls ClearImagePreview on this PDF3DAnnotation instance. |
GetRectangle(considerRotation: bool) | Bounding rectangle adjusted by considerRotation. |
ChangeAfterResize(transform: Matrix) | Adjust the annotation’s geometry after the user resized the page or the host rectangle. |
WriteXfdf(writer: System.Xml.XmlWriter) | Serialize this annotation as an XFDF element to writer (PDF 32000 §12.7.8 / XFDF 3.0). |
UpdateAppearances() | Regenerate the normal appearance stream (/AP /N) from the annotation’s current geometry and colours. |
Flatten() | Flatten this annotation — render its visual appearance into the page content and remove it from the page’s annotations array. |
BaseParagraph() | Creates a paragraph with default alignment, an empty margin and no hyperlink. |
Clone() | Shallow clone — copies scalar/ref-shared state. |
