From 7f66b9e8ba186fb14a2db598a87dfa8de7b5a47b Mon Sep 17 00:00:00 2001 From: tpearson Date: Wed, 10 Feb 2010 00:59:09 +0000 Subject: Added old abandoned KDE3 version of Kaffeine git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/kaffeine@1088031 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/Makefile.am | 5 + doc/kaffeine/Makefile.am | 5 + doc/kaffeine/discwindow.png | Bin 0 -> 193848 bytes doc/kaffeine/dvbbroadcast.png | Bin 0 -> 17421 bytes doc/kaffeine/dvbclient.png | Bin 0 -> 399897 bytes doc/kaffeine/dvbconfig.png | Bin 0 -> 38308 bytes doc/kaffeine/dvbepg.png | Bin 0 -> 25149 bytes doc/kaffeine/dvblive.jpg | Bin 0 -> 77062 bytes doc/kaffeine/dvbscan.png | Bin 0 -> 44518 bytes doc/kaffeine/dvbtimers.png | Bin 0 -> 33004 bytes doc/kaffeine/dvbwin.png | Bin 0 -> 266099 bytes doc/kaffeine/gstpart.png | Bin 0 -> 43274 bytes doc/kaffeine/index.docbook | 796 ++++++++++++++++++++++++++++++++++++++++++ doc/kaffeine/kaffeinepart.png | Bin 0 -> 106676 bytes doc/kaffeine/playlistwin.png | Bin 0 -> 85132 bytes doc/kaffeine/startwindow.png | Bin 0 -> 38149 bytes 16 files changed, 806 insertions(+) create mode 100644 doc/Makefile.am create mode 100644 doc/kaffeine/Makefile.am create mode 100644 doc/kaffeine/discwindow.png create mode 100644 doc/kaffeine/dvbbroadcast.png create mode 100644 doc/kaffeine/dvbclient.png create mode 100644 doc/kaffeine/dvbconfig.png create mode 100644 doc/kaffeine/dvbepg.png create mode 100644 doc/kaffeine/dvblive.jpg create mode 100644 doc/kaffeine/dvbscan.png create mode 100644 doc/kaffeine/dvbtimers.png create mode 100644 doc/kaffeine/dvbwin.png create mode 100644 doc/kaffeine/gstpart.png create mode 100644 doc/kaffeine/index.docbook create mode 100644 doc/kaffeine/kaffeinepart.png create mode 100644 doc/kaffeine/playlistwin.png create mode 100644 doc/kaffeine/startwindow.png (limited to 'doc') diff --git a/doc/Makefile.am b/doc/Makefile.am new file mode 100644 index 0000000..6812bd2 --- /dev/null +++ b/doc/Makefile.am @@ -0,0 +1,5 @@ + +KDE_LANG = en +KDE_DOCS = AUTO +SUBDIRS = $(AUTODIRS) + diff --git a/doc/kaffeine/Makefile.am b/doc/kaffeine/Makefile.am new file mode 100644 index 0000000..220b1f5 --- /dev/null +++ b/doc/kaffeine/Makefile.am @@ -0,0 +1,5 @@ + +KDE_LANG = en +KDE_DOCS = kaffeine + + diff --git a/doc/kaffeine/discwindow.png b/doc/kaffeine/discwindow.png new file mode 100644 index 0000000..3690fc0 Binary files /dev/null and b/doc/kaffeine/discwindow.png differ diff --git a/doc/kaffeine/dvbbroadcast.png b/doc/kaffeine/dvbbroadcast.png new file mode 100644 index 0000000..92f1181 Binary files /dev/null and b/doc/kaffeine/dvbbroadcast.png differ diff --git a/doc/kaffeine/dvbclient.png b/doc/kaffeine/dvbclient.png new file mode 100644 index 0000000..c780765 Binary files /dev/null and b/doc/kaffeine/dvbclient.png differ diff --git a/doc/kaffeine/dvbconfig.png b/doc/kaffeine/dvbconfig.png new file mode 100644 index 0000000..66cd07a Binary files /dev/null and b/doc/kaffeine/dvbconfig.png differ diff --git a/doc/kaffeine/dvbepg.png b/doc/kaffeine/dvbepg.png new file mode 100644 index 0000000..ab16367 Binary files /dev/null and b/doc/kaffeine/dvbepg.png differ diff --git a/doc/kaffeine/dvblive.jpg b/doc/kaffeine/dvblive.jpg new file mode 100644 index 0000000..0d6948f Binary files /dev/null and b/doc/kaffeine/dvblive.jpg differ diff --git a/doc/kaffeine/dvbscan.png b/doc/kaffeine/dvbscan.png new file mode 100644 index 0000000..5143f19 Binary files /dev/null and b/doc/kaffeine/dvbscan.png differ diff --git a/doc/kaffeine/dvbtimers.png b/doc/kaffeine/dvbtimers.png new file mode 100644 index 0000000..dbfa976 Binary files /dev/null and b/doc/kaffeine/dvbtimers.png differ diff --git a/doc/kaffeine/dvbwin.png b/doc/kaffeine/dvbwin.png new file mode 100644 index 0000000..2150238 Binary files /dev/null and b/doc/kaffeine/dvbwin.png differ diff --git a/doc/kaffeine/gstpart.png b/doc/kaffeine/gstpart.png new file mode 100644 index 0000000..d3f60ca Binary files /dev/null and b/doc/kaffeine/gstpart.png differ diff --git a/doc/kaffeine/index.docbook b/doc/kaffeine/index.docbook new file mode 100644 index 0000000..8532031 --- /dev/null +++ b/doc/kaffeine/index.docbook @@ -0,0 +1,796 @@ + + + Kaffeine"> + + + + +]> + + + + + +&kaffeine; 0.8 Handbook + + + +Jürgen + +Kofler + +
kaffeine@gmx.net
+ + + +Christophe + +Thommeret + +
hftom@free.fr
+ + + + + + + +2004 +2006 +The Kaffeine Authors + + + +&FDLNotice; + + + +13/03/2006 +0.08.00 + + + + + +A Media Player for KDE. http://kaffeine.sourceforge.net + + + + + + +kaffeine +xine +video +audio +mp3 + + + + + + + + +Kaffeine Shell + + +The Start Window + + +Start Window + + + + + + + Screenshot + + + + +Provides fast access to the most important media sources. + + + + + +The Playlist Window + + +&kaffeine; Playlist Window + + + + + + + Screenshot + + + + +Kaffeine supports multiple playlists. Choose the active one with the "Playlist" selector. You can easily drag some files or folders from the file browser and drop it on the playlist to enqueue or drop it on the player window to create a new playlist. To change playlist name edit it and confirm with Return. + +You can find all playlist related functions in the Playlist-Menu and the context-menu (right-click on playlist). + + + + + +The Discs Window + + +&kaffeine; Discs Window + + + + + + + Screenshot + + + + +Here you can start Audio CD, DVD or VCD. You can even rip and encode audio tracks to be stored on your hard disk. + + + + + +The DVB Window + + +DVB Window + + + + + + Screenshot + + + + +Kaffeine supports Digital Video Broadcasting devices supported by linuxtv drivers. This window is only visible if Kaffeine find a DVB device at startup. If you have a DVB device and Kaffeine doesn't find it, make sure the driver is loaded and your device recognized. (Further information can be found at www.linuxtv.org) + +You can arrange your channels in categories. To create a new category, right click in the icon view to get a popup menu. Now, drag a channel name and drop it on the desired category' icon. To remove a channel from a category, drop it on the "All" icon. Right click on an icon to delete that category or change icon. +You can find all DVB related functions in the DVB-Menu. + + + +Configuration + + +Configuration + + + + + + Screenshot + + + + +Select Menu->DVB->Configure DVB... to open the DVB config dialog. In order to get your device(s) working in Kaffeine, you have to choose a "source" in the list. If you have a DISEqC switch, choose a source for each satellite. + +The Recording page allow you to choose where programs are saved to disk. + + + + +Getting channels + + +Channels + + + + + + Screenshot + + + + +Open the Channels dialog from the DVB-Menu. There, click the Start scan button to start scanning the network for available channels. This can take a while, so be patient ... When done, select the channels you want to add to your channels list and click Add selected or use the filters and click Add filtered (e.g. check "Free to air" and "TV" to add all fta TV). + +When added to channels list, channels are automatically assigned a number. To change this number, right click on the channel name and choose Edit ... from the popup menu. This number will allow you to zap using keypad. + +Note that you can also change the channel number in the DVB window. Select the channel then click on the number to edit. + + + +Viewing live + + +Live TV + + + + + + Screenshot + + + + +To zap to a channel, you can either double-click on a channel name in the DVB window or use keypad (or remote control with kdelirc) to enter the channel number. Entered digit are displayed in the top left corner of the Player window. You can also hit pageUp/pageDown to zap to previous/next. + +You can now see your favorite program. Kaffeine also displays some informations about this channel using OSD. You can later hit "O" to see it again. (Hit "O" twice to display current program description). + +Now, what if your phone suddenly ring and you absolutely don't want to miss this crucial moment of the movie ? Don't worry. Just hit pause. Kaffeine will pause and immediately start to save the stream to your harddisk. Later, hit play and the program will continue from where you left it. To return to live, just rezap to this channel. + +Note that live DVB only works with the xine engine (called "Kaffeine"). Menu->Settings->Engine->Kaffeine. + + + +Electronic Program Guide + + +EPG + + + + + + Screenshot + + + + +Menu->DVB->EPG... brings up the Electronic Program Guide window, displaying current/next programs. Left click on an entry to display the detailed description of the program. Scheduled events for a given channel are displayed when you right click on one of the channel entry and select View all programs from the context menu. + +Double click on an entry to zap to that channel. + +Note that you have first to zap to some channels in order to get EPG. + + + +Recording + + +Recording + + + + + + Screenshot + + + + +Kaffeine offers you several way of recording. + +When you are viewing a live program, you can simply choose Menu->DVB->Instant record to immediately start recording this program. The duration is defined in the Recording page of the DVB config dialog, but you can modify it on the fly from the Timers dialog (Menu->DVB->Timers...). Just select the program and click Edit button to change the duration. + +You can also create a timer from the EPG window. Right click on a program entry and select Add to timers from the context menu. In this case, the timer is created using Begin margin and End margin defined in the Recording page of the DVB config dialog. So, start time is set to [start time given by EPG]-[begin margin] and duration is set to [duration given by EPG]+[begin margin]+[end margin]. + +Finally, you can create a new timer by hand. Open the Timers dialog, click on the New button and fill in required informations. + +Note that all timers can be deleted, even if running. Open the Timers dialog, select the program and click the Delete button. Of course, deleting a running timer doesn't delete the file on the disk. + +You can view and/or record several channels at the same time on the same multiplex. Note that the priority is always given to timers, so if you are viewing a live show and a timer is to be started on a different multiplex, live will be stopped to allow recording. + +Be aware that a DVB stream is about 1.5GB/hour. + + + +Playing a record + +Simply open the file and Kaffeine will start playing. That's all ! + + + + +Broadcasting + + +Broadcasting + + + + + + Screenshot + + + + +Kaffeine can broadcast several DVB channels (being on the same multiplex) on a lan. + +Open the DVB config dialog and go to the Broadcasting page to set address and ports. + +Menu->DVB->Broadcasting... opens the broadcasting editor. Select a channel in the Available channels list, and click the Add button to add it to the Broadcasting list. The Available channels list is now filled with channels on the same multiplex. You can now use multi-selection to add channels. Click OK button to start broadcasting. + +To stop broadcasting, open the dialog and click OK with an empty list. + +Note that the priority is always given to timers, so if you are broadcasting and a timer is to be started on a different multiplex, broadcasting will be stopped to allow recording. And broadcasting has a higher priority than live. + + + + + +The DVB Client Window + + +DVB Client Window + + + + + + Screenshot + + + + +To enable DVB client, you have to check the box in the Kaffeine configuration dialog. There you must also set address and ports. It will create a new tab labeled Dvb client showing a list of actually broadcasted channels (if any). Double click on a channel name to start playing it. DVB client also support time shifting (just hit pause). + + + + + + +Player Parts + +You'll find all available player parts in Settings-Player Engine. + + + +The Kaffeine Part + + +Kaffeine-Part + + + + + + + Screenshot + + + + +This is the default, xine based, full featured player part for Kaffeine. Plays almost everything... + + +About xine + + + xine is a free multimedia player. It plays back CDs, DVDs, and VCDs. + It also decodes multimedia files like AVI, MOV, WMV, and MP3 from local disk drives, and displays multimedia streamed over the Internet. + It interprets many of the most common multimedia formats available - and some of the most uncommon formats, too. + Detailed info about xine features: +http://www.xinehq.de + + + + + + + +The GStreamer Part + + +GStreamer-Part + + + + + + + Screenshot + + + + +A simple player part based on GStreamer. GStreamer homepage: +http://gstreamer.freedesktop.org + + + + + + + +Command Line Options + +Usage: + +kaffeine + + + + + + +--fullscreen +--play +--audiodriver +--videodriver +--device +--verbose +--wizard +file + + + + + + + + + +Starts &kaffeine; in fullscreen mode. + + + + +Starts with last played track. + + + + +Sets the audio driver. Arguments can be: alsa, arts, oss, ... + + + + +Sets the video driver. Arguments can be: xv, xshm, dxr3 ,... + + + + +Sets the Audio-CD/VCD/DVD path to (argument). + + + + +Outputs more debug messages. + + + +Runs installation wizard. + + + + +Files to play. Can be local files, a directory, an URL or "AudioCD", "VCD", "DVD". + + + + + + + + + +The DCOP Interface + + +Overview +You can use the DCOP interface in two kinds: From inside another application with KApplication::dcopClient()->send( "kaffeine", "KaffeineIface", "pause()" ) +or from command line with dcop kaffeine KaffeineIface openURL best_song_of_the_world.mp3. + + + + +Functions + + +KaffeineIface Object + + + + + + +void openURL(QString URL) +Opens and plays the given URL. + + +void appendURL(QString URL) +Appends the URL to current playlist. + + +void playAudioCD() +Starts playing Audio CD. + + +void playVCD() +Starts playing Video CD. + + +void playDVD() +Starts playing DVD. + +void play() +(Re)Starts playback. + +bool isPlaying() +Returns "true" or "false" on command line. + +void pause() +Toggles pause/playback. + +void next() +Plays next playlist entry/chapter/DVB channel. + +void previous() +Plays previous playlist entry/chapter/DVB channel. + +void stop() +Stops playback. + +QString title() +Returns the title of the current track. + +QString getFileName() +Returns filename of current track. + +int getLength() +Returns length of current track in seconds. + +int getTimePos() +Returns current stream position in seconds. + +void quit() +Quits Kaffeine. + +void random() +Toggles between random and normal play. + +void fullscreen() +Toggles between fullscreen and windowed mode. + +void posPlus() +Increases stream position. + +void posMinus() +Decreases stream position. + +void volUp() +Increases volume. + +void volDown() +Decreases volume. + +void mute() +Toggles mute on/off. + +void setNumber(int number) +Select DVB channel/playlist entry by number. + +void dvbOSD() +Toggles DVB-OSD on/off. + + + + + + + + + +KaffeinePartIface Object + + + + + + +int getContrast() +Returns current contrast. + + +void setContrast(int contrast) +Sets contrast (0..65535). + + +int getBrightness() +Returns current brightness. + + +void setBrightness(int brightness) +Sets brightness (0..65535). + + +void dvdMenuUp() +DVD Menu: Cursor up. + + +void dvdMenuDown() +DVD Menu: Cursor down. + + +void dvdMenuLeft() +DVD Menu: Cursor left. + + +void dvdMenuRight() +DVD Menu: Cursor right. + + +void dvdMenuSelect() +DVD Menu: Selects the menu item pointed by the cursor. + + +void dvdMenuToggle() +Toggles DVD menu on/off. + + +void aspectRatioAuto() +Automatic aspect ratio. + + +void aspectRatio4_3() +Sets aspect ratio to 4:3. + + +void aspectRatioAnamorphic() +Sets aspect ratio to 16:9. + + +void aspectRatioSquare() +Sets aspect ratio to 1:1. + + +void aspectRatioDVB() +Sets aspect ratio to 2.11:1. + + +void zoomIn() +Zooms picture in. + + +void zoomOut() +Zooms picture out. + + +void zoomOff() +Disables zoom. + + + + + + + + + + + +Keybindings + +You can configure shortcuts using Settings-Configure Shortcuts. + + + + + + +Questions and Answers + + + +Kaffeine-FAQ + + +xine-FAQ + + +For Questions use the kaffeine-user mailinglist. +(First check the archive + if the question is still answered.) + + + + + + +Reporting BUGS + + +Before you report a bug, please first make sure the bug has not been reported +yet in the bug tracking system at http://www.sourceforge.net/projects/kaffeine. +Also have a look into the mailinglist archive. + + + +Please use only the tracking system on sourceforge for reporting bugs and log in before +submitting (if you've a sourceforge account). + + + +When you submit a bug, please include all of the following information: + + +versions of Kaffeine, xine, KDE, X11 +the backtrace from KDE's Crash Manager +console output (you can use --verbose to get more) + + + + + + + +Copyright and License + + +Program copyright 2003-2005, The Kaffeine Authors + + + + +Documentation copyright 2003-2005, Jürgen Kofler kaffeine@gmx.net, Christophe Thommeret hftom@free.fr + + + + +&underFDL; + + + + +&underGPL; + + + + +&documentation.index; + + + + + + + + + + + + + + + diff --git a/doc/kaffeine/kaffeinepart.png b/doc/kaffeine/kaffeinepart.png new file mode 100644 index 0000000..fe108b7 Binary files /dev/null and b/doc/kaffeine/kaffeinepart.png differ diff --git a/doc/kaffeine/playlistwin.png b/doc/kaffeine/playlistwin.png new file mode 100644 index 0000000..9c6a283 Binary files /dev/null and b/doc/kaffeine/playlistwin.png differ diff --git a/doc/kaffeine/startwindow.png b/doc/kaffeine/startwindow.png new file mode 100644 index 0000000..bfdfa83 Binary files /dev/null and b/doc/kaffeine/startwindow.png differ -- cgit v1.2.1