design/media.txt

   1 Media uses
   2   audio (songs)
   3   sound effects (drama or whatever, triggered sequentially or spontaniously)
   4   video background (looping)
   5   video with audio (song with lyrics or video)
   6
   7 requirements
   8   [ ] audio media have individual saved volumes / mute
   9   [ ] video media have individual saved settings (brightness, contract, saturation, hue etc)
  10   [ ] playing media information
  11       [ ] seeker if seekable
  12       [ ] volumes, mute, brightness, contrast, saturation, hue etc. saving to individual item
  13       [ ] "remember for this file" button
  14           [ ] resolution in case another playlist already has overrides
  15   [ ] extract metadata (track name etc)
  16   [ ] remember audio output device (pulse audio or whatever)
  17   [ ] simple media player, randomising, queueing etc
  18       [ ] crossfading
  19       [ ] fade out before switching track
  20
  21 workings
  22   one audio, one video at a time
  23   now playing shows that one
  24   item preferences window may have another instance with the file playing so can get it right
  25
  26 classes
  27   KwAbstractMediaPreferences
  28     current media manager
  29   KwMediaPreferencesSequence
  30     range of time to play
  31   KwMediaPreferencesAudio
  32     volume
  33     mute
  34     fade out duration
  35   KwMediaPreferencesVisual
  36     brightness
  37     contrast
  38     saturation
  39     hue
  40     fullscreen
  41     keep aspect
  42   KwMediaControlWidget
  43     KwMediaManager
  44     KwMediaControlWidgetSequence (x2 if unlinked)
  45     KwMediaControlWidgetAudio (if audio is playing)
  46     KwMediaControlWidgetVisual (if visual is playing)
  47   KwMediaControlWidgetSequence
  48     - seek if possible (or just show position)
  49     - play/pause, stop
  50     KwMediaManager
  51   KwMediaControlWidgetAudio
  52     - volume, mute
  53     KwMediaManager
  54   KwMediaControlWidgetVisual
  55     - usual visual settings
  56     - show/hide video (turns to audio only, allowing other stuff to happen on screen
  57     KwMediaManager
  58   KwMediaManager
  59     now playing audio item source and output
  60     now playing video item source and output
  61   KwMediaItem
  62     url
  63     KwMediaPreferencesSequence* sequencePreferences
  64     KwMediaPreferencesAudio*    audioPreferences
  65     KwMediaPreferencesVisual*   visualPreferences
  66