Export vidéo

L'éditeur rend le niveau ouvert dans un fichier vidéo grâce à ffmpeg installé sur ton ordinateur. Le rendu se fait hors temps réel, une image à la fois, donc la vidéo est exacte quelle que soit la lenteur de la machine

L'export fonctionne sur Windows, macOS et Linux. Il n'est pas disponible sur téléphone

Où le trouver

Exporter la vidéo dans la colonne latérale des paramètres du niveau
la commande Exporter la vidéo dans la palette de commandes

La fenêtre s'ouvre par-dessus l'éditeur. Ouverte depuis les paramètres du niveau, elle y revient à la fermeture. Pendant le rendu d'une vidéo, la fenêtre ne peut pas être fermée : Arrêter met fin au rendu

Installer ffmpeg

ffmpeg ne fait pas partie du jeu. Installe-le une fois, et la fenêtre le trouve d'elle-même. Il faut la version 7.0 ou plus récente. Une version plus ancienne est refusée, et la fenêtre nomme la version trouvée

Système	Commande d'installation
Windows	`winget install ffmpeg`
macOS	`brew install ffmpeg`
Linux	le paquet de ta distribution, par exemple `sudo apt install ffmpeg`

Avertissement

Certaines distributions Linux fournissent un ffmpeg plus ancien que 7.0 (Ubuntu 24.04 fournit la 6.1). Installe alors une version plus récente depuis le site de ffmpeg et indique-la à la fenêtre

La fenêtre cherche ffmpeg dans cet ordre :

le fichier que tu as choisi avec Choisir ffmpeg.... Rien d'autre n'est alors cherché
le chemin dans la variable d'environnement BH_FFMPEG
tools/ffmpeg dans le dossier de données du jeu
chaque dossier de PATH
les dossiers où écrivent les installateurs habituels

Rechercher automatiquement oublie le fichier choisi et cherche à nouveau. Revérifier refait la vérification, par exemple juste après une installation

Ton ffmpeg peut contenir des encodeurs matériels (NVIDIA, AMD, Intel, Apple). La fenêtre essaie chacun sur un dixième de seconde de noir et n'utilise que ceux qui fonctionnent vraiment sur cet ordinateur

Options de la fenêtre

Option	Ce qu'elle fait
`Conteneur`, `Codec`	le type de fichier et la façon dont il est compressé, voir les formats plus bas
`Résolution`	la taille de la vidéo. La largeur et la hauteur sont des nombres pairs de `16` à `7680`
`Fréquence d'images`	les images par seconde de la vidéo, jusqu'à `240`. Elles ne dépendent pas de la fréquence d'images propre au niveau. En dessous de `60`, chaque image est simulée en plusieurs pas, pour que le bot joue comme dans le jeu
`Plage`	tout le niveau, la plage de boucle de la timeline, ou tes propres images de début et de fin
`Qualité`	la place que prend la vidéo. Masqué pour les formats sans perte de toute façon
`Couleur complète (4:4:4)`	la couleur pour chaque pixel au lieu d'un sur deux. Des lignes colorées fines plus nettes, un fichier plus gros
`Graine (0 = comme dans l'éditeur)`	la graine du hasard du niveau. `0` garde la graine qu'utilise l'éditeur
`Pré-roll, secondes`	combien de secondes avant le début sont jouées mais pas enregistrées, pour que les effets aient déjà leur historique. `2` par défaut, jusqu'à `10`
`Qui joue`	`Reflex Bot v1` par défaut, `Warm Bot v1`, ou `Aucun bot` pour une vidéo sans avatar. Les impacts ne font rien pendant un export
`Post-traitement`, `Effets`	les mêmes interrupteurs que dans l'éditeur, pour la vidéo seulement
`Audio`	les pistes du niveau dans la vidéo

Chaque option a son propre ? dans la fenêtre.

L'interface de l'éditeur, la grille, les gizmos, la sélection et les limites de la caméra n'entrent jamais dans la vidéo. La caméra du niveau cadre l'image, et des bandes noires remplissent ce que son format ne couvre pas

Vitesse de rendu

La vidéo ne dépend pas de la vitesse de ton ordinateur. Le temps du niveau et le bot avancent tous deux d'exactement une image de la vidéo par image rendue, donc une machine lente rend la même vidéo, simplement plus tard

Warm Bot v1 calcule tout son parcours avant la première image, et la fenêtre montre où il en est. S'il ne trouve aucun parcours, l'export s'arrête et demande un autre bot

Formats

Un format, c'est deux choix : Conteneur et Codec. Seules les paires que ton ffmpeg sait produire sont listées. La ligne en dessous dit quel son va avec la paire et quel fichier tu obtiens

`Conteneur`	`Codec`	Son	Bon pour
`MP4`	H.264, HEVC, AV1	`AAC, 320 kbit/s`	envoyer et mettre en ligne n'importe où
`MKV (Matroska)`	H.264, HEVC, AV1, VP9, FFV1	`FLAC, sans perte`	l'archivage, FFV1 sans aucune perte
`MOV (QuickTime)`	H.264, HEVC, ProRes	`PCM 16 bits, non compressé`	le montage dans Premiere, DaVinci Resolve, Final Cut
`WebM`	VP9, AV1	`Opus, 256 kbit/s`	le web
`GIF`, `WebP (animé)`, `APNG`	-	pas de son	de courts clips en boucle pour les discussions et les pages
`Séquence d'images`	PNG, JPEG, WebP, TIFF	`audio.wav` à côté des images	n'importe quel logiciel de montage l'importe
`Son seulement`	WAV, FLAC, MP3, Opus	le format lui-même	le son du niveau seul, rien n'est rendu

Le GIF prend une seule palette de 256 couleurs pour tout le clip. Garde-le court et petit : un GIF de tout un niveau pèse bien plus qu'un MP4 du même niveau

Où va la vidéo

Par défaut, la vidéo va dans recordings/<level id>/ dans le dossier de données du jeu, nommée d'après le niveau et l'heure de l'export. Ouvrir le dossier des enregistrements ouvre ce dossier. Choisir... enregistre la vidéo suivante n'importe où ailleurs

Les enregistrements restent quand tu supprimes le niveau. Ils ne font pas partie d'un transfert de profil, sauf si tu coches Captures vidéo

Son

Le son de la vidéo n'est pas enregistré depuis les haut-parleurs, et tu n'entends rien pendant un export.

Avec Son via le moteur (avec effets) activé (par défaut) et des effets sur les pistes, le son du niveau joue en temps réel pendant le rendu des images, et le son propre au jeu est enregistré, effets compris. L'export dure au moins la longueur de la plage : un ordinateur rapide attend la fin du son. Désactivé, les pistes sont mixées à part, avec leurs images clés de volume et de panoramique mais sans leurs effets. Son seulement mixe toujours à part

Sous l'aperçu, la fenêtre montre deux timelines, Images et Son : elles avancent indépendamment. Sur un niveau lourd, le son en parallèle peut saccader. Active alors Enregistrer le son après les images : le son est enregistré après la dernière image, et l'export prend plus longtemps, de la longueur de la plage

Avertissement

Ne ferme pas le jeu pendant le rendu d'une vidéo. La fenêtre le rappelle pendant toute la durée

Ce qui n'est pas dans la vidéo

les effets sur les pistes audio, mais seulement avec Son via le moteur (avec effets) désactivé ou dans Son seulement. La fenêtre prévient quand le niveau en a
un arrière-plan transparent
un enregistrement de ta façon de jouer : seul le bot peut jouer dans la vidéo

À lire ensuite : Export et protection, Audio