Subversion Repositories or1k

(0) Introduction:

    The files in this directory demonstrates how to create a Win32 DLL
    for Tcl/TK. It creates a file called DEMO.DLL which can be loaded
    into wish41.exe via the "load" command.

    The Borland C++ makefile (Makefile.bc) and a C file (Demo.c) gives
    an example for all the steps that you need to take to create such a
    DLL to load under Tcl/Tk. Moreover, if you are using Tix and need to
    call the Tix C functions in your DLL, please refer to the Makefile.bc
    for the necessary compilation flags required.

(1) Requirement:

    Tcl/Tk sources are required. You can download them from

        ftp://ftp.smli.com/pub/tcl/tcl75b3.zip
        ftp://ftp.smli.com/pub/tcl/tk41b3.zip

    Tix sources are required in you need to compile against Tix.DLL. It
    can be downloaded from

        ftp://ftp.xpi.com/pub/windows/tix41a2.zip

(2) Compilation:

    (a) You must compile the Tcl/Tk sources first. The reason is we
        need the files tcl75.lib and tk41.lib, which are not released
        by Sun in their binary release. This is also a good exercise
        for you to set up your environment for compiling Tcl/Tk-based
        software.

        If you have BC++ (4.5 or later) installed on your system, edit
        the header part of the file tcl7.5b3\win\makefile.bc to reflect
        the settings in your environment. Then

            cd tcl7.5b3\win\
            make -f makefile.bc

        When this finishes, you will get tcl75.dll and tcl75.lib in this
        directory.

        Do the same things to get tk41.dll and tk41.lib

    (b) Now cd to the DLLDemo directory and edit the file makefile.bc to
        to reflect the settings in your environment. Don't worry about the
        setting of the TIX directories yet.

        Now type

            make -f makefile.bc

        in this directory. When this is done, you should get a demo.dll. Start
        up wish41.exe. When you get the console screen, type the following
        in it:

            load demo.dll
            puts [demoHello]

    (c) If your DLL doesn't need to call the C functions of Tix (like our
        demo.dll), you can stop here. If you need to call the Tix C functions,
        then first install the Tix sources and get tix41.lib and tix41.dll.
        then change back to the DLLDemo directory and type

            make -f makefile.bc tix

        This will compile a demo_tix.dll that is linked to tix41.dll, tk41.dll
        and tcl75.dll.