QSensor Class

Documentation des propriétés

active : bool

Cette propriété contient une valeur indiquant si le capteur est actif.

Elle est définie sur « true » si le capteur est actif (s'il renvoie des valeurs). Elle est définie sur « false » dans le cas contraire.

Notez que le fait de définir cette valeur sur « true » n'aura pas d'effet immédiat. Le capteur sera en effet lancé dès que la boucle d'événements aura été atteinte.

Fonctions d'accès :

Signal de notification :

alwaysOn : bool

Cette propriété contient une valeur indiquant si le capteur doit continuer à fonctionner lorsque l'écran est éteint.

Certaines plateformes ont pour principe de suspendre les capteurs lorsque l'écran s'éteint. En définissant cette propriété sur « true », vous vous assurez que le capteur continue de fonctionner.

Fonctions d'accès :

Signal de notification :

[read-only] availableDataRates : qrangelist

Cette propriété contient les débits de données pris en charge par le capteur.

Il s'agit d'une liste des débits de données pris en charge par le capteur. Mesurés en hertz.

Les entrées de la liste peuvent correspondre à des débits discrets ou à une plage continue de débits. Un débit discret est indiqué par deux valeurs identiques.

Notez que cette information n'est pas obligatoire, car tous les capteurs ne fonctionnent pas nécessairement à une fréquence donnée. Dans ce cas, la liste sera vide.

Fonctions d'accès :

Voir également QSensor::dataRate et qrangelist.

axesOrientationMode : AxesOrientationMode

Cette propriété définit le mode qui détermine la manière dont l'orientation de l'écran influe sur les valeurs relevées.

Lorsqu’elle est définie sur « FixedOrientation », qui est le mode par défaut, aucune rotation automatique n’est appliquée aux valeurs affichées. Il s’agit du seul mode disponible pour les backends qui ne prennent pas en charge la fonctionnalité « QSensor::AxesOrientation ».

Lorsqu’elle est définie sur « AutomaticOrientation », les valeurs de lecture sont automatiquement pivotées lorsque l’orientation de l’écran change. En effet, l’orientation de l’écran est annulée.

À titre d’exemple, supposons que l’appareil soit pivoté de 180 degrés et que, par conséquent, l’orientation de l’écran soit également pivotée de 180 degrés par rapport à l’orientation native. Sans l’orientation automatique des axes, les valeurs mesurées seraient alors modifiées : les valeurs X et Y seraient toutes deux inversées, ce qui obligerait le développeur d’applications à annuler manuellement cette inversion dans le code de l’application. L’orientation automatique des axes s’en charge automatiquement ; dans ce mode, les valeurs X et Y seraient identiques à celles de l’orientation d’écran par défaut.

Cette rotation automatique des axes s’avère pratique dans certains cas d’utilisation, par exemple dans une application de niveau à bulle qui mesure le niveau d’une surface en analysant la valeur de l’axe X d’un accéléromètre. Lorsque l’orientation de l’appareil et de l’écran change de 90 degrés, le développeur d’applications n’a rien à modifier ; il peut continuer à utiliser la valeur de l’axe X même si l’appareil est pivoté. Sans orientation automatique des axes, le développeur d’applications devrait alors se baser sur les valeurs Y, ce qui l’obligerait à ajouter du code à l’application pour lire les données à partir d’un axe différent en fonction de l’orientation de l’écran.

Le mode « UserOrientation » est assez similaire à « AutomaticOrientation », à la différence près que l'orientation de l'écran est contrôlée manuellement au lieu d'être déterminée automatiquement. L'angle de la propriété « userOrientation » est alors utilisé pour faire pivoter les valeurs de lecture.

La rotation des valeurs de lecture étant basée sur l’orientation de l’écran, les valeurs Z ne changent jamais, car l’axe Z est perpendiculaire à l’écran. L’orientation de l’écran changeant par paliers de 90 degrés, la rotation des valeurs de lecture s’effectue également par paliers de 90 degrés.

Cette propriété n’est utilisée que pour les capteurs orientables.

Fonctions d’accès :

Signal de notification :

bufferSize : int

Cette propriété indique la taille de la mémoire tampon. Par défaut, la taille de la mémoire tampon est de 1, ce qui signifie qu'il n'y a pas de mise en mémoire tampon. Si la taille maximale de la mémoire tampon est de 1, cela signifie que la mise en mémoire tampon n'est pas prise en charge par le capteur.

Si vous définissez bufferSize sur une valeur supérieure à maxBufferSize, la mise en mémoire tampon ( maxBufferSize ) sera activée.

La mise en mémoire tampon est activée lorsque bufferSize est supérieur à 1. Le capteur collectera le nombre d’échantillons demandé et les transmettra tous à l’application en une seule fois. Ils seront transmis à l’application sous la forme d’une rafale de valeurs modifiées ; il est donc particulièrement important que l’application traite chaque valeur immédiatement ou enregistre les valeurs ailleurs.

Si la fonction ` stop()` est appelée alors que la mise en mémoire tampon est en cours, le tampon partiel n’est pas transmis.

Lorsque le capteur est lancé avec l’option de mise en mémoire tampon, les valeurs sont collectées à partir de ce moment-là. Il n’existe pas de mémoire tampon préexistante pouvant être utilisée.

Certains backends prennent uniquement en charge l’activation ou la désactivation de la mise en mémoire tampon et ne permettent pas de contrôler sa taille. Dans ce cas, les propriétés ` maxBufferSize ` et ` efficientBufferSize ` peuvent ne pas être définies du tout, même si la mise en mémoire tampon est prise en charge. Définir la propriété `bufferSize` sur une valeur supérieure à 1 activera la mise en mémoire tampon. Une fois le capteur démarré, la propriété bufferSize sera définie sur la valeur réelle par le backend.

Fonctions d’accès :

Signal de notification :

Voir également QSensor::maxBufferSize et QSensor::efficientBufferSize.

[read-only] busy : bool

Cette propriété contient une valeur indiquant si le capteur est occupé.

Certains capteurs peuvent être présents sur le système mais indisponibles. Cette fonction renvoie « true » si le capteur est occupé. Vous ne pourrez pas appeler la fonction « start() » sur ce capteur.

Notez que cette fonction ne renvoie pas « true » si vous utilisez le capteur, mais uniquement si un autre processus l'utilise.

Fonctions d'accès :

Signal de notification :

Voir également ` busyChanged()`.

[read-only] connectedToBackend : bool

Cette propriété contient une valeur indiquant si le capteur est connecté à un backend.

Un capteur qui n'est pas connecté à un backend ne peut rien faire d'utile.

Appelez la méthode ` connectToBackend()` pour forcer le capteur à se connecter immédiatement à un backend. Cette méthode est automatiquement appelée si vous appelez ` start()` ; vous n'avez donc besoin de l'appeler que si vous devez accéder aux propriétés du capteur (par exemple, pour interroger les métadonnées du capteur avant de l'utiliser).

Fonctions d’accès :

[read-only] currentOrientation : int

Cette propriété contient l'orientation actuelle utilisée pour faire pivoter les valeurs de lecture.

Elle peut ne pas correspondre à l'orientation de l'écran. Par exemple, en mode « FixedOrientation », les valeurs de lecture ne sont pas pivotées ; cette propriété prend donc la valeur 0.

En mode « UserOrientation », les valeurs de mesure sont pivotées en fonction de la propriété « userOrientation » ; cette propriété est donc égale à la propriété « userOrientation ».

En mode « AutomaticOrientation », les valeurs relevées sont pivotées en fonction de l’orientation de l’écran ; cette propriété est donc égale à l’orientation actuelle de l’écran.

Cette propriété est définie par le backend et n’est valable que pour les capteurs orientables.

Fonctions d’accès :

Signal de notification :

dataRate : int

Cette propriété définit le débit de données auquel le capteur doit fonctionner.

Elle est exprimée en hertz.

Le débit de données correspond à la fréquence maximale à laquelle le capteur peut détecter des changements.

La configuration de cette propriété n’est pas portable et peut entraîner des conflits avec d’autres applications. Consultez la documentation du backend du capteur et de la plateforme pour connaître les règles applicables lorsque plusieurs applications demandent un débit de données.

La valeur par défaut (0) signifie que l’application ne se soucie pas du débit de données. Les applications doivent envisager d’utiliser une interrogation de la valeur actuelle basée sur une minuterie ou s’assurer que le code traitant les valeurs s’exécute très rapidement, car la plateforme peut fournir des mises à jour plusieurs centaines de fois par seconde.

Ce paramètre doit être défini avant d’appeler la méthode ` start()` car le capteur risque de ne pas détecter les modifications apportées à cette valeur pendant son exécution.

Notez qu’il n’existe aucun mécanisme permettant de déterminer le débit de données actuellement utilisé par la plateforme.

Fonctions d’accès :

Signal de notification :

Voir également QSensor::availableDataRates.

[read-only] description : QString

Cette propriété contient une chaîne de caractères descriptive du capteur.

Fonctions d'accès :

[read-only] efficientBufferSize : int

Cette propriété indique la taille de tampon la plus efficace. En règle générale, cette valeur est égale à 1 (ce qui signifie qu'aucune taille particulière n'est la plus efficace). Certains pilotes de capteurs disposent d'un tampon FIFO, ce qui rend plus efficace la transmission en une seule fois d'un nombre de mesures correspondant à la taille de ce tampon.

Fonctions d'accès :

Signal de notification :

Voir également QSensor::bufferSize et QSensor::maxBufferSize.

[read-only] error : int

Cette propriété contient le dernier code d'erreur enregistré sur le capteur.

Notez que les codes d'erreur sont spécifiques à chaque capteur.

Fonctions d'accès :

Signal de notification :

identifier : QByteArray

Cette propriété contient l'identifiant du backend associé au capteur.

Notez que cet identifiant est renseigné automatiquement lorsque le capteur est connecté à un backend. Si vous souhaitez vous connecter à un backend spécifique, vous devez appeler la méthode `setIdentifier()` avant ` connectToBackend()`.

Fonctions d'accès :

Signal de notification :

[read-only] maxBufferSize : int

Cette propriété indique la taille maximale de la mémoire tampon.

Notez que cette valeur peut être égale à 1, auquel cas le capteur ne prend en charge aucune forme de mise en mémoire tampon. Dans ce cas, la fonction « isFeatureSupported » (QSensor::Buffering) renverra également la valeur « false ».

Fonctions d'accès :

Signal de notification :

Voir également QSensor::bufferSize et QSensor::efficientBufferSize.

outputRange : int

Cette propriété contient la plage de sortie utilisée par le capteur.

Cette valeur correspond à l'index de la liste « QSensor::outputRanges » à utiliser.

La configuration de cette propriété n’est pas portable et peut entraîner des conflits avec d’autres applications. Consultez la documentation du backend du capteur et de la plateforme pour connaître les règles applicables en cas de demandes de plage de sortie émanant de plusieurs applications.

La valeur par défaut (-1) signifie que l'application ne se soucie pas de la plage de sortie.

Notez qu’il n’existe aucun mécanisme permettant de déterminer la plage de sortie actuellement utilisée par la plateforme.

Fonctions d’accès :

Voir également QSensor::outputRanges.

[read-only] outputRanges : qoutputrangelist

Cette propriété contient la liste des plages de sortie prises en charge par le capteur.

Un capteur peut disposer de plusieurs plages de sortie. Cela permet généralement d'obtenir une plage de mesure plus large, au détriment de la précision.

Notez que cette information n'est pas obligatoire. Elle n'est généralement disponible que pour les capteurs dont les plages de sortie sont sélectionnables (comme c'est souvent le cas pour les accéléromètres).

Fonctions d'accès :

Voir également QSensor::outputRange et qoutputrangelist.

[read-only] reading : QSensorReading*

Cette propriété contient la classe de lecture.

La classe de lecture permet d'accéder aux mesures des capteurs. L'objet de lecture est un cache volatile contenant la mesure la plus récente reçue d'un capteur ; l'application doit donc traiter ces mesures immédiatement ou enregistrer les valeurs quelque part en vue d'un traitement ultérieur.

Notez que cette propriété renvoie 0 tant qu’aucun backend de capteur n’est connecté à un backend.

Notez également que les mesures ne sont pas immédiatement disponibles après l'appel de la fonction ` start()`. Les applications doivent attendre que le signal ` readingChanged()` soit émis.

Fonctions d'accès :

Signal de notification :

Voir également isConnectedToBackend() et start().

skipDuplicates : bool

Indique s'il faut omettre les valeurs de mesure en double.

Lorsque l'omission des valeurs en double est activée, les mesures successives dont les valeurs sont identiques ou très similaires sont omises. Cela permet de réduire la charge de traitement, car moins de mesures de capteurs sont mises à disposition. Par conséquent, les mesures arrivent à des intervalles irréguliers.

L'omission des valeurs en double n'est pas seulement activée pour les lectures exactement identiques, mais également pour celles qui sont assez similaires, car chaque capteur présente une légère instabilité même si l'appareil n'est pas déplacé.

La prise en charge de cette propriété dépend du backend. Utilisez ` isFeatureSupported()` pour vérifier si elle est prise en charge sur la plate-forme actuelle.

L'ignorance des doublons est désactivée par défaut.

L'ignorance des doublons prend effet au démarrage du capteur ; la modification de cette propriété alors que le capteur est actif n'a aucun effet immédiat.

Fonctions d’accès :

Signal de notification :

[read-only] type : const QByteArray

Cette propriété contient le type du capteur.

Fonctions d'accès :

userOrientation : int

Cette propriété définit l'angle utilisé pour faire pivoter les valeurs de lecture en mode « UserOrientation ».

Lorsque la propriété « axesOrientationMode » est définie sur « UserOrientation », l'angle de rotation des valeurs lues est déterminé par cette propriété. Dans les autres modes, cette propriété n'a aucun effet.

La valeur par défaut est 0. Les seules valeurs valides sont 0, 90, 180 et 270, car ce sont les seules orientations d'écran possibles.

Cette propriété n'est valable que pour les capteurs orientables.

Fonctions d'accès :

Signal de notification :

QSensor *magnetometer = new QSensor(QMagnetometer::sensorType, this);

QMagnetometer *magnetometer = new QMagnetometer(this);

sensor.start();
if (sensor.isBusy()) {
    // need to wait for busyChanged signal and try again
}

sensor->start();
sensor->reading()->x(); // no data available

    connect(sensor, SIGNAL(readingChanged()), this, SLOT(checkReading()));
    sensor->start();
}
void MyClass::checkReading() {
    sensor->reading()->x();

typedef QList<qoutputrange> qoutputrangelist;

typedef QPair<int,int> qrange;

typedef QList<qrange> qrangelist;