README.txt 3.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107
  1. ==========================
  2. Extended View Toolkit
  3. ==========================
  4. http://extendedview.mur.at
  5. Extended View Toolkit is an abstraction library for PureData towards
  6. panoramic imagery creation and projection mapping.
  7. Description
  8. -----------
  9. Extended View Toolkit is a set of abstractions for combining multiple
  10. video or image sources into a panoramic image and for projection
  11. setups with mutliple projectors or projection environments with
  12. challenging geometric forms, better known as video mapping.
  13. Multiple input media (e.g. camera input, video files, image files,
  14. 3D renderings) can be processed. It is possible to create
  15. imagery or video by either stitching multiple inputs to one continuous,
  16. or by unwrapping a 360-degree image taken with a special optical lens
  17. system. Such processed media input can then be projected onto even
  18. irregular shaped surfaces. It is possible to blend smoothly between
  19. multiple projectors, to create seamless immersive media environments.
  20. Extended View Toolkit was originally created at the "Institute for Electronic
  21. Music and Acoustics"/Graz within the CO-ME-DI-A project, lead by
  22. Winfried Ritsch for the art installation "Extended View" by Peter Venus.
  23. The CO-ME-DI-A project was supported by the Education, Audiovisual &
  24. Culture Executive Agency (EACEA) of the European Comission for
  25. the period 2007 - 2010 (http://www.comedia.eu.org/).
  26. Getting started
  27. ---------------
  28. For an abstracion overview, open "01_ev_module_list.pd".
  29. Go through the examples, to learn about the possibilities of the toolkit.
  30. There are also individual help-patches for most of the modules.
  31. The abstractions are divided into groups by folders:
  32. "ev-in" abstractions for media input,
  33. i.e. video files, image files or camera input.
  34. "ev-main" general abstractions of the toolkit.
  35. "ev-pano" panoramic image or video creation
  36. "ev-pro" abstractions for video projection mapping.
  37. "ev-glsl" abstractions to load OpenGL shaders
  38. (contains subfolder with some shader files).
  39. There are also folders for additional files:
  40. "data" contains the state-saving data of the example patches.
  41. "media" contains media files, like videos or images.
  42. "libs" contains external libraries that are used by the toolkit.
  43. Requirements
  44. ------------
  45. __Software:__
  46. * PureData or Pd-extended (http://puredata.info/downloads)
  47. * Gem 0.92.3 or higher
  48. (included in Pd-extended or to be downloaded from http://gem.iem.at)
  49. * For OSC support, additional libraries may be nessecary
  50. (e.g. mrpeach, iemnet; included in Pd-extended)
  51. __Operating System:__
  52. The abstractions have been tested on Linux (Debian/Ubuntu),
  53. Mac OSX 10.6/10.7 and Microsoft Windows 7.
  54. __Hardware:__
  55. Recent graphics hardware required to have access to full OpenGL
  56. capabilities of GEM
  57. __Following problems have to be considered:__
  58. Connecting more than one USB camera of the same type to a Windows
  59. or Mac Computer requires lots of tweaking, but works fine under Linux.
  60. Source
  61. ------
  62. https://github.com/extendedview/extended_view_toolkit
  63. Copyright/License
  64. -----------------
  65. Copyright (C) 2010-2012 Peter Venus, Marian Weger, Cyrille Henry and IEM
  66. This program is free software: you can redistribute it and/or modify
  67. it under the terms of the GNU General Public License as published by
  68. the Free Software Foundation, either version 3 of the License, or
  69. (at your option) any later version.
  70. This program is distributed in the hope that it will be useful,
  71. but WITHOUT ANY WARRANTY; without even the implied warranty of
  72. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  73. GNU General Public License for more details.
  74. You should have received a copy of the GNU General Public License
  75. along with this program. If not, see <http://www.gnu.org/licenses/>.