/usr/include/kmediaplayer/player.h is in kdelibs5-dev 4:4.14.2-5+deb8u2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 | // Copyright (C) 2002 Neil Stevens <neil@qualityassistant.com>
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
// in the Software without restriction, including without limitation the rights
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in
// all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// THE AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
// AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
// CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
//
// Except as contained in this notice, the name(s) of the author(s) shall not be
// used in advertising or otherwise to promote the sale, use or other dealings
// in this Software without prior written authorization from the author(s).
#ifndef KMEDIAPLAYERPLAYER_H
#define KMEDIAPLAYERPLAYER_H
#include <kparts/part.h>
#include <kmediaplayer/view.h>
/** KMediaPlayer contains an interface to reusable media player components.
*/
namespace KMediaPlayer
{
/** Player is the center of the KMediaPlayer interface. It provides all of
* the necessary media player operations, and optionally provides the GUI to
* control them.
*
* There are two servicetypes for Player: KMediaPlayer/Player and
* KMediaPlayer/Engine. KMediaPlayer/Player provides a widget (accessable
* through view as well as XML GUI KActions. KMediaPlayer/Engine omits
* the user interface facets, for those who wish to provide their own
* interface.
*/
class KMEDIAPLAYER_EXPORT Player : public KParts::ReadOnlyPart
{
Q_OBJECT
Q_PROPERTY(bool hasLength READ hasLength)
Q_PROPERTY(qlonglong length READ length)
Q_PROPERTY(bool looping READ isLooping WRITE setLooping)
Q_PROPERTY(qlonglong position READ position)
Q_PROPERTY(bool seekable READ isSeekable)
Q_PROPERTY(int state READ state WRITE setState)
public:
/** This constructor is what to use when no GUI is required, as in the
* case of a KMediaPlayer/Engine.
*/
Player(QObject *parent);
/** This constructor is what to use when a GUI is required, as in the
* case of a KMediaPlayer/Player.
*/
Player(QWidget *parentWidget, const char *widgetName, QObject *parent );
virtual ~Player(void);
/** A convenience function returning a pointer to the View for this
* Player, or 0 if this Player has no GUI.
*/
virtual View *view(void) = 0;
public Q_SLOTS:
/** Pause playback of the media track.*/
virtual void pause(void) = 0;
/** Begin playing the media track.*/
virtual void play(void) = 0;
/** Stop playback of the media track and return to the beginning.*/
virtual void stop(void) = 0;
/** Move the current playback position to the specified time in
* milliseconds, if the track is seekable. Some streams may not be
* seeked.
*/
virtual void seek(qlonglong msec) = 0;
public:
/** Returns whether the current track honors seek requests.*/
virtual bool isSeekable(void) const = 0;
/** Returns the current playback position in the track.*/
virtual qlonglong position(void) const = 0;
/** Returns whether the current track has a length. Some streams are
* endless, and do not have one. */
virtual bool hasLength(void) const = 0;
/** Returns the length of the current track.*/
virtual qlonglong length(void) const = 0;
public Q_SLOTS:
/** Set whether the Player should continue playing at the beginning of
* the track when the end of the track is reached.
*/
void setLooping(bool);
public:
/** Return the current looping state. */
bool isLooping(void) const;
Q_SIGNALS:
/** Emitted when the looping state is changed. */
void loopingChanged(bool);
public:
/** The possible states of the Player */
enum State
{
/** No track is loaded. */
Empty,
/** Not playing. */
Stop,
/** Playing is temporarily suspended. */
Pause,
/** The media is currently being output. */
Play
};
/** Return the current state of the player. */
int state(void) const;
Q_SIGNALS:
/** Emitted when the state changes. */
void stateChanged(int);
protected Q_SLOTS:
/** Implementers use this to control what users see as the current
* state.*/
void setState(int);
protected:
/* Enable the stateChanged(QString&, ...) method that was hidden by
the stateChanged(int) signal */
using KXMLGUIClient::stateChanged;
private:
bool currentLooping;
State currentState;
struct Data;
Data *d;
};
}
#endif
|