2.9.16
Coherent GT
A modern user interface library for games
renoir::CommonRenderingLibraryParams Struct Reference

Common initialization parameters of the Rendering library. More...

#include <Coherent/renoir/include/RenoirCore/CoherentRenderingLibrary.h>

+ Inheritance diagram for renoir::CommonRenderingLibraryParams:

Public Attributes

bool AllowMultipleRenderingThreads
 Allows usage of Rendering Library calls from different threads. If not enabled, using rendering methods from different threads produces an error message. More...
 
bool SetRenderingResourcesDebugNames
 Will set debug names on rendering resources. The actual use of these names depends on the rendering backend implementation. Use this for debugging purposes only as it incurs a slight performance penalty.
 
bool AllowMultithreadedCommandProcessing
 Will enable multi thread awarenes of the lirary which will result in more mutex locks/unlocks.
 
float PathTessellationThresholdRatio
 Sets the threshold ratio, which is used for determining whether to reuse old tessellated paths or tessellate new ones when changing the display size of paths (e.g. SVGs). If the threshold ratio is lower, then more paths will be tessellated, which will lead to a higher path visual quality, but also to increased memory usage. On the other hand, setting the threshold ratio to a higher value will result in reuse of more tessellated paths, which may cause lower path visual quality, because old tessellated paths are upscaled or downscaled in order to be reused. However, higher threshold value will lead to a decrease in the memory usage. More...
 
unsigned TextAtlasWidth
 Sets the width of the text atlas in px. More...
 
unsigned TextAtlasHeight
 Sets the height of the text atlas in px. More...
 
void * DeveloperOptions
 Reserved property for internal usage. Do not use it.
 

Detailed Description

Common initialization parameters of the Rendering library.

Member Data Documentation

◆ AllowMultipleRenderingThreads

bool renoir::CommonRenderingLibraryParams::AllowMultipleRenderingThreads

Allows usage of Rendering Library calls from different threads. If not enabled, using rendering methods from different threads produces an error message.

Note
This option is useful when, for example, the client rendering backend records commands on different threads, that are later executed on a dedicated rendering thread.
In the general use case where the rendering methods are called directly on the client's rendering thread this should be set to false, to warn when incorrect usage is detected.

◆ PathTessellationThresholdRatio

float renoir::CommonRenderingLibraryParams::PathTessellationThresholdRatio

Sets the threshold ratio, which is used for determining whether to reuse old tessellated paths or tessellate new ones when changing the display size of paths (e.g. SVGs). If the threshold ratio is lower, then more paths will be tessellated, which will lead to a higher path visual quality, but also to increased memory usage. On the other hand, setting the threshold ratio to a higher value will result in reuse of more tessellated paths, which may cause lower path visual quality, because old tessellated paths are upscaled or downscaled in order to be reused. However, higher threshold value will lead to a decrease in the memory usage.

Note
The default threshold ratio is 2.5, which means that if we have previously tessellated a path with size X, then we will reuse it if the size of the new one is 250% larger or smaller. This is done by upscaling or downscaling the old tessellated path.
Threshold ratio less than or equal to 1 will cause tessellation on every size change.

◆ TextAtlasHeight

unsigned renoir::CommonRenderingLibraryParams::TextAtlasHeight

Sets the height of the text atlas in px.

Note
The default value is 1024.
The value must be in the range [64;8192]. If the given value is not power of two we will round it up.

◆ TextAtlasWidth

unsigned renoir::CommonRenderingLibraryParams::TextAtlasWidth

Sets the width of the text atlas in px.

Note
The default value is 1024.
The value must be in the range [64;8192]. If the given value is not power of two we will round it up.