ProDelphi 42.x    Copyright 1998-2024  Helmuth J.H. Adolph

Freeware and Professional versions

---------------------------  Installing ProDelphi  ----------------------------
-------------------------- for 32-bit-applications ----------------------------

A  General
----------

 1. Check your CPU:
   
    ProDelphi runs on Pentium and Pentium compatible CPU's. It has been
    tested on:
    - Pentium Overdrive 120 MHz, Intel Celeron 400 MHz, Intel Pentium II, 
      with 400 MHz and Pentium III with 750 MHz, Pentium 4/2.4 GHz,
      Centrino 1.4 GHz, Core I5.
    - AMD K6 166 and 233 MHz, AMD K6-2 266, 300 and 500 MHz, AMD K6-3 400 MHz, 
      AMD Athlon 600 and 3000 MHz, Mobile Athlon 1800 MHz, Duron 1000 Mhz,
      AMD Turion 64, Turion 64 X2, AMD Athlon 64 and Athlon 64 X2.
   
    It definitely does NOT run on a Cyrix 6x86. The Cyrix M2 and IDT have
    not been tested.

 2. If you have installed an old version of ProDelphi before, please uninstall
    it before installing the new version. For that you need to use the setup
    program which resides in the directory in which ProDelphi has been installed.

 3. Install ProDelphi with the enclosed Setup program (Setup.exe).

 4. You should read the documentation (GuidePD.PDF), Post-Mortem-review is only
    described in the documention.


B.  Testing the installation with the example program (for automatic setup)
----------------------------------------------------------------------------
  Unzip the file Prodel.zip and install ProDelphi with Setup.exe.

  After installing ProDelphi you can, for testing the
  installation of ProDelphi, compile the example program installed in the
  subdirctory PROFILE-ME below the examples directory. 

  The compiler switch for optimization should be unchecked, otherwise
  ProDelphi inserts lines for deactivating optimization into your sources.

  You should first compile the program in the directory PROFILE-ME
  and then start ProDelphi from the Tools-menu of Delphi. Select the tab
  'Profiling', select this program, check the box 'Autostart' and then click
  the 'Instrument' button. After that define the compiler symbol 'PROFILE' in Delphi
  and compile it again. Start the program, press the start button and then
  close the application. In ProDelphi select the tab 'View results', select
  the text file in the directory PROFILE-ME, and click 'Load and View'. 
  A window should appear with the measurement results.

  You could repeat the test run of the example application with the check
  box for optimization enabled. With the online activation window you have the
  possibility to store multiple measurements in the result file. See user
  guide for this.


  The programs in the subdirectory DLLSUPP are examples for users who want 
  to measure methods in DLL's.


