To build and run the samples, you must be logged on the target system.

The samples are provided with source code and a Makefile.

Before attempting to run the DriveWorks samples, consult the procedures provided in Configuring the Host System to Run DriveWorks Samples.

The platform includes a default windowing system, however additional window systems are also supported. Each of the graphics samples may be built for all the supported window systems for a given platform.

Binaries are saved in separate subdirectories depending upon the window system with the same name, so you can maintain the output for multiple windowing systems.

To see the default and list of supported values, run make without setting NV_WINSYS. The following shows examples:

If NV_WINSYS is set to a value that is not supported for your platform, you will get an error when you run make, for example:

Use export NV_WINSYS=<value> to set the value permanently in your shell. If you want to set NV_WINSYS temporarily, use the env command:

For Vulkan samples, the direct-to-display windowing system value must be used.

All of the graphics samples are present in:

There are three 3D graphics sample applications in the PDK called ctree, bubble, gears-cube and gears, and one 2D text rendering application called drawfont. Along with these, eglstreamcube which is a cross-process eglstream application and eglcrosspart is a cross partition eglstream application. There are several utility libraries used by the graphics samples. nvgldemo is a general EGL and OpenGL ES framework to simplify common functionality such as the EGL initialization sequence for any particular windowing system, creation of an OpenGL ES context, OpenGL ES shader usage, and EGLStream setup.  All of the graphics samples use nvgldemo.  gears-lib contains OpenGL ES rendering code common to the multiple graphics samples that show the classic 3D spinning gears. nvtexfont is a small library to draw text using OpenGL ES textures and is used by several of the graphics samples.

Applications that use the PDK can run on any connected display output device and at any resolution. The sample applications provide command line options to adjust the display settings.

Applications can set the resolution of the application's output with the following flag:

This is the window size of the application.

Set the screen resolution with:

For specifying a desktop offset, use the flag:

Applications can select the overlay where you want to direct the sample output. Three overlays are supported so you can run up to three applications simultaneously.

Here, dispno is the display number which is assigned serially from 0 through 3 for the four displays on a DRIVE AGX SoC.

Multi-sample antialiasing (MSAA) can be specified with:

The numsamples specified are platform-dependent.

For Xavier SoC, valid values are 2, 4, or 8.

By default, if no command line arguments are supplied, the sample applications run at a native resolution for the connected display.

These procedures are specific to the EGLDevice windowing system. To run the samples on other windowing systems, the compositor for the windowing system must be run before the applications can be run on top of it.

Additional supported backends include:

For screen as the backend, run screen as described in the QNX screen graphic subsystem documentation, then run any of the graphics samples.

Applications can use this option to load the pre-compiled program binary from its current execution path. The program binaries are generated for all supported architectures when the ‘make’ command is run. These binaries are generated into separate directories, each with the supported architecture name. The correct directory name needs to be specified when running the sample app.

If the program binaries are not present, the application will create the program binary from shader source and save the created program binary in the current execution path. The application can then use these saved program binaries on the next run. The flag to control use of program binary is:

Where <boolean> is either 0 or 1.

The direct to display WSI backend is supported.

To run Vulkan samples, other windowing systems must be temporarily disabled. For example, with X11 installations, execute these commands:

There are two Vulkan sample applications in the SDK called vkfish and vkcube that can be found under:

Vkfish is a modified version of the NVIDIA threaded rendering Vulkan sample available at:

It has been modified to use the direct to display WSI platform with the interface stripped for simplification.