Nishita Ad Banner Plug-In
==============================
(Nishita's Freeware)

Revised: March 10, 2000
http://www.nishita.com

Summary: 
-------------
Description: 
This DLL allows you to run your Internet Sponsor's Banner Ads from your application 
and launch browser like Netscape or IE to send your users to your sponsor's web site 
when they click the ad. This is very similar to the get paid by surfing web kind software 
except you can use in your software.  Now you can generate some incomes even from your freeware.  
Since this is a DLL, it can be used in any Windows 32 bit programming language which support 
DLL links.  Example can be downloaded from http://nishita.com.
 

DLL            : NBannerAdPI.dll (32 bit)
Author         : K. Nishita
e-mail         : info@nishita.com
Home Page      : http://www.nishita.com
Delphi Ver     : 2.0, 3.0, 4.0, 5.0
BCB Ver        : 1.0 2.0, 3.0, 4.0, 5.0
Other Languages: Any 32 bit Windows programming language which can call dll.
Component Ver. : 1.0.0
Type           : Freeware
Source Code    : Not available


Legal issues: 
-------------
              Copyright (C) 2000 by K. Nishita. All Rights Reserved.
              
              This software is provided 'as-is', without any express or
              implied warranty. In no event will the author be held liable
              for any damages and loss arising from the use of this software.

              Permission is granted to anyone to use this software for any
              purpose, including commercial applications subject to the following
              restrictions:

              1. The origin of this software must not be misrepresented,
                 you must not claim that you wrote the original software.
                 If you use this software in a product, an acknowledgment
                 in the product documentation would be appreciated but is
                 not required.

              2. This notice may not be removed or altered from any source
                 distribution.

              3. You are encouraged to distribute this software freely in 
                 the original packaging. You may not charge any fees for this software.

              4. You must register this software by visiting http://nishita.com. 


		***** LEGAL NOTICE for GIF Format ************************************

		By US courts, UniSys Inc. (the inventors of the LZW file
		format used by GIF) and Compuserve, who are the registered users
		of the GIF format. You will need to obtain a license from them before 
                using this dll in any product to be sold for profit including shareware.
		However, freeware is exempt from this requirement. 
	
		***** LEGAL NOTICE for GIF Format ************************************

Register
--------

Nishita Ad Banner Plug-In is freeware. If you use the dll, you must register. 
To register, you can send an e-mail to info@nishita.com or just visiting 
http://nishita.com will be also considered registration.


DLL:
---

NBannerAdPI.dll     Nishita Banner Ad Plug-In (32 bit MS Windows DLL)


Sample application:
------------------

TEST.EXE            Example Program
default.gif         Default Ad Banner
ftp\bannerinfo.txt  Banner Information File. This file must be placed on your FTP site.
ftp\*.gif           Banner Ad Files. These files must be placed on your FTP site.  

The following example source code can be downloaded from http://nishita.com.
TEST.DPR            Example Program Source Code. 
TEST.DFM            Example Program Source Code.
UNIT_TEST.PAS       Example Program Source Code.


DLL Usage:
---------

Callable Functions: For the dll function usage, please see UNIT_TEST.PAS (Download from http://nishita.com).

1.  function IsOnline:Integer;
    Check if the PC is connected to the Internet.

2.  function InitBannerAD(Interval:Integer;DefURL,DefGifFileName,HostName,UserName,Password,BannerFileName:PChar):Integer; 
    Initialize Banner Ad.  
    Interval: Interval to change the banner ad.
    DefURL: Default URL. (ex. http://nishita.com)
    DefGifFileName: Default Gif Filename.
    HostName: Your ftp account server name without ftp:// (ex. freeware.freeservers.com)
    UserName: Your ftp account user name.
    Password: Your ftp account password.  (You may want to encrypt this information in your program)
    BannerFileName: Your banner information filename. (ex. bannerinfo.txt) Please see bannerinfo.txt in my example.   

3.  function StartBannerAd(SOption:Integer):Integer; 
    Used to start the banner ad.  Use SOption = 0.

4.  function CloseBannerAd:Integer; 
    Used to close the banner ad and deletes all the downloaded banner ad files.


To setup your banner, please follow the steps below.

1. Setup your banner info file.  (please see my example file ftp\bannerinfo.txt)
2. Upload your gif files (banners) to your ftp site.  (All the gif files must be on your ftp server)
3. Call InitBannerAd, IsOnline, and StartBannerAd functions in NBannerAdPI.dll as is done my example.

That's it!


Support:
--------

If you have any question, need technical help, or have comments, 
please send me an e-mail to info@nishita.com.

K. Nishita 
e-mail: info@nishita.com
WWW:    http://nishita.com 

The current version can be downloaded from http://nishita.com.


Known problems:
--------------

1. The dll does not display some of the gif file.
2. The dll occasionally fail to receive the ad banner.


Version Changes:
---------------

Ver 1.0.0
Initial release version.



Special thanks
--------------
This dll uses the following Delphi components.

TOnlineIP Component for Delphi 32 - Copyright (c) 1999 by Aleksey Xacker
Author: Aleksey Kuznetsov, Kiev, Ukraine
E-Mail: xacker@phreaker.net
WWW:    http://www.angen.net/~xacker/

ICS - Internet Component Suite - Copyright (C) 1997 by Franois PIETTE
Author: Franois PIETTE
E-Mail: francois.piette@ping.be
WWW:    http://www.rtfm.be/fpiette/indexuk.htm

ThtmlLite HTML Component, Version 6.2a - Copyright (C) 1995-1999 by L. David Baldwin 
Author: David Baldwin
E-Mail: dbaldwin@pbear.com
WWW:    http://www.pbear.com/ 

mdURLLabel - Copyright (C) 1997 by Martin Djerns
Author: Martin Djerns



-- END OF MESSAGES ------------------------------------------------------------------

info@nishita.com
http://www.nishita.com
