
         NN      NN     JJJJJJ   SSSSSSSS DDDDDDDD   KK      KK (TM)
         NN      NN       JJ   SS         DD      DD KK    KK
         NNNN    NN       JJ   SS         DD      DD KK  KK
         NN  NN  NN       JJ     SSSSSS   DD      DD KKKK
         NN    NNNN       JJ           SS DD      DD KK  KK
         NN      NN JJ    JJ           SS DD      DD KK    KK
         NN      NN   JJJJ     SSSSSSSS   DDDDDDDD   KK      KK

                              NJSDK (tm)

             NJStar Chinese Software Development Kits v3.0
        Copyright (C) Hongbo Ni 1992-1994. All Rights Reserved

                         Hongbo Data Systems
                 P.O.Box 40, Epping NSW 2121, AUSTRALIA
                      Telephone: +61-2-869-0821
                      Fax:       +61-2-869-0823
                      CompuServe:   100032,2724
___________________________________________________________________________


1. Introduction
============================================================================
NJSDK is a C Library based  on  NJSTAR  Version 3.0.  It  contains  all  the
functions for handling Chinese input, display and printing. With NJSDK, user
can develop any Chinese applications without knowing how Chinese  characters
are inputed, displayed or printed. It is  as  easy  as  writing  an  English
program.

Currently NJSDK is compiled with Microsoft C/C++ 7.00, and it is compatible
with Microsoft Visual C++ 1.0 and above.

NJSDK provides a Chinese interface for any C program. It reserves the bottom
line for Chinese input, and all other 24 lines (on VGA, 18  on  EGA,  29  on
SVGA) are working area for the application. NJSDK starts by loading  Chinese
font and dictionaries into memory, which require 200KB. If  user  select  to
leave font on disk, then NJSDK only requires 80KB  to  operate.  When  NJSDK
exits, all used memory are released, and screen is back to text mode.

NJSDK supports all the input methods in NJSTAR v3.0,  user  defined  methods
also supported in the same way as in NJSTAR. ALT+Function Keys are  reserved
by NJSDK for switching between the Chinese input methods (as listed in  next
section), and other Chinese related function.

Mouse operations are directly supported by NJSDK,  application  program  can
get mouse position by calling the NJSDK mouse functions.

Screen Saver and AutoSave  facilities  have  been  built  in  NJSDK.  Active
interval can be set by a configuration program NJSDKCFG.EXE.

2. License Information
============================================================================

With the full payment for NJSDK, the developer are  granted  a  distribution
license which permits the distribution of all NJSTAR  dictionaries,  drivers
and fonts (to be listed )  with  their  application  without  any  further
royalty payment. Distribution of any Executable file (*.EXE)  of  NJSTAR  is
strictly prohibited. Each licensed copy has an unique  serial  number,  this
protects any illegal use of NJSDK by other un-licensed users. Licensed  user
are entitled a free upgrade  to  next  version  of  NJSDK  when  it  becomes
available.  Please contact the author for current price.  Please contact the
author if you or your company have any special requirements or cooperations.

2.1 NJSDK is not and has never been public domain software, nor is it  free
    software. It is NJSDK owner's property.

2.2 No one may  modify  or  patch  the  NJSDK  library  files  in  any  way,
    including but not limited to decompiling,  disassembling,  or  otherwise
    reverse engineering the program.

2.3 The use of  NJSDK,  except  for  the  initial  30-day  trial,  requires
    registration. The use of unlicensed copies  of  NJSDK  by  any  person,
    business, corporation, government agency or any other entity is strictly
    prohibited.

2.4 Limited license is granted  to  copy  and  distribute  NJSDK  shareware
    version only for  the  trial  use  of  others,  subject  to  the  above
    limitations, and also the following:

    A) NJSDK must be copied in unmodified  form,  complete  with  the  file
       containing  this  license  information  and  the   file   containing
       registration information.

    B) The full machine-readable NJSDK  documentation must be also included
       with each copy.

    C) NJSDK may not be distributed in conjunction with any other  product
       without a specific license to do so from the author.

    D) No fee, charge, or other compensation may be requested or  accepted,
       except as authorized below:

       a) Operators of electronic bulletin board systems (sysops) may  make
          NJSDK available  for  downloading  only  as  long  as  the  above
          conditions are met. An overall or time-dependent charge  for  the
          use of the bulletin board system is permitted as long as there is
          not a specific charge for the download of NJSDK.

       b) ASP  vendors   can   distribute  NJSDK  without   obtaining   any
          permission from NJSDK  owner. Other  Vendors may distribute NJSDK
          only after  obtaining  written  permission from the NJSDK  owner.
          Such  permission  is  usually  granted.  Please write for details
          (enclose  your  catalog).  Vendors  may  charge  the  normal disk
          duplication and handling fee, which should not exceed $5 per disk.
          Please  refer to file VENDOR.DOC  for  more information.

                              LIMITED WARRANTY

A)   The Author  of NJSDK warrants  that all disks provided  are free from
     defects in material and workmanship, assuming normal use, for a period
     of 30 days from the date of purchase.

