okular/core/movie.h
Albert Astals Cid 19d98d6a74 Run clang-format
find . \( -name "*.cpp" -or -name "*.h"  -or -name "*.c"  -or -name "*.cc" \) -exec clang-format -i {} \;

If you reached this file doing a git blame, please see README.clang-format (added 2 commits in the future of this one)
2020-07-11 09:17:33 +02:00

161 lines
3.5 KiB
C++

/***************************************************************************
* Copyright (C) 2008 by Pino Toscano <pino@kde.org> *
* Copyright (C) 2012 by Guillermo A. Amaral B. <gamaral@kde.org> *
* *
* This program is free software; you can redistribute it and/or modify *
* it under the terms of the GNU General Public License as published by *
* the Free Software Foundation; either version 2 of the License, or *
* (at your option) any later version. *
***************************************************************************/
#ifndef _OKULAR_MOVIE_H_
#define _OKULAR_MOVIE_H_
#include "global.h"
#include "okularcore_export.h"
#include <QSize>
class QImage;
namespace Okular
{
/**
* @short Contains information about a movie object.
*
* @since 0.8 (KDE 4.2)
*/
class OKULARCORE_EXPORT Movie
{
public:
/**
* The play mode for playing the movie
*/
enum PlayMode {
PlayLimited, ///< Play a fixed amount of times, closing the movie controls at the end @since 0.24
PlayOpen, ///< Like PlayLimited, but leaving the controls open
PlayRepeat, ///< Play continuously until stopped
PlayPalindrome ///< Play forward, then backward, then again forward and so on until stopped
};
/**
* Creates a new movie object with the given external @p fileName.
*/
explicit Movie(const QString &fileName);
/**
* Creates a new movie object with the given movie data.
*/
explicit Movie(const QString &fileName, const QByteArray &data);
/**
* Destroys the movie object.
*/
~Movie();
/**
* Returns the url of the movie.
*/
QString url() const;
/**
* Sets the size for the movie.
*/
void setSize(const QSize &aspect); // TODO remove the & when we do a BIC change elsewhere
/**
* Returns the size of the movie.
*/
QSize size() const;
/**
* Sets the @p rotation of the movie.
*/
void setRotation(Rotation rotation);
/**
* Returns the rotation of the movie.
*/
Rotation rotation() const;
/**
* Sets whether show a bar with movie controls
*/
void setShowControls(bool show);
/**
* Whether show a bar with movie controls
*/
bool showControls() const;
/**
* Sets the way the movie should be played
*/
void setPlayMode(PlayMode mode);
/**
* How to play the movie
*/
PlayMode playMode() const;
/**
* Sets how many times the movie should be played
* @since 0.24
*/
void setPlayRepetitions(double repetitions);
/**
* How many times to play the movie
* @since 0.24
*/
double playRepetitions() const;
/**
* Sets whether to play the movie automatically
*/
void setAutoPlay(bool autoPlay);
/**
* Whether to play the movie automatically
*/
bool autoPlay() const;
/**
* Sets whether to show a poster image.
*
* @since 4.10
*/
void setShowPosterImage(bool show);
/**
* Whether to show a poster image.
*
* @since 4.10
*/
bool showPosterImage() const;
/**
* Sets the poster image.
*
* @since 4.10
*/
void setPosterImage(const QImage &image);
/**
* Returns the poster image.
*
* @since 4.10
*/
QImage posterImage() const;
private:
class Private;
Private *const d;
Q_DISABLE_COPY(Movie)
};
}
#endif