KLayout Manual: Main Index » Class Index » API reference - Class DTrans

API reference - Class DTrans

Description: A simple transformation

Public constructors
Public methods
Public static methods and constants
Deprecated methods (protected, public, static, non-static and constructors)
Detailed description

The simple transformation applies a displacement vector and a simple fixpoint transformation. This version acts on double coordinates.

Public constructors

new DTrans	new		Creates a unit transformation
new DTrans	new	(int f)	Conversion constructor from a fixpoint transformation
new DTrans	new	(int rot, bool mirr, DPoint u)	The standard constructor using angle and mirror flag
new DTrans	new	(int rot, bool mirr, double x, double y)	The standard constructor using angle and mirror flag and two coordinate values for displacement
new DTrans	new	(int f, const DPoint u)	The standard constructor using a code rather than angle and mirror
new DTrans	new	(int f, double x, double y)	The standard constructor using a code rather than angle and mirror and two coordinate values for displacement
new DTrans	new	(const DPoint u)	The standard constructor using a displacement only
new DTrans	new	(double x, double y)	The standard constructor using a displacement given as two coordinates

Public methods

[const]	bool	!=	(const DTrans arg1)	Inequality test
[const]	DTrans	*	(const DTrans *)	Multiplication (concatenation) of transformations
[const]	bool	<	(const DTrans arg1)	A sorting criterion
[const]	bool	==	(const DTrans arg1)	Equality test
[const]	int	angle		Gets the angle in units of 90 degree
	void	angle=	(int a)	Sets the angle in units of 90 degree
[const]	void	assign	(const DTrans other)	Assign the contents of another object to self
	void	create		Ensures the C++ object is created
[const]	double	ctrans	(double d)	The transformation of a distance
	void	destroy		Explicitly destroy the object
[const]	bool	destroyed?		Returns a value indicating whether the object was already destroyed
[const]	DPoint	disp		Accessor to the point
	void	disp=	(const DPoint u)	Sets the displacement
[const]	DTrans	dup		Creates a copy of self
	DTrans	invert		In-place inversion
[const]	DTrans	inverted		Inversion
[const]	bool	is_const_object?		Returns a value indicating whether the reference is a const reference
[const]	bool	is_mirror?		Gets the mirror flag
	void	mirror=	(bool m)	Sets the mirror flag
[const]	int	rot		Gets the angle/mirror code
	void	rot=	(int r)	Sets the angle/mirror code
[const]	string	to_s		String conversion
[const]	DPoint	trans	(const DPoint p)	The transformation of a point

Public static methods and constants

int	M0		Angle/mirror code for the "mirrored at the x-axis" transformation
int	M135		Angle/mirror code for the "mirrored at the 135 degree axis" transformation
int	M45		Angle/mirror code for the "mirrored at the 45 degree axis" transformation
int	M90		Angle/mirror code for the "mirrored at the y (90 degree) axis" transformation
int	R0		Angle/mirror code for the "unrotated" transformation
int	R180		Angle/mirror code for the "rotated by 180 degree counterclockwise" transformation
int	R270		Angle/mirror code for the "rotated by 270 degree counterclockwise" transformation
int	R90		Angle/mirror code for the "rotated by 90 degree counterclockwise" transformation
DTrans	from_itrans	(const Trans int_trans)	Conversion constructor from an integer coordinate transformation

Deprecated methods (protected, public, static, non-static and constructors)

[static]	int	m0		Use of this method is deprecated. Use M0 instead
[static]	int	m135		Use of this method is deprecated. Use M135 instead
[static]	int	m45		Use of this method is deprecated. Use M45 instead
[static]	int	m90		Use of this method is deprecated. Use M90 instead
[static]	new DTrans	new_f	(int f)	Use of this method is deprecated. Use new instead
[static]	new DTrans	new_fu	(int f, const DPoint u)	Use of this method is deprecated. Use new instead
[static]	new DTrans	new_fxy	(int f, double x, double y)	Use of this method is deprecated. Use new instead
[static]	new DTrans	new_rmu	(int rot, bool mirr, DPoint u)	Use of this method is deprecated. Use new instead
[static]	new DTrans	new_rmxy	(int rot, bool mirr, double x, double y)	Use of this method is deprecated. Use new instead
[static]	new DTrans	new_u	(const DPoint u)	Use of this method is deprecated. Use new instead
[static]	new DTrans	new_xy	(double x, double y)	Use of this method is deprecated. Use new instead
[static]	int	r0		Use of this method is deprecated. Use R0 instead
[static]	int	r180		Use of this method is deprecated. Use R180 instead
[static]	int	r270		Use of this method is deprecated. Use R270 instead
[static]	int	r90		Use of this method is deprecated. Use R90 instead

Detailed description

[const] bool !=(const DTrans arg1)

Description: Inequality test

[const] DTrans (const DTrans )

Description: Multiplication (concatenation) of transformations

t:	The transformation to apply before
Returns:	The modified transformation

The * operator returns self*t ("t is applied before this transformation").

[const] bool <(const DTrans arg1)

Description: A sorting criterion

[const] bool ==(const DTrans arg1)

Description: Equality test

[static] int M0

Description: Angle/mirror code for the "mirrored at the x-axis" transformation

[static] int M135

Description: Angle/mirror code for the "mirrored at the 135 degree axis" transformation

