Previous: setbc Up: ../plot79_s.html Next: setci

SETBUG

       SUBROUTINE  SETBUG (BUGON,BUGPRT,BUGLIM)
 C$    (Debug CORE)
 C$    It is  occasionally  convenient to  be  able to  trace  the
 C$    execution of a graphics  application, particularly if  line
 C$    segments are not appearing  where they are expected.   This
 C$    routine may be called to set for debug printing.   Whenever
 C$    the world-coordinate  to  NDC space  transformation  matrix
 C$    changes, it is printed along  with all its factor  matrices
 C$    and all the  current viewing  parameters.  A  call to  this
 C$    routine  turning  on  printing   will  cause  the   current
 C$    parameters to be printed  immediately, so that a  following
 C$    call turning  it  off can  be  used to  capture  just  that
 C$    information.
 C$
 C$    Whenever a line segment is passed to PLTCL for clipping and
 C$    plotting,  the  current  point  in  world  coordinates   is
 C$    printed, along with the  start and end  points of the  line
 C$    segment in  NDC space.   If  clipping occurs,  the  clipped
 C$    segment is printed, and if the segment is rejected, this is
 C$    noted.
 C$
 C$    Since up to 3 lines can  be printed for every line  segment
 C$    generated, the output can be potentially voluminous, and it
 C$    should be requested with caution.  The arguments are:
 C$
 C$    BUGON....... .TRUE. - Turn on debug printing.
 C$                .FALSE. - Turn off debug printing.  The
 C$                           remaining arguments are ignored.
 C$    BUGPRT......FORTRAN unit number of the debug print file.
 C$    BUGLIM......Maximum number of debug lines allowed before
 C$                automatically shutting off the debug option.
 C$                If BUGLIM = 0, unlimited printing is allowed.
 C$
 C$    (02-SEP-83)