Base class of all elements of the program. This class is responsible for manage graphical and his data. More...

#include <Element.h>

Inheritance diagram for Element:

[legend]

Public Member Functions
	Element ()
	Constructor.

virtual	~Element ()
	Destructor.

void	SetDragging (bool dragging=true)
	Set if the element are being dragged.

void	SetHeight (double height)
	Set element height.

void	SetPosition (const wxPoint2DDouble position)
	Set the element position and update the rectangle.

void	SetSelected (bool selected=true)
	Set element selection.

void	SetWidth (double width)
	Set element width.

void	SetAngle (double angle)
	Set element angle.

void	ShowPickbox (bool showPickbox=true)
	Set if the pickbox is shown.

void	SetBorderSize (double borderSize)
	Set the size of the border (shown in selected elements).

bool	SetOnline (bool online=true)
	Set if the element is online or offline.

virtual void	SetPointList (std::vector< wxPoint2DDouble > pointList)
	Set the list of points that connect the element to the bus.

ElementType	GetElementType ()

wxRect2DDouble	GetRect () const
	Get the element rectangle.

wxPoint2DDouble	GetPosition () const
	Get the element position.

bool	IsDragging () const
	Checks if the element is being dragged.

double	GetHeight () const
	Get the element height.

bool	IsSelected () const
	Checks if the element is selected.

double	GetWidth () const
	Get the element width.

double	GetAngle () const
	Get the element angle.

double	GetRotationAngle () const
	Get the angle of rotation.

bool	IsPickboxShown () const
	Checks if the pickbox is shown.

bool	IsOnline () const
	Checks if the element is online or offline.

virtual std::vector< wxPoint2DDouble >	GetPointList () const
	Get the list of points that connect the element to bus.

virtual std::vector< wxPoint2DDouble > &	GetPointListRef ()

virtual bool	AddParent (Element *parent, wxPoint2DDouble position, bool isOpening=false)
	Add a parent to the element. This method must be used on power elements that connect to a bus, so the parent must be a bus. The element basic points are calculated in this method, so apply this when the element is being inserted.

virtual void	AddParent (Element *parent)
	Add a parent to the element.

virtual bool	Contains (wxPoint2DDouble position) const =0
	Checks if the element contains a position.

virtual bool	Intersects (wxRect2DDouble rect) const =0
	Check if the element's rect intersects other rect.

virtual Element *	GetCopy ()
	Get a the element copy.

virtual void	SetID (int id)
	Set the element ID.

virtual int	GetID () const
	Get the element ID.

virtual void	AddChild (Element *child)
	Add a child to the child list.

virtual void	RemoveChild (Element *child)
	Remove a child from the list.

virtual void	ReplaceChild (Element oldChild, Element newChild)
	Replace a child from the list.

virtual wxString	GetTipText () const
	Get the tip text.

virtual void	DrawDC (GUIColour guiColour, wxPoint2DDouble translation, double scale, wxGraphicsContext gc) const
	Draw the element using GDI+.

virtual void	DrawDC (GUIColour *guiColour, wxPoint2DDouble translation, double scale, wxDC &dc) const
	Draw the element using wxDC.

virtual void	Rotate (bool clockwise=true)
	Rotate the element.

virtual bool	GetContextMenu (wxMenu &menu)
	Get the element contex menu.

virtual void	AddPoint (wxPoint2DDouble point)
	Add point to the list of points that connect the element to the bus.

virtual void	StartMove (wxPoint2DDouble position)
	Update the element attributes related to the movement.

virtual void	Move (wxPoint2DDouble position)
	Move the element other position.

virtual void	AlignToGrid (double gridSize=20.0)

virtual void	MoveNode (Element *parent, wxPoint2DDouble position)
	Move a node. StartMove(wxPoint2DDouble position) before start moving.

virtual bool	NodeContains (wxPoint2DDouble position)
	Check if a node contains a point. If contains, set the attributes related to node movement.

virtual void	UpdateNodes ()
	Update the nodes according to the parents. If a parent is removed, use this method.

void	SetParent (Element *parent, int num)

void	SetChild (Element *child, int num)

virtual bool	SetNodeParent (Element *parent)
	Set a perent to the node. If all conditions are met, a new parent are added to the element and the points related to the nodes will be calculated.

virtual void	RemoveParent (Element *parent)
	Remove a parent.

virtual void	ReplaceParent (Element oldParent, Element newParent)
	Replace a parent.

virtual void	RotateNode (Element *parent, bool clockwise=true)
	Rotate a node.

virtual bool	PickboxContains (wxPoint2DDouble position)
	Check if a pickbox contains a point. If contains the attributes related to pickbox movement will be calculated.

virtual void	MovePickbox (wxPoint2DDouble position)
	Move the pickbox.

virtual wxCursor	GetBestPickboxCursor () const
	Get the best cursor to shown to the user when the mouse is above a pickbox.

virtual void	ResetPickboxes ()
	Remove the pickboxes.

virtual void	ResetNodes ()
	Remove the active nodes.

virtual wxPoint2DDouble	WorldToScreen (wxPoint2DDouble translation, double scale, double offsetX=0.0, double offsetY=0.0) const
	Convert the element position to screen position.

virtual wxPoint2DDouble	WorldToScreen (wxPoint2DDouble position, wxPoint2DDouble translation, double scale, double offsetX=0.0, double offsetY=0.0) const
	Convert a generic position to screen position.

virtual bool	RotatedRectanglesIntersects (wxRect2DDouble rect1, wxRect2DDouble rect2, double angle1, double angle2) const
	Check if two roteted rectangles intersect.

virtual void	DrawDCRectangle (wxPoint2DDouble position, double width, double height, double angle, wxDC &dc) const
	Draw a circle.

virtual void	DrawDCRoundedRectRotated (wxDC &dc, const wxPoint2DDouble &center, double width, double height, double radius, double angleDeg, int arcSegments=8) const

virtual void	DrawDCCircle (wxPoint2DDouble position, double radius, int numSegments, wxGraphicsContext *gc) const
	Draw a circle using device context.

virtual void	DrawDCCircle (wxPoint2DDouble position, double radius, wxDC &dc) const

virtual void	DrawDCArc (wxPoint2DDouble position, double radius, double initAngle, double finalAngle, int numSegments, wxGraphicsContext *gc) const

virtual void	DrawDCArc (wxPoint2DDouble position, double radius, double initAngle, double finalAngle, wxDC &dc) const

virtual void	DrawDCTriangle (std::vector< wxPoint2DDouble > points, wxGraphicsContext *gc) const
	Draw rectangle.

virtual void	DrawDCTriangle (std::vector< wxPoint > points, wxDC &dc) const

virtual void	DrawStabilityEventGC (wxGraphicsContext gc, wxPoint2DDouble translation, double scale, GUIColour guiColour, bool rotateAnchor=false, wxPoint2DDouble iconPosition=wxPoint2DDouble(-1, -1)) const

virtual void	DrawDCPickbox (wxPoint2DDouble position, wxGraphicsContext *gc) const
	Draw a point.

virtual wxPoint2DDouble	RotateAtPosition (wxPoint2DDouble pointToRotate, double angle, bool degrees=true) const
	Rotate a point as element position being the origin.

virtual wxPoint2DDouble	RotateLocal (wxPoint2DDouble local, double angleDeg) const

virtual wxPoint	RotateAround (const wxPoint2DDouble &p, const wxPoint2DDouble &center, double angleDeg) const

virtual std::vector< Element * >	GetParentList () const
	Get the parent list.

virtual std::vector< Element * >	GetChildList () const
	Get the Child list.

virtual wxPoint2DDouble	GetMoveStartPosition () const

virtual wxPoint2DDouble	GetMovePosition () const

virtual void	CalculateBoundaries (wxPoint2DDouble &leftUp, wxPoint2DDouble &rightBottom) const
	Calculate the element boundaries.

virtual void	GeneralMenuItens (wxMenu &menu)
	Insert general itens to context menu.

virtual bool	ShowForm (wxWindow parent, Element element, wxWindow *workspace=nullptr)
	Show element data form.

virtual double	PointToLineDistance (wxPoint2DDouble point, int *segmentNumber=nullptr) const
	Calculate the distance between a line (formed by point list) and a point.

bool	IsInserted () const
	Check if the element is properly inserted in the workspace.

void	SetInserted (bool inserted=true)
	Set if the element is properly inserted in the workspace.

virtual rapidxml::xml_node *	SaveElement (rapidxml::xml_document<> &doc, rapidxml::xml_node<> *elementListNode)

