TRANSFORM Class Reference

for transforming drawing coordinates for a wxDC device context. More...

#include <transform.h>

Public Member Functions
	TRANSFORM ()
	The default construct creates a transform that draws object is the normal orientation. More...
	TRANSFORM (int ax1, int ay1, int ax2, int ay2)
bool	operator== (const TRANSFORM &aTransform) const
bool	operator!= (const TRANSFORM &aTransform) const
wxPoint	TransformCoordinate (const wxPoint &aPoint) const
	Calculate a new coordinate according to the mirror/rotation transform. More...
EDA_RECT	TransformCoordinate (const EDA_RECT &aRect) const
	Calculate a new rect according to the mirror/rotation transform. More...
TRANSFORM	InverseTransform () const
	Calculate the Inverse mirror/rotation transform. More...
bool	MapAngles (int *aAngle1, int *aAngle2) const
	Calculate new angles according to the transform. More...

Public Attributes
int	x1
int	y1
int	x2
int	y2

Detailed Description

for transforming drawing coordinates for a wxDC device context.

This probably should be a base class with all pure virtual methods and a WXDC_TRANSFORM derived class. Then in the future if some new device context is used, a new transform could be derived from the base class and all the drawable objects would have to do is provide overloaded draw methods to use the new transform.

Definition at line 45 of file transform.h.

Constructor & Destructor Documentation

TRANSFORM() [1/2]

TRANSFORM::TRANSFORM ( )

inline

The default construct creates a transform that draws object is the normal orientation.

Definition at line 56 of file transform.h.

: x1( 1 ), y1( 0 ), x2( 0 ), y2( -1 ) {}

TRANSFORM() [2/2]

TRANSFORM::TRANSFORM ( int  ax1, int  ay1, int  ax2, int  ay2  )

inline

Definition at line 58 of file transform.h.

: x1( ax1 ), y1( ay1 ), x2( ax2 ), y2( ay2 ) {}

Member Function Documentation

InverseTransform()

TRANSFORM TRANSFORM::InverseTransform

(

)

const

Calculate the Inverse mirror/rotation transform.

Useful to calculate coordinates relative to a symbol. which must be for a non rotated, non mirrored item from the actual coordinate.

Returns

The inverse transform.

Definition at line 57 of file transform.cpp.

{
    int invx1;
    int invx2;
    int invy1;
    int invy2;

    /* Calculates the inverse matrix coeffs:
     * for a matrix m{x1, x2, y1, y2}
     * the inverse matrix is 1/(x1*y2 -x2*y1) m{y2,-x2,-y1,x1)
     */
    int det = x1*y2 -x2*y1; // Is never null, because the inverse matrix exists
    invx1 = y2/det;
    invx2 = -x2/det;
    invy1 = -y1/det;
    invy2 = x1/det;

    TRANSFORM invtransform( invx1, invy1, invx2, invy2 );
    return invtransform;
}

References x1, x2, y1, and y2.

Referenced by SCH_SYMBOL::doIsConnected(), GetRelativePosition(), SCH_MOVE_TOOL::moveItem(), and SCH_FIELD::SetPosition().

MapAngles()

bool TRANSFORM::MapAngles	(	int *	aAngle1,
		int *	aAngle2
	)		const

Calculate new angles according to the transform.

Parameters

aAngle1	= The first angle to transform
aAngle2	= The second angle to transform

Returns

True if the angles were swapped during the transform.

Definition at line 79 of file transform.cpp.

{
    wxCHECK_MSG( aAngle1 != nullptr && aAngle2 != nullptr, false,
                 wxT( "Cannot map NULL point angles." ) );

    int    Angle, Delta;
    double x, y, t;
    bool   swap = false;

    Delta = *aAngle2 - *aAngle1;

    if( Delta >= 1800 )
    {
        *aAngle1 -= 1;
        *aAngle2 += 1;
    }

    x = cos( DECIDEG2RAD( *aAngle1 ) );
    y = sin( DECIDEG2RAD( *aAngle1 ) );
    t = x * x1 + y * y1;
    y = x * x2 + y * y2;
    x = t;
    *aAngle1 = KiROUND( RAD2DECIDEG( atan2( y, x ) ) );

    x = cos( DECIDEG2RAD( *aAngle2 ) );
    y = sin( DECIDEG2RAD( *aAngle2 ) );
    t = x * x1 + y * y1;
    y = x * x2 + y * y2;
    x = t;
    *aAngle2 = KiROUND( RAD2DECIDEG( atan2( y, x ) ) );

    NORMALIZE_ANGLE_POS( *aAngle1 );
    NORMALIZE_ANGLE_POS( *aAngle2 );

    if( *aAngle2 < *aAngle1 )
        *aAngle2 += 3600;

    if( *aAngle2 - *aAngle1 > 1800 ) // Need to swap the two angles
    {
        Angle   = (*aAngle1);
        *aAngle1 = (*aAngle2);
        *aAngle2 = Angle;

        NORMALIZE_ANGLE_POS( *aAngle1 );
        NORMALIZE_ANGLE_POS( *aAngle2 );

        if( *aAngle2 < *aAngle1 )
            *aAngle2 += 3600;

        swap = true;
    }

    if( Delta >= 1800 )
    {
        *aAngle1 += 1;
        *aAngle2 -= 1;
    }

    return swap;
}

References DECIDEG2RAD(), KiROUND(), NORMALIZE_ANGLE_POS(), RAD2DECIDEG(), x1, x2, y1, and y2.

Referenced by KIGFX::SCH_PAINTER::draw(), LIB_ARC::GetBoundingBox(), LIB_ARC::Plot(), and LIB_ARC::print().

