Permalink
Branch: master
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
91 lines (59 sloc) 6.68 KB

GLOVE demos for Linux

GLOVE is accompanied by a demo SDK that contains fully commented, highly optimized C applications (accompanied by the ESSL shader source code). These demos demonstrate some simple rendering techniques with different geometry complexities, as they were designed with the restrictions of low-power embedded platforms in mind (see Table 1 ).

Name Dimension Shading Functionality
triangle2d_one_color 2D Draw a single 2D triangle with white color
triangle2d_split_colors 2D A 2D triangle is rendered on the screen. The color of each non-empty pixel is dynamically chosen at runtime between 2 fixed colors (red & green) based on its screen-space position.
circle2d_sdf 2D A dynamically generated circle is drawn (with time-varying radius) using signed distance fields. Note that no geometry (for the 2D circle) is streamed to hardware.
texture2d_color 2D A fullscreen quad rendering (using two triangles) is used to draw a 2D texture.
cube3d_vertexcolors 3D Draw a 3D rotated (in Y axis) cube in the center of the screen with per-vertex colors. Note that this example also supports transparency via blending operations and orthographic camera projection (default: perspective).
cube3d_textures 3D Similar graphics rendering framework as ' cube3d_vertexcolors ' but with different shading method: Mixing two textures.
render_to_texture_filter_gamma 2D/3D 2D image processing effects on a texture generated by off-screen rendering a 3D rotated cube (using demo example 'cube3d_texture '). To achieve this, we initially render scene to a Frame Buffer Object (FBO) and then perform post-processing Gamma correction filtering on the generated texture.
render_to_texture_filter_invert 2D/3D Similar graphics rendering framework as ' render_to_texture_filter_gamma ' but with different filtering effect: Color Invert
render_to_texture_filter_grayscale 2D/3D Similar graphics rendering framework as ' render_to_texture_filter_gamma ' but with different filtering effect: Grayscale
render_to_texture_filter_sobel 2D/3D Similar graphics rendering framework as ' render_to_texture_filter_gamma ' but with different filtering effect: Sobel
render_to_texture_filter_boxblur 2D/3D Similar graphics rendering framework as ' render_to_texture_filter_gamma ' but with different filtering effect: Box Blur

Table 1. Example demos name and description

Execution

Open a new terminal and navigate to the ' build/Demos/demos' directory ($ cd build/Demos/demos/), then run all examples by typing this command:

$ ./run_all_samples.sh

Note that file logging of OpenGL debug and Vulkan profile is supported (use --help for details).

Configuration

A number of object-like and conditional macros have been used to offer debug and profiling features as well as to simplify the setting process of the demo configuration (see Table 2 ).

Name Values Functionality
DEBUG (a)DEBUG_OPENGLES (b)DEBUG_ASSET_MANAGEMENT Enable to log errors for (a) OpenGL ES API and (b) asset management respectively.
PROFILE (a)FPS_DISPLAY, FPS_TIME_PERIOD = X (b)INFO_DISPLAY Enable to report (a) processed time in fps and ms for the time period of X seconds and (b) shading and rendering settings respectively.
CONFIG KILL_APP = Y Enable to auto terminate the application after the time period of Y seconds (suggestion: Y>X).
BINARY_PROG DBINARY_PROG Enable to load from a precompiled shader program. Disable to load from vertex and fragment shaders.
WINDOW_SIZE WIDTH = W, HEIGHT = H Set the dimensions of the application window to be [W,H]. Note that this macro definition is mandatory.

Table 2. Makefile macros used by our demos.

Key Bindings

A list of key bindings are provided for information and testing purposes (see Table 3 ). Note that the keys 't' and 'p' are available only for the 'cube3d_vertexcolors' and 'cube3d_textures' demos that handles 3d shapes.

Key Functionality Mode
Esc Exit the application -
t Changes the material type of all objects Opaque/Transparent
p Changes the projection transformation of the camera Perspective/Orthographic

Table 3. Key bindings for the provided demos.

Credits

Vulkan logo texture has been downloaded from the Khronos Official Logo Archive and is registered trademarks of the Khronos Group Inc.

Offline Shader Compilation Tool

An offline compiler interface of input (vertex and fragment) shader sources is also provided ensuring that the resulting shader program binary can be efficiently loaded into the graphics application. This is a very useful path for applications that wish to remain portable by shipping pure ESSL source shaders, yet would like to avoid the cost of compiling their shaders at runtime. The tool, which can be found in the ' build/Demos/tools' folder ($ cd build/Demos/tools/), works by compiling and linking the given shaders and returns back the final program binary through a command-line interface. If the vertex and fragment ESSL source shader names are 'sh.vert' and 'sh.frag' respectively, then the generated precompiled binary shader program, named 'sh.bin', can be generated by executed this command:

$ ./offline_shader_compiler -v sh.vert -f sh.frag -o sh.bin

Note that, the BINARY_PROG macro preprocessor in the ' CMakeLists.txt' file has to be provided in the CMAKE_C_FLAGS to inform graphics applications to use precompiled shaders (see Table 2).

GLOVE demos for Android

Currently, GLOVE uses the es2gears demo (official link here) as a demo application for Android.

Installation

The installation procedure requires a device that supports Vulkan. Ensure that the device is connected to the building machine, open a new terminal and type the following command:

$ adb install android/bin/NativeActivity-debug.apk

The application will be automatically installed to the Android device.

Execution

To execute the application, tap on the application icon named 'GLOVE_Demo'.