0030116: Documentation - provide hints for use of OCCT in CMake-based projects

View Issue Details [ Jump to Notes ]

[ Issue History ] [ Print ]

Project

Category

View Status

Date Submitted

Last Update

0030116

Open CASCADE

[OCCT] OCCT:Documentation

public

2018-09-06 20:05

2019-07-19 14:43

Reporter

abv

Assigned To

apn

Priority

normal

Severity

minor

Status

new

Resolution

open

Platform

OS Version

Product Version

Target Version

[OCCT] 7.5.0*

Fixed in Version

Summary

0030116: Documentation - provide hints for use of OCCT in CMake-based projects

Description

OCCT install includes CMake configuration files intended for use by projects that are based on OCCT. The basic idea is that to use OCCT in a project, you need to add a few commands in its CMake file, assuming something like this:

```
cmake_minimum_required(VERSION 3.4)
project(Your_Project_Name)

find_package(OpenCASCADE REQUIRED)
add_executable(Your_App_Name Your_Source_File.cpp)
target_include_directories(Your_App_Name ${OpenCASCADE_INCLUDES})
target_link_libraries(Your_App_Name ${OpenCASCADE_LIBS})
```

Here "OpenCASCADE_INCLUDES" and "OpenCASCADE_LIBS" are assumed to be CMake variables set either by OCCT CMake configuretion scripts or find_package itself. Indeed, actual names of such variables, and ways to use them, can be different. This is what we need to have documented, among other related things.

Tentatively the following should be described:

1. How to make CMake to find OCCT package: specify the name of the package, describe where it is located, give hints on how to call find_package.

2. How to set paths to OCCT includes and libs to the project build scripts.

3. How to ensure that project build parameters are consistent with parameters used for building OCCT. This includes used third-party libs, CRT version, etc. See #28457 and dependent issues for some of the issues to be addressed.

4. How to install binaries (DLLs) of OCCT and required third-parties (FreeType, FreeImage etc., depending on what components of OCCT are used and what third-parties are used) along with the application (if necessary). See also 0027560.

I suppose that this documentation can be put in Overview, e.g. after Installation section:
https://dev.opencascade.org/doc/overview/html/index.html#OCCT_OVW_SECTION_4_2 [^]

Tags

No tags attached.

Test case number

Attached Files

Relationships

Notes
(0079592) git (administrator) 2018-10-02 12:33	Branch CR30116 has been created by apn. SHA-1: 91cffb3053086c4437708dfa423b9f419497b5ef Detailed log of new commits: Author: apn Date: Tue Oct 2 12:31:26 2018 +0300 0030116: Documentation - provide hints for use of OCCT in CMake-based projects //Add description of installed CMake configuration files.

Issue History
Date Modified	Username	Field	Change
2018-09-06 20:05	abv	New Issue
2018-09-06 20:05	abv	Assigned To	=> apn
2018-09-06 20:25	abv	Description Updated	View Revisions
2018-09-06 20:29	abv	Relationship added	related to 0028457
2018-09-07 10:17	abv	Description Updated	View Revisions
2018-10-02 12:33	git	Note Added: 0079592
2019-07-19 14:43	apn	Target Version	7.4.0 => 7.5.0*