Extension:Semantic Image Annotator

Semantic Image Annotator is an extension for Semantic MediaWiki developed within and funded by the research project SMW-CorA that allows you to add customized semantic annotations to images in your wiki. It requires SemanticForms and Semantic MediaWiki to work.

Download
You can download the extension directly from the MediaWiki source code repository. You can get:


 * One of the extensions tags (click the tag number and then "snapshot"). Tags tend to be stable.
 * A snapshot of the latest code. This might be unstable.

After you've got the code, save it into the extensions/SemanticImageAnnotator directory of your wiki.

If you are familiar with git and have shell access to your server, you can obtain the extension, with all its tags and branches, as follows: cd extensions git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/SemanticImageAnnotator.git

Installation

 * 1) The downloaded file will contain a folder called something like SemanticImageAnnotator-master-80755c2. Rename it to SemanticImageAnnotator and put it into your wikis extension (/wiki/extensions/) folder.
 * 2) Include the following line in your LocalSettings.php :

Setup
After the installation, you have to create a Template and a Form to work with Semantic Image Annotator. The form has to have the name Form:ImageAnnotation and it is good practice to call the corresponding Template the same. More information on using Semantic Forms can be found on it's extension page. A good starting point is the Quick start guide.

Usage
This is a brief introduction on how to use the Semantic Image Annotator. A more detailed guide will appear on this page in the near future.

Creating annotations
After Successful installation, the button Annotate this image will appear above images on their File: page. Clicking this button will start the "annotation mode". You are then able to draw rectangular annotations on the image. Clicking once will start the shaping mode, in which you can move your mouse to create any rectangular shape. Clicking again stops the shaping mode and you can decide to accept or discard the rectangle that you have created. If you are happy with the annotation shape and click OK, a Semantic Forms popup window with the form that you have created will appear. In this window, you can specify the details of your annotation.

Displaying annotations
To display annotations that you have created, you use the Semantic MediaWiki ask parser functions with the result format imageannotation. If you want to display every annotation for a particular image, you can query for the special property SIAannotatedImage, giving the file name as its value. So for example if you have an image called Spieler.png, your query would look like this:

If you have created a form/template that stores additional properties for the annotations, you can also simply query for these properties. If your query returns annotations for multiple images, they are all displayed (see Planned features). You can also specify the parameter width= and give an integer number to scale the images width to this size (in pixels):

How it works
Semantic Image Annotator defines a custom namespace for annotations (ImageAnnotation:). Each annotation is stored as a unique page in this namespace. Semantic Image Annotator also defines a few custom properties that are added to an image annotation page that are necessary to correctly store and retrieve annotations:
 * SIAannotatedImage
 * The name of the image file that this annotation belongs to.


 * SIArectangleCoordinates
 * The coordinates, relative to the image dimension, at which the annotation is drawn.


 * SIAimageURL
 * The url (relative to the wiki) at which the annotated image is stored.


 * SIAcreatedBy
 * The user that created the annotation.

Future development
The Semantic Image Annotator is still under heavy development. Feedback, bug reports and feature requests are therefore very welcome! Using the discussion page is a very good way to get in touch with the developers and maintainers of Semantic Image Annotator

Upcoming features
These are features that are at the top of the priority list and will be implemented shortly:
 * 1) Configurable Namespace Number for the ImageAnnotation Namespace
 * 2) Different handling for queries that return annotations for multiple images

Planned features
These features are planned already and will be implemented in the near future:
 * 1) Modifying annotation shapes
 * 2) Dragging annotations to a different position
 * 3) Resizing annotations
 * 4) Add different shapes, e.g. circles and custom shapes
 * 5) Define custom colors for annotation shapes

Known issues
If you find a bug, please report it on the discussion page.