![]() ![]() |
Since TGIFImage isn't a component it doesn't really need to be installed before you can use it.
However, if you would like to be able to use the TImage component to load and display GIFs at design time, Delphi must be told about TGIFImage somehow. The procedure to install TGIFImage is the same as with any other component, but varies a little with different versions of Delphi and C++ Builder.
|
||||
![]() |
Read the FAQ. Pay special attention to the first
issue mentioned (GIF doesn't display at run-time).
|
|||
![]() |
Verify that you do not have any other GIF libraries installed. Since TGIFImage registers itself with the TPicture class as a GIF handler, it will conflict with any other GIF libraries that does the same thing (e.g. rxLib and ImageLib). If you do not have another GIF library installed or you do not use the TImage component to load and display GIFs, you can skip this step. To verify that you don't have another GIF library installed you can create a new form, add a TImage component to it and click on the Picture property in the "Object Inspector". If the "Load Picture" dialog already has the "GIF" file type listed or you are able to load and display a GIF file, you do have another GIF library installed and will need to do something about it (if you have a previous version of TGIFImage installed you are obviously already using TGIFImage and thus do not need to do anything).
To avoid conflicts you must disable the TImage/TPicture integration of either
TGIFImage or the other GIF library:
To disable the GIF support of the other GIF library, you should consult the
library's documentation on how to do so. The following is what rxLib says
about the issue: If you are using another GIF image support library (like ImageLib), deactivate the conditional define USE_RX_GIF in RX\UNITS\RX.INC file and rebuild your component library. |
|
||||
Library installation | ||||
![]() |
From the Component menu select Install Component...
|
|||
![]() |
Specify gifimage as the Unit file name. If the gifimage unit isn't in the library search path, you can use the Browse button to specify where it is located.
|
|||
![]() |
Specify the package to add gifimage to in the Package file name field. Unless you prefer another package, I recommend that you use the dclusr50.dpk package which is reserved for "User's Components".
|
|||
![]() |
When you close the "Install Component" dialog, the package will be recompiled and installed
for you. Please note that TGIFImage will not show up on your component palette since it is not a component. If this surprises you, you should read the FAQ again.
|
|||
![]() |
To verify that TGIFImage is now available at design time, you can create a
new form, add a TImage component to it and click on the Picture
property in the "Object Inspector". The "Load Picture" dialog should now have a "GIF Image" file type and if you load a GIF file it should be displayed by the TImage component.
|
|||
![]() |
Finally, read the FAQ again. It might also be a good idea for you to read the list of Known Problems.
|
|||
Context sensitive help installation |
||||
![]() |
From the Help menu select Customize...
|
|||
![]() |
When the OpenHelp dialog appears select the Index tab. | |||
![]() |
Click the Add Files toolbar button and add tgifimage.hlp which will be found in the folder where you installed TGIFImage. | |||
![]() |
Close the OpenHelp dialog and Save the project when prompted. | |||
![]() |
It may be necessary to exit and restart Delphi before the help system is properly updated (An alternative is to delete the Delphi5.gid file located in Delphi's help directory). |
|
||||
Library installation | ||||
![]() |
From the Component menu select Install Component...
|
|||
![]() |
Specify gifimage as the Unit file name. If the gifimage unit isn't in the library search path, you can use the Browse button to specify where it is located.
|
|||
![]() |
Specify the package to add gifimage to in the Package file name field. Unless you prefer another package, I recommend that you use the dclusr40.dpk package which is reserved for "User's Components".
|
|||
![]() |
When you close the "Install Component" dialog, the package will be recompiled and installed
for you. Please note that TGIFImage will not show up on your component palette since it is not a component. If this surprises you, you should read the FAQ again.
|
|||
![]() |
To verify that TGIFImage is now available at design time, you can create a
new form, add a TImage component to it and click on the Picture
property in the "Object Inspector". The "Load Picture" dialog should now have a "GIF Image" file type and if you load a GIF file it should be displayed by the TImage component.
|
|||
![]() |
Finally, read the FAQ again. It might also be a good idea for you to read the list of Known Problems.
|
|||
Context sensitive help installation |
||||
![]() |
From the Help menu select Customize...
|
|||
![]() |
When the OpenHelp dialog appears select the Index tab. | |||
![]() |
Click the Add Files toolbar button and add tgifimage.hlp which will be found in the folder where you installed TGIFImage. | |||
![]() |
Close the OpenHelp dialog and Save the project when prompted. | |||
![]() |
It may be necessary to exit and restart Delphi before the help system is properly updated (An alternative is to delete the Delphi4.gid file located in Delphi's help directory). |
|
||||
Library installation | ||||
![]() |
From the Component menu select Install Component...
|
|||
![]() |
Specify gifimage as the Unit file name. If the gifimage unit isn't in the library search path, you can use the Browse button to specify where it is located.
|
|||
![]() |
Specify the package to add gifimage to in the Package file name field. Unless you prefer another package, I recommend that you use the dclusr30.dpk package which is reserved for "User's Components".
|
|||
![]() |
When you close the "Install Component" dialog, the package will be recompiled and installed
for you. Please note that TGIFImage will not show up on your component palette since it is not a component. If this surprises you, you should read the FAQ again.
|
|||
![]() |
To verify that TGIFImage is now available at design time, you can create a
new form, add a TImage component to it and click on the Picture
property in the "Object Inspector". The "Load Picture" dialog should now have a "GIF Image" file type and if you load a GIF file it should be displayed by the TImage component.
|
|||
![]() |
Finally, read the FAQ again. It might also be a good idea for you to read the list of Known Problems.
|
|||
Context sensitive help installation |
||||
![]() |
In the Delphi Help directory open Delphi3.cnt with a text editor and insert
into the Index section. Replace Path with the path to the directory where you installed TGIFImage. The index section will then look something like this:
|
|||
![]() |
Save the modified Delphi3.cnt file. |
|
||||
Library installation | ||||
![]() |
From the Component menu select Install...
|
|||
![]() |
Click the Add... button and specify gifimage.pas as the Module name. If the gifimage unit isn't in the library search path, you can use the Browse button to specify where it is located.
|
|||
![]() |
When you close the "Install Components" dialog, the component library will
recompiled be for you. Please note that TGIFImage will not show up on your component palette since it is not a component. If this surprises you, you should read the FAQ again.
|
|||
![]() |
To verify that TGIFImage is now available at design time, you can create a
new form, add a TImage component to it and click on the Picture
property in the "Object Inspector". The "Load Picture" dialog should now have a "GIF Image" file type and if you load a GIF file it should be displayed by the TImage component.
|
|||
![]() |
Finally, read the FAQ again. It might also be a good idea for you to read the list of Known Problems.
|
|||
Context sensitive help installation |
||||
![]() |
The TGIFImage context sensitive help currently doesn't support Delphi 2. |
|
||||
Library installation | ||||
![]() |
From the Component menu select Install Component...
|
|||
![]() |
Specify gifimage.pas as the Unit file name. If the gifimage unit isn't in the library search path, you can use the Browse button to specify where it is located.
|
|||
![]() |
Specify the package to add gifimage to in the Package file name field. Unless you prefer another package, I recommend that you use the dclusr40.bpk package which is reserved for "User's Components".
|
|||
![]() |
When you close the "Install Component" dialog, the package will be recompiled and installed
for you. Please note that TGIFImage will not show up on your component palette since it is not a component. If this surprises you, you should read the FAQ again.
|
|||
![]() |
To verify that TGIFImage is now available at design time, you can create a
new form, add a TImage component to it and click on the Picture
property in the "Object Inspector". The "Load Picture" dialog should now have a "GIF Image" file type and if you load a GIF file it should be displayed by the TImage component.
|
|||
![]() |
Finally, read the FAQ again. It might also be a good idea for you to read the list of Known Problems.
|
|||
Context sensitive help installation |
||||
![]() |
From the Help menu select Customize...
|
|||
![]() |
When the OpenHelp dialog appears select the Index tab. | |||
![]() |
Click the Add Files toolbar button and add tgifimage.hlp which will be found in the folder where you installed TGIFImage. | |||
![]() |
Close the OpenHelp dialog and Save the project when prompted. | |||
![]() |
It may be necessary to exit and restart C++ Builder before the help system is properly updated (An alternative is to delete the Bcb4.gid file located in C++ Builder's help directory). |
|
||||
Library installation | ||||
![]() |
From the Component menu select Install Component...
|
|||
![]() |
Specify gifimage.pas as the Unit file name. If the gifimage unit isn't in the library search path, you can use the Browse button to specify where it is located.
|
|||
![]() |
Specify the package to add gifimage to in the Package file name field. Unless you prefer another package, I recommend that you use the dclusr35.bpk package which is reserved for "User's Components".
|
|||
![]() |
When you close the "Install Component" dialog, the package will be recompiled and installed
for you. Please note that TGIFImage will not show up on your component palette since it is not a component. If this surprises you, you should read the FAQ again.
|
|||
![]() |
To verify that TGIFImage is now available at design time, you can create a
new form, add a TImage component to it and click on the Picture
property in the "Object Inspector". The "Load Picture" dialog should now have a "GIF Image" file type and if you load a GIF file it should be displayed by the TImage component.
|
|||
![]() |
Finally, read the FAQ again. It might also be a good idea for you to read the list of Known Problems.
|
|||
Context sensitive help installation |
||||
![]() |
From the Help menu select Customize...
|
|||
![]() |
When the OpenHelp dialog appears select the Index tab. | |||
![]() |
Click the Add Files toolbar button and add tgifimage.hlp which will be found in the folder where you installed TGIFImage. | |||
![]() |
Close the OpenHelp dialog and Save the project when prompted. | |||
![]() |
It may be necessary to exit and restart C++ Builder before the help system is properly updated (An alternative is to delete the Bcb3.gid file located in C++ Builder's help directory). | |||
Examples If you wish to use the TGIFImage demo applications with C++ Builder 3, you will need to convert them from C++ Builder 4 format before they can be compiled. |
||||
![]() |
Open the bcb_gifdemos.bpg project group from the TGIFImage demo directory in C++ Builder. | |||
![]() |
For each project in the project group, C++ Builder will notify you that it has updated the project make file from version 0 to version 3. | |||
![]() |
Adjust the Include path of all projects in the project group: From the "Project" menu select "Options", then select the "Directories" tab and add $(BCB)\include;$(BCB)\include\vcl to the "Include path". |
|||
![]() |
In turn, open all forms of all projects in the project group. C++ Builder will display an error that says something like "Error reading XXXX: Property does not exist". Press the "Ignore All" button and save the form. |
|||
![]() |
In turn, open the "make" file (.BPR files) of all projects in the project group. Remove any references to DCLSTD35.LIB from the "LIBRARIES" and "SPARELIBS" section. |
|||
![]() |
Select "Close All" from the "File" menu to close all files and write all changes to disk. | |||
![]() |
Reopen the bcb_gifdemos.bpg project group and select "Make All Projects" from the project menu. C++ Builder should now compile all the demo projects without problems. Note: The Comments demo application currently fails to run when compiled with C++ Builder 3. |