Éditeur multipiste Audacity: complément d'accessibilité - manuel utilisateur

Auteur : paulber19 (paulber19@laposte.net)

URL: https://github.com/paulber19/audacityAccessEnhancementNVDAAddon.git

Téléchargement :

Compatibilité :

Sommaire

1. Introduction

1.1. Fonctionnalités

Cette extension tente d'améliorer l'accessibilité de l'éditeur audio multipiste Audacity (®) en apportant les scripts :

Ainsi que les améliorations d'accessibilité suivantes :

1.2. mise à jour

La mise à jour de l'extension se fait, par défaut, automatiquement peu de temps après le démarrage de NVDA (entre 20 et 600 secondes) et au maximum une fois par jour. Il est possible de désactiver cette mise à jour en décochant l'option "Rechercher automatiquement les mises à jour" se trouvant dans la catégorie "Mise à jour" des paramètres de l'extension. La version de l'extension peut être :

Par défaut, une version stable est mise à jour avec une version stable plus récente (numéro de version supérieur). Mais il est possible de mettre à jour la version stable courante avec une version de développement de la prochaine version stable. Il suffit de cocher l'option "Mettre aussi à jour les versions stables vers les versions de développement " situé dans les paramètres de l'extension, élément de menu "Mise à jour".

Une version de développement est mise à jour :

Le bouton "Rechercher une mise à jour" placé dans la catégorie "Mise à jour" des paramètres de l'extension, permet de rechercher immédiatement une mise à jour.

Le bouton "Voir l'historique", placé dans cette même catégorie, vous permet d'afficher l'historique de la version actuelle dans le navigateur.

Dans le cas d'une mise à jour automatique et si une nouvelle version est détectée, la boite de dialogue "Mise à jour" s'affiche pour proposer :

Dans le cas d'une mise à jour vers une version stable, Le bouton "Quoi de neuf" offre la possibilité d'ouvrir, dans le navigateur, l'historique de l'extension et ainsi pouvoir connaitre les nouveautés de la version proposée.

1.3. Compatibilité

1.4. Recommandations de configuration

Pour un bon fonctionnement de l'extension, il est nécessaire de :

