X-Git-Url: https://git.libre-soc.org/?a=blobdiff_plain;f=src%2Fgallium%2Fdrivers%2Ffreedreno%2Ffreedreno_resource.c;h=8147ff57a990c880303f2c0b804e88fa885ae5c8;hb=a331d7d1cdfdc971f707fb6b1f71edbad622c804;hp=5bcf11da85bef67b3e8b329521125d4bcd87497f;hpb=dcde4cd114e906f5c4372dbb6758026c9222cd2a;p=mesa.git diff --git a/src/gallium/drivers/freedreno/freedreno_resource.c b/src/gallium/drivers/freedreno/freedreno_resource.c index 5bcf11da85b..8147ff57a99 100644 --- a/src/gallium/drivers/freedreno/freedreno_resource.c +++ b/src/gallium/drivers/freedreno/freedreno_resource.c @@ -48,66 +48,57 @@ /* XXX this should go away, needed for 'struct winsys_handle' */ #include "state_tracker/drm_driver.h" -static bool -pending(struct fd_resource *rsc, bool write) -{ - /* if we have a pending GPU write, we are busy in any case: */ - if (rsc->write_batch) - return true; - - /* if CPU wants to write, but we are pending a GPU read, we are busy: */ - if (write && rsc->batch_mask) - return true; - - if (rsc->stencil && pending(rsc->stencil, write)) - return true; - - return false; -} - +/** + * Go through the entire state and see if the resource is bound + * anywhere. If it is, mark the relevant state as dirty. This is + * called on realloc_bo to ensure the neccessary state is re- + * emitted so the GPU looks at the new backing bo. + */ static void -fd_invalidate_resource(struct fd_context *ctx, struct pipe_resource *prsc) +rebind_resource(struct fd_context *ctx, struct pipe_resource *prsc) { - int i; - - /* Go through the entire state and see if the resource is bound - * anywhere. If it is, mark the relevant state as dirty. This is called on - * realloc_bo. - */ - - /* Constbufs */ - for (i = 1; i < PIPE_MAX_CONSTANT_BUFFERS && !(ctx->dirty & FD_DIRTY_CONSTBUF); i++) { - if (ctx->constbuf[PIPE_SHADER_VERTEX].cb[i].buffer == prsc) - ctx->dirty |= FD_DIRTY_CONSTBUF; - if (ctx->constbuf[PIPE_SHADER_FRAGMENT].cb[i].buffer == prsc) - ctx->dirty |= FD_DIRTY_CONSTBUF; - } - /* VBOs */ - for (i = 0; i < ctx->vtx.vertexbuf.count && !(ctx->dirty & FD_DIRTY_VTXBUF); i++) { - if (ctx->vtx.vertexbuf.vb[i].buffer == prsc) + for (unsigned i = 0; i < ctx->vtx.vertexbuf.count && !(ctx->dirty & FD_DIRTY_VTXBUF); i++) { + if (ctx->vtx.vertexbuf.vb[i].buffer.resource == prsc) ctx->dirty |= FD_DIRTY_VTXBUF; } - /* Index buffer */ - if (ctx->indexbuf.buffer == prsc) - ctx->dirty |= FD_DIRTY_INDEXBUF; + /* per-shader-stage resources: */ + for (unsigned stage = 0; stage < PIPE_SHADER_TYPES; stage++) { + /* Constbufs.. note that constbuf[0] is normal uniforms emitted in + * cmdstream rather than by pointer.. + */ + const unsigned num_ubos = util_last_bit(ctx->constbuf[stage].enabled_mask); + for (unsigned i = 1; i < num_ubos; i++) { + if (ctx->dirty_shader[stage] & FD_DIRTY_SHADER_CONST) + break; + if (ctx->constbuf[stage].cb[i].buffer == prsc) + ctx->dirty_shader[stage] |= FD_DIRTY_SHADER_CONST; + } - /* Textures */ - for (i = 0; i < ctx->verttex.num_textures && !(ctx->dirty & FD_DIRTY_VERTTEX); i++) { - if (ctx->verttex.textures[i] && (ctx->verttex.textures[i]->texture == prsc)) - ctx->dirty |= FD_DIRTY_VERTTEX; - } - for (i = 0; i < ctx->fragtex.num_textures && !(ctx->dirty & FD_DIRTY_FRAGTEX); i++) { - if (ctx->fragtex.textures[i] && (ctx->fragtex.textures[i]->texture == prsc)) - ctx->dirty |= FD_DIRTY_FRAGTEX; + /* Textures */ + for (unsigned i = 0; i < ctx->tex[stage].num_textures; i++) { + if (ctx->dirty_shader[stage] & FD_DIRTY_SHADER_TEX) + break; + if (ctx->tex[stage].textures[i] && (ctx->tex[stage].textures[i]->texture == prsc)) + ctx->dirty_shader[stage] |= FD_DIRTY_SHADER_TEX; + } + + /* SSBOs */ + const unsigned num_ssbos = util_last_bit(ctx->shaderbuf[stage].enabled_mask); + for (unsigned i = 0; i < num_ssbos; i++) { + if (ctx->dirty_shader[stage] & FD_DIRTY_SHADER_SSBO) + break; + if (ctx->shaderbuf[stage].sb[i].buffer == prsc) + ctx->dirty_shader[stage] |= FD_DIRTY_SHADER_SSBO; + } } } static void realloc_bo(struct fd_resource *rsc, uint32_t size) { - struct fd_screen *screen = fd_screen(rsc->base.b.screen); + struct fd_screen *screen = fd_screen(rsc->base.screen); uint32_t flags = DRM_FREEDRENO_GEM_CACHE_WCOMBINE | DRM_FREEDRENO_GEM_TYPE_KMEM; /* TODO */ @@ -119,114 +110,245 @@ realloc_bo(struct fd_resource *rsc, uint32_t size) fd_bo_del(rsc->bo); rsc->bo = fd_bo_new(screen->dev, size, flags); - rsc->timestamp = 0; util_range_set_empty(&rsc->valid_buffer_range); fd_bc_invalidate_resource(rsc, true); } -static unsigned -fd_resource_layer_offset(struct fd_resource *rsc, - struct fd_resource_slice *slice, - unsigned layer) +static void +do_blit(struct fd_context *ctx, const struct pipe_blit_info *blit, bool fallback) { - if (rsc->layer_first) - return layer * rsc->layer_size; - else - return layer * slice->size0; + /* TODO size threshold too?? */ + if (!fallback) { + /* do blit on gpu: */ + fd_blitter_pipe_begin(ctx, false, true, FD_STAGE_BLIT); + ctx->blit(ctx, blit); + fd_blitter_pipe_end(ctx); + } else { + /* do blit on cpu: */ + util_resource_copy_region(&ctx->base, + blit->dst.resource, blit->dst.level, blit->dst.box.x, + blit->dst.box.y, blit->dst.box.z, + blit->src.resource, blit->src.level, &blit->src.box); + } } -static void -fd_resource_flush_z32s8(struct fd_transfer *trans, const struct pipe_box *box) +static bool +fd_try_shadow_resource(struct fd_context *ctx, struct fd_resource *rsc, + unsigned level, const struct pipe_box *box) { - struct fd_resource *rsc = fd_resource(trans->base.resource); - struct fd_resource_slice *slice = fd_resource_slice(rsc, trans->base.level); - struct fd_resource_slice *sslice = fd_resource_slice(rsc->stencil, trans->base.level); - enum pipe_format format = trans->base.resource->format; + struct pipe_context *pctx = &ctx->base; + struct pipe_resource *prsc = &rsc->base; + bool fallback = false; - float *depth = fd_bo_map(rsc->bo) + slice->offset + - fd_resource_layer_offset(rsc, slice, trans->base.box.z) + - (trans->base.box.y + box->y) * slice->pitch * 4 + (trans->base.box.x + box->x) * 4; - uint8_t *stencil = fd_bo_map(rsc->stencil->bo) + sslice->offset + - fd_resource_layer_offset(rsc->stencil, sslice, trans->base.box.z) + - (trans->base.box.y + box->y) * sslice->pitch + trans->base.box.x + box->x; + if (prsc->next) + return false; - if (format != PIPE_FORMAT_X32_S8X24_UINT) - util_format_z32_float_s8x24_uint_unpack_z_float( - depth, slice->pitch * 4, - trans->staging, trans->base.stride, - box->width, box->height); + /* TODO: somehow munge dimensions and format to copy unsupported + * render target format to something that is supported? + */ + if (!pctx->screen->is_format_supported(pctx->screen, + prsc->format, prsc->target, prsc->nr_samples, + PIPE_BIND_RENDER_TARGET)) + fallback = true; - util_format_z32_float_s8x24_uint_unpack_s_8uint( - stencil, sslice->pitch, - trans->staging, trans->base.stride, - box->width, box->height); -} + /* do shadowing back-blits on the cpu for buffers: */ + if (prsc->target == PIPE_BUFFER) + fallback = true; -static void -fd_resource_flush_rgtc(struct fd_transfer *trans, const struct pipe_box *box) -{ - struct fd_resource *rsc = fd_resource(trans->base.resource); - struct fd_resource_slice *slice = fd_resource_slice(rsc, trans->base.level); - enum pipe_format format = trans->base.resource->format; + bool whole_level = util_texrange_covers_whole_level(prsc, level, + box->x, box->y, box->z, box->width, box->height, box->depth); - uint8_t *data = fd_bo_map(rsc->bo) + slice->offset + - fd_resource_layer_offset(rsc, slice, trans->base.box.z) + - ((trans->base.box.y + box->y) * slice->pitch + - trans->base.box.x + box->x) * rsc->cpp; + /* TODO need to be more clever about current level */ + if ((prsc->target >= PIPE_TEXTURE_2D) && !whole_level) + return false; - uint8_t *source = trans->staging + - util_format_get_nblocksy(format, box->y) * trans->base.stride + - util_format_get_stride(format, box->x); + struct pipe_resource *pshadow = + pctx->screen->resource_create(pctx->screen, prsc); - switch (format) { - case PIPE_FORMAT_RGTC1_UNORM: - case PIPE_FORMAT_RGTC1_SNORM: - case PIPE_FORMAT_LATC1_UNORM: - case PIPE_FORMAT_LATC1_SNORM: - util_format_rgtc1_unorm_unpack_rgba_8unorm( - data, slice->pitch * rsc->cpp, - source, trans->base.stride, - box->width, box->height); - break; - case PIPE_FORMAT_RGTC2_UNORM: - case PIPE_FORMAT_RGTC2_SNORM: - case PIPE_FORMAT_LATC2_UNORM: - case PIPE_FORMAT_LATC2_SNORM: - util_format_rgtc2_unorm_unpack_rgba_8unorm( - data, slice->pitch * rsc->cpp, - source, trans->base.stride, - box->width, box->height); - break; - default: - assert(!"Unexpected format\n"); - break; + if (!pshadow) + return false; + + assert(!ctx->in_shadow); + ctx->in_shadow = true; + + /* get rid of any references that batch-cache might have to us (which + * should empty/destroy rsc->batches hashset) + */ + fd_bc_invalidate_resource(rsc, false); + + mtx_lock(&ctx->screen->lock); + + /* Swap the backing bo's, so shadow becomes the old buffer, + * blit from shadow to new buffer. From here on out, we + * cannot fail. + * + * Note that we need to do it in this order, otherwise if + * we go down cpu blit path, the recursive transfer_map() + * sees the wrong status.. + */ + struct fd_resource *shadow = fd_resource(pshadow); + + DBG("shadow: %p (%d) -> %p (%d)\n", rsc, rsc->base.reference.count, + shadow, shadow->base.reference.count); + + /* TODO valid_buffer_range?? */ + swap(rsc->bo, shadow->bo); + swap(rsc->write_batch, shadow->write_batch); + + /* at this point, the newly created shadow buffer is not referenced + * by any batches, but the existing rsc (probably) is. We need to + * transfer those references over: + */ + debug_assert(shadow->batch_mask == 0); + struct fd_batch *batch; + foreach_batch(batch, &ctx->screen->batch_cache, rsc->batch_mask) { + struct set_entry *entry = _mesa_set_search(batch->resources, rsc); + _mesa_set_remove(batch->resources, entry); + _mesa_set_add(batch->resources, shadow); + } + swap(rsc->batch_mask, shadow->batch_mask); + + mtx_unlock(&ctx->screen->lock); + + struct pipe_blit_info blit = {0}; + blit.dst.resource = prsc; + blit.dst.format = prsc->format; + blit.src.resource = pshadow; + blit.src.format = pshadow->format; + blit.mask = util_format_get_mask(prsc->format); + blit.filter = PIPE_TEX_FILTER_NEAREST; + +#define set_box(field, val) do { \ + blit.dst.field = (val); \ + blit.src.field = (val); \ + } while (0) + + /* blit the other levels in their entirety: */ + for (unsigned l = 0; l <= prsc->last_level; l++) { + if (l == level) + continue; + + /* just blit whole level: */ + set_box(level, l); + set_box(box.width, u_minify(prsc->width0, l)); + set_box(box.height, u_minify(prsc->height0, l)); + set_box(box.depth, u_minify(prsc->depth0, l)); + + do_blit(ctx, &blit, fallback); } + + /* deal w/ current level specially, since we might need to split + * it up into a couple blits: + */ + if (!whole_level) { + set_box(level, level); + + switch (prsc->target) { + case PIPE_BUFFER: + case PIPE_TEXTURE_1D: + set_box(box.y, 0); + set_box(box.z, 0); + set_box(box.height, 1); + set_box(box.depth, 1); + + if (box->x > 0) { + set_box(box.x, 0); + set_box(box.width, box->x); + + do_blit(ctx, &blit, fallback); + } + if ((box->x + box->width) < u_minify(prsc->width0, level)) { + set_box(box.x, box->x + box->width); + set_box(box.width, u_minify(prsc->width0, level) - (box->x + box->width)); + + do_blit(ctx, &blit, fallback); + } + break; + case PIPE_TEXTURE_2D: + /* TODO */ + default: + unreachable("TODO"); + } + } + + ctx->in_shadow = false; + + pipe_resource_reference(&pshadow, NULL); + + return true; +} + +static struct fd_resource * +fd_alloc_staging(struct fd_context *ctx, struct fd_resource *rsc, + unsigned level, const struct pipe_box *box) +{ + struct pipe_context *pctx = &ctx->base; + struct pipe_resource tmpl = rsc->base; + + tmpl.width0 = box->width; + tmpl.height0 = box->height; + tmpl.depth0 = box->depth; + tmpl.array_size = 1; + tmpl.last_level = 0; + tmpl.bind |= PIPE_BIND_LINEAR; + + struct pipe_resource *pstaging = + pctx->screen->resource_create(pctx->screen, &tmpl); + if (!pstaging) + return NULL; + + return fd_resource(pstaging); } static void -fd_resource_flush(struct fd_transfer *trans, const struct pipe_box *box) +fd_blit_from_staging(struct fd_context *ctx, struct fd_transfer *trans) { - enum pipe_format format = trans->base.resource->format; + struct pipe_resource *dst = trans->base.resource; + struct pipe_blit_info blit = {0}; + + blit.dst.resource = dst; + blit.dst.format = dst->format; + blit.dst.level = trans->base.level; + blit.dst.box = trans->base.box; + blit.src.resource = trans->staging_prsc; + blit.src.format = trans->staging_prsc->format; + blit.src.level = 0; + blit.src.box = trans->staging_box; + blit.mask = util_format_get_mask(trans->staging_prsc->format); + blit.filter = PIPE_TEX_FILTER_NEAREST; + + do_blit(ctx, &blit, false); +} - switch (format) { - case PIPE_FORMAT_Z32_FLOAT_S8X24_UINT: - case PIPE_FORMAT_X32_S8X24_UINT: - fd_resource_flush_z32s8(trans, box); - break; - case PIPE_FORMAT_RGTC1_UNORM: - case PIPE_FORMAT_RGTC1_SNORM: - case PIPE_FORMAT_RGTC2_UNORM: - case PIPE_FORMAT_RGTC2_SNORM: - case PIPE_FORMAT_LATC1_UNORM: - case PIPE_FORMAT_LATC1_SNORM: - case PIPE_FORMAT_LATC2_UNORM: - case PIPE_FORMAT_LATC2_SNORM: - fd_resource_flush_rgtc(trans, box); - break; - default: - assert(!"Unexpected staging transfer type"); - break; - } +static void +fd_blit_to_staging(struct fd_context *ctx, struct fd_transfer *trans) +{ + struct pipe_resource *src = trans->base.resource; + struct pipe_blit_info blit = {0}; + + blit.src.resource = src; + blit.src.format = src->format; + blit.src.level = trans->base.level; + blit.src.box = trans->base.box; + blit.dst.resource = trans->staging_prsc; + blit.dst.format = trans->staging_prsc->format; + blit.dst.level = 0; + blit.dst.box = trans->staging_box; + blit.mask = util_format_get_mask(trans->staging_prsc->format); + blit.filter = PIPE_TEX_FILTER_NEAREST; + + do_blit(ctx, &blit, false); +} + +static unsigned +fd_resource_layer_offset(struct fd_resource *rsc, + struct fd_resource_slice *slice, + unsigned layer) +{ + if (rsc->layer_first) + return layer * rsc->layer_size; + else + return layer * slice->size0; } static void fd_resource_transfer_flush_region(struct pipe_context *pctx, @@ -234,15 +356,56 @@ static void fd_resource_transfer_flush_region(struct pipe_context *pctx, const struct pipe_box *box) { struct fd_resource *rsc = fd_resource(ptrans->resource); - struct fd_transfer *trans = fd_transfer(ptrans); if (ptrans->resource->target == PIPE_BUFFER) util_range_add(&rsc->valid_buffer_range, ptrans->box.x + box->x, ptrans->box.x + box->x + box->width); +} + +static void +flush_resource(struct fd_context *ctx, struct fd_resource *rsc, unsigned usage) +{ + struct fd_batch *write_batch = NULL; - if (trans->staging) - fd_resource_flush(trans, box); + fd_batch_reference(&write_batch, rsc->write_batch); + + if (usage & PIPE_TRANSFER_WRITE) { + struct fd_batch *batch, *batches[32] = {0}; + uint32_t batch_mask; + + /* This is a bit awkward, probably a fd_batch_flush_locked() + * would make things simpler.. but we need to hold the lock + * to iterate the batches which reference this resource. So + * we must first grab references under a lock, then flush. + */ + mtx_lock(&ctx->screen->lock); + batch_mask = rsc->batch_mask; + foreach_batch(batch, &ctx->screen->batch_cache, batch_mask) + fd_batch_reference(&batches[batch->idx], batch); + mtx_unlock(&ctx->screen->lock); + + foreach_batch(batch, &ctx->screen->batch_cache, batch_mask) + fd_batch_flush(batch, false, false); + + foreach_batch(batch, &ctx->screen->batch_cache, batch_mask) { + fd_batch_sync(batch); + fd_batch_reference(&batches[batch->idx], NULL); + } + assert(rsc->batch_mask == 0); + } else if (write_batch) { + fd_batch_flush(write_batch, true, false); + } + + fd_batch_reference(&write_batch, NULL); + + assert(!rsc->write_batch); +} + +static void +fd_flush_resource(struct pipe_context *pctx, struct pipe_resource *prsc) +{ + flush_resource(fd_context(pctx), fd_resource(prsc), PIPE_TRANSFER_READ); } static void @@ -253,16 +416,14 @@ fd_resource_transfer_unmap(struct pipe_context *pctx, struct fd_resource *rsc = fd_resource(ptrans->resource); struct fd_transfer *trans = fd_transfer(ptrans); - if (trans->staging && !(ptrans->usage & PIPE_TRANSFER_FLUSH_EXPLICIT)) { - struct pipe_box box; - u_box_2d(0, 0, ptrans->box.width, ptrans->box.height, &box); - fd_resource_flush(trans, &box); + if (trans->staging_prsc) { + if (ptrans->usage & PIPE_TRANSFER_WRITE) + fd_blit_from_staging(ctx, trans); + pipe_resource_reference(&trans->staging_prsc, NULL); } if (!(ptrans->usage & PIPE_TRANSFER_UNSYNCHRONIZED)) { fd_bo_cpu_fini(rsc->bo); - if (rsc->stencil) - fd_bo_cpu_fini(rsc->stencil->bo); } util_range_add(&rsc->valid_buffer_range, @@ -270,9 +431,7 @@ fd_resource_transfer_unmap(struct pipe_context *pctx, ptrans->box.x + ptrans->box.width); pipe_resource_reference(&ptrans->resource, NULL); - util_slab_free(&ctx->transfer_pool, ptrans); - - free(trans->staging); + slab_free(&ctx->transfer_pool, ptrans); } static void * @@ -296,11 +455,11 @@ fd_resource_transfer_map(struct pipe_context *pctx, DBG("prsc=%p, level=%u, usage=%x, box=%dx%d+%d,%d", prsc, level, usage, box->width, box->height, box->x, box->y); - ptrans = util_slab_alloc(&ctx->transfer_pool); + ptrans = slab_alloc(&ctx->transfer_pool); if (!ptrans) return NULL; - /* util_slab_alloc() doesn't zero: */ + /* slab_alloc_st() doesn't zero: */ trans = fd_transfer(ptrans); memset(trans, 0, sizeof(*trans)); @@ -311,6 +470,47 @@ fd_resource_transfer_map(struct pipe_context *pctx, ptrans->stride = util_format_get_nblocksx(format, slice->pitch) * rsc->cpp; ptrans->layer_stride = rsc->layer_first ? rsc->layer_size : slice->size0; + /* we always need a staging texture for tiled buffers: + * + * TODO we might sometimes want to *also* shadow the resource to avoid + * splitting a batch.. for ex, mid-frame texture uploads to a tiled + * texture. + */ + if (rsc->tile_mode) { + struct fd_resource *staging_rsc; + + staging_rsc = fd_alloc_staging(ctx, rsc, level, box); + if (staging_rsc) { + // TODO for PIPE_TRANSFER_READ, need to do untiling blit.. + trans->staging_prsc = &staging_rsc->base; + trans->base.stride = util_format_get_nblocksx(format, + staging_rsc->slices[0].pitch) * staging_rsc->cpp; + trans->base.layer_stride = staging_rsc->layer_first ? + staging_rsc->layer_size : staging_rsc->slices[0].size0; + trans->staging_box = *box; + trans->staging_box.x = 0; + trans->staging_box.y = 0; + trans->staging_box.z = 0; + + if (usage & PIPE_TRANSFER_READ) { + fd_blit_to_staging(ctx, trans); + fd_bo_cpu_prep(rsc->bo, ctx->pipe, DRM_FREEDRENO_PREP_READ); + } + + buf = fd_bo_map(staging_rsc->bo); + offset = 0; + + *pptrans = ptrans; + + ctx->stats.staging_uploads++; + + return buf; + } + } + + if (ctx->in_shadow && !(usage & PIPE_TRANSFER_READ)) + usage |= PIPE_TRANSFER_UNSYNCHRONIZED; + if (usage & PIPE_TRANSFER_READ) op |= DRM_FREEDRENO_PREP_READ; @@ -319,9 +519,7 @@ fd_resource_transfer_map(struct pipe_context *pctx, if (usage & PIPE_TRANSFER_DISCARD_WHOLE_RESOURCE) { realloc_bo(rsc, fd_bo_size(rsc->bo)); - if (rsc->stencil) - realloc_bo(rsc->stencil, fd_bo_size(rsc->stencil->bo)); - fd_invalidate_resource(ctx, prsc); + rebind_resource(ctx, prsc); } else if ((usage & PIPE_TRANSFER_WRITE) && prsc->target == PIPE_BUFFER && !util_ranges_intersect(&rsc->valid_buffer_range, @@ -330,131 +528,104 @@ fd_resource_transfer_map(struct pipe_context *pctx, * to wait. */ } else if (!(usage & PIPE_TRANSFER_UNSYNCHRONIZED)) { + struct fd_batch *write_batch = NULL; + + /* hold a reference, so it doesn't disappear under us: */ + fd_batch_reference(&write_batch, rsc->write_batch); + + if ((usage & PIPE_TRANSFER_WRITE) && write_batch && + write_batch->back_blit) { + /* if only thing pending is a back-blit, we can discard it: */ + fd_batch_reset(write_batch); + } + /* If the GPU is writing to the resource, or if it is reading from the * resource and we're trying to write to it, flush the renders. */ - if (((ptrans->usage & PIPE_TRANSFER_WRITE) && - pending(rsc, true)) || - pending(rsc, false)) { - if (usage & PIPE_TRANSFER_WRITE) { - struct fd_batch *batch; - foreach_batch(batch, &ctx->screen->batch_cache, rsc->batch_mask) { - fd_batch_flush(batch); - } - assert(rsc->batch_mask == 0); + bool needs_flush = pending(rsc, !!(usage & PIPE_TRANSFER_WRITE)); + bool busy = needs_flush || (0 != fd_bo_cpu_prep(rsc->bo, + ctx->pipe, op | DRM_FREEDRENO_PREP_NOSYNC)); + + /* if we need to flush/stall, see if we can make a shadow buffer + * to avoid this: + * + * TODO we could go down this path !reorder && !busy_for_read + * ie. we only *don't* want to go down this path if the blit + * will trigger a flush! + */ + if (ctx->screen->reorder && busy && !(usage & PIPE_TRANSFER_READ) && + (usage & PIPE_TRANSFER_DISCARD_RANGE)) { + /* try shadowing only if it avoids a flush, otherwise staging would + * be better: + */ + if (needs_flush && fd_try_shadow_resource(ctx, rsc, level, box)) { + needs_flush = busy = false; + rebind_resource(ctx, prsc); + ctx->stats.shadow_uploads++; } else { - fd_batch_flush(rsc->write_batch); + struct fd_resource *staging_rsc; + + if (needs_flush) { + flush_resource(ctx, rsc, usage); + needs_flush = false; + } + + /* in this case, we don't need to shadow the whole resource, + * since any draw that references the previous contents has + * already had rendering flushed for all tiles. So we can + * use a staging buffer to do the upload. + */ + staging_rsc = fd_alloc_staging(ctx, rsc, level, box); + if (staging_rsc) { + trans->staging_prsc = &staging_rsc->base; + trans->base.stride = util_format_get_nblocksx(format, + staging_rsc->slices[0].pitch) * staging_rsc->cpp; + trans->base.layer_stride = staging_rsc->layer_first ? + staging_rsc->layer_size : staging_rsc->slices[0].size0; + trans->staging_box = *box; + trans->staging_box.x = 0; + trans->staging_box.y = 0; + trans->staging_box.z = 0; + buf = fd_bo_map(staging_rsc->bo); + offset = 0; + + *pptrans = ptrans; + + fd_batch_reference(&write_batch, NULL); + + ctx->stats.staging_uploads++; + + return buf; + } } } + if (needs_flush) { + flush_resource(ctx, rsc, usage); + needs_flush = false; + } + + fd_batch_reference(&write_batch, NULL); + /* The GPU keeps track of how the various bo's are being used, and * will wait if necessary for the proper operation to have * completed. */ - ret = fd_bo_cpu_prep(rsc->bo, ctx->screen->pipe, op); - if (ret) - goto fail; + if (busy) { + ret = fd_bo_cpu_prep(rsc->bo, ctx->pipe, op); + if (ret) + goto fail; + } } buf = fd_bo_map(rsc->bo); - if (!buf) - goto fail; - offset = slice->offset + box->y / util_format_get_blockheight(format) * ptrans->stride + box->x / util_format_get_blockwidth(format) * rsc->cpp + fd_resource_layer_offset(rsc, slice, box->z); - if (prsc->format == PIPE_FORMAT_Z32_FLOAT_S8X24_UINT || - prsc->format == PIPE_FORMAT_X32_S8X24_UINT) { - assert(trans->base.box.depth == 1); - - trans->base.stride = trans->base.box.width * rsc->cpp * 2; - trans->staging = malloc(trans->base.stride * trans->base.box.height); - if (!trans->staging) - goto fail; - - /* if we're not discarding the whole range (or resource), we must copy - * the real data in. - */ - if (!(usage & (PIPE_TRANSFER_DISCARD_WHOLE_RESOURCE | - PIPE_TRANSFER_DISCARD_RANGE))) { - struct fd_resource_slice *sslice = - fd_resource_slice(rsc->stencil, level); - void *sbuf = fd_bo_map(rsc->stencil->bo); - if (!sbuf) - goto fail; - - float *depth = (float *)(buf + slice->offset + - fd_resource_layer_offset(rsc, slice, box->z) + - box->y * slice->pitch * 4 + box->x * 4); - uint8_t *stencil = sbuf + sslice->offset + - fd_resource_layer_offset(rsc->stencil, sslice, box->z) + - box->y * sslice->pitch + box->x; - - if (format != PIPE_FORMAT_X32_S8X24_UINT) - util_format_z32_float_s8x24_uint_pack_z_float( - trans->staging, trans->base.stride, - depth, slice->pitch * 4, - box->width, box->height); - - util_format_z32_float_s8x24_uint_pack_s_8uint( - trans->staging, trans->base.stride, - stencil, sslice->pitch, - box->width, box->height); - } - - buf = trans->staging; - offset = 0; - } else if (rsc->internal_format != format && - util_format_description(format)->layout == UTIL_FORMAT_LAYOUT_RGTC) { - assert(trans->base.box.depth == 1); - - trans->base.stride = util_format_get_stride( - format, trans->base.box.width); - trans->staging = malloc( - util_format_get_2d_size(format, trans->base.stride, - trans->base.box.height)); - if (!trans->staging) - goto fail; - - /* if we're not discarding the whole range (or resource), we must copy - * the real data in. - */ - if (!(usage & (PIPE_TRANSFER_DISCARD_WHOLE_RESOURCE | - PIPE_TRANSFER_DISCARD_RANGE))) { - uint8_t *rgba8 = (uint8_t *)buf + slice->offset + - fd_resource_layer_offset(rsc, slice, box->z) + - box->y * slice->pitch * rsc->cpp + box->x * rsc->cpp; - - switch (format) { - case PIPE_FORMAT_RGTC1_UNORM: - case PIPE_FORMAT_RGTC1_SNORM: - case PIPE_FORMAT_LATC1_UNORM: - case PIPE_FORMAT_LATC1_SNORM: - util_format_rgtc1_unorm_pack_rgba_8unorm( - trans->staging, trans->base.stride, - rgba8, slice->pitch * rsc->cpp, - box->width, box->height); - break; - case PIPE_FORMAT_RGTC2_UNORM: - case PIPE_FORMAT_RGTC2_SNORM: - case PIPE_FORMAT_LATC2_UNORM: - case PIPE_FORMAT_LATC2_SNORM: - util_format_rgtc2_unorm_pack_rgba_8unorm( - trans->staging, trans->base.stride, - rgba8, slice->pitch * rsc->cpp, - box->width, box->height); - break; - default: - assert(!"Unexpected format"); - break; - } - } - - buf = trans->staging; - offset = 0; - } + if (usage & PIPE_TRANSFER_WRITE) + rsc->valid = true; *pptrans = ptrans; @@ -479,8 +650,10 @@ fd_resource_destroy(struct pipe_screen *pscreen, static boolean fd_resource_get_handle(struct pipe_screen *pscreen, + struct pipe_context *pctx, struct pipe_resource *prsc, - struct winsys_handle *handle) + struct winsys_handle *handle, + unsigned usage) { struct fd_resource *rsc = fd_resource(prsc); @@ -488,20 +661,13 @@ fd_resource_get_handle(struct pipe_screen *pscreen, rsc->slices[0].pitch * rsc->cpp, handle); } - -static const struct u_resource_vtbl fd_resource_vtbl = { - .resource_get_handle = fd_resource_get_handle, - .resource_destroy = fd_resource_destroy, - .transfer_map = fd_resource_transfer_map, - .transfer_flush_region = fd_resource_transfer_flush_region, - .transfer_unmap = fd_resource_transfer_unmap, -}; - static uint32_t setup_slices(struct fd_resource *rsc, uint32_t alignment, enum pipe_format format) { - struct pipe_resource *prsc = &rsc->base.b; + struct pipe_resource *prsc = &rsc->base; + struct fd_screen *screen = fd_screen(prsc->screen); enum util_format_layout layout = util_format_description(format)->layout; + uint32_t pitchalign = screen->gmem_alignw; uint32_t level, size = 0; uint32_t width = prsc->width0; uint32_t height = prsc->height0; @@ -517,9 +683,9 @@ setup_slices(struct fd_resource *rsc, uint32_t alignment, enum pipe_format forma if (layout == UTIL_FORMAT_LAYOUT_ASTC) slice->pitch = width = - util_align_npot(width, 32 * util_format_get_blockwidth(format)); + util_align_npot(width, pitchalign * util_format_get_blockwidth(format)); else - slice->pitch = width = align(width, 32); + slice->pitch = width = align(width, pitchalign); slice->offset = size; blocks = util_format_get_nblocks(format, width, height); /* 1d array and 2d array textures must all have the same layer size @@ -548,12 +714,12 @@ setup_slices(struct fd_resource *rsc, uint32_t alignment, enum pipe_format forma } static uint32_t -slice_alignment(struct pipe_screen *pscreen, const struct pipe_resource *tmpl) +slice_alignment(enum pipe_texture_target target) { /* on a3xx, 2d array and 3d textures seem to want their * layers aligned to page boundaries: */ - switch (tmpl->target) { + switch (target) { case PIPE_TEXTURE_3D: case PIPE_TEXTURE_1D_ARRAY: case PIPE_TEXTURE_2D_ARRAY: @@ -563,6 +729,69 @@ slice_alignment(struct pipe_screen *pscreen, const struct pipe_resource *tmpl) } } +/* cross generation texture layout to plug in to screen->setup_slices().. + * replace with generation specific one as-needed. + * + * TODO for a4xx probably can extract out the a4xx specific logic int + * a small fd4_setup_slices() wrapper that sets up layer_first, and then + * calls this. + */ +uint32_t +fd_setup_slices(struct fd_resource *rsc) +{ + uint32_t alignment; + + alignment = slice_alignment(rsc->base.target); + + struct fd_screen *screen = fd_screen(rsc->base.screen); + if (is_a4xx(screen)) { + switch (rsc->base.target) { + case PIPE_TEXTURE_3D: + rsc->layer_first = false; + break; + default: + rsc->layer_first = true; + alignment = 1; + break; + } + } + + return setup_slices(rsc, alignment, rsc->base.format); +} + +/* special case to resize query buf after allocated.. */ +void +fd_resource_resize(struct pipe_resource *prsc, uint32_t sz) +{ + struct fd_resource *rsc = fd_resource(prsc); + + debug_assert(prsc->width0 == 0); + debug_assert(prsc->target == PIPE_BUFFER); + debug_assert(prsc->bind == PIPE_BIND_QUERY_BUFFER); + + prsc->width0 = sz; + realloc_bo(rsc, fd_screen(prsc->screen)->setup_slices(rsc)); +} + +// TODO common helper? +static bool +has_depth(enum pipe_format format) +{ + switch (format) { + case PIPE_FORMAT_Z16_UNORM: + case PIPE_FORMAT_Z32_UNORM: + case PIPE_FORMAT_Z32_FLOAT: + case PIPE_FORMAT_Z32_FLOAT_S8X24_UINT: + case PIPE_FORMAT_Z24_UNORM_S8_UINT: + case PIPE_FORMAT_S8_UINT_Z24_UNORM: + case PIPE_FORMAT_Z24X8_UNORM: + case PIPE_FORMAT_X8Z24_UNORM: + return true; + default: + return false; + } +} + /** * Create a new texture object, using the given template info. */ @@ -570,10 +799,11 @@ static struct pipe_resource * fd_resource_create(struct pipe_screen *pscreen, const struct pipe_resource *tmpl) { + struct fd_screen *screen = fd_screen(pscreen); struct fd_resource *rsc = CALLOC_STRUCT(fd_resource); - struct pipe_resource *prsc = &rsc->base.b; + struct pipe_resource *prsc = &rsc->base; enum pipe_format format = tmpl->format; - uint32_t size, alignment; + uint32_t size; DBG("%p: target=%d, format=%s, %ux%ux%u, array_size=%u, last_level=%u, " "nr_samples=%u, usage=%u, bind=%x, flags=%x", prsc, @@ -587,38 +817,57 @@ fd_resource_create(struct pipe_screen *pscreen, *prsc = *tmpl; +#define LINEAR \ + (PIPE_BIND_SCANOUT | \ + PIPE_BIND_LINEAR | \ + PIPE_BIND_DISPLAY_TARGET) + + if (screen->tile_mode && + (tmpl->target != PIPE_BUFFER) && + (tmpl->bind & PIPE_BIND_SAMPLER_VIEW) && + !(tmpl->bind & LINEAR)) { + rsc->tile_mode = screen->tile_mode(tmpl); + } + pipe_reference_init(&prsc->reference, 1); prsc->screen = pscreen; util_range_init(&rsc->valid_buffer_range); - rsc->base.vtbl = &fd_resource_vtbl; - - if (format == PIPE_FORMAT_Z32_FLOAT_S8X24_UINT) - format = PIPE_FORMAT_Z32_FLOAT; - else if (fd_screen(pscreen)->gpu_id < 400 && - util_format_description(format)->layout == UTIL_FORMAT_LAYOUT_RGTC) - format = PIPE_FORMAT_R8G8B8A8_UNORM; rsc->internal_format = format; rsc->cpp = util_format_get_blocksize(format); + prsc->nr_samples = MAX2(1, prsc->nr_samples); + rsc->cpp *= prsc->nr_samples; assert(rsc->cpp); - alignment = slice_alignment(pscreen, tmpl); - if (is_a4xx(fd_screen(pscreen))) { - switch (tmpl->target) { - case PIPE_TEXTURE_3D: - rsc->layer_first = false; - break; - default: - rsc->layer_first = true; - alignment = 1; - break; - } + // XXX probably need some extra work if we hit rsc shadowing path w/ lrz.. + if (is_a5xx(screen) && (fd_mesa_debug & FD_DBG_LRZ) && has_depth(format)) { + const uint32_t flags = DRM_FREEDRENO_GEM_CACHE_WCOMBINE | + DRM_FREEDRENO_GEM_TYPE_KMEM; /* TODO */ + unsigned lrz_pitch = align(DIV_ROUND_UP(tmpl->width0, 8), 32); + unsigned lrz_height = DIV_ROUND_UP(tmpl->height0, 8); + unsigned size = lrz_pitch * lrz_height * 2; + + size += 0x1000; /* for GRAS_LRZ_FAST_CLEAR_BUFFER */ + + rsc->lrz_height = lrz_height; + rsc->lrz_width = lrz_pitch; + rsc->lrz_pitch = lrz_pitch; + rsc->lrz = fd_bo_new(screen->dev, size, flags); } - size = setup_slices(rsc, alignment, format); + size = screen->setup_slices(rsc); + + /* special case for hw-query buffer, which we need to allocate before we + * know the size: + */ + if (size == 0) { + /* note, semi-intention == instead of & */ + debug_assert(prsc->bind == PIPE_BIND_QUERY_BUFFER); + return prsc; + } if (rsc->layer_first) { rsc->layer_size = align(size, 4096); @@ -629,19 +878,6 @@ fd_resource_create(struct pipe_screen *pscreen, if (!rsc->bo) goto fail; - /* There is no native Z32F_S8 sampling or rendering format, so this must - * be emulated via two separate textures. The depth texture still keeps - * its Z32F_S8 format though, and we also keep a reference to a separate - * S8 texture. - */ - if (tmpl->format == PIPE_FORMAT_Z32_FLOAT_S8X24_UINT) { - struct pipe_resource stencil = *tmpl; - stencil.format = PIPE_FORMAT_S8_UINT; - rsc->stencil = fd_resource(fd_resource_create(pscreen, &stencil)); - if (!rsc->stencil) - goto fail; - } - return prsc; fail: fd_resource_destroy(pscreen, prsc); @@ -660,7 +896,8 @@ fd_resource_from_handle(struct pipe_screen *pscreen, { struct fd_resource *rsc = CALLOC_STRUCT(fd_resource); struct fd_resource_slice *slice = &rsc->slices[0]; - struct pipe_resource *prsc = &rsc->base.b; + struct pipe_resource *prsc = &rsc->base; + uint32_t pitchalign = fd_screen(pscreen)->gmem_alignw; DBG("target=%d, format=%s, %ux%ux%u, array_size=%u, last_level=%u, " "nr_samples=%u, usage=%u, bind=%x, flags=%x", @@ -680,14 +917,20 @@ fd_resource_from_handle(struct pipe_screen *pscreen, util_range_init(&rsc->valid_buffer_range); - rsc->bo = fd_screen_bo_from_handle(pscreen, handle, &slice->pitch); + rsc->bo = fd_screen_bo_from_handle(pscreen, handle); if (!rsc->bo) goto fail; - rsc->base.vtbl = &fd_resource_vtbl; - rsc->cpp = util_format_get_blocksize(tmpl->format); - slice->pitch /= rsc->cpp; + prsc->nr_samples = MAX2(1, prsc->nr_samples); + rsc->internal_format = tmpl->format; + rsc->cpp = prsc->nr_samples * util_format_get_blocksize(tmpl->format); + slice->pitch = handle->stride / rsc->cpp; slice->offset = handle->offset; + slice->size0 = handle->stride * prsc->height0; + + if ((slice->pitch < align(prsc->width0, pitchalign)) || + (slice->pitch & (pitchalign - 1))) + goto fail; assert(rsc->cpp); @@ -698,9 +941,6 @@ fail: return NULL; } -static void fd_blitter_pipe_begin(struct fd_context *ctx, bool render_cond); -static void fd_blitter_pipe_end(struct fd_context *ctx); - /** * _copy_region using pipe (3d engine) */ @@ -720,7 +960,8 @@ fd_blitter_pipe_copy_region(struct fd_context *ctx, if (!util_blitter_is_copy_supported(ctx->blitter, dst, src)) return false; - fd_blitter_pipe_begin(ctx, false); + /* TODO we could discard if dst box covers dst level fully.. */ + fd_blitter_pipe_begin(ctx, false, false, FD_STAGE_BLIT); util_blitter_copy_texture(ctx->blitter, dst, dst_level, dstx, dsty, dstz, src, src_level, src_box); @@ -790,18 +1031,18 @@ fd_blit(struct pipe_context *pctx, const struct pipe_blit_info *blit_info) { struct fd_context *ctx = fd_context(pctx); struct pipe_blit_info info = *blit_info; - - if (info.src.resource->nr_samples > 1 && - info.dst.resource->nr_samples <= 1 && - !util_format_is_depth_or_stencil(info.src.resource->format) && - !util_format_is_pure_integer(info.src.resource->format)) { - DBG("color resolve unimplemented"); - return; - } + bool discard = false; if (info.render_condition_enable && !fd_render_condition_check(pctx)) return; + if (!info.scissor_enable && !info.alpha_blend) { + discard = util_texrange_covers_whole_level(info.dst.resource, + info.dst.level, info.dst.box.x, info.dst.box.y, + info.dst.box.z, info.dst.box.width, + info.dst.box.height, info.dst.box.depth); + } + if (util_try_blit_via_copy_region(pctx, &info)) { return; /* done */ } @@ -818,14 +1059,17 @@ fd_blit(struct pipe_context *pctx, const struct pipe_blit_info *blit_info) return; } - fd_blitter_pipe_begin(ctx, info.render_condition_enable); - util_blitter_blit(ctx->blitter, &info); + fd_blitter_pipe_begin(ctx, info.render_condition_enable, discard, FD_STAGE_BLIT); + ctx->blit(ctx, &info); fd_blitter_pipe_end(ctx); } -static void -fd_blitter_pipe_begin(struct fd_context *ctx, bool render_cond) +void +fd_blitter_pipe_begin(struct fd_context *ctx, bool render_cond, bool discard, + enum fd_render_stage stage) { + util_blitter_save_fragment_constant_buffer_slot(ctx->blitter, + ctx->constbuf[PIPE_SHADER_FRAGMENT].cb); util_blitter_save_vertex_buffer_slot(ctx->blitter, ctx->vtx.vertexbuf.vb); util_blitter_save_vertex_elements(ctx->blitter, ctx->vtx.vtx); util_blitter_save_vertex_shader(ctx->blitter, ctx->prog.vp); @@ -842,54 +1086,120 @@ fd_blitter_pipe_begin(struct fd_context *ctx, bool render_cond) util_blitter_save_framebuffer(ctx->blitter, ctx->batch ? &ctx->batch->framebuffer : NULL); util_blitter_save_fragment_sampler_states(ctx->blitter, - ctx->fragtex.num_samplers, - (void **)ctx->fragtex.samplers); + ctx->tex[PIPE_SHADER_FRAGMENT].num_samplers, + (void **)ctx->tex[PIPE_SHADER_FRAGMENT].samplers); util_blitter_save_fragment_sampler_views(ctx->blitter, - ctx->fragtex.num_textures, ctx->fragtex.textures); + ctx->tex[PIPE_SHADER_FRAGMENT].num_textures, + ctx->tex[PIPE_SHADER_FRAGMENT].textures); if (!render_cond) util_blitter_save_render_condition(ctx->blitter, ctx->cond_query, ctx->cond_cond, ctx->cond_mode); - fd_hw_query_set_stage(ctx, ctx->batch->draw, FD_STAGE_BLIT); + if (ctx->batch) + fd_batch_set_stage(ctx->batch, stage); + + ctx->in_blit = discard; } -static void +void fd_blitter_pipe_end(struct fd_context *ctx) { - fd_hw_query_set_stage(ctx, ctx->batch->draw, FD_STAGE_NULL); + if (ctx->batch) + fd_batch_set_stage(ctx->batch, FD_STAGE_NULL); + ctx->in_blit = false; } static void -fd_flush_resource(struct pipe_context *pctx, struct pipe_resource *prsc) +fd_invalidate_resource(struct pipe_context *pctx, struct pipe_resource *prsc) { struct fd_resource *rsc = fd_resource(prsc); - if (rsc->write_batch) - fd_batch_flush(rsc->write_batch); + /* + * TODO I guess we could track that the resource is invalidated and + * use that as a hint to realloc rather than stall in _transfer_map(), + * even in the non-DISCARD_WHOLE_RESOURCE case? + */ - assert(!rsc->write_batch); + if (rsc->write_batch) { + struct fd_batch *batch = rsc->write_batch; + struct pipe_framebuffer_state *pfb = &batch->framebuffer; + + if (pfb->zsbuf && pfb->zsbuf->texture == prsc) + batch->resolve &= ~(FD_BUFFER_DEPTH | FD_BUFFER_STENCIL); + + for (unsigned i = 0; i < pfb->nr_cbufs; i++) { + if (pfb->cbufs[i] && pfb->cbufs[i]->texture == prsc) { + batch->resolve &= ~(PIPE_CLEAR_COLOR0 << i); + } + } + } + + rsc->valid = false; +} + +static enum pipe_format +fd_resource_get_internal_format(struct pipe_resource *prsc) +{ + return fd_resource(prsc)->internal_format; +} + +static void +fd_resource_set_stencil(struct pipe_resource *prsc, + struct pipe_resource *stencil) +{ + fd_resource(prsc)->stencil = fd_resource(stencil); +} + +static struct pipe_resource * +fd_resource_get_stencil(struct pipe_resource *prsc) +{ + struct fd_resource *rsc = fd_resource(prsc); + if (rsc->stencil) + return &rsc->stencil->base; + return NULL; } +static const struct u_transfer_vtbl transfer_vtbl = { + .resource_create = fd_resource_create, + .resource_destroy = fd_resource_destroy, + .transfer_map = fd_resource_transfer_map, + .transfer_flush_region = fd_resource_transfer_flush_region, + .transfer_unmap = fd_resource_transfer_unmap, + .get_internal_format = fd_resource_get_internal_format, + .set_stencil = fd_resource_set_stencil, + .get_stencil = fd_resource_get_stencil, +}; + void fd_resource_screen_init(struct pipe_screen *pscreen) { - pscreen->resource_create = fd_resource_create; + struct fd_screen *screen = fd_screen(pscreen); + bool fake_rgtc = screen->gpu_id < 400; + + pscreen->resource_create = u_transfer_helper_resource_create; pscreen->resource_from_handle = fd_resource_from_handle; - pscreen->resource_get_handle = u_resource_get_handle_vtbl; - pscreen->resource_destroy = u_resource_destroy_vtbl; + pscreen->resource_get_handle = fd_resource_get_handle; + pscreen->resource_destroy = u_transfer_helper_resource_destroy; + + pscreen->transfer_helper = u_transfer_helper_create(&transfer_vtbl, + true, fake_rgtc, true); + + if (!screen->setup_slices) + screen->setup_slices = fd_setup_slices; } void fd_resource_context_init(struct pipe_context *pctx) { - pctx->transfer_map = u_transfer_map_vtbl; - pctx->transfer_flush_region = u_transfer_flush_region_vtbl; - pctx->transfer_unmap = u_transfer_unmap_vtbl; + pctx->transfer_map = u_transfer_helper_transfer_map; + pctx->transfer_flush_region = u_transfer_helper_transfer_flush_region; + pctx->transfer_unmap = u_transfer_helper_transfer_unmap; pctx->buffer_subdata = u_default_buffer_subdata; - pctx->texture_subdata = u_default_texture_subdata; + pctx->texture_subdata = u_default_texture_subdata; pctx->create_surface = fd_create_surface; pctx->surface_destroy = fd_surface_destroy; pctx->resource_copy_region = fd_resource_copy_region; pctx->blit = fd_blit; pctx->flush_resource = fd_flush_resource; + pctx->invalidate_resource = fd_invalidate_resource; }