C. Profiling your own sources
-----------------------------

 1. Save all your sources (e.g. ZIP them into an achive file).

 2. Compile your program.

    If no errors occur:

    3. Start ProDelphi.

    4. Select Profile and choose the correct Delphi-version. If you use
       conditional symbols, you should see them in your ProDelphi window (if
       not, you haven't saved your project).

    5. Define the compiler symbol PROFILE in the compiler options (conditional
       definitions), NOT in the source file! 
       Uncheck the Optimization-option !!!!!!!

    6. Click on 'Instrument'.

    7. BUILD your application.

    8. Start your program and let it do what it has to do.

       Attention: When you start your program, it takes a second or two for
                  calibration (estimation of your CPU speed and measurement
                  correction times).

                  When you use ProDelphi under Windows 95, the interrupts
                  are locked while calibrating, that means that your mouse
                  cursor does not move !!!
                  Under Windows NT/XP/2000/Vista/7/8 the interrupts can not be
		  locked, so your mouse cursor can be moved.

                  Please do not start any other programs while calibrating,
                  otherwise the results are incorrect.

                  After the calibration phase the Online operation window and
                  your form(s) is/are shown.


    9. After your program has terminated, start ProDelphi, select VIEW,
       open the directory with your compiled program, select the file 
       'Progname.TXT' and click the Run-button.
       'Progname' stands for the name of your program.
       After this actions the viewer window opens and you can look at the
       results of the measurement.

   10. Checked procedures might use a few CPU-cycles more than they would
       use without measurement. The reason is, that the measurement procedures
       in the unit ProfInt and in the DLL ProfMeas are moved into the memory 
       cache and delete those procedures that would be there without 
       measurement. Depending on the CPU you use, the results are very accurate
       or less accurate. (Same effect is given for data too.)

       The L1-cache of the plain pentium has 16 kB,
       the L1-cache of pentium MMX / PII or Celeron have 32 kB Cache size,
       the AMD K6 / K6-2 / K6-3 have 64 kB L1-Cache size, AMD Athlon has
       128 kB L1-Cache, Pentium 4 A has 20 kB L1-Cache.
       Also the L2-Cache sizes differ, the processor might have a L3-cache
       (e.g. the AMD K6-3). Also the accesses to L2-cache differ (1/3, 1/2,
       1/1 CPU frequency or bus frequency).

       That's why the results on an AMD K6-x or AMD Athlon are more excact 
       than on pentium processors.


11. See the GuidePD.PDF file for further instruction or information.

12. Limitations of use:

    Console applications can not have an online operation window.
    For further minor important limitations see README.DOC.

13. For DLL-support unzip the file DLLSUPP.ZIP and read the comments in the
    sources.


--------------------------  Uninstalling ProDelphi ----------------------------

Delete the files, directories and links you have created. For that you can use
the Setup Program residing in the installation directory of ProDelphi.


-----------------------  ProDelphi Distribution Files  ------------------------

  PROFILER.EXE     ProDelphi executable file
  PROFINT.PAS      Unit that links the profiled VCL program or DLL to the 
                   measurement DLL PROFMEAS.DLL (time measurement).
  PROFINTC.PAS     Unit that links the profiled CLX program or DLL to the 
                   measurement DLL PROFMEAS.DLL (time measurement).
  PROFINTF.PAS     Unit that links the profiled FMX program or DLL to the 
                   measurement DLL PROFMEAS.DLL (time measurement).
  PROFINTPACK.dpk  Service for instrumentation of packages.
  PROFMEAS.DLL     The DLL, that contents all measurement procedures. There is
                   one DLL for all Delphi versions.
  PROFCALI.DLL     DLL that computes the measurement correction (calibration),
                   it is included used by PROFINT.PAS.
  PROFONFO.DLL     DLL with the Online operation window.
  PRODVER.DLL      Version information.
  PDIFAC**.***     Interface to Delphi X IDE.
  GuidePD.PDF      Description of ProDelphi x.x (Adobe-Format)
  ORDER.TXT        Information on how to order the registered version
  LICENSE.TXT      License Agreement / Warranty Disclaimer
  VENDOR.TXT       Information for shareware distributors
  INSTALL.TXT      This file.
  NEWS.TXT         News and Hints for usage of ProDelphi.
  REGISTER.ENG     Registration via www.shareit.com (english)
  REGISTER.GER     Registration via www.shareit.com (german)
  SETUP.EXE        Program for automatic setup.
  GETSPEED.EXE     Program to get the speed index of a PC to be emulated.
  DLLSUPP.ZIP      Example project for measuring procedures in a DLL.

  example files


-------------------------  Files created by ProDelphi -------------------------

PROFLST.ASC    Contains information about the procedures to be measured for
               profiling or traced for post mortem review.

PROFILE.INI    Options for time measurement, screen coordinates for the
               online operation window.

----------  Files created at runtime by measured or traced programs -----------

PROGNAME.EXE   PROGNAME is the name of your executable, created by Delphi.

PROGNAME.TXT   Results in data base format (runtimes of the procedures), used
               by the built-in viewer.

PROGNAME.TX2   Run numbers, CPU-clock-rate and headlines for the built-in
               viewer.

PROGNAME.TX3   References to the source lines for opening a file in the
               Delphi editor.

PROGNAME.NEV   Contents the names of those methods that are not called at
               time of measurement.

PROGNAME.HST   History file, stored by the viewer when the history button
               is pressed. Contains runtimes for later comparison after
               optimization.

PROGNAME.SWO   List of procedures that have to be deactivated for time
               measurement at next program start.

PROGNAME.PMR   Call stack in case of a trapped exception (for Post Mortem 
               Review only).

All files are created in the output directory for the exe- or dll-file.
