|
|
| (157 intermediate revisions by one user not shown) |
| Line 1: |
Line 1: |
| | + | __NOTOC__ |
| | =Welcome= | | =Welcome= |
| − | This part of the Wiki is dedicated to developers who would like to implement their own plug-ins for AnyWave. | + | This part of the Wiki is dedicated to developers who would like to implement their own plug-ins for AnyWave.<br /> |
| − | | + | {| style="text-align: center; margin: auto;" |
| − | =Setting up the SDK=
| + | |+ Quick Navigation |
| − | Before developing a plug-in for AnyWave, the developer must download and build the SDK.<br />
| + | |- |
| − | The SDK is available here: https://github.com/anywave/sdk<br />
| + | | [[File:Menu_matlab_plugin.png|400px|link=AnyWave:MATLAB_Plugin|'''Write a MATLAB Plugin''']] || [[File:Menu_cpp_plugin.png|400px|link=AnyWave:Cpp_Plugin|'''Write a c++ Plugin''']] |
| − | Note that you can also try to build the complete AnyWave software which includes the SDK.<br />
| + | |- |
| − | AnyWave git repository is available here: https://github.com/anywave/anywave<br />
| + | | [[File:Menu_matlab_batch.png|400px|link=AnyWave:Plugin_Batch|'''Make your plugin batchable''']] || [[File:Menu_matlab_batch_gui_compatible.png|400px|link=AnyWave:MATLAB_Batch_GUI|'''Make your plugin compatible with the batch GUI of AnyWave''']] |
| − | | + | |} |
| − | Clone the sdk repository on your computer:
| + | |
| − | * On Linux or Mac systems this can be done in a terminal with the following command: '''git clone https://github.com/anywave/sdk mysdkfolder'''
| + | |
| − | * On Windows, we strongly suggest to install the TortoiseGit Software, freely available at https://code.google.com/p/tortoisegit/wiki/Download
| + | |
| − | | + | |
| − | =Software requirements=
| + | |
| − | To successfully build the SDK, at least three software must be installed on the computer:
| + | |
| − | * The Qt4 framework
| + | |
| − | * The VTK library (version 5.4.2 to 5.8 will work)
| + | |
| − | * CMake 2.8 or greater.
| + | |
| − | | + | |
| − | ==AnyWave compatibility==
| + | |
| − | When building a plug-in, the developer has two choices:
| + | |
| − | * Build for the currently distributed binary version of AnyWave.
| + | |
| − | * Build for its own AnyWave version built from the sources available on github.
| + | |
| − | | + | |
| − | ===Plug-ins for the binary distributed package of AnyWave===
| + | |
| − | Pay attention that if the plug-in must work with the distributed binary versions of AnyWave it must match more requirements:
| + | |
| − | * Qt4 must be 4.8.2 to work with the Linux debian packaged version of AnyWave.
| + | |
| − | * Qt4 must be 4.8.1 to 4.8.5 to work with the Windows and Mac OS X versions.
| + | |
| − | * VTK library must be 5.4.2 to 5.8.xx (VTK 6.x will not work)
| + | |
| − | | + | |
| − | The Linux and Mac versions have been built with the gcc compiler and therefore will use the glibc library.<br />
| + | |
| − | On Mac systems, the XCode software must be installed to get access to the gcc compiler.
| + | |
| − | | + | |
| − | '''ATTENTION:''' The Windows version of AnyWave was built with Visual Studio 2008. Therefore, the plug-in must also be built using Visual Studio 2008 for binary compatibility. | + | |
| − | | + | |
| − | ===Plug-ins for the developer version of AnyWave===
| + | |
| − | If a developer plans to build plug-ins that will stay private, it is up to him/her not to match the requirements previously mentioned.
| + | |
| − | | + | |
| − | ==Building AnyWave from sources and use it as the SDK==
| + | |
| − | As mentioned before, the developer is free to use the complete AnyWave source code as SDK.<br />
| + | |
| − | The requirements to build AnyWave are the same than for the SDK.<br />
| + | |
| − | Follow the instructions available when cloning the anywave repository to build AnyWave.
| + | |
| − | | + | |
| − | =Building the SDK=
| + | |
| − | The SDK requires the CMake software tool to compile, so cmake 2.8 or greater must be installed on the system.<br />
| + | |
| − | | + | |
| − | ==Choose the SDK folder==
| + | |
| − | The first thing to do is to create a folder with an explicit name, for example: '''AwSDK''', that will be the root of the SDK.<br />
| + | |
| − | We will consider for the following explanations that the folder is named AwSDK and is located in '''/home/user/Dev/AwSDK'''
| + | |
| − | | + | |
| − | ==Define '''AWSDK''' variable== | + | |
| − | Once the folder is created, you MUST define an environment variable named '''AWSDK''' that points to this folder.<br />
| + | |
| − | On Linux on Mac systems this can be done by adding the two following lines to your .bashrc file:<br />
| + | |
| − | ''AWSDK=/home/user/Dev/AwSDK''<br />
| + | |
| − | ''export AWSDK''<br />
| + | |
This part of the Wiki is dedicated to developers who would like to implement their own plug-ins for AnyWave.
