Client | Application examples Server

# Client

A virtual X11 session implemented by XmetaX can be transferred to a real X Window server either directly or by simultaneous recording and playback.

## Directly: Meta technology

The Meta technology allows to display the virtual X11 session in a window within another session or on an empty X Window server without display manager or window manager.

### Display in a window, static

For displaying the virtual X11 session in a window the XmetaX proxy needs the option InWindow (Screen of type window). The option is configured by a configuration statement added to the startXvxMeta call (Additional configuration of the XmetaX proxy). If the virtual X11 session is to be displayed at startup, the additional screen of window type has to be added to the configuration of the proxy, like in:

    /opt/XSOXmetaX/bin/startXvxMeta \
        options +InWindow \
        window client0 \
            display client_computer:0.0 \
            sameAs screen0

Following is a more complex example implementing two screens of different color depths, which are scaled down (Zooming a screen):

    /opt/XSOXmetaX/bin/startXvxMeta 1280x1024x8 1280x1024x24 \
        options +InWindow +Vario \
        window client0 \
            display client_computer:0.0 \
            ofMetaScreen metaScreen0 \
            sameAs screen0 \
            clipGeometry 1280x1024 displayGeometry 768x640 \
            tags onTop \
        window client1 \
            display client_computer:0.0 \
            ofMetaScreen metaScreen1 \
            sameAs screen1 \
            clipGeometry 1280x1024 displayGeometry 768x640 \
            tags onTop

The display of the virtual X11 session can be stopped only by terminating the XmetaX proxy (Terminating the XmetaX proxy):

    /opt/XSOXmetaX/bin/xmetaxtool -display server_computer:10 -terminate

### Display in a window, dynamic

If the display window should be added or deleted later using the configuration tool xmetaxtool (XmetaXtool: control and integration), the XmetaX proxy needs the DynamicServer option (Dynamic configuration). The option is configured by a configuration statement added to the startXvxMeta call (Additional configuration of the XmetaX proxy), like in:

    /opt/XSOXmetaX/bin/startXvxMeta \
        options +InWindow +DynamicServer

The following command adds a window type screen:

    /opt/XSOXmetaX/bin/xmetaxtool -display server_computer:10 -noGui \
        window client0 \
            display client_computer:0.0 \
            sameAs screen0

The following command deletes the display window without disturbing the virtual X11 session (Screen):

    /opt/XSOXmetaX/bin/xmetaxtool -display server_computer:10 -noGui \
        window client0 \
            delete

Alternatively you may simply close the display window.

The following commands correspond to the two screens example:

    /opt/XSOXmetaX/bin/startXvxMeta 1280x1024x8 1280x1024x24 \
        options +InWindow +Vario +DynamicServer

    /opt/XSOXmetaX/bin/xmetaxtool -display server_computer:10 -noGui \
        window client0 \
            display client_computer:0.0 \
            ofMetaScreen metaScreen0 \
            sameAs screen0 \
            clipGeometry 1280x1024 displayGeometry 768x640 \
            tags onTop \
        window client1 \
            display client_computer:0.0 \
            ofMetaScreen metaScreen1 \
            sameAs screen1 \
            clipGeometry 1280x1024 displayGeometry 768x640 \
            tags onTop

    /opt/XSOXmetaX/bin/xmetaxtool -display server_computer:10 -noGui \
        window client0 \
            delete \
        window client1 \
            delete

### Display on an X Window server, static

For displaying the virtual X11 session on an empty X Window server the option InWindow is not needed.

If the virtual X11 session is to be displayed at startup, the additional screen has to be added to the configuration of the proxy, like in:

    /opt/XSOXmetaX/bin/startXvxMeta \
        screen client0 \
    	display client_computer:0.0 \
            sameAs screen0

