24
|
1 Creating new plugins
|
|
2 ====================
|
|
3
|
|
4 The recommended way of :ref:`contributing to the Orthanc code <contributing>`
|
|
5 is by extending it by :ref:`creating new plugins <plugins>`.
|
|
6
|
|
7 Overview
|
|
8 --------
|
|
9
|
|
10 Orthanc plugins must use the `plugin SDK
|
|
11 <https://orthanc.chu.ulg.ac.be/sdk/index.html>`__ and must be written
|
|
12 in C or C++. They must also fullfil the terms of the `GPLv3 license
|
|
13 <http://www.gnu.org/licenses/quick-guide-gplv3.en.html>`__ that is
|
|
14 used by the core of Orthanc. Sample code for plugins can be found `in
|
|
15 the official Orthanc repository
|
|
16 <https://bitbucket.org/sjodogne/orthanc/src/default/Plugins/Samples/>`__
|
|
17 (in the ``Plugins/Samples`` folder of the ``plugins`` branch). A
|
|
18 tutorial showing how to implement a basic WADO server is `available on
|
|
19 CodeProject
|
25
|
20 <http://www.codeproject.com/Articles/797118/Implementing-a-WADO-Server-using-Orthanc>`__.
|
|
21
|
|
22 We suggest developers to adopt the :ref:`coding style of the Orthanc
|
|
23 core <coding-style>`, although this is of course not required.
|
|
24
|
|
25 Do not hesitate to `contact us
|
|
26 <http://www.orthanc-server.com/static.php?page=contact>`__ if you wish
|
|
27 your plugin to be **indexed** in :ref:`this part of the Orthanc Book
|
|
28 <plugins-contributed>`!
|
|
29
|
|
30
|
|
31 Structure of the plugins
|
|
32 ------------------------
|
24
|
33
|
|
34 A plugin takes the form of a shared library (``.DLL`` under Windows,
|
25
|
35 ``.so`` under Linux, ``.dylib`` under Apple OS X...) that use the `ABI
|
|
36 of the C language
|
|
37 <https://en.wikipedia.org/wiki/Application_binary_interface>`__ to
|
|
38 declare 4 public functions/symbols:
|
24
|
39
|
|
40 * ``int32_t OrthancPluginInitialize(OrthancPluginContext* context)``. This
|
|
41 callback function is responsible for initializing the plugin. The
|
|
42 ``context`` argument gives access to the API of Orthanc.
|
|
43 * ``void OrthancPluginFinalize()``. This function is responsible
|
|
44 for finalizing the plugin, releasing all the allocated resources.
|
|
45 * ``const char* OrthancPluginGetName()``. This function must give a
|
|
46 name to the plugin.
|
|
47 * ``const char* OrthancPluginGetVersion()``. This function must
|
|
48 provide the version of the plugin.
|
|
49
|
25
|
50 *Remark:* The size of the memory buffers that are exchanged between
|
|
51 the Orthanc core and the plugins must be below 4GB. This is a
|
|
52 consequence of the fact that the Orthanc plugin SDK uses ``uint32_t``
|
|
53 to encode the size of a memory buffer. We might extend the SDK in
|
|
54 the future to deal with buffers whose size if above 4GB.
|