boarddesignrulecheckdata.h

Go to the documentation of this file.

/*
 * LibrePCB - Professional EDA for everyone!
 * Copyright (C) 2013 LibrePCB Developers, see AUTHORS.md for contributors.
 * https://librepcb.org/
 *
 * 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 3 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, see <http://www.gnu.org/licenses/>.
 */
 
#ifndef LIBREPCB_CORE_BOARDDESIGNRULECHECKDATA_H
#define LIBREPCB_CORE_BOARDDESIGNRULECHECKDATA_H
 
/*******************************************************************************
 *  Includes
 ******************************************************************************/
#include "../../../geometry/padgeometry.h"
#include "../../../geometry/zone.h"
#include "../../../types/uuid.h"
#include "boarddesignrulechecksettings.h"
 
#include <QtCore>
 
/*******************************************************************************
 *  Namespace / Forward Declarations
 ******************************************************************************/
namespace librepcb {
 
class Board;
class Layer;
 
/*******************************************************************************
 *  Class BoardDesignRuleCheckData
 ******************************************************************************/
 
struct BoardDesignRuleCheckData final {
  struct NetClass {
    UnsignedLength minCopperCopperClearance;
    UnsignedLength minCopperWidth;
    UnsignedLength minViaDrillDiameter;
  };
  struct Junction {
    Uuid uuid;
    Point position;
    qsizetype traces;
  };
  struct Trace {
    Uuid uuid;
    Point p1;
    Point p2;
    PositiveLength width;
    const Layer* layer;
  };
  struct Via {
    Uuid uuid;
    Point position;
    PositiveLength drillDiameter;
    PositiveLength size;
    // Only filled with the layers of traces directly connected to the via.
    QSet<const Layer*> connectedLayers;
    const Layer* startLayer;
    const Layer* endLayer;
    std::optional<std::pair<const Layer*, const Layer*>> drillLayerSpan;
    bool isBuried;
    bool isBlind;
    std::optional<PositiveLength> stopMaskDiameterTop;
    std::optional<PositiveLength> stopMaskDiameterBot;
  };
  struct Hole {
    Uuid uuid;
    PositiveLength diameter;
    NonEmptyPath path;
    std::optional<Length> stopMaskOffset;
  };
  struct Pad {
    Uuid uuid;
    QString libPkgPadName;  // Empty if not connected to a package pad.
    Point position;  // Absolute transform.
    Angle rotation;  // Absolute transform.
    bool mirror;  // Absolute transform.
    QList<Hole> holes;
    QHash<const Layer*, QList<PadGeometry>> geometries;
    QSet<const Layer*> layersWithTraces;  // Layers where traces are connected.
    UnsignedLength copperClearance;
    std::optional<Uuid> net;
    QString netName;  // Empty if no net.
    std::optional<Uuid> netClass;
  };
  struct Segment {
    Uuid uuid;
    std::optional<Uuid> net;
    QString netName;  // Empty if no net.
    std::optional<Uuid> netClass;
    QHash<Uuid, Junction> junctions;
    QList<Trace> traces;
    QHash<Uuid, Via> vias;
    QHash<Uuid, Pad> pads;
  };
  struct AirWireAnchor {
    Point position;
    std::optional<Uuid> device;  // If it's a footprint pad.
    std::optional<Uuid> pad;  // If it's a pad.
    std::optional<Uuid> segment;  // If it's a junction or via or board pad.
    std::optional<Uuid> junction;  // If it's a junction.
    std::optional<Uuid> via;  // If it's a via.
  };
  struct AirWire {
    AirWireAnchor p1;
    AirWireAnchor p2;
    QString netName;  // Always valid.
  };
  struct Plane {
    Uuid uuid;
    std::optional<Uuid> net;
    QString netName;  // Empty if no net.
    std::optional<Uuid> netClass;
    const Layer* layer;
    UnsignedLength minWidth;
    PositiveLength thermalSpokeWidth;
    Path outline;
    QVector<Path> fragments;
  };
  struct Polygon {
    Uuid uuid;
    const Layer* layer;
    UnsignedLength lineWidth;
    bool filled;
    Path path;
  };
  struct Circle {
    Uuid uuid;
    Point center;
    PositiveLength diameter;
    const Layer* layer;
    UnsignedLength lineWidth;
    bool filled;
  };
  struct StrokeText {
    Uuid uuid;
    Point position;
    Angle rotation;
    bool mirror;
    const Layer* layer;
    UnsignedLength strokeWidth;
    PositiveLength height;
    QVector<Path> paths;
  };
  struct Zone {
    Uuid uuid;
    QSet<const Layer*> boardLayers;  // Only set for board zones!
    librepcb::Zone::Layers footprintLayers;  // Only set for device zones!
    librepcb::Zone::Rules rules;
    Path outline;
  };
  struct ImpossibleConnection {
    Uuid signalUuid;
    QString signalName;
    QString netName;
  };
  struct Device {
    Uuid uuid;
    QString cmpInstanceName;
    Point position;
    Angle rotation;
    bool mirror;
    QHash<Uuid, Pad> pads;  // With absolute transform.
    QList<Polygon> polygons;  // From library footprint.
    QList<Circle> circles;  // From library footprint.
    QList<StrokeText> strokeTexts;  // With absolute transform.
    QList<Hole> holes;  // From library footprint.
    QList<Zone> zones;  // From library footprint.
    QList<ImpossibleConnection> impossibleSignalConnections;
  };
 
