RethinkDisplay

Grand manipulation of the entire Intuition display.

Declaration

Source position: intuition.pas line 3520

Function result

Returns zero for success, non-zero for failure. Probable cause of failure is failure of MakeVPort() or of MrgCop().

Description

This function performs the Intuition global display reconstruction. This includes rethinking about all of the ViewPorts and their relationship to one another and reconstructing the entire display based on the results of this rethinking.

Specifically, and omitting many internal details, the operation consists of this:

• Determine which ViewPorts are invisible and set their VP_HIDE ViewPort Mode flag. VP_HIDE flags are also set for screens that may not be simultaneously displayed with the frontmost.
• If a change to a viewport height, or changing interlace or monitor scan rates require, MakeVPort() is called for specific screen viewports. After this phase, the intermediate Copper lists for each screen's viewport are correctly set up.
• MrgCop() and LoadView() are then called to get these Copper lists in action, thus establishing the new state of the Intuition display.

You may perform a MakeScreen() on your Custom Screen before calling this routine. The results will be incorporated in the new display, but changing the interlace ViewPort mode for one screens must be reflected in the Intuition View, which is left to Intuition.

Warning: This routine can take several milliseconds to run, so do not use it lightly.

This routine is substantially changed to support new screen modes. In particular, if screen rearrangement has caused a change in interlace mode or scan rate, this routine will remake the copper lists for each screen's viewport.

See also