Repository navigation
Releases
RegionBool 0.1.1
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.appif 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
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.appif 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.jsonchanging while it's open, so reopen your project after agit 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.