将场地图像加入到路径编织器。

此处是对如何将您个人的场地图像加入路径编织器的指示,此处将使用2019年的比赛作为示例。

比赛内容是从Linux和macOS上的``~/PathWeaver/Games``或Windows上的``%USERPROFILE%/PathWeaver/Games``目录中加载的。这些文件可以位于关于比赛的特定的子目录中,也可以位于Games目录中的zip文件中。 ZIP文件必须遵循与比赛内容目录相同的布局; JSON文件必须位于ZIP文件的根目录中 (不能位于子目录中)。

在此处<files/DeepSpace.zip>`下载* FIRST * Destination Deep Space 的示例。其他场地定义可在`PathWeaver GitHub存储库<https://github.com/wpilibsuite/PathWeaver/tree/master/src/main/resources/edu/wpi/first/pathweaver>`__中获得。

文件格式

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

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"
}

场地图像的路径是相对于JSON文件的。为简单起见,图像文件应与JSON文件位于同一目录中。

场角是 X 坐标与 Y 坐标在场地左上角与右下角的交点,用于定义场地图像中可操作的矩形区域。非矩形的操作区域将不被支持。

场地的尺寸是可操作区域的长和宽,场地的尺寸将以既定的单位给出。

场地单位不区分大小写,可以以米,厘米,毫米,英寸,英尺,码或英里为单位。支持单数,复数和缩写 (例如,“meter”,“meters”和“ m”对于指定米均有效)。

注解

When making a new field image, a border (minimum of 20 pixels is recommended) should be left around the outside so that waypoints on the field edge are accessible.