operator!=()

bool TRANSFORM::operator!= ( const TRANSFORM &  aTransform ) const

inline

Definition at line 62 of file transform.h.

{ return !( *this == aTransform ); }

operator==()

bool TRANSFORM::operator==

(

const TRANSFORM &

aTransform

)

const

Definition at line 33 of file transform.cpp.

{
    return ( x1 == aTransform.x1 &&
             y1 == aTransform.y1 &&
             x2 == aTransform.x2 &&
             y2 == aTransform.y2 );
}

References x1, x2, y1, and y2.

TransformCoordinate() [1/2]

wxPoint TRANSFORM::TransformCoordinate

(

const wxPoint &

aPoint

)

const

Calculate a new coordinate according to the mirror/rotation transform.

Useful to calculate actual coordinates of a point from coordinates relative to a symbol. which are given for a non rotated, non mirrored item

Parameters

aPoint

= The position to transform

Returns

The transformed coordinate.

Definition at line 42 of file transform.cpp.

{
    return wxPoint( ( x1 * aPoint.x ) + ( y1 * aPoint.y ),
                    ( x2 * aPoint.x ) + ( y2 * aPoint.y ) );
}

References x1, x2, y1, and y2.

Referenced by SCH_SYMBOL::doIsConnected(), LIB_ARC::GetBoundingBox(), SCH_PIN::GetBoundingBox(), SCH_FIELD::GetBoundingBox(), SCH_SYMBOL::GetConnectionPoints(), SCH_SYMBOL::GetPinPhysicalPosition(), SCH_FIELD::GetPosition(), GetRelativePosition(), SCH_PIN::GetTransformedPosition(), LIB_CIRCLE::HitTest(), LIB_RECTANGLE::HitTest(), LIB_ARC::HitTest(), LIB_TEXT::HitTest(), LIB_BEZIER::HitTest(), LIB_POLYLINE::HitTest(), LIB_FIELD::HitTest(), SCH_MOVE_TOOL::moveItem(), LIB_PIN::PinDrawOrient(), LIB_CIRCLE::Plot(), LIB_RECTANGLE::Plot(), LIB_ARC::Plot(), LIB_BEZIER::Plot(), LIB_POLYLINE::Plot(), LIB_TEXT::Plot(), LIB_FIELD::Plot(), LIB_PIN::Plot(), LIB_BEZIER::print(), LIB_CIRCLE::print(), LIB_RECTANGLE::print(), LIB_POLYLINE::print(), LIB_ARC::print(), LIB_TEXT::print(), LIB_PIN::print(), LIB_FIELD::print(), SCH_FIELD::SetPosition(), ERC_TESTER::TestTextVars(), TransformCoordinate(), and SCH_SYMBOL::UpdateDanglingState().

TransformCoordinate() [2/2]

EDA_RECT TRANSFORM::TransformCoordinate

(

const EDA_RECT &

aRect

)

const

Calculate a new rect according to the mirror/rotation transform.

Useful to calculate actual coordinates of a point from coordinates relative to a symbol which are given for a non rotated, non mirrored item

Parameters

aRect

= The rectangle to transform

Returns

The transformed rectangle.

Definition at line 48 of file transform.cpp.

{
    EDA_RECT rect;
    rect.SetOrigin( TransformCoordinate( aRect.GetOrigin() ) );
    rect.SetEnd( TransformCoordinate( aRect.GetEnd() ) );
    return rect;
}

References EDA_RECT::GetEnd(), EDA_RECT::GetOrigin(), EDA_RECT::SetEnd(), EDA_RECT::SetOrigin(), and TransformCoordinate().

Member Data Documentation

x1

int TRANSFORM::x1

Definition at line 48 of file transform.h.

Referenced by SCH_SYMBOL::GetBodyBoundingBox(), LIB_TEXT::HitTest(), LIB_FIELD::HitTest(), InverseTransform(), SCH_LEGACY_PLUGIN::loadSymbol(), MapAngles(), operator==(), LIB_TEXT::Plot(), SCH_LEGACY_PLUGIN::saveSymbol(), SCH_SYMBOL::SetOrientation(), and TransformCoordinate().

x2

int TRANSFORM::x2

Definition at line 50 of file transform.h.

Referenced by SCH_SYMBOL::GetBodyBoundingBox(), InverseTransform(), SCH_LEGACY_PLUGIN::loadSymbol(), MapAngles(), operator==(), SCH_LEGACY_PLUGIN::saveSymbol(), SCH_SYMBOL::SetOrientation(), and TransformCoordinate().

y1

int TRANSFORM::y1

Definition at line 49 of file transform.h.

Referenced by AUTOPLACER::computeFBoxSize(), SCH_SYMBOL::GetBodyBoundingBox(), InverseTransform(), SCH_LEGACY_PLUGIN::loadSymbol(), MapAngles(), operator==(), LIB_FIELD::Plot(), SCH_FIELD::Plot(), LIB_TEXT::print(), SCH_FIELD::Print(), SCH_LEGACY_PLUGIN::saveSymbol(), SCH_SYMBOL::SetOrientation(), and TransformCoordinate().

y2

int TRANSFORM::y2

Definition at line 51 of file transform.h.

Referenced by SCH_SYMBOL::GetBodyBoundingBox(), InverseTransform(), SCH_LEGACY_PLUGIN::loadSymbol(), MapAngles(), operator==(), SCH_LEGACY_PLUGIN::saveSymbol(), SCH_SYMBOL::SetOrientation(), and TransformCoordinate().

---

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

• transform.h
• transform.cpp