Skip to content

v0.1.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 08 Nov 19:35
· 8 commits to main since this release
v0.1.0
4f69001
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

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.

Assets 6
Loading