linux/drivers/gpu/drm
Matt Roper c103d1cfb3 drm: Add primary plane helpers (v3)
When we expose non-overlay planes to userspace, they will become
accessible via standard userspace plane API's.  We should be able to
handle the standard plane operations against primary planes in a generic
way via the modeset handler.

Drivers that can program primary planes more efficiently, that want to
use their own primary plane structure to track additional information,
or that don't have the limitations assumed by the helpers are free to
provide their own implementation of some or all of these handlers.

v3: Tweak kerneldoc formatting slightly to avoid ugliness
v2:
 - Move plane helpers to a new file (drm_plane_helper.c)
 - Tighten checks on update handler (check for scaling, CRTC coverage,
   subpixel positioning)
 - Pass proper panning parameters to modeset interface
 - Disallow disabling primary plane (and thus CRTC) if other planes are
   still active on the CRTC.
 - Use a minimal format list that should work on all hardware/drivers.
   Drivers may call this function with a more accurate plane list to
   enable additional formats they can support.

Signed-off-by: Matt Roper <matthew.d.roper@intel.com>
Reviewed-by: Rob Clark <robdclark@gmail.com>
2014-04-01 20:11:28 -04:00
..
armada Merge branch 'drm-armada-fixes' of git://ftp.arm.linux.org.uk/~rmk/linux-cubox into drm-fixes 2014-03-07 09:04:32 +10:00
ast drm: init TTM dev_mapping in ttm_bo_device_init() 2014-03-16 12:23:42 +01:00
bochs Merge branch 'drm-next' of git://people.freedesktop.org/~dvdhrm/linux into drm-next 2014-03-18 19:17:02 +10:00
bridge drm/bridge: PTN3460 needs DRM_KMS_HELPER 2014-03-27 12:03:12 +10:00
cirrus drm: init TTM dev_mapping in ttm_bo_device_init() 2014-03-16 12:23:42 +01:00
exynos drm/exynos: Restrict plane loops to only operate on overlay planes (v2) 2014-04-01 20:11:18 -04:00
gma500 drm/gma500: Replace DRM_LOG_KMS() by DRM_DEBUG_KMS() 2014-03-28 12:57:08 +10:00
i2c drm/i2c: tda998x: always use the same device for all kernel messages 2014-02-14 20:11:12 +00:00
i810
i915 drm/i915: Restrict plane loops to only operate on overlay planes (v2) 2014-04-01 20:11:27 -04:00
mga drivers: gpu: Include appropriate header file in mga_ioc32.c 2014-01-14 12:59:24 +10:00
mgag200 drm: init TTM dev_mapping in ttm_bo_device_init() 2014-03-16 12:23:42 +01:00
msm Merge branch 'msm-next' of git://people.freedesktop.org/~robclark/linux into drm-next 2014-02-11 12:56:17 +10:00
nouveau drm/nouveau: fix missing newline 2014-03-26 14:08:26 +10:00
omapdrm drm: use anon-inode instead of relying on cdevs 2014-03-16 12:23:33 +01:00
panel drm/panel: update EDID BLOB in panel_simple_get_modes() 2014-01-14 16:02:02 +01:00
qxl drm: init TTM dev_mapping in ttm_bo_device_init() 2014-03-16 12:23:42 +01:00
r128 drivers: gpu: Include appropriate header file in r128_ioc32.c 2014-01-14 13:05:37 +10:00
radeon drm/radeon: set PIPE_CONFIG for 1D and linear tiling modes on CIK 2014-03-25 13:13:24 +01:00
rcar-du Merge branch 'drm/next/du' of git://linuxtv.org/pinchartl/fbdev into drm-next 2013-12-23 10:42:36 +10:00
savage
shmobile drm/shmobile: Restrict plane loops to only operate on legacy planes 2014-04-01 20:11:27 -04:00
sis drivers: gpu: Mark function as static in sis_drv.c 2014-01-14 13:04:33 +10:00
tdfx
tegra Linux 3.14-rc7 2014-03-18 19:12:31 +10:00
tilcdc drm: store the gem vma offset manager in a typed pointer 2014-01-14 12:38:32 +10:00
ttm drm/ttm: Add a ttm_ref_object_exists function 2014-03-28 14:19:03 +01:00
udl drm/udl: fix Bpp calculation in dumb_create() 2014-03-16 12:11:01 +01:00
via drivers: gpu: Mark function as static in via_drv.c 2014-01-14 13:05:00 +10:00
vmwgfx drm/vmwgfx: Bump driver minor and date 2014-03-28 14:19:05 +01:00
ati_pcigart.c
drm_agpsupport.c
drm_auth.c
drm_buffer.c
drm_bufs.c
drm_cache.c
drm_context.c
drm_crtc_helper.c drm/helper: lock all around force mode restore 2014-03-22 08:05:32 +10:00
drm_crtc_internal.h drm: move drm_mode related functions into drm_modes.c 2014-03-13 12:48:40 +01:00
drm_crtc.c drm: Make drm_crtc_check_viewport non-static 2014-04-01 20:11:28 -04:00
drm_debugfs.c
drm_dma.c
drm_dp_helper.c drm/dp: make aux retries less chatty 2014-03-25 13:13:20 +01:00
drm_drv.c drm: Add a function to get the ioctl flags 2014-03-28 14:19:02 +01:00
drm_edid_load.c
drm_edid.c Merge branch 'topic/core-stuff' of git://git.freedesktop.org/git/drm-intel into drm-next 2014-03-18 19:23:22 +10:00
drm_encoder_slave.c
drm_fb_cma_helper.c
drm_fb_helper.c drm: Add support for multiple plane types (v2) 2014-04-01 19:13:07 -04:00
drm_flip_work.c
drm_fops.c drm: Protect the master management with a drm_device::master_mutex v3 2014-03-28 14:19:02 +01:00
drm_gem_cma_helper.c drm/cma: remove to make sg_table when gem cma is created 2014-03-18 19:20:25 +10:00
drm_gem.c Merge branch 'drm-docs' of ssh://people.freedesktop.org/~danvet/drm into drm-next 2014-03-18 19:09:10 +10:00
drm_global.c
drm_hashtab.c
drm_info.c
drm_ioc32.c
drm_ioctl.c drm: add DRM_CAPs for cursor size 2014-02-18 13:41:01 -05:00
drm_irq.c drm/radeon: Move the early vblank IRQ fixup to radeon_get_crtc_scanoutpos() 2014-01-20 12:21:35 +02:00
drm_lock.c
drm_memory.c
drm_mipi_dsi.c
drm_mm.c drm/doc: Add function reference documentation for drm_mm.c 2014-03-13 12:48:37 +01:00
drm_modes.c drm: polish function kerneldoc for drm_modes.[hc] 2014-03-13 12:48:44 +01:00
drm_panel.c
drm_pci.c Merge branch 'topic/core-stuff' of git://git.freedesktop.org/git/drm-intel into drm-next 2014-03-18 19:23:22 +10:00
drm_plane_helper.c drm: Add primary plane helpers (v3) 2014-04-01 20:11:28 -04:00
drm_platform.c drm: provide device-refcount 2014-03-16 12:25:17 +01:00
drm_prime.c drm/doc: Add PRIME function references 2014-03-13 12:48:34 +01:00
drm_rect.c
drm_scatter.c
drm_stub.c drm: Protect the master management with a drm_device::master_mutex v3 2014-03-28 14:19:02 +01:00
drm_sysfs.c
drm_trace_points.c
drm_trace.h
drm_usb.c drm: provide device-refcount 2014-03-16 12:25:17 +01:00
drm_vm.c
drm_vma_manager.c
Kconfig drm/bridge: Add PTN3460 bridge driver 2014-03-24 00:36:37 +09:00
Makefile drm: Add primary plane helpers (v3) 2014-04-01 20:11:28 -04:00
README.drm

