[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


   NAME
        MakeVPort -- generate display copper list for a viewport.

   SYNOPSIS
        error =  MakeVPort( view, viewport )
         d0                   a0     a1

        ULONG MakeVPort( struct view *, struct viewport * );

   FUNCTION
        Uses information in the view, viewport, viewport->rasinfo to
        construct and intermediate copper list for this viewport.

   INPUTS
        view - pointer to a view structure
        viewport - pointer to a viewport structure
                 The viewport must have valid pointer to a RasInfo.

   RESULTS
        constructs intermediate copper list and puts pointers in
        viewport.DspIns
        If the colormap ptr in viewport is null then it uses colors
        from the default color table.
        If DUALPF in Modes then there must be a second RasInfo pointed
        to by the first RasInfo

        From V39, MakeVPort can return a ULONG error value (previous versions
        returned void), to indicate that either not enough memory could be
        allocated for MakeVPort's use, or that the viewport mode
        and bitplane alignments are incorrect for the bitplane's depth.

        You should check for these error values - they are defined in
        <graphics/view.h>.


   BUGS
        In V37 and earlier, narrow Viewports (whose righthand edge is
        less than 3/4 of the way across the display) do not work properly.

   SEE ALSO
        initvport() mrgcop() graphics/view.h intuition.library/makescreen()
        intuition.library/remakedisplay() intuition.library/rethinkdisplay()