virtual bool	OpenElement (rapidxml::xml_node<> *elementNode)

void	SaveCADProperties (rapidxml::xml_document<> &doc, rapidxml::xml_node<> *elementNode)

bool	OpenCADProperties (rapidxml::xml_node<> *elementNode)

Static Public Member Functions
static bool	DoubleFromString (wxWindow *parent, wxString strValue, double &value, wxString errorMsg)
	Get a double value from a string. Show a error message if the conversion fail.

static bool	IntFromString (wxWindow *parent, wxString strValue, int &value, wxString errorMsg)
	Convert a string to int. Show a error message if the conversion fail.

static wxString	StringFromDouble (double value, int minDecimal=1, int maxDecimals=13)
	Convert a double value to string.

Protected Attributes
ElementType	m_elementType = ElementType::TYPE_NONE

int	m_elementID = 0

std::vector< Element * >	m_parentList

std::vector< Element * >	m_childList

wxRect2DDouble	m_rect

wxPoint2DDouble	m_position

double	m_width = 0.0

double	m_height = 0.0

double	m_angle = 0.0

double	m_borderSize = 2.0

double	m_rotationAngle = 45.0

double	m_switchSize = 10.0

std::vector< wxRect2DDouble >	m_switchRect

bool	m_selected = false

bool	m_dragging = false

bool	m_showPickbox = false

bool	m_inserted = false

int	m_activePickboxID = ID_PB_NONE

int	m_activeNodeID = 0

std::vector< wxPoint2DDouble >	m_pointList

std::vector< wxPoint2DDouble >	m_movePts

wxPoint2DDouble	m_moveStartPt

wxPoint2DDouble	m_movePos

bool	m_online = true

Detailed Description

Base class of all elements of the program. This class is responsible for manage graphical and his data.

Author: Thales Lima Oliveira thale.nosp@m.s@uf.nosp@m.u.br

Date: 19/09/2017

Warning: Don't use this base class directly. Always create a derivative element to use it.

Definition at line 114 of file Element.h.

Constructor & Destructor Documentation

◆ Element()

Element::Element ( )

Constructor.

Definition at line 28 of file Element.cpp.

{
    //m_selectionColour.Set(0, 128, 255, 128);
}

◆ ~Element()

virtual Element::~Element ( )

inlinevirtual

Destructor.

Definition at line 125 of file Element.h.

125{}

Member Function Documentation

◆ AddChild()

void Element::AddChild ( Element * child )

virtual

Add a child to the child list.

Parameters

child New child.

Definition at line 581 of file Element.cpp.

581{ m_childList.push_back(child); }

Here is the caller graph for this function:

◆ AddParent() [1/2]

virtual void Element::AddParent ( Element * parent )

inlinevirtual

Add a parent to the element.

Parameters

parent Element parent.

Definition at line 248 of file Element.h.

248{ m_parentList.push_back(parent); }

◆ AddParent() [2/2]

virtual bool Element::AddParent	(	Element *	parent,
		wxPoint2DDouble	position,
		bool	isOpening = `false`
	)

inlinevirtual

Add a parent to the element. This method must be used on power elements that connect to a bus, so the parent must be a bus. The element basic points are calculated in this method, so apply this when the element is being inserted.

Parameters

parent	Element parent.
position	Node position in the parent.

Reimplemented in Bus, Capacitor, EMTElement, HarmCurrent, Inductor, Line, Load, Machines, Transformer, and Text.

Definition at line 243 of file Element.h.

243{ return false; }

◆ AddPoint()

virtual void Element::AddPoint ( wxPoint2DDouble point )

inlinevirtual

Add point to the list of points that connect the element to the bus.

Parameters

point Point to be added.

Reimplemented in Branch, and Line.

Definition at line 332 of file Element.h.

332{}

◆ AlignToGrid()

void Element::AlignToGrid ( double gridSize = 20.0 )

virtual

Definition at line 342 of file Element.cpp.

{
    if (gridSize <= 0.0) gridSize = 20.0;
    wxPoint2DDouble oldPos = m_position;
    wxPoint2DDouble newPos(std::round(oldPos.m_x / gridSize) * gridSize,
                           std::round(oldPos.m_y / gridSize) * gridSize);
    wxPoint2DDouble delta = newPos - oldPos;
    SetPosition(newPos);
    for (auto& pt : m_pointList) {
        pt += delta;
    }
}

◆ CalculateBoundaries()

void Element::CalculateBoundaries	(	wxPoint2DDouble &	leftUp,
		wxPoint2DDouble &	rightBottom
	)		const

virtual

Calculate the element boundaries.

Parameters

leftUp	Top-left position of the element.
rightBottom	Bottom-right position of the element.

Reimplemented in Line.

Definition at line 493 of file Element.cpp.

{
    // Check rect corners boundaries.
 
    // Get rectangle corners
    wxPoint2DDouble rectCorner[4] = { m_rect.GetLeftTop(), m_rect.GetLeftBottom(), m_rect.GetRightBottom(),
                                     m_rect.GetRightTop() };
    // Rotate corners.
    for (int i = 0; i < 4; ++i) { rectCorner[i] = RotateAtPosition(rectCorner[i], m_angle); }
    leftUp = rectCorner[0];
    rightBottom = rectCorner[0];
    for (int i = 1; i < 4; ++i) {
        if (rectCorner[i].m_x < leftUp.m_x) leftUp.m_x = rectCorner[i].m_x;
        if (rectCorner[i].m_y < leftUp.m_y) leftUp.m_y = rectCorner[i].m_y;
        if (rectCorner[i].m_x > rightBottom.m_x) rightBottom.m_x = rectCorner[i].m_x;
        if (rectCorner[i].m_y > rightBottom.m_y) rightBottom.m_y = rectCorner[i].m_y;
    }
 
    // Check points list boundaries.
    for (int i = 0; i < (int)m_pointList.size(); i++) {
        if (m_pointList[i].m_x < leftUp.m_x) leftUp.m_x = m_pointList[i].m_x;
        if (m_pointList[i].m_y < leftUp.m_y) leftUp.m_y = m_pointList[i].m_y;
        if (m_pointList[i].m_x > rightBottom.m_x) rightBottom.m_x = m_pointList[i].m_x;
        if (m_pointList[i].m_y > rightBottom.m_y) rightBottom.m_y = m_pointList[i].m_y;
    }
}

Here is the call graph for this function:

◆ Contains()

virtual bool Element::Contains ( wxPoint2DDouble position ) const

pure virtual

Checks if the element contains a position.

Parameters

position Position to be checked.

Implemented in ConnectionLine, Constant, Exponential, Gain, IOControl, Limiter, MathExpression, MathOperation, RateLimiter, Sum, TransferFunction, Branch, Bus, Capacitor, EMTElement, HarmCurrent, Inductor, Line, Machines, Shunt, Transformer, and Text.

Here is the caller graph for this function:

◆ DoubleFromString()

bool Element::DoubleFromString	(	wxWindow *	parent,
		wxString	strValue,
		double &	value,
		wxString	errorMsg
	)

static

Get a double value from a string. Show a error message if the conversion fail.

Parameters

parent	Message box parent.
strValue	String value to be converted.
value	Double value converted.
errorMsg	Error message.

Definition at line 520 of file Element.cpp.

{
    double dValue = 0.0;
 
    if (!strValue.ToDouble(&dValue)) {
        wxMessageDialog msgDialog(parent, errorMsg, _("Error"), wxOK | wxCENTRE | wxICON_ERROR);
        msgDialog.ShowModal();
        return false;
    }
 
    value = dValue;
    return true;
}

◆ DrawDC() [1/2]

virtual void Element::DrawDC	(	GUIColour *	guiColour,
		wxPoint2DDouble	translation,
		double	scale,
		wxDC &	dc
	)		const

inlinevirtual

Draw the element using wxDC.

Parameters

guiColour	Colours of the system defined in properties.
translation	Translation of the system.
scale	Scale of the system.
dc	Device context.

Reimplemented in Bus, Capacitor, EMTElement, HarmCurrent, Inductor, Line, Load, Machines, and Transformer.

Definition at line 316 of file Element.h.

316{}

◆ DrawDC() [2/2]

virtual void Element::DrawDC	(	GUIColour *	guiColour,
		wxPoint2DDouble	translation,
		double	scale,
		wxGraphicsContext *	gc
	)		const

inlinevirtual

Draw the element using GDI+.

Parameters

guiColour	Colours of the system defined in properties.
translation	Translation of the system.
scale	Scale of the system.
gc	Graphics context

