{"id":15451501,"url":"https://github.com/davidar/pixelstruct","last_synced_at":"2025-04-28T16:23:32.395Z","repository":{"id":33463573,"uuid":"37109125","full_name":"davidar/pixelstruct","owner":"davidar","description":"a tool for visualising 3D scenes reconstructed from photographs","archived":false,"fork":false,"pushed_at":"2016-12-02T01:55:36.000Z","size":200,"stargazers_count":45,"open_issues_count":7,"forks_count":10,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-03-30T11:11:55.735Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/davidar.png","metadata":{"files":{"readme":"README","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-06-09T03:57:42.000Z","updated_at":"2023-07-07T21:11:04.000Z","dependencies_parsed_at":"2022-09-12T21:42:44.427Z","dependency_job_id":null,"html_url":"https://github.com/davidar/pixelstruct","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidar%2Fpixelstruct","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidar%2Fpixelstruct/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidar%2Fpixelstruct/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidar%2Fpixelstruct/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/davidar","download_url":"https://codeload.github.com/davidar/pixelstruct/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251343365,"owners_count":21574349,"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-10-01T21:26:46.713Z","updated_at":"2025-04-28T16:23:32.373Z","avatar_url":"https://github.com/davidar.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"ABOUT\nPixelStruct[1] is an opensource tool for visualizing 3D scenes reconstructed\nfrom photographs. It uses the opensource structure-from-motion system\nBundler[2], which is based on the same research as Microsoft Live Labs\nPhotosynth[3].\n\nHOW TO COMPILE\nPixelStruct requires the following libraries:\n - Qt4 (with OpenGL support)\n - CGAL\n\nYou will also need to install CMake in order to build PixelStruct.\n\nAll of the above can be installed in Ubuntu (and likely other Debian-based\ndistributions) by running\n    sudo aptitude install libqt4-dev libcgal-dev cmake\n\nOnce you have installed these, compile the program by running `make` in the\nproject root directory.\n\nThis will create a binary called 'pixelstruct' in the current directory.\nYou can either copy this executable into your PATH for system-wide access, or\njust run it immediately by either calling `./pixelstruct` in a terminal or by\nopening it with your file browser.\n\nUSAGE\nPixelStruct requires Bundler, which can be downloaded from [2]. First, you need\nto manually run Bundler on a directory of images as described in the README.txt\nfile contained in the Bundler distribution. Once Bundler has completed\nprocessing the images, the image set can be loaded into PixelStruct.\n\nIf you do not want to manually run Bundler, and would rather view a\npre-processed dataset, you have two options:\n- download the small (3.6MB) Kermit example from [4], untar it, and open the\n  kermit/ directory in PixelStruct\n- download the very large (1.8GB) Notre Dame example from [5], unzip it, create\n  a bundle/ directory inside the NotreDame/ directory, copy/move notredame.out\n  to bundle/bundle.out, and open the NotreDame/ directory in PixelStruct\n\nTo view a processed dataset, launch PixelStruct as described above, and go to\n\"File\u003eOpen image directory\". Navigate into the image directory you ran Bundler\non, and hit \"Choose\"/\"Open\". Alternatively you can specify the image directory\nas a command-line argument when launching PixelStruct. The 3D point cloud will\nbe loaded into the window, and once the viewer has focus (you may have to click\non it for this), the camera will focus on the first image.\n\nYou can now hit your Return key to move to the next image, or use your arrow\nkeys to move to another image in the chosen direction. Pressing Page Up and\nPage Down will attempt to move the camera closer to and further away from the\nphotographed object respectively.\n\nThe View menu allows you to choose between several transition modes, as\ndescribed in section 5.3 of [6].\n\nQPL-GPL INCOMPATIBILITY NOTICE\nAs portions of CGAL are licensed under the QPL[7] which is incompatible with\nthe GPL (see the QPL secction of [8]), the following notice is required:\n  As a special exception, you have permission to link this program\n  with the CGAL library and distribute executables, as long as you\n  follow the requirements of the GNU GPL in regard to all of the\n  software in the executable aside from CGAL.\n\n[1] http://da.vidr.cc/projects/pixelstruct/\n[2] http://phototour.cs.washington.edu/bundler/\n[3] http://photosynth.net/\n[4] http://pixelstruct.googlecode.com/files/kermit-example-bundler0.3.tar.gz\n[5] http://phototour.cs.washington.edu/datasets/NotreDame.zip\n[6] http://phototour.cs.washington.edu/Photo_Tourism.pdf\n[7] http://doc.trolltech.com/4.3/qpl.html\n[8] http://www.fsf.org/licensing/licenses/index_html\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidar%2Fpixelstruct","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdavidar%2Fpixelstruct","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidar%2Fpixelstruct/lists"}