NAME
    Display::Resolution - Convert between display resolution size (e.g.
    1280x720) and name (e.g. HD, 720p)

VERSION
    This document describes version 0.004 of Display::Resolution (from Perl
    distribution Display-Resolution), released on 2018-04-26.

FUNCTIONS
  get_display_resolution_name
    Usage:

     get_display_resolution_name(%args) -> str|array[str]

    Get the known name for a display resolution size.

    Examples:

    *   You can specify width and height ...:

         get_display_resolution_name(height => 480, width => 640); # -> [200, "OK", "MCGA", {}]

    *   ... or size directly (in "x x y" or "x*y" format):

         get_display_resolution_name(size => "1280x720"); # -> [200, "OK", "720p", {}]

    *   Return all names:

         get_display_resolution_name(size => "1280x720", all => 1); # -> [200, "OK", ["720p", "HD", "WXGA 16:9"], {}]

    *   Unknown resolution size:

         get_display_resolution_name(size => "999x666"); # -> [200, "OK", undef, {}]

    Will return undef if there is no known name for the resolution size.

    This function is not exported by default, but exportable.

    Arguments ('*' denotes required arguments):

    *   all => *bool*

        Return all names instead of the first one.

        When set to true, an arrayref will be returned instead of string.

    *   height => *posint*

    *   size => *str*

    *   width => *posint*

    Return value: (str|array[str])

  get_display_resolution_size
    Usage:

     get_display_resolution_size(%args) -> str

    Get the size of a display resolution name.

    Examples:

    *   Example #1:

         get_display_resolution_size(name => "VGA"); # -> [200, "OK", "640x480", {}]

    *   Unknown name:

         get_display_resolution_size(name => "foo"); # -> [200, "OK", undef, {}]

    Will return undef if the name is unknown.

    This function is not exported by default, but exportable.

    Arguments ('*' denotes required arguments):

    *   name* => *str*

    Return value: (str)

  list_display_resolution_names
    Usage:

     list_display_resolution_names() -> hash

    Examples:

    *   Example #1:

         list_display_resolution_names();

        Result:

         [
           200,
           "OK",
           {
             "1080p"      => "1920x1080",
             "1440p"      => "2560x1440",
             "16K"        => "15360x8640",
             "16K UHD"    => "15360x8640",
             "2160p"      => "3840x2160",
             "4320p"      => "7680x4320",
             "480p"       => "720x480",
             "4K"         => "3840x2160",
             "4K UHD"     => "3840x2160",
             "4K UHD-1"   => "3840x2160",
             "576p"       => "720x576",
             "5K"         => "5120x2880",
             "720p"       => "1280x720",
             "8640p"      => "15360x8640",
             "8K"         => "7680x4320",
             "8K UHD"     => "7680x4320",
             "8K UHD-2"   => "7680x4320",
             "CGA1"       => "320x200",
             "CGA2"       => "640x200",
             "Cinema 16K" => "16384x8640",
             "Cinema 2K"  => "2048x1080",
             "Cinema 4K"  => "4096x2160",
             "Cinema 8K"  => "8192x4320",
             "DCI 16K"    => "16384x8640",
             "DCI 2K"     => "2048x1080",
             "DCI 4K"     => "4096x2160",
             "DCI 8K"     => "8192x4320",
             "DGA"        => "960x640",
             "DVGA"       => "960x640",
             "EGA"        => "640x350",
             "FHD"        => "1920x1080",
             "Full HD"    => "1920x1080",
             "FWVGA"      => "854x480",
             "HD"         => "1280x720",
             "HD+"        => "1600x900",
             "HGC"        => "720x348",
             "HQVGA"      => "240x160",
             "HSXGA"      => "5120x4096",
             "HUXGA"      => "6400x4800",
             "HVGA"       => "480x320",
             "HXGA"       => "4096x3072",
             "MCGA"       => "640x480",
             "MDA"        => "720x350",
             "qHD"        => "960x540",
             "QHD"        => "2560x1440",
             "QHD+"       => "3200x1800",
             "QQVGA"      => "160x120",
             "qqVGA"      => "160x120",
             "qSVGA"      => "400x300",
             "QSXGA+"     => "2800x2100",
             "QUXGA"      => "3200x2400",
             "QVGA"       => "320x240",
             "SD"         => "640x480",
             "SVGA"       => "800x600",
             "SXGA"       => "1280x1024",
             "True 16K"   => "16384x8640",
             "True 4K"    => "4096x2160",
             "True 8K"    => "8192x4320",
             "UHD 16K"    => "15360x8640",
             "UHD 4K"     => "3840x2160",
             "UHD 8K"     => "7680x4320",
             "UHD+"       => "5120x2880",
             "UHD-1"      => "3840x2160",
             "UHD-2"      => "7680x4320",
             "UHDTV-1"    => "3840x2160",
             "UHDTV-2"    => "7680x4320",
             "UVGA"       => "800x600",
             "UW10K"      => "10240x4320",
             "UW4K"       => "3840x1600",
             "UW5K"       => "5120x2160",
             "UWQHD"      => "3440x1440",
             "UXGA"       => "1600x1200",
             "VGA"        => "640x480",
             "WGA"        => "768x480",
             "WHSXGA"     => "6400x4096",
             "WHUXGA"     => "7680x4800",
             "WHXGA"      => "5120x3200",
             "WQHD"       => "2560x1440",
             "WQSXGA"     => "3200x2048",
             "WQUXGA"     => "3840x2400",
             "WQVGA"      => "400x240",
             "WQXGA"      => "2560x1600",
             "WQXGA+"     => "3200x1800",
             "WSVGA"      => "1024x600",
             "WUXGA"      => "1920x1200",
             "WVGA"       => "768x480",
             "WXGA 16:10" => "1280x800",
             "WXGA 16:9"  => "1280x720",
             "WXGA 5:3"   => "1280x768",
             "WXGA+"      => "1440x900",
             "XGA"        => "1024x768",
             "XGA+"       => "1152x864",
           },
           {},
         ]

    This function is not exported by default, but exportable.

    No arguments.

    Return value: (hash)

HOMEPAGE
    Please visit the project's homepage at
    <https://metacpan.org/release/Display-Resolution>.

SOURCE
    Source repository is at
    <https://github.com/perlancar/perl-Display-Resolution>.

BUGS
    Please report any bugs or feature requests on the bugtracker website
    <https://rt.cpan.org/Public/Dist/Display.html?Name=Display-Resolution>

    When submitting a bug or request, please include a test-file or a patch
    to an existing test-file that illustrates the bug or desired feature.

SEE ALSO
    <https://en.wikipedia.org/wiki/Display_resolution>

    <https://en.wikipedia.org/wiki/List_of_common_resolutions>

AUTHOR
    perlancar <perlancar@cpan.org>

COPYRIGHT AND LICENSE
    This software is copyright (c) 2018, 2016 by perlancar@cpan.org.

    This is free software; you can redistribute it and/or modify it under
    the same terms as the Perl 5 programming language system itself.

