Some test text!

Overview
Documentation
All Products
Search
Downloads
Chat with us
Discord Logo
Hamburger Icon

Web / Guides / Ellipse

Ellipse Annotations

Ellipse annotations are one of the basic shapes for annotating. You can use this to circle certain areas on a document to bring attention to them.

Ellipse annotations can have both a fill and stroke color. The stroke or border style can also be changed to between a solid or dashed. The cloudy style is not supported.

Ellipse annotation

Instantiation

WebViewer(...)
  .then(instance => {
    const { documentViewer, annotationManager, Annotations } = instance.Core;

    documentViewer.addEventListener('annotationsLoaded', () => {
      const annot = new Annotations.EllipseAnnotation({
        PageNumber: 1,
        X: 100,
        Y: 50,
        Width: 150,
        Height: 25,
        StrokeColor: new Annotations.Color(0, 255, 0, 1), 
      });

      annotationManager.addAnnotation(annot);
      annotationManager.redrawAnnotation(annot);
    });
  });
XFDF
Element name: circle
<circle page="0" rect="241.520,578.270,344.750,641.790" color="#E44234" flags="print" name="600ca455-44a4-f8ff-6132-dcbec1013ba3" title="Guest" subject="Ellipse" date="D:20220602170947-07'00'" creationdate="D:20220602170946-07'00'"/>
Required properties
PageNumber
Gets or sets the page number of a document that the annotation appears on.
X
Gets or sets the annotation's x-axis position.
Y
Gets or sets the annotation's y-axis position.
Height
Gets or sets the height of the annotation.
Width
Gets or sets the width of the annotation.
Notable properties
For the full list of properties, please visit the annotation's API docs.
FillColor
Gets or sets the color of the annotation's interior.
StrokeColor
Gets or sets the color of the annotation's stroke.
StrokeThickness
Gets or sets the width of the annotation's stroke outline.
Style
Gets or sets the border style of an annotation. Possible styles include:
  • solid
  • dash
Dashes
Gets or sets the border dash style of an annotation. This expects a string representing the length of dashes and spacing inbetween, delimited by commas (ex. 3, 3). You can specify any amount of lengths but, an odd number of values will be made even by cloning it as a second set. To understand further, you can read more about the setLineDash API.
Author
The author of the annotation.
Color
Gets or sets the annotation's stroke color.
Hidden
Gets or sets whether the annotation is hidden.
Invisible
Gets or sets whether the annotation is invisible, only if it is an unknown annotation type. Generally for hiding annotations you should use "Hidden".
IsClickableOutsideRect
Gets or sets whether any parts of the annotation drawn outside of the rect are clickable.
Listable
Gets or sets whether the annotation should be listed in annotation lists. If set to false, the annotation will also become unselectable.
Locked
Gets or sets whether the annotation is locked or not. If it's locked it can't be edited or deleted, but the note can be edited.
LockedContents
Gets or sets whether the annotation contents are locked or not. If the contents are locked then note can't be edited but the annotation can be edited or deleted.
NoDelete
Gets or sets if this annotation can be deleted.
NoMove
Gets or sets whether or not the annotation can be moved.
NoResize
Gets or sets if this annotation can be resized by the user.
NoRotate
Gets or sets if this annotation can be rotated.
NoView
Gets or sets whether the annotation is visible on the screen. Differs from Hidden in that it can still be printed if the print flag is set.
NoZoom
Gets or sets if this annotation scales with the page.
Opacity
Gets or sets the opacity of the annotation.
Printable
Gets or sets whether the annotation should be displayed when printing the page.
ReadOnly
Gets or sets whether the annotation is readonly or not. If it's readonly both the annotation itself and its note can't be edited or deleted.
ToggleNoView
Gets or sets whether the ToggleNoView flag is set on the annotation.
Useful methods
setRect
Although ellipse annotations have both move and resize APIs, it also provides a setRect API which effectively does both which makes it worthy to note.
WebViewer(...)
  .then(instance => {
    const { annotationManager, Annotations } = instance.Core;

    annotationManager.addEventListener('annotationChanged', (annotations, action) => {
      if (action === 'add') {
        annotations.forEach(annot => {
          if (annot instanceof Annotations.EllipseAnnotation) {
            const rect = annot.getRect();
            rect.X = Math.round(rect.X);
            rect.Y = Math.round(rect.Y);
            rect.Width = Math.round(rect.Width);
            rect.Height = Math.round(rect.Height);

            annot.setRect(rect);
          }
        });
      }
    });
  });
Trial setup questions? Ask experts on Discord
Need other help? Contact Support
Pricing or product questions? Contact Sales