KVS.osmesa

KVS.osmesa is an off-screen rendering framework with OSMesa for KVS.

Prerequisite

The following software packages are needed to compile KVS.osmesa.

OSMesa

OSMesa must be installed in your computing environment before compiling KVS.osmesa.

• OSMesa

Linux

For Linux, OSMesa will be available by installing libosmesa6-dev. The following shows a command example with apt-get on Ubuntu Linux.

sudo apt-get install libosmesa6-dev

Mac OS X

In case of Mac OS X environment, OSMesa will be installed by installing XQuartz. You can dowload it from the following URL.

• XQuartz

The environment variable KVS_OSMESA_DIR should be set to an install directory of OSMesa as follows:

export KVS_OSMESA_DIR=/usr/X11

KVS based on OSMesa GL implementation

The source code of KVS can be downloaded via GitHub as follows:

$ git clone https://github.com/naohisas/KVS.git

The environment variable KVS_DIR should be set to an install directory of KVS. Here is an example of setting the variable. You can change the install directory to other directory, if you want.

export KVS_DIR=~/local/kvs

OSMesa-enabled KVS can be compiled as follows:

1. Change directory to KVS

$ cd KVS

2. Modify kvs.conf as follows

KVS_ENABLE_OPENGL     = 1
KVS_ENABLE_OSMESA     = 1
KVS_ENABLE_GLU        = 0
KVS_ENABLE_GLEW       = 0
KVS_ENABLE_OPENMP     = 0
KVS_ENABLE_DEPRECATED = 0

KVS_SUPPORT_CUDA      = 0
KVS_SUPPORT_GLUT      = 0
KVS_SUPPORT_OPENCV    = 0
KVS_SUPPORT_QT        = 0
KVS_SUPPORT_PYTHON    = 0

3. Build and install KVS

$ make
$ make install

Installation

You can get the source codes of KVS.osmesa from GitHub.

$ git clone https://github.com/vizlab-kobe/KVS.osmesa.git

Build

First of all, you need to build a library with a python script.

$ cd KVS.osmesa
$ cd Lib
$ ./kvsmake.py

Test

Several test programs with KVS.osmesa can be found in the App directory. Each of the programs can be easily compiled with kvsmake command.

$ cd App
$ cd Test
$ kvsmake -G
$ kvsmake

This program generates 12 resulting images rendered with a volume rendering technique.

$ ./Test
OSMesa version: 11.2.0
rendering to ... output_000.bmp
rendering to ... output_001.bmp
rendering to ... output_002.bmp
rendering to ... output_003.bmp
rendering to ... output_004.bmp
rendering to ... output_005.bmp
rendering to ... output_006.bmp
rendering to ... output_007.bmp
rendering to ... output_008.bmp
rendering to ... output_009.bmp
rendering to ... output_010.bmp
rendering to ... output_011.bmp

Note

Gallium softpipe driver doesn't support "upside-down" rendering which would be needed for the OSMESA_Y_UP=TRUE case. Therefore, the rendering pixel data need to be flipped. In the current implementation, it is necessary to specify the gallium driver "softpipe" or "llvmpipe" by using environment parameter 'KVS_OSMESA_GALLIUM_DRIVER'.

e.g.) export KVS_OSMESA_GALLIUM_DRIVER=softpipe