Difference between revisions of "Activity Team/Object Chooser"

From Sugar Labs
Jump to navigation Jump to search
Line 17: Line 17:
  
 
  if version >= [0, 84]:
 
  if version >= [0, 84]:
    # Insert here code relevant to Sugar 0.84 and higher
+
    # Insert here code relevant to Sugar 0.84 and higher
    # I use this to only display Object Chooser callback buttons only for >= 0.84
+
    # I use this to only display Object Chooser callback buttons only for >= 0.84
    # Clicking one of the displayed buttons calls the choose method
+
    # Clicking one of the displayed buttons calls the choose method
  
 
  def choose(self, widget):
 
  def choose(self, widget):
  chooser =  ObjectChooser(parent=self, what_filter=mime.GENERIC_TYPE_AUDIO)
+
    chooser =  ObjectChooser(parent=self, what_filter=mime.GENERIC_TYPE_AUDIO)
  result = chooser.run()
+
    result = chooser.run()
  if result == gtk.RESPONSE_ACCEPT:
+
    if result == gtk.RESPONSE_ACCEPT:
  self.jobject = chooser.get_selected_object()
+
    self.jobject = chooser.get_selected_object()
  if self.jobject is not None:
+
    if self.jobject is not None:
      self.path = str(self.jobject.get_file_path())
+
        self.path = str(self.jobject.get_file_path())
  
 
=== Random observations: ===
 
=== Random observations: ===
  
:1. I exclude Sugar 0.82 for two reasons (which means, unfortunately, "no user soundfiles for 0.82"):
+
# I exclude Sugar 0.82 for two reasons (which means, unfortunately, "no user soundfiles for 0.82"):
::(a) its version of Object Chooser does not allow filtering for the audio mime type;
+
#* its version of Object Chooser does not allow filtering for the audio mime type;
::(b) Sugar 0.82's Csound (5.08) - or more specifically its version of libsndfile - does not handle ogg vorbis soundfiles, the type that the Record activity creates. Record is the most likely/accessible means that children would use to create their own soundfiles. (The whole idea behind using Object Chooser here is to select user files that have been placed in the Journal [as Record does by default] for performance in FileMix.)
+
#* Sugar 0.82's Csound (5.08) - or more specifically its version of libsndfile - does not handle ogg vorbis soundfiles, the type that the Record activity creates. Record is the most likely/accessible means that children would use to create their own soundfiles. (The whole idea behind using Object Chooser here is to select user files that have been placed in the Journal [as Record does by default] for performance in FileMix.)
::(c) In addition, earlier versions of Record (<v64 or so) create ogg SPEEX soundfiles; even the recent versions of Csound (actually, libsndfile) do not handle this (lo-fi) format.
+
#* In addition, earlier versions of Record (<v64 or so) create ogg SPEEX soundfiles; even the recent versions of Csound (actually, libsndfile) do not handle this (lo-fi) format.
 +
# self.path stores the soundfile name (complete path); self.jobject stores the object itself. This is key to being able (in Csound) to locate and load the selected soundfile. self.path is then a channel opened to send the named soundfile to Csound.
 +
# If the user closes the Object Chooser box instead of clicking on a sound object, the result is not accepted, and self.path reverts to "0" - which is a flag (in Csound) to revert to the default soundfile included in FileMix.
 +
# The str() cast for self.jname1 converts the filename to the usual path format readable by Csound (this too is required). It is dbus string object... maybe we need to this type cast in sugar-toolkit code (though in most cases this casting should happen implicitly).
  
 
+
''Art Hunkins and Aleksey Lim''
:2. self.path stores the soundfile name (complete path); self.jobject stores the object itself. This is key to being able (in Csound) to locate and load the selected soundfile. self.path is then a channel opened to send the named soundfile to Csound.
 
 
 
:3. If the user closes the Object Chooser box instead of clicking on a sound object, the result is not accepted, and self.path reverts to "0" - which is a flag (in Csound) to revert to the default soundfile included in FileMix.
 
 
 
:4. The str() cast for self.jname1 converts the filename to the usual path format readable by Csound (this too is required). It is dbus string object... maybe we need to this type cast in sugar-toolkit code (though in most cases this casting should happen implicitly).
 
 
 
''Art Hunkins and Aleksy Lim''
 

Revision as of 11:40, 22 December 2010

The Sugar Object Chooser

The following example is modified from the FileMix activity. Note that it invokes the Chooser to select objects of mime type GENERIC_TYPE_AUDIO.

from sugar.graphics.objectchooser import ObjectChooser
from sugar import mime
self.path = "0"
self.jobject = None
# Determine which version of Sugar you are running
try:
    from jarabe import config
    version = [int(i) for i in config.version.split('.')][:2]
except ImportError:
    version = [0, 82]
if version >= [0, 84]:
    # Insert here code relevant to Sugar 0.84 and higher
    # I use this to only display Object Chooser callback buttons only for >= 0.84
    # Clicking one of the displayed buttons calls the choose method
def choose(self, widget):
    chooser =  ObjectChooser(parent=self, what_filter=mime.GENERIC_TYPE_AUDIO)
    result = chooser.run()
    if result == gtk.RESPONSE_ACCEPT:
    self.jobject = chooser.get_selected_object()
    if self.jobject is not None:
        self.path = str(self.jobject.get_file_path())

Random observations:

  1. I exclude Sugar 0.82 for two reasons (which means, unfortunately, "no user soundfiles for 0.82"):
    • its version of Object Chooser does not allow filtering for the audio mime type;
    • Sugar 0.82's Csound (5.08) - or more specifically its version of libsndfile - does not handle ogg vorbis soundfiles, the type that the Record activity creates. Record is the most likely/accessible means that children would use to create their own soundfiles. (The whole idea behind using Object Chooser here is to select user files that have been placed in the Journal [as Record does by default] for performance in FileMix.)
    • In addition, earlier versions of Record (<v64 or so) create ogg SPEEX soundfiles; even the recent versions of Csound (actually, libsndfile) do not handle this (lo-fi) format.
  2. self.path stores the soundfile name (complete path); self.jobject stores the object itself. This is key to being able (in Csound) to locate and load the selected soundfile. self.path is then a channel opened to send the named soundfile to Csound.
  3. If the user closes the Object Chooser box instead of clicking on a sound object, the result is not accepted, and self.path reverts to "0" - which is a flag (in Csound) to revert to the default soundfile included in FileMix.
  4. The str() cast for self.jname1 converts the filename to the usual path format readable by Csound (this too is required). It is dbus string object... maybe we need to this type cast in sugar-toolkit code (though in most cases this casting should happen implicitly).

Art Hunkins and Aleksey Lim