28  * This file implements the vmwgfx context binding manager,
41  * already killed if a resource to which a binding points
47  * to protect all binding manager data.
50  * (surface, shader or even DX query) is conceptually a context binding that
69  * struct vmw_ctx_binding_state - per context binding state
75  * @ds_view: Depth-stencil view binding.
78  * @index_buffer: Index buffer binding.
82  * @dirty: Bitmap tracking per binding-type changes that have not yet
84  * @dirty_vb: Bitmap tracking individual vertex buffer binding changes that
86  * @bind_cmd_buffer: Scratch space used to construct binding commands.
87  * @bind_cmd_count: Number of binding command data entries in @bind_cmd_buffer
89  * device binding slot of the first command data entry in @bind_cmd_buffer.
139  * struct vmw_binding_info - Per binding type information for the binding
142  * @size: The size of the struct binding derived from a struct vmw_ctx_bindinfo.
144  * of struct bindings for the binding type.
145  * @scrub_func: Pointer to the scrub function for this binding type.
147  * Holds static information to help optimize the binding manager and avoid
158  * location of the struct vmw_ctx_bindinfo slots for each binding type.
273  * context binding state tracker.
275  * @cbs: The context binding state tracker.
279  * binding state tracker. If there are no active bindings, this function
297  * @bt: The binding type.
298  * @shader_slot: The shader slot of the binding. If none, then set to 0.
299  * @slot: The slot of the binding.
312  * vmw_binding_drop: Stop tracking a context binding
314  * @bi: Pointer to binding tracker storage.
316  * Stops tracking a context binding, and re-initializes its storage.
317  * Typically used when the context binding is replaced with a binding to
329  * vmw_binding_add: Start tracking a context binding
331  * @cbs: Pointer to the context binding state tracker.
332  * @bi: Information about the binding to track.
333  * @shader_slot: The shader slot of the binding.
334  * @slot: The slot of the binding.
336  * Starts tracking the binding in the context binding
357  * vmw_binding_cb_offset_update: Update the offset of a cb binding
359  * @cbs: Pointer to the context binding state tracker.
360  * @shader_slot: The shader slot of the binding.
361  * @slot: The slot of the binding.
362  * @offsetInBytes: The new offset of the binding.
364  * Updates the offset of an existing cb binding in the context binding
379  * @cbs: Pointer to the context binding state tracker.
390  * vmw_binding_transfer: Transfer a context binding tracking entry.
392  * @cbs: Pointer to the persistent context binding state tracker.
393  * @from: Staged binding info built during execbuf
394  * @bi: Information about the binding to track.
422  * @cbs: Pointer to the context binding state tracker.
425  * context binding state tracker. Then re-initializes the whole structure.
440  * @cbs: Pointer to the context binding state tracker.
443  * context binding state tracker.
462  * resource binding list
464  * @head: list head of resource binding list
480  * resource binding list
482  * @head: list head of resource binding list
509  * vmw_binding_state_commit - Commit staged binding info
511  * @to:   Staged binding info area to copy into to.
512  * @from: Staged binding info built during execbuf.
514  * Transfers binding info from a temporary structure
537  * @cbs: Pointer to the context binding state tracker.
539  * Walks through the context binding list and rebinds all scrubbed
566  * vmw_binding_scrub_shader - scrub a shader binding from a context.
568  * @bi: single binding information.
573 	struct vmw_ctx_bindinfo_shader *binding =  in vmw_binding_scrub_shader()  local
574 		container_of(bi, typeof(*binding), bi);  in vmw_binding_scrub_shader()
588 	cmd->body.type = binding->shader_slot + SVGA3D_SHADERTYPE_MIN;  in vmw_binding_scrub_shader()
596  * vmw_binding_scrub_render_target - scrub a render target binding
599  * @bi: single binding information.
605 	struct vmw_ctx_bindinfo_view *binding =  in vmw_binding_scrub_render_target()  local
606 		container_of(bi, typeof(*binding), bi);  in vmw_binding_scrub_render_target()
620 	cmd->body.type = binding->slot;  in vmw_binding_scrub_render_target()
630  * vmw_binding_scrub_texture - scrub a texture binding from a context.
632  * @bi: single binding information.
641 	struct vmw_ctx_bindinfo_tex *binding =  in vmw_binding_scrub_texture()  local
642 		container_of(bi, typeof(*binding), bi);  in vmw_binding_scrub_texture()
659 	cmd->body.s1.stage = binding->texture_stage;  in vmw_binding_scrub_texture()
668  * vmw_binding_scrub_dx_shader - scrub a dx shader binding from a context.
670  * @bi: single binding information.
675 	struct vmw_ctx_bindinfo_shader *binding =  in vmw_binding_scrub_dx_shader()  local
676 		container_of(bi, typeof(*binding), bi);  in vmw_binding_scrub_dx_shader()
689 	cmd->body.type = binding->shader_slot + SVGA3D_SHADERTYPE_MIN;  in vmw_binding_scrub_dx_shader()
697  * vmw_binding_scrub_cb - scrub a constant buffer binding from a context.
699  * @bi: single binding information.
704 	struct vmw_ctx_bindinfo_cb *binding =  in vmw_binding_scrub_cb()  local
705 		container_of(bi, typeof(*binding), bi);  in vmw_binding_scrub_cb()
718 	cmd->body.slot = binding->slot;  in vmw_binding_scrub_cb()
719 	cmd->body.type = binding->shader_slot + SVGA3D_SHADERTYPE_MIN;  in vmw_binding_scrub_cb()
721 		cmd->body.offsetInBytes = binding->offset;  in vmw_binding_scrub_cb()
722 		cmd->body.sizeInBytes = binding->size;  in vmw_binding_scrub_cb()
735  * vmw_collect_view_ids - Build view id data for a view binding command
739  * @biv: Pointer to where the binding info array is stored in @cbs
743  * Stops at the first non-existing binding in the @bi array.
768  * vmw_collect_dirty_view_ids - Build view id data for a view binding command
771  * @bi: Pointer to where the binding info array is stored in @cbs
779  * binding, and @cbs->bind_cmd_buffer contains the command data.
810  * vmw_emit_set_sr - Issue delayed DX shader resource binding commands
813  * @shader_slot: The shader slot of the binding.
854  * vmw_emit_set_rt - Issue delayed DX rendertarget binding commands
892  * vmw_collect_so_targets - Build SVGA3dSoTarget data for a binding command
896  * @biso: Pointer to where the binding info array is stored in @cbs
900  * Stops at the first non-existing binding in the @bi array.
933  * vmw_emit_set_so_target - Issue delayed streamout binding commands
968  * vmw_binding_emit_dirty_ps - Issue delayed per shader binding commands
998  * @bi: Pointer to where the binding info array is stored in @cbs
1006  * binding, and @cbs->bind_cmd_buffer contains the command data.
1044  * vmw_emit_set_vb - Issue delayed vertex buffer binding commands
1145  * vmw_binding_emit_dirty - Issue delayed binding commands
1149  * This function issues the delayed binding commands that arise from
1150  * previous scrub / unscrub calls. These binding commands are typically
1195  * vmw_binding_scrub_sr - Schedule a dx shaderresource binding
1198  * @bi: single binding information.
1217  * vmw_binding_scrub_dx_rt - Schedule a dx rendertarget binding
1220  * @bi: single binding information.
1234  * vmw_binding_scrub_so_target - Schedule a dx streamoutput buffer binding
1237  * @bi: single binding information.
1251  * vmw_binding_scrub_vb - Schedule a dx vertex buffer binding
1254  * @bi: single binding information.
1271  * vmw_binding_scrub_ib - scrub a dx index buffer binding from a context
1273  * @bi: single binding information.
1278 	struct vmw_ctx_bindinfo_ib *binding =  in vmw_binding_scrub_ib()  local
1279 		container_of(bi, typeof(*binding), bi);  in vmw_binding_scrub_ib()
1294 		cmd->body.format = binding->format;  in vmw_binding_scrub_ib()
1295 		cmd->body.offset = binding->offset;  in vmw_binding_scrub_ib()
1324  * vmw_binding_scrub_so - Scrub a streamoutput binding from context.
1325  * @bi: Single binding information.
1330 	struct vmw_ctx_bindinfo_so *binding =  in vmw_binding_scrub_so()  local
1331 		container_of(bi, typeof(*binding), bi);  in vmw_binding_scrub_so()
1384  * vmw_binding_state_list - Get the binding list of a
1389  * Returns the binding list which can be used to traverse through the bindings
1402  * Drops all bindings registered in @cbs. No device binding actions are
1414  * vmw_binding_dirtying - Return whether a binding type is dirtying its resource
1415  * @binding_type: The binding type
1418  * context binding referencing it, we need to determine whether that resource
1423  * Return: Whether the binding type dirties the resource its binding points to.