RectangularRegion Class Reference

This class is subject to change. Programs using this class may require changes with a new version of VirtualLab.
Class which describes a rectangular region which may be situated at an arbitrary center and which may be rotated by an arbitrary angle. More...

Inheritance diagram for RectangularRegion:

Public Member Functions
override double	CalculateDistanceOfPointToRegionBorder (VectorD point)
	Calculates the distance of a point to the border of this region. More...
override object	Clone ()
	Deep copy of the object. More...
override bool	Equals (object obj, EqualityIntent equalityIntent)
	Equality operator. More...
override InsideOutside	GetInOutRelation (VectorD point, ExtrapolationInfo extrapolation2use=null)
	Method which checks whether or not a point lies inside or outside the 2D region or on its boundary. More...
override void	MayBeNonzeroOutside (out bool maybeNonZeroLeft, out bool maybeNonZeroRight, out bool maybeNonZeroBottom, out bool maybeNonZeroTop)
	Method which determines whether or not the region can provide "inside" state outside of its boundary interval. This is not the case for extrapolation mode 'ConstantZero', of course. More...
	RectangularRegion ()
	Default constructor, creating a a non-rotated rectangle of 10mm x 5mm and centered at (0,0).
	RectangularRegion (RectanglePhysical rectangle, bool boundariesAreInside)
	Constructor which creates region from RectanglePhysical More...
	RectangularRegion (RectangularRegion rectRegion)
	Copy constructor More...
	RectangularRegion (SerializationInfo info, StreamingContext context)
	Deserialization constructor. See the ISerializable interface for more details. More...
	RectangularRegion (VectorD location, double width, double height, double angle, bool bottomLeftCoordinateInsteadOfCenterGiven, bool boundaryIsInside=false, PhysicalProperty propertyOfCoordinatesX=PhysicalProperty.Length, PhysicalProperty propertyOfCoordinatesY=PhysicalProperty.Length)
	Constructor with all field parameters. More...
override void	UpdatePropertyOfCoordinates ()
	Method for handling update after change of the physical property of the coordinate
Public Member Functions inherited from ElementaryRegion2D
abstract double	CalculateDistanceOfPointToRegionBorder (VectorD point)
	Calculates the distance of a point to the border of this region. More...
	ElementaryRegion2D (bool boundariesAreInside, PhysicalProperty propertyOfCoordinatesX=PhysicalProperty.Length, PhysicalProperty propertyOfCoordinatesY=PhysicalProperty.Length)
	Constructor which gets the _boundariesAreInside flag. To be called from derived classes constructors. More...
	ElementaryRegion2D (ElementaryRegion2D region2bCopied)
	Copy constructor. More...
	ElementaryRegion2D (SerializationInfo info, StreamingContext context)
	Deserialization constructor. See the ISerializable interface for more details. More...
Public Member Functions inherited from Region2D
override object	Clone ()
	Clones the current object. More...
override bool	Equals (object obj, EqualityIntent equalityIntent)
	Equality operation More...
abstract InsideOutside	GetInOutRelation (VectorD point, ExtrapolationInfo extrapolation2use=null)
	Method which checks whether or not a point lies inside or outside the 2D region or on its boundary. More...
bool	IsInside (double pointX, double pointY)
	Method which checks whether or not a point is inside the 2D region. More...
bool	IsInside (VectorD point)
	Method which checks whether or not a point is inside the 2D region. More...
abstract void	MayBeNonzeroOutside (out bool maybeNonZeroLeft, out bool maybeNonZeroRight, out bool maybeNonZeroBottom, out bool maybeNonZeroTop)
	Method which determines whether or not the region can provide "inside" state outside of its boundary interval. This is not the case for extrapolation mode 'ConstantZero', of course. More...
	Region2D (bool boundariesAreInside, PhysicalProperty propertyOfCoordinatesX=PhysicalProperty.Length, PhysicalProperty propertyOfCoordinatesY=PhysicalProperty.Length)
	Constructor which gets the _boundariesAreInside flag. To be called from derived classes constructors. More...
	Region2D (Region2D region2bCopied)
	Copy constructor. More...
	Region2D (SerializationInfo info, StreamingContext context)
	Deserialization constructor. See the ISerializable interface for more details. More...
virtual void	UpdatePropertyOfCoordinates ()
	Method for handling update after change of the physical property of the coordinate
bool	Equals (object otherObject, EqualityIntent equalityIntent)
	Determines whether the specified Object is equal to this instance. More...
Public Member Functions inherited from IDocument
void	Reload ()
	Reload function for the document

Static Public Member Functions
static implicit	operator SimplePolygon (RectangularRegion rectangularRegion)
	Implicit cast from rectangle to simple polygon. More...
