2014-11-21 21:30:24 +00:00
|
|
|
/*
|
|
|
|
* Copyright (C) 2013 Glyptodon LLC
|
|
|
|
*
|
|
|
|
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
|
|
* of this software and associated documentation files (the "Software"), to deal
|
|
|
|
* in the Software without restriction, including without limitation the rights
|
|
|
|
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
|
|
* copies of the Software, and to permit persons to whom the Software is
|
|
|
|
* furnished to do so, subject to the following conditions:
|
|
|
|
*
|
|
|
|
* The above copyright notice and this permission notice shall be included in
|
|
|
|
* all copies or substantial portions of the Software.
|
|
|
|
*
|
|
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
|
|
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
|
|
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
|
|
* THE SOFTWARE.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef GUAC_RDP_DISP_H
|
|
|
|
#define GUAC_RDP_DISP_H
|
|
|
|
|
2014-11-25 10:20:54 +00:00
|
|
|
#include <freerdp/client/disp.h>
|
2014-11-21 21:30:24 +00:00
|
|
|
#include <freerdp/freerdp.h>
|
|
|
|
|
2014-12-05 23:30:51 +00:00
|
|
|
/**
|
|
|
|
* The minimum value for width or height, in pixels.
|
|
|
|
*/
|
|
|
|
#define GUAC_RDP_DISP_MIN_SIZE 200
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The maximum value for width or height, in pixels.
|
|
|
|
*/
|
|
|
|
#define GUAC_RDP_DISP_MAX_SIZE 8192
|
2014-11-25 10:20:54 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* The minimum amount of time that must elapse between display size updates,
|
|
|
|
* in milliseconds.
|
|
|
|
*/
|
|
|
|
#define GUAC_RDP_DISP_UPDATE_INTERVAL 250
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Display size update module.
|
|
|
|
*/
|
|
|
|
typedef struct guac_rdp_disp {
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Display control interface.
|
|
|
|
*/
|
|
|
|
DispClientContext* disp;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The timestamp of the last display update request, or 0 if no request
|
|
|
|
* has been sent yet.
|
|
|
|
*/
|
|
|
|
guac_timestamp last_request;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The last requested screen width, in pixels.
|
|
|
|
*/
|
|
|
|
int requested_width;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The last requested screen height, in pixels.
|
|
|
|
*/
|
|
|
|
int requested_height;
|
|
|
|
|
|
|
|
} guac_rdp_disp;
|
|
|
|
|
2014-11-21 21:30:24 +00:00
|
|
|
/**
|
2014-11-25 10:20:54 +00:00
|
|
|
* Allocates a new display update module, which will ultimately control the
|
|
|
|
* display update channel once conected.
|
2014-11-26 06:53:22 +00:00
|
|
|
*
|
|
|
|
* @return A new display update module.
|
2014-11-25 10:20:54 +00:00
|
|
|
*/
|
|
|
|
guac_rdp_disp* guac_rdp_disp_alloc();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Frees the given display update module.
|
2014-11-26 06:53:22 +00:00
|
|
|
*
|
|
|
|
* @param disp The display update module to free.
|
2014-11-25 10:20:54 +00:00
|
|
|
*/
|
|
|
|
void guac_rdp_disp_free(guac_rdp_disp* disp);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Loads the "disp" plugin for FreeRDP. It is still up to external code to
|
|
|
|
* detect when the "disp" channel is connected, and update the guac_rdp_disp
|
|
|
|
* with a call to guac_rdp_disp_connect().
|
2014-11-26 06:53:22 +00:00
|
|
|
*
|
|
|
|
* @param context The rdpContext associated with the active RDP session.
|
2014-11-21 21:30:24 +00:00
|
|
|
*/
|
|
|
|
void guac_rdp_disp_load_plugin(rdpContext* context);
|
|
|
|
|
|
|
|
/**
|
2014-11-25 10:20:54 +00:00
|
|
|
* Stores the given DispClientContext within the given guac_rdp_disp, such that
|
|
|
|
* display updates can be properly sent. Until this is called, changes to the
|
|
|
|
* display size will be deferred.
|
2014-11-26 06:53:22 +00:00
|
|
|
*
|
|
|
|
* @param guac_disp The display update module to associate with the connected
|
|
|
|
* display update channel.
|
|
|
|
* @param disp The DispClientContext associated by FreeRDP with the connected
|
|
|
|
* display update channel.
|
2014-11-25 10:20:54 +00:00
|
|
|
*/
|
|
|
|
void guac_rdp_disp_connect(guac_rdp_disp* guac_disp, DispClientContext* disp);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Requests a display size update, which may then be sent immediately to the
|
|
|
|
* RDP server. If an update was recently sent, this update may be delayed until
|
2014-11-26 06:53:22 +00:00
|
|
|
* the RDP server has had time to settle. The width/height values provided may
|
|
|
|
* be automatically altered to comply with the restrictions imposed by the
|
|
|
|
* display update channel.
|
|
|
|
*
|
|
|
|
* @param disp The display update module which should maintain the requested
|
|
|
|
* size, sending the corresponding display update request when
|
|
|
|
* appropriate.
|
|
|
|
* @param context The rdpContext associated with the active RDP session.
|
|
|
|
* @param width The desired display width, in pixels. Due to the restrictions
|
|
|
|
* of the RDP display update channel, this will be contrained to
|
|
|
|
* the range of 200 through 8192 inclusive, and rounded down to
|
|
|
|
* the nearest even number.
|
|
|
|
* @param height The desired display height, in pixels. Due to the restrictions
|
|
|
|
* of the RDP display update channel, this will be contrained to
|
|
|
|
* the range of 200 through 8192 inclusive.
|
2014-11-25 10:20:54 +00:00
|
|
|
*/
|
|
|
|
void guac_rdp_disp_set_size(guac_rdp_disp* disp, rdpContext* context,
|
|
|
|
int width, int height);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Sends an actual display update request to the RDP server based on previous
|
|
|
|
* calls to guac_rdp_disp_set_size(). If an update was recently sent, the
|
|
|
|
* update may be delayed until a future call to this function.
|
2014-11-26 06:53:22 +00:00
|
|
|
*
|
|
|
|
* @param disp The display update module which should track the update request.
|
|
|
|
* @param context The rdpContext associated with the active RDP session.
|
2014-11-21 21:30:24 +00:00
|
|
|
*/
|
2014-11-25 10:20:54 +00:00
|
|
|
void guac_rdp_disp_update_size(guac_rdp_disp* disp, rdpContext* context);
|
2014-11-21 21:30:24 +00:00
|
|
|
|
|
|
|
#endif
|
|
|
|
|