Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
DRMMODEGETRESOURCES(3)	    Direct Rendering Manager	  DRMMODEGETRESOURCES(3)

NAME
     drmModeGetResources - retrieve current display configuration information

SYNOPSIS
     #include <xf86drm.h>

     #include <xf86drmMode.h>

     drmModeResPtr drmModeGetResources(int fd);

DESCRIPTION
     drmModeGetResources  allocates,  populates, and returns a drmModeRes struc-
     ture containing information about the current  display  configuration.  The
     structure contains the following fields:

	typedef struct _drmModeRes {
	    int count_fbs;
	    uint32_t *fbs;

	    int count_crtcs;
	    uint32_t *crtcs;

	    int count_connectors;
	    uint32_t *connectors;

	    int count_encoders;
	    uint32_t *encoders;

	    uint32_t min_width, max_width;
	    uint32_t min_height, max_height;
	} drmModeRes, *drmModeResPtr;

     The  count_fbs  and  fbs  fields indicate the number of currently allocated
     framebuffer objects (i.e., objects that can be attached to a given CRTC  or
     sprite for display).

     The count_crtcs and crtcs fields list the available CRTCs in the configura-
     tion.  A CRTC is simply an object that can scan out a framebuffer to a dis-
     play sink, and contains mode  timing  and	relative  position  information.
     CRTCs drive encoders, which are responsible for converting the pixel stream
     into a specific display protocol (e.g., MIPI or HDMI).

     The count_connectors and connectors fields list the available physical con-
     nectors  on the system. Note that some of these may not be exposed from the
     chassis (e.g., LVDS or eDP). Connectors are attached to encoders  and  con-
     tain information about the attached display sink (e.g., width and height in
     mm, subpixel ordering, and various other properties).

     The  count_encoders  and encoders fields list the available encoders on the
     device. Each encoder may be associated with a CRTC,  and  may  be	used  to
     drive a particular encoder.

     The  min_*  and max_* fields indicate the maximum size of a framebuffer for
     this device (i.e., the scanout size limit).

RETURN VALUE
     drmModeGetResources returns a drmModeRes structure pointer on success, NULL
     on failure. The  returned	structure  must  be  freed  with  drmModeFreeRe-
     sources(3).

REPORTING BUGS
     Bugs in this function should be reported to
      <https://gitlab.freedesktop.org/mesa/libdrm/-/issues>

SEE ALSO
     drm(7), drm-kms(7), drmModeGetFB(3), drmModeAddFB(3), drmModeAddFB2(3), dr-
     mModeRmFB(3), drmModeDirtyFB(3), drmModeGetCrtc(3), drmModeSetCrtc (3), dr-
     mModeGetEncoder (3), drmModeGetConnector(3)

				 September 2012 	  DRMMODEGETRESOURCES(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=drmModeGetResources&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help