Version 2.7.7

Maintenance release that fixes minor bugs and prepares support for the line drawing tool.

Version 2.7.5

Bugfixes

• Fixed a regression bug that broke getSelectedImageSnippet and getImageSnippetById

Version 2.7.3

Bugfixes

• Fixed a minor issue in the Selection class that caused error when accessing the exact field on image annotations. The call now returns null.

Version 2.7.2

Behavior/feature additions

• Added fitBoundsWithConstraints method (#114)

Bugfixes

• Fixes a bug that prevented the ShapeLabels plugin from working in Gigapixel Mode
• selected CSS class now properly applied to selected shape in read-only mode (#113)
• Fixed a style regression bug that prevented line breaks is read-only comments
• After selecting and deselecting (or, more precisely, moving out of) an annotation, OSD's default zoom-on-click behavior no longer worked. Fixed. (#120)

Other

• Improved input sanization for SVG polygon selectors

Version 2.7.1

New features

• saveSelected API method now also works in normal mode, not just headless
• Delete key now deletes the currently selected annotation
• Added new init property hotkey, for re-assigning the key that activates drawing mode (Shift by default). Allowed values are, either, a keycode (e.g. 'Shift', 'Alt', 'Control'), or an object with a key and an optional inverted property. If inverted is set to true, Annotorious will always remain in drawing mode, and only switch to navigation when the hotkey is held.

var anno = OpenSeadragon.Annotorious(viewer, {
  hotkey: 'Control'
});

// Or...

var anno = OpenSeadragon.Annotorious(viewer, {
  hotkey: {
    key: 'Alt',
    inverted: true // OSD navigation off by default!
  }
});

Editor

• Added Russian UI translation
• Breaking change: tag bodies are now serialized differently when terms are from a semantic vocabulary (label + URI) (#94):

{
  "type": "SpecificResource",
  "purpose": "tagging",
  "source": {
    "id": "http://vocab.getty.edu/aat/300010358",
    "label": "material"
  }
}

Non-semantic terms are still represented in the same way, as a TextualBody with a value:

{
  "type": "TextualBody",
  "value": "material",
  "purpose": "tagging",
  "source": "http://vocab.getty.edu/aat/300010358"
}

Bugfixes

• Accurate hit testing (mouse hover, select) now works again for all shape types (#100)
• Fixed a bug that prevented the overrideId function to work in headless mode

Version 2.7.0

OpenSeadragon v3.0 Support

BREAKING CHANGE: From this version (v2.7.0) onward, Annotorious strictly requires OpenSeadragon v3.0! For the previous version of OpenSeadragon (v2.4.x), please keep using Annotorious 2.6.x or older.

Behavior/feature additions

• New API method .getImageSnippetById(annotationId) that returns
  • a DOM Canvas element with the given annotation's image snippet
  • a coordinate transform function that translates X/Y coordinates in the snippet coordinate space back to the coordinate space of the full image
• New formatters init config parameter that allows setting a single formatter function as well as an array of formatters. The old formatter option is still available, but deprecated!
• New formatters instance field that allows dynamic adding/removing of formatter functions

Bugfixes

• Fixed a bug that caused point annotations from the selector pack to shift (or disappear) in gigapixel mode
• Fixed a bug that caused errors when loading rectangle annotation with percent-encoded Fragment Selectors (#93)

Version 2.6.0

Features/behavior

• The tag widget now supports functions as vocabulary init option. The function will get the current value of the tag input field as an argument, and must return either, a list of vocabulary terms, e.g.:

// Return an array of strings to serve as suggestions
return ['Animal', 'Person', 'Building'];

// Or return a list of objects with label/uri fields
return [
  { label: 'Animal', uri: 'http//example.com/vocab/Animal' },
  { label: 'Person', uri: 'http//example.com/vocab/Person' },
  { label: 'Building', uri: 'http//example.com/vocab/Building' }
];

Or it must return a Promise of vocabulary items.

Bugfixes

• Fixes a bug that prevented language switching, from any of the supported languages back to the default en (#104)

Other

• Removed downshift dependency in favour of a lighter (and more hackable) custom implementation, reducing bundle size by ~20kB.

Version 2.5.16

Bugfix release

• Fixes a bug that broke annotation selection on Firefox
• Adds a tolerance buffer when selecting annotations, so that point annotations can be selected reliably
• Fixes a bug that caused point annotations to collapse to 5px size (in image coordinates) after canceling a selection, leading to super-small points on higher image zoom levels (#103 - only happend in conjuction with the point editing tool in the Selector Pack)

Version 2.5.15

Fixes various regression bugs that broke annotation move/resize on touch devices.

Version 2.5.10

Feature additions/behavior

• Added Thai UI translation
• Added support for 'non-scaling' annotations, which remain of constant screen size, regardless of whether the underlying image is scaled. The typical (only?) use case for this is point markers. For example: you'll always want a point marker to be a circle of 5 pixel radius, no matter if the image is displayed in original size, or scaled by 50% in a responsive UI.

Bugfixes

• Fixed a regression bug that broke shape move/edit on touch (#102)
• Fixed a bug that caused annotations to become un-selectable when using the overrideId feature
• Fixed a bug in gigapixel mode that prevented newly-created selections from scaling/moving with the image, when no other annotation was on screen