Provided by: libggi2_2.2.2-3ubuntu1_i386 bug

NAME

       display-sub - 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.