Difference between revisions of "MacOSX"

From mitk.org
Jump to navigation Jump to search
(username removed)
 
m (2 revisions)
(One intermediate revision by the same user not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
= MITK on MacOS =
+
<!-- ## page was renamed from internal/MacOS -->
 +
<<[[TableOfContents]]()>>
  
== General ==
+
== MITK on MacOS ==
  
MacOS support for MITK is rather new. This page summarizes how to build a MacOS version and some known issues.
+
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 ==
 
== Building the required toolkits ==
Line 10: Line 11:
 
=== 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.
+
 
 +
<pre><nowiki>#!wiki caution
 +
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 here:
 
You can select the right version here:
 
http://qt.nokia.com/downloads/mac-os-cpp
 
http://qt.nokia.com/downloads/mac-os-cpp
 +
 +
Note that you might also want to install the debug-libs package (in addition to the normal library!).
  
 
=== Building VTK ===
 
=== Building VTK ===
Line 21: Line 32:
 
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 here: http://www.vtk.org/Wiki/Cocoa_VTK
  
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:
  
  
Line 71: Line 82:
 
=== 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:
  
  
Line 79: Line 90:
  
  
== Building MITK ==
+
Build and install as usual...
 +
 
 +
<pre><nowiki>
 +
make
 +
make install
 +
</nowiki></pre>
 +
 
 +
 
 +
== Building and running MITK ==
 +
 
 +
Nothing different from Linux or Windows, read the
 +
[http://docs.mitk.org/nightly-qt4/BuildInstructionsPage.html 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:
  
Nothing different from Linux or Windows, a link to some general page should come here.
+
 
 +
<pre><nowiki>
 +
export DYLD_LIBRARY_PATH=/home/user/mitk/toolkits/vtk-5.4.2-Release/lib/vtk-5.4/:$DYLD_LIBRARY_PATH
 +
/home/user/mitk/bin/ExtApp
 +
</nowiki></pre>
 +
 
 +
 
 +
You should end up with something like this:
 +
 
 +
[[File:MacOSX$mac.png]]
  
 
== 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]

Revision as of 17:28, 21 October 2014

<<TableOfContents()>>

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

#!wiki caution
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: http://qt.nokia.com/downloads/mac-os-cpp

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: http://www.vtk.org/Wiki/Cocoa_VTK

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


BUILD_SHARED_LIBS = ON
VTK_USE_PARALLEL = ON
VTK_USE_GUISUPPORT = ON  (advanced option)


(configure)


VTK_USE_QVTK = ON


(configure)


DESIRED_QT_VERSION = 4


(configure)
(configure)
(generate)


Build...

make


Then optionally install (recommended).

make install


Building ITK

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


BUILD_SHARED_LIBS = ON


Build and install as usual...

make
make install


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:


export DYLD_LIBRARY_PATH=/home/user/mitk/toolkits/vtk-5.4.2-Release/lib/vtk-5.4/:$DYLD_LIBRARY_PATH
/home/user/mitk/bin/ExtApp


You should end up with something like this:

MacOSX$mac.png

Known issues

All known explicit MacOS issues: Bugzilla list