gallium: Change the resource_copy_region semantics to allow copies between different...
authorJosé Fonseca <jfonseca@vmware.com>
Mon, 13 Sep 2010 10:14:54 +0000 (11:14 +0100)
committerJosé Fonseca <jfonseca@vmware.com>
Mon, 13 Sep 2010 10:33:44 +0000 (11:33 +0100)
src/gallium/docs/source/context.rst

index 8250c30..5342fc2 100644 (file)
@@ -263,9 +263,11 @@ apart from any 3D state in the context.  Blitting functionality may be
 moved to a separate abstraction at some point in the future.
 
 ``resource_copy_region`` blits a region of a subresource of a resource to a
-region of another subresource of a resource, provided that both resources have the
-same format. The source and destination may be the same resource, but overlapping
-blits are not permitted.
+region of another subresource of a resource, provided that both resources have
+the same format, or compatible formats, i.e., formats for which copying the
+bytes from the source resource unmodified to the destination resource will
+achieve the same effect of a textured quad blitter. The source and destination
+may be the same resource, but overlapping blits are not permitted.
 
 ``resource_resolve`` resolves a multisampled resource into a non-multisampled
 one. Formats and dimensions must match. This function must be present if a driver