##

##

##

##

##

    ________________________________________________________________________
    Plugins:

    Plugins sind kompilierte Zusatzprogramme (Lademodule).
    Plugins können alle internen Funktionen benutzen.
    Eingabefenster können systemneutral mit dem GUI-Tool "C-Kit-GUI" erstellt werden.

    Aufruf von Plugins: Plugin/Select-Start (oder Ctrl-P).

    Die Lademodule liegen im Verzeichnis
     {baseDir}/binMS32/plugins/          (Microsoft) oder
     {baseDir}/binLinux32/plugins/       (Linux).
     {baseDir}/binLinux64/plugins/       (Linux).

    Plugins erzeugen Standardcode, der im Model normal abgespeichert wird.
    Plugins haben keine spezifischen Befehle (wie Prozessoren).
    Plugins können zur Laufzeit entladen, rekompiliert und wieder
        geladen werden.

      Installation Entwicklungspaket Linux
      Installation Entwicklungspaket MS-Windows
      Entwicklungs - Dokumentation
      Erstellung neuer Plugins

    ________________________________________________________________________

    Installation Entwicklungspaket Linux:

    Prerequistes:

    Erforderliche Softwarepakete sind:
      gcc-4..                    - Compiler
      libgtk+2.0_0-devel-..      - für Gtk-Funktionen
      libgtkglarea2.0-devel-..   - für OpenGL-Funktionen

    Linux Installation von git-repository:

    # start Terminal (zB gnome-terminal)
    cd
    mkdir devel
    cd devel

    # Entwicklungspaket nach ~/devel/gcad3d/* kopieren
    git clone https://github.com/gcad3d/gcad3d

    Linux Installation von Zipfile:

    # start Terminal (zB gnome-terminal)
    cd
    mkdir devel
    cd devel
    cp xxx/gCAD3D_x.xx-src.zip .

    # get all files into ~/devel/gcad3d/*
    unzip gCAD3D_x.xx-src.zip
    cd gcad3d
    mkdir -p binLinux32/plugins
    mkdir -p binLinux64/plugins

    ________________________________________________________________________

    Installation Entwicklungspaket MS-Windows:
    Paketname ist gCAD3D-devel-1.26.zip.

    Erforderliche Softwarepakete sind:
      ein Compiler; zB VisualStudio-Express.

    The package contains -
      - all necessary Gtk+ includefiles and libs,
      - GTK-Toolbox with examples (sources and makefiles)
      - some gCAD3D-demo-plugins (sources and makefiles)
      - all gCAD3D includefiles

    You have to copy it into the gCAD3D basic installation directory;
      the basedirectory is normally "C:\Programme\gCAD3D"
        or "C:\program files\gCAD3D"
        Unpack the zipfile.

    You will need a commandshell with the correct compiler-environment
      For VC8 you can use the Visual-Studio-Commandwindow or cmd.exe plus:
        "C:\Programme\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"
      For VC9 (VisualStudio 2008) you can use:
        "C:\Programme\Microsoft Visual Studio 9.0\VC\vcvarsall.bat" x86
      Test it with "cl /?".

    Testlink of a testprogramm or add-on-library:
      open Commandshell (CMD.EXE)
      cd C:\Programme\gCAD3D\gtk
      nmake -f tst_gtk0.nmak

    Runtime-link:
      start gCAD3D from Commandshell (CMD.EXE) to see messages
      activate Checkbox Options/compile_DLL's in gCAD3D;
      activate a DDL (select "DemoXX" in upper right)
      the selected DLL will be compiled, linked, started
      (see textwindow for errors)

    ________________________________________________________________________

    Entwicklungs - Dokumentation:

    Linux:
      Anzeigen aus einer Commandshell mit:
      firefox ~/devel/gcad3d/doc/gcad/index.htm

    MS-Windows:
      Anzeigen aus einer Commandshell mit:
        cd C:\Programme\gCAD3D\xa
        hh ..\devdoc\index.htm

    ________________________________________________________________________

    Erstellung neuer Plugins:

      Es sind ein Quellprogramm ({progname}.c) und ein Linkjob ({progname}.mak)
       erforderlich (MS-Win: {progname}.nmak).

      Beispiele: {baseDir}/Demo*.c, Demo*.mak  (MS: Demo*.nmak).

      Mit "Options/compile_DLLs" ein wird ein Plugin zur Laufzeit entladen,
        neu compilert, neu gelinkt und wieder geladen.

      Dokumentation zum Erstellen eines Plugin:
      pag_pd1.htm
      oder doc/gcad/pag_pd1.htm im Entwicklungspaket.

    Beispiel:
    cd ~/devel/gcad3d/src/APP
    cp Demo_toolbar1.c myTest1.c
    cp Demo_toolbar1.mak myTest1.mak
    # change "Demo_toolbar1" in myTest1.c and in myTest1.mak into "myTest1"
    # link for the first time:
    make -f myTest1.mak
    # start gcad with "Options/compile_DLLs" on
    ./do comp
    # select "Plugin / select plugin .. / myTest1"
    # keep gcad running; exit plugin; change code, save code;
    # restart plugin with "Ctrl+P" makes automatic recompile and start ..

    ________________________________________________________________________
    Senden Sie Fehlerberichte, Verbesserungsvorschläge an
    support@gcad3d.org