Warning, /multimedia/dragon/doc/index.docbook is written in an unsupported language. File is not indexed.

0001 <?xml version="1.0" ?>
0002 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
0003   <!ENTITY % addindex "IGNORE">
0004   <!ENTITY % English "INCLUDE"><!-- change language only here -->
0005 ]>
0006 
0007 <book id="dragon" lang="&language;">
0008 
0009 <bookinfo>
0010 <title>The &dragon; Handbook</title>
0011 
0012 <authorgroup>
0013 <author>
0014 <firstname>Mike</firstname>
0015 <surname>Diehl</surname>
0016 <affiliation>
0017 <address><email>madpenguin8@yahoo.com</email></address>
0018 </affiliation>
0019 </author>
0020 <author>
0021 <firstname>Ian</firstname>
0022 <surname>Monroe</surname>
0023 <affiliation>
0024 <address><email>imonroe@kde.org</email></address>
0025 </affiliation>
0026 </author>
0027 <!-- TRANS:ROLES_OF_TRANSLATORS -->
0028 </authorgroup>
0029 
0030 <copyright>
0031 <year>2004</year>
0032 <holder>Mike Diehl</holder>
0033 </copyright>
0034 <copyright>
0035 <year>2007</year>
0036 <holder>Ian Monroe</holder>
0037 </copyright>
0038 
0039 <legalnotice>&FDLNotice;</legalnotice>
0040 
0041 <date>2016-06-29</date>
0042 <releaseinfo>Applications 16.04</releaseinfo>
0043 
0044 <abstract>
0045 <para>
0046 &dragon; is a simple video player by &kde;.
0047 </para>
0048 </abstract>
0049 
0050 <keywordset>
0051 <keyword>KDE</keyword>
0052 <keyword>Codeine</keyword>
0053 <keyword>Phonon</keyword>
0054 <keyword>Dragon</keyword>
0055 <keyword>Player</keyword>
0056 <keyword>Dragon Player</keyword>
0057 <keyword>video</keyword>
0058 <keyword>multi-media</keyword>
0059 </keywordset>
0060 
0061 </bookinfo>
0062 
0063 <chapter id="introduction">
0064 <title>Introduction</title>
0065 
0066 <screenshot>
0067 <screeninfo>&dragon; Screenshot</screeninfo>
0068 <mediaobject>
0069 <imageobject><imagedata fileref="main.png" format="PNG"/></imageobject>
0070 <textobject><phrase>Screenshot</phrase></textobject>
0071 </mediaobject>
0072 </screenshot>
0073 
0074 
0075 <para>
0076 &dragon; is a simple media player using &phonon; technology. &dragon; is a no frills media player that excels at playing DVDs and movie files without getting in your way.
0077 </para>
0078 
0079 </chapter>
0080 
0081 <chapter id="select-media">
0082 <title>Select a Media</title>
0083 
0084 <para>If you start &dragon; from the application launcher or use <guibutton>Play Media</guibutton>
0085 (<keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>) from the toolbar or from the <guimenu>Play</guimenu> 
0086 menu this window is displayed:</para>
0087 
0088 <screenshot>
0089 <screeninfo>Play Media</screeninfo>
0090 <mediaobject>
0091 <imageobject><imagedata fileref="playmedia.png" format="PNG"/></imageobject>
0092 <textobject><phrase>Play Media</phrase></textobject>
0093 </mediaobject>
0094 </screenshot>
0095 
0096 <para>There are three ways to play a video file:</para>
0097 <para><guibutton>Play File</guibutton> opens the file dialog and allows you to select a file to play.</para>
0098 <para><guibutton>Play Disc</guibutton> to play a &CD; or DVD.</para>
0099 <para><guibutton>Play Stream</guibutton> opens a dialog to enter an address of some <ulink url="https://en.wikipedia.org/wiki/Streaming_media">multimedia stream</ulink>.</para>
0100 <para>Double click on an entry in the play list with recently opened files to start playing it. 
0101 The context menu of the play list shows actions to remove a selected entry or clear the whole play list. 
0102 Any file you played will be automatically added to the list.</para>
0103 </chapter>
0104 
0105 <chapter id="features">
0106 <title>Features</title>
0107 
0108 <variablelist>
0109 
0110 <varlistentry>
0111 <term>
0112 <guimenuitem>Full Screen Mode</guimenuitem>
0113 </term>
0114 <listitem><para>
0115 While playing a movie, you can enter full screen mode. This uses the entire monitor to display the movie. 
0116 Moving the mouse shows a toolbar at the top of the screen in full screen mode.
0117 Toggle the full screen mode using the <guimenu>Settings</guimenu> menu, the action in the toolbar, double click on the video or use the shortcut 
0118 <keycap>F</keycap>.
0119 </para></listitem>
0120 </varlistentry>
0121 
0122 <varlistentry>
0123 <term>
0124 <guimenuitem>Video Settings</guimenuitem>
0125 </term>
0126 <listitem><para>Select this action from the <guimenu>Settings</guimenu> menu to adjust <guilabel>Brightness</guilabel>, <guilabel>Contrast</guilabel>, <guilabel>Hue</guilabel> and <guilabel>Saturation</guilabel>.
0127 These settings are stored together with the playback position for each video file. This enables you resume playing a video with the selected video  settings and the position where you stopped playing.
0128 </para></listitem>
0129 </varlistentry>
0130 
0131 <varlistentry>
0132 <term>
0133 Navigation
0134 </term>
0135 <listitem><para>The shortcut <keycap>PgUp</keycap> brings you 10% forward / <keycap>+</keycap> 10 seconds forward and <keycap>PgDown</keycap> brings you 10% backward / <keycap>-</keycap> 10 seconds backward.
0136 Use <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Menu Toggle</guimenuitem></menuchoice> (<keycap>R</keycap>) to switch to the video menu and select another chapter to play.
0137 <menuchoice><guimenu>Play</guimenu><guimenuitem>Play/Pause</guimenuitem></menuchoice> (<keysym>Space</keysym>) allows you to pause and resume playback if a movie is loaded. <menuchoice><guimenu>Play</guimenu><guimenuitem>Stop</guimenuitem></menuchoice> (<keycap>S</keycap>) stops playback.
0138 Go to the previous or next chapter of a video with <guimenuitem>Previous Chapter</guimenuitem> (<keycap>,</keycap>) or <guimenuitem>Next Chapter</guimenuitem> (<keycap>.</keycap>) from the <guimenu>Play</guimenu> menu.
0139 </para></listitem>
0140 </varlistentry>
0141 
0142 <varlistentry>
0143 <term>
0144 <guimenuitem>Volume control</guimenuitem>
0145 </term>
0146 <listitem><para>If you play videos with a hidden toolbar, you can use the shortcut <keycap>M</keycap> to mute or unmute the sound; and the shortcut <keycap>V</keycap> to toggle the display of the volume slider right to the video.
0147 </para></listitem>
0148 </varlistentry>
0149 
0150 <varlistentry>
0151 <term><menuchoice>
0152 <guimenu>Settings</guimenu>
0153 <guisubmenu>Aspect Ratio</guisubmenu>
0154 </menuchoice></term>
0155 <listitem><para><action>This menu lets you pick the aspect ratio of the playing movie. The aspect ratio is width of movie compared to the height.</action></para></listitem>
0156 </varlistentry>
0157 
0158 <varlistentry>
0159 <term>
0160 <guisubmenu>Subtitles</guisubmenu> and <guisubmenu>Audio Channels</guisubmenu>
0161 </term>
0162 <listitem><para>
0163 These menu items from the <guimenu>Settings</guimenu> menu are active if there are any subtitles or additional audio channels (&eg; with different languages) available from the currently playing movie. Note that it may take a few seconds of playback before the subtitles or audio channels become available.
0164 </para></listitem>
0165 </varlistentry>
0166 
0167 </variablelist>
0168 
0169 </chapter>
0170 
0171 <chapter id="credits">
0172 
0173 <title>Credits and License</title>
0174 
0175 <para>
0176 &dragon;
0177 </para>
0178 
0179 <para>Program copyright 2004 Max B. Howell <email>max.howell@methylblue.com</email></para>
0180 <para>Program copyright 2007 Ian A. Monroe <email>imonroe@kde.org</email></para>
0181 
0182 <para>
0183 Documentation copyright 2004 Mike Diehl <email>madpenguin8@yahoo.com</email>
0184 </para>
0185 <para>
0186 Documentation copyright 2007 Ian Monroe <email>imonroe@kde.org</email>
0187 </para>
0188 
0189 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
0190 &underFDL;
0191 &underGPL;
0192 
0193 </chapter>
0194 
0195 &documentation.index;
0196 </book>
0197 <!--
0198 Local Variables:
0199 mode: sgml
0200 sgml-minimize-attributes:nil
0201 sgml-general-insert-case:lower
0202 sgml-indent-step:0
0203 sgml-indent-data:nil
0204 End:
0205 -->