Reimplemented in ConnectionLine, Constant, Exponential, Gain, IOControl, Limiter, MathExpression, MathOperation, RateLimiter, Sum, TransferFunction, Bus, Capacitor, EMTElement, HarmCurrent, Inductor, Line, Load, Machines, and Transformer.

Definition at line 308 of file Element.h.

308{}

◆ DrawDCArc() [1/2]

void Element::DrawDCArc	(	wxPoint2DDouble	position,
		double	radius,
		double	initAngle,
		double	finalAngle,
		int	numSegments,
		wxGraphicsContext *	gc
	)		const

virtual

Definition at line 190 of file Element.cpp.

{
    double initAngRad = wxDegToRad(initAngle);
    double finalAngRad = wxDegToRad(finalAngle);
    wxPoint2DDouble* points = new wxPoint2DDouble[numSegments + 2];
    for (int i = 0; i <= numSegments; i++) {
        double theta = initAngRad + (finalAngRad - initAngRad) * double(i) / double(numSegments);
        points[i] = wxPoint2DDouble(radius * std::cos(theta) + position.m_x, radius * std::sin(theta) + position.m_y);
    }
 
    gc->StrokeLines(numSegments + 1, points);
    delete[] points;
}

◆ DrawDCArc() [2/2]

void Element::DrawDCArc	(	wxPoint2DDouble	position,
		double	radius,
		double	initAngle,
		double	finalAngle,
		wxDC &	dc
	)		const

virtual

Definition at line 204 of file Element.cpp.

{
    dc.DrawEllipticArc(wxRound(position.m_x - radius), wxRound(position.m_y - radius), wxRound(2 * radius), wxRound(2 * radius), initAngle, finalAngle);
}

◆ DrawDCCircle() [1/2]

void Element::DrawDCCircle	(	wxPoint2DDouble	position,
		double	radius,
		int	numSegments,
		wxGraphicsContext *	gc
	)		const

virtual

Draw a circle using device context.

Parameters

position	Circle position.
radius	Circle radius
numSegments	Num of segments of the circle.
gl	Device context.

Definition at line 173 of file Element.cpp.

{
    wxPoint2DDouble* pts = new wxPoint2DDouble[numSegments + 1];
    for (int i = 0; i < numSegments; i++) {
        double theta = 2.0 * 3.1415926 * double(i) / double(numSegments);
        pts[i] = wxPoint2DDouble(radius * std::cos(theta) + position.m_x, radius * std::sin(theta) + position.m_y);
    }
    pts[numSegments] = pts[0];
    gc->DrawLines(numSegments + 1, pts);
    delete[] pts;
}

Here is the caller graph for this function:

◆ DrawDCCircle() [2/2]

void Element::DrawDCCircle	(	wxPoint2DDouble	position,
		double	radius,
		wxDC &	dc
	)		const

virtual

Definition at line 185 of file Element.cpp.

{
    dc.DrawCircle(wxRound(position.m_x), wxRound(position.m_y), wxRound(radius));
}

◆ DrawDCPickbox()

void Element::DrawDCPickbox	(	wxPoint2DDouble	position,
		wxGraphicsContext *	gc
	)		const

virtual

Draw a point.

Parameters

position	Point position.
size	Point size.

Draw line.

Parameters

points	Line vertices.
mode	OpenGl primitive.

Draw pickbox.

Parameters

position Pickbox position.

Draw pickbox using direct context.

Parameters

position	Pickbox position.
gc	Direct context.

Definition at line 291 of file Element.cpp.

{
    gc->SetPen(wxPen(wxColour(0, 0, 0, 255)));
    gc->SetBrush(wxBrush(wxColour(255, 255, 255, 204)));
    gc->DrawRectangle(position.m_x, position.m_y, 8, 8);
}

Here is the caller graph for this function:

◆ DrawDCRectangle()

void Element::DrawDCRectangle	(	wxPoint2DDouble	position,
		double	width,
		double	height,
		double	angle,
		wxDC &	dc
	)		const

virtual

Draw a circle.

Parameters

position	Circle position.
radius	Circle radius
numSegments	Num of segments of the circle.
mode	OpenGl primitive.

Definition at line 41 of file Element.cpp.

{
    if (angle == 0.0) {
        wxPoint poly[4] = {
            wxPoint((int)(position.m_x - width / 2.0), (int)(position.m_y - height / 2.0)),
            wxPoint((int)(position.m_x + width / 2.0), (int)(position.m_y - height / 2.0)),
            wxPoint((int)(position.m_x + width / 2.0), (int)(position.m_y + height / 2.0)),
            wxPoint((int)(position.m_x - width / 2.0), (int)(position.m_y + height / 2.0))
        };
        dc.DrawPolygon(4, poly);
        return;
    }
 
    double hw = width / 2.0;
    double hh = height / 2.0;
    double angleRad = wxDegToRad(angle);
 
    // Retângulo centrado na origem
    wxPoint2DDouble pts[4] = {
        {-hw, -hh},
        { hw, -hh},
        { hw,  hh},
        {-hw,  hh}
    };
 
    wxPoint poly[4];
 
    for (int i = 0; i < 4; ++i)
    {
        double x = pts[i].m_x;
        double y = pts[i].m_y;
 
        // Rotação
        double xr = x * cos(angleRad) - y * sin(angleRad);
        double yr = x * sin(angleRad) + y * cos(angleRad);
 
        // Translação para centro
        poly[i].x = (int)(xr + position.m_x);
        poly[i].y = (int)(yr + position.m_y);
    }
 
    dc.DrawPolygon(4, poly);
 
}

Here is the caller graph for this function:

◆ DrawDCRoundedRectRotated()

void Element::DrawDCRoundedRectRotated	(	wxDC &	dc,
		const wxPoint2DDouble &	center,
		double	width,
		double	height,
		double	radius,
		double	angleDeg,
		int	arcSegments = `8`
	)		const

virtual

Definition at line 86 of file Element.cpp.

{
    radius = std::min(radius, std::min(width, height) / 2.0);
 
    double hw = width / 2.0;
    double hh = height / 2.0;
 
    double rad = wxDegToRad(angleDeg);
    double c = std::cos(rad);
    double s = std::sin(rad);
 
    auto rotate = [&](double x, double y)
        {
            double xr = c * x - s * y + center.m_x;
            double yr = s * x + c * y + center.m_y;
            return wxPoint2DDouble(xr, yr);
        };
 
    auto drawArc = [&](double cx, double cy,
        double startDeg)
        {
            wxPoint2DDouble arcCenterLocal(cx, cy);
            wxPoint2DDouble arcCenter = rotate(arcCenterLocal.m_x,
                arcCenterLocal.m_y);
 
            double start = startDeg + angleDeg;
            double end = start + 90.0;
 
            dc.DrawEllipticArc(
                wxRound(arcCenter.m_x - radius),
                wxRound(arcCenter.m_y - radius),
                wxRound(radius * 2),
                wxRound(radius * 2),
                start,
                end
            );
        };
 
    auto line = [&](double x1, double y1,
        double x2, double y2,
        wxPoint& p1, wxPoint& p2)
        {
            wxPoint2DDouble p1d = rotate(x1, y1);
            wxPoint2DDouble p2d = rotate(x2, y2);
            p1 = wxPoint(wxRound(p1d.m_x), wxRound(p1d.m_y));
            p2 = wxPoint(wxRound(p2d.m_x), wxRound(p2d.m_y));
 
            //dc.DrawLine(p1.x, p1.y, p2.x, p2.y);
        };
 
    wxPen pen = dc.GetPen();
 
    wxPoint pts[4];
    line(-hw + radius, -hh,
        hw - radius, -hh,
        pts[0], pts[1]);
 
    line(hw - radius, hh,
        -hw + radius, hh,
        pts[2], pts[3]);
 
    dc.SetPen(*wxTRANSPARENT_PEN);
    dc.DrawPolygon(4, pts);
    dc.SetPen(pen);
    dc.DrawLine(pts[0].x, pts[0].y, pts[1].x, pts[1].y);
    dc.DrawLine(pts[2].x, pts[2].y, pts[3].x, pts[3].y);
 
    line(hw, -hh + radius,
        hw, hh - radius,
        pts[0], pts[1]);
 
    line(-hw, hh - radius,
        -hw, -hh + radius,
        pts[2], pts[3]);
 
    dc.SetPen(*wxTRANSPARENT_PEN);
    dc.DrawPolygon(4, pts);
    dc.SetPen(pen);
    dc.DrawLine(pts[0].x, pts[0].y, pts[1].x, pts[1].y);
    dc.DrawLine(pts[2].x, pts[2].y, pts[3].x, pts[3].y);
 
    drawArc(hw - radius, -hh + radius, 0 - angleDeg * 2);
    drawArc(hw - radius, hh - radius, 270 - angleDeg * 2);
    drawArc(-hw + radius, hh - radius, 180 - angleDeg * 2);
    drawArc(-hw + radius, -hh + radius, 90 - angleDeg * 2);
}

