Miroir de composition
LINK PC-VR DOCUMENTATION
Ce sujet concerne le développement avec le SDK PC. Pour en savoir plus sur l’optimisation des performances pour les applications Meta Quest, consultez l’un des sujets suivants en fonction de votre plateforme de développement : L’outil Miroir de composition affiche le contenu qui apparaît dans le casque Rift sur l’écran de votre ordinateur. Il possède plusieurs options d’affichage utiles pour le développement, le dépannage et les présentations.
Tout ce qui apparaît dans le casque Rift peut être affiché dans l’outil Miroir de composition, y compris Oculus Home, les limites du système Guardian, les notifications dans le jeu et les fondus de transition. Cet outil est compatible avec tous les jeux ou expériences, qu’ils aient été développés avec le SDK PC natif ou un moteur de jeu.
L’outil Miroir de composition se trouve dans C:\Program Files\Oculus\Support\oculus-diagnostics\OculusMirror.exe
Options d’affichage d’image
L’outil Miroir de composition possède plusieurs options d’affichage.
Le mode par défaut est recommandé pour les présentations en direct et les démos. Si vous double-cliquez sur OculusMirror depuis l’Explorateur Windows ou si vous l’exécutez depuis la ligne de commande sans spécifier d’options, l’outil affiche une fenêtre 1 366 x 768 (pixels) montrant une vue rectiligne de l’image de l’œil droit, ainsi que la couche de limite du système Guardian et la couche de notification.
Les autres modes d’affichage sont les suivants :
OculusMirror.exe --LeftEyeOnly : affichage de l’image de l’œil gauche dans une vue rectiligne :

OculusMirror.exe --RightEyeOnly : affichage de l’image de l’œil droit dans une vue rectiligne :

OculusMirror.exe --RectilinearBothEyes : affichage des images des deux yeux dans une vue rectiligne :

OculusMirror.exe --RectilinearBothEyes --IncludeGuardian : affichage des images des deux yeux dans une vue rectiligne ainsi que de la limite du système Guardian. Dans l’exemple suivant, les mains de l’utilisateur·ice ont dépassé la limite du système Guardian à deux endroits, comme l’indiquent les trous circulaires dans la limite :

OculusMirror.exe --PostDistortion : affichage des images des deux yeux corrigées de la distorsion de la lentille et de l’aberration chromatique. Cela affichera également toutes les autres options qui apparaissent dans le casque. Par exemple, la sortie suivante est produite avec --PostDistortion, mais montre également la limite du système Guardian, puisqu’elle est visible à l’intérieur du casque. Aucune option supplémentaire n’est autorisée en conjonction avec --PostDistortion. Par exemple, vous ne pouvez pas exclure explicitement les notifications ou la limite du système Guardian si elles sont visibles dans le casque.

Modification de la taille de la fenêtre
Vous pouvez modifier la taille de la fenêtre en faisant glisser les bords de la fenêtre sur le bureau. Vous pouvez également utiliser la commande --Size width height pour définir la taille de la fenêtre (en pixels) depuis la ligne de commande. Si vous dépassez la résolution de votre écran principal, la taille de la fenêtre est réduite pour s’adapter. Par exemple :
OculusMirror.exe --Size 2160 2160 --RightEyeOnly
Ajustement du champ de vision
Le champ de vision par défaut utilisé par le Miroir de composition ne montre pas autant de contenu que dans le casque. Pour l’augmenter, vous pouvez utiliser l’option FovTanAngleMultiplier. L’exemple suivant montre les paramètres recommandés pour correspondre au mieux au champ de vision d’Oculus Rift :
OculusMirror.exe --FovTanAngleMultiplier 1.3 1.3
Affichage des notifications
Vous pouvez afficher la couche de notifications en utilisant --IncludeNotifications. Par exemple :
OculusMirror.exe --RectilinearBothEyes --IncludeNotifications
Clignotement lors de suppressions d’images
Il est possible que l’outil Miroir de composition supprime des images qui sont affichées dans le casque Rift. Si vous souhaitez voir clairement quand cela se produit, utilisez la commande --FlashFrameDrops. Cela provoquera le clignotement de l’affichage dans le Miroir de composition chaque fois qu’une image est supprimée. Par exemple :
OculusMirror.exe --FlashFrameDrops --RectilinearBothEyes
Capture de contenu pour le streaming
Vous pouvez combiner plusieurs des options précédentes pour capturer du contenu Oculus Rift optimal pour le streaming. Après le lancement du Miroir de composition, vous pouvez utiliser Open Broadcaster Software (OBS) pour capturer et diffuser votre flux. Voici les paramètres recommandés :
OculusMirror.exe --Size 1280 1280 --FovTanAngleMultiplier 1.3 1.3 --DisableTimewarp --SymmetricFov --RightEyeOnly --DisableFovStencil --IncludeSystemGui --IncludeNotifications
Pour faciliter l’utilisation répétée, il est recommandé de placer ce paramètre dans un fichier .bat afin de ne pas avoir à le saisir à chaque fois que vous souhaitez diffuser du contenu. Voici l’aspect du contenu d’un fichier .bat avec les paramètres recommandés :
start "" "OculusMirror.exe" --Size 1280 1280 --FovTanAngleMultiplier 1.3 1.3 --DisableTimewarp --SymmetricFov --RightEyeOnly --DisableFovStencil --IncludeSystemGui --IncludeNotifications
exit