GUIGeometry.h

Go to the documentation of this file.

/****************************************************************************/
// Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.dev/sumo
// Copyright (C) 2001-2024 German Aerospace Center (DLR) and others.
// This program and the accompanying materials are made available under the
// terms of the Eclipse Public License 2.0 which is available at
// https://www.eclipse.org/legal/epl-2.0/
// This Source Code may also be made available under the following Secondary
// Licenses when the conditions for such availability set forth in the Eclipse
// Public License 2.0 are satisfied: GNU General Public License, version 2
// or later which is available at
// https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html
// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
/****************************************************************************/
// File for geometry classes and functions
/****************************************************************************/
#pragma once
#include <config.h>
 
#include <utils/geom/PositionVector.h>
#include <utils/gui/globjects/GUIGlObject.h>
#include <utils/gui/settings/GUIVisualizationSettings.h>
 
// ===========================================================================
// class definitions
// ===========================================================================
 
class GUIGeometry {
 
public:
    GUIGeometry();
 
    GUIGeometry(const PositionVector& shape);
 
    GUIGeometry(const PositionVector& shape, const std::vector<double>& shapeRotations,
                const std::vector<double>& shapeLengths);
 
    void updateGeometry(const PositionVector& shape);
 
    void updateGeometry(const PositionVector& shape, const double posOverShape, const double lateralOffset);
 
    void updateGeometry(const PositionVector& shape, double starPosOverShape, double endPosOverShape,
                        const double lateralOffset);
 
    void updateGeometry(const PositionVector& shape, double beginTrimPosition, const Position& extraFirstPosition,
                        double endTrimPosition, const Position& extraLastPosition);
 
    void updateSinglePosGeometry(const Position& position, const double rotation);
 
    void clearGeometry();
 
    void moveGeometryToSide(const double amount);
 
    void scaleGeometry(const double scale);
 
    const PositionVector& getShape() const;
 
    const std::vector<double>& getShapeRotations() const;
 
    const std::vector<double>& getShapeLengths() const;
 
 
    static double calculateRotation(const Position& first, const Position& second);
 
    static double calculateLength(const Position& first, const Position& second);
 
    static void adjustStartPosGeometricPath(double& startPos, const PositionVector& startLaneShape, double& endPos,
                                            const PositionVector& endLaneShape);
 
 
 
    static void drawGeometry(const GUIVisualizationSettings::Detail d, const GUIGeometry& geometry,
                             const double width, double offset = 0);
 
    static void drawGeometry(const GUIVisualizationSettings::Detail d, const GUIGeometry& geometry,
                             const std::vector<RGBColor>& colors, const double width, double offset = 0);
 
    static void drawContourGeometry(const GUIGeometry& geometry, const double width, const bool drawExtremes = false);
 
    static void drawGeometryPoints(const GUIVisualizationSettings::Detail d, const PositionVector& shape,
                                   const RGBColor& color, const double radius, const double exaggeration,
                                   const bool editingElevation);
 
    static void drawParentLine(const GUIVisualizationSettings& s, const Position& parent, const Position& child,
                               const RGBColor& color, const bool drawEntire, const double lineWidth);
 
    static void drawChildLine(const GUIVisualizationSettings& s, const Position& child, const Position& parent,
                              const RGBColor& color, const bool drawEntire, const double lineWidth);
 
    static PositionVector getVertexCircleAroundPosition(const Position& pos, const double width, const int steps = 8);
 
    static void rotateOverLane(const double rot);
 
 
protected:
    void calculateShapeRotationsAndLengths();
 
    PositionVector myShape;
 
    std::vector<double> myShapeRotations;
 
    std::vector<double> myShapeLengths;
 
private:
    static PositionVector myCircleCoords;
 
    static int angleLookup(const double angleDeg);
};