Difference between revisions of "MacOSX"

From mitk.org
Jump to navigation Jump to search
(username removed)
 
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
−
= MITK on MacOS =
+
== MITK on MacOS ==
  
−
== General ==
+
MacOS support for MITK is rather new. This page summarizes how to build a MacOS version and some known issues. If you have already used MITK it all boils down to: ''use the right Qt version''.
  
−
MacOS support for MITK is rather new. This page summarizes how to build a MacOS version and some known issues.
 
  
 
== Building the required toolkits ==
 
== Building the required toolkits ==
Line 10: Line 9:
 
=== Use Qt with Cocoa support ===
 
=== Use Qt with Cocoa support ===
  
−
If you are running MacOS 10.5 or higher, make sure to use the Cocoa version of Qt. The Carbon version produces some unwanted effects e.g. in rendering.
 
  
−
You can select the right version here:
+
<pre><nowiki>
−
http://qt.nokia.com/downloads/mac-os-cpp
+
Use Qt 4.6.2 or newer.
 +
 
 +
Use the Cocoa version.
 +
</nowiki></pre>
 +
 
 +
 
 +
Make sure to use the Carbon version of Qt 4.6.2 or newer. The Carbon version and Qt version prior to 4.6.2 produced some unwanted effects e.g. in the display of render windows.
 +
 
 +