◆ DrawDCTriangle() [1/2]

void Element::DrawDCTriangle	(	std::vector< wxPoint >	points,
		wxDC &	dc
	)		const

virtual

Definition at line 215 of file Element.cpp.

{
    points.emplace_back(points[0]);
    dc.DrawPolygon(4, &points[0]);
}

◆ DrawDCTriangle() [2/2]

void Element::DrawDCTriangle	(	std::vector< wxPoint2DDouble >	points,
		wxGraphicsContext *	gc
	)		const

virtual

Draw rectangle.

Parameters

position	Rectangle position.
width	Rectangle width.
height	Rectangle height.
mode	OpenGl primitive.

Draw rectangle.

Parameters

points	Rectangle vertices.
mode	OpenGl primitive.

Draw a triangle.

Parameters

points	Triangle vertices.
mode	OpenGl primitive.

Draw a triangle.

Parameters

points	Triangle vertices.
gc	Device context.

Definition at line 209 of file Element.cpp.

{
    points.emplace_back(points[0]);
    gc->DrawLines(4, &points[0]);
}

Here is the caller graph for this function:

◆ DrawStabilityEventGC()

void Element::DrawStabilityEventGC	(	wxGraphicsContext *	gc,
		wxPoint2DDouble	translation,
		double	scale,
		GUIColour *	guiColour,
		bool	rotateAnchor = `false`,
		wxPoint2DDouble	iconPosition = `wxPoint2DDouble(-1, -1)`
	)		const

virtual

Definition at line 221 of file Element.cpp.

{
    if (!gc)
        return;
 
    // Fixed size in screen pixels.
    constexpr double radius = 10.0;
    constexpr int handWidth = 3;
    constexpr int crownWidth = 7;
    constexpr int crownHeight = 3;
    constexpr int crownStem = 3;
    constexpr double margin = 4.0;
 
    wxGraphicsMatrix identityMatrix = gc->GetTransform();
    identityMatrix.Set();
 
    gc->PushState();
    gc->SetTransform(identityMatrix);
 
    wxPoint2DDouble screenPt;
 
    // Use the specified position when provided.
    if (iconPosition.m_x != -1.0 || iconPosition.m_y != -1.0) {
        screenPt = WorldToScreen(iconPosition, translation, scale, 0.0, 0.0);
    }
    else {
        // Get the element angle in a canonical range [-90°, 90°].
        double anchorAngle = std::fmod(m_angle, 180.0);
 
        if (anchorAngle >= 90.0)
            anchorAngle -= 180.0;
        else if (anchorAngle < -90.0)
            anchorAngle += 180.0;
 
        // Get the right edge of the element.
        wxPoint2DDouble anchor(m_width / 2.0, 0.0);
 
        if (rotateAnchor)
            anchor = RotateLocal(anchor, anchorAngle);
 
        // Convert the anchor to screen coordinates.
        screenPt = WorldToScreen(translation, scale, anchor.m_x, anchor.m_y);
    }
 
    // Keep the indicator at a fixed screen-space offset from the element.
    screenPt.m_x += radius + margin * scale;
    screenPt.m_y -= radius + crownStem + crownHeight + margin * scale;
 
    // Draw stopwatch body.
    gc->SetPen(*wxTRANSPARENT_PEN);
    gc->SetBrush(wxBrush(guiColour->bus));
    gc->DrawEllipse(screenPt.m_x - radius, screenPt.m_y - radius, 2.0 * radius, 2.0 * radius);
 
    // Draw stopwatch stem.
    gc->SetPen(wxPen(guiColour->bus, crownHeight));
    gc->StrokeLine(screenPt.m_x, screenPt.m_y - radius, screenPt.m_x, screenPt.m_y - radius - crownStem);
 
    // Draw stopwatch crown.
    gc->StrokeLine(screenPt.m_x - crownWidth / 2.0, screenPt.m_y - radius - crownStem, screenPt.m_x + crownWidth / 2.0, screenPt.m_y - radius - crownStem);
 
    // Draw clock hands.
    wxPen handPen(guiColour->eventElement, handWidth);
    handPen.SetCap(wxCAP_ROUND);
    gc->SetPen(handPen);
    gc->StrokeLine(screenPt.m_x, screenPt.m_y, screenPt.m_x, screenPt.m_y - 7.0);
    gc->StrokeLine(screenPt.m_x, screenPt.m_y, screenPt.m_x + 5.0, screenPt.m_y + 3.0);
 
    gc->PopState();
}

◆ GeneralMenuItens()

void Element::GeneralMenuItens ( wxMenu & menu )

virtual

Insert general itens to context menu.

Parameters

menu	Menu that will be inserted the general itens.

Definition at line 475 of file Element.cpp.

{
    wxFileName exeFileName(wxStandardPaths::Get().GetExecutablePath());
    //wxString exePath = exeFileName.GetPath();
 
    wxMenuItem* clockItem = new wxMenuItem(&menu, ID_ROTATE_CLOCK, _("Rotate clockwise"));
    clockItem->SetBitmap(wxImage(Paths::GetDataPath() + "/images/menu/rotateClock16.png"));
    menu.Append(clockItem);
 
    wxMenuItem* counterClockItem = new wxMenuItem(&menu, ID_ROTATE_COUNTERCLOCK, _("Rotate counter-clockwise"));
    counterClockItem->SetBitmap(wxImage(Paths::GetDataPath() + "/images/menu/rotateCounterClock16.png"));
    menu.Append(counterClockItem);
 
    wxMenuItem* deleteItem = new wxMenuItem(&menu, ID_DELETE, _("Delete"));
    deleteItem->SetBitmap(wxImage(Paths::GetDataPath() + "/images/menu/delete16.png"));
    menu.Append(deleteItem);
}

Here is the caller graph for this function:

◆ GetAngle()

double Element::GetAngle ( ) const

inline

Get the element angle.

Returns: Angle value.

Definition at line 214 of file Element.h.

214{ return m_angle; }

Here is the caller graph for this function:

◆ GetBestPickboxCursor()

virtual wxCursor Element::GetBestPickboxCursor ( ) const

inlinevirtual

Get the best cursor to shown to the user when the mouse is above a pickbox.

Returns: Cursor.

Reimplemented in Branch, Bus, and Line.

Definition at line 407 of file Element.h.

407{ return wxCURSOR_ARROW; }

◆ GetChildList()

virtual std::vector< Element * > Element::GetChildList ( ) const

inlinevirtual

Get the Child list.

Returns: Child List.

Definition at line 572 of file Element.h.

572{ return m_childList; }

◆ GetContextMenu()

virtual bool Element::GetContextMenu ( wxMenu & menu )

inlinevirtual

Get the element contex menu.

Parameters

menu	menu that will be inserted the element itens.

Returns: True if was possible to build the menu, false otherwise.

Reimplemented in Branch, Bus, Capacitor, EMTElement, HarmCurrent, IndMotor, Inductor, Line, Load, SyncGenerator, SyncMotor, and Transformer.

Definition at line 327 of file Element.h.

327{ return false; }

◆ GetCopy()

virtual Element * Element::GetCopy ( )

inlinevirtual

Get a the element copy.

Returns: Copy of the element.

Reimplemented in ConnectionLine, Constant, Divider, Exponential, Gain, IOControl, Limiter, MathExpression, Multiplier, RateLimiter, Sum, TransferFunction, Bus, Capacitor, EMTElement, HarmCurrent, IndMotor, Inductor, Line, Load, SyncGenerator, SyncMotor, Transformer, and Text.

Definition at line 265 of file Element.h.

265{ return nullptr; }

◆ GetElementType()

ElementType Element::GetElementType ( )

inline

Definition at line 179 of file Element.h.

179{ return m_elementType; }

◆ GetHeight()

double Element::GetHeight ( ) const

inline

Get the element height.

Returns: Element height.

Definition at line 199 of file Element.h.

199{ return m_height; }

Here is the caller graph for this function:

◆ GetID()

virtual int Element::GetID ( ) const

inlinevirtual

Get the element ID.

Returns: Element ID.

Definition at line 275 of file Element.h.

275{ return m_elementID; }

◆ GetMovePosition()

virtual wxPoint2DDouble Element::GetMovePosition ( ) const

