{"id":22703408,"url":"https://github.com/arshitarora/image-overlaying-prespective","last_synced_at":"2026-05-09T04:33:30.238Z","repository":{"id":185233041,"uuid":"672945960","full_name":"ArshitArora/Image-Overlaying-Prespective","owner":"ArshitArora","description":"Perform perspective warping and image fusion in Python using OpenCV and NumPy. Select four points on the base image to define the region where the subject image will be warped and fused. The script creates a fused image and saves it as Final_Output.png. 🖼️🌌🔮","archived":false,"fork":false,"pushed_at":"2023-08-01T05:54:42.000Z","size":1496,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-29T19:44:57.032Z","etag":null,"topics":["image","numpy","opencv","python","swap"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ArshitArora.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-07-31T14:16:52.000Z","updated_at":"2024-04-09T21:58:59.000Z","dependencies_parsed_at":"2023-08-01T07:05:25.975Z","dependency_job_id":null,"html_url":"https://github.com/ArshitArora/Image-Overlaying-Prespective","commit_stats":null,"previous_names":["delicate-jerk/image-overlaying-prespective","arshitarora/image-overlaying-prespective"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ArshitArora/Image-Overlaying-Prespective","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArshitArora%2FImage-Overlaying-Prespective","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArshitArora%2FImage-Overlaying-Prespective/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArshitArora%2FImage-Overlaying-Prespective/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArshitArora%2FImage-Overlaying-Prespective/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ArshitArora","download_url":"https://codeload.github.com/ArshitArora/Image-Overlaying-Prespective/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArshitArora%2FImage-Overlaying-Prespective/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32807252,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"online","status_checked_at":"2026-05-09T02:00:06.633Z","response_time":123,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["image","numpy","opencv","python","swap"],"created_at":"2024-12-10T08:10:35.059Z","updated_at":"2026-05-09T04:33:30.217Z","avatar_url":"https://github.com/ArshitArora.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Perspective Warping and Image Fusion 🌌🔮\n\nThis Python script allows you to perform perspective warping and image fusion between two images. It enables you to select four points on the base image, and then it warps and fuses the subject image onto the selected region of the base image. 🖼️🔍\n\n## Prerequisites 🛠️🔧\n\nTo run this script, you need to have the following libraries installed:\n\n- OpenCV (cv2) 📸\n- NumPy 🧮\n\nYou can install the required libraries using pip: \n\n## Usage 🚀📝\n\n1. Clone or download the repository. 📥\n\n2. Navigate to the project directory. 📂\n\n3. Run the Python script with the required arguments:\n\n\u003cimg src ='base_img.jpg' width = 300 height=250\u003e \u003cimg src ='subject.jpg' width = 300\u003e  \n\n**Selecting the corner points**   \nEvery time you click on a point, the chosen point is highlighted using a red dot as shown below.  \n\n\u003cimg src ='points_selector.gif' width = 300 height=250\u003e  \n\n## Output :\n\u003cimg src ='images/Final_Output.png' width = 300 height=250\u003e   \n\n\n\n## Usage :\n\nTo run without debug enabled :-  \n`python main.py --base_img base_img.jpg --subject_img subject.jpg`\n\nTo run with debug enabled :-  \n`python main.py --base_img base_img.jpg --subject_img subject.jpg --debug True`\n\nEnabling debug would allow you to visualize the intermediate masks and processed images so that \nyou can better analyze where you're going wrong and remedy the problem accordingly.\n\n\n\n## Notes 📝🚩\n\n- Make sure the selected points form a convex polygon. Otherwise, the script may not produce the desired results. 🧩❌\n\n- The subject image will be scaled to fit the selected region on the base image. The aspect ratio of the subject image may be distorted if the selected region is not a parallelogram. 🔍🔄🔮\n\n- The script saves the final fused image as `Final_Output.png` in the project directory. 💾💼\n\n---\n\nPlease make sure to include this `README.md` file with your project so that users can understand how to use the script effectively. 📝🆒\n\n\nDo let me know if you face any issues. I'll do my best to help :)  \nHappy Learning People ! Keep chasing your dreams ! ⭐️\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farshitarora%2Fimage-overlaying-prespective","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farshitarora%2Fimage-overlaying-prespective","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farshitarora%2Fimage-overlaying-prespective/lists"}