summaryrefslogtreecommitdiff
path: root/libresourceqt/include/qt4/policy
diff options
context:
space:
mode:
Diffstat (limited to 'libresourceqt/include/qt4/policy')
-rw-r--r--libresourceqt/include/qt4/policy/resource-set.h312
-rw-r--r--libresourceqt/include/qt4/policy/resource.h115
-rw-r--r--libresourceqt/include/qt4/policy/resources.h319
3 files changed, 374 insertions, 372 deletions
diff --git a/libresourceqt/include/qt4/policy/resource-set.h b/libresourceqt/include/qt4/policy/resource-set.h
index 0e18e5b..3e9bc24 100644
--- a/libresourceqt/include/qt4/policy/resource-set.h
+++ b/libresourceqt/include/qt4/policy/resource-set.h
@@ -9,15 +9,15 @@
/**
* \mainpage Resource Policy Library
- *
+ *
* \section intro_section Introduction
- *
+ *
* This library is used to request resources from the Polict Resource Manager.
* To use this library two classes are provided: \ref ResourcePolicy::Resource and
* \ref ResourcePolicy::ResourceSet.
- *
+ *
* \section library_use_section Library Usage
- *
+ *
* To use the Resource Policy Library, you first need to create a number of
* \ref Resource objects like this (given as an example of what a media player
* might want/need):
@@ -50,168 +50,168 @@
*/
namespace ResourcePolicy
{
+/**
+ * The resourceSet repesents a set of attributes. Each set can only contain
+ * a single Resource of a given type. That is one AudioPlaybackResource, etc.
+ *
+ * Internally the set is stored as a QVector of \ref Resource objects.
+ */
+class ResourceSet: public QObject
+{
+ Q_OBJECT
+ Q_DISABLE_COPY(ResourceSet)
+public:
+ /**
+ * The constructor.
+ * \param applicationClass This parameter defines the application class.
+ * The application class is used to determine the priority order of the
+ * application.
+ * \param parent The optional parent of of this class.
+ */
+ ResourceSet(const QString &applicationClass, QObject *parent = NULL);
+ /**
+ * The destructor
+ */
+ ~ResourceSet();
/**
- * The resourceSet repesents a set of attributes. Each set can only contain
- * a single Resource of a given type. That is one AudioPlaybackResource, etc.
- *
- * Internally the set is stored as a QVector of \ref Resource objects.
- */
- class ResourceSet: public QObject
- {
- Q_OBJECT
- Q_DISABLE_COPY( ResourceSet )
- public:
- /**
- * The constructor.
- * \param applicationClass This parameter defines the application class.
- * The application class is used to determine the priority order of the
- * application.
- * \param parent The optional parent of of this class.
- */
- ResourceSet(const QString &applicationClass, QObject *parent=NULL);
- /**
- * The destructor
- */
- ~ResourceSet();
- /**
- * Finalizes the ResourceSet. This method should be called after all
- * resources have been added to the set.
- * \return true if the finalization was successful.
- */
- bool finalize();
+ * Finalizes the ResourceSet. This method should be called after all
+ * resources have been added to the set.
+ * \return true if the finalization was successful.
+ */
+ bool finalize();
- /**
- * This method adds a resource to the set. A set contains only a single
- * instance of a given resource. If the ResourceSet already contains a
- * resource of the given type it will be overridden.
- * \param resource The resource to add to the set. A copy of this object
- * is stored in the Set.
- */
- void addResource(const Resource *resource);
- /**
- * This method adds all resources in the list to the set.
- * A set contains only a single instance of a given resource. If the
- * ResourceSet already contains a resource of the given type it will be
- * overridden.
- * \param resources The list of resources to add to the set. These will
- * be copied.
- */
- void addResources(const QList<Resource *>resources);
- /**
- * This method removes the resource of the given type
- * \param type The type of the resource to remove from the set.
- */
- void delResource(ResourceType type);
+ /**
+ * This method adds a resource to the set. A set contains only a single
+ * instance of a given resource. If the ResourceSet already contains a
+ * resource of the given type it will be overridden.
+ * \param resource The resource to add to the set. A copy of this object
+ * is stored in the Set.
+ */
+ void addResource(const Resource *resource);
+ /**
+ * This method adds all resources in the list to the set.
+ * A set contains only a single instance of a given resource. If the
+ * ResourceSet already contains a resource of the given type it will be
+ * overridden.
+ * \param resources The list of resources to add to the set. These will
+ * be copied.
+ */
+ void addResources(const QList<Resource *>resources);
+ /**
+ * This method removes the resource of the given type
+ * \param type The type of the resource to remove from the set.
+ */
+ void delResource(ResourceType type);
- /**
- * This method returns a list of all resource in the set.
- * \return a QList of all resources in the set.
- */
- QList<Resource *> resources() const;
- /**
- * This method returns a const pointer to a resource of a specific type.
- * \type The type of resource we are interested in.
- * \return a pointer to the Resource if it is defined NULL otherwise.
- */
- Resource * resource(ResourceType type) const;
- /**
- * Checks if the \ref ResourceSet contains the given \ref Resource
- * \param type The Resource to look for
- * \return true if the \ref Resource is defined in this \ref ResourceSet
- */
- bool contains(ResourceType type) const;
+ /**
+ * This method returns a list of all resource in the set.
+ * \return a QList of all resources in the set.
+ */
+ QList<Resource *> resources() const;
+ /**
+ * This method returns a const pointer to a resource of a specific type.
+ * \type The type of resource we are interested in.
+ * \return a pointer to the Resource if it is defined NULL otherwise.
+ */
+ Resource * resource(ResourceType type) const;
+ /**
+ * Checks if the \ref ResourceSet contains the given \ref Resource
+ * \param type The Resource to look for
+ * \return true if the \ref Resource is defined in this \ref ResourceSet
+ */
+ bool contains(ResourceType type) const;
- /**
- * Checks if the \ref ResourceSet contains all given resources.
- * \param types A list of resources to check for
- * \return true if \b all given resources are defined in the ResourceSet.
- */
- bool contains(const QList<ResourceType> &types) const;
+ /**
+ * Checks if the \ref ResourceSet contains all given resources.
+ * \param types A list of resources to check for
+ * \return true if \b all given resources are defined in the ResourceSet.
+ */
+ bool contains(const QList<ResourceType> &types) const;
- /**
- * Returns the unique identifier for this ResourceSet.
- * @return the unique identifier for this ResourceSet.
- */
- quint32 id() const;
+ /**
+ * Returns the unique identifier for this ResourceSet.
+ * @return the unique identifier for this ResourceSet.
+ */
+ quint32 id() const;
- /**
- * Returns the registered application class (given in the constructor).
- */
- QString applicationClass();
+ /**
+ * Returns the registered application class (given in the constructor).
+ */
+ QString applicationClass();
- /**
- * Try to acquire the \ref ResourceSet. The resourcesGranted() or
- * resourcesDenied() signal will be emited depending on whether the
- * requested resources could be acquired or not.
- */
- bool acquire();
- /**
- * Release the acquired resources.
- */
- bool release();
- /**
- * Commit changes to the \ref ResourceSet. Remember to call update()
- * after adding and/or removing resources.
- */
- bool update();
+ /**
+ * Try to acquire the \ref ResourceSet. The resourcesGranted() or
+ * resourcesDenied() signal will be emited depending on whether the
+ * requested resources could be acquired or not.
+ */
+ bool acquire();
+ /**
+ * Release the acquired resources.
+ */
+ bool release();
+ /**
+ * Commit changes to the \ref ResourceSet. Remember to call update()
+ * after adding and/or removing resources.
+ */
+ bool update();
- /**
- * Stes the auto-release. When loosing the resources doue to another
- * application with a higher priority the default is that we automatically
- * re-gain our resources without having to re-request them. However if
- * the AutoRelease is set we release the resources and need to re-acquire
- * them, when the pre-emting application releases it s resources.
- * This feature is by default disabled.
- * Remember to call update() when changing this.
- */
- void setAutoRelease();
- /**
- * see \ref setAutoRelease().
- */
- void unsetAutoRelease();
- /**
- * Sets that the resourcesGranted() signal is emited even if we already
- * have the requested resources granted. By default this feature is off.
- */
- void setAlwaysReply();
- /**
- * Unsets the always reply flag (see \ref setAlwaysReply())
- */
- void unsetAlwaysReply();
+ /**
+ * Stes the auto-release. When loosing the resources doue to another
+ * application with a higher priority the default is that we automatically
+ * re-gain our resources without having to re-request them. However if
+ * the AutoRelease is set we release the resources and need to re-acquire
+ * them, when the pre-emting application releases it s resources.
+ * This feature is by default disabled.
+ * Remember to call update() when changing this.
+ */
+ void setAutoRelease();
+ /**
+ * see \ref setAutoRelease().
+ */
+ void unsetAutoRelease();
+ /**
+ * Sets that the resourcesGranted() signal is emited even if we already
+ * have the requested resources granted. By default this feature is off.
+ */
+ void setAlwaysReply();
+ /**
+ * Unsets the always reply flag (see \ref setAlwaysReply())
+ */
+ void unsetAlwaysReply();
- signals:
- /**
- * This signal is emited when the Resource Policy Manager notifies that
- * the given resources have become available.
- * \param availableResources A list of available resources. The list of
- * available resources contains only available resource which we have in the set.
- */
- void resourcesBecameAvailable(QList<ResourceType> availableResources);
- /**
- * This signal is emited as a response to the acquire() request.
- * \param grantedOptionalResources The list of granted optional resources.
- * All the mandatory resources have also been aquired.
- */
- void resourcesGranted(QList<ResourceType> grantedOptionalResources);
- /**
- * This signal is emited as a response to the acquire() request, in the
- * case where one or more of the mandatroy resources were not availalble.
- */
- void resourcesDenied();
- /**
- * This signal is emited when some other program with a higher priority
- * superseeds us, and as a result we loose our resources.
- */
- void lostResources();
+signals:
+ /**
+ * This signal is emited when the Resource Policy Manager notifies that
+ * the given resources have become available.
+ * \param availableResources A list of available resources. The list of
+ * available resources contains only available resource which we have in the set.
+ */
+ void resourcesBecameAvailable(QList<ResourceType> availableResources);
+ /**
+ * This signal is emited as a response to the acquire() request.
+ * \param grantedOptionalResources The list of granted optional resources.
+ * All the mandatory resources have also been aquired.
+ */
+ void resourcesGranted(QList<ResourceType> grantedOptionalResources);
+ /**
+ * This signal is emited as a response to the acquire() request, in the
+ * case where one or more of the mandatroy resources were not availalble.
+ */
+ void resourcesDenied();
+ /**
+ * This signal is emited when some other program with a higher priority
+ * superseeds us, and as a result we loose our resources.
+ */
+ void lostResources();
- private:
- quint32 identifier;
- const QString resourceClass;
- Resource* resourceSet[NumberOfTypes];
- bool connected;
- bool autoRelease;
- bool alwaysReply;
- };
+private:
+ quint32 identifier;
+ const QString resourceClass;
+ Resource* resourceSet[NumberOfTypes];
+ bool connected;
+ bool autoRelease;
+ bool alwaysReply;
+};
}
#endif
diff --git a/libresourceqt/include/qt4/policy/resource.h b/libresourceqt/include/qt4/policy/resource.h
index 74b3e9b..dd31a78 100644
--- a/libresourceqt/include/qt4/policy/resource.h
+++ b/libresourceqt/include/qt4/policy/resource.h
@@ -3,69 +3,70 @@
#include <QtCore>
-namespace ResourcePolicy {
- enum ResourceType {
- AudioPlaybackType = 0,
- VideoPlaybackType,
- AudioRecorderType,
- VideoRecorderType,
- VibraType,
- LedsType,
- BacklightType,
- SystemButtonType,
- LockButtonType,
- ScaleButtonType,
- SnapButtonType,
- LensCoverType,
- NumberOfTypes
- };
+namespace ResourcePolicy
+{
+enum ResourceType {
+ AudioPlaybackType = 0,
+ VideoPlaybackType,
+ AudioRecorderType,
+ VideoRecorderType,
+ VibraType,
+ LedsType,
+ BacklightType,
+ SystemButtonType,
+ LockButtonType,
+ ScaleButtonType,
+ SnapButtonType,
+ LensCoverType,
+ NumberOfTypes
+};
- class ResourceSet;
+class ResourceSet;
+/**
+* This class is the super class for all resources. It represents a generic
+* \ref Resource. The type specific resource classes should be used.
+*/
+class Resource
+{
+public:
+ friend class ResourceSet;
/**
- * This class is the super class for all resources. It represents a generic
- * \ref Resource. The type specific resource classes should be used.
- */
- class Resource
- {
- public:
- friend class ResourceSet;
- /**
- * Whether or not this resource is optional, in that it doesn't need to
- * be available for the set to be acquired.
- * \return true when this resource is optional.
- */
- bool isOptional() const;
- /**
- * Set the resource to be optional or mandatory.
- * \param resourceIsOptional This optional parameter defaults to true.
- * The default, true, results in the resource becoming optional. When it
- * is set to false the resource becomes mandatory.
- */
- void setOptional(bool resourceIsOptional=true);
- /**
- * Whether or not the resource to be shared. If it is shared then other
- * programs are allowed to share this resource.
- * \return true when this resource is shared.
- */
- bool isGranted() const;
+ * Whether or not this resource is optional, in that it doesn't need to
+ * be available for the set to be acquired.
+ * \return true when this resource is optional.
+ */
+ bool isOptional() const;
+ /**
+ * Set the resource to be optional or mandatory.
+ * \param resourceIsOptional This optional parameter defaults to true.
+ * The default, true, results in the resource becoming optional. When it
+ * is set to false the resource becomes mandatory.
+ */
+ void setOptional(bool resourceIsOptional = true);
+ /**
+ * Whether or not the resource to be shared. If it is shared then other
+ * programs are allowed to share this resource.
+ * \return true when this resource is shared.
+ */
+ bool isGranted() const;
- virtual ResourceType type() const = 0;
- virtual Resource * clone() const = 0;
- virtual ~Resource();
- protected:
- Resource();
- Resource(const Resource &other);
+ virtual ResourceType type() const = 0;
+ virtual Resource * clone() const = 0;
+ virtual ~Resource();
+protected:
+ Resource();
+ Resource(const Resource &other);
- ResourceType resourceType;
- bool optional;
- quint32 identifier;
- private:
- void setGranted();
- void unsetGranted();
- bool granted;
+ ResourceType resourceType;
+ bool optional;
+ quint32 identifier;
+private:
+ void setGranted();
+ void unsetGranted();
+ bool granted;
- };
+};
}
#endif
diff --git a/libresourceqt/include/qt4/policy/resources.h b/libresourceqt/include/qt4/policy/resources.h
index 47002d7..f00cc2e 100644
--- a/libresourceqt/include/qt4/policy/resources.h
+++ b/libresourceqt/include/qt4/policy/resources.h
@@ -5,165 +5,166 @@
#include <QObject>
#include <QString>
-namespace ResourcePolicy {
-
- class AudioResource: public Resource
- {
- public:
- AudioResource(const QString &audioGroup=QString());
- AudioResource(const AudioResource &other);
- virtual ~AudioResource();
-
- QString audioGroup() const;
- void setAudioGroup(const QString & newGroup);
-
- quint32 processID() const;
- void setProcessID(quint32 newPID);
-
- QString streamTag() const;
- void setStreamTag(const QString & newStreamTag);
-
- virtual ResourceType type() const;
- virtual Resource * clone() const;
- private:
- QString group;
- quint32 pid;
- QString stream;
- };
-
- class AudioRecorderResource: public Resource
- {
- public:
- AudioRecorderResource(const QString & audioGroup=QString());
- AudioRecorderResource(const AudioRecorderResource &other);
- virtual ~AudioRecorderResource();
-
- QString audioGroup() const;
- void setAudioGroup(const QString & newGroup);
-
- quint32 processID() const;
- void setProcessID(quint32 newPID);
-
- QString streamTag() const;
- void setStreamTag(const QString & newStreamTag);
-
- virtual ResourceType type() const;
- virtual Resource * clone() const;
- private:
- QString group;
- quint32 pid;
- QString stream;
- };
-
- class BacklightResource: public Resource
- {
- public:
- BacklightResource();
- BacklightResource(const BacklightResource &other);
- virtual ~BacklightResource();
-
- virtual ResourceType type() const;
- virtual Resource * clone() const;
- };
-
- class LedsResource: public Resource
- {
- public:
- LedsResource();
- LedsResource(const LedsResource &other);
- virtual ~LedsResource();
-
- virtual ResourceType type() const;
- virtual Resource * clone() const;
- };
-
- class VibraResource: public Resource
- {
- public:
- VibraResource();
- VibraResource(const VibraResource &other);
- virtual ~VibraResource();
-
- virtual ResourceType type() const;
- virtual Resource * clone() const;
- };
-
- class VideoRecorderResource: public Resource
- {
- public:
- VideoRecorderResource();
- VideoRecorderResource(const VideoRecorderResource &other);
- virtual ~VideoRecorderResource();
-
- virtual ResourceType type() const;
- virtual Resource * clone() const;
- };
-
- class VideoResource: public Resource
- {
- public:
- VideoResource();
- VideoResource(const VideoResource &other);
- virtual ~VideoResource();
-
- virtual ResourceType type() const;
- virtual Resource * clone() const;
- };
-
- class SystemButtonResource: public Resource
- {
- public:
- SystemButtonResource();
- SystemButtonResource(const SystemButtonResource &other);
- virtual ~SystemButtonResource();
-
- virtual ResourceType type() const;
- virtual Resource * clone() const;
- };
-
- class LockButtonResource: public Resource
- {
- public:
- LockButtonResource();
- LockButtonResource(const LockButtonResource &other);
- virtual ~LockButtonResource();
-
- virtual ResourceType type() const;
- virtual Resource * clone() const;
- };
-
- class ScaleButtonResource: public Resource
- {
- public:
- ScaleButtonResource();
- ScaleButtonResource(const ScaleButtonResource &other);
- virtual ~ScaleButtonResource();
-
- virtual ResourceType type() const;
- virtual Resource * clone() const;
- };
-
- class SnapButtonResource: public Resource
- {
- public:
- SnapButtonResource();
- SnapButtonResource(const SnapButtonResource &other);
- virtual ~SnapButtonResource();
-
- virtual ResourceType type() const;
- virtual Resource * clone() const;
- };
-
- class LensCoverResource: public Resource
- {
- public:
- LensCoverResource();
- LensCoverResource(const LensCoverResource &other);
- virtual ~LensCoverResource();
-
- virtual ResourceType type() const;
- virtual Resource * clone() const;
- };
+namespace ResourcePolicy
+{
+
+class AudioResource: public Resource
+{
+public:
+ AudioResource(const QString &audioGroup = QString());
+ AudioResource(const AudioResource &other);
+ virtual ~AudioResource();
+
+ QString audioGroup() const;
+ void setAudioGroup(const QString & newGroup);
+
+ quint32 processID() const;
+ void setProcessID(quint32 newPID);
+
+ QString streamTag() const;
+ void setStreamTag(const QString & newStreamTag);
+
+ virtual ResourceType type() const;
+ virtual Resource * clone() const;
+private:
+ QString group;
+ quint32 pid;
+ QString stream;
+};
+
+class AudioRecorderResource: public Resource
+{
+public:
+ AudioRecorderResource(const QString & audioGroup = QString());
+ AudioRecorderResource(const AudioRecorderResource &other);
+ virtual ~AudioRecorderResource();
+
+ QString audioGroup() const;
+ void setAudioGroup(const QString & newGroup);
+
+ quint32 processID() const;
+ void setProcessID(quint32 newPID);
+
+ QString streamTag() const;
+ void setStreamTag(const QString & newStreamTag);
+
+ virtual ResourceType type() const;
+ virtual Resource * clone() const;
+private:
+ QString group;
+ quint32 pid;
+ QString stream;
+};
+
+class BacklightResource: public Resource
+{
+public:
+ BacklightResource();
+ BacklightResource(const BacklightResource &other);
+ virtual ~BacklightResource();
+
+ virtual ResourceType type() const;
+ virtual Resource * clone() const;
+};
+
+class LedsResource: public Resource
+{
+public:
+ LedsResource();
+ LedsResource(const LedsResource &other);
+ virtual ~LedsResource();
+
+ virtual ResourceType type() const;
+ virtual Resource * clone() const;
+};
+
+class VibraResource: public Resource
+{
+public:
+ VibraResource();
+ VibraResource(const VibraResource &other);
+ virtual ~VibraResource();
+
+ virtual ResourceType type() const;
+ virtual Resource * clone() const;
+};
+
+class VideoRecorderResource: public Resource
+{
+public:
+ VideoRecorderResource();
+ VideoRecorderResource(const VideoRecorderResource &other);
+ virtual ~VideoRecorderResource();
+
+ virtual ResourceType type() const;
+ virtual Resource * clone() const;
+};
+
+class VideoResource: public Resource
+{
+public:
+ VideoResource();
+ VideoResource(const VideoResource &other);
+ virtual ~VideoResource();
+
+ virtual ResourceType type() const;
+ virtual Resource * clone() const;
+};
+
+class SystemButtonResource: public Resource
+{
+public:
+ SystemButtonResource();
+ SystemButtonResource(const SystemButtonResource &other);
+ virtual ~SystemButtonResource();
+
+ virtual ResourceType type() const;
+ virtual Resource * clone() const;
+};
+
+class LockButtonResource: public Resource
+{
+public:
+ LockButtonResource();
+ LockButtonResource(const LockButtonResource &other);
+ virtual ~LockButtonResource();
+
+ virtual ResourceType type() const;
+ virtual Resource * clone() const;
+};
+
+class ScaleButtonResource: public Resource
+{
+public:
+ ScaleButtonResource();
+ ScaleButtonResource(const ScaleButtonResource &other);
+ virtual ~ScaleButtonResource();
+
+ virtual ResourceType type() const;
+ virtual Resource * clone() const;
+};
+
+class SnapButtonResource: public Resource
+{
+public:
+ SnapButtonResource();
+ SnapButtonResource(const SnapButtonResource &other);
+ virtual ~SnapButtonResource();
+
+ virtual ResourceType type() const;
+ virtual Resource * clone() const;
+};
+
+class LensCoverResource: public Resource
+{
+public:
+ LensCoverResource();
+ LensCoverResource(const LensCoverResource &other);
+ virtual ~LensCoverResource();
+
+ virtual ResourceType type() const;
+ virtual Resource * clone() const;
+};
}
#endif