inlinevirtual

Definition at line 574 of file Element.h.

574{ return m_movePos; }

◆ GetMoveStartPosition()

virtual wxPoint2DDouble Element::GetMoveStartPosition ( ) const

inlinevirtual

Definition at line 573 of file Element.h.

573{ return m_moveStartPt; }

◆ GetParentList()

virtual std::vector< Element * > Element::GetParentList ( ) const

inlinevirtual

Get the parent list.

Returns: Parent list.

Definition at line 567 of file Element.h.

567{ return m_parentList; }

Here is the caller graph for this function:

◆ GetPointList()

virtual std::vector< wxPoint2DDouble > Element::GetPointList ( ) const

inlinevirtual

Get the list of points that connect the element to bus.

Returns: List of points.

Definition at line 234 of file Element.h.

234{ return m_pointList; }

◆ GetPointListRef()

virtual std::vector< wxPoint2DDouble > & Element::GetPointListRef ( )

inlinevirtual

Definition at line 235 of file Element.h.

235{ return m_pointList; }

◆ GetPosition()

wxPoint2DDouble Element::GetPosition ( ) const

inline

Get the element position.

Returns: Element position.

Definition at line 189 of file Element.h.

189{ return m_position; }

Here is the caller graph for this function:

◆ GetRect()

wxRect2DDouble Element::GetRect ( ) const

inline

Get the element rectangle.

Returns: Element rectangle.

Definition at line 184 of file Element.h.

184{ return m_rect; }

◆ GetRotationAngle()

double Element::GetRotationAngle ( ) const

inline

Get the angle of rotation.

Returns: Rotation angle.

Definition at line 219 of file Element.h.

219{ return m_rotationAngle; }

◆ GetTipText()

virtual wxString Element::GetTipText ( ) const

inlinevirtual

Get the tip text.

Returns: Tip text.

Reimplemented in Bus, Capacitor, EMTElement, HarmCurrent, IndMotor, Inductor, Line, Load, SyncGenerator, SyncMotor, and Transformer.

Definition at line 299 of file Element.h.

299{ return wxEmptyString; }

◆ GetWidth()

double Element::GetWidth ( ) const

inline

Get the element width.

Returns: Element width.

Definition at line 209 of file Element.h.

209{ return m_width; }

Here is the caller graph for this function:

◆ Intersects()

virtual bool Element::Intersects ( wxRect2DDouble rect ) const

pure virtual

Check if the element's rect intersects other rect.

Parameters

rect	Rect to check intersection.

Implemented in ConnectionLine, Constant, Exponential, Gain, IOControl, Limiter, MathExpression, MathOperation, RateLimiter, Sum, TransferFunction, Branch, Bus, Capacitor, EMTElement, HarmCurrent, Inductor, Line, Machines, Shunt, Transformer, and Text.

Here is the caller graph for this function:

◆ IntFromString()

bool Element::IntFromString	(	wxWindow *	parent,
		wxString	strValue,
		int &	value,
		wxString	errorMsg
	)

static

Convert a string to int. Show a error message if the conversion fail.

Parameters

parent	Message box parent.
strValue	String value to be converted.
value	Int value converted.
errorMsg	Error message.

Definition at line 534 of file Element.cpp.

{
    long int iValue = 0;
 
    if (!strValue.ToLong(&iValue)) {
        wxMessageDialog msgDialog(parent, errorMsg, _("Error"), wxOK | wxCENTRE | wxICON_ERROR);
        msgDialog.ShowModal();
        return false;
    }
 
    value = iValue;
    return true;
}

◆ IsDragging()

bool Element::IsDragging ( ) const

inline

Checks if the element is being dragged.

Returns: True if is being dragged, false otherwise.

Definition at line 194 of file Element.h.

194{ return m_dragging; }

◆ IsInserted()

bool Element::IsInserted ( ) const

inline

Check if the element is properly inserted in the workspace.

Returns: true if is inserted properly, false otherwise

Definition at line 633 of file Element.h.

633{ return m_inserted; }

◆ IsOnline()

bool Element::IsOnline ( ) const

inline

Checks if the element is online or offline.

Returns: True if online, false if offline.

Definition at line 229 of file Element.h.

229{ return m_online; }

Here is the caller graph for this function:

◆ IsPickboxShown()

bool Element::IsPickboxShown ( ) const

inline

Checks if the pickbox is shown.

Returns: True if the pickbox is show, false otherwise.

Definition at line 224 of file Element.h.

224{ return m_showPickbox; }

◆ IsSelected()

bool Element::IsSelected ( ) const

inline

Checks if the element is selected.

Returns: True if selected, false otherwise.

Definition at line 204 of file Element.h.

204{ return m_selected; }

◆ Move()

void Element::Move ( wxPoint2DDouble position )

virtual

Move the element other position.

Parameters

position Position that the element will be moved. Use StartMove(wxPoint2DDouble position) before start moving.

Reimplemented in ConnectionLine, ControlElement, Gain, Branch, Line, Machines, Shunt, and Transformer.

Definition at line 341 of file Element.cpp.

341{ SetPosition(m_movePos + position - m_moveStartPt); }

Here is the call graph for this function:

◆ MoveNode()

virtual void Element::MoveNode	(	Element *	parent,
		wxPoint2DDouble	position
	)

inlinevirtual

Move a node. StartMove(wxPoint2DDouble position) before start moving.

Parameters

parent	Node's parent.
position	New node position.

Reimplemented in Machines, Shunt, Branch, Line, and Transformer.

Definition at line 352 of file Element.h.

352{}

◆ MovePickbox()

virtual void Element::MovePickbox ( wxPoint2DDouble position )

inlinevirtual

Move the pickbox.

Parameters

position position that the pickbox will be moved.

Reimplemented in Branch, Bus, and Line.

Definition at line 402 of file Element.h.

402{}

◆ NodeContains()

virtual bool Element::NodeContains ( wxPoint2DDouble position )

inlinevirtual

Check if a node contains a point. If contains, set the attributes related to node movement.

Parameters

position Position tested.

Returns: True if at least one node contains the position, false otherwise.

Reimplemented in Branch, Machines, and Shunt.

Definition at line 358 of file Element.h.

358{ return false; }

◆ OpenCADProperties()

bool Element::OpenCADProperties ( rapidxml::xml_node<> * elementNode )

Definition at line 670 of file Element.cpp.

{
    auto cadPropNode = elementNode->first_node("CADProperties");
    if (!cadPropNode) return false;
 
    auto position = cadPropNode->first_node("Position");
    double posX = XMLParser::GetNodeValueDouble(position, "X");
    double posY = XMLParser::GetNodeValueDouble(position, "Y");
    auto size = cadPropNode->first_node("Size");
    m_width = XMLParser::GetNodeValueDouble(size, "Width");
    m_height = XMLParser::GetNodeValueDouble(size, "Height");
    m_angle = XMLParser::GetNodeValueDouble(cadPropNode, "Angle");
    SetPosition(wxPoint2DDouble(posX, posY));
    return true;
}

◆ OpenElement()

virtual bool Element::OpenElement ( rapidxml::xml_node<> * elementNode )

inlinevirtual

Definition at line 642 of file Element.h.

642{ return true; }

◆ PickboxContains()

virtual bool Element::PickboxContains ( wxPoint2DDouble position )

inlinevirtual

Check if a pickbox contains a point. If contains the attributes related to pickbox movement will be calculated.

Parameters

position Position to be checked.

Returns: True if the element constains the pickbox, false otherwise.

Reimplemented in Branch, Bus, and Line.

Definition at line 397 of file Element.h.

397{ return false; }

◆ PointToLineDistance()

double Element::PointToLineDistance	(	wxPoint2DDouble	point,
		int *	segmentNumber = `nullptr`
	)		const

virtual

Calculate the distance between a line (formed by point list) and a point.

Parameters

point	origin point.
segmentNumber	Sotores the segment number clicked

Returns: The distance between the point and the line.

Definition at line 616 of file Element.cpp.

