{"id":21644455,"url":"https://github.com/samsung/360tools","last_synced_at":"2025-04-11T18:22:51.483Z","repository":{"id":54816747,"uuid":"64740779","full_name":"Samsung/360tools","owner":"Samsung","description":"The 360tools package is software for VR video processing experiments. The software includes both 360 video conversion and quality metrics functionality","archived":false,"fork":false,"pushed_at":"2023-04-07T10:30:37.000Z","size":3305,"stargazers_count":110,"open_issues_count":5,"forks_count":42,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-04-11T18:22:16.329Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Samsung.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2016-08-02T08:53:04.000Z","updated_at":"2025-03-15T03:15:38.000Z","dependencies_parsed_at":"2022-08-14T03:40:45.449Z","dependency_job_id":"d981fa5c-7864-4259-80a5-c0c6420aba0d","html_url":"https://github.com/Samsung/360tools","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samsung%2F360tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samsung%2F360tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samsung%2F360tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samsung%2F360tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Samsung","download_url":"https://codeload.github.com/Samsung/360tools/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248456386,"owners_count":21106607,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-25T05:40:18.960Z","updated_at":"2025-04-11T18:22:51.449Z","avatar_url":"https://github.com/Samsung.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 360tools \n\n\tProjection and quality evaluation tools for VR video compression exploration experiments\n\n## Description\n\t+ 360tools_conv is used for conversion between different projection formats\n\t+ 360tools_metric implements various quality metrics for vR video quality evaluation\n\t\n\tThe 360tools is software for VR video processing experiments.\n\tThe software includes both 360 video conversion and quality metrics\n\tfunctionality\n\t\n\t360tools software is useful in aiding users of a 360 VR video coding\n\texperiments to establish and test various processing techniques for VR video\n\tcontent.\n\t360tools is useful to educate users. For these purposes, the software is\n\tprovided as an aid for the study and implementation of 360 VR video coding and\n\tmay eventually be formally published as reference software, e.g., by\n\tITU-T and ISO/IEC.\n\t\n\tThis software may be subject to other third party and contributor rights,\n\tincluding patent rights and no such rights are granted.\n\n## Building\n\nCheckout the source for 360 Tools\n\n\t+ Windows\n\tIn 360tools/build/x86_windows/\n\tselect corresponding *.sln file\n\tbuild and run with preferred visual studio 2008 or 2010\n\tExecutable files are stored to 360tools/bin/ directory\n\t\n\t+ Linux\n\tIn 360tools/build/x86_linux/\n\texecute make command \n\tExecutable files are stored at 360tools/bin/ directory\n\n## Example usage for conversion tool\n\n\t./360tools_conv -i [file] -o [file] -f [int] -w [int] -h [int] -l [int] -m [int] -x [int] -y [int]\n\t./360tools_conv -i glacier_vr_24p_3840x1920.yuv -w 3840 -h 1920 -x 1 -o glacier_vr_24p_isp_4268x2016.yuv -l 4268 -m 2016 -y 1 -f 5 -n 10\n\t\n## Example usage for quality metrics\n\n\t./360tools_metrics -w [int] -h [int] -f [int] -o [file] -q [int] -l [int] -m [int] -t [int] -r [file] -n [int] -x [int]\n\t./360tools_metrics -w 4096 -h 2048 -f 1 -o glacier_vr_24p_3840x1920.yuv -q 4 -l 4268 -m 2016 -t 2 -r glacier_vr_24p_isp_4268x2016.yuv -n 7 -x 1 \n\t\n## Supported formats\n\t+\tEquirectangular projection (ERP)\n\t+\tIcosahedral projection (ISP)\n\t+\tOctahedron projection (OHP)\n\t+\tCubemap projection (CMP)\n\t+\tTruncated Square Pyramid projection (TSP)\n\t+\tSegmented Sphere Projection (SSP)\n\t+\tReshaped Icosahedral projection (RISP)\n\t+\tReshaped Octahedron projection (ROHP)\n\t+\tReshaped Cubemap projection (RCMP)\n\t\n## Supported quality metrics\n\t+\tPSNR - conventional Peak Signal to Noise Ratio quality metrics\n\t+\tS-PSNR - spherical PSNR (requires sphere_655362.txt file with point coordinates)\n\t+\tWS-PSNR - weighted Spherical PSNR (for equirectangular projection only)\n\t+\tCPP-PSNR - equal area common projection PSNR\n\t\n## Conversion parameters\n\t+\tMandatory\n\t\t-i\tinput file name\n\t\t-o\toutput file name\n\t\t-w\tinput image width\n\t\t-h\tinput image height\n\t\t-l\toutput image width\n\t\t-m\toutput image height\n\t\t-x\tinput image colorspace\n\t\t-y\toutput image colorspace\n\t\t-f\tconversion format\n\t\t\n\t+\tOptional\n\t\t-n\tnumber of converted frames\n\t\t-a\talign to multiple of size\n\t\t-u\tdisable padding\n\t\t-c\tconfig file\n\t\t-p\tpitch angle\n\t\t-y\tyaw angle\n\t\t\n## Quality metrics parameters\n\t+\tMandatory\n\t\t-o\toriginal file\n\t\t-r\treconstructed file\n\t\t-w\twidth original\n\t\t-h\theight original\n\t\t-q\tmetrics type\n\t\t-x\toriginal image colorspace\n\t\t-y\treconstructed image colorspace\n\t\t\n\t+\tOptinal\n\t\t-l\twidth reconstructed\n\t\t-m\theight reconstructed\n\t\t-n\tnumber of frames\n\t\t-s\tspheric coordinates file, mandatory for S-PSNR\n\t\t-f\tprojection format original, mandatory for CPP-PSNR\n\t\t-t\tprojection format reconstructed for CPP-PSNR\n\t\t-c\tconfig file\n\t\t\n## Recommended equal spatial resolution: number of pixels in each projection is constant \n\t(S_ERP == S_ISP == S_CPP); Value is suggested for HM and JEM sw\n\t+\tERP \t\t3840x1920\n\t\t- ISP\t\t4928x2328\n\t\t- OHP\t\t5984x2592\n\t\t- CMP\t\t3840x2880\n\t\t- TSP\t\t1920x960\n\t\t- SSP\t\t3840x2880\n\t\t\n\t+\tERP \t\t4096x2048\n\t\t- ISP\t\t4928x2328\n\t\t- OHP\t\t6208x2688\n\t\t- CMP\t\t4096x3072\n\t\t- TSP\t\t2048x1024\n\t\t- SSP\t\t4096x3072\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamsung%2F360tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsamsung%2F360tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamsung%2F360tools/lists"}