191 lines
9.3 KiB
C
191 lines
9.3 KiB
C
/**
|
|
* FreeRDP: A Remote Desktop Protocol Implementation
|
|
* Graphics Pipeline Extension
|
|
*
|
|
* Copyright 2013 Marc-Andre Moreau <marcandre.moreau@gmail.com>
|
|
* Copyright 2015 Thincast Technologies GmbH
|
|
* Copyright 2015 DI (FH) Martin Haimberger <martin.haimberger@thincast.com>
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
#ifndef FREERDP_CHANNEL_RDPGFX_CLIENT_RDPGFX_H
|
|
#define FREERDP_CHANNEL_RDPGFX_CLIENT_RDPGFX_H
|
|
|
|
#include <freerdp/api.h>
|
|
#include <freerdp/types.h>
|
|
|
|
#include <freerdp/codecs.h>
|
|
|
|
#include <freerdp/channels/rdpgfx.h>
|
|
#include <freerdp/utils/profiler.h>
|
|
|
|
#include <freerdp/cache/persistent.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C"
|
|
{
|
|
#endif
|
|
|
|
/**
|
|
* Client Interface
|
|
*/
|
|
typedef struct gdi_gfx_surface gdiGfxSurface;
|
|
typedef struct s_rdpgfx_client_context RdpgfxClientContext;
|
|
|
|
typedef UINT (*pcRdpgfxResetGraphics)(RdpgfxClientContext* context,
|
|
const RDPGFX_RESET_GRAPHICS_PDU* resetGraphics);
|
|
typedef UINT (*pcRdpgfxStartFrame)(RdpgfxClientContext* context,
|
|
const RDPGFX_START_FRAME_PDU* startFrame);
|
|
typedef UINT (*pcRdpgfxEndFrame)(RdpgfxClientContext* context,
|
|
const RDPGFX_END_FRAME_PDU* endFrame);
|
|
typedef UINT (*pcRdpgfxSurfaceCommand)(RdpgfxClientContext* context,
|
|
const RDPGFX_SURFACE_COMMAND* cmd);
|
|
typedef UINT (*pcRdpgfxDeleteEncodingContext)(
|
|
RdpgfxClientContext* context,
|
|
const RDPGFX_DELETE_ENCODING_CONTEXT_PDU* deleteEncodingContext);
|
|
typedef UINT (*pcRdpgfxCreateSurface)(RdpgfxClientContext* context,
|
|
const RDPGFX_CREATE_SURFACE_PDU* createSurface);
|
|
typedef UINT (*pcRdpgfxDeleteSurface)(RdpgfxClientContext* context,
|
|
const RDPGFX_DELETE_SURFACE_PDU* deleteSurface);
|
|
typedef UINT (*pcRdpgfxSolidFill)(RdpgfxClientContext* context,
|
|
const RDPGFX_SOLID_FILL_PDU* solidFill);
|
|
typedef UINT (*pcRdpgfxSurfaceToSurface)(RdpgfxClientContext* context,
|
|
const RDPGFX_SURFACE_TO_SURFACE_PDU* surfaceToSurface);
|
|
typedef UINT (*pcRdpgfxSurfaceToCache)(RdpgfxClientContext* context,
|
|
const RDPGFX_SURFACE_TO_CACHE_PDU* surfaceToCache);
|
|
typedef UINT (*pcRdpgfxCacheToSurface)(RdpgfxClientContext* context,
|
|
const RDPGFX_CACHE_TO_SURFACE_PDU* cacheToSurface);
|
|
typedef UINT (*pcRdpgfxCacheImportOffer)(RdpgfxClientContext* context,
|
|
const RDPGFX_CACHE_IMPORT_OFFER_PDU* cacheImportOffer);
|
|
typedef UINT (*pcRdpgfxCacheImportReply)(RdpgfxClientContext* context,
|
|
const RDPGFX_CACHE_IMPORT_REPLY_PDU* cacheImportReply);
|
|
typedef UINT (*pcRdpgfxEvictCacheEntry)(RdpgfxClientContext* context,
|
|
const RDPGFX_EVICT_CACHE_ENTRY_PDU* evictCacheEntry);
|
|
typedef UINT (*pcRdpgfxImportCacheEntry)(RdpgfxClientContext* context, UINT16 cacheSlot,
|
|
const PERSISTENT_CACHE_ENTRY* importCacheEntry);
|
|
typedef UINT (*pcRdpgfxExportCacheEntry)(RdpgfxClientContext* context, UINT16 cacheSlot,
|
|
PERSISTENT_CACHE_ENTRY* importCacheEntry);
|
|
typedef UINT (*pcRdpgfxMapSurfaceToOutput)(
|
|
RdpgfxClientContext* context, const RDPGFX_MAP_SURFACE_TO_OUTPUT_PDU* surfaceToOutput);
|
|
typedef UINT (*pcRdpgfxMapSurfaceToScaledOutput)(
|
|
RdpgfxClientContext* context,
|
|
const RDPGFX_MAP_SURFACE_TO_SCALED_OUTPUT_PDU* surfaceToOutput);
|
|
typedef UINT (*pcRdpgfxMapSurfaceToWindow)(
|
|
RdpgfxClientContext* context, const RDPGFX_MAP_SURFACE_TO_WINDOW_PDU* surfaceToWindow);
|
|
typedef UINT (*pcRdpgfxMapSurfaceToScaledWindow)(
|
|
RdpgfxClientContext* context,
|
|
const RDPGFX_MAP_SURFACE_TO_SCALED_WINDOW_PDU* surfaceToWindow);
|
|
typedef UINT (*pcRdpgfxSetSurfaceData)(RdpgfxClientContext* context, UINT16 surfaceId,
|
|
void* pData);
|
|
typedef void* (*pcRdpgfxGetSurfaceData)(RdpgfxClientContext* context, UINT16 surfaceId);
|
|
typedef UINT (*pcRdpgfxGetSurfaceIds)(RdpgfxClientContext* context, UINT16** ppSurfaceIds,
|
|
UINT16* count);
|
|
typedef UINT (*pcRdpgfxSetCacheSlotData)(RdpgfxClientContext* context, UINT16 cacheSlot,
|
|
void* pData);
|
|
typedef void* (*pcRdpgfxGetCacheSlotData)(RdpgfxClientContext* context, UINT16 cacheSlot);
|
|
|
|
typedef UINT (*pcRdpgfxUpdateSurfaces)(RdpgfxClientContext* context);
|
|
|
|
typedef UINT (*pcRdpgfxUpdateWindowFromSurface)(RdpgfxClientContext* context,
|
|
gdiGfxSurface* surface);
|
|
|
|
typedef UINT (*pcRdpgfxUpdateSurfaceArea)(RdpgfxClientContext* context, UINT16 surfaceId,
|
|
UINT32 nrRects, const RECTANGLE_16* rects);
|
|
|
|
typedef UINT (*pcRdpgfxOnOpen)(RdpgfxClientContext* context, BOOL* do_caps_advertise,
|
|
BOOL* do_frame_acks);
|
|
typedef UINT (*pcRdpgfxOnClose)(RdpgfxClientContext* context);
|
|
typedef UINT (*pcRdpgfxCapsAdvertise)(RdpgfxClientContext* context,
|
|
const RDPGFX_CAPS_ADVERTISE_PDU* capsAdvertise);
|
|
typedef UINT (*pcRdpgfxCapsConfirm)(RdpgfxClientContext* context,
|
|
const RDPGFX_CAPS_CONFIRM_PDU* capsConfirm);
|
|
typedef UINT (*pcRdpgfxFrameAcknowledge)(RdpgfxClientContext* context,
|
|
const RDPGFX_FRAME_ACKNOWLEDGE_PDU* frameAcknowledge);
|
|
typedef UINT (*pcRdpgfxQoeFrameAcknowledge)(
|
|
RdpgfxClientContext* context, const RDPGFX_QOE_FRAME_ACKNOWLEDGE_PDU* qoeFrameAcknowledge);
|
|
|
|
typedef UINT (*pcRdpgfxMapWindowForSurface)(RdpgfxClientContext* context, UINT16 surfaceID,
|
|
UINT64 windowID);
|
|
typedef UINT (*pcRdpgfxUnmapWindowForSurface)(RdpgfxClientContext* context, UINT64 windowID);
|
|
|
|
struct s_rdpgfx_client_context
|
|
{
|
|
void* handle;
|
|
void* custom;
|
|
|
|
/* Implementations require locking */
|
|
WINPR_ATTR_NODISCARD pcRdpgfxResetGraphics ResetGraphics;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxStartFrame StartFrame;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxEndFrame EndFrame;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxSurfaceCommand SurfaceCommand;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxDeleteEncodingContext DeleteEncodingContext;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxCreateSurface CreateSurface;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxDeleteSurface DeleteSurface;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxSolidFill SolidFill;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxSurfaceToSurface SurfaceToSurface;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxSurfaceToCache SurfaceToCache;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxCacheToSurface CacheToSurface;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxCacheImportOffer CacheImportOffer;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxCacheImportReply CacheImportReply;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxImportCacheEntry ImportCacheEntry;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxExportCacheEntry ExportCacheEntry;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxEvictCacheEntry EvictCacheEntry;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxMapSurfaceToOutput MapSurfaceToOutput;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxMapSurfaceToScaledOutput MapSurfaceToScaledOutput;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxMapSurfaceToWindow MapSurfaceToWindow;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxMapSurfaceToScaledWindow MapSurfaceToScaledWindow;
|
|
|
|
WINPR_ATTR_NODISCARD pcRdpgfxGetSurfaceIds GetSurfaceIds;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxSetSurfaceData SetSurfaceData;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxGetSurfaceData GetSurfaceData;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxSetCacheSlotData SetCacheSlotData;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxGetCacheSlotData GetCacheSlotData;
|
|
|
|
/* Proxy callbacks */
|
|
WINPR_ATTR_NODISCARD pcRdpgfxOnOpen OnOpen;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxOnClose OnClose;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxCapsAdvertise CapsAdvertise;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxCapsConfirm CapsConfirm;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxFrameAcknowledge FrameAcknowledge;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxQoeFrameAcknowledge QoeFrameAcknowledge;
|
|
|
|
/* No locking required */
|
|
WINPR_ATTR_NODISCARD pcRdpgfxUpdateSurfaces UpdateSurfaces;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxUpdateSurfaceArea UpdateSurfaceArea;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxUpdateWindowFromSurface UpdateWindowFromSurface;
|
|
|
|
/* These callbacks allow creating/destroying a window directly
|
|
* mapped to a surface.
|
|
* NOTE: The surface is already locked.
|
|
*/
|
|
WINPR_ATTR_NODISCARD pcRdpgfxMapWindowForSurface MapWindowForSurface;
|
|
WINPR_ATTR_NODISCARD pcRdpgfxUnmapWindowForSurface UnmapWindowForSurface;
|
|
|
|
CRITICAL_SECTION mux;
|
|
rdpCodecs* codecs;
|
|
PROFILER_DEFINE(SurfaceProfiler)
|
|
};
|
|
|
|
FREERDP_API void rdpgfx_client_context_free(RdpgfxClientContext* context);
|
|
|
|
WINPR_ATTR_MALLOC(rdpgfx_client_context_free, 1)
|
|
WINPR_ATTR_NODISCARD
|
|
FREERDP_API RdpgfxClientContext* rdpgfx_client_context_new(rdpContext* context);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* FREERDP_CHANNEL_RDPGFX_CLIENT_RDPGFX_H */
|