{
    //[Ref] http://geomalgorithms.com/a02-_lines.html
    double distance = 100.0;  // Big initial distance.
    wxPoint2DDouble p0 = point;
 
    for (int i = 1; i < (int)m_pointList.size() - 2; i++) {
        double d = 0.0;
 
        wxPoint2DDouble p1 = m_pointList[i];
        wxPoint2DDouble p2 = m_pointList[i + 1];
 
        wxPoint2DDouble v = p2 - p1;
        wxPoint2DDouble w = p0 - p1;
 
        double c1 = w.m_x * v.m_x + w.m_y * v.m_y;
        double c2 = v.m_x * v.m_x + v.m_y * v.m_y;
 
        if (c1 <= 0.0) {
            d = std::sqrt(std::pow(p0.m_y - p1.m_y, 2) + std::pow(p0.m_x - p1.m_x, 2));
        }
        else if (c2 <= c1) {
            d = std::sqrt(std::pow(p0.m_y - p2.m_y, 2) + std::pow(p0.m_x - p2.m_x, 2));
        }
        else {
            d = std::abs((p2.m_y - p1.m_y) * p0.m_x - (p2.m_x - p1.m_x) * p0.m_y + p2.m_x * p1.m_y - p2.m_y * p1.m_x) /
                std::sqrt(std::pow(p2.m_y - p1.m_y, 2) + std::pow(p2.m_x - p1.m_x, 2));
        }
        if (d < distance) {
            distance = d;
            if (segmentNumber) *segmentNumber = i;
        }
    }
 
    return distance;
}

Here is the caller graph for this function:

◆ RemoveChild()

void Element::RemoveChild ( Element * child )

virtual

Remove a child from the list.

Parameters

child Child to remove.

Definition at line 582 of file Element.cpp.

{
    for (auto it = m_childList.begin(); it != m_childList.end();) {
        if (*it == child) it = m_childList.erase(it);
        else ++it;
    }
}

◆ RemoveParent()

virtual void Element::RemoveParent ( Element * parent )

inlinevirtual

Remove a parent.

Parameters

parent Parent to be removed.

Reimplemented in ConnectionLine, Branch, Machines, and Shunt.

Definition at line 377 of file Element.h.

377{}

◆ ReplaceChild()

void Element::ReplaceChild	(	Element *	oldChild,
		Element *	newChild
	)

virtual

Replace a child from the list.

Parameters

oldChild	Old child.
newChild	New child.

Definition at line 590 of file Element.cpp.

{
    for (int i = 0; i < (int)m_childList.size(); i++) {
        if (m_childList[i] == oldChild) m_childList[i] = newChild;
    }
}

◆ ReplaceParent()

void Element::ReplaceParent	(	Element *	oldParent,
		Element *	newParent
	)

virtual

Replace a parent.

Parameters

oldParent	Parent to be replaced.
newParent	New parent.

Definition at line 574 of file Element.cpp.

{
    for (int i = 0; i < (int)m_parentList.size(); i++) {
        if (m_parentList[i] == oldParent) m_parentList[i] = newParent;
    }
}

◆ ResetNodes()

virtual void Element::ResetNodes ( )

inlinevirtual

Remove the active nodes.

Definition at line 415 of file Element.h.

415{ m_activeNodeID = 0; }

◆ ResetPickboxes()

virtual void Element::ResetPickboxes ( )

inlinevirtual

Remove the pickboxes.

Definition at line 411 of file Element.h.

411{ m_activePickboxID = ID_PB_NONE; }

ID_PB_NONE

@ ID_PB_NONE

Definition Element.h:63

◆ Rotate()

virtual void Element::Rotate ( bool clockwise = true )

inlinevirtual

Rotate the element.

Parameters

clockwise True to rotate clockwise, false to rotate counter-clockwise.

Reimplemented in Constant, Exponential, Gain, IOControl, Limiter, MathExpression, MathOperation, RateLimiter, Sum, TransferFunction, Bus, Capacitor, EMTElement, HarmCurrent, Inductor, Load, Machines, Transformer, and Text.

Definition at line 321 of file Element.h.

321{}

◆ RotateAround()

wxPoint Element::RotateAround	(	const wxPoint2DDouble &	p,
		const wxPoint2DDouble &	center,
		double	angleDeg
	)		const

virtual

Definition at line 320 of file Element.cpp.

{
    double rad = wxDegToRad(angleDeg);
    double c = std::cos(rad);
    double s = std::sin(rad);
 
    double dx = p.m_x - center.m_x;
    double dy = p.m_y - center.m_y;
 
    double xr = c * dx - s * dy + center.m_x;
    double yr = s * dx + c * dy + center.m_y;
 
    return wxPoint(wxRound(xr), wxRound(yr));
}

◆ RotateAtPosition()

wxPoint2DDouble Element::RotateAtPosition	(	wxPoint2DDouble	pointToRotate,
		double	angle,
		bool	degrees = `true`
	)		const

virtual

Rotate a point as element position being the origin.

Parameters

pointToRotate	Point that will be rotated.
angle	Angle of rotation.
degrees	True if the angle is in degrees, false if radians.

Definition at line 298 of file Element.cpp.

{
    double radAngle = angle;
    if (degrees) radAngle = wxDegToRad(angle);
    return wxPoint2DDouble(std::cos(radAngle) * (pointToRotate.m_x - m_position.m_x) -
        std::sin(radAngle) * (pointToRotate.m_y - m_position.m_y) + m_position.m_x,
        std::sin(radAngle) * (pointToRotate.m_x - m_position.m_x) +
        std::cos(radAngle) * (pointToRotate.m_y - m_position.m_y) + m_position.m_y);
}

Here is the caller graph for this function:

◆ RotatedRectanglesIntersects()

bool Element::RotatedRectanglesIntersects	(	wxRect2DDouble	rect1,
		wxRect2DDouble	rect2,
		double	angle1,
		double	angle2
	)		const

virtual

Check if two roteted rectangles intersect.

Parameters

rect1	First rect.
rect2	Second rect.
angle1	Rotation algle of first rectangle.
angle2	Rotation angle of second rectangle.

Definition at line 377 of file Element.cpp.

{
    wxPoint2DDouble rect1Corners[4] = { rect1.GetLeftTop(), rect1.GetLeftBottom(), rect1.GetRightBottom(),
                                       rect1.GetRightTop() };
    wxPoint2DDouble rect2Corners[4] = { rect2.GetLeftTop(), rect2.GetLeftBottom(), rect2.GetRightBottom(),
                                       rect2.GetRightTop() };
    wxPoint2DDouble rect1Center(rect1.m_x + rect1.m_width / 2.0, rect1.m_y + rect1.m_height / 2.0);
    wxPoint2DDouble rect2Center(rect2.m_x + rect2.m_width / 2.0, rect2.m_y + rect2.m_height / 2.0);
 
    // Rotate the corners.
    double radAngle1 = wxDegToRad(angle1);
    double radAngle2 = wxDegToRad(angle2);
 
    for (int i = 0; i < 4; i++) {
        rect1Corners[i] =
            wxPoint2DDouble(std::cos(radAngle1) * (rect1Corners[i].m_x - rect1Center.m_x) -
                std::sin(radAngle1) * (rect1Corners[i].m_y - rect1Center.m_y) + rect1Center.m_x,
                std::sin(radAngle1) * (rect1Corners[i].m_x - rect1Center.m_x) +
                std::cos(radAngle1) * (rect1Corners[i].m_y - rect1Center.m_y) + rect1Center.m_y);
 
        rect2Corners[i] =
            wxPoint2DDouble(std::cos(radAngle2) * (rect2Corners[i].m_x - rect2Center.m_x) -
                std::sin(radAngle2) * (rect2Corners[i].m_y - rect2Center.m_y) + rect2Center.m_x,
                std::sin(radAngle2) * (rect2Corners[i].m_x - rect2Center.m_x) +
                std::cos(radAngle2) * (rect2Corners[i].m_y - rect2Center.m_y) + rect2Center.m_y);
    }
 
    //[Ref] http://www.gamedev.net/page/resources/_/technical/game-programming/2d-rotated-rectangle-collision-r2604
 
    // Find the rectangles axis to project
    wxPoint2DDouble axis[4] = { rect1Corners[3] - rect1Corners[0], rect1Corners[3] - rect1Corners[2],
                               rect2Corners[3] - rect2Corners[0], rect2Corners[3] - rect2Corners[2] };
 
    // Calculate the projected points to each axis
    wxPoint2DDouble rect1ProjPts[4][4];  // [axis][corner]
    wxPoint2DDouble rect2ProjPts[4][4];  // [axis][corner]
    for (int i = 0; i < 4; i++) {
        double den = axis[i].m_x * axis[i].m_x + axis[i].m_y * axis[i].m_y;
        for (int j = 0; j < 4; j++) {
            double m_rectProj = (rect1Corners[j].m_x * axis[i].m_x + rect1Corners[j].m_y * axis[i].m_y) / den;
            double rectProj = (rect2Corners[j].m_x * axis[i].m_x + rect2Corners[j].m_y * axis[i].m_y) / den;
 
            rect1ProjPts[i][j] = wxPoint2DDouble(m_rectProj * axis[i].m_x, m_rectProj * axis[i].m_y);
            rect2ProjPts[i][j] = wxPoint2DDouble(rectProj * axis[i].m_x, rectProj * axis[i].m_y);
        }
    }
 
    // Calculate the scalar value to identify the max and min values on projections
    double rect1Scalar[4][4];  //[axis][corner]
    double rect2Scalar[4][4];  //[axis][corner]
    for (int i = 0; i < 4; i++) {
        for (int j = 0; j < 4; j++) {
            rect1Scalar[i][j] = rect1ProjPts[i][j].m_x * axis[i].m_x + rect1ProjPts[i][j].m_y * axis[i].m_y;
            rect2Scalar[i][j] = rect2ProjPts[i][j].m_x * axis[i].m_x + rect2ProjPts[i][j].m_y * axis[i].m_y;
        }
    }
    // Identify the max and min scalar values
    double rect1Min[4];
    double rect1Max[4];
    double rect2Min[4];
    double rect2Max[4];
 
    for (int i = 0; i < 4; i++) {
        rect1Max[i] = rect1Scalar[i][0];
        rect2Max[i] = rect2Scalar[i][0];
        rect1Min[i] = rect1Scalar[i][0];
        rect2Min[i] = rect2Scalar[i][0];
 
        for (int j = 1; j < 4; j++) {
            if (rect1Max[i] < rect1Scalar[i][j]) rect1Max[i] = rect1Scalar[i][j];
            if (rect2Max[i] < rect2Scalar[i][j]) rect2Max[i] = rect2Scalar[i][j];
 
            if (rect1Min[i] > rect1Scalar[i][j]) rect1Min[i] = rect1Scalar[i][j];
            if (rect2Min[i] > rect2Scalar[i][j]) rect2Min[i] = rect2Scalar[i][j];
        }
    }
 
    // Check if any segment don't overlap
    for (int i = 0; i < 4; i++) {
        if (!(rect2Min[i] <= rect1Max[i] && rect2Max[i] >= rect1Min[i])) return false;
    }
 
    return true;
}

