docs/random/ensonic/interfaces.txt

   1 $Id$
   2
   3 * existing gstreamer interfaces
   4   ./gstreamer/gst/gsttaginterface.c
   5   ./gstreamer/gst/gstinterface.c
   6   ./gstreamer/gst/gsturi.c
   7   ./gst-plugins/gst-libs/gst/propertyprobe/propertyprobe.c
   8   ./gst-plugins/gst-libs/gst/mixer/mixer.c
   9   ./gst-plugins/gst-libs/gst/tuner/tuner.c
  10   ./gst-plugins/gst-libs/gst/xoverlay/xoverlay.c
  11   ./gst-plugins/gst-libs/gst/colorbalance/colorbalance.c
  12   ./gst-plugins/gst-libs/gst/navigation/navigation.c
  13 * new general interfaces
  14   * GST_TYPE_PRESET_MANAGER
  15     - add preset managment
  16     - API:
  17       GList *get_presets();
  18       void activate_preset_by_index(glong index);
  19       void activate_preset_by_name(const gchar *name);
  20       void add_current(const gchar *name);
  21       void remove_preset_by_index(glong index);
  22       void remove_preset_by_name(const gchar *name);
  23     - features
  24       - there should always be a default preset
  25     - questions
  26       - were and how do we store the presets?
  27
  28   * GST_TYPE_UI_HINT
  29     - add hints to generate 'good' looking interfaces to elements
  30     - API:
  31       GList *get_group_list();
  32       struct ui_hint_group {
  33         gchar *label;
  34         gachr *role;
  35         GList *entries;
  36       }
  37       struct ui_hint_group_entry {
  38         enum UiHintGroupEntryType type={PARAM,DPARAM};
  39         gchar *name;
  40       }
  41       roles {
  42         /* graphics */
  43         "color_selection/rgb",
  44         "color_selection/hsv",
  45         "aspect_ratio",
  46         /* audio */
  47         "envelope/adsr",
  48       }
  49     - features
  50       - grouping of parameters, each group has:
  51         - a label: giving a title to the group
  52         - a role:
  53           - this can give the UI a hint about the purpose of the controls
  54           - this only makes sense, if we dont make this a thousand templates
  55         - a list of dparams or properties
  56     - question
  57       - should this be aware of instruments (voice-groups)
  58         - no, instruments should auto-generate those
  59
  60 * new interfaces for audio applications
  61   * GST_TYPE_MUSIC_GENERATOR
  62     - add hints so that application can use a element as an instrument
  63     - API:
  64       // param types
  65       DParam *get_note_dparam();
  66       GList *get_trigger_dparams();
  67       // -- or
  68       DParamType get_dparam_type(DParam *);
  69       dparamtype = { NOTE, TRIGGER, OTHER }
  70       // voices
  71       char *get_number_of_voices_property();
  72       GList *get_global_param_names();
  73       GList *get_voice_param_names();
  74     - features
  75       - find out which params to use to play notes/trigger sounds
  76         - these params will not appear in a control-ui
  77         - notes involve a key to frequency translation
  78       - find out if the element has a number_of_voices property
  79         - if yes, we can find out about the max by looking at the gparamspec
  80         - setting the property, adds/removes voices
  81         - if the element supports it, it needs to:
  82           - register voice-dparams as e.g. note_XXX, where XXX is the voice-number
  83           - run the voice-loop in the chain/loop function
  84             each voice processes the same input, if at all
  85             the outputs of all voices are mixed together
  86