C-KIT-GUI-GTK 0.62
C-KIT-GUI-GTK
is a user interface abstraction layer for C-programs
completely separates the application from the GUI-software
makes the application independent from the gui-system
is a graphical user interface toolkit simplifying the design of GUI's
is a C - library with sampleprograms
provides full OpenGL-integration
Linux interfaces to Gtk2 or Gtk3, 32-bit or 64-bit.
MS-Windows (XP, Win7, Win8) interfaces to Gtk2
Functions use standard datatypes
have a unified callback-interface
Programs using C-KIT-GUI-GTK:
gCAD3D
__________________________________________________________________
Linux Prerequisites:
for using C-KIT-GUI-GTK:
gcc, Gtk2 or Gtk3-runtime libraries
for using C-KIT-GUI-GTK with OpenGL:
libGL.so.1
for modifications of C-KIT-GUI-GTK:
gcc, Gtk-development-files (libgtk2.0-dev or libgtk-3-dev),
OpenGL-development-files (eg mesa-common-dev), ctags.
Installation of gtk3-development-files; eg for debian-os:
sudo apt-get install libgtk-3-0-dev
Optional:
sudo apt-get install libgtk-3-0-doc
sudo apt-get install gtk-3-examples
for modification of the documentation:
doxygen
__________________________________________________________________
Linux Install from git-repository:
// start commandline (eg gnome-terminal)
cd
mkdir devel
cd devel
git clone https://github.com/ckitgui/ckitgui
// get all files into ~/devel/ckitgui/*
__________________________________________________________________
Linux Install from tarfile:
// start commandline (eg gnome-terminal)
cd
mkdir devel
mkdir binLinux32
mkdir binLinux64
cd devel
cp xxx/C-KIT-GUI-GTK-*-Linux.tar.gz .
unzip ckitgui_V*.zip
// get all files into ~/devel/ckitgui/*
__________________________________________________________________
Linux Build:
cd ~/devel/ckitgui/src
// change gtk-version (VGUI):
vi options.mak
// ReCreate the shared library:
cd ~/devel/ckitgui/src/APP
make -f ckitgui.mak
// Rebuild / start examples:
cd ~/devel/ckitgui/src/APP
make run -f hello-world.mak
make run -f tst_lst1.mak
make run -f tst_lst2.mak
make run -f tst_ed1.mak
make run -f tst_gui1.mak
make run -f tst_gui2.mak
// If menu is not visible (on Ubuntu 11/12) do:
export UBUNTU_MENUPROXY=
// ReCreate documentation:
cd ~/devel/ckitgui/doc
./gui_doxygen.sh
// view documentation:
xdg-open ~/devel/ckitgui/doc/gui/index.htm
DEVELOPMENT-TOOLS-TAGFILES:
If you are using vim: jump into functions with tagfiles:
in directory APP_tests tagfiles can be used with vim.
Add in .vimrc:
let tagfiles = system("ls -m *.tag |sed \"s/ //g\"")
"echo tagfiles
let &tags = substitute(tagfiles, "\n", "", "g")
Using tagfiles:
cd ~/devel/ckitgui/src/APP
vi -t UME_init
or use "Ctr-R" inside vim with cursor over function, Ctrl-O = back.
DEVELOPMENT-TOOLS-CSCOPE:
Use cscope with:
cd ~/devel/ckitgui/src/APP
./ed
update EDITOR in file ~/devel/ckitgui/src/APP/ed.
__________________________________________________________________
Linux Uninstall:
cd
rm -rf ckitgui
==================================================================
MS-Windows
==================================================================
Prerequisites:
for using C-KIT-GUI-GTK:
MS-C-Compiler (gcc or MS-Visual-C (C++, Express))
for using C-KIT-GUI-GTK with OpenGL:
OpenGL32.lib, Glu32.lib (Microsoft SDKs)
for modifications of C-KIT-GUI-GTK:
the package contains all development-files;
optional: get the gtk-dokumentation from www.gtk.org.
MS-Windows Install (Win-XP Win7 Win8):
The registry is never affected / modified.
Create new directory %HOMEDRIVE%%HOMEPATH%/devel
Using a commandshell (cmd):
%HOMEDRIVE% // activate the homedrive
cd %HOMEPATH% // goto homepath
mkdir devel // create new directory
cd devel // goto %HOMEPATH%/devel
Extract C-KIT-GUI-GTK-*.**-MS.zip into this directory
Using a commandshell (cmd):
unzip ckitgui_V*.zip
Rebuild library / examples:
// You will need a commandshell with the correct compiler-environment.
// You can use the Visual-Studio-Commandwindow or cmd.exe; e.g. for VC8:
"C:\Programme\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"
// or for VC10 - start a commandwindow with:
%comspec% /k ""C:\Program Files\Microsoft Visual Studio 10.0\VC\vcvarsall.bat"" x86
// Test MS-compiler with:
cl /?
ReCreate the shared library:
%HOMEDRIVE% // activate the homedrive
cd %HOMEPATH%\devel\ckitgui\src\APP
nmake -f ckitgui.nmak
// reCreate and start testprogs
nmake -f hello-world.nmak
nmake -f tst_gui1.nmak
nmake -f tst_gui2.nmak
// view documentation:
cd %HOMEPATH%\devel\ckitgui
hh doc\gui\index.htm
MS-Windows Uninstall:
cd
rmdir/s %HOMEDRIVE%%HOMEPATH%\devel\ckitgui
__________________________________________________________________
Directories controlled by git:
src job create libs
src/gui
src/gui_gtk2
src/gui_gtk3
src/ut
src/testapp1 Testprogs and Linkjobs for testprogs
cfg/ config-files
doc job create development-documentation devdoc
doc/dox
icons
Directories not controlled by git:
binLinux32
binLinux64
doc/devdoc was gui/devdoc
__________________________________________________________________
History:
V0.62 / 2015-02-05 changes for git. RF.
V0.60 / 2014-10-24 Bugfixes, gtk_handle_* removed. RF.
V0.50 / 2014-01-18 Bugfixes, new ScreenCast-functions GUI_TUT_m__ GUI_TUT_t__ for Gtk3 only. RF
V0.42 / 2013-09-07 Bugfixes, Minor updates. RF.
V0.40 / 2013-01-18 Bugfixes, NEW: MS-Windows-Version. RF.
V0.32 / 2013-01-05 Minor updates. RF.
V0.30 / 2012-10-22 First productive version. RF.
V0.20 / 2012-09-04 Gtk3-version, 64-bit-version, new parameter "opts" in many interfaces.
V0.10 / 2012-08-17 Changes, Editor (../gui_gtk/gtk_ed1.c) new.
V0.01 / 2012-05-16 First release.
__________________________________________________________________
<b>Links:</b>
GTK: http://www.gtk.org.
<br>
Report bugs, improvements to support at gcad3d.org
// EOF