Here is the caller graph for this function:

◆ RotateLocal()

wxPoint2DDouble Element::RotateLocal	(	wxPoint2DDouble	local,
		double	angleDeg
	)		const

virtual

Definition at line 308 of file Element.cpp.

{
    double rad = wxDegToRad(angleDeg);
    double c = std::cos(rad);
    double s = std::sin(rad);
 
    return wxPoint2DDouble(
        c * local.m_x - s * local.m_y,
        s * local.m_x + c * local.m_y
    );
}

◆ RotateNode()

virtual void Element::RotateNode	(	Element *	parent,
		bool	clockwise = `true`
	)

inlinevirtual

Rotate a node.

Parameters

parent	Node's parent.
clockwise	True to rotate clockwise, false to rotate counter-clockwise.

Reimplemented in Transformer, Branch, Line, Machines, and Shunt.

Definition at line 390 of file Element.h.

390{}

◆ SaveCADProperties()

void Element::SaveCADProperties	(	rapidxml::xml_document<> &	doc,
		rapidxml::xml_node<> *	elementNode
	)

Definition at line 653 of file Element.cpp.

{
    auto cadProp = XMLParser::AppendNode(doc, elementNode, "CADProperties");
    auto position = XMLParser::AppendNode(doc, cadProp, "Position");
    auto posX = XMLParser::AppendNode(doc, position, "X");
    XMLParser::SetNodeValue(doc, posX, m_position.m_x);
    auto posY = XMLParser::AppendNode(doc, position, "Y");
    XMLParser::SetNodeValue(doc, posY, m_position.m_y);
    auto size = XMLParser::AppendNode(doc, cadProp, "Size");
    auto width = XMLParser::AppendNode(doc, size, "Width");
    XMLParser::SetNodeValue(doc, width, m_width);
    auto height = XMLParser::AppendNode(doc, size, "Height");
    XMLParser::SetNodeValue(doc, height, m_height);
    auto angle = XMLParser::AppendNode(doc, cadProp, "Angle");
    XMLParser::SetNodeValue(doc, angle, m_angle);
}

◆ SaveElement()

virtual rapidxml::xml_node * Element::SaveElement	(	rapidxml::xml_document<> &	doc,
		rapidxml::xml_node<> *	elementListNode
	)

inlinevirtual

Definition at line 641 of file Element.h.

641{ return nullptr; }

◆ SetAngle()

void Element::SetAngle ( double angle )

inline

Set element angle.

Parameters

angle Angle value in degrees.

Definition at line 157 of file Element.h.

157{ m_angle = angle; }

◆ SetBorderSize()

void Element::SetBorderSize ( double borderSize )

inline

Set the size of the border (shown in selected elements).

Parameters

borderSize Border size.

Definition at line 167 of file Element.h.

167{ m_borderSize = borderSize; }

◆ SetChild()

void Element::SetChild	(	Element *	child,
		int	num
	)

inline

Definition at line 365 of file Element.h.

365{ m_childList[num] = child; }

◆ SetDragging()

void Element::SetDragging ( bool dragging = true )

inline

Set if the element are being dragged.

Parameters

dragging True if is dragging, false otherwise.

Definition at line 131 of file Element.h.

131{ m_dragging = dragging; }

◆ SetHeight()

void Element::SetHeight ( double height )

inline

Set element height.

Parameters

height Height value.

Definition at line 136 of file Element.h.

136{ m_height = height; }

◆ SetID()

virtual void Element::SetID ( int id )

inlinevirtual

Set the element ID.

Parameters

id	Element ID.

Definition at line 270 of file Element.h.

270{ m_elementID = id; }

◆ SetInserted()

void Element::SetInserted ( bool inserted = true )

inline

Set if the element is properly inserted in the workspace.

Parameters

inserted true if is inserted properly, false otherwise

Definition at line 639 of file Element.h.

639{ m_inserted = inserted; }

Here is the caller graph for this function:

◆ SetNodeParent()

virtual bool Element::SetNodeParent ( Element * parent )

inlinevirtual

Set a perent to the node. If all conditions are met, a new parent are added to the element and the points related to the nodes will be calculated.

Parameters

parent Node parent.

Returns: True if was possible to set the parent.

Reimplemented in Branch, Line, Machines, Shunt, and Transformer.

Definition at line 372 of file Element.h.

372{ return false; }

◆ SetOnline()

bool Element::SetOnline ( bool online = true )

Set if the element is online or offline.

Parameters

online True if online, false if offline.

Definition at line 465 of file Element.cpp.

{
    // Check if any parent is null.
    for (auto it = m_parentList.begin(); it != m_parentList.end(); it++) {
        if (!(*it)) return false;
    }
    m_online = online;
    return true;
}

◆ SetParent()

void Element::SetParent	(	Element *	parent,
		int	num
	)

inline

Definition at line 364 of file Element.h.

364{ m_parentList[num] = parent; }

◆ SetPointList()

virtual void Element::SetPointList ( std::vector< wxPoint2DDouble > pointList )

inlinevirtual

Set the list of points that connect the element to the bus.

Parameters

pointList List of points.

Reimplemented in Line.

Definition at line 178 of file Element.h.

178{ m_pointList = pointList; }

◆ SetPosition()

void Element::SetPosition ( const wxPoint2DDouble position )

Set the element position and update the rectangle.

Parameters

position Position value.

Definition at line 33 of file Element.cpp.

{
    m_position = position;
    m_rect =
        wxRect2DDouble(m_position.m_x - m_width / 2.0 - m_borderSize, m_position.m_y - m_height / 2.0 - m_borderSize,
            m_width + 2.0 * m_borderSize, m_height + 2.0 * m_borderSize);
}

Here is the caller graph for this function:

◆ SetSelected()

void Element::SetSelected ( bool selected = true )

inline

Set element selection.

Parameters

selected True if selected, false otherwise.

Definition at line 147 of file Element.h.

147{ m_selected = selected; }

◆ SetWidth()

void Element::SetWidth ( double width )

inline

Set element width.

Parameters

width Width value.

Definition at line 152 of file Element.h.

152{ m_width = width; }

◆ ShowForm()

virtual bool Element::ShowForm	(	wxWindow *	parent,
		Element *	element,
		wxWindow *	workspace = `nullptr`
	)

inlinevirtual

Show element data form.

Parameters

parent	Form parent
element	Element that will be edited.

Returns: True if the form is shown, false otherwise.

