sct.h File Reference

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	surface_context_tracker
	Per-device info, basically. More...
struct	sct_context_list
	Simple linked list of contexts. More...
Functions
void	sct_bind_surfaces (struct surface_context_tracker *sct, struct pipe_context *context, uint num_surf, struct pipe_surface **surfaces)
	Bind context to a set of surfaces (color + Z).
void	sct_bind_texture (struct surface_context_tracker *sct, struct pipe_context *context, uint unit, struct pipe_texture *texture)
	Bind a texture to a rendering context.
void	sct_update_texture (struct pipe_texture *tex)
	To be called when the image contents of a texture are changed, such as for gl[Copy]TexSubImage().
boolean	sct_is_texture_used (struct surface_context_tracker *sct, const struct pipe_context *context, const struct pipe_texture *texture)
	Check if the given texture has been used by the rendering context since the last call to sct_flush_textures().
void	sct_flush_textures (struct surface_context_tracker *sct, struct pipe_context *context)
	When a scene is flushed/rendered we can release the list of used textures.
struct sct_context_list *	sct_get_surface_contexts (struct surface_context_tracker *sct, const struct pipe_surface *surf)
	Return list of contexts bound to a surface.
void	sct_destroy_context (struct surface_context_tracker *sct, struct pipe_context *context)
void	sct_destroy_surface (struct surface_context_tracker *sct, struct pipe_surface *surface)

---

Function Documentation

void sct_bind_surfaces	(	struct surface_context_tracker *	sct,
		struct pipe_context *	context,
		uint	num_surf,
		struct pipe_surface **	surfaces
	)

Bind context to a set of surfaces (color + Z).

Like MakeCurrent().

Definition at line 238 of file sct.c.

References add_context_to_surface(), find_create_context_info(), find_create_surface_info(), find_surface_context(), MAX_SURFACES, sct_context::surfaces, and unbind_context_surface().

{
   struct sct_context *ci = find_create_context_info(sct, context);
   uint i;

   if (!ci) {
      return; /* out of memory */
   }

   /* unbind currently bound surfaces */
   for (i = 0; i < MAX_SURFACES; i++) {
      if (ci->surfaces[i]) {
         unbind_context_surface(sct, context, ci->surfaces[i]);
      }
   }

   /* bind new surfaces */
   for (i = 0; i < num_surf; i++) {
      struct sct_surface *si = find_create_surface_info(sct, surfaces[i]);
      if (!find_surface_context(si, context)) {
         add_context_to_surface(si, context);
      }
   }
}

void sct_bind_texture	(	struct surface_context_tracker *	sct,
		struct pipe_context *	context,
		uint	unit,
		struct pipe_texture *	texture
	)

Bind a texture to a rendering context.

Definition at line 319 of file sct.c.

References add_texture_used(), find_context_info(), pipe_texture_reference(), and sct_context::textures.

{
   struct sct_context *ci = find_context_info(sct, context);

   if (ci->textures[unit] != tex) {
      /* put texture on the 'used' list */
      add_texture_used(ci, tex);
      /* bind new */
      pipe_texture_reference(&ci->textures[unit], tex);
   }
}

void sct_destroy_context	(	struct surface_context_tracker *	sct,
		struct pipe_context *	context
	)

Definition at line 389 of file sct.c.

References sct_context::context, surface_context_tracker::contexts, FREE, sct_context::next, sct_surface::next, remove_context_from_surface(), and surface_context_tracker::surfaces.

{
   /* XXX should we require an unbinding first? */
   {
      struct sct_surface *si;
      for (si = sct->surfaces; si; si = si->next) {
         remove_context_from_surface(si, context);
      }
   }

   /* remove context from context_info list */
   {
      struct sct_context *ci, *next, *prev = NULL;
      for (ci = sct->contexts; ci; ci = next) {
         next = ci->next;
         if (ci->context == context) {
            if (prev)
               prev->next = ci->next;
            else
               sct->contexts = ci->next;
            FREE(ci);
         }
         else {
            prev = ci;
         }
      }
   }

}

void sct_destroy_surface	(	struct surface_context_tracker *	sct,
		struct pipe_surface *	surface
	)

Definition at line 422 of file sct.c.

References assert, surface_context_tracker::contexts, FREE, MAX_SURFACES, sct_surface::next, sct_context::next, sct_surface::surface, surface_context_tracker::surfaces, and sct_context::surfaces.

{
   if (1) {
      /* debug/sanity: no context should be bound to surface */
      struct sct_context *ci;
      uint i;
      for (ci = sct->contexts; ci; ci = ci->next) {
         for (i = 0; i < MAX_SURFACES; i++) {
            assert(ci->surfaces[i] != surface);
         }
      }
   }

   /* remove surface from sct_surface list */
   {
      struct sct_surface *si, *next, *prev = NULL;
      for (si = sct->surfaces; si; si = next) {
         next = si->next;
         if (si->surface == surface) {
            /* unlink */
            if (prev)
               prev->next = si->next;
            else
               sct->surfaces = si->next;
            FREE(si);
         }
         else {
            prev = si;
         }
      }
   }
}

void sct_flush_textures	(	struct surface_context_tracker *	sct,
		struct pipe_context *	context
	)

When a scene is flushed/rendered we can release the list of used textures.

Definition at line 366 of file sct.c.

References add_texture_used(), find_context_info(), FREE, texture_list::next, PIPE_MAX_SAMPLERS, pipe_texture_release(), texture_list::texture, sct_context::textures, and sct_context::textures_used.

{
   struct sct_context *ci = find_context_info(sct, context);
   struct texture_list *tl, *next;
   uint i;

   for (tl = ci->textures_used; tl; tl = next) {
      next = tl->next;
      pipe_texture_release(&tl->texture);
      FREE(tl);
   }
   ci->textures_used = NULL;

   /* put the currently bound textures on the 'used' list */
   for (i = 0; i < PIPE_MAX_SAMPLERS; i++) {
      add_texture_used(ci, ci->textures[i]);
   }
}

struct sct_context_list* sct_get_surface_contexts	(	struct surface_context_tracker *	sct,
		const struct pipe_surface *	surf
	)			[read]

Return list of contexts bound to a surface.

Definition at line 271 of file sct.c.

References sct_surface::contexts, and find_surface_info().

{
   const struct sct_surface *si = find_surface_info(sct, surface);
   return si->contexts;
}

boolean sct_is_texture_used	(	struct surface_context_tracker *	sct,
		const struct pipe_context *	context,
		const struct pipe_texture *	texture
	)

Check if the given texture has been used by the rendering context since the last call to sct_flush_textures().

Definition at line 340 of file sct.c.

References find_context_info(), and find_texture().

{
   const struct sct_context *ci = find_context_info(sct, context);
   return find_texture(ci, texture);
}

void sct_update_texture

(

struct pipe_texture *

tex

)

To be called when the image contents of a texture are changed, such as for gl[Copy]TexSubImage().

XXX this may not be needed

Definition at line 355 of file sct.c.

{

}

---