************************************************************
* For the very latest on DRI development, please see:      *
*     http://dri.freedesktop.org/                          *
************************************************************

The Direct Rendering Manager (drm) is a device-independent kernel-level
device driver that provides support for the XFree86 Direct Rendering
Infrastructure (DRI).

The DRM supports the Direct Rendering Infrastructure (DRI) in four major
ways:

    1. The DRM provides synchronized access to the graphics hardware via
       the use of an optimized two-tiered lock.

    2. The DRM enforces the DRI security policy for access to the graphics
       hardware by only allowing authenticated X11 clients access to
       restricted regions of memory.

    3. The DRM provides a generic DMA engine, complete with multiple
       queues and the ability to detect the need for an OpenGL context
       switch.

    4. The DRM is extensible via the use of small device-specific modules
       that rely extensively on the API exported by the DRM module.


Documentation on the DRI is available from:
    http://dri.freedesktop.org/wiki/Documentation
    http://sourceforge.net/project/showfiles.php?group_id=387
    http://dri.sourceforge.net/doc/

For specific information about kernel-level support, see:

    The Direct Rendering Manager, Kernel Support for the Direct Rendering
    Infrastructure
    http://dri.sourceforge.net/doc/drm_low_level.html

    Hardware Locking for the Direct Rendering Infrastructure
    http://dri.sourceforge.net/doc/hardware_locking_low_level.html

    A Security Analysis of the Direct Rendering Infrastructure
    http://dri.sourceforge.net/doc/security_low_level.html