Table of Contents
Table C.3. IO Manager Options
| OPTION | DESCRIPTION |
|---|---|
| -oio_mgr,queue_size=4096 | This will limit the event queue size to a maximum of 4K. If the queue exceeds this size, events will be dropped and diagnostic messages will be logged regarding the dropped events. The default behavior is to have an unlimited event queue size. |
Table C.4. Model Manager Options
| OPTION | DESCRIPTION |
|---|---|
| -omodel_mgr,fps=25 | Limits the frame rate for all animations to a maximum fps specified (25 in this example). |
| -omodel_mgr,mem_stats=1 | On platforms where process/task memory usage or heap allocator memory usage values are available, report them as performance log metrics. The value should be set to 1 to enable the statistics, future values are reserved. |
| -omodel_mgr,plugin_path=/temp | Sets the plugin path to the specified directory (/temp in this example). This setting overrides the SB_PLUGINS environment variable setting. |
| -omodel_mgr,scroll_drag_px | The number of pixels that need to be moved before a scrollable container considers this a scroll operation (default 10). |
| -omodel_mgr,scroll_bounce_ms | The number of milliseconds that the bounce operation on a scrollable container should animate once the bounce back is operation is started (default 200ms). |
| -omodel_mgr,scroll_bounce_rate | The animation rate that should be used on a scrollable container for bounce back animations (default easein). |
Table C.5. Render Manager Options: Windows, win32, swrender, OpenGL ES 2.0, x86
| OPTION | DESCRIPTION |
|---|---|
| -orender_mgr,x=[xpos] | This will position the application at the defined x-position |
| -orender_mgr,y=[ypos] | This will position the application at the defined y-position |
| -orender_mgr,sysdpi | This will enable the window upscaling performed by Windows according to the system DPI setting |
Table C.6. Render Manager Options: Linux, sdl, x86
| OPTION | DESCRIPTION |
|---|---|
| -orender_mgr,quality=[0|1|2] | Quality of image rotation. The default, 0 is fastest but lowest quality rendering. A setting of 2 is highest quality but slowest performing. |
Table C.7. Render Manager Options: Linux, fbdev, x86, armle
| OPTION | DESCRIPTION |
|---|---|
| -orender_mgr,dblbuffer | Enable double buffering (fullscreen redraws) |
| -orender_mgr,fb=[device path] | The path to the framebuffer device to use (default=/dev/fb0) |
| -orender_mgr,fullscreen | Run in fullscreen mode |
| -orender_mgr,rotated=[90|180|270] | Rotate the application by the defined angle. |
| -orender_mgr,quality=[0|1|2] | Quality of image rotation. The default, 0 is fastest but lowest quality rendering. A setting of 2 is highest quality but slowest performing. |
Table C.8. Render Manager Options: Linux, directfb, x86, armle
| OPTION | DESCRIPTION |
|---|---|
| -orender_mgr,dumpconfig | Dump the layer and graphics configuration information at startup |
| -orender_mgr,double | Enable double buffering (fullscreen redraws) |
| -orender_mgr,layer=[index] | Set the directfb layer index that content will render to (default=0) |
| -orender_mgr,quality=[0|1|2] | Quality of image rotation. The default, 0 is fastest but lowest quality rendering. A setting of 2 is highest quality but slowest performing. |
Table C.9. Render Manager Options: Linux, Windows CE, Windows Compact 7, Mac OSX, Neutrino 6.5, OpenGL ES 2.0, armle (Beagleboard)
| OPTION | DESCRIPTION |
|---|---|
| -orender_mgr,quality=[0|1|2] | Set the rendering quality including shade model and texture filter, and image rotation quality. A value of 0=nearest/flat, 1=linear/flat, 2=nearest/smooth (default=linear/flat). For image rotation, lower numbers mean faster algorithms, but better quality |
| -orender_mgr,fullscreen | Run in fullscreen mode |
| -orender_mgr,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. |
| -orender_mgr,vbo | Enables the use of vertex buffer objects |
| -orender_mgr,scale=[aspect] | Scale the application to the physical display size. If aspect is passed the application will retain the proper aspect ratio when scaled. |
| -orender_mgr,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. |
| -orender_mgr,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. |
| -orender_mgr,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. |
| -orender_mgr,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' |
| -orender_mgr,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' |
| -orender_mgr,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) |
| -orender_mgr,clipmode=[stencil|scissor] | Set the clipping mode to use, may have performance impacts. Each implementation defaults to the best performance. |
| -orender_mgr,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. |
| -orender_mgr,display=[index] | Connect to the given display index, this option is only available for the QNX Screen OpenGL ES 2.0 render manager or the Linux i.MX6 OpenGL ES 2.0 render manager where the value is the selected framebuffer index. |
| -orender_mgr,fb=[x] | This option pertains specifically to iMX6 hardware platforms. Starting at 0, x defines the framebuffer number to render to. |
| -orender_mgr,x=[xpos] | When using the QNX Screen engine this will position the application at the defined x-position |
| -orender_mgr,y=[ypos] | When using the QNX Screen engine this will position the application at the defined y-position. |
| -orender_mgr,rotated=[90|180|270] | Rotate the application by the defined angle. |
| -orender_mgr,zorder=[z] | When using the QNX Screen engine this will position the application window at the defined Z index. |
| -orender_mgr,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. |
| -orender_mgr,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. |
| -orender_mgr,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. |
| -orender_mgr,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) |
| -orender_mgr,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. |
Table C.10. Render Manager Options: QNX Neutrino 6.5, Linux, Fujitsu Jade, armle
| OPTION | DESCRIPTION |
|---|---|
| -orender_mgr,mainlayer=[number] | The main layer to use for rendering, defaults to layer 0 |
| -orender_mgr,display=[number] | The display to connect to, defaults to display 0 |
| -orender_mgr,conf_file=[path] | A path to a LCD configuration file which includes the display settings |
Table C.11. Render Manager Options: WinCE 6.0, Windows Compact 7, win32, armle
| OPTION | DESCRIPTION |
|---|---|
| -orender_mgr,quality=[0|1|2] | Quality of image rotation. 0 is fastest but lowest quality. 2 highest and slowest |
| -orender_mgr,fullscreen | Removes the window border and fills the display outside of the application area |
| -orender_mgr,dumpcaps | Print the device capabilities and acceleration flags |
| -orender_mgr,nohwcursor | Disables the HW cursor |
Table C.12. Resource Manager Options
| OPTION | DESCRIPTION |
|---|---|
| -oresource_mgr,image=[number] | This will set the maximium number of bytes in the image cache. After the cache
is full, the behaviour for allocations is controlled via the image_oom option.
A value of 0 (default setting) indicates that the image cache should be limited by the
size of available system memory. A value of -1 indicates no image cache and only
one image at a time will be loaded and that image not cached. Otherwise
a positive value indicates the size of the cache in bytes and can be symbolically
specified using K, M qualifiers such as 4K
to indicate an image cache of 4096 bytes or 1M to indicate 1048576 bytes
of memory. |
| -oresource_mgr,image_oom=[fail|lru] | This sets the behaviour when the maximum value of the image cache is reached.
If this is set to the value fail then when an allocation can't be fulfilled the
request will fail. If this is set to the value lru then when an allocation can't
be fulfilled the request will attempt to remove other entries from the cache until it can either
fit the request or it fails. The default behaviour is lru. |
| -oresource_mgr,font=[number] | Similar to the image resource option, this value controls the number of bytes
of memory allocated for the font glyph cache. After the cache is full, the behaviour
of the allocations is controlled via the font_oom option.
A value of 0 (default setting) indicates that the font glyph cache should be limited by the
size of available system memory. Otherwise
a positive value indicates the size of the cache in bytes and can be symbolically
specified using K, M qualifiers such as 4K
to indicate an font glpyh cache of 4096 bytes or 1M to indicate 1048576 bytes
of memory. |
| -oresource_mgr,error=[0|1] | When a resource error is encountered a diagnostic message is generated. This option controls if an event for the error is sent (1, default) or not sent (0). This option is currently only enabled for OpenGL render managers. |
Table C.13. Screen Manager Options
| OPTION | DESCRIPTION |
|---|---|
| -oscreen_mgr,swcursor | Enables the rendering of a software cursor |
| -oscreen_mgr,redraw_complete | Generate a completed event for every screen update |
| -oscreen_mgr,dl=1 | Disable the use of a particular hardware layer |
| -oscreen_mgr,fps | Display the frames per second of the display updates
in the Storyboard Engine console output and also set the
grd_fps variable with the calculated value. |
| -oscreen_mgr,overlay | Allow the application to be run as an overlay and show the content below. This only functions on particular render managers and if the application has a transparent background. |