[.. upper level ..]

Commands

Helper commands below bin/.

• vgagames3-config
  Script for compiling games with VgaGames3.

  - vgagames3-config --cflags
    CFLAGS for c-compiler
  - vgagames3-config --libs
    LDFLAGS and LIBS, needed libraries, for c-compiler
  - vgagames3-config --libspath
    LDFLAGS and LIBS, needed libraries, for c-compiler, with fixed path to the VgaGames3-library
  - vgagames3-config --extralibs
    Additional libraries for c-compiler without the VgaGames3-library
  - vgagames3-config --prefix
    PREFIX, installation prefix, where the VgaGames3-library is installed
  - vgagames3-config --version
    Version of the installed VgaGames3-library in the format <major release>.<minor release>
  - vgagames3-config --copylocal
    Using this flag creates a directory vgag3 into the current path and copies all needed files
    of the already installed VgaGames3-library into it.
    So the game can be executed on another computer, where the VgaGames3-library is not installed.
    The game must be compiled with the flag --libs, not with --libspath,
    then it has to be copied into the parent-directory of the new created vgag3.
    Before executing the game, two environment variables must be set:
    - LD_LIBRARY_PATH
      which contains the relative path from the executable to the VgaGames3-library: vgag3/lib
    - VGAG3_PREFIX
      which contains the relative path from the executable to the created directory: vgag3
  

• vg3-objfunc-create-cfile
  When using VgaGames3-objects.
  Must be used to create ofunc_new() from get-functions (getofc_*(), getoofc_*() and getofmgmt_*()):

  Scans recursively from current directory c- and c++-files for get-functions
   - to set struct for object-functions
     void getofc_*(struct vg3_ofunc_objfunc *)
   - to set struct for object-to-object-functions
     void getoofc_*(struct vg3_ofunc_objobjfunc *)
   - to set struct for -object-managing-functions
     void getofmgmt_*(struct vg3_ofunc_ofmgmt *)
  Writes to stdout: c-file with function for initialization: ofunc_new()
  

• vg3-convert-image
  For converting image-files (.bmp).
  Useful to convert to the actual colormap,
  to replace transparent pixels (0x000000) to black pixels (0x010101)
  and to replace pixels of arbitrary color to transparent pixels:

  Usage: vg3-convert-image [<options>] <bitmap-files or directories>
  Converts found bitmap-files according to colormap
  and replaces transparent pixels into black pixels.
  Options:
   -c: use standard colormap (missing: no colormap)
   -C: read colormap from stdin
       (Format: up to 256 lines with pixelcolors (0-255): <red> <green> <blue>)
   -n: don't convert transparent to black pixel
   -y: don't ask for confirmation
   -t <color>: convert <color> pixels to transparent pixels
               <color>: 0x<rr><gg><bb>
   -a <alpha>: convert pixels with less equal <alpha> to transparent pixels