2 * QEMU VNC display driver: Zlib Run-length Encoding (ZRLE)
4 * From libvncserver/libvncserver/zrle.c
5 * Copyright (C) 2002 RealVNC Ltd. All Rights Reserved.
6 * Copyright (C) 2003 Sun Microsystems, Inc.
10 * Permission is hereby granted, free of charge, to any person obtaining a copy
11 * of this software and associated documentation files (the "Software"), to deal
12 * in the Software without restriction, including without limitation the rights
13 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
14 * copies of the Software, and to permit persons to whom the Software is
15 * furnished to do so, subject to the following conditions:
17 * The above copyright notice and this permission notice shall be included in
18 * all copies or substantial portions of the Software.
20 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
21 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
23 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
24 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
25 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
29 #include "qemu/osdep.h"
31 #include "vnc-enc-zrle.h"
33 static const int bits_per_packed_pixel[] = {
34 0, 1, 2, 2, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4
38 static void vnc_zrle_start(VncState *vs)
40 buffer_reset(&vs->zrle.zrle);
42 /* make the output buffer be the zlib buffer, so we can compress it later */
43 vs->zrle.tmp = vs->output;
44 vs->output = vs->zrle.zrle;
47 static void vnc_zrle_stop(VncState *vs)
49 /* switch back to normal output/zlib buffers */
50 vs->zrle.zrle = vs->output;
51 vs->output = vs->zrle.tmp;
54 static void *zrle_convert_fb(VncState *vs, int x, int y, int w, int h,
59 buffer_reset(&vs->zrle.fb);
60 buffer_reserve(&vs->zrle.fb, w * h * bpp + bpp);
63 vs->output = vs->zrle.fb;
65 vnc_raw_send_framebuffer_update(vs, x, y, w, h);
67 vs->zrle.fb = vs->output;
69 return vs->zrle.fb.buffer;
72 static int zrle_compress_data(VncState *vs, int level)
74 z_streamp zstream = &vs->zrle.stream;
76 buffer_reset(&vs->zrle.zlib);
78 if (zstream->opaque != vs) {
81 zstream->zalloc = vnc_zlib_zalloc;
82 zstream->zfree = vnc_zlib_zfree;
84 err = deflateInit2(zstream, level, Z_DEFLATED, MAX_WBITS,
85 MAX_MEM_LEVEL, Z_DEFAULT_STRATEGY);
88 fprintf(stderr, "VNC: error initializing zlib\n");
95 /* reserve memory in output buffer */
96 buffer_reserve(&vs->zrle.zlib, vs->zrle.zrle.offset + 64);
99 zstream->next_in = vs->zrle.zrle.buffer;
100 zstream->avail_in = vs->zrle.zrle.offset;
101 zstream->next_out = vs->zrle.zlib.buffer + vs->zrle.zlib.offset;
102 zstream->avail_out = vs->zrle.zlib.capacity - vs->zrle.zlib.offset;
103 zstream->data_type = Z_BINARY;
106 if (deflate(zstream, Z_SYNC_FLUSH) != Z_OK) {
107 fprintf(stderr, "VNC: error during zrle compression\n");
111 vs->zrle.zlib.offset = vs->zrle.zlib.capacity - zstream->avail_out;
112 return vs->zrle.zlib.offset;
115 /* Try to work out whether to use RLE and/or a palette. We do this by
116 * estimating the number of bytes which will be generated and picking the
117 * method which results in the fewest bytes. Of course this may not result
118 * in the fewest bytes after compression... */
119 static void zrle_choose_palette_rle(VncState *vs, int w, int h,
120 VncPalette *palette, int bpp_out,
121 int runs, int single_pixels,
123 bool *use_rle, bool *use_palette)
125 size_t estimated_bytes;
126 size_t plain_rle_bytes;
128 *use_palette = *use_rle = false;
130 estimated_bytes = w * h * (bpp_out / 8); /* start assuming raw */
133 if (zywrle_level > 0 && !(zywrle_level & 0x80))
134 estimated_bytes >>= zywrle_level;
137 plain_rle_bytes = ((bpp_out / 8) + 1) * (runs + single_pixels);
139 if (plain_rle_bytes < estimated_bytes) {
141 estimated_bytes = plain_rle_bytes;
144 if (palette_size(palette) < 128) {
145 int palette_rle_bytes;
147 palette_rle_bytes = (bpp_out / 8) * palette_size(palette);
148 palette_rle_bytes += 2 * runs + single_pixels;
150 if (palette_rle_bytes < estimated_bytes) {
153 estimated_bytes = palette_rle_bytes;
156 if (palette_size(palette) < 17) {
159 packed_bytes = (bpp_out / 8) * palette_size(palette);
160 packed_bytes += w * h *
161 bits_per_packed_pixel[palette_size(palette)-1] / 8;
163 if (packed_bytes < estimated_bytes) {
166 estimated_bytes = packed_bytes;
172 static void zrle_write_u32(VncState *vs, uint32_t value)
174 vnc_write(vs, (uint8_t *)&value, 4);
177 static void zrle_write_u24a(VncState *vs, uint32_t value)
179 vnc_write(vs, (uint8_t *)&value, 3);
182 static void zrle_write_u24b(VncState *vs, uint32_t value)
184 vnc_write(vs, ((uint8_t *)&value) + 1, 3);
187 static void zrle_write_u16(VncState *vs, uint16_t value)
189 vnc_write(vs, (uint8_t *)&value, 2);
192 static void zrle_write_u8(VncState *vs, uint8_t value)
194 vnc_write_u8(vs, value);
197 #define ENDIAN_LITTLE 0
202 #define ZYWRLE_ENDIAN ENDIAN_NO
203 #include "vnc-enc-zrle-template.c"
208 #define ZYWRLE_ENDIAN ENDIAN_LITTLE
209 #include "vnc-enc-zrle-template.c"
212 #define ZYWRLE_ENDIAN ENDIAN_BIG
213 #include "vnc-enc-zrle-template.c"
218 #define ZYWRLE_ENDIAN ENDIAN_LITTLE
219 #include "vnc-enc-zrle-template.c"
222 #define ZYWRLE_ENDIAN ENDIAN_BIG
223 #include "vnc-enc-zrle-template.c"
228 #define ZYWRLE_ENDIAN ENDIAN_LITTLE
229 #include "vnc-enc-zrle-template.c"
232 #define ZYWRLE_ENDIAN ENDIAN_BIG
233 #include "vnc-enc-zrle-template.c"
235 #define ZRLE_COMPACT_PIXEL 24a
237 #define ZYWRLE_ENDIAN ENDIAN_LITTLE
238 #include "vnc-enc-zrle-template.c"
241 #define ZYWRLE_ENDIAN ENDIAN_BIG
242 #include "vnc-enc-zrle-template.c"
244 #undef ZRLE_COMPACT_PIXEL
245 #define ZRLE_COMPACT_PIXEL 24b
247 #define ZYWRLE_ENDIAN ENDIAN_LITTLE
248 #include "vnc-enc-zrle-template.c"
251 #define ZYWRLE_ENDIAN ENDIAN_BIG
252 #include "vnc-enc-zrle-template.c"
253 #undef ZRLE_COMPACT_PIXEL
256 static int zrle_send_framebuffer_update(VncState *vs, int x, int y,
259 bool be = vs->client_be;
263 if (vs->zrle.type == VNC_ENCODING_ZYWRLE) {
264 if (!vs->vd->lossy || vs->tight.quality == (uint8_t)-1
265 || vs->tight.quality == 9) {
267 vs->zrle.type = VNC_ENCODING_ZRLE;
268 } else if (vs->tight.quality < 3) {
270 } else if (vs->tight.quality < 6) {
281 switch (vs->client_pf.bytes_per_pixel) {
283 zrle_encode_8ne(vs, x, y, w, h, zywrle_level);
287 if (vs->client_pf.gmax > 0x1F) {
289 zrle_encode_16be(vs, x, y, w, h, zywrle_level);
291 zrle_encode_16le(vs, x, y, w, h, zywrle_level);
295 zrle_encode_15be(vs, x, y, w, h, zywrle_level);
297 zrle_encode_15le(vs, x, y, w, h, zywrle_level);
304 bool fits_in_ls3bytes;
305 bool fits_in_ms3bytes;
308 ((vs->client_pf.rmax << vs->client_pf.rshift) < (1 << 24) &&
309 (vs->client_pf.gmax << vs->client_pf.gshift) < (1 << 24) &&
310 (vs->client_pf.bmax << vs->client_pf.bshift) < (1 << 24));
312 fits_in_ms3bytes = (vs->client_pf.rshift > 7 &&
313 vs->client_pf.gshift > 7 &&
314 vs->client_pf.bshift > 7);
316 if ((fits_in_ls3bytes && !be) || (fits_in_ms3bytes && be)) {
318 zrle_encode_24abe(vs, x, y, w, h, zywrle_level);
320 zrle_encode_24ale(vs, x, y, w, h, zywrle_level);
322 } else if ((fits_in_ls3bytes && be) || (fits_in_ms3bytes && !be)) {
324 zrle_encode_24bbe(vs, x, y, w, h, zywrle_level);
326 zrle_encode_24ble(vs, x, y, w, h, zywrle_level);
330 zrle_encode_32be(vs, x, y, w, h, zywrle_level);
332 zrle_encode_32le(vs, x, y, w, h, zywrle_level);
340 bytes = zrle_compress_data(vs, Z_DEFAULT_COMPRESSION);
341 vnc_framebuffer_update(vs, x, y, w, h, vs->zrle.type);
342 vnc_write_u32(vs, bytes);
343 vnc_write(vs, vs->zrle.zlib.buffer, vs->zrle.zlib.offset);
347 int vnc_zrle_send_framebuffer_update(VncState *vs, int x, int y, int w, int h)
349 vs->zrle.type = VNC_ENCODING_ZRLE;
350 return zrle_send_framebuffer_update(vs, x, y, w, h);
353 int vnc_zywrle_send_framebuffer_update(VncState *vs, int x, int y, int w, int h)
355 vs->zrle.type = VNC_ENCODING_ZYWRLE;
356 return zrle_send_framebuffer_update(vs, x, y, w, h);
359 void vnc_zrle_clear(VncState *vs)
361 if (vs->zrle.stream.opaque) {
362 deflateEnd(&vs->zrle.stream);
364 buffer_free(&vs->zrle.zrle);
365 buffer_free(&vs->zrle.fb);
366 buffer_free(&vs->zrle.zlib);