Configure globals subsection

The globals subsection specifies the configuration to apply globally to Screen.

This section must begin with begin globals and end with end globals.

There can only be one globals section. Parameters that are set in this section are applied to all pipelines.

Below is an example of a globals section of a graphics.conf file.

begin globals
  blit-config = pvr2d
  blits-logsize = 4096
end globals
  

Parameters

The following are valid parameters that can be configured under the globals subsection:

Parameter Description Type Possible value(s)
alloc-config The name of the module used for buffer allocation. Screen uses the following algorithm to determine the blitter module to load:
"screen-" + <value of alloc-config> + ".so"
This configuration is platform-specific, and it's already set in the graphics.conf provided to you for your platform. We don't recommend changing this configuration from its original value.
string imx6xbuf
blit-config The blitter used when your application explicitly calls the native blit API functions (screen_blit() and screen_fill()). Screen uses the following algorithm to determine the blitter module to load:
"screen-" + <value of blit-config> + ".so"
Note:

Only one blitter can be configured. The selection of valid blitters depends on your platform; there can be multiple blitter values available for your particular platform.

This parameter differs from the blitter specified in the usage parameter under your class section in graphics.conf. The blitter specified in the usage parameter is the blitter that Screen uses for composition.

String

sw (default)

pvr2d

bv-j5

gles2blt

blits-logsize The size (in bytes) of an internal working ring buffer. Integer

0 to 4,294,967,295

default-display

The primary display.

Identify the primary display by using the display_id that's used to define your displays in the display section of graphics.conf. This is typically a port number, or you can specify a string value.

This parameter is valid only if your system supports displays.

String A numeric value specifying the port number or one of these string values:
  • composite
  • svideo
  • YPbPr
  • rgb
  • rgbhv
  • dvi
  • hdmi
gesture-logsize The size (in bytes) of an internal working ring buffer. integer 0 to 4,294,967,295
idle-timeout The number of seconds after which the system will enter an idle state. long integer 0 to 4,294,967,295
input

Human interface device (HID).

This parameter can be configured with multiple values. If you don't specfiy input at all in your configuration file, Screen defaults to include all input (i.e., the same as if you had specified input = gamepad joystick keyboard mouse).

Specify none (with no other valid input string) to explicitly disable all input.

Note: If you specify any valid input string other than none, you must ensure that you have io-hid running before starting screen; you must also have libhiddi.so in your LD_LIBRARY_PATH.
String

gamepad

joystick

keyboard

mouse

none

input-logsize The size (in bytes) of an internal working ring buffer. Integer

0 to 4,294,967,295

joystick-logsize The size (in bytes) of an internal working ring buffer. Integer

0 to 4,294,967,295

keyboard-logsize The size (in bytes) of an internal working ring buffer. Integer

0 to 4,294,967,295

keymap The location and name of the default keymap file. The keymap file specified is used when a new keyboard device is created. This is applicable only to HID keyboards. Although this keymap file can be specified using the Screen context property, SCREEN_PROPERTY_KEYMAP, the location of this file can be specified using this parameter only at time of configuration. This parameter is optional. If keymap isn't set, then the default keymap at the default keymap file location is used. String /shared/keymap/en_US_101
pointer-logsize The size (in bytes) of an internal working ring buffer. Integer

0 to 4,294,967,295

queue-start-size The size of the event queue per context. Events for the context, such as input events, are put into this queue. This queue size doesn't grow if there are more events than the queue size specified. This means that applications may lose events if they aren't handled before more events are queued to beyond the queue's capacity. Integer 20 (default)
requests-logsize The size (in bytes) of an internal ring buffer. Integer 0 to 4,294,967,295
shortcuts The string to append to the keymap name before the .kbd extension. The keymap name, this string, and the .kbd extension altogether identify the filename of the keymap file that's used when a window isn't in text-entry mode. String 0 to 65535
stack-size The stack size (in units of bytes) that Screen is to use for its threads. This stack-size must be configured appropriately for blitters/compositors that are using Mesa (e.g., gles2blt). The default stack size of is insufficient for these types of blitters/compositors. Integer 0 to 4,294,967,295

Example: 2097152

touch-logsize The size (in bytes) of an internal working ring buffer. Integer 0 to 4,294,967,295