1 1.1 mrg /********************************************************** 2 1.1 mrg * Copyright 2009-2011 VMware, Inc. All rights reserved. 3 1.1 mrg * 4 1.1 mrg * Permission is hereby granted, free of charge, to any person 5 1.1 mrg * obtaining a copy of this software and associated documentation 6 1.1 mrg * files (the "Software"), to deal in the Software without 7 1.1 mrg * restriction, including without limitation the rights to use, copy, 8 1.1 mrg * modify, merge, publish, distribute, sublicense, and/or sell copies 9 1.1 mrg * of the Software, and to permit persons to whom the Software is 10 1.1 mrg * furnished to do so, subject to the following conditions: 11 1.1 mrg * 12 1.1 mrg * The above copyright notice and this permission notice shall be 13 1.1 mrg * included in all copies or substantial portions of the Software. 14 1.1 mrg * 15 1.1 mrg * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 16 1.1 mrg * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 17 1.1 mrg * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 18 1.1 mrg * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS 19 1.1 mrg * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN 20 1.1 mrg * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN 21 1.1 mrg * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 22 1.1 mrg * SOFTWARE. 23 1.1 mrg * 24 1.1 mrg ********************************************************* 25 1.1 mrg * Authors: 26 1.1 mrg * Zack Rusin <zackr-at-vmware-dot-com> 27 1.1 mrg * Thomas Hellstrom <thellstrom-at-vmware-dot-com> 28 1.1 mrg */ 29 1.1 mrg 30 1.1 mrg The XA gallium frontend is intended as a versioned interface to gallium for 31 1.1 mrg xorg driver writers. Initially it's mostly based on Zack Rusin's 32 1.1 mrg composite / video work for the Xorg gallium frontend. 33 1.1 mrg 34 1.1 mrg The motivation behind this gallium frontend is that the Xorg gallium frontend has 35 1.1 mrg a number of interfaces to work with: 36 1.1 mrg 37 1.1 mrg 1) The Xorg sdk (versioned) 38 1.1 mrg 2) Gallium3D (not versioned) 39 1.1 mrg 3) KMS modesetting (versioned) 40 1.1 mrg 4) Driver-private (hopefully versioned) 41 1.1 mrg 42 1.1 mrg Since Gallium3D is not versioned, the Xorg gallium frontend needs to be compiled 43 1.1 mrg with Gallium, but it's really beneficial to be able to compile xorg drivers 44 1.1 mrg standalone. 45 1.1 mrg 46 1.1 mrg Therefore the xa gallium frontend is intended to supply the following 47 1.1 mrg functionality: 48 1.1 mrg 49 1.1 mrg 1) Versioning. 50 1.1 mrg 2) Surface functionality (creation and copying for a basic dri2 implementation) 51 1.1 mrg 3) YUV blits for textured Xv. 52 1.1 mrg 4) Solid fills without ROP functionality. 53 1.1 mrg 5) Copies with format conversion and - reinterpretation but without ROP 54 1.1 mrg 6) Xrender- type compositing for general acceleration. 55 1.1 mrg 56 1.1 mrg 57 1.1 mrg The first user will be the vmwgfx xorg driver. When there are more users, 58 1.1 mrg we need to be able to load the appropriate gallium pipe driver, and we 59 1.1 mrg should investigate sharing the loadig mechanism with the EGL gallium frontend. 60 1.1 mrg 61 1.1 mrg IMPORTANT: 62 1.1 mrg Version compatibilities: 63 1.1 mrg While this library remains OUTSIDE any mesa release branch, 64 1.1 mrg and the major version number is still 0. Any minor bump should be viewed as 65 1.1 mrg an incompatibility event, and any user of this library should test for that 66 1.1 mrg and refuse to use the library if minor versions differ. 67 1.1 mrg As soon as the library enters a mesa release branch, if not earlier, major 68 1.1 mrg will be bumped to 1, and normal incompatibility rules (major bump) 69 1.1 mrg will be followed. 70 1.1 mrg It is allowed to add function interfaces while only bumping minor. Any 71 1.1 mrg user that uses these function interfaces must therefore use lazy symbol 72 1.1 mrg lookups and test minor for compatibility before using such a function. 73
Indexes created Fri Apr 03 00:24:04 UTC 2026