B)   The  Author  of NJSDK  warrants  that  the  program will  perform  in
     substantial  compliance with  the documentation  supplied  within this
     document.    If a  significant  defect in  the  product is  found, the
     Purchaser may return the product for a  refund.  In no event will such
     a refund exceed the purchase price of the product.

C)   Use of this product for any period of time constitutes your acceptance
     of this agreement and subjects you to its contents.

D)   EXCEPT  AS  PROVIDED  ABOVE,  THE   AUTHOR   OF  NJSDK  DISCLAIMS  ALL
     WARRANTIES, EITHER EXPRESS OR  IMPLIED, INCLUDING, BUT NOT  LIMITED TO
     IMPLIED WARRANTIES  OF MERCHANTABILITY  AND FITNESS  FOR A  PARTICULAR
     PURPOSE,  WITH RESPECT  TO  THE  PRODUCT.   SHOULD  THE PROGRAM  PROVE
     DEFECTIVE, THE PURCHASER ASSUMES THE RISK OF PAYING THE ENTIRE COST OF
     ALL NECESSARY SERVICING,  REPAIR, OR CORRECTION AND  ANY INCIDENTAL OR
     CONSEQUENTIAL DAMAGES.  IN NO  EVENT WILL THE  AUTHOR   OF   NJSDK BE
     LIABLE  FOR  ANY  DAMAGES  WHATSOEVER  (INCLUDING  WITHOUT  LIMITATION
     DAMAGES FOR LOSS OF  BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS  OF
     BUSINESS INFORMATION  AND  THE LIKE)  ARISING OUT  OF THE  USE OR  THE
     INABILITY TO USE THIS  PRODUCT EVEN IF THE AUTHOR HAS  BEEN ADVISED OF
     THE POSSIBILITY OF SUCH DAMAGES.


3. List of files in NJSDK package
============================================================================

Main Programes:
        NJSDK.LIB       The NJSDK C subroutine library (MSC 7.0 Large model)
        NJSDK.H         The header file for NJSDK
        NJSDK.INI       NJSDK Initialization file
        KEYS.H          The header file for key and mouse button definitions
        NJCARD.C        Example program (name and address managment program)
        NJCARD.EXE      NJCARD.c complied with registered NJSDK.
        NJCARD.DBS      Address Data Base File
        CC.BAT          Batch file used to compile program, eg.  CC njcard
        NJSDK.CFG       NJSDK configuration file
        NJSDKCFG.EXE    The application configuration program

Documentations:
        README.TXT      This File
        NJSDK.TXT       Documentation of NJSDK
        NJSDK.DOC       MS WinWord 2.0 version of NJSDK.TXT (shareware only)
        FILE_ID.DIZ     NJSDK description for BBS
        VENDOR.DOC      Instruction for shareware vendors
        PRODUCTS.DOC    List of progames from the author

Following files from NJSTAR are needed for program based on  NJSDK  to  run.
Those files can be distributed with user's .EXE file  only  after  a  proper
distribution license has been purchased.

        CCLIB.16        16x16 Simplified Chinese bitmap
        CCLIBF.16       16x16 un-Simplified Chinese bitmap
        ASCII.16        16x8 Ascii bitmap
        CCLIB.24        24x24 Simplified Chinese bitmap (With Reg. ver)
        CCLIBF.24       24x24 un-Simplified Chinese bitmap (With Reg. ver)
        ASCII.24        24x12 Ascii bitmap (With Reg. ver)

        NANJIPY.DIC     NJSTAR PinYin dictionary
        NANJILX.DIC     NJSTAR Lianxiang dictionary
        NJINPUT*.DIC    External character input methods dictionary
        NJCIZU*.DIC     External word input methods dictionary
        TOLERATE.DIC    PinYin Tolerance lists (text file)
        ********.DRV    Printer drivers
        SUPER.VGA       The super VGA definition file (required by NJSDKCFG)

If NJSTAR is installed on C:\NJSTAR, a file NJSDK.INI can be created in
the same directory as user's application. It should contains two lines:

NJZK=C:\NJSTAR
NJDIC=C:\NJSTAR

NJSDK will try to locate the font and dictionaries in the same directory as
users EXE file. If not found, NJSDK will try those as defined in NJSDK.INI.
user can also set two DOS environment variables in AUTOEXEC.BAT to specify
the location of fonts and dictionaries (override NJSDK.INI).

SET NJZK=C:\NJSTAR
SET NJDIC=C:\NJSTAR

In this way, only one set of font and dictionaries are needed in one
computer, all the NJSDK applications and NJSTAR can access the same font
and dictionaries.

4. Examples
===========================================================================

Two examples are included in NJSDK shareware package, The first one is the
classic 'hello world' example.

The second one is much more complex. NJCARD is a Name and Address Data base
managment program. It provides simple Record searching, adding, deleting
editing functions. The program can dial the current user phone number with
a modem by pressing a button. Your must have NJSTAR Chinese WP 3.0 installed
before start NJCARD or and other NJSDK application.