static bool	operator!= (RectangularRegion o1, RectangularRegion o2)
	Unequals operator. More...
static bool	operator== (RectangularRegion o1, RectangularRegion o2)
	Equals operator More...
Static Public Member Functions inherited from ElementaryRegion2D
static bool	operator!= (ElementaryRegion2D o1, ElementaryRegion2D o2)
	Unequals operator. More...
static bool	operator== (ElementaryRegion2D o1, ElementaryRegion2D o2)
	Equals operator More...
Static Public Member Functions inherited from Region2D
static Region2D	InvertRegion (Region2D region2Invert)
	Creates a new region with inverted in / out regions compared to this. More...
static Region2D	Load (string fileName)
	Loads the specified file name. Works independently from whether the document has been saved without view settings (as prior to VL 6.0) or with view settings. More...
static bool	operator!= (Region2D o1, Region2D o2)
	Unequals operator. More...
static bool	operator== (Region2D o1, Region2D o2)
	Equals operator More...

Static Public Attributes
const string	VertexNameLowerLeft
	Standard vertex name for lower left vertices in equidistant segmentation of polygons.
const string	VertexNameLowerRight
	Standard vertex name for lower right vertices in equidistant segmentation of polygons.
const string	VertexNameUpperLeft
	Standard vertex name for upper left vertices in equidistant segmentation of polygons.
const string	VertexNameUpperRight
	Standard vertex name for upper right vertices in equidistant segmentation of polygons.
Static Public Attributes inherited from Region2D
const string	DefaultDocumentName
	The default document name (= type description) for an Order Collection.
static readonly string	FileDialogFilterString
	The filter string used in "Open File" dialogs.
const string	FileExtensionString
	The file extension for an Order Collection.

Properties
double	Angle [get, set]
	Gets the rotation angle in radian.
override RectanglePhysical	AxisAlignedBoundingBox [get]
	Gets the bounding box for the rect region. Its sides are parallel to the x- and y-axis resp. So this bounding box is identical to the region itself only in case of a rotation angle of 0 or 180 degrees.
VectorD	Center [get, set]
	Gets the center of the rectangle.
double	Height [get, set]
	Gets the height of the rectangle.
virtual List< Parameter >	ParameterRunParameters [get]
	Gets all available parameters. For variable parameters (i.e. those double and int parameters which can be used in the Parameter Run, Parametric Optimization and so on) add a VaryParameterInfo object (derived from Parameter class) to the returned list.
VectorD[]	VerticesConsideringRotation [get]
	Gets the four vertices of the rectangle considering its rotation by AngleInDegrees.
double	Width [get, set]
	Gets the width of the rectangle.
Properties inherited from Region2D
abstract RectanglePhysical	AxisAlignedBoundingBox [get]
	Gets the bounding box for the 2D region. Its sides are parallel to the x- and y-axis resp.
bool	BoundariesAreInside [get, set]
	Gets or sets whether or not the boundaries of the region belong to the inner region.
string	CommentOfCoordinates_X [get, set]
	Gets and sets the comment for the x-coordinates.
string	CommentOfCoordinates_Y [get, set]
	Gets and sets the comment for the y-coordinates.
ExtrapolationInfo	ExtrapolationHandling [get, set]
	The extrapolation mode for this region. See ITN.064 for more information on the mode 'border continuation'.
bool	IsOneD [get]
	Gets whether this IRegion1D2D is 1D or 2D
string	Name [get, set]
	The name which can be given to the region by the user.
PhysicalProperty	PropertyOfCoordinatesX [get, set]
	Physical property of the x-coordinates of the region
PhysicalProperty	PropertyOfCoordinatesY [get, set]
	Physical property of the y-coordinates of the region
Region2DType	RegionType [get]
	Gets the type of the region
SamplingParameters	SamplingForUsageWithComplexFields [get, set]
	Sampling parameters which will be used for a coordinate rescaling in case of using the region with a complex field.
Properties inherited from IRegion1D2D
bool	BoundariesAreInside [get, set]
	Gets or sets whether or not the boundaries of the region belong to the inner region.
bool	IsOneD [get]
	Gets whether this IRegion1D2D is 1D or 2D
string	Name [get, set]
	The name which can be given to the region by the user.
SamplingParameters	SamplingForUsageWithComplexFields [get, set]
	Sampling parameters which will be used for a coordinate rescaling in case of using the region with a complex field.
Properties inherited from IDocument
VirtualLabSession	Session [get, set]
	every documents need to be handled in a session ==> default is the VirtualLab Mainsession
NodeVLExplorer	TreeStructure [get]
	every document should have a node (maybe with subnodes) in the VirtualLab Explorer
DocumentType	TypeOfDocument [get]
	Gets an enum entry specifying the type of the document.

