vkcube

Updated: April 19, 2023

Demonstrate 3D rendering capabilities using Vulkan

Syntax:

vulkaninfo  [options]

Runs on:

QNX Neutrino

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:

Examples:

# vkcube