1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
|
/* $Id: clipboard-helper.h $ */
/** @file
* Shared Clipboard - Some helper function for converting between the various EOLs.
*/
/*
* Copyright (C) 2006-2020 Oracle Corporation
*
* This file is part of VirtualBox Open Source Edition (OSE), as
* available from http://www.virtualbox.org. This file is free software;
* you can redistribute it and/or modify it under the terms of the GNU
* General Public License (GPL) as published by the Free Software
* Foundation, in version 2 as it comes in the "COPYING" file of the
* VirtualBox OSE distribution. VirtualBox OSE is distributed in the
* hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
*
* The contents of this file may alternatively be used under the terms
* of the Common Development and Distribution License Version 1.0
* (CDDL) only, as it comes in the "COPYING.CDDL" file of the
* VirtualBox OSE distribution, in which case the provisions of the
* CDDL are applicable instead of those of the GPL.
*
* You may elect to license modified versions of this file under the
* terms and conditions of either the GPL or the CDDL or both.
*/
#ifndef VBOX_INCLUDED_GuestHost_clipboard_helper_h
#define VBOX_INCLUDED_GuestHost_clipboard_helper_h
#ifndef RT_WITHOUT_PRAGMA_ONCE
# pragma once
#endif
#include <iprt/string.h>
#include <VBox/GuestHost/SharedClipboard.h>
/** Constants needed for string conversions done by the Linux/Mac clipboard code. */
enum
{
/** In Linux, lines end with a linefeed character. */
VBOX_SHCL_LINEFEED = 0xa,
/** In Windows, lines end with a carriage return and a linefeed character. */
VBOX_SHCL_CARRIAGERETURN = 0xd,
/** Little endian "real" UTF-16 strings start with this marker. */
VBOX_SHCL_UTF16LEMARKER = 0xfeff,
/** Big endian "real" UTF-16 strings start with this marker. */
VBOX_SHCL_UTF16BEMARKER = 0xfffe
};
/**
* Returns the length (in UTF-8 characters) of an UTF-16 string with LF EOL.
*
* @returns VBox status code.
* @param pcwszSrc UTF-16 string to return size for.
* @param cwcSrc Length of the string in RTUTF16 units.
* @param pchLen Where to return the length (in UTF-8 characters).
* Does not include terminator.
*/
int ShClUtf16LFLenUtf8(PCRTUTF16 pcwszSrc, size_t cwcSrc, size_t *pchLen);
/**
* Returns the length (in UTF-8 characters) of an UTF-16 string with CRLF EOL.
*
* @returns VBox status code.
* @param pcwszSrc UTF-16 string to return size for.
* @param cwcSrc Length of the source string in RTUTF16 units.
* @param pchLen Where to return the length (in UTF-8 characters).
* Does not include terminator.
*/
int ShClUtf16CRLFLenUtf8(PCRTUTF16 pcwszSrc, size_t cwcSrc, size_t *pchLen);
/**
* Returns the length (in characters) of an UTF-16 string, including terminator.
*
* @returns VBox status code.
* @param pcwszSrc UTF-16 string to return size for.
* @param cwcSrc Length of the source string in RTUTF16 units.
* @param pchLen Where to return the length (in UTF-8 characters).
* Does not include terminator.
*/
int ShClUtf16LenUtf8(PCRTUTF16 pcwszSrc, size_t cwcSrc, size_t *pchLen);
/**
* Converts an UTF-16 string with LF EOL to an UTF-16 string with CRLF EOL.
*
* @returns VBox status code.
* @param pcwszSrc UTF-16 string to convert.
* @param cwcSrc Size of the string int RTUTF16 units.
* @param pwszDst Buffer to store the converted string to.
* @param cwcDst The size of \a pwszDst in RTUTF16 units.
*/
int ShClConvUtf16LFToCRLF(PCRTUTF16 pcwszSrc, size_t cwcSrc, PRTUTF16 pwszDst, size_t cwcDst);
/**
* Converts an UTF-16 string with LF EOL to an UTF-16 string with CRLF EOL.
*
* Convenience function which returns the allocated + converted string on success.
*
* @returns VBox status code.
* @param pcwszSrc UTF-16 string to convert.
* @param cwcSrc Size of the string int RTUTF16 units.
* @param ppwszDst Where to return the allocated converted string. Must be free'd by the caller.
* @param pcwDst Where to return the size of the converted string in RTUTF16 units.
* Does not include the terminator.
*/
int ShClConvUtf16LFToCRLFA(PCRTUTF16 pcwszSrc, size_t cwcSrc, PRTUTF16 *ppwszDst, size_t *pcwDst);
/**
* Converts an UTF-16 string with CRLF EOL to an UTF-16 string with LF EOL.
*
* @returns VBox status code.
* @param pcwszSrc UTF-16 string to convert.
* @param cwcSrc Size of the string in RTUTF16 units.
* @param pwszDst Where to store the converted string to.
* @param cwcDst The size of \a pwszDst in RTUTF16 units.
*/
int ShClConvUtf16CRLFToLF(PCRTUTF16 pcwszSrc, size_t cwcSrc, PRTUTF16 pwszDst, size_t cwcDst);
/**
* Converts an UTF-16 string with CRLF EOL to UTF-8 LF.
*
* @returns VBox status code. Will return VERR_NO_DATA if no data was converted.
* @param pcwszSrc UTF-16 string to convert.
* @param cbSrc Length of @a pwszSrc (in bytes).
* @param pszBuf Where to write the converted string.
* @param cbBuf The size of the buffer pointed to by @a pszBuf.
* @param pcbLen Where to store the size (in bytes) of the converted string.
* Does not include terminator.
*/
int ShClConvUtf16CRLFToUtf8LF(PCRTUTF16 pcwszSrc, size_t cbSrc, char *pszBuf, size_t cbBuf, size_t *pcbLen);
/**
* Converts an HTML string from UTF-16 into UTF-8.
*
* @returns VBox status code.
* @param pcwszSrc UTF-16 string to convert.
* @param cwcSrc Length (in RTUTF16 units) of the source text.
* @param ppszDst Where to store the converted result on success.
* @param pcbDst Where to store the number of bytes written.
*/
int ShClConvUtf16ToUtf8HTML(PCRTUTF16 pcwszSrc, size_t cwcSrc, char **ppszDst, size_t *pcbDst);
/**
* Converts an UTF-8 string with LF EOL into UTF-16 CRLF.
*
* @returns VBox status code.
* @param pcszSrc UTF-8 string to convert.
* @param cbSrc Size of UTF-8 string to convert (in bytes), not counting the terminating zero.
* @param ppwszDst Where to return the allocated buffer on success.
* @param pcwDst Where to return the size (in RTUTF16 units) of the allocated buffer on success.
* Does not include terminator.
*/
int ShClConvUtf8LFToUtf16CRLF(const char *pcszSrc, size_t cbSrc, PRTUTF16 *ppwszDst, size_t *pcwDst);
/**
* Converts a Latin-1 string with LF EOL into UTF-16 CRLF.
*
* @returns VBox status code.
* @param pcszSrc UTF-8 string to convert.
* @param cbSrc Size of string (in bytes), not counting the terminating zero.
* @param ppwszDst Where to return the allocated buffer on success.
* @param pcwDst Where to return the size (in RTUTF16 units) of the allocated buffer on success.
* Does not include terminator.
*/
int ShClConvLatin1LFToUtf16CRLF(const char *pcszSrc, size_t cbSrc, PRTUTF16 *ppwszDst, size_t *pcwDst);
#pragma pack(1)
/** @todo r=bird: Why duplicate these structures here, we've got them in
* DevVGA.cpp already! */
/**
* Bitmap File Header. Official win32 name is BITMAPFILEHEADER
* Always Little Endian.
*/
typedef struct BMFILEHEADER
{
uint16_t uType;
uint32_t uSize;
uint16_t uReserved1;
uint16_t uReserved2;
uint32_t uOffBits;
} BMFILEHEADER;
#pragma pack()
/** Pointer to a BMFILEHEADER structure. */
typedef BMFILEHEADER *PBMFILEHEADER;
/** BMP file magic number */
#define BITMAPHEADERMAGIC (RT_H2LE_U16_C(0x4d42))
/**
* Bitmap Info Header. Official win32 name is BITMAPINFOHEADER
* Always Little Endian.
*/
typedef struct BMINFOHEADER
{
uint32_t uSize;
uint32_t uWidth;
uint32_t uHeight;
uint16_t uPlanes;
uint16_t uBitCount;
uint32_t uCompression;
uint32_t uSizeImage;
uint32_t uXBitsPerMeter;
uint32_t uYBitsPerMeter;
uint32_t uClrUsed;
uint32_t uClrImportant;
} BMINFOHEADER;
/** Pointer to a BMINFOHEADER structure. */
typedef BMINFOHEADER *PBMINFOHEADER;
/**
* Convert CF_DIB data to full BMP data by prepending the BM header.
* Allocates with RTMemAlloc.
*
* @returns VBox status code.
* @param pvSrc DIB data to convert
* @param cbSrc Size of the DIB data to convert in bytes
* @param ppvDst Where to store the pointer to the buffer for the
* destination data
* @param pcbDst Pointer to the size of the buffer for the destination
* data in bytes.
*/
int ShClDibToBmp(const void *pvSrc, size_t cbSrc, void **ppvDst, size_t *pcbDst);
/**
* Get the address and size of CF_DIB data in a full BMP data in the input buffer.
* Does not do any allocation.
*
* @returns VBox status code.
* @param pvSrc BMP data to convert
* @param cbSrc Size of the BMP data to convert in bytes
* @param ppvDst Where to store the pointer to the destination data
* @param pcbDst Pointer to the size of the destination data in bytes
*/
int ShClBmpGetDib(const void *pvSrc, size_t cbSrc, const void **ppvDst, size_t *pcbDst);
#ifdef LOG_ENABLED
/**
* Dumps HTML data to the debug log.
*
* @returns VBox status code.
* @param pszSrc HTML data to dump.
* @param cbSrc Size (in bytes) of HTML data to dump.
*/
int ShClDbgDumpHtml(const char *pszSrc, size_t cbSrc);
/**
* Dumps data using a specified clipboard format.
*
* @param pv Pointer to data to dump.
* @param cb Size (in bytes) of data to dump.
* @param u32Format Clipboard format to use for dumping.
*/
void ShClDbgDumpData(const void *pv, size_t cb, SHCLFORMAT u32Format);
#endif /* LOG_ENABLED */
/**
* Translates a Shared Clipboard host function number to a string.
*
* @returns Function ID string name.
* @param uFn The function to translate.
*/
const char *ShClHostFunctionToStr(uint32_t uFn);
/**
* Translates a Shared Clipboard host message enum to a string.
*
* @returns Message ID string name.
* @param uMsg The message to translate.
*/
const char *ShClHostMsgToStr(uint32_t uMsg);
/**
* Translates a Shared Clipboard guest message enum to a string.
*
* @returns Message ID string name.
* @param uMsg The message to translate.
*/
const char *ShClGuestMsgToStr(uint32_t uMsg);
#endif /* !VBOX_INCLUDED_GuestHost_clipboard_helper_h */
|
