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.