FindosgText

Finds the osgText NodeKit from the OpenSceneGraph toolkit.

備註

In most cases, it's recommended to use the FindOpenSceneGraph module instead and list osgText as a component. This will automatically handle dependencies such as the OpenThreads and core osg libraries:

find_package(OpenSceneGraph COMPONENTS osgText)

This module is used internally by FindOpenSceneGraph to find the osgText NodeKit. It is not intended to be included directly during typical use of the find_package() command. However, it is available as a standalone module for advanced use cases where finer control over detection is needed. For example, to find the osgText explicitly or bypass automatic component detection:

find_package(osgText)

OpenSceneGraph and osgText headers are intended to be included in C++ project source code as:

example.cxx
#include <osg/PositionAttitudeTransform>
#include <osgText/Text>
// ...

When working with the OpenSceneGraph toolkit, other libraries such as OpenGL may also be required.

結果變數

該模組定義了以下變數：

osgText_FOUND

在 3.3 版被加入.

Boolean indicating whether the osgText NodeKit of the OpenSceneGraph toolkit was found.

OSGTEXT_LIBRARIES

The libraries needed to link against to use osgText.

OSGTEXT_LIBRARY

A result variable that is set to the same value as the OSGTEXT_LIBRARIES variable.

快取變數

The following cache variables may also be set:

OSGTEXT_INCLUDE_DIR

The include directory containing headers needed to use osgText.

OSGTEXT_LIBRARY_DEBUG

The path to the osgText debug library.

提示

This module accepts the following variables:

OSGDIR

Environment variable that can be set to help locate the OpenSceneGraph toolkit, including its osgText NodeKit, when installed in a custom location. It should point to the OpenSceneGraph installation prefix used when it was configured, built, and installed: ./configure --prefix=$OSGDIR.

已棄用的變數

The following variables are provided for backward compatibility:

OSGTEXT_FOUND

在 4.2 版之後被棄用: Use osgText_FOUND, which has the same value.

Boolean indicating whether the osgText NodeKit of the OpenSceneGraph toolkit was found.

範例

Finding osgText explicitly with this module and creating an interface imported target that encapsulates its usage requirements for linking it to a project target:

find_package(osgText)

if(osgText_FOUND AND NOT TARGET osgText::osgText)
  add_library(osgText::osgText INTERFACE IMPORTED)
  set_target_properties(
    osgText::osgText
    PROPERTIES
      INTERFACE_INCLUDE_DIRECTORIES "${OSGTEXT_INCLUDE_DIR}"
      INTERFACE_LINK_LIBRARIES "${OSGTEXT_LIBRARIES}"
  )
endif()

target_link_libraries(example PRIVATE osgText::osgText)

另請參見