From mboxrd@z Thu Jan 1 00:00:00 1970 From: Daniel Vetter Subject: [PATCH 09/10] drm/doc: Document color space handling Date: Wed, 31 Aug 2016 18:09:12 +0200 Message-ID: <20160831160913.12991-10-daniel.vetter@ffwll.ch> References: <20160831160913.12991-1-daniel.vetter@ffwll.ch> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <20160831160913.12991-1-daniel.vetter@ffwll.ch> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" To: DRI Development Cc: Daniel Vetter , Intel Graphics Development , Daniel Vetter List-Id: dri-devel@lists.freedesktop.org QWdhaW4gbW92ZSBpdCBmcm9tIHRoZSB1bm1haW50YWluYWJsZSBjc3YgaW50byBET0MgZnJlZS1m b3JtIG92ZXJ2aWV3CnNlY3Rpb25zLgoKQ2M6IExpb25lbCBMYW5kd2VybGluIDxsaW9uZWwuZy5s YW5kd2VybGluQGludGVsLmNvbT4KU2lnbmVkLW9mZi1ieTogRGFuaWVsIFZldHRlciA8ZGFuaWVs LnZldHRlckBpbnRlbC5jb20+Ci0tLQogRG9jdW1lbnRhdGlvbi9ncHUvZHJtLWttcy5yc3QgICAg ICAgIHwgMTIgKysrKysrKysrCiBEb2N1bWVudGF0aW9uL2dwdS9rbXMtcHJvcGVydGllcy5jc3Yg fCAgNSAtLS0tCiBkcml2ZXJzL2dwdS9kcm0vZHJtX2NvbG9yX21nbXQuYyAgICAgfCA0OCArKysr KysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysKIGluY2x1ZGUvZHJtL2RybV9jb2xvcl9t Z210LmggICAgICAgICB8IDExICsrKysrKy0tLQogNCBmaWxlcyBjaGFuZ2VkLCA2OCBpbnNlcnRp b25zKCspLCA4IGRlbGV0aW9ucygtKQoKZGlmZiAtLWdpdCBhL0RvY3VtZW50YXRpb24vZ3B1L2Ry bS1rbXMucnN0IGIvRG9jdW1lbnRhdGlvbi9ncHUvZHJtLWttcy5yc3QKaW5kZXggNmJlOGQzMzU5 NjIwLi41M2I4NzJjMTA1ZDIgMTAwNjQ0Ci0tLSBhL0RvY3VtZW50YXRpb24vZ3B1L2RybS1rbXMu cnN0CisrKyBiL0RvY3VtZW50YXRpb24vZ3B1L2RybS1rbXMucnN0CkBAIC0yOTYsNiArMjk2LDE4 IEBAIFBsYW5lIENvbXBvc2l0aW9uIFByb3BlcnRpZXMKIC4uIGtlcm5lbC1kb2M6OiBkcml2ZXJz L2dwdS9kcm0vZHJtX2JsZW5kLmMKICAgIDpleHBvcnQ6CiAKK0NvbG9yIE1hbmFnZW1lbnQgUHJv cGVydGllcworLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tCisKKy4uIGtlcm5lbC1kb2M6OiBk cml2ZXJzL2dwdS9kcm0vZHJtX2NvbG9yX21nbXQuYworICAgOmRvYzogb3ZlcnZpZXcKKworLi4g a2VybmVsLWRvYzo6IGluY2x1ZGUvZHJtL2RybV9jb2xvcl9tZ210LmgKKyAgIDppbnRlcm5hbDoK KworLi4ga2VybmVsLWRvYzo6IGRyaXZlcnMvZ3B1L2RybS9kcm1fY29sb3JfbWdtdC5jCisgICA6 ZXhwb3J0OgorCiBFeGlzdGluZyBLTVMgUHJvcGVydGllcwogLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0KIApkaWZmIC0tZ2l0IGEvRG9jdW1lbnRhdGlvbi9ncHUva21zLXByb3BlcnRpZXMuY3N2IGIv RG9jdW1lbnRhdGlvbi9ncHUva21zLXByb3BlcnRpZXMuY3N2CmluZGV4IDFhYTI0OTNkMWVmOS4u MWE1NzI5YzRhZjY1IDEwMDY0NAotLS0gYS9Eb2N1bWVudGF0aW9uL2dwdS9rbXMtcHJvcGVydGll cy5jc3YKKysrIGIvRG9jdW1lbnRhdGlvbi9ncHUva21zLXByb3BlcnRpZXMuY3N2CkBAIC0yNCwx MSArMjQsNiBAQCBPd25lciBNb2R1bGUvRHJpdmVycyxHcm91cCxQcm9wZXJ0eSBOYW1lLFR5cGUs UHJvcGVydHkgVmFsdWVzLE9iamVjdCBhdHRhY2hlZCxEZQogLCzigJxzdWdnZXN0ZWQgWeKAnSxS QU5HRSwiTWluPTAsIE1heD0weGZmZmZmZmZmIixDb25uZWN0b3IscHJvcGVydHkgdG8gc3VnZ2Vz dCBhbiBZIG9mZnNldCBmb3IgYSBjb25uZWN0b3IKICxPcHRpb25hbCwiIiJhc3BlY3QgcmF0aW8i IiIsRU5VTSwieyAiIk5vbmUiIiwgIiI0OjMiIiwgIiIxNjo5IiIgfSIsQ29ubmVjdG9yLFREQgog LCzigJxkaXJ0eeKAnSxFTlVNIHwgSU1NVVRBQkxFLCJ7ICIiT2ZmIiIsICIiT24iIiwgIiJBbm5v dGF0ZSIiIH0iLENvbm5lY3RvcixUQkQKLSws4oCcREVHQU1NQV9MVVTigJ0sQkxPQiwwLENSVEMs RFJNIHByb3BlcnR5IHRvIHNldCB0aGUgZGVnYW1tYSBsb29rdXAgdGFibGUgKExVVCkgbWFwcGlu ZyBwaXhlbCBkYXRhIGZyb20gdGhlIGZyYW1lYnVmZmVyIGJlZm9yZSBpdCBpcyBnaXZlbiB0byB0 aGUgdHJhbnNmb3JtYXRpb24gbWF0cml4LiBUaGUgZGF0YSBpcyBhbiBpbnRlcnByZXRlZCBhcyBh biBhcnJheSBvZiBzdHJ1Y3QgZHJtX2NvbG9yX2x1dCBlbGVtZW50cy4gSGFyZHdhcmUgbWlnaHQg Y2hvb3NlIG5vdCB0byB1c2UgdGhlIGZ1bGwgcHJlY2lzaW9uIG9mIHRoZSBMVVQgZWxlbWVudHMg bm9yIHVzZSBhbGwgdGhlIGVsZW1lbnRzIG9mIHRoZSBMVVQgKGZvciBleGFtcGxlIHRoZSBoYXJk d2FyZSBtaWdodCBjaG9vc2UgdG8gaW50ZXJwb2xhdGUgYmV0d2VlbiBMVVRbMF0gYW5kIExVVFs0 XSkuCi0sLOKAnERFR0FNTUFfTFVUX1NJWkXigJ0sUkFOR0UgfCBJTU1VVEFCTEUsIk1pbj0wLCBN YXg9VUlOVF9NQVgiLENSVEMsRFJNIHByb3BlcnR5IHRvIGdpdmVzIHRoZSBzaXplIG9mIHRoZSBs b29rdXAgdGFibGUgdG8gYmUgc2V0IG9uIHRoZSBERUdBTU1BX0xVVCBwcm9wZXJ0eSAodGhlIHNp emUgZGVwZW5kcyBvbiB0aGUgdW5kZXJseWluZyBoYXJkd2FyZSkuCi0sLOKAnENUTeKAnSxCTE9C LDAsQ1JUQyxEUk0gcHJvcGVydHkgdG8gc2V0IHRoZSBjdXJyZW50IHRyYW5zZm9ybWF0aW9uIG1h dHJpeCAoQ1RNKSBhcHBseSB0byBwaXhlbCBkYXRhIGFmdGVyIHRoZSBsb29rdXAgdGhyb3VnaCB0 aGUgZGVnYW1tYSBMVVQgYW5kIGJlZm9yZSB0aGUgbG9va3VwIHRocm91Z2ggdGhlIGdhbW1hIExV VC4gVGhlIGRhdGEgaXMgYW4gaW50ZXJwcmV0ZWQgYXMgYSBzdHJ1Y3QgZHJtX2NvbG9yX2N0bS4K LSws4oCcR0FNTUFfTFVU4oCdLEJMT0IsMCxDUlRDLERSTSBwcm9wZXJ0eSB0byBzZXQgdGhlIGdh bW1hIGxvb2t1cCB0YWJsZSAoTFVUKSBtYXBwaW5nIHBpeGVsIGRhdGEgYWZ0ZXIgdG8gdGhlIHRy YW5zZm9ybWF0aW9uIG1hdHJpeCB0byBkYXRhIHNlbnQgdG8gdGhlIGNvbm5lY3Rvci4gVGhlIGRh dGEgaXMgYW4gaW50ZXJwcmV0ZWQgYXMgYW4gYXJyYXkgb2Ygc3RydWN0IGRybV9jb2xvcl9sdXQg ZWxlbWVudHMuIEhhcmR3YXJlIG1pZ2h0IGNob29zZSBub3QgdG8gdXNlIHRoZSBmdWxsIHByZWNp c2lvbiBvZiB0aGUgTFVUIGVsZW1lbnRzIG5vciB1c2UgYWxsIHRoZSBlbGVtZW50cyBvZiB0aGUg TFVUIChmb3IgZXhhbXBsZSB0aGUgaGFyZHdhcmUgbWlnaHQgY2hvb3NlIHRvIGludGVycG9sYXRl IGJldHdlZW4gTFVUWzBdIGFuZCBMVVRbNF0pLgotLCzigJxHQU1NQV9MVVRfU0laReKAnSxSQU5H RSB8IElNTVVUQUJMRSwiTWluPTAsIE1heD1VSU5UX01BWCIsQ1JUQyxEUk0gcHJvcGVydHkgdG8g Z2l2ZXMgdGhlIHNpemUgb2YgdGhlIGxvb2t1cCB0YWJsZSB0byBiZSBzZXQgb24gdGhlIEdBTU1B X0xVVCBwcm9wZXJ0eSAodGhlIHNpemUgZGVwZW5kcyBvbiB0aGUgdW5kZXJseWluZyBoYXJkd2Fy ZSkuCiBpOTE1LEdlbmVyaWMsIiIiQnJvYWRjYXN0IFJHQiIiIixFTlVNLCJ7ICIiQXV0b21hdGlj IiIsICIiRnVsbCIiLCAiIkxpbWl0ZWQgMTY6MjM1IiIgfSIsQ29ubmVjdG9yLCJXaGVuIHRoaXMg cHJvcGVydHkgaXMgc2V0IHRvIExpbWl0ZWQgMTY6MjM1IGFuZCBDVE0gaXMgc2V0LCB0aGUgaGFy ZHdhcmUgd2lsbCBiZSBwcm9ncmFtbWVkIHdpdGggdGhlIHJlc3VsdCBvZiB0aGUgbXVsdGlwbGlj YXRpb24gb2YgQ1RNIGJ5IHRoZSBsaW1pdGVkIHJhbmdlIG1hdHJpeCB0byBlbnN1cmUgdGhlIHBp eGVscyBub3JtYWx5IGluIHRoZSByYW5nZSAwLi4xLjAgYXJlIHJlbWFwcGVkIHRvIHRoZSByYW5n ZSAxNi8yNTUuLjIzNS8yNTUuIgogLCzigJxhdWRpb+KAnSxFTlVNLCJ7ICIiZm9yY2UtZHZpIiIs ICIib2ZmIiIsICIiYXV0byIiLCAiIm9uIiIgfSIsQ29ubmVjdG9yLFRCRAogLFNEVk8tVFYs4oCc bW9kZeKAnSxFTlVNLCJ7ICIiTlRTQ19NIiIsICIiTlRTQ19KIiIsICIiTlRTQ180NDMiIiwgIiJQ QUxfQiIiIH0gZXRjLiIsQ29ubmVjdG9yLFRCRApkaWZmIC0tZ2l0IGEvZHJpdmVycy9ncHUvZHJt L2RybV9jb2xvcl9tZ210LmMgYi9kcml2ZXJzL2dwdS9kcm0vZHJtX2NvbG9yX21nbXQuYwppbmRl eCBhY2ExYjdhNjM5N2MuLjIzYjc5Mjc0NmNmZCAxMDA2NDQKLS0tIGEvZHJpdmVycy9ncHUvZHJt L2RybV9jb2xvcl9tZ210LmMKKysrIGIvZHJpdmVycy9ncHUvZHJtL2RybV9jb2xvcl9tZ210LmMK QEAgLTI2LDYgKzI2LDU0IEBACiAKICNpbmNsdWRlICJkcm1fY3J0Y19pbnRlcm5hbC5oIgogCisv KioKKyAqIERPQzogb3ZlcnZpZXcKKyAqCisgKiBDb2xvciBtYW5hZ2VtZW50IG9yIGNvbG9yIHNw YWNlIGFkanVzdGVtZW50cyBpcyBzdXBwb3J0ZWQgdGhyb3VnaCBhIHNldCBvZiA1CisgKiBwcm9w ZXJ0aWVzIG9uIHRoZSAmZHJtX2NydGMgb2JqZWN0LiBUaGV5IGFyZSBzZXQgdXAgYnkgY2FsbGlu ZworICogZHJtX2NydGNfZW5hYmxlX2NvbG9yX21nbXQoKS4KKyAqCisgKiAiREVHQU1NQV9MVVTi gJ06CisgKglCbG9iIHByb3BlcnR5IHRvIHNldCB0aGUgZGVnYW1tYSBsb29rdXAgdGFibGUgKExV VCkgbWFwcGluZyBwaXhlbCBkYXRhCisgKglmcm9tIHRoZSBmcmFtZWJ1ZmZlciBiZWZvcmUgaXQg aXMgZ2l2ZW4gdG8gdGhlIHRyYW5zZm9ybWF0aW9uIG1hdHJpeC4KKyAqCVRoZSBkYXRhIGlzIGFu IGludGVycHJldGVkIGFzIGFuIGFycmF5IG9mIHN0cnVjdCAmZHJtX2NvbG9yX2x1dCBlbGVtZW50 cy4KKyAqCUhhcmR3YXJlIG1pZ2h0IGNob29zZSBub3QgdG8gdXNlIHRoZSBmdWxsIHByZWNpc2lv biBvZiB0aGUgTFVUIGVsZW1lbnRzCisgKglub3IgdXNlIGFsbCB0aGUgZWxlbWVudHMgb2YgdGhl IExVVCAoZm9yIGV4YW1wbGUgdGhlIGhhcmR3YXJlIG1pZ2h0CisgKgljaG9vc2UgdG8gaW50ZXJw b2xhdGUgYmV0d2VlbiBMVVRbMF0gYW5kIExVVFs0XSkuCisgKgorICog4oCcREVHQU1NQV9MVVRf U0laReKAnToKKyAqCVVuc2luZ2VkIHJhbmdlIHByb3BlcnR5IHRvIGdpdmVzIHRoZSBzaXplIG9m IHRoZSBsb29rdXAgdGFibGUgdG8gYmUgc2V0CisgKglvbiB0aGUgREVHQU1NQV9MVVQgcHJvcGVy dHkgKHRoZSBzaXplIGRlcGVuZHMgb24gdGhlIHVuZGVybHlpbmcKKyAqCWhhcmR3YXJlKS4gSWYg ZHJpdmVycyBzdXBwb3J0IG11bHRpcGxlIExVVCBzaXplcyB0aGVuIHRoZXkgc2hvdWxkCisgKglw dWJsaXNoIHRoZSBsYXJnZXN0IHNpemUsIGFuZCBzdWItc2FtcGxlIHNtYWxsZXIgc2l6ZWQgTFVU cyAoZS5nLiBmb3IKKyAqCXNwbGl0LWdhbW1hIG1vZGVzKSBhcHByb3ByaWF0ZWx5LgorICoKKyAq IOKAnENUTeKAnToKKyAqCUJsb2IgcHJvcGVydHkgdG8gc2V0IHRoZSBjdXJyZW50IHRyYW5zZm9y bWF0aW9uIG1hdHJpeCAoQ1RNKSBhcHBseSB0bworICoJcGl4ZWwgZGF0YSBhZnRlciB0aGUgbG9v a3VwIHRocm91Z2ggdGhlIGRlZ2FtbWEgTFVUIGFuZCBiZWZvcmUgdGhlCisgKglsb29rdXAgdGhy b3VnaCB0aGUgZ2FtbWEgTFVULiBUaGUgZGF0YSBpcyBhbiBpbnRlcnByZXRlZCBhcyBhIHN0cnVj dAorICoJJmRybV9jb2xvcl9jdG0uCisgKgorICog4oCcR0FNTUFfTFVU4oCdOgorICoJQmxvYiBw cm9wZXJ0eSB0byBzZXQgdGhlIGdhbW1hIGxvb2t1cCB0YWJsZSAoTFVUKSBtYXBwaW5nIHBpeGVs IGRhdGEKKyAqCWFmdGVyIHRvIHRoZSB0cmFuc2Zvcm1hdGlvbiBtYXRyaXggdG8gZGF0YSBzZW50 IHRvIHRoZSBjb25uZWN0b3IuIFRoZQorICoJZGF0YSBpcyBhbiBpbnRlcnByZXRlZCBhcyBhbiBh cnJheSBvZiBzdHJ1Y3QgJmRybV9jb2xvcl9sdXQgZWxlbWVudHMuCisgKglIYXJkd2FyZSBtaWdo dCBjaG9vc2Ugbm90IHRvIHVzZSB0aGUgZnVsbCBwcmVjaXNpb24gb2YgdGhlIExVVCBlbGVtZW50 cworICoJbm9yIHVzZSBhbGwgdGhlIGVsZW1lbnRzIG9mIHRoZSBMVVQgKGZvciBleGFtcGxlIHRo ZSBoYXJkd2FyZSBtaWdodAorICoJY2hvb3NlIHRvIGludGVycG9sYXRlIGJldHdlZW4gTFVUWzBd IGFuZCBMVVRbNF0pLgorICoKKyAqIOKAnEdBTU1BX0xVVF9TSVpF4oCdOgorICoJVW5zaWduZWQg cmFuZ2UgcHJvcGVydHkgdG8gZ2l2ZXMgdGhlIHNpemUgb2YgdGhlIGxvb2t1cCB0YWJsZSB0byBi ZSBzZXQKKyAqCW9uIHRoZSBHQU1NQV9MVVQgcHJvcGVydHkgKHRoZSBzaXplIGRlcGVuZHMgb24g dGhlIHVuZGVybHlpbmcgaGFyZHdhcmUpLgorICoJSWYgZHJpdmVycyBzdXBwb3J0IG11bHRpcGxl IExVVCBzaXplcyB0aGVuIHRoZXkgc2hvdWxkIHB1Ymxpc2ggdGhlCisgKglsYXJnZXN0IHNpemUs IGFuZCBzdWItc2FtcGxlIHNtYWxsZXIgc2l6ZWQgTFVUcyAoZS5nLiBmb3Igc3BsaXQtZ2FtbWEK KyAqCW1vZGVzKSBhcHByb3ByaWF0ZWx5LgorICoKKyAqIFRoZXJlIGlzIGFsc28gc3VwcG9ydCBm b3IgYSBsZWdhY3kgZ2FtbWEgdGFibGUsIHdoaWNoIGlzIHNldCB1cCBieSBjYWxsaW5nCisgKiBk cm1fbW9kZV9jcnRjX3NldF9nYW1tYV9zaXplKCkuIERyaXZlcnMgd2hpY2ggc3VwcG9ydCBib3Ro IHNob3VsZCB1c2UKKyAqIGRybV9hdG9taWNfaGVscGVyX2xlZ2FjeV9nYW1tYV9zZXQoKSB0byBh bGlhcyB0aGUgbGVnYWN5IGdhbW1hIHJhbXAgd2l0aCB0aGUKKyAqICJHQU1NQV9MVVQiIHByb3Bl cnR5IGFib3ZlLgorICovCiAKIC8qKgogICogZHJtX2NydGNfZW5hYmxlX2NvbG9yX21nbXQgLSBl bmFibGUgY29sb3IgbWFuYWdlbWVudCBwcm9wZXJ0aWVzCmRpZmYgLS1naXQgYS9pbmNsdWRlL2Ry bS9kcm1fY29sb3JfbWdtdC5oIGIvaW5jbHVkZS9kcm0vZHJtX2NvbG9yX21nbXQuaAppbmRleCAx ZTAxYzU4YmJlODEuLmM3NjcyMzhhYzlkNSAxMDA2NDQKLS0tIGEvaW5jbHVkZS9kcm0vZHJtX2Nv bG9yX21nbXQuaAorKysgYi9pbmNsdWRlL2RybS9kcm1fY29sb3JfbWdtdC5oCkBAIC0zMyw5ICsz MywxNCBAQCB2b2lkIGRybV9jcnRjX2VuYWJsZV9jb2xvcl9tZ210KHN0cnVjdCBkcm1fY3J0YyAq Y3J0YywKIGludCBkcm1fbW9kZV9jcnRjX3NldF9nYW1tYV9zaXplKHN0cnVjdCBkcm1fY3J0YyAq Y3J0YywKIAkJCQkgaW50IGdhbW1hX3NpemUpOwogCi0vKgotICogRXh0cmFjdCBhIGRlZ2FtbWEv Z2FtbWEgTFVUIHZhbHVlIHByb3ZpZGVkIGJ5IHVzZXIgYW5kIHJvdW5kIGl0IHRvIHRoZQotICog cHJlY2lzaW9uIHN1cHBvcnRlZCBieSB0aGUgaGFyZHdhcmUuCisvKioKKyAqIGRybV9jb2xvcl9s dXRfZXh0cmFjdCAtIGNsYW1wJnJvdW5kIExVVCBlbnRyaWVzCisgKiBAdXNlcl9pbnB1dDogaW5w dXQgdmFsdWUKKyAqIEBiaXRfcHJlY2lzaW9uOiBudW1iZXIgb2YgYml0cyB0aGUgaHcgTFVUIHN1 cHBvcnRzCisgKgorICogRXh0cmFjdCBhIGRlZ2FtbWEvZ2FtbWEgTFVUIHZhbHVlIHByb3ZpZGVk IGJ5IHVzZXIgKGluIHRoZSBmb3JtIG9mCisgKiAmZHJtX2NvbG9yX2x1dCBlbnRyaWVzKSBhbmQg cm91bmQgaXQgdG8gdGhlIHByZWNpc2lvbiBzdXBwb3J0ZWQgYnkgdGhlCisgKiBoYXJkd2FyZS4K ICAqLwogc3RhdGljIGlubGluZSB1aW50MzJfdCBkcm1fY29sb3JfbHV0X2V4dHJhY3QodWludDMy X3QgdXNlcl9pbnB1dCwKIAkJCQkJICAgICB1aW50MzJfdCBiaXRfcHJlY2lzaW9uKQotLSAKMi45 LjMKCl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCkludGVs LWdmeCBtYWlsaW5nIGxpc3QKSW50ZWwtZ2Z4QGxpc3RzLmZyZWVkZXNrdG9wLm9yZwpodHRwczov L2xpc3RzLmZyZWVkZXNrdG9wLm9yZy9tYWlsbWFuL2xpc3RpbmZvL2ludGVsLWdmeAo=