softpipe: Add support for reporting shader-db output.
[mesa.git] / src / gallium / drivers / softpipe / sp_screen.c
1 /**************************************************************************
2 *
3 * Copyright 2008 VMware, Inc.
4 * All Rights Reserved.
5 *
6 * Permission is hereby granted, free of charge, to any person obtaining a
7 * copy of this software and associated documentation files (the
8 * "Software"), to deal in the Software without restriction, including
9 * without limitation the rights to use, copy, modify, merge, publish,
10 * distribute, sub license, and/or sell copies of the Software, and to
11 * permit persons to whom the Software is furnished to do so, subject to
12 * the following conditions:
13 *
14 * The above copyright notice and this permission notice (including the
15 * next paragraph) shall be included in all copies or substantial portions
16 * of the Software.
17 *
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
21 * IN NO EVENT SHALL VMWARE AND/OR ITS SUPPLIERS BE LIABLE FOR
22 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
23 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
24 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
25 *
26 **************************************************************************/
27
28
29 #include "util/u_memory.h"
30 #include "util/format/u_format.h"
31 #include "util/format/u_format_s3tc.h"
32 #include "util/u_screen.h"
33 #include "util/u_video.h"
34 #include "util/os_misc.h"
35 #include "util/os_time.h"
36 #include "pipe/p_defines.h"
37 #include "pipe/p_screen.h"
38 #include "draw/draw_context.h"
39
40 #include "frontend/sw_winsys.h"
41 #include "tgsi/tgsi_exec.h"
42
43 #include "sp_texture.h"
44 #include "sp_screen.h"
45 #include "sp_context.h"
46 #include "sp_fence.h"
47 #include "sp_public.h"
48
49 static const struct debug_named_value sp_debug_options[] = {
50 {"vs", SP_DBG_VS, "dump vertex shader assembly to stderr"},
51 {"gs", SP_DBG_GS, "dump geometry shader assembly to stderr"},
52 {"fs", SP_DBG_FS, "dump fragment shader assembly to stderr"},
53 {"cs", SP_DBG_CS, "dump compute shader assembly to stderr"},
54 {"no_rast", SP_DBG_NO_RAST, "no-ops rasterization, for profiling purposes"},
55 {"use_llvm", SP_DBG_USE_LLVM, "Use LLVM if available for shaders"},
56 };
57
58 int sp_debug;
59 DEBUG_GET_ONCE_FLAGS_OPTION(sp_debug, "SOFTPIPE_DEBUG", sp_debug_options, 0)
60
61 static const char *
62 softpipe_get_vendor(struct pipe_screen *screen)
63 {
64 return "Mesa/X.org";
65 }
66
67
68 static const char *
69 softpipe_get_name(struct pipe_screen *screen)
70 {
71 return "softpipe";
72 }
73
74
75 static int
76 softpipe_get_param(struct pipe_screen *screen, enum pipe_cap param)
77 {
78 struct softpipe_screen *sp_screen = softpipe_screen(screen);
79 switch (param) {
80 case PIPE_CAP_NPOT_TEXTURES:
81 case PIPE_CAP_MIXED_FRAMEBUFFER_SIZES:
82 case PIPE_CAP_MIXED_COLOR_DEPTH_BITS:
83 return 1;
84 case PIPE_CAP_FRAGMENT_SHADER_TEXTURE_LOD:
85 case PIPE_CAP_FRAGMENT_SHADER_DERIVATIVES:
86 case PIPE_CAP_VERTEX_SHADER_SATURATE:
87 return 1;
88 case PIPE_CAP_ANISOTROPIC_FILTER:
89 return 1;
90 case PIPE_CAP_POINT_SPRITE:
91 return 1;
92 case PIPE_CAP_MAX_RENDER_TARGETS:
93 return PIPE_MAX_COLOR_BUFS;
94 case PIPE_CAP_MAX_DUAL_SOURCE_RENDER_TARGETS:
95 return 1;
96 case PIPE_CAP_OCCLUSION_QUERY:
97 return 1;
98 case PIPE_CAP_QUERY_TIME_ELAPSED:
99 return 1;
100 case PIPE_CAP_QUERY_PIPELINE_STATISTICS:
101 return 1;
102 case PIPE_CAP_TEXTURE_MIRROR_CLAMP:
103 case PIPE_CAP_TEXTURE_MIRROR_CLAMP_TO_EDGE:
104 return 1;
105 case PIPE_CAP_TEXTURE_SWIZZLE:
106 return 1;
107 case PIPE_CAP_MAX_TEXTURE_2D_SIZE:
108 return 1 << (SP_MAX_TEXTURE_2D_LEVELS - 1);
109 case PIPE_CAP_MAX_TEXTURE_3D_LEVELS:
110 return SP_MAX_TEXTURE_3D_LEVELS;
111 case PIPE_CAP_MAX_TEXTURE_CUBE_LEVELS:
112 return SP_MAX_TEXTURE_CUBE_LEVELS;
113 case PIPE_CAP_BLEND_EQUATION_SEPARATE:
114 return 1;
115 case PIPE_CAP_INDEP_BLEND_ENABLE:
116 return 1;
117 case PIPE_CAP_INDEP_BLEND_FUNC:
118 return 1;
119 case PIPE_CAP_TGSI_FS_COORD_ORIGIN_UPPER_LEFT:
120 case PIPE_CAP_TGSI_FS_COORD_ORIGIN_LOWER_LEFT:
121 case PIPE_CAP_TGSI_FS_COORD_PIXEL_CENTER_HALF_INTEGER:
122 case PIPE_CAP_TGSI_FS_COORD_PIXEL_CENTER_INTEGER:
123 return 1;
124 case PIPE_CAP_DEPTH_CLIP_DISABLE:
125 return 1;
126 case PIPE_CAP_MAX_STREAM_OUTPUT_BUFFERS:
127 return PIPE_MAX_SO_BUFFERS;
128 case PIPE_CAP_MAX_STREAM_OUTPUT_SEPARATE_COMPONENTS:
129 case PIPE_CAP_MAX_STREAM_OUTPUT_INTERLEAVED_COMPONENTS:
130 return 16*4;
131 case PIPE_CAP_MAX_GEOMETRY_OUTPUT_VERTICES:
132 case PIPE_CAP_MAX_GEOMETRY_TOTAL_OUTPUT_COMPONENTS:
133 return 1024;
134 case PIPE_CAP_MAX_VERTEX_STREAMS:
135 if (sp_screen->use_llvm)
136 return 1;
137 else
138 return PIPE_MAX_VERTEX_STREAMS;
139 case PIPE_CAP_MAX_VERTEX_ATTRIB_STRIDE:
140 return 2048;
141 case PIPE_CAP_PRIMITIVE_RESTART:
142 case PIPE_CAP_PRIMITIVE_RESTART_FIXED_INDEX:
143 return 1;
144 case PIPE_CAP_SHADER_STENCIL_EXPORT:
145 return 1;
146 case PIPE_CAP_TGSI_ATOMFADD:
147 case PIPE_CAP_TGSI_INSTANCEID:
148 case PIPE_CAP_VERTEX_ELEMENT_INSTANCE_DIVISOR:
149 case PIPE_CAP_START_INSTANCE:
150 return 1;
151 case PIPE_CAP_SEAMLESS_CUBE_MAP:
152 case PIPE_CAP_SEAMLESS_CUBE_MAP_PER_TEXTURE:
153 return 1;
154 case PIPE_CAP_MAX_TEXTURE_ARRAY_LAYERS:
155 return 256; /* for GL3 */
156 case PIPE_CAP_MIN_TEXEL_OFFSET:
157 return -8;
158 case PIPE_CAP_MAX_TEXEL_OFFSET:
159 return 7;
160 case PIPE_CAP_CONDITIONAL_RENDER:
161 case PIPE_CAP_FRAGMENT_COLOR_CLAMPED:
162 case PIPE_CAP_VERTEX_COLOR_UNCLAMPED: /* draw module */
163 case PIPE_CAP_VERTEX_COLOR_CLAMPED: /* draw module */
164 return 1;
165 case PIPE_CAP_MIXED_COLORBUFFER_FORMATS:
166 return 1;
167 case PIPE_CAP_GLSL_FEATURE_LEVEL:
168 return 400;
169 case PIPE_CAP_GLSL_FEATURE_LEVEL_COMPATIBILITY:
170 return 140;
171 case PIPE_CAP_COMPUTE:
172 return 1;
173 case PIPE_CAP_USER_VERTEX_BUFFERS:
174 case PIPE_CAP_STREAM_OUTPUT_PAUSE_RESUME:
175 case PIPE_CAP_STREAM_OUTPUT_INTERLEAVE_BUFFERS:
176 case PIPE_CAP_TGSI_VS_LAYER_VIEWPORT:
177 case PIPE_CAP_DOUBLES:
178 case PIPE_CAP_INT64:
179 case PIPE_CAP_INT64_DIVMOD:
180 case PIPE_CAP_TGSI_DIV:
181 return 1;
182 case PIPE_CAP_CONSTANT_BUFFER_OFFSET_ALIGNMENT:
183 return 16;
184 case PIPE_CAP_MIN_MAP_BUFFER_ALIGNMENT:
185 return 64;
186 case PIPE_CAP_QUERY_TIMESTAMP:
187 case PIPE_CAP_CUBE_MAP_ARRAY:
188 return 1;
189 case PIPE_CAP_TEXTURE_BUFFER_OBJECTS:
190 return 1;
191 case PIPE_CAP_MAX_TEXTURE_BUFFER_SIZE:
192 return 65536;
193 case PIPE_CAP_TEXTURE_BUFFER_OFFSET_ALIGNMENT:
194 return 16;
195 case PIPE_CAP_PREFER_BLIT_BASED_TEXTURE_TRANSFER:
196 return 0;
197 case PIPE_CAP_MAX_VIEWPORTS:
198 return PIPE_MAX_VIEWPORTS;
199 case PIPE_CAP_ENDIANNESS:
200 return PIPE_ENDIAN_NATIVE;
201 case PIPE_CAP_MAX_TEXTURE_GATHER_COMPONENTS:
202 return 4;
203 case PIPE_CAP_TEXTURE_GATHER_SM5:
204 case PIPE_CAP_TEXTURE_QUERY_LOD:
205 return 1;
206 case PIPE_CAP_TGSI_VS_WINDOW_SPACE_POSITION:
207 return 1;
208 case PIPE_CAP_TGSI_FS_FINE_DERIVATIVE:
209 return 1;
210 case PIPE_CAP_SAMPLER_VIEW_TARGET:
211 return 1;
212 case PIPE_CAP_FAKE_SW_MSAA:
213 return 1;
214 case PIPE_CAP_MIN_TEXTURE_GATHER_OFFSET:
215 return -32;
216 case PIPE_CAP_MAX_TEXTURE_GATHER_OFFSET:
217 return 31;
218 case PIPE_CAP_DRAW_INDIRECT:
219 return 1;
220 case PIPE_CAP_QUERY_SO_OVERFLOW:
221 return 1;
222
223 case PIPE_CAP_VENDOR_ID:
224 return 0xFFFFFFFF;
225 case PIPE_CAP_DEVICE_ID:
226 return 0xFFFFFFFF;
227 case PIPE_CAP_ACCELERATED:
228 return 0;
229 case PIPE_CAP_VIDEO_MEMORY: {
230 /* XXX: Do we want to return the full amount fo system memory ? */
231 uint64_t system_memory;
232
233 if (!os_get_total_physical_memory(&system_memory))
234 return 0;
235
236 if (sizeof(void *) == 4)
237 /* Cap to 2 GB on 32 bits system. We do this because softpipe does
238 * eat application memory, which is quite limited on 32 bits. App
239 * shouldn't expect too much available memory. */
240 system_memory = MIN2(system_memory, 2048 << 20);
241
242 return (int)(system_memory >> 20);
243 }
244 case PIPE_CAP_UMA:
245 return 0;
246 case PIPE_CAP_CONDITIONAL_RENDER_INVERTED:
247 return 1;
248 case PIPE_CAP_CLIP_HALFZ:
249 case PIPE_CAP_TEXTURE_FLOAT_LINEAR:
250 case PIPE_CAP_TEXTURE_HALF_FLOAT_LINEAR:
251 return 1;
252 case PIPE_CAP_FRAMEBUFFER_NO_ATTACHMENT:
253 case PIPE_CAP_CULL_DISTANCE:
254 case PIPE_CAP_COPY_BETWEEN_COMPRESSED_AND_PLAIN_FORMATS:
255 case PIPE_CAP_TGSI_ARRAY_COMPONENTS:
256 return 1;
257 case PIPE_CAP_CLEAR_TEXTURE:
258 return 1;
259 case PIPE_CAP_MAX_VARYINGS:
260 return TGSI_EXEC_MAX_INPUT_ATTRIBS;
261 case PIPE_CAP_PCI_GROUP:
262 case PIPE_CAP_PCI_BUS:
263 case PIPE_CAP_PCI_DEVICE:
264 case PIPE_CAP_PCI_FUNCTION:
265 case PIPE_CAP_GLSL_OPTIMIZE_CONSERVATIVELY:
266 return 0;
267 case PIPE_CAP_MAX_GS_INVOCATIONS:
268 return 32;
269 case PIPE_CAP_MAX_SHADER_BUFFER_SIZE:
270 return 1 << 27;
271 case PIPE_CAP_SHADER_BUFFER_OFFSET_ALIGNMENT:
272 return 4;
273 default:
274 return u_pipe_screen_get_param_defaults(screen, param);
275 }
276 }
277
278 static int
279 softpipe_get_shader_param(struct pipe_screen *screen,
280 enum pipe_shader_type shader,
281 enum pipe_shader_cap param)
282 {
283 struct softpipe_screen *sp_screen = softpipe_screen(screen);
284 switch(shader)
285 {
286 case PIPE_SHADER_FRAGMENT:
287 return tgsi_exec_get_shader_param(param);
288 case PIPE_SHADER_COMPUTE:
289 return tgsi_exec_get_shader_param(param);
290 case PIPE_SHADER_VERTEX:
291 case PIPE_SHADER_GEOMETRY:
292 if (sp_screen->use_llvm)
293 return draw_get_shader_param(shader, param);
294 else
295 return draw_get_shader_param_no_llvm(shader, param);
296 default:
297 return 0;
298 }
299 }
300
301 static float
302 softpipe_get_paramf(struct pipe_screen *screen, enum pipe_capf param)
303 {
304 switch (param) {
305 case PIPE_CAPF_MAX_LINE_WIDTH:
306 /* fall-through */
307 case PIPE_CAPF_MAX_LINE_WIDTH_AA:
308 return 255.0; /* arbitrary */
309 case PIPE_CAPF_MAX_POINT_WIDTH:
310 /* fall-through */
311 case PIPE_CAPF_MAX_POINT_WIDTH_AA:
312 return 255.0; /* arbitrary */
313 case PIPE_CAPF_MAX_TEXTURE_ANISOTROPY:
314 return 16.0;
315 case PIPE_CAPF_MAX_TEXTURE_LOD_BIAS:
316 return 16.0; /* arbitrary */
317 case PIPE_CAPF_MIN_CONSERVATIVE_RASTER_DILATE:
318 return 0.0;
319 case PIPE_CAPF_MAX_CONSERVATIVE_RASTER_DILATE:
320 return 0.0;
321 case PIPE_CAPF_CONSERVATIVE_RASTER_DILATE_GRANULARITY:
322 return 0.0;
323 }
324 /* should only get here on unhandled cases */
325 debug_printf("Unexpected PIPE_CAPF %d query\n", param);
326 return 0.0;
327 }
328
329 /**
330 * Query format support for creating a texture, drawing surface, etc.
331 * \param format the format to test
332 * \param type one of PIPE_TEXTURE, PIPE_SURFACE
333 */
334 static bool
335 softpipe_is_format_supported( struct pipe_screen *screen,
336 enum pipe_format format,
337 enum pipe_texture_target target,
338 unsigned sample_count,
339 unsigned storage_sample_count,
340 unsigned bind)
341 {
342 struct sw_winsys *winsys = softpipe_screen(screen)->winsys;
343 const struct util_format_description *format_desc;
344
345 assert(target == PIPE_BUFFER ||
346 target == PIPE_TEXTURE_1D ||
347 target == PIPE_TEXTURE_1D_ARRAY ||
348 target == PIPE_TEXTURE_2D ||
349 target == PIPE_TEXTURE_2D_ARRAY ||
350 target == PIPE_TEXTURE_RECT ||
351 target == PIPE_TEXTURE_3D ||
352 target == PIPE_TEXTURE_CUBE ||
353 target == PIPE_TEXTURE_CUBE_ARRAY);
354
355 if (MAX2(1, sample_count) != MAX2(1, storage_sample_count))
356 return false;
357
358 format_desc = util_format_description(format);
359 if (!format_desc)
360 return false;
361
362 if (sample_count > 1)
363 return false;
364
365 if (bind & (PIPE_BIND_DISPLAY_TARGET |
366 PIPE_BIND_SCANOUT |
367 PIPE_BIND_SHARED)) {
368 if(!winsys->is_displaytarget_format_supported(winsys, bind, format))
369 return false;
370 }
371
372 if (bind & PIPE_BIND_RENDER_TARGET) {
373 if (format_desc->colorspace == UTIL_FORMAT_COLORSPACE_ZS)
374 return false;
375
376 /*
377 * Although possible, it is unnatural to render into compressed or YUV
378 * surfaces. So disable these here to avoid going into weird paths
379 * inside gallium frontends.
380 */
381 if (format_desc->block.width != 1 ||
382 format_desc->block.height != 1)
383 return false;
384 }
385
386 if (bind & PIPE_BIND_DEPTH_STENCIL) {
387 if (format_desc->colorspace != UTIL_FORMAT_COLORSPACE_ZS)
388 return false;
389 }
390
391 if (format_desc->layout == UTIL_FORMAT_LAYOUT_ASTC ||
392 format_desc->layout == UTIL_FORMAT_LAYOUT_ATC) {
393 /* Software decoding is not hooked up. */
394 return false;
395 }
396
397 if ((bind & (PIPE_BIND_RENDER_TARGET | PIPE_BIND_SAMPLER_VIEW)) &&
398 ((bind & PIPE_BIND_DISPLAY_TARGET) == 0) &&
399 target != PIPE_BUFFER) {
400 const struct util_format_description *desc =
401 util_format_description(format);
402 if (desc->nr_channels == 3 && desc->is_array) {
403 /* Don't support any 3-component formats for rendering/texturing
404 * since we don't support the corresponding 8-bit 3 channel UNORM
405 * formats. This allows us to support GL_ARB_copy_image between
406 * GL_RGB8 and GL_RGB8UI, for example. Otherwise, we may be asked to
407 * do a resource copy between PIPE_FORMAT_R8G8B8_UINT and
408 * PIPE_FORMAT_R8G8B8X8_UNORM, for example, which will not work
409 * (different bpp).
410 */
411 return false;
412 }
413 }
414
415 if (format_desc->layout == UTIL_FORMAT_LAYOUT_ETC &&
416 format != PIPE_FORMAT_ETC1_RGB8)
417 return false;
418
419 /*
420 * All other operations (sampling, transfer, etc).
421 */
422
423 /*
424 * Everything else should be supported by u_format.
425 */
426 return true;
427 }
428
429
430 static void
431 softpipe_destroy_screen( struct pipe_screen *screen )
432 {
433 struct softpipe_screen *sp_screen = softpipe_screen(screen);
434 struct sw_winsys *winsys = sp_screen->winsys;
435
436 if(winsys->destroy)
437 winsys->destroy(winsys);
438
439 FREE(screen);
440 }
441
442
443 /* This is often overriden by the co-state tracker.
444 */
445 static void
446 softpipe_flush_frontbuffer(struct pipe_screen *_screen,
447 struct pipe_resource *resource,
448 unsigned level, unsigned layer,
449 void *context_private,
450 struct pipe_box *sub_box)
451 {
452 struct softpipe_screen *screen = softpipe_screen(_screen);
453 struct sw_winsys *winsys = screen->winsys;
454 struct softpipe_resource *texture = softpipe_resource(resource);
455
456 assert(texture->dt);
457 if (texture->dt)
458 winsys->displaytarget_display(winsys, texture->dt, context_private, sub_box);
459 }
460
461 static uint64_t
462 softpipe_get_timestamp(struct pipe_screen *_screen)
463 {
464 return os_time_get_nano();
465 }
466
467 static int
468 softpipe_get_compute_param(struct pipe_screen *_screen,
469 enum pipe_shader_ir ir_type,
470 enum pipe_compute_cap param,
471 void *ret)
472 {
473 switch (param) {
474 case PIPE_COMPUTE_CAP_IR_TARGET:
475 return 0;
476 case PIPE_COMPUTE_CAP_MAX_GRID_SIZE:
477 if (ret) {
478 uint64_t *grid_size = ret;
479 grid_size[0] = 65535;
480 grid_size[1] = 65535;
481 grid_size[2] = 65535;
482 }
483 return 3 * sizeof(uint64_t) ;
484 case PIPE_COMPUTE_CAP_MAX_BLOCK_SIZE:
485 if (ret) {
486 uint64_t *block_size = ret;
487 block_size[0] = 1024;
488 block_size[1] = 1024;
489 block_size[2] = 1024;
490 }
491 return 3 * sizeof(uint64_t);
492 case PIPE_COMPUTE_CAP_MAX_THREADS_PER_BLOCK:
493 if (ret) {
494 uint64_t *max_threads_per_block = ret;
495 *max_threads_per_block = 1024;
496 }
497 return sizeof(uint64_t);
498 case PIPE_COMPUTE_CAP_MAX_LOCAL_SIZE:
499 if (ret) {
500 uint64_t *max_local_size = ret;
501 *max_local_size = 32768;
502 }
503 return sizeof(uint64_t);
504 case PIPE_COMPUTE_CAP_GRID_DIMENSION:
505 case PIPE_COMPUTE_CAP_MAX_GLOBAL_SIZE:
506 case PIPE_COMPUTE_CAP_MAX_PRIVATE_SIZE:
507 case PIPE_COMPUTE_CAP_MAX_INPUT_SIZE:
508 case PIPE_COMPUTE_CAP_MAX_MEM_ALLOC_SIZE:
509 case PIPE_COMPUTE_CAP_MAX_CLOCK_FREQUENCY:
510 case PIPE_COMPUTE_CAP_MAX_COMPUTE_UNITS:
511 case PIPE_COMPUTE_CAP_IMAGES_SUPPORTED:
512 case PIPE_COMPUTE_CAP_SUBGROUP_SIZE:
513 case PIPE_COMPUTE_CAP_ADDRESS_BITS:
514 case PIPE_COMPUTE_CAP_MAX_VARIABLE_THREADS_PER_BLOCK:
515 break;
516 }
517 return 0;
518 }
519
520 /**
521 * Create a new pipe_screen object
522 * Note: we're not presently subclassing pipe_screen (no softpipe_screen).
523 */
524 struct pipe_screen *
525 softpipe_create_screen(struct sw_winsys *winsys)
526 {
527 struct softpipe_screen *screen = CALLOC_STRUCT(softpipe_screen);
528
529 if (!screen)
530 return NULL;
531
532 sp_debug = debug_get_option_sp_debug();
533
534 screen->winsys = winsys;
535
536 screen->base.destroy = softpipe_destroy_screen;
537
538 screen->base.get_name = softpipe_get_name;
539 screen->base.get_vendor = softpipe_get_vendor;
540 screen->base.get_device_vendor = softpipe_get_vendor; // TODO should be the CPU vendor
541 screen->base.get_param = softpipe_get_param;
542 screen->base.get_shader_param = softpipe_get_shader_param;
543 screen->base.get_paramf = softpipe_get_paramf;
544 screen->base.get_timestamp = softpipe_get_timestamp;
545 screen->base.is_format_supported = softpipe_is_format_supported;
546 screen->base.context_create = softpipe_create_context;
547 screen->base.flush_frontbuffer = softpipe_flush_frontbuffer;
548 screen->base.get_compute_param = softpipe_get_compute_param;
549 screen->use_llvm = sp_debug & SP_DBG_USE_LLVM;
550
551 softpipe_init_screen_texture_funcs(&screen->base);
552 softpipe_init_screen_fence_funcs(&screen->base);
553
554 return &screen->base;
555 }