[static] int M45

Description: Angle/mirror code for the "mirrored at the 45 degree axis" transformation

[static] int M90

Description: Angle/mirror code for the "mirrored at the y (90 degree) axis" transformation

[static] int R0

Description: Angle/mirror code for the "unrotated" transformation

[static] int R180

Description: Angle/mirror code for the "rotated by 180 degree counterclockwise" transformation

[static] int R270

Description: Angle/mirror code for the "rotated by 270 degree counterclockwise" transformation

[static] int R90

Description: Angle/mirror code for the "rotated by 90 degree counterclockwise" transformation

[const] int angle

Description: Gets the angle in units of 90 degree

This value delivers the rotation component. In addition, a mirroring at the x axis may be applied before if the is_mirror? property is true.

void angle=(int a)

Description: Sets the angle in units of 90 degree

a:	The new angle

This method was introduced in version 0.20.

[const] void assign(const DTrans other)

Description: Assign the contents of another object to self

This method assigns the contents of another object to self. This is a deep copy that does not only copy the reference but the actual content.

void create

Description: Ensures the C++ object is created

Use this method to ensure the C++ object is created, for example to ensure that resources are allocated. Usually C++ objects are created on demand and not necessarily when the script object is created.

[const] double ctrans(double d)

Description: The transformation of a distance

d:	The distance to transform
Returns:	The transformed distance

The "ctrans" method transforms the given distance. e = t(d). For the simple transformations, there is no magnification and no modification of the distance therefore.

void destroy

Description: Explicitly destroy the object

Explicitly destroy the object on C++ side if it was owned by the Ruby interpreter. Subsequent access to this object will throw an exception. If the object is not owned by Ruby, this method will do nothing.

[const] bool destroyed?

Description: Returns a value indicating whether the object was already destroyed

This method returns true, if the object was destroyed, either explicitly or by the C++ side. The latter may happen, if the object is owned by a C++ object which got destroyed itself.

[const] DPoint disp

Description: Accessor to the point

void disp=(const DPoint u)

Description: Sets the displacement

u:	The new displacement

This method was introduced in version 0.20.

[const] DTrans dup

Description: Creates a copy of self

[static] DTrans from_itrans(const Trans int_trans)

Description: Conversion constructor from an integer coordinate transformation

DTrans invert

Description: In-place inversion

Returns:

The inverted transformation

Inverts the transformation and replaces this object by the inverted one.

[const] DTrans inverted

Description: Inversion

Returns:

The inverted transformation

Returns the inverted transformation

[const] bool is_const_object?

Description: Returns a value indicating whether the reference is a const reference

This method returns true, if self is a const reference. In that case, only const methods may be called on self.

[const] bool is_mirror?

Description: Gets the mirror flag

If this property is true, the transformation is composed of a mirroring at the x-axis followed by a rotation by the angle given by the angle property.

[static] int m0

Description: Angle/mirror code for the "mirrored at the x-axis" transformation

This method is deprecated. Use method 'M0' instead

[static] int m135

Description: Angle/mirror code for the "mirrored at the 135 degree axis" transformation

This method is deprecated. Use method 'M135' instead

[static] int m45

Description: Angle/mirror code for the "mirrored at the 45 degree axis" transformation

This method is deprecated. Use method 'M45' instead

[static] int m90

Description: Angle/mirror code for the "mirrored at the y (90 degree) axis" transformation

This method is deprecated. Use method 'M90' instead

void mirror=(bool m)

Description: Sets the mirror flag

m:	The new mirror flag

"mirroring" describes a reflection at the x-axis which is included in the transformation prior to rotation.

This method was introduced in version 0.20.

[static] new DTrans new

Description: Creates a unit transformation

[static] new DTrans new(int f)

Description: Conversion constructor from a fixpoint transformation

f:	The rotation/mirror code (r0 .. m135 constants)

This constructor will create a transformation with a fixpoint transformation but no displacement.

[static] new DTrans new(int rot,bool mirr,DPoint u)

Description: The standard constructor using angle and mirror flag

rot:	The rotation in units of 90 degree
mirrx:	True, if mirrored at x axis
u:	The displacement

The sequence of operations is: mirroring at x axis, rotation, application of displacement.

[static] new DTrans new(int rot,bool mirr,double x,double y)

Description: The standard constructor using angle and mirror flag and two coordinate values for displacement

rot:	The rotation in units of 90 degree
mirrx:	True, if mirrored at x axis
x:	The horizontal displacement
y:	The vertical displacement

The sequence of operations is: mirroring at x axis, rotation, application of displacement.

[static] new DTrans new(int f,const DPoint u)

Description: The standard constructor using a code rather than angle and mirror

f:	The rotation/mirror code (r0 .. m135 constants)
u:	The displacement

[static] new DTrans new(int f,double x,double y)

Description: The standard constructor using a code rather than angle and mirror and two coordinate values for displacement

f:	The rotation/mirror code (r0 .. m135 constants)
x:	The horizontal displacement
y:	The vertical displacement

[static] new DTrans new(const DPoint u)

Description: The standard constructor using a displacement only

u:	The displacement

[static] new DTrans new(double x,double y)

Description: The standard constructor using a displacement given as two coordinates

x:	The horizontal displacement
y:	The vertical displacement