HexaCone/tools/README.md
2026-01-02 12:43:30 +01:00

57 lines
1.6 KiB
Markdown

# Tools
The page for « Build system and utilities ».
## Make a sequence
Un argument pour construire la séquence entière ou deux pour démarrer au
milieu, c'est parfois pratique quand le disjoncteur fait un *beu-beu* en
plein milieu. Exemples :
```
$ tools/mkloop.sh survol
$ tools/mkloop.sh survol 133
```
Et pour générer plusieurs séquences dans la foulée, avec les
post-processings (ega-mp4 et ega-gif89a) en même temps,
vous avez le script [Mk Sex](mkseqs.sh) à votre service.
Mkloop ajoute le nom de la séquence, le numéro de trame et le temps de
rendu au fichier `log/mp4.timing` permettant ainsi la création de
graphiques aussi jolis qu'inutiles.
## Linkfarming
C'est le directeur de la production, le grand
[script](./linkfarmer.sh)
d'assemblage des séquences avec générique et intertitres.
Hélas, il n'est pas encore configurable. Mais c'est
en projet pour janvier 2026 ?
## Encoding
Le [script](./encode.sh) n'est qu'un wrapper autour de
la fonction `ff_encodage()` de la lib des tools :
[fonctions.sh](fonctions.sh). Par défaut, il encode
la séquence *essai*.
Le fichier de sortie s'appelle *wip.mp4* dans tous les cas.
## Plot the timing
On peut visualiser le temps de calcul d'une séquence avec la
commande [plot-timing.sh](./plot-timing.sh) qui génère un fichier
PNG. C'est un script basé sur *Awk* et *Gnuplot*.
Ces graphiques sont utilisés comme fond pour les
intertitres.
```
$ tools/plot-timing.sh essai && d timing.png
```
Cette commande utilise le fichier `log/mp4.timing`, lequel est généré
par le script de création de séquence vu plus haut.