                          
                         

            h u g i   s i z e   c o d i n g   c o m p e t i t i o n
                             n u m b e r   1 0

                                "TESTDBUG"

                               by TAD & Ruud

                          
                         


What The ?

        This program is an extension to the TEST.COM program
        used in the HC#10 test-suite program. I have added
        a useful debug-option which allows someone to view
        any graphical errors between their ENTRY.COM program
        and the built-in reference puzzle game.

Compile:

                TASM testdbug
                TLINK /t testdbug

Run:

                TESTDBUG [-d]  <entry.com>  <keys filename>

        e.g.
                TESTDBUG  -D  ENTRY.COM <KEYS1

Batch file:

        I have included a simple batch-file "DBUG.BAT" to make
        life even easier... you lucky ppl.

                DBUG


Debug-mode?

        The -D switch enabled the debug-mode option which
        is built into the TESTDBUG.COM program. Whenever a
        pixel difference is found between your ENTRY.COM
        program and the built-in reference graphics the
        program will stop and enter a small 'debug-mode'.

        The debug-mode displays a zoom-window together with
        an area indicated by the cursor. You can move this
        cursor around with either the mouse, or the normal
        [CURSOR] keys.


Flashy Graphics?

        Inside the zoom-window the graphics will sometimes
        flash between two different colors. This means that
        a particular pixel is incorrect (it does NOT match
        the reference puzzle graphics).

                     Flashing pixels = error  #:o(

                 non-flashing pixels = good   #:o)

        You can use the [TAB] key to cycle between the ENTRY.COM
        screen and the built-in reference screen.


Keys:

        [UP]            - move up    1 pixel
        [DOWN]          - move down     ""
        [LEFT]          - move left     ""
        [RIGHT]         - move right    ""

        [SHIFT+UP]      - move up    8 pixels
        [SHIFT+DOWN]    - move down     ""
        [SHIFT+LEFT]    - move left     ""
        [SHIFT+RIGHT]   - move right    ""

        [TAB]           - toggle the background screen
                          (switches between the reference
                           graphics screen and the ENTRY.COM
                           screen).

        [N]             - find the next pixel-error
                          (the cursor will be moved over it).

        [SPACE]         - run until the next game-loop error.

        [ESC]           - turn OFF debug-mode and run as normal.        


Credits:

        - TAD           (hey, that's me)
        - Ruud          (thanx for your help)



regards
        TAD.
