7
mirror of https://gitlab.com/kicad/code/kicad.git synced 2024-11-28 00:31:20 +00:00
kicad/libs/kimath/include/geometry/roundrect.h
John Beard 8fdb6d6e88 Feature: Exact item offset tool
This is a little bit like the bounding hull tool, but the
output is "exact" and it only supports the most common
source items.

By 'exact', this means that rounded corners are real arc
segments rather than polygonal approximations. Obviously,
this is rather tricky in the general case, and especially
for any concave shape or anything with a bezier in it.

Envisioned main uses:

* Creating courtyard and silkscreen offsets in footprints
* Making slots around line or arcs.

The one thing that it does not currently do, but which it might
plausibly do without reimplementing Clipper is convex polygons,
which would bring trapezoidal pad outsets for free. But that
is a stretch goal, and bounding hull can be used.
2024-09-19 06:35:43 +01:00

85 lines
2.6 KiB
C++

/*
* This program source code file is part of KiCad, a free EDA CAD application.
*
* Copyright (C) 2024 KiCad Developers, see AUTHORS.txt for contributors.
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation; either version 2
* of the License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, you may find one here:
* http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
* or you may search the http://www.gnu.org website for the version 2 license,
* or you may write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
*/
#pragma once
#include <geometry/shape_rect.h>
/**
* A round rectangle shape, based on a rectangle and a radius.
*
* For now, not an inheritor of SHAPE as that means implementing a
* lot of Collision logic. Then again, this is a common shape, could be more efficient
* to do the collision using arcs rather than Clipper'ing pad outsets.
*/
class ROUNDRECT
{
public:
ROUNDRECT() : m_rect(), m_radius( 0 ) {}
ROUNDRECT( SHAPE_RECT aRect, int aRadius );
static ROUNDRECT OutsetFrom( const SHAPE_RECT& aRect, int aOutset );
int GetRoundRadius() const { return m_radius; }
/**
* Get the basis rectangle of the roundrect.
*
* This is the rectangle without the rounded corners.
*/
const SHAPE_RECT& GetRect() const { return m_rect; }
/**
* Shortcut for common values
*/
int GetWidth() const { return m_rect.GetWidth(); }
int GetHeight() const { return m_rect.GetHeight(); }
VECTOR2I GetPosition() const { return m_rect.GetPosition(); }
/**
* Get the bounding box of the roundrect.
*
* (This is always the same as the basis rectangle's bounding box.)
*/
BOX2I BBox() const { return m_rect.BBox(); }
/**
* Get the roundrect with the size increased by aOutset in all directions.
* (the radius increases by aOutset as well).
*/
ROUNDRECT GetInflated( int aOutset ) const;
/**
* Get the polygonal representation of the roundrect.
*/
void TransformToPolygon( SHAPE_POLY_SET& aBuffer, int aError, ERROR_LOC aErrorLoc ) const
/*override */;
private:
SHAPE_RECT m_rect;
int m_radius;
};