From: Ben Widawsky Subject: Re: [PATCH] i915,drm/fourcc: Improve the CCS modifier documentation Date: Mon, 21 Aug 2017 09:25:35 -0700 Message-ID: <20170821162535.GA24848@mail.bwidawsk.net> References: <1503081280-1813-1-git-send-email-jason.ekstrand@intel.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8"; Format="flowed" Content-Transfer-Encoding: base64 Return-path: Content-Disposition: inline In-Reply-To: <1503081280-1813-1-git-send-email-jason.ekstrand@intel.com> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: Jason Ekstrand Cc: Jason Ekstrand , intel-gfx@lists.freedesktop.org, dri-devel@lists.freedesktop.org List-Id: dri-devel@lists.freedesktop.org T24gMTctMDgtMTggMTE6MzQ6NDAsIEphc29uIEVrc3RyYW5kIHdyb3RlOgo+VGhpcyB1cGRhdGVz IHRoZSBkb2N1bWVudGF0aW9uIG9uIHRoZSBpbnRlbCBDQ1MgbW9kaWZpZXJzIGZvciBhIGNvdXBs ZQo+b2YgcmVhc29uczoKPgo+IDEpIFRoZSBvbGQgZG9jdW1lbnRhdGlvbiByZXF1aXJlZCB0aGF0 IHRoZSBDQ1MgbW9kaWZpZXIgb25seSBiZSB1c2VkCj4gICAgd2l0aCA4ODg4IGZvcm1hdHMuICBX aGlsZSBpOTE1IGN1cnJlbnRseSBvbmx5IHN1cHBvcnRzIENDUyBzY2Fub3V0Cj4gICAgd2l0aCA4 ODg4IGZvcm1hdHMgKGFuZCBhZHZlcnRpc2VzIHN1Y2ggdGhyb3VnaCB0aGUgYmxvYiBmb3JtYXQp LCBDQ1MKPiAgICBjYW4gYmUgdXNlZCB3aXRoIG1hbnkgb3RoZXIgZm9ybWF0cy4gIE1lc2EsIGlu IHBhcnRpY3VsYXIsIGNhbgo+ICAgIGhhbmRsZSBDQ1Mgb24gdGhlIGZ1bGwgcmFuZ2Ugb2YgZm9y bWF0cyBzdXBwb3J0ZWQgYnkgdGhlIGhhcmR3YXJlLgo+ICAgIEZvciBpbWFnZSBzaGFyaW5nIGVu dGlyZWx5IHdpdGhpbiB1c2Vyc3BhY2UsIHdlIGRvbid0IHdhbnQgdGhpcwo+ICAgIHJlc3RyaWN0 aW9uLgo+Cj4gMikgVGhlIG9sZCBkb2N1bWVudGF0aW9uIHNwZWNpZmllZCB0aGUgc2NhbGluZyBm YWN0b3IgaW4gdGVybXMgb2YKPiAgICBwaXhlbHMgd2hpY2ggYnJlYWtzIGRvd24gd2hlbiB5b3Ug c3RhcnQgdXNpbmcgZm9ybWF0cyB3aGljaCBhcmUgbm90Cj4gICAgMzItYml0LiAgQnkgc3BlY2lm eWluZyBpdCBpbiB0ZXJtcyBvZiBjYWNoZSBsaW5lcyBhbmQgdGlsZXMsIHdlIGNhbgo+ICAgIHBy b3Blcmx5IHNwZWNpZnkgdGhlIHNjYWxlLWRvd24gcmVsYXRpb25zaGlwIHdpdGggbm8gZm9ybWF0 IHNpemUKPiAgICBhc3N1bXB0aW9ucy4KPgo+IDMpIFRoZSBuZXcgY29tbWVudCBwcm92aWRlcyBt b3JlIGRldGFpbCBhYm91dCB0aGUgInJlYWwiIGxheW91dCBvZiBDQ1MKPiAgICBvbiBTa3kgTGFr ZSBhbmQgYWxzbyBwb2ludHMgb3V0IHRoYXQgdGhlIHJlYXNvbiB3aHkgWSB0aWxpbmcgaXMKPiAg ICBpbXBvcnRhbnQgaXMgYmVjYXVzZSBpdCBhZmZlY3RzIHJvdyBwaXRjaCBjYWxjdWxhdGlvbnMu Cj4KPiA0KSBXZSBzaG91bGRuJ3QgYmUgZG9jdW1lbnRpbmcgdGhlIFlmIENDUyBtb2RpZmllciB5 ZXQuICBVc2Vyc3BhY2UgaXMKPiAgICBpbmNhcGFibGUgb2YgZ2VuZXJhdGluZyBpdCByaWdodCBu b3cgYW5kIHdlIGRvbid0IGZ1bGx5IGtub3cgaG93IGl0Cj4gICAgd29ya3MgeWV0LiAgVHJ5aW5n IHRvIGZ1bGx5IGRlc2NyaWJlIGl0IGlzIHByZW1hdHVyZS4KPgo+U2lnbmVkLW9mZi1ieTogSmFz b24gRWtzdHJhbmQgPGphc29uQGpsZWtzdHJhbmQubmV0Pgo+Q2M6IEJlbiBXaWRhd3NreSA8YmVu QGJ3aWRhd3NrLm5ldD4KPkNjOiBWaWxsZSBTeXJqw6Rsw6QgPHZpbGxlLnN5cmphbGFAbGludXgu aW50ZWwuY29tPgo+LS0tCj4gaW5jbHVkZS91YXBpL2RybS9kcm1fZm91cmNjLmggfCAzNSArKysr KysrKysrKysrKysrKysrKysrLS0tLS0tLS0tLS0tLQo+IDEgZmlsZSBjaGFuZ2VkLCAyMiBpbnNl cnRpb25zKCspLCAxMyBkZWxldGlvbnMoLSkKPgo+ZGlmZiAtLWdpdCBhL2luY2x1ZGUvdWFwaS9k cm0vZHJtX2ZvdXJjYy5oIGIvaW5jbHVkZS91YXBpL2RybS9kcm1fZm91cmNjLmgKPmluZGV4IDNh ZDgzOGQuLjk2NzBkYTQgMTAwNjQ0Cj4tLS0gYS9pbmNsdWRlL3VhcGkvZHJtL2RybV9mb3VyY2Mu aAo+KysrIGIvaW5jbHVkZS91YXBpL2RybS9kcm1fZm91cmNjLmgKPkBAIC0yNjYsMjEgKzI2Niwz MCBAQCBleHRlcm4gIkMiIHsKPiAvKgo+ICAqIEludGVsIGNvbG9yIGNvbnRyb2wgc3VyZmFjZSAo Q0NTKSBmb3IgcmVuZGVyIGNvbXByZXNzaW9uCj4gICoKPi0gKiBUaGUgZnJhbWVidWZmZXIgZm9y bWF0IG11c3QgYmUgb25lIG9mIHRoZSA4Ojg6ODo4IFJHQiBmb3JtYXRzLgo+LSAqIFRoZSBtYWlu IHN1cmZhY2Ugd2lsbCBiZSBwbGFuZSBpbmRleCAwIGFuZCBtdXN0IGJlIFkvWWYtdGlsZWQsCj4t ICogdGhlIENDUyB3aWxsIGJlIHBsYW5lIGluZGV4IDEuCj4tICoKPi0gKiBFYWNoIENDUyB0aWxl IG1hdGNoZXMgYSAxMDI0eDUxMiBwaXhlbCBhcmVhIG9mIHRoZSBtYWluIHN1cmZhY2UuCj4tICog VG8gbWF0Y2ggY2VydGFpbiBhc3BlY3RzIG9mIHRoZSAzRCBoYXJkd2FyZSB0aGUgQ0NTIGlzCj4t ICogY29uc2lkZXJlZCB0byBiZSBtYWRlIHVwIG9mIG5vcm1hbCAxMjhCeDMyIFkgdGlsZXMsIFRo dXMKPi0gKiB0aGUgQ0NTIHBpdGNoIG11c3QgYmUgc3BlY2lmaWVkIGluIG11bHRpcGxlcyBvZiAx MjggYnl0ZXMuCj4tICoKPi0gKiBJbiByZWFsaXR5IHRoZSBDQ1MgdGlsZSBhcHBlYXJzIHRvIGJl IGEgNjRCeDY0IFkgdGlsZSwgY29tcG9zZWQKPi0gKiBvZiBRV09SRCAoOCBieXRlcykgY2h1bmtz IGluc3RlYWQgb2YgT1dPUkQgKDE2IGJ5dGVzKSBjaHVua3MuCj4tICogQnV0IHRoYXQgZmFjdCBp cyBub3QgcmVsZXZhbnQgdW5sZXNzIHRoZSBtZW1vcnkgaXMgYWNjZXNzZWQKPi0gKiBkaXJlY3Rs eS4KPisgKiBUaGUgaW1hZ2UgZm9ybWF0IG11c3QgYmUgY29tcGF0aWJsZSB3aXRoIENDU19FIChs b3NzbGVzcyByZW5kZXIKPisgKiBjb21wcmVzc2lvbikgYXMgc3BlY2lmaWVkIGluIHRoZSBQUk0g Zm9yIHRoZSByZWxldmFudCBoYXJkd2FyZS4KPisgKiBUaGUgbWFpbiBzdXJmYWNlIHdpbGwgYmUg cGxhbmUgaW5kZXggMCBhbmQgbXVzdCBiZSBZLXRpbGVkLAo+KyAqIHRoZSBDQ1Mgd2lsbCBiZSBw bGFuZSBpbmRleCAxIGFuZCBpcyBhbHNvIFktdGlsZWQuCgpJIGd1ZXNzIGlmIHlvdSdyZSBmdXR1 cmUgcHJvb2ZpbmcsIHlvdSBtaWdodCB3YW50IHRvIGJha2UgaW4gdGhlIGxhbmd1YWdlIGZvcgpw bGFuYXIgZm9ybWF0cy4KCj4rICoKPisgKiBFYWNoIDY0QiBjYWNoZSBsaW5lIGluIHRoZSBDQ1Mg KGEgcmVnaW9uIG9mIDE2QiB4IDQgcm93cyB3aGVuCj4rICogWS10aWxlZCkgY29ycmVzcG9uZHMg dG8gYSByZWdpb24gb2YgMzJ4MTYgY2FjaGUgbGluZXMgaW4gdGhlIG1haW4KPisgKiBzdXJmYWNl LiAgKEFzIGEgY29yb2xsYXJ5LCBlYWNoIENDUyB0aWxlIGNvcnJlc3BvbmRzIHRvIGFuIGFyZWEg b2YKPisgKiAzMngxNiB0aWxlcyBpbiB0aGUgbWFpbiBzdXJmYWNlLikgIFRoaXMgcmVsYXRpb25z aGlwIGhvbGRzIHJlZ2FyZGxlc3MKPisgKiBvZiB0aGUgc2l6ZSBvZiB0aGUgbnVtYmVyIG9mIGJp dHMgcGVyIHBpeGVsIG9mIHRoZSBpbWFnZSBmb3JtYXQuCj4rICoKPisgKiBJbiByZWFsaXR5LCB0 aGUgY2FjaGUgbGluZXMgaW4gdGhlIENDUyB0aWxlIGFyZSBwcm9wb3J0aW9uZWQgaW4gYW4KPisg KiA4QiB4IDggcm93IGNvbmZpZ3VyYXRpb24gd2l0aCBlYWNoIGJ5dGUgYmVpbmcgMngyIDItYml0 IENDUyBlbnRyaWVzLgo+KyAqIEhvd2V2ZXIsIENDUyBpcyBkb2N1bWVudGVkIGFzIFktdGlsZWQg d2l0aCB0aGUgc2NhbGluZyByZWxhdGlvbnNoaXAKPisgKiBkZXNjcmliZWQgaW4gdGVybXMgb2Yg Y2FjaGUgbGluZXMgYXMgYWJvdmUgc28gd2UgY29uc2lkZXIgaXQgdG8gYmUKPisgKiBZLXRpbGVk IGZvciB0aGUgcHVycG9zZSBvZiBzcGVjaWZ5aW5nIHRoaXMgbW9kaWZpZXIuICBUaGlzIG1lYW5z IHRoYXQKPisgKiB0aGUgcm93IHBpdGNoIGZvciB0aGUgQ0NTIGFzc3VtZXMgMTI4Qi90aWxlLgo+ ICAqLwo+ICNkZWZpbmUgSTkxNV9GT1JNQVRfTU9EX1lfVElMRURfQ0NTCWZvdXJjY19tb2RfY29k ZShJTlRFTCwgNCkKPisKPisvKiBSZXNlcnZlZCBmb3IgdGhlIFlmIHZlcnNpb24gb2YgdGhlIFRJ TEVEX0NDUyBtb2RpZmllci4KPisgKgo+KyAqIEV4YWN0IGRlZmluaXRpb24gVEJELgo+KyAqLwo+ ICNkZWZpbmUgSTkxNV9GT1JNQVRfTU9EX1lmX1RJTEVEX0NDUwlmb3VyY2NfbW9kX2NvZGUoSU5U RUwsIDUpCgpDYW4gd2UganVzdCByZW5hbWUgdGhpcyB0byBSU1ZELCBvciBkb2VzIE1lc2EgYnVp bGQgYWxyZWFkeSByZXF1aXJlIHRoaXM/Cgo+Cj4gLyoKX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX18KZHJpLWRldmVsIG1haWxpbmcgbGlzdApkcmktZGV2ZWxA bGlzdHMuZnJlZWRlc2t0b3Aub3JnCmh0dHBzOi8vbGlzdHMuZnJlZWRlc2t0b3Aub3JnL21haWxt YW4vbGlzdGluZm8vZHJpLWRldmVsCg==