Mesa (master): gallium: Change the resource_copy_region semantics to allow copies between different yet compatible formats

[Jose Fonseca]

Module: Mesa
Branch: master
Commit: 91a93257615390f75320c27645167d08b82b46b9
URL:    http://cgit.freedesktop.org/mesa/mesa/commit/?id=91a93257615390f75320c27645167d08b82b46b9

Author: José Fonseca <jfonseca at vmware.com>
Date:   Mon Sep 13 11:14:54 2010 +0100

gallium: Change the resource_copy_region semantics to allow copies between different yet compatible formats

---

 src/gallium/docs/source/context.rst |    8 +++++---
 1 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/src/gallium/docs/source/context.rst b/src/gallium/docs/source/context.rst
index 8250c30..5342fc2 100644
--- a/src/gallium/docs/source/context.rst
+++ b/src/gallium/docs/source/context.rst
@@ -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