MantisBT
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:052018-09-07 10:17
Reporterabv 
Assigned Toapn 
PrioritynormalSeverityminor 
StatusnewResolutionopen 
PlatformOSOS Version
Product Version 
Target Version[OCCT] 7.4.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)
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 [^]
TagsNo tags attached.
Test case number
Attached Files

- Relationships

-  Notes
There are no notes attached to this issue.

- 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


Copyright © 2000 - 2018 MantisBT Team
Powered by Mantis Bugtracker