======================================
Type deai.plugin.xorg.randr:OutputInfo
======================================

.. lua:module:: deai.plugin.xorg.randr.OutputInfo

See :lua:attr:`Output.info <deai.plugin.xorg.randr.Output.info>` for more information about this type

Properties
==========

.. list-table::
   :header-rows: 0

   * - :lua:attr:`connection <connection>`
     - Connection
   * - :lua:attr:`mm_height <mm_height>`
     - Height in millimeters
   * - :lua:attr:`mm_width <mm_width>`
     - Width in millimeters
   * - :lua:attr:`modes <modes>`
     - Modes
   * - :lua:attr:`name <name>`
     - Name
   * - :lua:attr:`num_preferred <num_preferred>`
     - Number of preferred mode
   * - :lua:attr:`subpixel_order <subpixel_order>`
     - Subpixel order

.. lua:attribute:: connection: integer

   :type: integer

   Connection 

   `Possible values
   <https
   ://gitlab.freedesktop.org/xorg/proto/xorgproto/-/blob/09602b2/randrproto.txt#L2505-2510>`_

.. lua:attribute:: mm_height: unsigned

   :type: unsigned

   Height in millimeters 

.. lua:attribute:: mm_width: unsigned

   :type: unsigned

   Width in millimeters 

.. lua:attribute:: modes: [Mode]

   :type: :lua:mod:`[Mode] <deai.plugin.xorg.randr.Mode>`

   Modes 

.. lua:attribute:: name: string

   :type: string

   Name 

.. lua:attribute:: num_preferred: unsigned

   :type: unsigned

   Number of preferred mode 

.. lua:attribute:: subpixel_order: integer

   :type: integer

   Subpixel order 

Methods
==========

.. list-table::
   :header-rows: 0

   * - :lua:meth:`preferred_mode() <preferred_mode>`
     - Find the preferred mode of an output.

.. lua:method:: preferred_mode() -> Mode

   :rtype: :lua:mod:`Mode <deai.plugin.xorg.randr.Mode>`

   Find the preferred mode of an output. 

   Mode is chosen first based on the preferred modes returned by the X server,
   any modes that aren't preferred are ignored. From what remains, we choose the
   mode with highest number of pixels. If there are multiple modes with the same
   number of pixels, we prefer the one that isn't interlaced or double scanned.