MicroChip Data Systems
10501 NW 3rd Street
Fort Lauderdale, FL 33324
USA
===========================================
ZipTV Compression Components
for Delphi 4 thru 7 & C++ Builder 4 thru 6
===========================================
================================
Installation for Delphi 4 thru 7
================================
If you just ran the install program and ZipTV is present in the IDE's
component palette, skip to step 6.
Packages:
ztv70dt.dpk = Delphi 7 design time package
ztv70rt.dpk = Delphi 7 run time package
ztv60dt.dpk = Delphi 6 design time package
ztv60rt.dpk = Delphi 6 run time package
ztv50dt.dpk = Delphi 5 design time package
ztv50rt.dpk = Delphi 5 run time package
ztv40dt.dpk = Delphi 4 design time package
ztv40rt.dpk = Delphi 4 run time package
The below installation is for Delphi 7. If installing into any
other supported version of Delphi (listed above in packages),
replace the design time package ztv70dt.dpk for
ztv[Delphi version]0dt.dpk. Example, if installing into Delphi
6 IDE, replace all instances (in the following instructions) of
ztv70dt.dpk for ztv60dt.dpk, and ztv70rt.dpk for ztv60rt.dpk.
1. ALWAYS INTALL ZipTV INTO AN EMPTY DIRECTORY! DO NOT INSTALL
INTO A DIRECTORY CONTAINING A PREVIOUS VERSION OF ZIPTV.
2. Close all files: File / Close All.
3. Open and compile the ZipTV run-time package: ztv70rt.dpk. This
file was installed in subdirectory of where you installed ZipTV:
<InstallDir>\srce\ztv70rt.dpk. The compile will create two files
named $(DELPHI)\bin\ztv70rt.bpl and $(DELPHI)\bin\ztv70rt.dcp.
NOTE(s):
a) the output file ztv70rt.bpl is a run-time package, thus not
installable into the Delphi IDE component palette.
b) the installer creates these two files in the $(DELPHI)\bin, but
depending on your library settings, may also copy them into the
windows\system directory so they are accessible by the compiler via
dos command-line.
4. Open and compile the ZipTV design-time package: ztv70dt.dpk. This
compile will create $(DELPHI)\bin\ztv70dt.bpl and
$(DELPHI)\bin\ztv70dt.dcp.
5. Install the compiled design-time package ztv70dt.bpl when prompted.
6. Delphi's menu:
a) tools\options select the "library" tab: append the name of the
directory where ZipTV was just installed. This allows the Delphi IDE to
locate the required unit(s) when compiling projects.
7. To prevent the Delphi's debugger from stopping in the IDE at each
strategically placed exception the components raise, add our unique exception
variable into Delphi:
a. Select Menus "Tools" | "Debugger Options..." the window caption should
read Debugger Options.
b. Select tab "Language Exceptions".
c. Select button "Add".
d. Add the variable "E_Raise".
e. Select button "Ok" twice.
Now Delphi will ignore exceptions the ZipTV components raise while
monitoring exceptions raised in your application using the components.
NOTE(s)
If you used the default installation paths, append "$(DELPHI)\ziptv6" to Delphi's
library path. If the install directory is included in the library path, Delphi will
be unable to compile any projects.
=====================================
Installation for C++ Builder 4 thru 6
=====================================
If you just ran the install program and ZipTV is present in the IDE's
component palette, skip to step 6.
1. ALWAYS INTALL ZipTV INTO AN EMPTY DIRECTORY! DO NOT INSTALL
INTO A DIRECTORY CONTAINING A PREVIOUS VERSION OF ZIPTV.
2. Close all files: File / Close All.
3. Open and compile the ZipTV run-time package: ztv50rt.bpk. This file
was installed in subdirectory of where you installed ZipTV:
<InstallDir>\srce\ztv50rt.bpk. This compile will create ztv50rt.bpl
and tziptv5.dcp.
NOTE(s):
a) the output files (ztv50rt.bpl, ztv50rt.dcp) are runtime package;
therefore, this package is not installable into Delphi's component
palette.
b) the installer creates these two files in the $(BCB)\bin, but
also copies them into the windows\system directory so they are accessible
by the compiler via dos command-line.
4. Open and compile the ZipTV design-time package: tziptv5.bpk. This
compile will create tziptv5.bpl & tziptv5.dcp.
NOTE(s):
a) the installer creates these two files in the $(BCB)\bin, but
also copies them into the windows\system directory so they are accessible
by the compiler via dos command-line.
5. Install the compiled design-time package ztv50rt.bpl. This file should
be located in the $(BCB)\bin directory.
6. Delphi's menu:
a) tools\options select the "library" tab: append the name of the
directory where ZipTV was just installed. This allows the C++ Builder IDE to
locate the required unit(s) when compiling projects.
7. To prevent the C++ Builder's debugger from stopping in the IDE at each
strategically placed exception the components raise, add our unique exception
variable into C++ Builder:
a. Select Menus "Tools" | "Debugger Options..." the window caption should
read Debugger Options.
b. Select tab "Language Exceptions".
c. Select button "Add".
d. Add the variable "E_Raise".
e. Select button "Ok" twice.
Now Delphi will ignore exceptions the ZipTV components raise while
monitoring exceptions raised in your application using the components.
BE SURE THAT THE DIRECTORY WHERE ZIPTV WAS INSTALLED IS INCLUDED IN C++ Builder's
'LIBRARY PATH'. IF THE DIRECTORY IS NOT INCLUDED IN THE LIBRARY PATH,
C++ Builder WILL BE UNABLE TO COMPILE.
*When running any of the demo applications, remember to append the ZipTV
install path. This will allow C++ to find the generated .cpp and .hpp
files.
MENU: Projects, Options...
TAB: Directories/Conditionals
Append the install directory to the top three fields (Include path,
Library path, Debug source path).
===========================================
Installing the help file into Delphi's IDE:
===========================================
Install the help file into Delphi to enable F1 help with properties and events
within Delphi's Object Inspector. Pressing F1 is enabled in any code window
when F1 is pressed while the cursor is on the name of any property, method, or
event supported in the ZipTV Components.
The most simple way to install help files for components into any version of
Delphi is to use a 3rd party help installer. We recommend the following
installer:
http://www.delphidabbler.com/software.php?id=chi
http://www.ziptv.com/download/DelphiHelpInstaller.zip
It's a handy and easy to use utility to install any help system within all versions
of Delphi.