source: mainline/uspace/lib/ui/test/paint.c@ 95658c9

ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since 95658c9 was 06176e1, checked in by Jiri Svoboda <jiri@…>, 3 years ago

Minimizing windows
  • Property mode set to 100644
File size: 14.4 KB
Line 
1/*
2 * Copyright (c) 2022 Jiri Svoboda
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 *
9 * - Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * - Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
14 * - The name of the author may not be used to endorse or promote products
15 * derived from this software without specific prior written permission.
16 *
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 */
28
29#include <gfx/context.h>
30#include <gfx/coord.h>
31#include <mem.h>
32#include <pcut/pcut.h>
33#include <stdbool.h>
34#include <ui/paint.h>
35#include <ui/resource.h>
36
37PCUT_INIT;
38
39PCUT_TEST_SUITE(paint);
40
41static errno_t testgc_set_clip_rect(void *, gfx_rect_t *);
42static errno_t testgc_set_color(void *, gfx_color_t *);
43static errno_t testgc_fill_rect(void *, gfx_rect_t *);
44static errno_t testgc_bitmap_create(void *, gfx_bitmap_params_t *,
45 gfx_bitmap_alloc_t *, void **);
46static errno_t testgc_bitmap_destroy(void *);
47static errno_t testgc_bitmap_render(void *, gfx_rect_t *, gfx_coord2_t *);
48static errno_t testgc_bitmap_get_alloc(void *, gfx_bitmap_alloc_t *);
49
50static gfx_context_ops_t ops = {
51 .set_clip_rect = testgc_set_clip_rect,
52 .set_color = testgc_set_color,
53 .fill_rect = testgc_fill_rect,
54 .bitmap_create = testgc_bitmap_create,
55 .bitmap_destroy = testgc_bitmap_destroy,
56 .bitmap_render = testgc_bitmap_render,
57 .bitmap_get_alloc = testgc_bitmap_get_alloc
58};
59
60typedef struct {
61 bool bm_created;
62 bool bm_destroyed;
63 gfx_bitmap_params_t bm_params;
64 void *bm_pixels;
65 gfx_rect_t bm_srect;
66 gfx_coord2_t bm_offs;
67 bool bm_rendered;
68 bool bm_got_alloc;
69} test_gc_t;
70
71typedef struct {
72 test_gc_t *tgc;
73 gfx_bitmap_alloc_t alloc;
74 bool myalloc;
75} testgc_bitmap_t;
76
77/** Paint bevel */
78PCUT_TEST(bevel)
79{
80 errno_t rc;
81 gfx_context_t *gc = NULL;
82 test_gc_t tgc;
83 gfx_rect_t rect;
84 gfx_color_t *color1;
85 gfx_color_t *color2;
86 gfx_rect_t inside;
87
88 memset(&tgc, 0, sizeof(tgc));
89 rc = gfx_context_new(&ops, &tgc, &gc);
90 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
91
92 rc = gfx_color_new_rgb_i16(1, 2, 3, &color1);
93 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
94
95 rc = gfx_color_new_rgb_i16(4, 5, 6, &color2);
96 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
97
98 rect.p0.x = 10;
99 rect.p0.y = 20;
100 rect.p1.x = 30;
101 rect.p1.y = 40;
102
103 /* Paint bevel with NULL 'inside' output parameter */
104 rc = ui_paint_bevel(gc, &rect, color1, color2, 2, NULL);
105 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
106
107 /* Paint bevel with valid 'inside' output parameter */
108 rc = ui_paint_bevel(gc, &rect, color1, color2, 2, &inside);
109 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
110
111 gfx_color_delete(color2);
112 gfx_color_delete(color1);
113 rc = gfx_context_delete(gc);
114 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
115}
116
117/** Get bevel inside */
118PCUT_TEST(get_bevel_inside)
119{
120 errno_t rc;
121 gfx_context_t *gc = NULL;
122 test_gc_t tgc;
123 gfx_rect_t rect;
124 gfx_rect_t inside;
125
126 memset(&tgc, 0, sizeof(tgc));
127 rc = gfx_context_new(&ops, &tgc, &gc);
128 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
129
130 rect.p0.x = 10;
131 rect.p0.y = 20;
132 rect.p1.x = 30;
133 rect.p1.y = 40;
134
135 ui_paint_get_bevel_inside(gc, &rect, 2, &inside);
136 PCUT_ASSERT_INT_EQUALS(12, inside.p0.x);
137 PCUT_ASSERT_INT_EQUALS(22, inside.p0.y);
138 PCUT_ASSERT_INT_EQUALS(28, inside.p1.x);
139 PCUT_ASSERT_INT_EQUALS(38, inside.p1.y);
140
141 rc = gfx_context_delete(gc);
142 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
143}
144
145/** Paint inset frame */
146PCUT_TEST(inset_frame)
147{
148 errno_t rc;
149 gfx_context_t *gc = NULL;
150 ui_resource_t *resource = NULL;
151 test_gc_t tgc;
152 gfx_rect_t rect;
153 gfx_rect_t inside;
154
155 memset(&tgc, 0, sizeof(tgc));
156 rc = gfx_context_new(&ops, &tgc, &gc);
157 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
158
159 rc = ui_resource_create(gc, false, &resource);
160 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
161 PCUT_ASSERT_NOT_NULL(resource);
162
163 rect.p0.x = 10;
164 rect.p0.y = 20;
165 rect.p1.x = 30;
166 rect.p1.y = 40;
167
168 /* Paint inset frame with NULL 'inside' output parameter */
169 rc = ui_paint_inset_frame(resource, &rect, NULL);
170 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
171
172 /* Paint inset frame with valid 'inside' output parameter */
173 rc = ui_paint_inset_frame(resource, &rect, &inside);
174 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
175
176 ui_resource_destroy(resource);
177 rc = gfx_context_delete(gc);
178 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
179}
180
181/** Get inset frame inside */
182PCUT_TEST(get_inset_frame_inside)
183{
184 errno_t rc;
185 gfx_context_t *gc = NULL;
186 ui_resource_t *resource = NULL;
187 test_gc_t tgc;
188 gfx_rect_t rect;
189 gfx_rect_t inside;
190
191 memset(&tgc, 0, sizeof(tgc));
192 rc = gfx_context_new(&ops, &tgc, &gc);
193 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
194
195 rc = ui_resource_create(gc, false, &resource);
196 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
197 PCUT_ASSERT_NOT_NULL(resource);
198
199 rect.p0.x = 10;
200 rect.p0.y = 20;
201 rect.p1.x = 30;
202 rect.p1.y = 40;
203
204 ui_paint_get_inset_frame_inside(resource, &rect, &inside);
205 PCUT_ASSERT_INT_EQUALS(12, inside.p0.x);
206 PCUT_ASSERT_INT_EQUALS(22, inside.p0.y);
207 PCUT_ASSERT_INT_EQUALS(28, inside.p1.x);
208 PCUT_ASSERT_INT_EQUALS(38, inside.p1.y);
209
210 ui_resource_destroy(resource);
211 rc = gfx_context_delete(gc);
212 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
213}
214
215/** Paint filled circle */
216PCUT_TEST(filled_circle)
217{
218 errno_t rc;
219 gfx_context_t *gc = NULL;
220 test_gc_t tgc;
221 gfx_coord2_t center;
222
223 memset(&tgc, 0, sizeof(tgc));
224 rc = gfx_context_new(&ops, &tgc, &gc);
225 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
226
227 center.x = 0;
228 center.y = 0;
229
230 /* Paint filled circle / upper-left half */
231 rc = ui_paint_filled_circle(gc, &center, 10, ui_fcircle_upleft);
232 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
233
234 /* Paint filled circle / lower-right half */
235 rc = ui_paint_filled_circle(gc, &center, 10, ui_fcircle_lowright);
236 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
237
238 /* Paint entire filled circle */
239 rc = ui_paint_filled_circle(gc, &center, 10, ui_fcircle_entire);
240 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
241
242 rc = gfx_context_delete(gc);
243 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
244}
245
246/** Paint up pointing triangle */
247PCUT_TEST(up_triangle)
248{
249 errno_t rc;
250 gfx_context_t *gc = NULL;
251 test_gc_t tgc;
252 gfx_coord2_t center;
253
254 memset(&tgc, 0, sizeof(tgc));
255 rc = gfx_context_new(&ops, &tgc, &gc);
256 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
257
258 center.x = 0;
259 center.y = 0;
260
261 rc = ui_paint_up_triangle(gc, &center, 5);
262 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
263
264 rc = gfx_context_delete(gc);
265 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
266}
267
268/** Paint down pointing triangle */
269PCUT_TEST(down_triangle)
270{
271 errno_t rc;
272 gfx_context_t *gc = NULL;
273 test_gc_t tgc;
274 gfx_coord2_t center;
275
276 memset(&tgc, 0, sizeof(tgc));
277 rc = gfx_context_new(&ops, &tgc, &gc);
278 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
279
280 center.x = 0;
281 center.y = 0;
282
283 rc = ui_paint_down_triangle(gc, &center, 5);
284 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
285
286 rc = gfx_context_delete(gc);
287 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
288}
289
290/** Paint left pointing triangle */
291PCUT_TEST(left_triangle)
292{
293 errno_t rc;
294 gfx_context_t *gc = NULL;
295 test_gc_t tgc;
296 gfx_coord2_t center;
297
298 memset(&tgc, 0, sizeof(tgc));
299 rc = gfx_context_new(&ops, &tgc, &gc);
300 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
301
302 center.x = 0;
303 center.y = 0;
304
305 rc = ui_paint_left_triangle(gc, &center, 5);
306 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
307
308 rc = gfx_context_delete(gc);
309 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
310}
311
312/** Paint right pointing triangle */
313PCUT_TEST(right_triangle)
314{
315 errno_t rc;
316 gfx_context_t *gc = NULL;
317 test_gc_t tgc;
318 gfx_coord2_t center;
319
320 memset(&tgc, 0, sizeof(tgc));
321 rc = gfx_context_new(&ops, &tgc, &gc);
322 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
323
324 center.x = 0;
325 center.y = 0;
326
327 rc = ui_paint_right_triangle(gc, &center, 5);
328 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
329
330 rc = gfx_context_delete(gc);
331 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
332}
333
334/** Paint diagonal cross (X) */
335PCUT_TEST(cross)
336{
337 errno_t rc;
338 gfx_context_t *gc = NULL;
339 test_gc_t tgc;
340 gfx_coord2_t center;
341
342 memset(&tgc, 0, sizeof(tgc));
343 rc = gfx_context_new(&ops, &tgc, &gc);
344 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
345
346 center.x = 0;
347 center.y = 0;
348
349 rc = ui_paint_cross(gc, &center, 5, 1, 2);
350 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
351
352 rc = gfx_context_delete(gc);
353 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
354}
355
356/** Paint mimimize icon */
357PCUT_TEST(minicon)
358{
359 errno_t rc;
360 gfx_context_t *gc = NULL;
361 ui_resource_t *resource = NULL;
362 test_gc_t tgc;
363 gfx_coord2_t center;
364
365 memset(&tgc, 0, sizeof(tgc));
366 rc = gfx_context_new(&ops, &tgc, &gc);
367 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
368
369 rc = ui_resource_create(gc, false, &resource);
370 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
371 PCUT_ASSERT_NOT_NULL(resource);
372
373 center.x = 0;
374 center.y = 0;
375
376 rc = ui_paint_minicon(resource, &center, 8, 6);
377 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
378
379 ui_resource_destroy(resource);
380 rc = gfx_context_delete(gc);
381 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
382}
383
384/** Paint maximize icon */
385PCUT_TEST(maxicon)
386{
387 errno_t rc;
388 gfx_context_t *gc = NULL;
389 ui_resource_t *resource = NULL;
390 test_gc_t tgc;
391 gfx_coord2_t center;
392
393 memset(&tgc, 0, sizeof(tgc));
394 rc = gfx_context_new(&ops, &tgc, &gc);
395 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
396
397 rc = ui_resource_create(gc, false, &resource);
398 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
399 PCUT_ASSERT_NOT_NULL(resource);
400
401 center.x = 0;
402 center.y = 0;
403
404 rc = ui_paint_maxicon(resource, &center, 8, 6);
405 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
406
407 ui_resource_destroy(resource);
408 rc = gfx_context_delete(gc);
409 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
410}
411
412/** Paint unmaximize icon */
413PCUT_TEST(unmaxicon)
414{
415 errno_t rc;
416 gfx_context_t *gc = NULL;
417 ui_resource_t *resource = NULL;
418 test_gc_t tgc;
419 gfx_coord2_t center;
420
421 memset(&tgc, 0, sizeof(tgc));
422 rc = gfx_context_new(&ops, &tgc, &gc);
423 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
424
425 rc = ui_resource_create(gc, false, &resource);
426 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
427 PCUT_ASSERT_NOT_NULL(resource);
428
429 center.x = 0;
430 center.y = 0;
431
432 rc = ui_paint_unmaxicon(resource, &center, 8, 8, 3, 3);
433 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
434
435 ui_resource_destroy(resource);
436 rc = gfx_context_delete(gc);
437 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
438}
439
440/** Paint text box */
441PCUT_TEST(text_box)
442{
443 errno_t rc;
444 gfx_context_t *gc = NULL;
445 ui_resource_t *resource = NULL;
446 gfx_color_t *color = NULL;
447 test_gc_t tgc;
448 gfx_rect_t rect;
449
450 memset(&tgc, 0, sizeof(tgc));
451 rc = gfx_context_new(&ops, &tgc, &gc);
452 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
453
454 rc = ui_resource_create(gc, false, &resource);
455 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
456 PCUT_ASSERT_NOT_NULL(resource);
457
458 rc = gfx_color_new_rgb_i16(1, 2, 3, &color);
459 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
460
461 rect.p0.x = 10;
462 rect.p0.y = 20;
463 rect.p1.x = 30;
464 rect.p1.y = 40;
465
466 /* Paint text box */
467 rc = ui_paint_text_box(resource, &rect, ui_box_single, color);
468 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
469
470 gfx_color_delete(color);
471 ui_resource_destroy(resource);
472 rc = gfx_context_delete(gc);
473 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
474}
475
476/** Paint text horizontal brace */
477PCUT_TEST(text_hbrace)
478{
479 errno_t rc;
480 gfx_context_t *gc = NULL;
481 ui_resource_t *resource = NULL;
482 gfx_color_t *color = NULL;
483 test_gc_t tgc;
484 gfx_rect_t rect;
485
486 memset(&tgc, 0, sizeof(tgc));
487 rc = gfx_context_new(&ops, &tgc, &gc);
488 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
489
490 rc = ui_resource_create(gc, false, &resource);
491 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
492 PCUT_ASSERT_NOT_NULL(resource);
493
494 rc = gfx_color_new_rgb_i16(1, 2, 3, &color);
495 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
496
497 rect.p0.x = 10;
498 rect.p0.y = 20;
499 rect.p1.x = 30;
500 rect.p1.y = 40;
501
502 /* Paint text horizontal brace */
503 rc = ui_paint_text_hbrace(resource, &rect, ui_box_single,
504 color);
505
506 gfx_color_delete(color);
507 ui_resource_destroy(resource);
508 rc = gfx_context_delete(gc);
509 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
510}
511
512/** Paint text rectangle */
513PCUT_TEST(text_rect)
514{
515 errno_t rc;
516 gfx_context_t *gc = NULL;
517 ui_resource_t *resource = NULL;
518 gfx_color_t *color = NULL;
519 test_gc_t tgc;
520 gfx_rect_t rect;
521
522 memset(&tgc, 0, sizeof(tgc));
523 rc = gfx_context_new(&ops, &tgc, &gc);
524 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
525
526 rc = ui_resource_create(gc, false, &resource);
527 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
528 PCUT_ASSERT_NOT_NULL(resource);
529
530 rc = gfx_color_new_rgb_i16(1, 2, 3, &color);
531 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
532
533 rect.p0.x = 10;
534 rect.p0.y = 20;
535 rect.p1.x = 30;
536 rect.p1.y = 40;
537
538 /* Paint text box */
539 rc = ui_paint_text_rect(resource, &rect, color, "A");
540 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
541
542 gfx_color_delete(color);
543 ui_resource_destroy(resource);
544 rc = gfx_context_delete(gc);
545 PCUT_ASSERT_ERRNO_VAL(EOK, rc);
546}
547
548static errno_t testgc_set_clip_rect(void *arg, gfx_rect_t *rect)
549{
550 (void) arg;
551 (void) rect;
552 return EOK;
553}
554
555static errno_t testgc_set_color(void *arg, gfx_color_t *color)
556{
557 (void) arg;
558 (void) color;
559 return EOK;
560}
561
562static errno_t testgc_fill_rect(void *arg, gfx_rect_t *rect)
563{
564 (void) arg;
565 (void) rect;
566 return EOK;
567}
568
569static errno_t testgc_bitmap_create(void *arg, gfx_bitmap_params_t *params,
570 gfx_bitmap_alloc_t *alloc, void **rbm)
571{
572 test_gc_t *tgc = (test_gc_t *) arg;
573 testgc_bitmap_t *tbm;
574
575 tbm = calloc(1, sizeof(testgc_bitmap_t));
576 if (tbm == NULL)
577 return ENOMEM;
578
579 if (alloc == NULL) {
580 tbm->alloc.pitch = (params->rect.p1.x - params->rect.p0.x) *
581 sizeof(uint32_t);
582 tbm->alloc.off0 = 0;
583 tbm->alloc.pixels = calloc(sizeof(uint32_t),
584 (params->rect.p1.x - params->rect.p0.x) *
585 (params->rect.p1.y - params->rect.p0.y));
586 tbm->myalloc = true;
587 if (tbm->alloc.pixels == NULL) {
588 free(tbm);
589 return ENOMEM;
590 }
591 } else {
592 tbm->alloc = *alloc;
593 }
594
595 tbm->tgc = tgc;
596 tgc->bm_created = true;
597 tgc->bm_params = *params;
598 tgc->bm_pixels = tbm->alloc.pixels;
599 *rbm = (void *)tbm;
600 return EOK;
601}
602
603static errno_t testgc_bitmap_destroy(void *bm)
604{
605 testgc_bitmap_t *tbm = (testgc_bitmap_t *)bm;
606 if (tbm->myalloc)
607 free(tbm->alloc.pixels);
608 tbm->tgc->bm_destroyed = true;
609 free(tbm);
610 return EOK;
611}
612
613static errno_t testgc_bitmap_render(void *bm, gfx_rect_t *srect,
614 gfx_coord2_t *offs)
615{
616 testgc_bitmap_t *tbm = (testgc_bitmap_t *)bm;
617 tbm->tgc->bm_rendered = true;
618 tbm->tgc->bm_srect = *srect;
619 tbm->tgc->bm_offs = *offs;
620 return EOK;
621}
622
623static errno_t testgc_bitmap_get_alloc(void *bm, gfx_bitmap_alloc_t *alloc)
624{
625 testgc_bitmap_t *tbm = (testgc_bitmap_t *)bm;
626 *alloc = tbm->alloc;
627 tbm->tgc->bm_got_alloc = true;
628 return EOK;
629}
630
631PCUT_EXPORT(paint);
Note: See TracBrowser for help on using the repository browser.