Pages MetaSound

Les pages MetaSound sont des variantes de MetaSound que vous pouvez utiliser pour prendre en charge différents niveaux de performances matérielles. Avec les pages, vous pouvez définir un ensemble de valeurs d'entrée MetaSound ou un graphique MetaSound entièrement différent, puis basculer entre les pages en fonction des plateformes cibles ou de la logique d'exécution.

Dans la mesure où les plateformes ne sont pas en corrélation directe avec les pages, vous pouvez les mapper en fonction de la complexité, de l'utilisation du processeur, de l'utilisation de la mémoire ou de tout autre élément.

Vous ne pouvez pas utiliser les pages pour modifier les instances MetaSound actives, car les échanges de données paginées se produisent avant l'exécution d'une instance MetaSound.

Utiliser les pages

Ajuster les paramètres du projet

Vous pouvez créer des pages et ajuster leurs paramètres dans les paramètres du projet.

1. Sélectionnez Modifier > Paramètres du projet.
2. Sur la gauche, sous le titre Moteur, sélectionnez MetaSounds.
3. Modifiez les paramètres suivants dans la section Pages (expérimental) :
   1. Cliquez sur le bouton Ajouter en regard de Paramètres de page pour ajouter une page à la matrice.
   2. Développez le nouvel élément de matrice.
   3. Définissez le nom, par exemple « Faible », « Élevé » ou « Mobile ». L'ordre des pages dans la matrice est important. Consultez la rubrique Gestion des solutions de repli pour en savoir plus.
   4. Si l'option Ciblable est définie sur true, la page cible toutes les plateformes. Si vous souhaitez cibler une plateforme spécifique, cliquez sur le bouton Ajouter en regard de Ciblable et sélectionnez la plateforme cible. Répétez cette étape pour en définir plusieurs.
   5. Si vous souhaitez exclure la page de la phase de préparation sur des plateformes spécifiques, cliquez sur le bouton Ajouter en regard de Exclure de la préparation et sélectionnez les plateformes à exclure. Répétez cette étape pour en définir plusieurs.
   6. Si vous souhaitez cibler une page autre que celle « par défaut », définissez le nom de page cible sur la page souhaitée. Consultez la rubrique Nom de page cible pour en savoir plus sur ce paramètre.

La page par défaut ne peut pas être supprimée ou renommée.

Gestion des solutions de repli

Si une page cible n'est pas implémentée pour la plateforme active, MetaSound utilise l'ordre d'indexation des pages préparées dans les paramètres de page. Plus précisément, MetaSound rétablit la page suivante la plus basse de l'ordre d'indexation qu'il implémente. Si aucune solution de repli n'est trouvée, MetaSound utilise l'implémentation par défaut.

Nom de la page cible

Le paramètre Nom de page cible définit la page utilisée lors de l'exécution de MetaSounds. Cette cible est reflétée lors de la lecture dans Play In Editor (PIE).

Vous pouvez définir le nom de page cible de la manière suivante :

• Dans les paramètres du projet
• Dans le fichier .ini d'une plateforme ([PROJECT_ROOT]\Platforms\[PLATFORM_NAME]\Config\[PLATFORM_NAME]MetaSound.ini)
• À l'aide de la variable de console cvar au.MetaSound.Pages.SetTarget [PAGE_NAME]
• Dans Blueprint ou dans C++, lors de l'exécution

Le nom de page cible s'affiche également par défaut dans l'éditeur MetaSound, mais vous pouvez aussi auditionner la page avec d'autres plateformes et pages. Consultez la rubrique Auditionner des pages dans l'éditeur pour en savoir plus.

Paginer des graphiques MetaSound

Après avoir configuré les pages dans les paramètres du projet, vous pouvez les utiliser dans les graphiques MetaSound Source et Patch dans l'onglet Pages.

Dans l'onglet Pages, vous pouvez :

• ajouter une nouvelle page en en sélectionnant une dans le menu déroulant Ajouter un graphique de page ;
• supprimer une page en sélectionnant le bouton Corbeille en regard celle-ci ;
• cibler sur une page en sélectionnant le bouton Cibler (<-) à gauche de celle-ci.

Si vous ajoutez une page, le graphique existant est copié sur la nouvelle page. Par la suite, toutes les modifications apportées au graphique actif s'appliquent uniquement à la page ciblée. Vous devez utiliser ce flux de travail pour créer le meilleur son possible, puis ajouter des pages pour les variantes nécessitant des graphiques moins complexes.

Toutes les pages partagent les mêmes membres d'entrée et de sortie, y compris les interfaces. Cependant, les variables sont définies par graphique.

Vous pouvez afficher la page actuellement ciblée dans l'angle inférieur gauche du panneau Graphique MetaSound.

Paginer des entrées MetaSound

En plus des variantes de graphiques, vous pouvez également regrouper différentes valeurs d'entrée par défaut par page. Par exemple, vous pouvez spécifier un nombre différent d'ondes sonores dans une matrice en fonction des différents besoins en ressources de vos pages cibles.

Pour créer une entrée paginée, procédez comme suit :

1. Dans le panneau Membres, sélectionnez une entrée.
2. Dans le panneau Détails, cliquez sur le menu déroulant Valeur par défaut > Ajouter une valeur de page par défaut et sélectionnez la page concernée. Une nouvelle entrée Valeur par défaut est ainsi créée.
3. Définissez la valeur de la nouvelle entrée.

Solution de repli des entrées sans graphique

Les variantes d'entrée associées aux pages sont distinctes des variantes de graphiques. Si un graphique paginé n'est pas disponible pour une page donnée, le prochain graphique paginé disponible est utilisé comme solution de repli avec toutes les variantes d'entrée pertinentes.

Par exemple, vous pouvez utiliser une entrée paginée « Faible » sur le graphique d'une page « Moyen » en procédant comme suit :

1. Dans les paramètres du projet, créez les pages « Moyen » et « Faible » dans cet ordre.
2. Sur MetaSound :
   1. Créez le graphique paginé « Moyen ».
   2. Créez une entrée paginée « Faible ».

Consultez la rubrique Gestion des solutions de repli pour en savoir plus.

Auditionner des pages dans l'éditeur

Par défaut, l'audition d'un MetaSound dans l'éditeur MetaSound correspond aux éléments lus dans PIE.

Cependant, vous pouvez remplacer cette fonctionnalité dans le menu Audition, où vous pouvez combiner les éléments suivants :

• Plateforme d'audition : définissez une plateforme et appliquez les paramètres de cible et de préparation pertinents à l'audition.
• Synchroniser avec le page de graphique (activé par défaut) : si ce paramètre est activé, la lecture d'un MetaSound dans l'éditeur MetaSound lit le graphique de la page ciblée. Si cette option est désactivée, vous pouvez sélectionner une page d'audition spécifique à prévisualiser.

Si la page n'est pas une page cible pour la plateforme d'audition sélectionnée, le bouton Lecture devient jaune avec une icône d'avertissement et une infobulle correspondante. Cependant, vous pouvez toujours lancer la lecture.

Les paramètres du menu Audition sont reflétés dans Préférences de l'éditeur > Éditeur MetaSound.

Limites

• Vous ne pouvez pas ajouter ou supprimer de pages dans un préréglage MetaSound, mais pouvez remplacer les valeurs par défaut des entrées de page.
• Les valeurs par défaut des entrées d'interface ne prennent pas en charge les valeurs par défaut des entrées de page.
• Les classes de nœud C++ ne prennent pas en charge les valeurs par défaut des entrées de page.
• Les projets ne peuvent pas modifier le comportement d'audition dans l'éditeur.