Skip to main content
Version: 9.0.2

render-mgr

Plugin Name: render_mgr (-orender_mgr,...)

x=[xpos]

This will position the application at the defined x-position.

y=[ypos]

This will position the application at the defined y-position.

sysdpi

This will enable the window upscaling performed by Windows according to the system DPI setting.

PLATFORM: Windows, OpenGL, swrender, x86

num_buffers=[n]

The number of display framebuffers to use for each layer.

PLATFORM: OpenGL, swrender

dblbuffer

Enable double buffering (fullscreen redraws)

PLATFORM: Linux, x86, armle, swrender

display=[index]

Connect to the given display index, this option is only available for the QNX Screen OpenGL and software render managers or the Linux i.MX6 OpenGL render manager where the value is the selected framebuffer index.

fb=[x]

This option pertains specifically to iMX6 hardware platforms. Starting at 0, x defines the framebuffer number to render to.

PLATFORM: Linux, swrender

fullscreen

Run in fullscreen mode.

rotate=[90|180|270]

Rotate the application by the defined angle.

PLATFORM: MacOS, Linux, QNX, x86, armle, OpenGL, swrender

rle_blit=[x]

Decode RLE compressed images directly to framebuffer surface memory in order to remove need for temporary decode buffer. Only available for 32 bits per pixel source images with No Scaling and No Rotation. This option pertains to swrender on RTExec platforms. Set x = 1 (default) to enable RLE blit; x = 0 is not enabled.

PLATFORM: armle, RTExec, Storyboard Lite, swrender

quality=[0|1|2]

Visual fidelity of image rotation rendering. A value of 0 emphasizes speed at the cost of visually fidelity. A value of 2 provides the highest visual fidelity, with a potential impact on performance. The default value is set to 1.

dumpconfig

Dump the layer and graphics configuration information at startup.

PLATFORM: Linux, x86, armle, swrender

double

Enable double buffering (fullscreen redraws)

PLATFORM: Linux, x86, armle, swrender

layer=[index]

Set the directfb layer index that content will render to (default=0)

PLATFORM: Linux, x86, armle, swrender

multisample=[value]

Indicates the degree of multisampling which affects the visual smoothness of edges. For example, a value of 4 would be 4x multisampling while 0 would be no multisampling. By default, this value is set dynamically based on the model content that is being interpreted in order to provide the best balance between high performance and high quality rendering. If your model contains 3D models, polygons or circles then multi-sampling is turned on to a level of 4, otherwise it is off. The command line option setting will override the default probing and ensure a fixed value.

PLATFORM: cOS, Linux, QNX, armle, OpenGL

vbo

Enables the use of vertex buffer objects.

PLATFORM: MacOS, Linux, QNX, armle, OpenGL

scale=[aspect]

Scale the application to the physical display size. If aspect is passed the application will retain the proper aspect ratio when scaled.

PLATFORM: MacOS, Linux, QNX, armle, OpenGL

backbuffer

Render the scene using a damage rectangle. On some OpenGL ES implementations this will give better performance but will use more memory as it has to allocate a separate display buffer.

PLATFORM: MacOS, Linux, QNX, armle, OpenGL

npot

Disable power-of-two texture allocations. By default the OpenGL ES API is queried to check for NPOT texture support. This option can be used to override this behavior and force support. NPOT textures will use less memory for image data.

PLATFORM: MacOS, Linux, QNX, armle, OpenGL

fontsize=[size]

Specify the size of the font texture sheet. Fonts are generated into sheets and the default size is 512x512. The number of glyphs put into the sheet is a function of the point size and the texture size. This option can be used to tune the number of available glyphs and the memory usage.

PLATFORM: MacOS, Linux, QNX, armle, OpenGL

window_w=[w]

Scale the application content and window to the specified width. This option is only valid on desktop systems which use a window manager. This option must be used along with 'window_h'

PLATFORM: Windows, MacOS, Linux, QNX, x86, armle, OpenGL

window_h=[h]

Scale the application content and window to the specified height. This option is only valid on desktop systems which use a window manager. This option must be used along with 'window_w'

PLATFORM: Windows, MacOS, Linux, QNX, x86, armle, OpenGL

pixel_format=[rgb565|rgb888|argb8888]

Override the application's pixel format. This option is specific to the Linux fbdev render manager.

PLATFORM: Linux, swrender

linejoin=[0|1]

Set line join style for path drawing, drawing joins can have a performance impact on frame rate. 0=none, 1=round (default=1)

PLATFORM: MacOS, Linux, QNX, armle, OpenGL

clipmode=[stencil|scissor]

Set the clipping mode to use, may have performance impacts. Each implementation defaults to the best performance.

PLATFORM: MacOS, Linux, QNX, armle, OpenGL

error_event

An error event is generated for OpenGL render errors. Image and font errors will identify the image and font related to the error.

display=[index]

Connect to the given display index, this option is only available for the QNX Screen OpenGL render manager or the Linux i.MX6 OpenGL render manager where the value is the selected framebuffer index.

zorder=[z]

When using the QNX Screen engine this will position the application window at the defined Z index.

clearcolor=[color]

Specify the clear color to be used for the Window Surface. The color format is ARGB and specified in hexadecimal. The default clear color is 0x00000000. This option can be used for debugging purposes.

PLATFORM: MacOS, Linux, QNX, armle, OpenGL

image_block_size=[number]

This specifies the memory size of the shared blocks that are used within the image cache. These settings override the generic block_size setting that is used generically for the atlas and are bound by the -oresource_mgr,image setting.

PLATFORM: MacOS, Linux, QNX, armle, OpenGL

font_block_size=[number]

This specifies the memory size of the shared blocks that are used within the font glpyh cache. These settings override the generic block_size setting that is used generically for the atlas and are bound by the -oresource_mgr,font setting.

PLATFORM: MacOS, Linux, QNX, armle, OpenGL

block_size=[-1|0|>0]

Specify how block size should be determined for growing the image atlas. For -1, a degenerate block size will be used, forcing block size to that of a single image. For 0, the block size is rounded up to the nearest power of two for an image's dimensions. For any value greater than zero, block allocations will be rounded up to the size specified. (default=1024)

PLATFORM: MacOS, Linux, QNX, armle, OpenGL

surface_cache=[-1(default)|0|>0]

Specify the surface cache control. For -1, the surface cache will grow unbounded (default). For 0, the surface cache will be disabled. For any value greater than zero, it will be used as the upper limit on the number of surfaces in the surface cache.

PLATFORM: MacOS, Linux, QNX, armle, OpenGL

mainlayer=[number]

The main layer to use for rendering, defaults to layer 0

PLATFORM: Linux, QNX, armle

dumpcaps

Print the device capabilities and acceleration flags.

PLATFORM: OpenGL

nohwcursor

Disables the HW cursor.

PLATFORM: armle

swapinterval=[>=0]

The minimum number of VSYNC periods per buffer swap. Running with 0 can improve performance but can cause display tearing. (default 1)

PLATFORM: OpenGL

xdg_app_id=[<string>]

When using a Wayland XDG Shell, sets the app id for the shell to a custom value. This can be useful when you need to manage multiple layers or windows in Wayland through Wayland manager services. The default value is an identifier determined by Wayland.

PLATFORM: Wayland OpenGL