# Select Features

<div class="contents" id="bkmrk-cmake-feature-switch"><div class="contents"><div class="textblock"><dl class="warning"><dd><p class="callout warning">CMake feature switches have been renamed for V3.x releases, see <span style="color: rgb(230, 126, 35);">[Change Log](https://doc3161en.candera.eu/shelves/6-change-log)</span></p>

</dd></dl></div></div></div>#### <a class="anchor" id="bkmrk-"></a>Select Candera Features

Build settings for the [Candera](http://dev.doc.cgistudio.at/APILINK/namespace_candera.html "&#91;DataBinding&#95;RefTypeSample&#93;") Engine are specified by the following CMake variables:

<div class="contents" id="bkmrk-name-description-pos"><div class="contents"><div class="textblock"><table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse; width: 800px; border-width: 1px; border-spacing: 0px;" width="1150"><tbody><tr bgcolor="#d4d4d4"><th style="border-width: 1px; padding: 5px;">**Name**</th><th style="border-width: 1px; padding: 5px;">**Description**</th><th style="border-width: 1px; padding: 5px;">**Possible values**</th></tr><tr><td style="border-width: 1px; padding: 5px;">CANDERA\_2D\_ENABLED</td><td style="border-width: 1px; padding: 5px;">Enables [Candera](http://dev.doc.cgistudio.at/APILINK/namespace_candera.html "&#91;DataBinding&#95;RefTypeSample&#93;") engine's 2D elements.  
If both 2D and 3D are enabled, the solution will contain both CanderaEngine2D and CanderaEngine3D subprojects.</td><td style="border-width: 1px; padding: 5px;">ON/OFF</td></tr><tr><td style="border-width: 1px; padding: 5px;">CANDERA\_LAYOUT\_ENABLED</td><td style="border-width: 1px; padding: 5px;">Enables [Candera](http://dev.doc.cgistudio.at/APILINK/namespace_candera.html "&#91;DataBinding&#95;RefTypeSample&#93;") 2D dynamic layout.  
If disabled, the whole code for dynamic layout is removed.</td><td style="border-width: 1px; padding: 5px;">ON/OFF</td></tr><tr><td style="border-width: 1px; padding: 5px;">CANDERA\_LAYOUT\_CLIPPING\_ENABLED</td><td style="border-width: 1px; padding: 5px;">Enables clipping of [Candera](http://dev.doc.cgistudio.at/APILINK/namespace_candera.html "&#91;DataBinding&#95;RefTypeSample&#93;") 2D dynamic layout.  
If enabled, the render area of a render node is clipped to the layout area.</td><td style="border-width: 1px; padding: 5px;">ON/OFF</td></tr><tr><td style="border-width: 1px; padding: 5px;">CANDERA\_3D\_ENABLED</td><td style="border-width: 1px; padding: 5px;">Enables Cander engine's 3D elements.</td><td style="border-width: 1px; padding: 5px;">ON/OFF</td></tr><tr><td style="border-width: 1px; padding: 5px;">CANDERA\_VRAM\_ALLOCATOR\_CHECK\_ENABLED</td><td style="border-width: 1px; padding: 5px;">  
</td><td style="border-width: 1px; padding: 5px;">ON/OFF</td></tr><tr><td style="border-width: 1px; padding: 5px;">CANDERA\_VRAM\_ALLOCATOR\_STATISTICS\_ENABLED</td><td style="border-width: 1px; padding: 5px;">  
</td><td style="border-width: 1px; padding: 5px;">ON/OFF</td></tr><tr><td style="border-width: 1px; padding: 5px;">CANDERA\_RENDER\_STATE\_CACHING\_ENABLED</td><td style="border-width: 1px; padding: 5px;">Whether or not [Candera](http://dev.doc.cgistudio.at/APILINK/namespace_candera.html "&#91;DataBinding&#95;RefTypeSample&#93;") shall cache render states.   
<dl class="note"><dt></dt><dd><p class="callout info">For SceneComposer builds (on host), render state caching must be disabled.</p>

<p class="callout info">For target builds, take care to enable this feature!</p>

</dd></dl></td><td style="border-width: 1px; padding: 5px;">ON/OFF

</td></tr><tr><td style="border-width: 1px; padding: 5px;">CANDERA\_DETAIL\_STATISTICS\_ENABLED</td><td style="border-width: 1px; padding: 5px;">Whether or not [Candera](http://dev.doc.cgistudio.at/APILINK/namespace_candera.html "&#91;DataBinding&#95;RefTypeSample&#93;") shall keep statistics about render state cache hits and misses.   
<dl class="note"><dt></dt><dd><p class="callout info">This works only if CANDERA\_RENDER\_STATE\_CACHING\_ENABLED is enabled.</p>

<p class="callout info">For target builds, disable because of the added overhead!</p>

</dd></dl></td><td style="border-width: 1px; padding: 5px;">ON/OFF

</td></tr><tr><td style="border-width: 1px; padding: 5px;">CANDERA\_GLOBALIZATION\_ENABLED</td><td style="border-width: 1px; padding: 5px;">Whether or not [Candera](http://dev.doc.cgistudio.at/APILINK/namespace_candera.html "&#91;DataBinding&#95;RefTypeSample&#93;") Globalization library shall be built.

<dl class="note"><dt></dt><dd><p class="callout info">[Candera](http://dev.doc.cgistudio.at/APILINK/namespace_candera.html "&#91;DataBinding&#95;RefTypeSample&#93;") Globalization is an optional module only available upon special request.</p>

</dd></dl></td><td style="border-width: 1px; padding: 5px;">ON/OFF</td></tr><tr><td style="border-width: 1px; padding: 5px;">CANDERA\_ASSET\_DECOMPRESSION\_ENABLED</td><td style="border-width: 1px; padding: 5px;">This option is required to decompress asset data if it was compressed with CGI Studio Asset Library Shaper previously. <dl class="note"><dt>  
</dt><dd><p class="callout info">Enabling this feature will automatically add ZLib to the project.</p>

</dd></dl></td><td style="border-width: 1px; padding: 5px;">ON/OFF</td></tr><tr><td style="border-width: 1px; padding: 5px;">CANDERA\_TEXT\_SHAPER</td><td style="border-width: 1px; padding: 5px;">Allows the selection of a text shaper.   
A text shaper resolves certain text features like text direction, context specific substitutions and ligatures.  
Options:

- **HarfBuzz (Default)(Optional)**: Unidirectional text. Unicode defined substitutions. Unicode defined ligature, GSUB and GPOS lookup. <dl class="note"><dt></dt><dd><p class="callout info">HarfBuzz shaping is an optional module only available upon special request. Upon failure to detect the HarfBuzz source location, CMake will display "ComplexScripLib" as default textshaping option.</p>
    
    </dd></dl>
- **ComplexScriptLib**: Bidirectional text. Arabic context substitutions. Forced Unicode defined ligatures.
- **NoShaping**: Disables shaping. Text will be displayed left to right. No substitutions or ligatures are resolved.

</td><td style="border-width: 1px; padding: 5px;">NoShaping  
ComplexScriptLib  
Harfbuzz - *Default*  
  
</td></tr><tr><td style="border-width: 1px; padding: 5px;">CANDERA\_BIDIRECTIONAL\_TEXT\_ENABLED</td><td style="border-width: 1px; padding: 5px;">Allows enabling of bidirectional text parsing.   
This is needed when combining text written left to right with text written right to left.   
If the text shaper supports bidirectional text this option is required when using multi-font text styles.</td><td style="border-width: 1px; padding: 5px;">ON/OFF

</td></tr><tr><td style="border-width: 1px; padding: 5px;">CANDERA\_TEXTENGINE\_NATIVE\_LINEHEIGHT\_ENABLED</td><td style="border-width: 1px; padding: 5px;">Whether or not the native line height metrics of the font engine is used.   
If disabled then 120% of EM size is applied as line height which is compatible with Adobe.</td><td style="border-width: 1px; padding: 5px;">ON/OFF</td></tr><tr><td style="border-width: 1px; padding: 5px;">CANDERA\_ASSETLOADER\_MEMORYPOOL\_ENABLED</td><td style="border-width: 1px; padding: 5px;">Enables the use of the Memory Pool feature in [Candera](http://dev.doc.cgistudio.at/APILINK/namespace_candera.html "&#91;DataBinding&#95;RefTypeSample&#93;") AssetLoader.  
<dl class="note"><dt></dt><dd>Requires the MemoryPool feature. <p class="callout info">Only available if FEATSTD\_MEMORYPOOL\_ENABLED is ON.</p>

</dd></dl></td><td style="border-width: 1px; padding: 5px;">ON/OFF</td></tr><tr><td style="border-width: 1px; padding: 5px;">CANDERA\_TEXTENGINE\_MEMORYPOOL\_ENABLED</td><td style="border-width: 1px; padding: 5px;">Enables the use of the Memory Pool feature in [Candera](http://dev.doc.cgistudio.at/APILINK/namespace_candera.html "&#91;DataBinding&#95;RefTypeSample&#93;") TextEngine.  
<dl class="note"><dt></dt><dd>Requires the MemoryPool feature.</dd><dd><p class="callout info">Only available if FEATSTD\_MEMORYPOOL\_ENABLED is ON.</p>

</dd></dl></td><td style="border-width: 1px; padding: 5px;">ON/OFF</td></tr><tr><td style="border-width: 1px; padding: 5px;">CANDERA\_ASSET\_LIBRARYHEADER\_CACHE\_ENABLED</td><td style="border-width: 1px; padding: 5px;">Optional feature which will cache all Asset-Library-Header that have been loaded and cached upon Asset initialization.  
<dl class="note"><dt></dt><dd>If dynamic Asset-Partitions are being used, caching will occur when a partition is added, and will continue until it is removed. <p class="callout info">The cache will use the standard Asset Cache memory.</p>

</dd></dl></td><td style="border-width: 1px; padding: 5px;">ON/OFF</td></tr></tbody></table>

</div></div></div>#### <a class="anchor" id="bkmrk--0"></a>Select FeatStd Features

For information about FeastStd features, please refer to <span style="color: rgb(230, 126, 35);">[FeatStd &gt; FeatStd Features](https://doc3161en.candera.eu/books/featstd/page/featstd-features "FeatStd Features")</span>.