You can select the right version [http://qt.nokia.com/downloads/mac-os-cpp here]:
 +
 
 +
 
 +
Note that you might also want to install the debug-libs package (in addition to the normal library!).
 +
 
  
 
=== Building VTK ===
 
=== Building VTK ===
Line 19: Line 29:
 
(These notes apply to VTK 5.4.2)
 
(These notes apply to VTK 5.4.2)
  
−
Some notes about MacOS, Cocoa and VTK from Kitware can be found here: http://www.vtk.org/Wiki/Cocoa_VTK
+
Some notes about MacOS, Cocoa and VTK from Kitware can be found [http://www.vtk.org/Wiki/Cocoa_VTK here]:
  
−
Download VTK and configure it using CMake. Use these options:
+
[http://www.vtk.org/VTK/resources/software.html#latest Download VTK] and configure it using CMake. Use these options:
  
−
 
+
<syntaxhighlight lang="cmake">
−
<pre><nowiki>
 
 
BUILD_SHARED_LIBS = ON
 
BUILD_SHARED_LIBS = ON
 
VTK_USE_PARALLEL = ON
 
VTK_USE_PARALLEL = ON
 
VTK_USE_GUISUPPORT = ON  (advanced option)
 
VTK_USE_GUISUPPORT = ON  (advanced option)
−
</nowiki></pre>
+
</syntaxhighlight>
−
 
 
  
 
(configure)
 
(configure)
  
−
 
+
<syntaxhighlight lang="cmake">
−
<pre><nowiki>
 
 
VTK_USE_QVTK = ON
 
VTK_USE_QVTK = ON
−
</nowiki></pre>
+
</syntaxhighlight>
−
 
 
  
 
(configure)
 
(configure)
  
−
 
+
<syntaxhighlight lang="cmake">
−
<pre><nowiki>
 
 
DESIRED_QT_VERSION = 4
 
DESIRED_QT_VERSION = 4
−
</nowiki></pre>
+
</syntaxhighlight>
−
 
 
−
 
 
  
−
<pre><nowiki>
+
<syntaxhighlight lang="cmake">
 
(configure)
 
(configure)
 
(configure)
 
(configure)
 
(generate)
 
(generate)
−
</nowiki></pre>
+
</syntaxhighlight>
−
 
 
  
 
Build...
 
Build...
  
−
<pre><nowiki>
+
<syntaxhighlight lang="bash">
 
make
 
make
−
</nowiki></pre>
+
</syntaxhighlight>
−
 
 
  
 
Then optionally install (recommended).
 
Then optionally install (recommended).
  
−
<pre><nowiki>
+
<syntaxhighlight lang="bash">
 
make install
 
make install
−
</nowiki></pre>
+
</syntaxhighlight>
  
  
 
=== Building ITK ===
 
=== Building ITK ===
  
−
ITK builds without problems. Download it from www.itk.org, configure using CMake, then build and install. The only important CMake option is:
+
ITK builds without problems. Download it [http://itk.org/ITK/resources/software.html www.itk.org], configure using CMake, then build and install. The only important CMake option is:
 +
 
 +
<syntaxhighlight lang="cmake">
 +
BUILD_SHARED_LIBS = ON
 +
</syntaxhighlight>
 +
 
 +
Build and install as usual...
 +
 
 +
<syntaxhighlight lang="bash">
 +
make
 +
make install
 +
</syntaxhighlight>
 +
 
  
 +
== Building and running MITK ==
  
−
<pre><nowiki>
+
Nothing different from Linux or Windows, read the
−
BUILD_SHARED_LIBS = ON
+
[http://docs.mitk.org/nightly/BuildInstructionsPage.html Build Instructions]
−
</nowiki></pre>
+
 
 +
There is a minor issue in starting/running MITK: you have to manually set the search path of the dynamic linker to the directory containing the VTK libraries. A bash script similar to this one should start MITK successfully:
 +
 
 +
<syntaxhighlight lang="bash">
 +
export DYLD_LIBRARY_PATH=/home/user/mitk/toolkits/vtk-5.4.2-Release/lib/vtk-5.4/:$DYLD_LIBRARY_PATH
 +
/home/user/mitk/bin/MitkWorkbench
 +
</syntaxhighlight>
 +
 
 +
You should end up with something like this:
  
  
−
== Building MITK ==
+
[[File:MacOSX$mac.png]]
  
−
Nothing different from Linux or Windows, a link to some general page should come here.
 
  
 
== Known issues ==
 
== Known issues ==
−
 
−
With this VTK/Qt combination renderwindows don't draw, but at least:
 
−
* text edit boxes show a blinking cursor
 
−
* render window "buttons" are drawn correctly
 
  
 
All known explicit MacOS issues: [http://bugs.mitk.org/buglist.cgi?op_sys=Mac%20OS%20X&query_format=advanced&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&product=MITK&product=MITK%203M3 Bugzilla list]
 
All known explicit MacOS issues: [http://bugs.mitk.org/buglist.cgi?op_sys=Mac%20OS%20X&query_format=advanced&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&product=MITK&product=MITK%203M3 Bugzilla list]

Latest revision as of 15:49, 1 June 2016

MITK on MacOS

MacOS support for MITK is rather new. This page summarizes how to build a MacOS version and some known issues. If you have already used MITK it all boils down to: use the right Qt version.


Building the required toolkits

Use Qt with Cocoa support

Use Qt 4.6.2 or newer.

Use the Cocoa version.


Make sure to use the Carbon version of Qt 4.6.2 or newer. The Carbon version and Qt version prior to 4.6.2 produced some unwanted effects e.g. in the display of render windows.

You can select the right version here:


Note that you might also want to install the debug-libs package (in addition to the normal library!).


Building VTK

(These notes apply to VTK 5.4.2)

Some notes about MacOS, Cocoa and VTK from Kitware can be found here:

Download VTK and configure it using CMake. Use these options:

<syntaxhighlight lang="cmake"> BUILD_SHARED_LIBS = ON VTK_USE_PARALLEL = ON VTK_USE_GUISUPPORT = ON (advanced option) </syntaxhighlight>

(configure)

<syntaxhighlight lang="cmake"> VTK_USE_QVTK = ON </syntaxhighlight>

(configure)

<syntaxhighlight lang="cmake"> DESIRED_QT_VERSION = 4 </syntaxhighlight>

<syntaxhighlight lang="cmake"> (configure) (configure) (generate) </syntaxhighlight>

Build...

<syntaxhighlight lang="bash"> make </syntaxhighlight>

Then optionally install (recommended).

<syntaxhighlight lang="bash"> make install </syntaxhighlight>


Building ITK

ITK builds without problems. Download it www.itk.org, configure using CMake, then build and install. The only important CMake option is:

<syntaxhighlight lang="cmake"> BUILD_SHARED_LIBS = ON </syntaxhighlight>

Build and install as usual...

<syntaxhighlight lang="bash"> make make install </syntaxhighlight>


Building and running MITK

Nothing different from Linux or Windows, read the Build Instructions

There is a minor issue in starting/running MITK: you have to manually set the search path of the dynamic linker to the directory containing the VTK libraries. A bash script similar to this one should start MITK successfully:

<syntaxhighlight lang="bash"> export DYLD_LIBRARY_PATH=/home/user/mitk/toolkits/vtk-5.4.2-Release/lib/vtk-5.4/:$DYLD_LIBRARY_PATH /home/user/mitk/bin/MitkWorkbench </syntaxhighlight>

You should end up with something like this:


MacOSX$mac.png


Known issues

All known explicit MacOS issues: Bugzilla list

Retrieved from "http://mitk.org/w/index.php?title=MacOSX&oldid=3028"