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.