Fixed typos

This commit is contained in:
2023-06-05 16:41:17 +02:00
parent 90c8963369
commit a1406091e8

View File

@@ -2,7 +2,7 @@
## Installation
Pour Installer le projet, il faut aller sur le [repo](https://gitea.parano.ch/Maxluli/TrackTrends) qui contient le projet et suivre les étapes indiquées dans le ReadMe. Les étapes ne sont pas répètées ici pour éviter de la redondance et pour éviter de devoir changer cette documentation si les versions ou les dépendances à installer changent.
Pour Installer le projet, il faut aller sur le [repo](https://gitea.parano.ch/Maxluli/TrackTrends) qui contient le projet et suivre les étapes indiquées dans le ReadMe. Les étapes ne sont pas répétées ici pour éviter de la redondance et pour éviter de devoir changer cette documentation si les versions ou les dépendances à installer changent.
## A quoi sert l'app ?
@@ -10,9 +10,9 @@ Track Trends est une application Windows qui sert d'outil pour des abonnés de l
L'application est faite pour un seul cas d'utilisation :
Récupèrer les infos d'un Grand Prix en cour ou d'une rediffusion et les afficher de manière plus intéressante (en mettant en valeur des infos, en construisant un historique et en en interpêtant d'autres).
Récupérer les infos d'un Grand Prix en cours ou d'une rediffusion et les afficher de manière plus intéressante (en mettant en valeur des infos, en construisant un historique et en en interptant d'autres).
L'application est faite pour que l'utilisateur aie le moins de choses à faire pour que tout fonctionne. Cela ne veut pas dire que l'utilisateur n'a rien à faire et le but de ce document est d'expliquer les différentes étapes nescessaires à l'utilisation de l'application
L'application est faite pour que l'utilisateur ait le moins de choses à faire pour que tout fonctionne. Cela ne veut pas dire que l'utilisateur n'a rien à faire et le but de ce document est d'expliquer les différentes étapes nécessaires à l'utilisation de l'application.
## Utilisation "Simple"
@@ -22,134 +22,134 @@ Vous devez commencer par lancer le programme.
!["Page de lancement"](./Images/Manual/StartPage.png)
Au lancement de l'app, vous devriez avoir une page comme ci dessus. Il y a beaucoup d'infos mais pour le moment ce qui nous intéresse c'est le menu en haut à gauche.
Au lancement de l'app, vous devriez avoir une page comme ci-dessus. Il y a beaucoup d'infos, mais pour le moment ce qui nous intéresse, c'est le menu en haut à gauche.
!["Contrôles"](./Images/Manual/Controls.png)
Si c'est la première fois que vous utilisez l'application il est possible qu'il n'y aie qu'un seul preset au lieu des quatres ci dessous voire même 0 si vous n'avez pas mis le preset inclus dans l'installation. Si vous n'avez aucun preset, passez directement à l'étape calibration avant de revenir ici.
Si c'est la première fois que vous utilisez l'application, il est possible qu'il n'y ait qu'un seul preset au lieu des quatre ci-dessous voire 0 si vous n'avez pas mis le preset inclus dans l'installation. Si vous n'avez aucun preset, passez directement à l'étape calibration avant de revenir ici.
Comme vous pouvez le voir, en plus des presets slectionnables, il y a quatre boutons (dont deux grisés) et une boite de texte avec un lien.
Comme vous pouvez le voir, en plus des presets sélectionnables, il y a quatre boutons (dont deux grisés) et une boite de texte avec un lien.
Le lien est la chose la plus simple. C'est le lien du Grand Prix que vous voulez analyser.
### Récupèrer le lien vers le flux
### Récupérer le lien vers le flux
Pour remplir la boite de texte précitée il nous faut un lien et ce lien on le trouve sur la [F1TV](https://f1tv.formula1.com/).
Pour remplir la boite de texte précitée, il nous faut un lien et ce lien, on le trouve sur la [F1TV](https://f1tv.formula1.com/).
Quand vous vous rendez sur la F1TV la page principale devrait ressembler à quelque chose comme ca (évidemment le contenu ne sera pas le même):
Quand vous vous rendez sur la F1TV la page principale devrait ressembler à quelque chose comme ça (évidemment le contenu ne sera pas le même) :
!["Page principale de la F1TV"](./Images/Manual/F1TvMainPage.png)
Si vous ne vous êtes pas déja connecté, connectez vous et ensuite allez sur la page du Grand Prix qui vous intéresse.
Si vous ne vous êtes pas déjà connecté, connectez-vous et ensuite, allez sur la page du Grand Prix qui vous intéresse.
Pour un Grand Prix en direct, normalement, il y a un endroit ou vous pouvez cliquer pour accèder au flux directement, et si vous voulez utiliser un Grand Prix en différé vous pouvez aller dans "202x Season" ou x est l'année en cour, en l'occurence 2023. Et la vous pourrez selectionner un Grand Prix.
Pour un Grand Prix en direct, normalement, il y a un endroit où vous pouvez cliquer pour accéder au flux directement, et si vous voulez utiliser un Grand Prix en différé, vous pouvez aller dans "202x Season" ou x est l'année en cours, en l'occurrence 2023. Et là, vous pourrez sélectionner un Grand Prix.
Dans tous les cas, quand vous avez selectionné votre Grand Prix vous devriez vous retrouver sur une page de ce style :
Dans tous les cas, quand vous avez sélectionné votre Grand Prix, vous devriez vous retrouver sur une page de ce style :
!["Page d'un Grand Prix sur la F1TV"](./Images/Manual/F1TvGpPage.png)
Et ici si vous êtes sur un Grand Prix en direct, vous pouvez directement copier l'URL de la page et si c'est un Grand Prix en diffèré, vous pouvez directement naviguer avec la barre de progression vidéo du lecteur de la F1TV, Je conseille de la placer juste après le départ. Vous pouvez prendre le lien avant ou après avoir changé le timecode de la vidéo cela ne change rien, le lien ne contient pas votre progression dans la vidéo.
Et ici si vous êtes sur un Grand Prix en direct, vous pouvez directement copier l'URL de la page et si c'est un Grand Prix en différé, vous pouvez directement naviguer avec la barre de progression vidéo du lecteur de la F1TV, Je conseille de la placer juste après le départ. Vous pouvez prendre le lien avant ou après avoir changé le timecode de la vidéo, cela ne change rien, le lien ne contient pas votre progression dans la vidéo.
Ensuite vous pourrez juste mettre le lien que vous avez récupéré dans la boite de texte que l'on a vu précédemment. Il faut simplement s'assurer que le lien contient bien le terme `?action=play` à la fin.
Ensuite, vous pourrez juste mettre le lien que vous avez récupéré dans la boite de texte que l'on a vu précédemment. Il faut simplement s'assurer que le lien contient bien le terme `?action=play` à la fin.
### Boutons
Vous n'avez accès qu'à deux boutons au lancement de l'application. Le premier nommé 'Config' et le second 'Launch'
Le bouton 'Config' permet d'ouvrir la page de calibration (voir section Calibration)
Le bouton 'Config' permet d'ouvrir la page de calibration (voir section Calibration).
Le bouton Launch permet de lancer le programme. Le texte peut changer (Par exemple en 'Retry' si le lancement a raté) mais son utilité reste la même : Lancer le navigateur virtuel qui sera requis pour trater les données.
Le bouton Launch permet de lancer le programme. Le texte peut changer (Par exemple en 'Retry' si le lancement a raté) mais son utilité reste la même : Lancer le navigateur virtuel qui sera requis pour traiter les données.
Si vous cliquez sur Launch tous les boutons devraient être grisés, c'est normal. Pendant le lancement du navigateur l'application ne peut pas être utilisée pour éviter des conflits. Il faut simplement attendre. Vous aurez également des fenêtres d'invite de commande qui vont s'ouvrir et se fermer c'est tout à fait normal et il ne faut pas interragir avec tant que tout ne s'est pas stabilisé.
Si vous cliquez sur Launch tous les boutons devraient être grisés, c'est normal. Pendant le lancement du navigateur, l'application ne peut pas être utilisée pour éviter des conflits. Il faut juste attendre. Vous aurez également des fenêtres d'invite de commande qui vont s'ouvrir et se fermer, c'est tout à fait normal et il ne faut pas interagir avec tant que tout ne s'est pas stabilisé.
Vous devriez voir enfin une fenêtre comme celle ci :
!["Page suspecte (Pas de panique elle ne l'est pas)"](./Images/Manual/SuspectCmd.png)
!["Page suspecte (Pas de panique, elle ne l'est pas)"](./Images/Manual/SuspectCmd.png)
Il ne faut pas fermer cette fenêtre. C'est la seule chose qui nous relie au navigateur virtuel qu'utilise l'application. Il ne faut pas la fermer par contre vous pouvez la réduire et la laisser en background c'est d'ailleur ce que je vous recommande de faire.
Il ne faut pas fermer cette fenêtre. C'est la seule chose qui nous relie au navigateur virtuel qu'utilise l'application. Il ne faut pas la fermer, par contre, vous pouvez la réduire et la laisser en background, c'est d'ailleurs ce que je vous recommande de faire.
Peu après l'ouverture de cette fenêtre vous devriez avoir accès à trois boutons.
Peu après l'ouverture de cette fenêtre, vous devriez avoir accès à trois boutons.
- Bouton 'Config' qui fait la même chose qu'avant
- Bouton 'Re Launch' qui remplace le bouton 'Launch' qui permet de relancer le processus dans le cas ou vous auriez envie de changer de lien ou de preset.
- Bouton 'Start' démarre le processus de récupèration de données.
- Bouton 'Start' lance le processus de récupération de données.
Si vous cliquez sur ce dernier, vous lancerez le programme. Cela peut prendre quelque secondes à s'actualiser mais très vite vous devriez vous trouver devant une page comme celle ci :
Si vous cliquez sur ce dernier, vous lancerez le programme. Cela peut prendre quelque secondes à s'actualiser, mais très vite vous devriez vous trouver devant une page comme celle-ci :
!["Début du programme"](./Images/Manual/StartOfSimulation.png)
Vous n'aurez alors qu'un seul bouton disponible : le bouton 'Stop'.
Vous pouvez arrêter le programme quand vous le voulez. ATTENTION : Avant de fermer le programme, merci de stopper dabord le processus.
Vous pouvez arrêter le programme quand vous le voulez. ATTENTION : Avant de fermer le programme, merci de stopper d'abord le processus.
Si vous stoppez le processus vous devriez vous retrouver dans la même situation que juste après avoir lancé le navigateur virtuel :
Si vous stoppez le processus, vous devriez vous retrouver dans la même situation que juste après avoir lancé le navigateur virtuel :
!["Arrêt du programme"](./Images/Manual/Stopeed.png)
Vous pouvez voir en dessous la dernière image que le programme a décodé et vous avez de nouveau accès aux trois boutons expliqués précédemment.
Vous pouvez voir en dessous la dernière image que le programme a décodée et vous avez de nouveau accès aux trois boutons expliqués précédemment.
Quand l'application a été lancée vous pouvez aussi cliquer sur les données affichées mais ces comportements sont expliqués dans la section "Comprendre les données"
Quand l'application a été lancée, vous pouvez aussi cliquer sur les données affichées, mais ces comportements sont expliqués dans la section "Comprendre les données"
Voila ! Vous savez comment lancer, stopper et modifier les variables de fonctionnement de l'application. Maintenant vous pouvez passer directement à la section "Comprendre les données" si vous voulez apprendre comment utiliser ce que propose le programme ou passer à la section "Calibration" si vous voulez apprendre à configuer l'application et créer des Presets.
Voilà ! Vous savez comment lancer, stopper et modifier les variables de fonctionnement de l'application. Maintenant, vous pouvez passer directement à la section "Comprendre les données" si vous voulez apprendre comment utiliser ce que propose le programme ou passer à la section "Calibration" si vous voulez apprendre à configurer l'application et créer des Presets.
## Calibration
Ici vous apprendrez à configurer l'application pour créer vos propres presets et surtout pourquoi vous auriez besoin de le faire et à quoi servent ces fameux "Preset". Vous serez en mesure d'adapter le fonctionnement de l'application qu'elle soit conforme aux différents changements d'interface et de pilotes présents.
Ici, vous apprendrez à configurer l'application pour créer vos propres presets et surtout pourquoi vous auriez besoin de le faire et à quoi servent ces fameux "Preset". Vous serez en mesure d'adapter le fonctionnement de l'application, qu'elle soit conforme aux différents changements d'interface et de pilotes présents.
### Pourquoi calibrer l'application et créer un Preset ?
Le programme que vous allez utiliser utilise de l'OCR (Optical Character Recognition). Cela veut dire que le programme va aller regarder chaque image de la F1TV et convertir ce qu'il y a marqué dessus en données que l'on peut récupèrer automatiquement.
Le programme que vous allez utiliser utilise de l'OCR (Optical Character Recognition). Cela veut dire que le programme va aller regarder chaque image de la F1TV et convertir ce qu'il y a marqué dessus en données que l'on peut récupérer automatiquement.
Sauf que pour y arriver, le programme a besoin de savoir ou se trouve le texte important et surtout quel type de donnée il est scensé trouver à tel ou tel endroit.
Sauf que pour y arriver, le programme a besoin de savoir où se trouve le texte important et surtout quel type de donnée, il est censé trouver à tel ou tel endroit.
Pour être plus précis il a également besoin de savoir quels pilotes peuvent se trouver dans la course actuelle.
Pour être plus précis, il a également besoin de savoir quels pilotes peuvent se trouver dans la course actuelle.
Et pour qu'il sache tout cela, il y a des fichiers de configuration nommés "Presets" qui doivent contenir toutes ces informations. Et pour les créer, il existe la page de calibration qui va demander à un humain de lui fournir les infos qu'il ne peut pas trouver par lui même.
Et pour qu'il sache tout cela, il y a des fichiers de configuration nommés "Presets" qui doivent contenir toutes ces informations. Et pour les créer, il existe la page de calibration qui va demander à un humain de lui fournir les infos qu'il ne peut pas trouver par lui-même.
Normalement il devrait y avoir un Preset fournis par l'application quand vous la téléchargez depuis le [repo](https://gitea.parano.ch/Maxluli/TrackTrends) mais vous pouvez avoir besoin de faire votre propre "Preset" dans deux cas :
Normalement, il devrait y avoir un Preset fournis par l'application quand vous la téléchargez depuis le [repo](https://gitea.parano.ch/Maxluli/TrackTrends) mais vous pouvez avoir besoin de faire votre propre "Preset" dans deux cas :
- Quand les pilotes présents ne sont pas les mêmes (Ex: Si un pilote doit être remplacé ou si de nouveaux pilotes sont arrivés ou bien que d'autres aient pris leur retraite)
- Quand vous voulez utiliser des Grand Prix faits d'une autre année que celle pour laquelle le "Preset" original a été prévu. (L'année devrait être mentionnée dans le nom du preset)
- Quand les pilotes présents ne sont pas les mêmes (Ex : Si un pilote doit être remplacé ou si de nouveaux pilotes sont arrivés ou bien que d'autres aient pris leur retraite)
- Quand vous voulez utiliser des Grand Prix fait d'une autre année que celle pour laquelle le "Preset" original a été prévu. (L'année devrait être mentionnée dans le nom du preset)
Il est déconseillé d'utiliser ce projet pour des Grand Prix courus avant 2022 car l'interface de la page Data de la F1TV peut avoir trop changé mais vous pouvez toujours essayer pour voir en faisant votre propre Preset pour des années comme 2021 ou 2020.
Il est déconseillé d'utiliser ce projet pour des Grand Prix couru avant 2022, car l'interface de la page Data de la F1TV peut avoir trop changé, mais vous pouvez toujours essayer pour voir en faisant votre propre Preset pour des années comme 2021 ou 2020.
### Comment créer son Preset
Pour créer son Preset, il faut utiliser la page Settings ou Config de l'application.
Pour y accèder il faut simplement cliquer sur le bouton "Config" de la page principale et vous serez acceuilli par une page qui devrait ressembler à celle ci dessous:
Pour y accéder, il faut simplement cliquer sur le bouton "Config" de la page principale et vous serez accueilli par une page qui devrait ressembler à celle ci dessous :
!["Page de config vide"](./Images/Manual/EmptySettingsPage.png)
La seule différence est que vous aurez sûrement moins de Presets dans la liste des Presets voir vous pouvez n'en avoir aucuns.
La seule différence est que vous aurez sûrement moins de Presets dans la liste des Presets voir, vous pouvez n'en avoir aucuns.
Comme vous pouvez le voir, vous n'avez pas énormément d'options disponibles quand vous lancez simplement l'application.
Vous n'avez accès qu'aux boutons "Start the browser" et "Add","Remove".
On verra à quoi servenet ces deux derniere plus tards mais dans un premier temps on va se pencher sur le bouton Start.
On verra à quoi servent ces deux dernières plus tard, mais dans un premier temps, on va se pencher sur le bouton Start.
Vous pouvez voir que en plus de ce bouton vous pouvez aussi rentrer du texte dans la boite de texte "Grand Prix URL" ce qui n'est pas un hasard.
Vous pouvez voir qu'en plus de ce bouton, vous pouvez aussi rentrer du texte dans la boite de texte "Grand Prix URL" ce qui n'est pas un hasard.
Le but c'est de mettre le lien vers un Grand Prix pour pouvoir avoir une image de test. Pour voir comment récupèrer cet URL voir la section (Utilisation "simple" => "Récupèrer le lien vers le flux")
Le but, c'est de mettre le lien vers un Grand Prix pour pouvoir avoir une image de test. Pour voir comment récupérer cet URL, voir la section (Utilisation "simple" "Récupérer le lien vers le flux")
Quand l'URL a été placée au bon endroit, on peut cliquer sur le bouton "Start" et attendre. Si vous n'avez pas encore lu la partie "Utilisation "simple"", vous allez voir des invite de commandes s'ouvrir et se fermer et c'est tout à fait normal.
Quand l'URL a été placée au bon endroit, on peut cliquer sur le bouton "Start" et attendre. Si vous n'avez pas encore lu la partie "Utilisation "simple"", vous allez voir des invites de commandes s'ouvrir et se fermer et c'est tout à fait normal.
Il faut attendre d'avoir une invite de commande qui reste ouvert et qui ressemble à celle ci dessous avant de faire quoi que ce soit. Ensuite vous pourrez simplement réduire cette fenêtre et retourner sur la page de configuration.
Il faut attendre d'avoir une invite de commande qui reste ouverte et qui ressemble à celle ci dessous avant de faire quoi que ce soit. Ensuite, vous pourrez simplement réduire cette fenêtre et retourner sur la page de configuration.
!["Invite de commande suspecte mais normale"](./Images/Manual/SettingsPageWithCmdOpen.png)
!["Invite de commande suspecte, mais normale"](./Images/Manual/SettingsPageWithCmdOpen.png)
Ensuite si vous attendez un peu (le processus peut prendre jusqu'à plusieurs dixaines de secondes), vous aurez soit une erreur, soit vous vous retrouverez avec une page qui ressemble à ca :
Ensuite, si vous attendez un peu (le processus peut prendre jusqu'à plusieurs dizaines de secondes), vous aurez soit une erreur, soit vous vous retrouverez avec une page qui ressemble à ça :
!["Page de config amorcée"](./Images/Manual/SettingsPageWithStartedF1TV.png)
Et la on voit que toutes les options ont été débloquées.
Et là on voit que toutes les options ont été débloquées.
Avant de se pencher sur les nouvelles options on va rester sur le fonctionnement général. Le bouton "Get a newer image" permet d'avoir une image plus récente de la F1TV. C'est utile par exemple car comme on le voit sur l'exemple, l'interface de la F1TV n'a pas encore eu le temps de disparaitre. Mais cela peut aussi être utile plus tard dans le cas ou vous voudriez que certaines infos s'affichent.
Avant de se pencher sur les nouvelles options, on va rester sur le fonctionnement général. Le bouton "Get a newer image" permet d'avoir une image plus récente de la F1TV. C'est utile par exemple, car comme on le voit sur l'exemple, l'interface de la F1TV n'a pas encore eu le temps de disparaitre. Mais cela peut aussi être utile plus tard dans le cas où vous voudriez que certaines infos s'affichent.
Le bouton "Reset Emulator", lui, permet comme son nom l'indique, de relancer le navigateur virtual que l'on a lancé avec le bouton "Start the browser". Cela peut-être utile dans le cas ou l'image ne soit pas l'image que l'on attendait ou si on veut tenter le coup avec un autre URL.
Le bouton "Reset Emulator", lui, permet, comme son nom l'indique, de relancer le navigateur virtuel que l'on a lancé avec le bouton "Start the browser". Cela peut être utile dans le cas ou l'image ne soit pas l'image que l'on attendait ou si on veut tenter le coup avec un autre URL.
Maintenant on peut passer à la création des zones et des windows
Maintenant, on peut passer à la création des zones et des windows
#### Création des Zones et des Windows
@@ -157,65 +157,65 @@ Sans trop rentrer dans les détails, l'application a besoin de connaitre la loca
Elle a besoin de savoir :
- Ou se trouve la zone générale des infos pilotes
- Ou se trouve chaque pilote
- Ou se trouvent les informations pour chacuns de ces pilotes
- Où se trouve la zone générale des infos pilotes
- Où se trouve chaque pilote
- Où se trouvent les informations pour chacuns de ces pilotes
Le programme de calibration est fait pour que vous n'ayez besoin de donner que les informations qu'il ne peut pas deviner.
Il y a deux étapes :
La première étape est de donner les dimensions de la zone principale d'informations. Pour ce faire il faut dans un premier temps cliquer sur le bouton "Create the main zone" qui devrait afficher le texte suivant en dessous après avoir cliqué :
La première étape est de donner les dimensions de la zone principale d'informations. Pour ce faire, il faut dans un premier temps cliquer sur le bouton "Create the main zone" qui devrait afficher le texte suivant en dessous après avoir cliqué :
!["Texte indiquant le nombre de points qu'il reste à ajouter"](./Images/Manual/2PointsRemaining.png)
Ensuite il va falloir cliquer directement sur l'image pour indiquer le coin en haut à gauche et le point en bas à droite de la zone rectangulaire qui contient les informations.
Ensuite, il va falloir cliquer directement sur l'image pour indiquer le coin en haut à gauche et le point en bas à droite de la zone rectangulaire qui contient les informations.
Vous pouvez voir en bleu ci dessous les coins du rectangle et en rouge l'endroit où il faut cliquer.
Vous pouvez voir en bleu ci-dessous les coins du rectangle et en rouge l'endroit où il faut cliquer.
!["Infographie expliquant ou placer les points de la zone principale"](./Images/Manual/WhereToDrawMainZone.png)
!["Infographie expliquant où placer les points de la zone principale"](./Images/Manual/WhereToDrawMainZone.png)
Il faut faire attention à bien prendre tous les pilotes MAIS il faut également faire attention à ne pas prendre le texte alentours.
!["Texte qui ne doit pas être dans la zone selectionnée"](./Images/Manual/ForbiddenZone.png)
!["Texte qui ne doit pas être dans la zone sélectionnée"](./Images/Manual/ForbiddenZone.png)
Ci dessus on peut voir du texte barré en violet. Il ne faut surtout pas que la zone vienne inclure ces bouts de texte ou toute la calibration pourrait rater.
Ci dessus, on peut voir du texte barré en violet. Il ne faut surtout pas que la zone vienne inclure ces bouts de texte ou toute la calibration pourrait rater.
Ensuite si vous avez bien fait votre travail, au deuxième clic sur la page vous aurez quelques secondes de flottement et ensuite vous devriez avoir les contours que vous avez dessiné affichés en jaune avec pleins de plus petites zones à l'intérieur comme ci dessous :
Ensuite, si vous avez bien fait votre travail, au deuxième clic sur la page, vous aurez quelques secondes de flottement et ensuite, vous devriez avoir les contours que vous avez dessinés affichés en jaune avec pleins de plus petites zones à l'intérieur comme ci-dessous :
!["Zone principale avec les zones de pilotes automatiquement calculées"](./Images/Manual/DriverZones.png)
Le programme a non seulement pris en compte la zone mais il a aussi detecté automatiquement ou se trouvaient les zones de chaque pilote. Si vous n'avez pas un résultat comme celui la et/ou que les zones ne sont pas bien alignées avec les pilotes sur l'image je vous conseille de réessayer de créer la zone principale.
Le programme a non seulement pris en compte la zone, mais il a aussi détecté automatiquement où se trouvaient les zones de chaque pilote. Si vous n'avez pas un résultat comme celui-là et/ou que les zones ne sont pas bien alignées sur les pilotes sur l'image, je vous conseille de réessayer de créer la zone principale.
La seconde étape est de montrer ou sont les fenêtres d'infos au programme.
La seconde étape est de montrer où sont les fenêtres d'infos au programme.
Vous aurez peut-être remarqué que en dessous de l'image principale, quand l'affichage jaune a été appliqué, une image est apparue.
Vous aurez peut-être remarqué qu'en dessous de l'image principale, quand l'affichage jaune a été appliqué, une image est apparue.
Elle devrait ressembler à quelque chose dans ce style :
!["Image d'une zone de pilote"](./Images/Manual/DriverZone.png)
C'est une zone de pilote de l'image que l'on voit au dessus et c'est ici que l'on va indiquer les zones intéressantes.
C'est une zone de pilote de l'image que l'on voit au-dessus et c'est ici que l'on va indiquer les zones intéressantes.
Pour ce faire il faut cliquer sur le bouton "Create Windows" et ce message devrait s'afficher un peu en dessous :
Pour ce faire, il faut cliquer sur le bouton "Create Windows" et ce message devrait s'afficher un peu en dessous :
!["Texte indiquant le nombre de windows à ajouter"](./Images/Manual/9WindowsRemaining.png)
Cela nous indique le nombre de fenêtres qu'il nous reste à selectionner.
Cela nous indique le nombre de fenêtres qu'il nous reste à sélectionner.
La technique est la même que pour la grande zone sauf que la il faut le faire 9 fois. Et il faut absolument le faire dans l'ordre de gauche à droite.
La technique est la même que pour la grande zone sauf que là, il faut le faire neuf fois. Et il faut absolument le faire dans l'ordre de gauche à droite.
Le but est de tout selectioner et d'arriver à ce résultat :
Le but est de tout sélectionner et d'arriver à ce résultat :
!["Exemple de fenêtres découpées"](./Images/Manual/Windows.png)
Dans l'ordre, de gauche à droite on veut récupèrerer :
Dans l'ordre, de gauche à droite, on veut récupérer :
- La position du pilote
- Son écart avec le leader (en l'occurence comme c'est le leader que l'on voit on doit selectionner la fenêtre ou il est marqué "LEADER")
- Son écart avec le leader (en l'occurrence comme c'est le leader que l'on voit, on doit sélectionner la fenêtre ou il est marqué "LEADER")
- Son dernier temps au tour
- La fenêtre DRS
- L'étât de ses pneus
- L'état de ses pneus
- Son nom
- Son temps au secteur 1
- Son temps au secteur 2
@@ -225,19 +225,19 @@ Dans l'ordre, de gauche à droite on veut récupèrerer :
La dernière info qui manque à notre programme est la liste des pilotes présents.
On peut interragir avec cette liste ici :
On peut interagir avec cette liste ici :
!["Menu d'interraction avec la liste de pilotes"](./Images/Manual/DriverListControls.png)
!["Menu d'interaction avec la liste de pilotes"](./Images/Manual/DriverListControls.png)
Dans la boite de texte on peut écrire le nom d'un pilote qui peut être trouvé sur l'image, on peut l'ajouter à la liste et si on a fait une erreur on peut le retirer.
Dans la boite de texte, on peut écrire le nom d'un pilote qui peut être trouvé sur l'image, on peut l'ajouter à la liste et si on a fait une erreur, on peut le retirer.
Et c'est à peu près tout. il ne reste maintenant plus qu'à mettre tous les noms.
Et c'est à peu près tout. Il ne reste maintenant plus qu'à mettre tous les noms.
TIP : Il peut être intéressant d'ajouter le nom des pilotes de reserve pour éviter de venir changer son preset si un pilote n'est pas présent pour cause de maladie ou de blessure. Il faut simplement faire attention de ne pas non plus mettre trop de noms pour éviter que le programme puisse confondre.
TIP : Il peut être intéressant d'ajouter le nom des pilotes de réserve pour éviter de venir changer son preset si un pilote n'est pas présent pour cause de maladie ou de blessure. Il faut simplement faire attention de ne pas non plus mettre trop de noms pour éviter que le programme puisse confondre.
Et voila ! On a toutes les infos nescessaires.
Et voilà ! On a toutes les infos nécessaires.
La page de configuration devrait ressembler à ca :
La page de configuration devrait ressembler à ça :
!["Image de la page de config après avoir ajouté toutes les infos"](./Images/Manual/SettingsReady.png)
@@ -245,23 +245,23 @@ Il ne reste plus qu'à le sauvegarder.
#### Sauvegarder le nouveau Preset
Pour sauvegarder le preset, on peut simplement lui donner un nom dans la zone de texte sous les trois boutons de contrôle des Presets et cliquer sur Save current Preset.
Pour sauvegarder le preset, on peut facilement lui donner un nom dans la zone de texte sous les trois boutons de contrôle des Presets et cliquer sur Save current Preset.
Et voila, vous savez maintenant comment créer vos propres presets et à quoi ils servent. Vous pouvez donc adapter le fonctionnement du projet pour qu'il soit conforme aux changements de pilotes et d'interface avec les années.
Et voilà, vous savez désormais comment créer vos propres presets et à quoi ils servent. Vous pouvez donc adapter le fonctionnement du projet pour qu'il soit conforme aux changements de pilotes et d'interface avec les années.
Vous pouvez donc utiliser l'application normalement en selectionnant votre nouveau preset à chaques fois.
Vous pouvez ainsi utiliser l'application normalement en sélectionnant votre nouveau preset à chaque fois.
### Load un Preset existant
Le loading est un peu spécial. Il faut déja avoir lancé le navigateur virtuel pour activer les boutons. Ensuite il suffit de selectionner un preset et de cliquer sur "Load the Preset" et attendre un petit peu. L'affichage sera un peu bizarre mais c'est normal il ne faut pas s'inquièter si la zone de pilote affichée en dessous est correcte.
Le loading est un peu spécial. Il faut déjà avoir lancé le navigateur virtuel pour activer les boutons. Ensuite, il suffit de sélectionner un preset et de cliquer sur "Load the Preset" et attendre un petit peu. L'affichage sera un peu bizarre, mais c'est normal, il ne faut pas s'inquiéter si la zone de pilote affichée en dessous est correcte.
!["Exemple de ce à quoi peut ressembler un loading et l'affichage bizarre que ca implique"](./Images/Manual/LoadedPreset.png)
!["Exemple de ce à quoi peut ressembler un loading et l'affichage bizarre que ça implique"](./Images/Manual/LoadedPreset.png)
A partir de la il est facile de faire son propre preset en changeant juste les noms des pilotes par exemple.
À partir de là, il est facile de faire son propre preset en changeant juste les noms des pilotes par exemple.
## Comprendre les données
Ici vous allez apprendre a utiliser l'application et ses données en comprenant à quoi elles servent et comment elles sont affichées.
Ici, vous allez apprendre à utiliser l'application et ses données en comprenant à quoi elles servent et comment elles sont affichées.
!["Image de l'application en cours de fonctionnement depuis quelques minutes"](./Images/Manual/Simulation.png)
@@ -269,55 +269,55 @@ Il y a 5 types de données :
### Overtakes
Cette fenêtre est loin d'être complêtement opérationnelle mais elle permet de voir l'historique des dépassements et changements de position. Il faut scroller pour voir les plus récents.
Cette fenêtre est loin d'être complètement opérationnelle, mais elle permet de voir l'historique des dépassements et des changements de position. Il faut scroller pour voir les plus récents.
Je dirais que pour le moment c'est la moins intéressante et elle ne fonctionne pas toujours super.
Je dirais que pour le moment, c'est la moins intéressante et elle ne fonctionne pas toujours super.
### Last Five Laps
!["Image de la fenêtre des cinqs derniers tours"](./Images/Manual/LastFiveLAps.png)
!["Image de la fenêtre des cinq derniers tours"](./Images/Manual/LastFiveLAps.png)
En total constraste avec la fenêtre Overtakes, ici on a peut-être la fenêtre la plus intéressante de toutes.
En total contraste avec la fenêtre Overtakes, ici, on a peut-être la fenêtre la plus intéressante de toutes.
On peut voir les pilotes actuellement les plus rapides et plus lents sur le circuit. Le calcul est fait sur la moyenne des cinq derniers tours de chaques pilotes. Cela permet de se faire une idée de la situation des pilotes.
On peut voir les pilotes actuellement les plus rapides et plus lents sur le circuit. Le calcul est fait sur la moyenne des cinq derniers tours de chaque pilote. Cela permet de se faire une idée de la situation des pilotes.
Cela peut servir par exemple à detecter quand un pneu est plus rapide que les autres quand on voit des pilotes dans le milieu ou bas de tableau apparaître dans les plus rapide.
Cela peut servir par exemple à détecter quand un pneu est plus rapide que les autres quand on voit des pilotes dans le milieu ou bas de tableau apparaître dans le plus rapide.
Il est par exemple intéressant de voir la différence de vitesse entre les pneus secs et pluie sur un circuit qui commence à sêcher. On peut progressivement voir les pilotes en pneus secs devenir de plus en plus rapides alors que ce sont des pilotes beaucoup moins rapide en temps normal.
Il est par exemple intéressant de voir la différence de vitesse entre les pneus secs et pluie sur un circuit qui commence à sécher. On peut progressivement voir les pilotes en pneus secs devenir de plus en plus rapides alors que ce sont des pilotes beaucoup moins rapide en temps normal.
On peut cliquer sur nimporte lequel de ces pilotes pour voir ses infos apparaître dans la fenêtre Driver Infos pour voir les cinq derniers tours par exemple ou les pneus qu'il est en train de chausser.
On peut cliquer sur n'importe lequel de ces pilotes pour voir ses infos apparaître dans la fenêtre Driver Infos pour voir les cinq derniers tours par exemple ou les pneus qu'il est en train de chausser.
### Battles
!["Fenêtre des batailles"](./Images/Manual/Battles.png)
Cette fenêtre est également assez intéressante car elle permet de voir les pilotes qui sont en train de se battre. Il est estimé qu'un pilote qui se bat est un pilote qui est à trois secondes ou moins du pilote devant lui.
Cette fenêtre est également assez intéressante, car elle permet de voir les pilotes qui sont en train de se battre. Il est estimé qu'un pilote qui se bat est un pilote qui est à trois secondes ou moins du pilote devant lui.
Ne sont affichées que les batailles de quatres pilotes maximums dans l'ordre du classement.
Ne sont affichées que les batailles de quatre pilotes maximums dans l'ordre du classement.
Si un pilote est entre 2 et 3 secondes de son adversaire, l'écart est en blanc.
Entre 1 et 2 secondes il est écrit en jaune.
Entre 1 et 2 secondes, il est écrit en jaune.
Dans la zone du DRS (Une seconde ou moins) il est écrit en vert.
On peut aussi cliquer sur le nom d'un pilote pour afficher ses infos dans la fenêtre des infos pilote.
Cette fenêtre permet de mieux comprendre qui sont les pilotes qu'il faut garder à l'oeuil à la TV ou simplement qui sont les pilotes qui sont très proches et qui pourraient se mettre la pression pour les arrêts aux stands car jamais un pilote ne reste à moins de trois secondes d'un autre si ca n'est pas pour tenter quelque chose au niveau stratégique.
Cette fenêtre permet de mieux comprendre qui sont les pilotes qu'il faut garder à l'œil à la TV ou simplement qui sont les pilotes qui sont très proches et qui pourraient se mettre la pression pour les arrêts aux stands, car jamais un pilote ne reste à moins de trois secondes d'un autre si ça n'est pas pour tenter quelque chose au niveau stratégique.
### Driver infos
!["Fenêtre des infos pilote"](./Images/Manual/DriverInfos.png)
Ici on peut voir toutes les infos live d'un pilote.
Ici, on peut voir toutes les infos lives d'un pilote.
Rien de fou à dire sur la partie de gauche, par contre la partie de droite est un peu plus intéressante car elle contient un historique de ses cinq derniers tours (dans la photo il n'y en a qu'un seul mais au fur et à mesure de la course cela se remplit).
Rien de fou à dire sur la partie de gauche, par contre la partie de droite est un peu plus intéressante, car elle contient un historique de ses cinq derniers tours (dans la photo, il n'y en a qu'un seul, mais au fur et à mesure de la course cela se remplit).
On peut non seulement voir les cinq derniers temps au tour mais on peut aussi cliquer sur chacuns d'eux pour voir les secteurs associés.
On peut non seulement voir les cinq derniers temps au tour, mais on peut aussi cliquer sur chacun d'eux pour voir les secteurs associés.
!["Exemple d'affichage des secteurs d'un temps au tour"](./Images/Manual/LapInfos.png);
### Live Ranking
!["Fenêtre du classement en live"](./Images/Manual/LiveRanking.png)
!["Fenêtre du classement en direct"](./Images/Manual/LiveRanking.png)
Ceci est la fenêtre la plus simple. C'est tout bêtement le classement actuel avec les écarts avec le leader.
@@ -325,14 +325,14 @@ Note : On peut également cliquer sur les différents pilotes pour en afficher l
## Erreurs
Il est très probable que si vous utilisiez beaucoup cette application vous rencontriez des erreurs. Ici vous pourrez apprendre ce qu'elles veulent dire et ce que vous pouvez faire pour y remedier.
Il est très probable que si vous utilisez beaucoup cette application, vous allez rencontrer des erreurs. Ici, vous pourrez apprendre ce qu'elles veulent dire et ce que vous pouvez faire pour y remédier.
Il n'existe pas un très grand nombre d'erreurs mais voici les principales
Il n'existe pas un très grand nombre d'erreurs, mais voici les principales
- Erreur 100 (Souvent au premier démarrage) Cette erreur signale un problème avec la récupèration de cookies. Cela peut être causé par une mauvaise installation de python ou si vous ne vous êtes pas connectés récemment à la F1TV depuis Chrome ou que vous n'avez tout simplement pas installé Chrome sur votre machine.
- Erreur 101 (Moins récurrent qu'à une époque) Cette erreur veut dire qu'il y a déja une instance de navigateur ouverte. Pour règler cette erreur regarder dans votre barre des tâche les invites de commande ouverts et fermez celui qui correspond à un ancien navigateur. (Si c'est déja fait alors en derniers recours vous pouvez chercher dans le gestionnaire des tâches et chercher "GeckoDriver.exe")
- Erreur 102 Cela peut être une erreur qui arrive car vous n'avez pas donné un URL valide pour la F1TV ou par ce que vous ne vous êtes pas connecté récemment à la F1TV depuis chrome (Si vous veniez de le faire alors attendez un peu et réessayez. Parfois cela peut prendre un peu de temps à s'actualiser)
- Erreur 100 (Souvent au premier démarrage) Cette erreur signale un problème avec la récupération de cookies. Cela peut être causé par une mauvaise installation de python ou si vous ne vous êtes pas connectés récemment à la F1TV depuis Chrome ou que vous n'avez tout simplement pas installé Chrome sur votre machine.
- Erreur 101 (Moins récurrent qu'à une époque) Cette erreur veut dire qu'il y a déjà une instance de navigateur ouverte. Pour régler cette erreur, regarder dans votre barre des tâches les invites de commande ouvertes et fermez celui qui correspond à un ancien navigateur. (Si c'est déjà fait alors en derniers recours, vous pouvez chercher dans le gestionnaire des tâches et chercher "GeckoDriver.exe")
- Erreur 102 Cela peut être une erreur qui arrive, car vous n'avez pas donné un URL valide pour la F1TV ou par ce que vous ne vous êtes pas connecté récemment à la F1TV depuis chrome (Si vous veniez de le faire alors, attendez un peu et réessayez). Parfois cela peut prendre un peu de temps à s'actualiser).
- Erreur 103 L'URL est invalide
- Erreur 104 L'URL est invalide
- Erreur 105 Cette erreur indique que soit vous avez donné un URL qui ne correspond à aucun Grand Prix, soit que la vidéo a mis trop de temps à charger. Vous pouvez essayer de vous brancher en ethernet ou simplement réessayer si vous êtes sur de votre URL.
- Pareil que l'erreur 105
- Erreur 105 Cette erreur indique que soit vous avez donné un URL qui ne correspond à aucun Grand Prix, soit que la vidéo a mis trop de temps à charger. Vous pouvez essayer de vous brancher en Ethernet ou simplement réessayer si vous êtes sûr de votre URL.
- Erreur 106 Même chose que pour la 105