GSoC: Week – 1

So, my scheduled work according to the timeline, for the first week of the coding period, is over. Here are the few changes made to Marble:

Marble has got something called “Tours”. It can be used to take a virtual tour of the world by visiting different places according to a defined playlist. Now, this “timeline” consists of four type of items:

  • FlyTo – These are fixed locations somewhere on Earth, with some coordinates, denoting a definite point on Earth. These are the very locations to which the tours travel to one by one, when it is played.
  • TourControl – These items are used for controlling the tour. These can be either “Play” or “Pause”. With their usual meanings, i.e., “Pause” will pause the tour, and “Play” will resume it.
  • Wait – These items, when encountered in the playlist, the tour playback stops for a definite amount of time. Wait items contain a value in seconds, defining the amount of time the tour has to wait, when it encounters this item.
  • SoundCue – Last but not the least, there is the SoundCue item, which is used for playing background music during the playback of the tour. Generally they are given towards the beginning, but you can place them anywhere in the playlist, and the sound will start playing in the background parallelly, when the item is encountered.

There is a separate TourWidget present in Marble, which handles these tours. Although it did have the functionality to open existing tours, and view them in the playlist, along with removing a few FlyTo items, but it did not have the ability to edit each of the Tour items, from inside the TourWidget itself. So, this is exactly what I did in my first week: Adding functionality for editing Tour items from the TourWidget.

This is how the Tour’s playlist looks like, after a tour is loaded:

Tour Playlist Normally


Now, notice the small Edit buttons adjacent to each item. Those are the buttons which trigger the Edit-mode by which we can edit each item. That is the exact functionality which I implemented. So, here goes a preview of the TourWidget, with a few of the item’s Edit button clicked:

Tour Playlist Edit mode


Here, the 1st, 2nd, 3rd, and fifth items are in Edit mode, and the others are not. By looking at the preview itself, I guess you can get a feel for what and how the items get changed. Anyways, so after making the desired changes, you just got to click on the Save button adjacent to the item, and the value shows up in the Tour Playlist again, but this time, with the modifications made during Edit-mode.

So, one hurdle complete. More to come, in the coming weeks! 🙂