  // NOTE: We create a `const` copy of this structure for each thread to
  // ensure thread-safety. For the implicitly shared Qt containers this is
  // a lightweight operation.
  BoardDesignRuleCheckSettings settings;
  bool quick = false;
  QSet<const Layer*> copperLayers;  // All board copper layers.
  QVector<const Layer*> silkscreenLayersTop;
  QVector<const Layer*> silkscreenLayersBot;
  QHash<Uuid, NetClass> netClasses;
  QHash<Uuid, Segment> segments;
  QList<Plane> planes;
  QList<Polygon> polygons;
  QList<StrokeText> strokeTexts;
  QList<Hole> holes;
  QList<Zone> zones;
  QHash<Uuid, Device> devices;
  QList<AirWire> airWires;
  QMap<Uuid, QString> unplacedComponents;  // UUID and name.
 
  // Constructors / Destructor
  BoardDesignRuleCheckData(const Board& board,
                           const BoardDesignRuleCheckSettings& drcSettings,
                           bool quickCheck) noexcept;
 
  // Helper Methods
  UnsignedLength getMinCopperCopperClearance(
      const std::optional<Uuid> netClass) const noexcept {
    if (netClass) {
      auto it = netClasses.find(*netClass);
      if (it != netClasses.end()) {
        return std::max(settings.getMinCopperCopperClearance(),
                        it->minCopperCopperClearance);
      }
    }
    return settings.getMinCopperCopperClearance();
  }
  UnsignedLength getMinCopperWidth(
      const std::optional<Uuid> netClass) const noexcept {
    if (netClass) {
      auto it = netClasses.find(*netClass);
      if (it != netClasses.end()) {
        return std::max(settings.getMinCopperWidth(), it->minCopperWidth);
      }
    }
    return settings.getMinCopperWidth();
  }
  UnsignedLength getMinViaDrillDiameter(
      const std::optional<Uuid> netClass) const noexcept {
    if (netClass) {
      auto it = netClasses.find(*netClass);
      if (it != netClasses.end()) {
        return std::max(settings.getMinPthDrillDiameter(),
                        it->minViaDrillDiameter);
      }
    }
    return settings.getMinPthDrillDiameter();
  }
};
 
/*******************************************************************************
 *  End of File
 ******************************************************************************/
 
}  // namespace librepcb
 
#endif