[]
        
(Showing Draft Content)

GrapeCity.Documents.Pdf.Annotations.Model3DAnnotation

Model3DAnnotation Class

Represents a 3D annotation. 3D annotations are the means by which 3D artwork shall be represented in a PDF document.

Namespace: GrapeCity.Documents.Pdf.Annotations
Assembly: DS.Documents.Pdf.dll
Syntax
public class Model3DAnnotation : AnnotationBase, IOwnedObject, IContentItem, IPdfDict
Public Class Model3DAnnotation
    Inherits AnnotationBase
    Implements IOwnedObject, IContentItem, IPdfDict

Constructors

Name Description
Model3DAnnotation()

Initializes a new instance of the Model3DAnnotation class.

Properties

Name Description
ActivationCondition

Gets or sets the IPdfName object specifying the circumstances under which the annotation shall be activated. The Model3DActivationCondition static class defines the values listed in the PDF specification; this list may be extended in future revisions.

DeactivationCondition

Gets or sets the IPdfName object specifying the circumstances under which the annotation shall be deactivated. The Model3DDeactivationCondition static class defines the values listed in the PDF specification; this list may be extended in future revisions.

PresentationStyle

Gets or sets the IPdfName object specifying the style of presentation of the 3D model (embedded or windowed). The Model3DPresentationStyle static class defines the values listed in the PDF specification; this list may be extended in future revisions.

ShowToolbar

Gets or sets the value indicating the default behavior of an interactive toolbar associated with this annotation. If true, the toolbar should be displayed when the annotation is activated and given focus. If false, the toolbar should not be displayed.

Stream

Gets or sets Model3DStream object defining 3D content of the annotation.

Transparent

Gets or sets the value indicating whether the interactive PDF processor shall display the underlying page content through the transparent areas of the rich media content.

Methods

Name Description
Get3DContent()

Retrieves the 3D stream content from this annotation without format information.

Get3DContent(out IPdfName)

Retrieves the 3D stream content from this annotation and its format.

GetDefaultView()

Resolves and returns the default initial Model3DView for this annotation.

The PDF specification allows the default view to be specified in multiple places and using different forms (for example, by name or by index). This method encapsulates the logic to find and return the effective default view that should be used when the annotation is activated.

Typical resolution behavior:

  • Inspect annotation-level settings that explicitly identify a default view.
  • If not found, inspect the associated 3D stream(s) for a named or indexed default view.
  • If the default is specified by name, the view with a matching Name is returned.
  • If specified by index, the view at that index in the stream's view list is returned.

If no explicit default view is defined or the referenced view cannot be resolved, the method returns null.

Set3DContent(Stream, IPdfName)

Sets the 3D stream content for this annotation.

SetDefaultView(Model3DView)

Sets the default initial Model3DView for this annotation.

SetDefaultView(int)

Sets the default initial view by specifying the zero-based index of a view in the associated 3D stream's Views collection.

SetPreviewAppearance(IImage)

Sets the preview appearance for this 3D annotation using a raster image.

Extension Methods