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.