display-sub(7) Make a child visual that is a window to the parent

SYNOPSIS


display-sub: <target-spec>

DESCRIPTION

Creates a "child" visual within a "parent". This can be thought of as a window and the display-sub target is intended for simple windowing systems.

No textual arguments, since this target can only be used by applications. argptr must contain the parent visual.

The sub target behaves a bit special with respect to (i.e. abuses the semantics of :) the ggiSetMode(3) call. It uses the "visible" size for the top left corner position of the window within the visual, and the "virtual" size for window width and height. Note, that moving/resizing the window does not cause any drawing action. You have to perform those yourself. All it does for you is providing a virtual visual within an existing one, which is convenient to allow for window system canvases to be about any GGI program.

Important: It is possible to have (0, 0) as upper, left corner. But beware, 0 means GGI_AUTO and therefore it may get overridden by GGI_DEFMODE environment variable. In this case, you may get unintended results.

OPTIONS

target-spec
Specifies the target which to draw on (the parent target). This defaults to automatic selection (just like using ggiOpen(NULL) when GGI_DISPLAY is not set).

FEATURES

  • DirectBuffer not supported.
  • Accelerated to the point of the parent. Calls are mapped through with modified clipping and coordinates.