Autres recommandations de configuration (voir pour plus d'information le "guide d'Audacity" ) :

1.5. Activation des scripts

Chaque script peut être activé de deux manière :

Dans la boite de dialogue "Gestes de commandes" de NVDA, les scripts apportés par l'extension sont placées dans la catégorie "Éditeur multipiste Audacity : complément d'accessibilité".

Pour les scripts pouvant être lancés par une commande de l'interpréteur, celle-ci est indiquée à la suite de la description du script.

Par défaut, la grande majorité des scripts pouvant être lancer par l'interpréteur de commandes n'est affectée à aucun geste de commande.

L'interpréteur de commande se lance à l'aide du geste de commande "NVDA + Espace". Un bip sonore est alors audible.

Aujourd'hui, les commandes ne sont pas modifiables.

La commande "h" de l'interpréteur liste l'ensemble des commandes et la commande "g" affiche le manuel d'utilisation de l'extension.

L'interpréteur de commandes s'arrête soit :

2. Configuration de l'extension

Cette extension installe dans le menu "Préférences" de NVDA le sous-menu "Éditeur multipiste Audacity : complément d'accessibilité - Paramètres ...". Celui-ci permet d'afficher le dialogue de configuration des paramètres de l'extension, à savoir :

Cette configuration est sauvegardée dans le fichier "audacityAccessEnhancementAddon.ini" enregistré dans le dossier de configuration utilisateur de NVDA.

3. Les scripts

3.1. Annonce de la position audio

Pour utiliser ce script, il faut que le focus soit dans la vue de piste.

Ce script se lance par la commande "a" de l'interpréteur.

Aucun geste de commande ne lui est affecté par défaut.

Il annonce le temps indiqué dans la boite de sélection numérique "position audio" de la barre d'outils "Temps".

3.2. Annonce des informations de sélection

Pour utiliser ce script, il faut que le focus soit dans la vue de piste.

La barre d'outils de sélection présente deux boites de sélection numériques qui donnent suivant le choix fait à l'aide du bouton "Selection Toolbar Setup" :

Avec les scripts suivants, Il est possible de faire annoncer le temps indiqué par ces deux boites sans avoir besoin de déplacer le focus dans la barre d'outils "Sélection" :

Par défaut, Aucun geste de commandes ne leur est affecté.

3.3. Annonce de l'état enfoncé des boutons Pause, lecture ou enregistrement

Pour utiliser ce script, il faut que le focus se trouve dans la vue de piste.

Il se lance par la commande "f5" de l'interpréteur.

Par défaut, aucun geste de commande ne lui est affecté.

Il annonce l'état "Enfoncé" des boutons "Lecture", "Pause" et "Enregistrement".

Dans le cas où aucun bouton n'est enfoncé, l'annonce "Aucun bouton enfoncé" est diffusée.

3.4. Annonce du niveau des vumètres de crête de lecture ou d'enregistrement

Dans les mélangeurs de lecture et d'enregistrement, Audacity présente les vumètres de lecture et d'enregistrement permettant de surveiller les pics de lecture ou d'enregistrement.

Les scripts suivants permettent de connaitre les niveaux de ces vumètres (quand ils sont disponibles) sans bouger le focus de la vue de pistes :

Par défaut, aucun geste de commande ne leur est affecté.

3.5. Annonce du niveau du curseur des potentiomètres de lecture ou enregistrement

Les mesureurs de lecture et d'enregistrement présente les potentiomètres de lecture et d'enregistrement permettant de régler les niveaux de lecture ou d'enregistrement :

Les scripts suivants permettent de connaitre les niveaux de ces curseurs sans bouger le focus de la vue de pistes :

Par défaut, aucun geste de commande ne leur est affecté.

3.6. Annonce de la vitesse de lecture

Il se lance par la commande "f11" de l'interpréteur.

Par défaut, aucun geste de commande ne lui est affecté.

Ce script annonce le niveau du potentiomètre "Vitesse de lecture" du groupe "Lecture-à-la-vitesse".

3.7. Affichage du guide d'Audacity

Ce script se lance par la commande "control+g" de l'interpréteur.

Par défaut, aucun geste de commande ne lui est affecté.

Il permet de faire afficher le guide d'Audacity écrit par David Bailes pour les utilisateurs du lecteur d'écran JAWS (C).

4. Améliorations d'accessibilité

4.1. Annonce automatique de la position audio

En lecture audio ou non, les raccourcis suivants d'Audacity (définis par défaut) permettent de définir ou de déplacer le curseur audio :

En lecture audio arrêtée et après l'activation du raccourci, l'information de la boite de sélection numérique "position audio" de la barre d'outils "Temps", est automatiquement annoncé si un changement a eu lieu et sous la forme :

Le retour de la position audio en début de sélection est signalé.

Ces raccourcis peuvent être modifiés par l'utilisateur sans impacter ce fonctionnement.

4.2. Annonce automatique de la sélection

Les raccourcis suivants d'Audacity (définis par défaut) permettent de définir ou de déplacer le début et la fin de la sélection :

Si l'option "Annoncer automatiquement les changements de sélection" de la catégorie "Options" des paramètres de l'extension est cochée, En lecture arrêtée et après l'activation d'un des raccourcis précédents, les changements de sélection sont annoncés Suivant le type de raccourci, l'une ou/et l'autre des boites de sélection numérique de la barre d'outils "Sélection" sont annoncés sous la forme :

Comme tous les libellés annoncés sont ceux qui sont affichés par Audacity, il peut y avoir des incohérences dues à la traduction ou au codage.

Ces raccourcis peuvent être modifiés par l'utilisateur sans impacter ce fonctionnement.

La commande "f4" de l'interpréteur de l'extension permet d'activer ou de désactiver cette annonce des changements de sélection quand celle-ci devient gênante. Elle fait basculer l'état de l'option "Annoncer automatiquement les changements de sélection" de l'état "coché" à l'état "décoché" ou réciproquement.

4.3. Utilisation de la barre d'espace ou de la touche Entrée pour appuyer sur un bouton

Dans Audacity, la barre d'espace est prévue pour lancer ou arrêter la lecture audio, mais pas pour appuyer sur un bouton.

Pour appuyer sur le bouton, il faut utiliser la touche "Entrée".

Si l'option "Utiliser la barre d'espace ou la touche Entrée pour appuyer sur un bouton" de la catégorie "Options" des paramètres de l'extension est cochée, il est alors possible d'appuyer sur un bouton avec la barre d'espace ou la touche Entrée.

4.4. Vocalisation des boites de sélection numérique du temps Audacity

Cette fonctionnalité n'est pas disponible dans les versions 3.3.x d'Audacity.

Audacity présente des boites de sélection numérique pour afficher un temps comme par exemple : la position audio, le début de sélection, la fin de sélection, le centre de sélection, la durée de sélection.

Ces boites de sélection présentent l'information suivant le format défini par l'utilisateur à l'aide du menu contextuel de la boite.

L'information est une suite de chiffres. Chaque chiffre appartient à un groupe de chiffre comme les heures, minutes, secondes, etc.

Pour modifier cette information, il faut se placer sur le chiffre à modifier (par flèche droite ou gauche) et l'augmenter ou le diminuer avec les flèches haut ou bas.

Par défaut, Cette extension permet une meilleure vocalisation en indiquant un temps en heure, minute et secondes, en indiquant la nature du chiffre qui est sélectionné et la valeur du groupe du chiffre modifié pour les boites de sélection numérique citée en exemple ci-dessus.

Ceci peut être désactivé en décochant l'option "Améliorer l'annonce des boites de sélection numérique" de la catégorie "Options" des paramètres de l'extension.

Seuls les formats suivants sont pris en compte :

La touche "NVDA + flèche haut" permet de faire vocaliser l'information de la boite de sélection numérique.

Les mêmes mécanismes sont mis en place dans d'autre boites de dialogue qui présentent des boites de sélection numérique de temps du même style, comme la boite de dialogue "Enregistrement temporisé".

4.5. Autres adaptations

5. Historique

L'historique des versions de cette extension est dans le fichier "changes.html"