Ajout d’images de Terrain à PathWeaver

Vous trouverez ici des instructions pour ajouter votre propre image de terrain de compétition en utilisant celle du jeu 2019 à titre d’exemple.

Les images des jeux sont chargées à partir du répertoire ~/PathWeaver/Games sous Linux et macOS ou %USERPROFILE%/PathWeaver/Games sous Windows. Les fichiers peuvent être dans un sous-répertoire spécifique au jeu ou dans un fichier zip à l’intérieur du répertoire Games. Le fichier ZIP doit suivre la même disposition qu’un répertoire de jeux ; Le fichier JSON doit être dans la racine du fichier ZIP (ne peut pas être dans un sous-répertoire).

Vous pouvez télécharger l’exemple de définition de terrain de FIRST Destination Deep Space ici. D’autres définitions de terrain sont disponibles dans le Dépôt GitHub PathWeaver.

Format de fichier

~/PathWeaver
  /Games
   /Custom Game
      custom-game.json
      field-image.png
   OtherGame.zip

Format JSON

{
   "game": "game name",
   "field-image": "relative/path/to/img.png",
   "field-corners": {
      "top-left": [x, y],
      "bottom-right": [x, y]
   },
   "field-size": [width, length],
   "field-unit": "unit name"
}

Le chemin d’accès à l’image du terrain est relatif au fichier JSON. Pour faire simple, le fichier image doit être placé dans le même répertoire que le fichier JSON.

En exprimant les coordonnées X et Y en pixels, les coins du terrain correspondant au point situé en haut à gauche et à celui situé en bas à droite définissent les limites de l’aire rectangulaire de la zone jouable dans l’image du terrain. Les aires de jeu non rectangulaires ne sont pas prises en charge.

La taille du terrain est la largeur et la longueur de l’aire de jeu du terrain dans les unités fournies.

Les unités du terrain sont insensibles à la casse et peuvent être en mètres, cm, mm, pouces, pieds, yards, ou miles. Le singulier, le pluriel et les abréviations sont pris en charge (p. ex. « mètre », « mètres », et « m » sont toutes valables pour définir les mètres)

Note

Lors de la création d’une nouvelle image de champ, une bordure (un minimum de 20 pixels est recommandé) doit être laissée à l’extérieur afin que les points de cheminement sur le bord du champ soient accessibles.