Introduction

This document presents additional guidelines for building third-party products used by Open CASCADE Technology and samples on Mac OS X platform (10.6.4 and later).

The links for downloading the third-party products are available on the web site of OPEN CASCADE SAS at https://www.opencascade.com/content/3rd-party-components.

There are two types of third-party products, which are necessary to build OCCT:

Mandatory products:
- Tcl/Tk 8.5 - 8.6;
- FreeType 2.4.10 - 2.5.3.
Optional products:
- TBB 3.x - 4.x;
- FreeImage 3.14.1 - 3.16.0

Building Mandatory Third-party Products

Tcl/Tk 8.5

Tcl/Tk is required for DRAW test harness. Version 8.5 or 8.6 can be used with OCCT.

Installation from sources: Tcl 8.5

Download the necessary archive from https://www.tcl.tk/software/tcltk/download.html and unpack it.

Enter the macosx sub-directory of the directory where the Tcl source files are located (TCL_SRC_DIR).
```
cd TCL_SRC_DIR/macosx   
```
Run the configure command
```
configure --enable-gcc  --enable-shared --enable-threads --prefix=TCL_INSTALL_DIR   
```
For a 64 bit platform also add –enable-64bit option to the command line.
If the configure command has finished successfully, start the building process
```
make   
```
If building is finished successfully, start the installation of Tcl. All binary and service files of the product will be copied to the directory defined by TCL_INSTALL_DIR.
```
make install   
```

Installation from sources: Tk 8.5

Download the necessary archive from https://www.tcl.tk/software/tcltk/download.html and unpack it.

Enter the macosx sub-directory of the directory where the source files of Tk are located (TK_SRC_DIR).
```
cd TK_SRC_DIR/macosx   
```
Run the configure command, where TCL_LIB_DIR is TCL_INSTALL_DIR/lib
```
configure --enable-gcc --enable-shared --enable-threads --with-tcl=TCL_LIB_DIR --prefix=TK_INSTALL_DIR   
```
For a 64 bit platform also add –enable-64bit option to the command line.
If the configure command has finished successfully, start the building process:
```
make   
```
If the building has finished successfully, start the installation of Tk. All binary and service files of the product will be copied to the directory defined by TK_INSTALL_DIR (usually it is TCL_INSTALL_DIR)
```
make install   
```

FreeType 2.4.10

FreeType is required for text display in the 3D viewer.

Download the necessary archive from https://sourceforge.net/projects/freetype/files/ and unpack it.

Enter the directory where the source files of FreeType are located (FREETYPE_SRC_DIR).
```
cd FREETYPE_SRC_DIR   
```
Run the configure command
```
configure  --prefix=FREETYPE_INSTALL_DIR   
```
For a 64 bit platform also add CFLAGS='-m64 -fPIC' CPPFLAGS='-m64 -fPIC' option to the command line.
If the configure command has finished successfully, start the building process
```
make   
```
If building has finished successfully, start the installation of FreeType. All binary and service files of the product will be copied to the directory defined by FREETYPE_INSTALL_DIR.
```
make install   
```

Building Optional Third-party Products

TBB 3.x or 4.x

This third-party product is installed with binaries from the archive that can be downloaded from https://github.com/intel/tbb. Go to the Download page, find the release version you need (e.g. tbb30_018oss) and pick the archive for Mac OS X platform. To install, unpack the downloaded archive of TBB 3.0 product (tbb30_018oss_osx.tgz).

FreeImage 3.14.1 or 3.15.x

Download the necessary archive from https://sourceforge.net/projects/freeimage/files/Source%20Distribution/ and unpack it. The directory with unpacked sources is further referred to as FREEIMAGE_SRC_DIR.

Note that for building FreeImage on Mac OS X 10.7 you should replace Makefile.osx in FREEIMAGE_SRC_DIR by the corrected file, which you can find in attachment to issue #22811 in OCCT Mantis bug tracker (https://tracker.dev.opencascade.org/file_download.php?file_id=6937&type=bug).

If you build FreeImage 3.15.x you can skip this step. Modify FREEIMAGE_SRC_DIR/Source/OpenEXR/Imath/ImathMatrix.h:

In line 60 insert the following:
```
#include string.h 
```
Modify FREEIMAGE_SRC_DIR/Source/FreeImage/PluginTARGA.cpp:

In line 320 replace:
```
SwapShort(value); 
```
with:
```
SwapShort(&value); 
```
Enter the directory where the source files of FreeImage are located (FREEIMAGE_SRC_DIR).
```
cd FREEIMAGE_SRC_DIR 
```
Run the building process
```
make   
```

Run the installation process

If you have the permission to write into /usr/local/include and /usr/local/lib directories, run the following command:
```
make install   
```

If you do not have this permission, you need to modify file FREEIMAGE_SRC_DIR/Makefile.osx:

Change line 49 from:

PREFIX ?= /usr/local

to:

PREFIX  ?= $(PREFIX)

Change lines 65-69 from:

  install -d -m 755 -o  root -g wheel $(INCDIR) $(INSTALLDIR) 
  install  -m 644 -o root -g wheel $(HEADER) $(INCDIR) 
  install  -m 644 -o root -g wheel $(SHAREDLIB) $(STATICLIB) $(INSTALLDIR) 
  ranlib  -sf $(INSTALLDIR)/$(STATICLIB) 
  ln  -sf $(SHAREDLIB) $(INSTALLDIR)/$(LIBNAME)

to:

install  -d $(INCDIR) $(INSTALLDIR) 
install  -m 755 $(HEADER) $(INCDIR) 
install  -m 755 $(STATICLIB) $(INSTALLDIR) 
install  -m 755 $(SHAREDLIB) $(INSTALLDIR) 
ln  -sf $(SHAREDLIB) $(INSTALLDIR)/$(VERLIBNAME)  
ln  -sf $(VERLIBNAME) $(INSTALLDIR)/$(LIBNAME)

Then run the installation process by the following command:

make PREFIX=FREEIMAGE_INSTALL_DIR  install

Clean temporary files
```
make clean 
```

Building 3rd-party libraries on MacOS X

Table of Contents