CRM32Pro SDK  v5.22
Installation, setup and details on Linux platforms using GNU GCC/G++ 4.1.x library version


Requirements

  • Any Linux distribution (tested on Fedora Core 12). 32bits and 64bits versions

  • GNU C/C++ 3.x/4.x and GNU Binary Tools (tested on 4.4.2)

Library installation

  • Unpack "CRM32Pro-linux-X.YZ.tar.gz" to /usr/CRM32Pro directory (CRM32PRO_INST_DIR)

  • From now on "CRM32Pro.so" is available for any application that uses it: SetupProject, SDK examples, SpacePong...

Compiling your own applications

  • To develop applications or compile the examples using GNU GCC/G++, we have to add a few compiler parameters:

    • to use CRM32Pro includes: -I/usr/CRM32Pro
    • to use the library: /usr/CRM32Pro.so

  • Include "CRM32Pro.h" at the beginning of your code

  • Link against the main library:

    • "CRM32Pro.so" to use the dynamic library version(CRM32Pro.so)

  • These are the minimum commands for GNU GCC/G++:
    "gcc -pthread example.cpp -o myoutput.exe -I/usr/CRM32Pro /usr/CRM32Pro.so -L/usr/X11/lib -lX11 -lXext"

  • In case of doubts, the Makefile project to build the examples can be checked, used and modified.

Important notes

  • Available video backends:

    • x11. Does not provide any hardware support so it is executed by the CPU. On modern systems it is quite fast. Supports full and window screen. Default video backend.
    • glsdl. Provides hardware support so it is mainly executed by the GPU. Supports full and window screen. However, the application needs to be developed keeping in mind some concepts explained on this page
    • fbcon. Provides limited hardware support using the specific drivers. Recent Linux distrubutions has abandoned this driver and currently is only available for old video card so this driver is also deprecated. It is better to use X11 on software modes or OpenGL for hardware ones.

  • Available audio backends:
    • alsa. Uses Advanced Linux Sound Architecture (ALSA) driver. It is newer than OSS and in general, provide better results but in last case, it depends on your Linux distribution. Default audio backend.
    • oss. Uses Open Sound System (OSS) API. Use it when ALSA is causing you problems.