How to add new tool to the viewer

[nodevm]

I want to add new tools to the viewer. I know how to add the icon to the toolbar for a new tool,but where the code resides for the new tool is not very clear.

Where for instance is the code for the length tool?.

[swederik]

Hello Lancelot,

The tools reside in the Cornerstone Tools library: https://github.com/chafey/cornerstoneTools/

The length tool specifically is here:

https://github.com/chafey/cornerstoneTools/blob/master/src/imageTools/lengthTool.js

To add a tool to the Viewer there are a few steps:

1. Add the tool itself to the repository.
   If you're using something from Cornerstone TOols you can skip this step. Some examples of custom tools can be found in the lesion tracker: https://github.com/OHIF/Viewers/tree/master/Packages/lesiontracker/client/compatibility

2. Add the toolbar button itself to the array of tools in the Toolbar:
   https://github.com/OHIF/Viewers/blob/574a6d02b090b8b2f020430c5919f8377b8316c6/OHIFViewer/client/components/toolbarSection/toolbarSection.js

3. A: Add it to the toolManager (if it's a tool, such as length / angle):

   Viewers/Packages/lesiontracker/client/tools.js

   Line 2 in 574a6d0

   toolManager.addTool('bidirectional', {

   OR

   B: Add it to the functionList if it's a command (e.g. toggle CINE play, or Invert the current viewport):

   Viewers/OHIFViewer/client/components/viewer/viewer.js

   Line 12 in 574a6d0

   OHIF.viewer.functionList = {

I've also added these details to the Wiki: https://github.com/OHIF/Viewers/wiki/Adding-a-tool-to-the-Viewer

If this satisfies your question please close the issue. If not, comment here with any issues you encountered and we can update the documentation.

Making this easier is one of our goals, so these steps might change in the future.

Hope that helps,

Erik

[nodevm]

Many thanks @swederik for your detailed answer.