Khadas Docs

Amazing Khadas, always amazes you!

User Tools

Site Tools


Sidebar

products:sbc:vim3:applications:sdl2

VIM3/3L SDL2

Introduction

This document is mainly SDL2 library. You will learn how to install the SDL2 library and do simple tests.

he default SDL2 packages from Ubuntu official are built with OpenGL Desktop support, but for VIMs, there don’t have Mali GPU driver under X11, so you can’t use SDL2 with GPU.In order to use SDL2 with GPU (fbdev), we have rebuilt the packages with Mali GPU support.

  • Only support Framebuffer Console mode.
  • Install this version of library will break some official packages which depend on this library.
  • Only supports Ubuntu 20.04 Linux 4.9.

System Configuration

Please make sure you use the latest image, if not please follow Upgrade The System to upgrade your system.

After reboot. Install SDL2:

$ sudo apt update
$ sudo apt install libsdl2-2.0-0 libsdl2-dev
$ mkdir /tmp/sdl2
$ cd /tmp/sdl2
$ wget https://dl.khadas.com/repos/debs/vim3/focal/sdl2/sdl2.tgz
$ tar xvzf sdl2.tgz
$ cd sdl2
$ sudo dpkg -i libsdl2-2.0-0_2.0.10+dfsg1-3_arm64.deb libsdl2-dev_2.0.10+dfsg1-3_arm64.deb

Demo Source Code

Get source code

$ cd /tmp
$ git clone https://github.com/libsdl-org/SDL
$ cd SDL
$ git checkout release-2.0.10

Compile

$ cd test
$ ./configure
$ make

Demonstrate

$ ./testgles2 
INFO: Screen bpp: 24
INFO: 
INFO: Vendor     : ARM
INFO: Renderer   : Mali-G52
INFO: Version    : OpenGL ES 3.2 git.c8adbf9.122c9daed32dbba4b3056f41a2f23c58
INFO: Extensions : GL_ARM_rgba8 GL_ARM_mali_shader_binary GL_OES_depth24 GL_OES_depth_texture GL_OES_depth_texture_cube_map GL_OES_packed_depth_stencil GL_OES_rgb8_rgba8 GL_EXT_read_format_bgra GL_OES_compressed_paletted_texture GL_OES_compressed_ETC1_RGB8_texture GL_OES_standard_derivatives GL_OES_EGL_image GL_OES_EGL_image_external GL_OES_EGL_image_external_essl3 GL_OES_EGL_sync GL_OES_texture_npot GL_OES_vertex_half_float GL_OES_required_internalformat GL_OES_vertex_array_object GL_OES_mapbuffer GL_EXT_texture_format_BGRA8888 GL_EXT_texture_rg GL_EXT_texture_type_2_10_10_10_REV GL_OES_fbo_render_mipmap GL_OES_element_index_uint GL_EXT_shadow_samplers GL_OES_texture_compression_astc GL_KHR_texture_compression_astc_ldr GL_KHR_texture_compression_astc_hdr GL_KHR_texture_compression_astc_sliced_3d GL_EXT_texture_compression_astc_decode_mode GL_EXT_texture_compression_astc_decode_mode_rgb9e5 GL_KHR_debug GL_EXT_occlusion_query_boolean GL_EXT_disjoint_timer_query GL_EXT_blend_minmax GL_EXT_discard_framebuffer GL_OES_get_program_binary GL_OES_texture_3D GL_EXT_texture_storage
INFO: 
INFO: SDL_GL_RED_SIZE: requested 5, got 8
INFO: SDL_GL_GREEN_SIZE: requested 5, got 8
INFO: SDL_GL_BLUE_SIZE: requested 5, got 8
INFO: SDL_GL_DEPTH_SIZE: requested 16, got 24

If everything is ok, you will see the cube on screen.

Troubleshooting

When you install such version of library you will break some packages (such as guvcview) which depend on the original library, if you don’t want to break the packages you can follow the instructions below to install the original SDL2 library.

$ wget http://ports.ubuntu.com/ubuntu-ports/ubuntu-ports/pool/universe/libs/libsdl2/libsdl2-2.0-0_2.0.10+dfsg1-3_arm64.deb
$ wget http://ports.ubuntu.com/ubuntu-ports/ubuntu-ports/pool/universe/libs/libsdl2/libsdl2-dev_2.0.10+dfsg1-3_arm64.deb
$ sudo dpkg -i libsdl2-2.0-0_2.0.10+dfsg1-3_arm64.deb libsdl2-dev_2.0.10+dfsg1-3_arm64.deb
$ sync
Last modified: 2023/11/03 04:17 by nick