64 lines
2.8 KiB
Markdown
64 lines
2.8 KiB
Markdown
# GPX - Compteur de vitesse
|
||
|
||
Script Python qui transforme une trace GPX en vidéo MP4 carrée 1024×1024, prête à être incrustée dans un autre montage : trace blanche sur fond noir, cercle blanc qui suit le trajet, compteur de vitesse à aiguille et noms des villes traversées.
|
||
|
||
## Table des matières
|
||
|
||
- [Fonctionnalités](#fonctionnalités)
|
||
- [Installation](#installation)
|
||
- [Utilisation](#utilisation)
|
||
- [Structure du projet](#structure-du-projet)
|
||
- [Développement](#développement)
|
||
|
||
## Fonctionnalités
|
||
|
||
- Lecture GPX 1.0 / 1.1 (points `trkpt` horodatés).
|
||
- Vitesse issue de l'extension `gpxtpx:speed` (m/s, ex. GeoRide) si présente, sinon calculée à partir des distances et des temps ; lissage léger.
|
||
- Vidéo accélérée à durée fixe (60 s par défaut) : le trajet complet est parcouru du début à la fin.
|
||
- Compteur analogique 0-200 km/h (paramétrable), aiguille et vitesse numérique, placé automatiquement dans le coin le moins encombré par la trace.
|
||
- Villes traversées obtenues par géocodage inverse [Nominatim](https://nominatim.org/) (OpenStreetMap), affichées sur la carte dès le début, avec placement des étiquettes qui évite chevauchements et trace.
|
||
- Cache des villes dans `<trace>.villes.json` : les exécutions suivantes n'accèdent plus au réseau.
|
||
- Rendu anticrénelé (suréchantillonnage ×2), encodage H.264 `yuv420p` via ffmpeg, sans fichiers intermédiaires.
|
||
|
||
## Installation
|
||
|
||
Prérequis : Python 3.10+ et [ffmpeg](https://ffmpeg.org/) accessible dans le `PATH`.
|
||
|
||
```powershell
|
||
python -m venv .venv
|
||
.venv\Scripts\Activate.ps1
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
## Utilisation
|
||
|
||
```powershell
|
||
python gpx_video.py Trajet_16-09-2026_15h38.gpx
|
||
```
|
||
|
||
Produit `Trajet_16-09-2026_15h38.mp4` à côté du GPX.
|
||
|
||
| Option | Défaut | Rôle |
|
||
|---|---|---|
|
||
| `-o`, `--sortie` | nom du GPX en `.mp4` | fichier de sortie |
|
||
| `--duree` | `60` | durée de la vidéo (secondes) |
|
||
| `--fps` | `30` | images par seconde |
|
||
| `--vmax` | `200` | graduation max du compteur (km/h) |
|
||
| `--sans-villes` | — | ne pas géocoder ni afficher les villes |
|
||
|
||
Exemple : `python gpx_video.py trace.gpx -o balade.mp4 --duree 90 --fps 25`
|
||
|
||
Notes :
|
||
- Le premier lancement interroge Nominatim (1 requête/s, un point par km de trajet) : compter environ 1 s par km.
|
||
- En cas d'erreurs réseau, la vidéo est générée sans villes et le cache n'est pas écrit. Supprimer `<trace>.villes.json` pour forcer un nouveau géocodage.
|
||
|
||
## Structure du projet
|
||
|
||
```
|
||
gpx_video.py script principal (lecture GPX, villes, rendu, encodage)
|
||
requirements.txt dépendances Python (numpy, Pillow)
|
||
Trajet_16-09-2026_15h38.gpx trace d'exemple (GeoRide)
|
||
Trajet_16-09-2026_15h38.villes.json cache des villes de l'exemple
|
||
Trajet_16-09-2026_15h38.mp4 vidéo générée pour l'exemple
|
||
```
|