181 lines
7.5 KiB
HTML
181 lines
7.5 KiB
HTML
<HTML>
|
|
<HEAD>
|
|
<META name=vsisbn content="1576101746">
|
|
<META name=vstitle content="Michael Abrash's Graphics Programming Black Book, Special Edition">
|
|
<META name=vsauthor content="Michael Abrash">
|
|
<META name=vspublisher content="The Coriolis Group">
|
|
<META name=vspubdate content="07/01/97">
|
|
<META name=vscategory content="Web and Software Development: Game Development,Web and Software Development: Graphics and Multimedia Development">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<TITLE>Michael Abrash's Graphics Programming Black Book Special Edition: Assume Nothing</TITLE>
|
|
|
|
<!-- HEADER -->
|
|
<!-- Empty Reference Subhead -->
|
|
|
|
<!--ISBN=1576101746//-->
|
|
<!--TITLE=Michael Abrash's Graphics Programming Black Book Special Edition//-->
|
|
<!--AUTHOR=Michael Abrash//-->
|
|
<!--PUBLISHER=The Coriolis Group, Inc.//-->
|
|
<!--CHAPTER=03//-->
|
|
<!--PAGES=067-070//-->
|
|
<!--UNASSIGNED1//-->
|
|
<!--UNASSIGNED2//--></HEAD><BODY LINK=#0000FF ALINK=#000099 VLINK=#0000FF BGCOLOR=#FFFFFF>
|
|
|
|
<CENTER>
|
|
<TABLE BORDER>
|
|
<TR>
|
|
<TD><A HREF="03-08.html">Previous</A></TD>
|
|
<TD><A HREF="index.html">Table of Contents</A></TD>
|
|
<TD><A HREF="03-10.html">Next</A></TD>
|
|
</TR>
|
|
</TABLE>
|
|
</CENTER>
|
|
<P><BR></P>
|
|
<P><B>LISTING 3.7 LZTIME.BAT</B></P>
|
|
<!-- CODE //-->
|
|
<PRE>
|
|
echo off
|
|
rem
|
|
rem *** Listing 3.7 ***
|
|
rem
|
|
rem ***************************************************************
|
|
rem * Batch file LZTIME.BAT, which builds and runs the *
|
|
rem * long-period Zen timer program LZTEST.EXE to time the code *
|
|
rem * named as the command-line parameter. Listing 3.5 must be *
|
|
rem * named LZTIMER.ASM, and Listing 3.6 must be named *
|
|
rem * LZTEST.ASM. To time the code in LST3-8, you’d type the *
|
|
rem * DOS command: *
|
|
rem * *
|
|
rem * lztime lst3-8 *
|
|
rem * *
|
|
rem * Note that MASM and LINK must be in the current directory or *
|
|
rem * on the current path in order for this batch file to work. *
|
|
rem * *
|
|
rem * This batch file can be speeded up by assembling LZTIMER.ASM *
|
|
rem * once, then removing the lines: *
|
|
rem * *
|
|
rem * masm lztimer; *
|
|
rem * if errorlevel 1 goto errorend *
|
|
rem * *
|
|
rem * from this file. *
|
|
rem * *
|
|
rem * By Michael Abrash *
|
|
rem ***************************************************************
|
|
rem
|
|
rem Make sure a file to test was specified.
|
|
rem
|
|
if not x%1==x goto ckexist
|
|
echo ***************************************************************
|
|
echo * Please specify a file to test. *
|
|
echo ***************************************************************
|
|
goto end
|
|
rem
|
|
rem Make sure the file exists.
|
|
rem
|
|
:ckexist
|
|
if exist %1 goto docopy
|
|
echo ***************************************************************
|
|
echo * The specified file, “%1,” doesn’t exist. *
|
|
echo ***************************************************************
|
|
goto end
|
|
rem
|
|
rem copy the file to measure to TESTCODE.
|
|
:docopy
|
|
copy %1 testcode
|
|
masm lztest;
|
|
if errorlevel 1 goto errorend
|
|
masm lztimer;
|
|
if errorlevel 1 goto errorend
|
|
link lztest+lztimer;
|
|
if errorlevel 1 goto errorend
|
|
lztest
|
|
goto end
|
|
:errorend
|
|
echo ***************************************************************
|
|
echo * An error occurred while building the long-period Zen timer. *
|
|
echo ***************************************************************
|
|
:end
|
|
</PRE>
|
|
<!-- END CODE //-->
|
|
<P>Listing 3.8 shows sample code that can be timed with the test-bed program of Listing 3.6. Listing 3.8 measures the time required to execute 20,000 loads of AL from memory, a length of time too long for the precision Zen timer to handle on the 8088.
|
|
</P>
|
|
<P><B>LISTING 3.8 LST3-8.ASM</B></P>
|
|
<!-- CODE //-->
|
|
<PRE>
|
|
;
|
|
; Measures the performance of 20,000 loads of AL from
|
|
; memory. (Use by renaming to TESTCODE, which is
|
|
; included by LZTEST.ASM (Listing 3.6). LZTIME.BAT
|
|
; (Listing 3.7) does this, along with all assembly
|
|
; and linking.)
|
|
;
|
|
; Note: takes about ten minutes to assemble on a slow PC if
|
|
;you are using MASM
|
|
;
|
|
jmpSkip;jump around defined data
|
|
;
|
|
MemVardb?
|
|
;
|
|
Skip:
|
|
;
|
|
; Start timing.
|
|
;
|
|
callZTimerOn
|
|
;
|
|
rept20000
|
|
moval,[MemVar]
|
|
endm
|
|
;
|
|
; Stop timing.
|
|
;
|
|
callZTimerOff
|
|
</PRE>
|
|
<!-- END CODE //-->
|
|
<P>When LZTIME.BAT is run on a PC with the following command line (assuming the code in Listing 3.8 is the file LST3-8.ASM)
|
|
</P>
|
|
<!-- CODE SNIP //-->
|
|
<PRE>
|
|
lztime lst3-8.asm
|
|
</PRE>
|
|
<!-- END CODE SNIP //-->
|
|
<P>the result is 72,544 µs, or about 3.63 µs per load of AL from memory. This is just slightly longer than the time per load of AL measured by the precision Zen timer, as we would expect given that interrupts are left enabled by the long-period Zen timer. The extra fraction of a microsecond measured per <B>MOV</B> reflects the time required to execute the BIOS code that handles the 18.2 timer interrupts that occur each second.</P>
|
|
<P>Note that the command can take as much as 10 minutes to finish on a slow PC if you are using MASM, with most of that time spent assembling Listing 3.8. Why? Because MASM is notoriously slow at assembling <B>REPT</B> blocks, and the block in Listing 3.8 is repeated 20,000 times.</P>
|
|
<H3><A NAME="Heading15"></A><FONT COLOR="#000077">Using the Zen Timer from C</FONT></H3>
|
|
<P>The Zen timer can be used to measure code performance when programming in C—but not right out of the box. As presented earlier, the timer is designed to be called from assembly language; some relatively minor modifications are required before the <B>ZTimerOn</B> (start timer), <B>ZTimerOff</B> (stop timer), and <B>ZTimerReport</B> (display timing results) routines can be called from C. There are two separate cases to be dealt with here: small code model and large; I’ll tackle the simpler one, the small code model, first.</P>
|
|
<P>Altering the Zen timer for linking to a small code model C program involves the following steps: <B> C</B> hange <B>ZTimerOn</B> to <B>_ZTimerOn</B>, change <B>ZTimerOff</B> to <B>_ZTimerOff</B>, change <B>ZTimerReport</B> to <B>_ZTimerReport</B>, and change <B>Code</B> to <B>_TEXT</B> . Figure 3.2 shows the line numbers and new states of all lines from Listing 3.1 that must be changed. These changes convert the code to use C-style external label names and the small model C code segment. (In C<SMALL>++</SMALL>, use the “C” specifier, as in</P>
|
|
<!-- CODE SNIP //-->
|
|
<PRE>
|
|
extern “C” ZTimerOn(void);
|
|
</PRE>
|
|
<!-- END CODE SNIP //-->
|
|
<P><BR></P>
|
|
<CENTER>
|
|
<TABLE BORDER>
|
|
<TR>
|
|
<TD><A HREF="03-08.html">Previous</A></TD>
|
|
<TD><A HREF="index.html">Table of Contents</A></TD>
|
|
<TD><A HREF="03-10.html">Next</A></TD>
|
|
</TR>
|
|
</TABLE>
|
|
</CENTER>
|
|
|
|
<hr width="90%" size="1" noshade>
|
|
<div align="center">
|
|
<font face="Verdana,sans-serif" size="1">Graphics Programming Black Book © 2001 Michael Abrash</font>
|
|
</div>
|
|
<!-- all of the reference materials (books) have the footer and subfoot reveresed -->
|
|
<!-- reference_subfoot = footer -->
|
|
<!-- reference_footer = subfoot -->
|
|
|
|
<!-- BEGIN SUB FOOTER -->
|
|
</BODY>
|
|
</HTML>
|
|
|
|
<!-- END FOOTER -->
|
|
|
|
|