vkcube

Runs on:

QNX OS

Vulkan options:

--c frame_count

Limit the number of frames rendered to the value specified by frame_count (integer); after the frame limit is reached, vkcube exits. The default is 2147483647 for unlimited.

If you set this option and -frame-limit, the last specified option is used.

--display_timing

Use VK_GOOGLE_display_timing extension.

--gpu_number gpu_index

Use gpu_index to specify the GPU to use.

--height pixels

Set the window height in pixels.

If you set this option and -size, the last specified option is used.

--incremental_present

Use the VK_KHR_incremental_present_enabled extension.

--present_mode mode

Set the presentation mode. Chose from the following:

• 0 - VK_PRESENT_MODE_IMMEDIATE_KHR
• 1 - VK_PRESENT_MODE_MAILBOX_KHR
• 2 - VK_PRESENT_MODE_FIFO_KHR (default)
• 3 - VK_PRESENT_MODE_FIFO_RELAXED_KHR

If you set this option and -interval, the last specified option is used.

--use_staging

Use the staging buffer to copy linear texture and optimized the format.

--validate

Enable any installed validation layers.

--width pixels

Set the window width in pixels.

If you set this option and -size, the last specified option is used.

Screen options:

-format=pixel_format

Set the window pixel format. Supported formats are:

• rgb565 - SCREEN_FORMAT_RGB565
• rgba5551 - SCREEN_FORMAT_RGBA5551
• rgbx5551 - SCREEN_FORMAT_RGBX5551
• rgba8888 - SCREEN_FORMAT_RGBA8888
• rgbx8888 - SCREEN_FORMAT_RGBX8888
• bgra8888 - SCREEN_FORMAT_BGRA8888
• bgrx8888 - SCREEN_FORMAT_BGRX8888
• rgba1010102 - SCREEN_FORMAT_RGBA1010102
• rgbx1010102 - SCREEN_FORMAT_RGBX1010102
• bgra1010102 - SCREEN_FORMAT_BGRA1010102
• bgrx1010102 - SCREEN_FORMAT_BGRX1010102

If you do not set this option, Screen uses the format of the window's framebuffer. If the framebuffer's format is not supported by Vulkan, vkcube will abort.

-frame-limit=frames

Limit the number of frames rendered to the value specified by frame-limit (integer); after the frame limit is reached, vkcube exits. By default, this utility assumes an unlimited number of frames.

If you set this option and --c, the last specified option is used.

-interval=mode

Set the presentation mode. Chose from the following:

• 0 for VK_PRESENT_MODE_IMMEDIATE_KHR
• 1 for VK_PRESENT_MODE_FIFO_KHR

If you do not set this option, Screen uses the value or default of --present_mode.

If you set this option and --present_mode, the last specified option is used.

-nbuffers=count

Set the number of window buffers to be created for rendering. Use an integer from 2 to the maximum buffer limit of your driver. The default is 3.

-pipeline=pipeline_id

Set the pipeline as specified by pipeline_id (integer). If you don't specify this option, vkcube uses the pipeline of the framebuffer.

If you use this option, Screen applies the SCREEN_USAGE_OVERLAY usage flag and uses the pipeline specified by pipeline_id.

-pos=x,y

Sets the x,y coordinates of the viewport. The default coordinate of 0,0 is used if this option isn't specified.

-size=widthxheight

Set the size as specified, using integer values for width and height, of the viewport in pixels. The default size is fullscreen.

If you set this option and -height, and/or --width, the last specified option is used.

-zorder=zorder

Set the z-order specified by zorder, as an integer, of the window. A z-order of 0 is used if this option isn't specified.

Description:

The vkcube binary is a command-line tool that confirms that Vulkan is running on Screen and has all the necessary drivers. It demonstrates Vulkan's 3D rendering by displaying a rotating cube.

To control vkcube, use the following keys:

• ESC - Quit the demo
• Space - Pause/resume the demo
• Left Arrow - Decrease the angel of the cube's rotation
• Right Arrow - Increase the angel of the cube's rotation

Examples:

# vkcube