Detailed Description

This class is subject to change. Programs using this class may require changes with a new version of VirtualLab.
Class which describes a rectangular region which may be situated at an arbitrary center and which may be rotated by an arbitrary angle.

Constructor & Destructor Documentation

RectangularRegion() [1/4]

RectangularRegion	(	VectorD	location,
		double	width,
		double	height,
		double	angle,
		bool	bottomLeftCoordinateInsteadOfCenterGiven,
		bool	boundaryIsInside = false,
		PhysicalProperty	propertyOfCoordinatesX = PhysicalProperty.Length,
		PhysicalProperty	propertyOfCoordinatesY = PhysicalProperty.Length
	)

Constructor with all field parameters.

Parameters

location	The center of the rectangle in case bottomLeftCoordinateInsteadOfCenterGiven == false. Otherwise this parameter gives the bottom left corner.
width	Width of the rectangle.
height	Height of the rectangle.
angle	Rotation angle (in radians) of the rectangle: The rotation is done about the given location. The angle is defined between the width-side and the x-axis, as well as between the height-side and the y-axis.
bottomLeftCoordinateInsteadOfCenterGiven	If true, the first parameter is not the center but the bottom left corner of the unrotated rectangle. Important: The rotation by angle is done around the location, no matter if it is the center or not.
boundaryIsInside	Flag which says whether or not the boundary is part of the inner region or not.
propertyOfCoordinatesX	Physical property of the x-coordinate.
propertyOfCoordinatesY	Physical property of the y-coordinate.

RectangularRegion() [2/4]

RectangularRegion

(

RectangularRegion

rectRegion

)

Copy constructor

Parameters

rectRegion

The rectangular region to be copied.

RectangularRegion() [3/4]

RectangularRegion	(	RectanglePhysical	rectangle,
		bool	boundariesAreInside
	)

Constructor which creates region from RectanglePhysical

Parameters

rectangle	RectanglePhysical to be represented as region.
boundariesAreInside	If true, values lying exactly on the boundaries are considered as being 'inside' the region.

RectangularRegion() [4/4]

RectangularRegion	(	SerializationInfo	info,
		StreamingContext	context
	)

Deserialization constructor. See the ISerializable interface for more details.

Parameters

info	SerializationInfo
context	StreamingContext

Member Function Documentation

CalculateDistanceOfPointToRegionBorder()

override double CalculateDistanceOfPointToRegionBorder ( VectorD  point )

virtual

Calculates the distance of a point to the border of this region.

Parameters

point

Point to calculate the distance for.

Returns

The distance of the given point to the border of this region

Implements ElementaryRegion2D.

Clone()

override object Clone

(

)

Deep copy of the object.

Returns

A deep copy of this.

Equals()

override bool Equals	(	object	obj,
		EqualityIntent	equalityIntent
	)

Equality operator.

Parameters

obj
equalityIntent	Defines what kind of equality you want to check when comparing two objects, for example all values or physical equality.

Returns

Implements IRegion1D2D.

GetInOutRelation()

override InsideOutside GetInOutRelation ( VectorD  point, ExtrapolationInfo  extrapolation2use = null  )

virtual

Method which checks whether or not a point lies inside or outside the 2D region or on its boundary.

Parameters

point	The point to be checked whether it lies inside.
extrapolation2use	Extrapolation info actually to be used.

Returns

Information where the point lies in relation to the region.

Implements Region2D.

MayBeNonzeroOutside()

override void MayBeNonzeroOutside ( out bool  maybeNonZeroLeft, out bool  maybeNonZeroRight, out bool  maybeNonZeroBottom, out bool  maybeNonZeroTop  )

virtual

Method which determines whether or not the region can provide "inside" state outside of its boundary interval. This is not the case for extrapolation mode 'ConstantZero', of course.

Parameters

maybeNonZeroLeft	True, if there may be nonzero values left of the bounding box.
maybeNonZeroRight	True, if there may be nonzero values right of the bounding box.
maybeNonZeroBottom	True, if there may be nonzero values below the bottom of the bounding box.
maybeNonZeroTop	True, if there may be nonzero values above the top of the bounding box.

Implements Region2D.

operator SimplePolygon()

static implicit operator SimplePolygon ( RectangularRegion  rectangularRegion )

static

Implicit cast from rectangle to simple polygon.

Parameters

rectangularRegion

Rectangle to be converted into a polygon.

operator!=()

static bool operator!= ( RectangularRegion  o1, RectangularRegion  o2  )

static

Unequals operator.

Parameters

o1
o2

Returns

operator==()

static bool operator== ( RectangularRegion  o1, RectangularRegion  o2  )

static

Equals operator

Parameters

o1
o2

Returns