Main Page     Cookbook/Overview     ImageMeister     the jcprops file     Licensing     Binary Installation & Configuration [ Win · Mac · Nix ]     Changes     Public API     Source Code Main Page         Java [ Common · Win · Mac · Nix ]     Native Code [ Common · Win · Mac · Nix ]     Manifest         Native Code Overviews [ Common · Win · Mac · Nix · Strings ]     Macros [ General · Native Macros ]         Walkthroughs [ Java only · Java and native ]     Building [ Win · Mac · Nix ]     Distribution Issues

Platforms

This version of JConfig is for use on Win95, Win98, and WinNT with the SunJDK ( 1.1 or higher ) and the MSIE VM. It has also been run with JBuilder (jdk1.1.6 version).

Installation

In the batch files described below, it is assumed that you unzipped the archive containing this file to the root of your C: drive, creating a c:\samizdat folder. If you unzipped this to another location, you will need to edit the batch files to reflect the different location, as described below. Other than that, no special installation is required.

Running ImageMeister

The ImageMeister application is run using 'imrunMS.bat' and 'imrunSN.bat', both of which are in the 'imeister' folder. To run ImageMeister, you may need to edit the first few lines of these files, as described in the next section.

For more information on ImageMeister, see imagemeister.html.

Running the Sample Applications

JConfig comes with two sample applications, the source code for both apps is inside the source/com/tolstoy/testjc folder.

The first application ( Tester.java ) opens up notepad.exe and launches your Web browser with a URL.

The second application is the predecessor to ImageMeister, and is a simple disk browser. The source code for this is in the files 'DiskBrowser.java' and 'BrowserPanel.java'.

The compiled versions of these apps are in the JConfig.zip file, so you don't need to compile them separately.

Four batch files are provided to run the sample applications:

• TesterMS.bat ( the first application, for use with the MSIE VM )
• TesterSN.bat ( the first application, for use with the Sun JDK )
• BrowseMS.bat ( the disk browser, for use with the MSIE VM )
• BrowseSN.bat ( the disk browser, for use with the Sun JDK )

NOTE: You may need to edit the first few lines of these batch files if you did not install the distribution to the root of your C:\ drive.

NOTE: If you get the message 'Out of Environment Space' when running the batch files, right click on the batch file, and choose 'Properties'. On the 'Memory' tab, in the 'Conventional Memory' area, set the 'Initial Environment' popup menu to its highest setting.

In addition to Tester and DiskBrowser, three other samples are provided.

Run these in a similar fashion to running Tester. See the comments in these files for more information.

• com.tolstoy.testjc.FileAttributesTest: Lets you view and set the attributes for files and folders.
• com.tolstoy.testjc.TestResFork: shows how to copy a Mac file's data and resource forks to a new file. Copying the file's attributes is left as an exercise.
• com.tolstoy.testjc.MakeLink: shows how to create a Windows shortcut, but could be adapted for the Mac.

Paths and Classpaths

On Windows, you must put JConfig.zip in your classpath, either in autoexec.bat, or in the batch file used to run your app. So, if JConfig.zip is in the 'c:\myapp' directory, you could use the following line in your batch file:

    set classpath=.;c:\myapp\JConfig.zip;%classpath%

Also, the native code libraries (jcnfigSN.dll, etc.) must be in the path. Note that the 'path' is a completely different environment variable from the classpath. The path is initially set in your autoexec.bat file, and tells Windows where to look for executables.

If the JConfig DLLs are in the 'c:\myapp' directory, you could use the following line in your batch file:

    set path=.;c:\myapp\;%path%

Note: you indicate the directory where the DLLs are stored, not the DLLs themselves.

Note: you can set the classpath and the path either in autoexec.bat, or in the batch file used to run your app, depending on your distribution method and other factors.

Another example of how to set the path and classpath is provided in the 'TesterSN.bat' batch file:

    set SAMDRIVE=c:
    set SAMHOME=c:\samizdat
    set JDKHOME=e:\jdk1.1.4

    %SAMDRIVE%
    cd %SAMHOME%\jconfig

    set classpath=.;%SAMHOME%\common\jconfig.zip;%JDKHOME%\lib\classes.zip
    set path=%path%;%SAMHOME%\common\

    set LD_LIBRARY_PATH=%LD_LIBRARY_PATH%;%SAMHOME%\common\

    %JDKHOME%\bin\java com.jconfig.Tester

The line setting 'LD_LIBRARY_PATH' is probably not needed, but it doesn't hurt either.

Debugging

JConfig writes debug messages to the DBWin32.exe application. This application is included in the file DBWin32.zip, which is in the windebug folder. Please run this application when using JConfig; if you have any problems with JConfig, please copy the contents of the DBWin32 window, and send them with your bug report.