Historical:Interactive Panoramic Viewer

From PanoTools.org Wiki
Revision as of 18:28, 5 June 2020 by Erik Krause (talk | contribs) (Erik Krause moved page Interactive Panoramic Viewer to Historical:Interactive Panoramic Viewer)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

See SoC 2007 overview for usage hints and a page list.


Freepv is a part of the PanoTools Software Universe and it is an effort to make a universal viewer for the different VR file formats. Thus this project intends to add new features like basic support to some files and enhance the user interactive experience. Since Freepv is at an early stage of development other objectives are to get a stable OpenGL renderer and restructure some components to have a more intuitive extendible architecture.

--Leonox 03:43, 25 March 2007 (CEST)


Freepv is intended to be a cross platform stand alone and plug in panorama viewer and to be able to support different type of files, freepv specially tries to fill some gaps for Linux and Unix user, where there are few support to QTVR, SPi-V and other panorama file formats. Thus this project intend to add new features like basic support to SPi-V file format and a better one for QTVR files.

Freepv is at an early stage of development. Thus there are a lot of improvements to do, like restructuring and cleaning up the code, adding comments and of course optimizing parts like the OpenGL renderer, I will help with this issues making a more stable renderer to work with.

Then I will have to extend or restructure the Scene and Camera class, which act like an interface between the QTVRdecoder and the renderer; these classes should be more flexible to handle different panoramic formats. With these enhanced class or classes, you will need just to implement the file decoder module, which you desire. These modules should fill these classes’ internal data structure and the renderer would work with the file data through these class or classes.

The next part of the project will consist in adding a basic SPi-V XML file format support, this will consist in adding an XML parser and implementing the SPIVdecoder, for this purpose I will need to read in detail the SPi-V XML file format specification. To the end of this part, the viewer should be able to display basic SPi-V panoramas; basically it will handle data from the meta node.

Other thing is to create a very basic freepv XML format, this as an alternative to read the different cubic faces JPEG images from the program argument list, it would be easier to specify just an XML file, that could be a Freepv file or a SPi-V file.

The last part of the project will consist in enhance the user interactive experience adding the support to hotspots; this will enable the user to make a virtual tour, switching from one scenes to another by just clicking over the hotspots. This last feature should be supported for both QTVR and SPi-V file formats, in order to this I will have to plan and design a component to handle the different scenes of a tour. Furthermore most of the hotspots in SPi-V are made with images that not necessarily are JPEG, so it will be needed to add support to files like PNG and GIF.

The hotspots could be points, squares or polygons, for the design of the hotspot interface, I should contemplate these three possible configurations. I’ll need to check the EventListener class and to implement a basic collision detection algorithm. The hotspots will support basic events, like roll over and click. Taking advantage of the new image readers formats and the SPi-V file format, it would be nice to be able to display flat images with the panoramic views, this images then could behave as buttons or external links to WebPages.

QTVR hotspots [1] SPi-V Panoelement (hotspots)[2]

Finally Freepvis able to become an interesting and useful tool for the panorama tools community, this project intent to be one step further in the direction to achieve the Freepv main objectives.

--Leonox 03:43, 25 March 2007 (CEST)


1. Have a more stable OpenGL renderer.

2. Make SPi-V file format avalaible for Linux/Unix users.

3. Add Freepv support to Hotspots.

4. Have a more clean and understandable code.


1. Planification

2. Design

3. Implementation

4. Testing period


By the end of this project, the deliverables should completed.

The deliverables will contain the following items:

  • A library (libfreepv) that will contain the next components:
    • Cylindrica, Equirectangular and cubic enhanced renderer.
    • Restructured class to handle data files.
    • SPIV decoder.
    • GIF PNG image readers.
  • A standalone application as an implementation of the libfreepv plataform (Linux/Windows).
  • A firefox plugin as an implementation of the libfreepv plataform (Linux/Windows).
  • The source code.

--Leonox 03:56, 25 March 2007 (CEST)



  • April 11: Begin a deeper familiarization with the project code, set up every thing (lib, compilers, etc…), so that I don’t have problems to begin coding.
  • April 23: Read articles, literature, papers and specifications, solve any doubt left with the mentors and the community.
  • May 9: Read with more detail the files specification and finally discuss with my mentors and the project community some implementation details.
  • May 28: Begin cleaning up the code and restructuring the OpenGL renderer, I'll be working in the cylindrical cubic and equirectagular rendering engines.
  • Jun 11: Begin with the Testing period.
  • Jun 18: Begin coding the file decoder class using the XML parser, planning the new image readers (PNG,GIF) and the changes that would be needed to make over Scene and Camera classes.
  • June 29: To this date Opengl renderer must be stable, be crossplataform and must be well documented. Begin with the image readers’ implementation and begin the planning of hotspots.
  • July 9: To this date it must be able to read basic SPi-V formats and I'll begin codifying hotspot and flat image loader.
  • August 13: Begin with the Testing period.
  • August 20: To this date hotspots and flat image loader should work.
  • August 31: The Final Day.

--Leonox 03:43, 25 March 2007 (CEST)


This planification is an estimation of the amount of time needed by each task:

OpenGL Renderer

Planification/Research: 1 week.

Design/Implementation: 2 weeks.

Testing period: 1 week.

SPi-V / Scene&Camera classes

Planification/Research: 1 week.

Design/Implementation: 2 weeks.

Testing period: 1 week.

Image loader

Planification/Research: 1 week.

Design/Implementation: 1 week.


Planification/Research: 1-2 weeks.

Design/Implementation: 2 weeks.

Testing period: 1 week.

Final Note

Some task could be overlapped, for example I could being coding and at the same time I would begin the planification of another task. This intend to make the process of developing faster and natural.

The approach of the project would be from bottom to the top, since the OpenGL need to be more stable to work with, then this should make easier other task like the implementation of Hotspots or the SPi-V decoder.

Every Friday a Report will be written to the mentors; it’ll have all the achieved sub-task, that were made in the week, the next task to be made in the following week and problems that I could be having.

--Leonox 01:39, 1 April 2007 (CEST)


Leon Moctezuma


  • Aldo Hoeben

Other people willing to help:

  • Yuval Levy
  • Pablo d'Angelo
  • Fulvio Senore
  • Ken Turkowski

--Leonox 16:53, 17 April 2007 (CEST)

Project Status

The project was accepted by Google [3]

--Leonox 17:02, 17 April 2007 (CEST)