ENIB S4-PRG_Rust 04_Track - Les pistes sonores

La première fonction à fournir, dans l'implémentation de Track, est nommée new() et est publique.
Elle sert à créer une donnée du type considéré (Self, c'est à dire Track ici).
Son unique paramètre est la valeur attendue pour le membre rate ; le membre samples sera simplement initialisé comme un vector vide.
Une utilisation minimale de cette fonction serait :
```
let my_track = Track::new(sample_rate);
```
Puisque le membre rate est privé (inaccessible depuis l'extérieur du module), il est utile de fournir, dans l'implémentation de Track, une fonction publique rate() renvoyant simplement la valeur de ce membre.
Une utilisation minimale de cette fonction serait :
```
let sample_rate = my_track.rate();
```
Il ne s'agit que de consulter l'état de la piste ; choisissez la forme du paramètre self en conséquence.
Il peut également être utile de fournir, dans l'implémentation de Track, une fonction publique duration() qui calcule et fournit la durée en secondes de la piste concernée✍
Ce calcul est trivial : c'est le nombre d'échantillons mémorisés dans le vector divisé par le sample-rate.
Prenez tout de même soin de réfléchir à la conversion de type numérique qui est la plus pertinente.
.
Une utilisation minimale de cette fonction serait :
```
let duration = my_track.duration();
```
Il ne s'agit que de consulter l'état de la piste ; choisissez la forme du paramètre self en conséquence.
Il pourrait être souhaitable de consulter la séquence d'échantillons d'une piste sonore.
Pour cela, il faut fournir, dans l'implémentation de Track, une fonction publique samples() dont le rôle est de fournir une slice partagée (non-mutable) de réels correspondant au contenu du membre samples.
Une utilisation minimale de cette fonction serait :
```
let samples = my_track.samples();
```
Il ne s'agit que de consulter l'état de la piste ; choisissez la forme du paramètre self en conséquence.
L'usage le plus courant que nous ferons de la piste sonore consiste à altérer les valeurs de ses échantillons pour représenter divers signaux.
De manière très similaire à la précédente fonction, il faut fournir, dans l'implémentation de Track, une fonction publique samples_mut() dont le rôle est de fournir une slice exclusive (mutable) de réels correspondant au contenu du membre samples.
Une utilisation minimale de cette fonction serait :
```
let samples = my_track.samples_mut();
```
Il s'agit cette fois d'accéder à des propriétés de la piste avec la possibilité de les modifier ; choisissez la forme du paramètre self en conséquence.
Jusqu'alors, une piste sonore crée par new() ne contient aucun échantillon ; il nous est donc indispensable de proposer un moyen de redimensionner cette piste✍
En particulier pour que les trois fonctions précédentes aient un intérêt.
.
Il faut alors fournir, dans l'implémentation de Track, une fonction publique ensure_sample_count() dont le rôle est de s'assurer que la piste contient au moins le nombre d'échantillons indiqué en paramètre.
Elle doit vérifier le nombre d'éléments du membre samples et, seulement si ce nombre est inférieur au paramètre, invoquer .resize() pour compléter avec des valeurs nulles jusqu'à la quantité souhaitée✍
Notre fonction ne doit pas diminuer la longueur de samples si celle-ci dépasse le nombre minimal attendu.
Les valeurs nulles assurent du fait que la piste reste silencieuse tant qu'on n'y inscrit pas explicitement de signal.
.
Une utilisation minimale de cette fonction serait :
```
my_track.ensure_sample_count(100000);
```
Il s'agit de modifier les propriétés de la piste ; choisissez la forme du paramètre self en conséquence.
De la même façon, il pourrait être confortable de demander à une piste sonore de se redimensionner pour atteindre une durée minimale exprimée en secondes.
Il suffit pour cela de fournir, dans l'implémentation de Track, une fonction publique ensure_duration() dont le rôle est de s'assurer que la piste contient au moins le nombre d'échantillons nécessaire pour couvrir la durée indiquée en paramètre.
Cette fonction se contente d'invoquer ensure_sample_count()✍
La durée souhaitée doit simplement être multipliée par le sample-rate.
Une nouvelle fois, la conversion de type numérique doit être effectuée avec suffisamment d'attention pour être pertinente.
.
Une utilisation minimale de cette fonction serait :
```
my_track.ensure_duration(3.5);
```
Il s'agit de modifier les propriétés de la piste ; choisissez la forme du paramètre self en conséquence.
Enfin, par confort, nous pouvons demander à une piste sonore de sauvegarder son état dans un fichier.
À cette fin, nous fournirons, dans l'implémentation de Track, une fonction publique save() dont le rôle est de produire le fichier sonore dont le nom est indiqué en paramètre.
Il ne s'agit que d'invoquer la fonction save_wav() déjà réalisée en lui transmettant les paramètres attendus.
Une utilisation minimale de cette fonction serait :
```
my_track.save("output_sound.wav")?;
```
Remarquez que le résultat de cette fonction n'est rien d'autre que celui de la fonction save_wav().
Il ne s'agit que de consulter l'état de la piste ; choisissez la forme du paramètre self en conséquence.