- API Documentation
- Simple input/output format
- Bounding Box, Point and Polygon Annotation
- Zooming, Scaling, Panning
- Multiple Images
- Cursor Crosshair
npm install react-image-annotate
import React from "react";
import ReactImageAnnotate from "react-image-annotate";
const App = () => (
<ReactImageAnnotate
labelImages
regionClsList={["Alpha", "Beta", "Charlie", "Delta"]}
regionTagList={["tag1", "tag2", "tag3"]}
images={[
{
src: "https://placekitten.com/408/287",
name: "Image 1",
regions: []
}
]}
/>
);
export default App;
To get the proper fonts, make sure to import the Inter UI or Roboto font, the following line added to a css file should suffice.
@import url("https://rsms.me/inter/inter.css");
All of the following properties can be defined on the Annotator...
Prop | Type (* = required) | Description | Default |
---|---|---|---|
taskDescription |
*string |
Markdown description for what to do in the image. | |
allowedArea |
{ x: number, y: number, w: number, h: number } |
Area that is available for annotation. | Entire image. |
regionTagList |
Array<string> |
Allowed "tags" (mutually inclusive classifications) for regions. | |
regionClsList |
Array<string> |
Allowed "classes" (mutually exclusive classifications) for regions. | |
regionColorList |
Array<string> |
Custom color list for regions. Default colors are used if not specified. | |
preselectCls |
string |
Put in the class that should be preselected when creating a new Box/Polygon etc. | |
imageTagList |
Array<string> |
Allowed tags for entire image. | |
imageClsList |
Array<string> |
Allowed classes for entire image. | |
enabledTools |
Array<string> |
Tools allowed to be used. e.g. "select", "create-point", "create-box", "create-polygon" | Everything. |
showTags |
boolean |
Show tags and allow tags on regions. | true |
selectedImage |
string |
URL of initially selected image. | |
images |
Array<Image> |
Array of images to load into annotator | |
showPointDistances |
boolean |
Show distances between points. | false |
pointDistancePrecision |
number |
Precision on displayed points (e.g. 3 => 0.123) | |
onExit |
MainLayoutState => any |
Called when "Save" is called. | |
RegionEditLabel |
Node |
React Node overriding the form to update the region (see RegionLabel ) |
|
enabledRegionProps |
boolean |
Which properties to show in region edit popup ("class", "tags", "name", "comment") | [class , name ] |
hidePrev |
boolean |
Hide Previous Image button from the header bar. |
false |
hideNext |
boolean |
Hide Next Image button from the header bar. |
false |
hideClone |
boolean |
Hide Clone button from the header bar. |
false |
hideSettings |
boolean |
Hide Settings button from the header bar. |
false |
hideFullScreen |
boolean |
Hide FullScreen/Window button from the header bar. |
false |
hideSave |
boolean |
Hide Save button from the header bar. |
false |
userReducer |
(state, action) => state |
User defined reducer that receives every event triggered within the annotator. See demo site for example. |
To begin developing run the following commands in the cloned repo.
npm install
npm start
Then navigate to http://localhost:5173/ and start testing.
See more details in the contributing guidelines.
Consult these icon repositories:
To test this package in your project follow this quickstart:
- Run
npm link
in the root directory of this project (where thepackage.json
is located) - With the same Terminal window, go to your target project folder where the
package.json
is located - Run
npm link "@starwit/react-image-annotate"
to install the package. It might be necessary to remove a previously installed@starwit/react-image-annotate
package. Please use the same node version when using npm link and executing the application. - Changes to this repository will apply live to the running dev session in your target project :)
Currently, there is an issue with vite-plugin-node-polyfills (0.15.0 at the time of writing), which shows many warnings while building (related to "use client"). That is expected and will probably be fixed in the future. See here: davidmyersdev/vite-plugin-node-polyfills#49