Reimplemented in Constant, Exponential, Gain, IOControl, Limiter, MathExpression, RateLimiter, Sum, TransferFunction, Bus, Capacitor, EMTElement, HarmCurrent, IndMotor, Inductor, Line, Load, SyncGenerator, SyncMotor, and Transformer.

Definition at line 595 of file Element.h.

595{ return false; }

◆ ShowPickbox()

void Element::ShowPickbox ( bool showPickbox = true )

inline

Set if the pickbox is shown.

Parameters

showPickbox True if show, false otherwise.

Definition at line 162 of file Element.h.

162{ m_showPickbox = showPickbox; }

◆ StartMove()

void Element::StartMove ( wxPoint2DDouble position )

virtual

Update the element attributes related to the movement.

Parameters

position Start move position.

Reimplemented in ConnectionLine, ControlElement, Branch, Line, Machines, Shunt, and Transformer.

Definition at line 335 of file Element.cpp.

{
    this->m_moveStartPt = position;
    this->m_movePos = m_position;
}

◆ StringFromDouble()

wxString Element::StringFromDouble	(	double	value,
		int	minDecimal = `1`,
		int	maxDecimals = `13`
	)

static

Convert a double value to string.

Parameters

value	Value to be converted.
minDecimal	Minimum number of decimal places.

Definition at line 548 of file Element.cpp.

{
    wxString str = wxString::FromCDouble(value, maxDecimals);
    int cutNumber = 0;
    int numDecimal = 0;
    bool foundCut = false;
    for (int i = (int)str.length() - 1; i >= 0; i--) {
        if (str[i] != '0' && !foundCut) {
            cutNumber = i;
            foundCut = true;
        }
        if (str[i] == '.') {
            numDecimal = i;
            break;
        }
    }
 
    wxString formatedStr = "";
    if (cutNumber - numDecimal > minDecimal)
        formatedStr = wxString::FromDouble(value, cutNumber - numDecimal);
    else
        formatedStr = wxString::FromDouble(value, minDecimal);
 
    return formatedStr;
}

Here is the caller graph for this function:

◆ UpdateNodes()

virtual void Element::UpdateNodes ( )

inlinevirtual

Update the nodes according to the parents. If a parent is removed, use this method.

Reimplemented in Branch, Machines, and Shunt.

Definition at line 362 of file Element.h.

362{}

◆ WorldToScreen() [1/2]

wxPoint2DDouble Element::WorldToScreen	(	wxPoint2DDouble	position,
		wxPoint2DDouble	translation,
		double	scale,
		double	offsetX = `0.0`,
		double	offsetY = `0.0`
	)		const

virtual

Convert a generic position to screen position.

Parameters

position	Position to be converted.
translation	System translation.
scale	System scale.
offsetX	Offset in X axis.
offsetY	Offset in Y axis.

Definition at line 360 of file Element.cpp.

{
    return wxPoint2DDouble(position.m_x + offsetX + translation.m_x, position.m_y + offsetY + translation.m_y) * scale;
}

◆ WorldToScreen() [2/2]

wxPoint2DDouble Element::WorldToScreen	(	wxPoint2DDouble	translation,
		double	scale,
		double	offsetX = `0.0`,
		double	offsetY = `0.0`
	)		const

virtual

Convert the element position to screen position.

Parameters

translation	System translation.
scale	System scale
offsetX	Offset in X axis.
offsetY	Offset if Y axis.

Definition at line 354 of file Element.cpp.

{
    return wxPoint2DDouble(m_position.m_x + offsetX + translation.m_x, m_position.m_y + offsetY + translation.m_y) *
        scale;
}

Here is the caller graph for this function:

Member Data Documentation

◆ m_activeNodeID

int Element::m_activeNodeID = 0

protected

Definition at line 669 of file Element.h.

◆ m_activePickboxID

int Element::m_activePickboxID = ID_PB_NONE

protected

Definition at line 668 of file Element.h.

◆ m_angle

double Element::m_angle = 0.0

protected

Definition at line 656 of file Element.h.

◆ m_borderSize

double Element::m_borderSize = 2.0

protected

Definition at line 657 of file Element.h.

◆ m_childList

std::vector<Element*> Element::m_childList

protected

Definition at line 650 of file Element.h.

◆ m_dragging

bool Element::m_dragging = false

protected

Definition at line 664 of file Element.h.

◆ m_elementID

int Element::m_elementID = 0

protected

Definition at line 648 of file Element.h.

◆ m_elementType

ElementType Element::m_elementType = ElementType::TYPE_NONE

protected

Definition at line 647 of file Element.h.

◆ m_height

double Element::m_height = 0.0

protected

Definition at line 655 of file Element.h.

◆ m_inserted

bool Element::m_inserted = false

protected

Definition at line 666 of file Element.h.

◆ m_movePos

wxPoint2DDouble Element::m_movePos

protected

Definition at line 675 of file Element.h.

◆ m_movePts

std::vector<wxPoint2DDouble> Element::m_movePts

protected

Definition at line 672 of file Element.h.

◆ m_moveStartPt

wxPoint2DDouble Element::m_moveStartPt

protected

Definition at line 674 of file Element.h.

◆ m_online

bool Element::m_online = true

protected

Definition at line 677 of file Element.h.

◆ m_parentList

std::vector<Element*> Element::m_parentList

protected

Definition at line 649 of file Element.h.

◆ m_pointList

std::vector<wxPoint2DDouble> Element::m_pointList

protected

Definition at line 671 of file Element.h.

◆ m_position

wxPoint2DDouble Element::m_position

protected

Definition at line 653 of file Element.h.

◆ m_rect

wxRect2DDouble Element::m_rect

protected

Definition at line 652 of file Element.h.

◆ m_rotationAngle

double Element::m_rotationAngle = 45.0

protected

Definition at line 658 of file Element.h.

◆ m_selected

bool Element::m_selected = false

protected

Definition at line 663 of file Element.h.

◆ m_showPickbox

bool Element::m_showPickbox = false

protected

Definition at line 665 of file Element.h.

◆ m_switchRect

std::vector<wxRect2DDouble> Element::m_switchRect

protected

Definition at line 661 of file Element.h.

◆ m_switchSize

double Element::m_switchSize = 10.0

protected

Definition at line 659 of file Element.h.

◆ m_width

double Element::m_width = 0.0

protected

Definition at line 654 of file Element.h.

The documentation for this class was generated from the following files:

Project/elements/Element.h
Project/elements/Element.cpp

Public Member Functions

Static Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ Element()

◆ ~Element()

Member Function Documentation

◆ AddChild()

◆ AddParent() [1/2]

◆ AddParent() [2/2]

◆ AddPoint()

◆ AlignToGrid()

◆ CalculateBoundaries()

◆ Contains()

◆ DoubleFromString()

◆ DrawDC() [1/2]

◆ DrawDC() [2/2]

◆ DrawDCArc() [1/2]

◆ DrawDCArc() [2/2]

◆ DrawDCCircle() [1/2]

◆ DrawDCCircle() [2/2]

◆ DrawDCPickbox()

◆ DrawDCRectangle()

◆ DrawDCRoundedRectRotated()

◆ DrawDCTriangle() [1/2]

◆ DrawDCTriangle() [2/2]

◆ DrawStabilityEventGC()

◆ GeneralMenuItens()

◆ GetAngle()

◆ GetBestPickboxCursor()

◆ GetChildList()

◆ GetContextMenu()

◆ GetCopy()

◆ GetElementType()

◆ GetHeight()

◆ GetID()

◆ GetMovePosition()

◆ GetMoveStartPosition()

◆ GetParentList()

◆ GetPointList()

◆ GetPointListRef()

◆ GetPosition()

◆ GetRect()

◆ GetRotationAngle()

◆ GetTipText()

◆ GetWidth()

◆ Intersects()

◆ IntFromString()

◆ IsDragging()

◆ IsInserted()

◆ IsOnline()

◆ IsPickboxShown()

◆ IsSelected()

◆ Move()

◆ MoveNode()

◆ MovePickbox()

◆ NodeContains()

◆ OpenCADProperties()

◆ OpenElement()

◆ PickboxContains()

◆ PointToLineDistance()

◆ RemoveChild()

◆ RemoveParent()

◆ ReplaceChild()

◆ ReplaceParent()

◆ ResetNodes()

◆ ResetPickboxes()

◆ Rotate()

◆ RotateAround()

◆ RotateAtPosition()

◆ RotatedRectanglesIntersects()

◆ RotateLocal()

◆ RotateNode()

◆ SaveCADProperties()

◆ SaveElement()

◆ SetAngle()

◆ SetBorderSize()

◆ SetChild()

◆ SetDragging()