Skip to content

Releases

RegionBool 0.1.1

Choose a tag to compare

@github-actions github-actions released this 08 Nov 20:54
67f94a6

New: choose your field coordinate system

Under Coordinates in the right panel, pick the system your robot code uses:

  • Origin at blue corner (the default): +x points toward the red alliance wall, as before.
  • Origin at field center: +x points toward the blue alliance wall.

With the field-center option, the generated class converts each pose before checking it, and converts outlines before publishing them to AdvantageScope, Glass or Elastic. Checks still don't allocate, so they're safe to call every loop.

The field is drawn the same either way. The numbers you see and type, the cursor position and the corner labels follow your choice. Your regions are saved the same way whichever system you pick, so switching never moves them, and projects from 0.1.0 open unchanged. If you keep the blue-corner option, re-exporting produces the same file as before.

Install

System File
Windows RegionBool-0.1.1-win-x64.exe
macOS (Apple Silicon) RegionBool-0.1.1-mac-arm64.dmg
macOS (Intel) RegionBool-0.1.1-mac-x64.dmg
Linux RegionBool-0.1.1-linux-x86_64.AppImage

Builds aren't signed yet, so your system will warn you:

  • Windows: on the SmartScreen warning, choose More info, then Run anyway.
  • macOS: after dragging the app to Applications, run xattr -cr /Applications/RegionBool.app if it refuses to open.
  • Linux: mark the AppImage as executable, then run it.

See the 0.1.0 release for everything else RegionBool does.

Found a problem? Open an issue.

v0.1.0

Choose a tag to compare

@github-actions github-actions released this 08 Nov 19:35
4f69001

The first release of RegionBool, from FRC Team 1156 UnderControl.

Draw a region on the field, and get a boolean Java method for your WPILib robot project:

if (FieldRegions.isInScoringZone(drivetrain.getPose())) {
  // The robot is in the scoring zone.
}

What it does

  • Draw regions with rectangles, circles, triangles and polygons. Combine shapes, cut holes, and rotate them, or type exact values.
  • Handle alliances by setting each region to flip on red or stay fixed. The generated code flips the right way for the field.
  • Export safely. You see a diff before anything is written, and RegionBool won't replace a file it didn't generate.
  • See your regions in a dashboard by publishing their outlines to AdvantageScope, Glass or Elastic.
  • Work as a team. Regions are saved in your project as readable JSON, so they go through git with your code.
  • Use real fields. 2022 to 2026 are included, with welded and AndyMark sizes for 2025 and 2026, or import your own image.

Install

System File
Windows RegionBool-0.1.0-win-x64.exe
macOS (Apple Silicon) RegionBool-0.1.0-mac-arm64.dmg
macOS (Intel) RegionBool-0.1.0-mac-x64.dmg
Linux RegionBool-0.1.0-linux-x86_64.AppImage

Builds aren't signed yet, so your system will warn you:

  • Windows: on the SmartScreen warning, choose More info, then Run anyway.
  • macOS: after dragging the app to Applications, run xattr -cr /Applications/RegionBool.app if it refuses to open.
  • Linux: mark the AppImage as executable, then run it.

WPILib versions

RegionBool reads your project's imports and generates code to match. Generated code has been run in tests against WPILib 2026.2.1 and 2027 alpha-8, and compiled against 2025.3.2. The 2027 API is still changing, so a later alpha may need an update.

Known limits

  • It hasn't been used on a real robot at an event yet, so check your regions before relying on them.
  • RegionBool doesn't notice regions.json changing while it's open, so reopen your project after a git pull.
  • Regions that flip are drawn on the blue side in the editor.

Field images come from WPILib and others, and aren't covered by RegionBool's MIT license. See SOURCES.md.

Found a problem? Open an issue.