The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
 / 
Display-Resolution-0.005
River stage one • 5 direct dependents • 6 total dependents
++
/ Display::Resolution

NAME

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

VERSION

This document describes version 0.005 of Display::Resolution (from Perl distribution Display-Resolution), released on 2019-07-02.

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",
     "KVCDx3 480p"  => "528x480",
     "KVCDx3 576p"  => "528x576",
     "KVCDx3A 480p" => "544x480",
     "KVCDx3A 576p" => "544x576",
     "MCGA"         => "640x480",
     "MDA"          => "720x350",
     "NTSC SVCD"    => "480x480",
     "NTSC VCD"     => "352x240",
     "PAL SVCD"     => "480x576",
     "PAL VCD"      => "352x288",
     "qHD"          => "960x540",
     "QHD"          => "2560x1440",
     "QHD+"         => "3200x1800",
     "qqVGA"        => "160x120",
     "QQVGA"        => "160x120",
     "qSVGA"        => "400x300",
     "QSXGA+"       => "2800x2100",
     "QUXGA"        => "3200x2400",
     "QVGA"         => "320x240",
     "SD"           => "640x480",
     "SECAM SVCD"   => "480x576",
     "SECAM VCD"    => "352x288",
     "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) 2019, 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.