{"id":16651272,"url":"https://github.com/vvzen/paintball-portraits","last_synced_at":"2026-05-16T18:31:55.275Z","repository":{"id":99228394,"uuid":"147592133","full_name":"vvzen/paintball-portraits","owner":"vvzen","description":"repo of the paintball gun installation for the \"Echosystems\" exhibition (September 2018, Goldsmiths)","archived":false,"fork":false,"pushed_at":"2018-10-09T07:36:11.000Z","size":560,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-04-24T21:43:07.006Z","etag":null,"topics":["arduino","cpp","echosystems","goldsmiths","installation-art","openframeworks"],"latest_commit_sha":null,"homepage":"http://echosystems.xyz/","language":"C++","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/vvzen.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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-09-05T23:45:48.000Z","updated_at":"2021-04-27T13:04:36.000Z","dependencies_parsed_at":"2023-03-23T13:48:24.241Z","dependency_job_id":null,"html_url":"https://github.com/vvzen/paintball-portraits","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/vvzen/paintball-portraits","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vvzen%2Fpaintball-portraits","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vvzen%2Fpaintball-portraits/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vvzen%2Fpaintball-portraits/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vvzen%2Fpaintball-portraits/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vvzen","download_url":"https://codeload.github.com/vvzen/paintball-portraits/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vvzen%2Fpaintball-portraits/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33114167,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-16T04:41:52.686Z","status":"ssl_error","status_checked_at":"2026-05-16T04:41:52.009Z","response_time":115,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["arduino","cpp","echosystems","goldsmiths","installation-art","openframeworks"],"created_at":"2024-10-12T09:24:26.924Z","updated_at":"2026-05-16T18:31:55.254Z","avatar_url":"https://github.com/vvzen.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# paintball-paintings\n\nPlease check the online version of this repo, available here: [https://github.com/vvzen/paintball-portraits](https://github.com/vvzen/paintball-portraits)\n\nThe installation works by getting the live feed from a PS3 eye camera, waiting for the user input, then processing the PS3 cam image by using the [coherent line drawing algorithm](https://www.youtube.com/watch?v=48fTXKUTM-8), sampling the resulting black \u0026 white image with some dots and then streaming the coordinates of each point to the cnc machine via serial communication.\n\nBelow you can find an example of the sampling process applied to the processed image:\n\n![imgs/example_sampling.png](imgs/example_sampling.png)\n\nThe serial communication is bundled inside the osc protocol for readability reasons: using raw byte buffers has definitely less overhead but there is no need for it in my case.\n\nEverytime the of app sends a serial message to the arduino, it waits for the arduino to send back the same message as a response and then procedes with the next message, until each dot has been shot on the canvas.\n\nThe path of the gun is optimised using a nearest neighbour algorithm, which definitely outperforms any kind of genetic algorithm approach that I tested.\n(have a look [here](https://github.com/vvzen/maca-final/tree/master/shortest-path-test))\n\n\n\n## ARDUINO\nOpen the arduino sketch and upload it to the arduino.\nCheck the required libraries by looking at the top of the arduino sketch.\n\n## OPENFRAMEWORKS\nThe openframeworks app requires several different addons:\n\n1. ofxOpenCv\n2. ofxPoco\n3. ofxGui\n4. ofxKinect (required for the libusb driver)\n5. [ofxIO](https://github.com/bakercp/ofxIO)\n6. [ofxSerial](https://github.com/bakercp/ofxSerial) \n7. [ofxCv](https://github.com/kylemcdonald/ofxCv)\n8. [ofxPS3EyeGrabber](https://github.com/bakercp/ofxPS3EyeGrabber)\n9. [ofxFaceTracker](https://github.com/kylemcdonald/ofxFaceTracker)\n\n![imgs/addons.png](imgs/addons.png)\n\n### Installing the addons\nYou can either run the `setup.py` using python3 (see below) or manually download each addon and put it in your openframeworks addons folder.\n\n#### Using setup.py\n\nThe setup.py file will automagically download all the required addons that you don't have installed into your openframeworks addons folder.\n\n1. Open the `setup.py` with a text editor and set the `OF_ROOT` variable to your openframeworks installation folder. In my case, it is `/Volumes/LaCie3TBYas/Code/c++/of_v0.10.0_osx_release` so I will change it like this:\n`OF_ROOT=\"/Volumes/LaCie3TBYas/Code/c++/of_v0.10.0_osx_release\"`\n\n1. open a terminal window and `cd` into the main folder of this repo (maca-final)\n\n2. run `python3 setup.py`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvvzen%2Fpaintball-portraits","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvvzen%2Fpaintball-portraits","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvvzen%2Fpaintball-portraits/lists"}