You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tqt3/examples/opengl/overlay_x11
Timothy Pearson dfb87398c7
Automated update from Qt3
10 years ago
..
utilities Test conversion to TQt3 from Qt3 8c6fc1f8e35fd264dd01c582ca5e7549b32ab731 13 years ago
README Automated update from Qt3 10 years ago
README.X11-OVERLAYS Automated update from Qt3 10 years ago
gearwidget.cpp Automated conversion from qt3 13 years ago
gearwidget.h Update to latest tqt3 automated conversion 13 years ago
main.cpp Automated conversion from qt3 13 years ago
overlay_x11.doc Automated update from Qt3 10 years ago
overlayrubber.pro Test conversion to TQt3 from Qt3 8c6fc1f8e35fd264dd01c582ca5e7549b32ab731 13 years ago
rubberbandwidget.cpp Update to latest tqt3 automated conversion 13 years ago
rubberbandwidget.h Update to latest tqt3 automated conversion 13 years ago

README

-----------------------------------------------------------------------
UPDATE: From version 5.0 onwards, the TQt OpenGL Extension includes
direct support for use of OpenGL overlays. For many uses of overlays,
this makes the technique described below redundant. See the 'overlay'
example program. The following is a discussion on how to use non-QGL
widgets in overlay planes.
-----------------------------------------------------------------------

Overlayrubber: An example program showing how to use TQt and TQt OpenGL
Extension with X11 overlay visuals.

(Background information for this example can be found in the file
 README.X11-OVERLAYS)

The example program has three main parts:

GearWidget: A simple QGLWidget that renders the usual gears. Modified
so that it will print a debug message every time it redraws (renders)
itself. Thus, you can eaily confirm that drawing in the overlay plane
does not cause redrawings in the main plane where the QGLWidget
resides.

RubberbandWidget: Very simple standard (non-GL) TQt widget that
implements rubberband drawing. Designed for use in an overlay
plane. It takes the planes' transparent color as a constructor
argument and uses that for its background color. Thus, the widget
itself will be invisible, only the rubberbands it draws will be
visible.

main.cpp: Creates a GearWidget and a Rubberbandwidget and puts the
latter on top of the former. Contains a routine that checks that the
default visual is in an overlay plane, and returns the transparent
color of that plane.


Running it:
-----------

Start the overlayrubber executable. Click and drag with the left mouse
button to see rubberband drawing. Observe that the QGLWidget does
not redraw itself (no redraw debug messages are output), and yet the
image is not destroyed. Marvel at the coolness of X11 overlays!


Using this technique in a real application
------------------------------------------

For clarity, this example program has been kept very simple. Here are
some hints for real application use:

All normal widgets can go in the overlay plane: This means that you
can put all kinds of TQt widgets (your own or those provided with Qt)
on top of the OpenGL image (widget), e.g. pushbuttons etc., and they
can be moved, resized, or removed without destroying the OpenGL image.

Using with geometry management: The QLayout classes will not allow you
to put one widget (the overlay) on top of another (the OpenGL widget);
that would defy the whole purpose of the automatic layout. The
solution is to add just one of them to the QLayout object. Have it
keep a pointer to the other (i.e. the QGLWidget knows about its
overlay widget or vice versa). Implement the resizeEvent() method of
the widget you put in the layout, and make it call setGeometry() on
the other widget with its own geometry as parameters, thus keeping the
two widgets' geometries synchronized.

Using with QPalette and QColorGroup: Instead of the somewhat
simplistic setBackgroundColor( transparentColor ), you can use Qt's
QPalette system for having your overlay widgets use transparent color
for what you want. This way, the normal TQt widgets can be used as
overlays for fancy effects: just create a palette for them with the
transparent color for the wanted color roles, e.g. Background and
Base, in the Normal and/or Active modes. This way, you can create
see-through QPushButtons etc.