TransluXent

Invocation

Invocation

To run transluXent you need an X server which supports GLX already running as transluXent utilizies the existing X server to do OpenGL graphics. When you run transluXent it puts up another window which becomes its root window, much like Xnest.

A sample invocation is:

transluXent :1 -query localhost, if you have xdm running and listening.

Or just transluXent :1 -ac followed window-manager-of-your-choice -display :1

Besides the standard X server options, the TransluXent server currently understands the following command line options:

-display display (default: $DISPLAY)

Which existing X display transluXent should utilize for input and output.

-geometry widthxheight (default: 1024x768)

Specifies the size of the root window.

-fullscreen

Utiliize the full screen.

-backbuffer safe

Some hardware (such as mine) actually copies the back buffer to the front buffer upon a SwapBuffers request. The back buffer then holds the same content as before the swap. When this is true we need to render only the modified screen regions for the next redraw. If using this options gives a garbage screen use -backbuffer garbage instead.

-backbuffer garbage (default)

The OpenGL specification says that the contents of the back buffer are undefined after a SwapBuffers operation. If this is actually true for your hardware use this option which forces a full redraw for each screen refresh.

-tilesize size (default: 128)

Specifies the size of the textures to use. Textures can only come is square shape and only in power of two dimensions. Larger textures mean less operations to send to the hardware but more memory loss to fragmentation. Smaller textures mean more operation to send to the hardware and less memory loss.

-alpha value (default: 0.9)

This option allows you to adjust the transparency of top level windows. Note: This option will vanish as we provide a real X extension in the future which will allow to change the value from within a window manager.

-texmem n (default: 16)

Amount of texture memory to use (in megabytes).

-partial-swaps (default: off)

When your graphics hardware actually copies the back buffer upon flips, this is a hack which tries to only swap what needs to be swaped.