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

Auteur : paulber19

URL : paulber19@laposte.net

Dépot GitHub : 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 multi-piste 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 stable 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é

Cette extension a été testée avec Audacity version 3.2, 3.1, 3.0 et 2.4.2. Les versions précédentes d'Audacity ne sont pas soutenues.

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 commendes " de NVDA, les scripts apportés par l'extension sont placées dans la catégorie "Éditeur multi-piste Audacity : complément d'accessibilité".

Pour les scripts pouvant être lancés par une commande de l'interpréteur, cell-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 sonnore 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 multi-piste 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 sauvegarder 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 le champ "position audio" de la barre d'outils "Sélection" (ou Audacity selection Toolbar",nom non traduit).

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 plusieurs informations :

Il est possible de les faire annoncer tout en restant dans la vue de piste avec les scripts suivants :

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

Audacitypré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

La barre d'outils de mixage (ou "Audacity mixer Toolbar", nom non traduit) 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 :

3.6. 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 zone de sélection numérique "position audio" de la barre d'outils "Sélection"ou "Temps suivant la version d'Audacity, 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 du raccourci, les changements de sélection sont annoncés Suivant le type de raccourci, l'une ou/et l'autre des zones 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 (par exemple, sélection fin au lieu de fin de la sélection", "durée sélection" au lieu de "longueur de la sélection").

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" mais cela déplace le focus sur l'élément suivant de la fenêtre et aucun changement d'état du bouton n'est vocalisé.

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 et les changements sont alors annoncés.

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

Audacity présente des zones de sélection numérique pour afficher un temps comme par exemple : lla 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 zones d'édition présentent l'information suivant le format défini par l'utilisateur à l'aide du menu contextuel de la zone.

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 haute 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 zones de sélecction numérique citée en exemple ci-dessus.

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

Seules les format suivants sont pris en compte :

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

Les mêmes mécanismes sont mis en place dans d'autre boites de dialogue qui présentent des zones 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"