Mantis Bug Tracker Workflow

View Issue Details Jump to Notes ] Issue History ] Print ]
IDProjectCategoryView StatusDate SubmittedLast Update
0030116Open CASCADE[OCCT] OCCT:Documentationpublic2018-09-06 20:052020-09-11 15:42
Assigned Toapn 
PlatformOSOS Version
Product Version 
Target Version[OCCT] 7.6.0*Fixed in Version 
Summary0030116: Documentation - provide hints for use of OCCT in CMake-based projects
DescriptionOCCT 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)

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 #27560.

I suppose that this documentation can be put in Overview, e.g. after Installation section: [^]
TagsNo tags attached.
Test case number
Attached Files

- Relationships

-  Notes
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
2020-02-28 18:15 kgv Relationship added related to 0031298
2020-09-11 15:42 utverdov Target Version 7.5.0 => 7.6.0*

Copyright © 2000 - 2021 MantisBT Team
Powered by Mantis Bugtracker