Following is a more complex example implementing two screens of different color depths, which are scaled up (Zooming a screen):

    /opt/XSOXmetaX/bin/startXvxMeta 1280x1024x8 1280x1024x24 \
        options +Vario \
        screen client0 \
    	display client_computer:0.0 \
    	ofMetaScreen metaScreen0 \
            sameAs screen0 \
    	clipGeometry 1280x1024 displayGeometry 2560x2048 \
        screen client1 \
    	display client_computer:0.1 \
    	ofMetaScreen metaScreen1 \
            sameAs screen1 \
    	clipGeometry 1280x1024 displayGeometry 2560x2048

The display of the virtual X11 session can be stopped only by terminating the XmetaX proxy (Terminating the XmetaX proxy):

    /opt/XSOXmetaX/bin/xmetaxtool -display server_computer:10 -terminate

### Display on an X window server, dynamic

If the displaying X Window server should be added or deleted later using the configuration tool xmetaxtool (XmetaXtool: control and integration), the XmetaX proxy needs the DynamicServer option (Dynamic configuration). The option is configured by a configuration statement added to the startXvxMeta call (Additional configuration of the XmetaX proxy), like in:

    /opt/XSOXmetaX/bin/startXvxMeta \
        options +DynamicServer

The following command adds a screen:

    /opt/XSOXmetaX/bin/xmetaxtool -display server_computer:10 -noGui \
        screen client0 \
    	display client_computer:0.0 \
            sameAs screen0

The following command deletes the screen without disturbing the virtual X11 session (Screen):

    /opt/XSOXmetaX/bin/xmetaxtool -display server_computer:10 -noGui \
        screen client0 \
            delete

The following commands correspond to the two screens example:

    /opt/XSOXmetaX/bin/startXvxMeta 1280x1024x8 1280x1024x24 \
        options +DynamicServer +Vario

    /opt/XSOXmetaX/bin/xmetaxtool -display server_computer:10 -noGui \
        screen client0 \
    	display client_computer:0.0 \
    	ofMetaScreen metaScreen0 \
            sameAs screen0 \
            clipGeometry 1280x1024 displayGeometry 768x640 \
        screen client1 \
    	display client_computer:0.1 \
    	ofMetaScreen metaScreen1 \
            sameAs screen1 \
            clipGeometry 1280x1024 displayGeometry 768x640

    /opt/XSOXmetaX/bin/xmetaxtool -display server_computer:10 -noGui \
        screen client0 \
            delete \
        screen client1 \
            delete

## Recording and simultaneous playback: Pose technology

(Option Pose: recording, playback, copying, conversion)Using the Pose technology the virtual X11 session is recorded locally and simultaneously remotely replayed by the XposeXplay product (Copying).

You may synchronously transfer audio, video or arbitrary binary data (Multimedia).

For recording the XmetaX proxy needs the Pose option (Option Pose: recording, playback, copying, conversion). The option is configured by a configuration statement added to the startXvxMeta call (Additional configuration of the XmetaX proxy), like in:

    /opt/XSOXmetaX/bin/startXvxMeta \
        options +Pose

On the server side, usually there is no additional configuration needed:

    /opt/XSOXmetaX/bin/startXvxPose

The recording of the virtual X11 session and the simultaneous playback are started by the configuration tool xposextool (XposeXtool: control and integration without graphical user interface), here a window is used as display:

    /opt/XSOXmetaX/bin/xposextool -noGui \
    copySettings fromDisplay server_computer:0 \
        toDisplay client_computer:0 displayMode window \
    start copy

If the session should not only be displayed but also controlled remotely, the option Control (Input control) is needed. The following example shows the fullscreen display:

    /opt/XSOXmetaX/bin/xposextool -noGui \
    copySettings fromDisplay server_computer:0 \
        toDisplay client_computer: displayMode fullscreen inputSwitch onClick \
    start copy

The transfer of the virtual X11 session is stopped by closing the display window or by stopping the xposextool process. The session is not disturbed.

top
Application examples
Server

Copyright © 2021 X-Software GmbH
info@x-software.com