Found |
This class holds the data of a transition found by image processing.
Strictly speaking a transition is a point where a gray value matches
a threshold on a scan line in a region of interest. The scan line
should be perpendicular to an edge that is the goal to be find.
The transition line is defined as the perpendicular line to the scan
line that goes through the transition point TP. The intersection points
of the transition line with the region of interest will be calculated;
these points are P1 and P2.
Using this line between P1 and P2 allows us to reuse the line
detection algorithms for the transition calculations to some extent.
Therefore this class is derived from FoundLine.
SlStartP
+---------------------------------------------o----------------------------+
| Region of interest / |
| / |
| / |
| / |
| Base point o------------- |
| /angle| |
| /_____/ |
| / |
| / Scan line |
| / |
o P1 |/_ Scan direction |
| o / |
| o /_ |
| #####o / \ |
| ############o TP / . | |
| ###################o / |
| ###################/######o |
| ##### Object ######/#############o |
| ###################/####################o Transition line |
| ###################/##### to find #############o |
| ###################/########################### o |
| ###################/########################### o |
+----------------------o------------------------------------------------o--+
SlEndP P2
Inheritance HierarchySystemObject
RAYLASE.Marker.JobElement.ImageProcessingBaseFoundImageProcessingObject
RAYLASE.Marker.JobElement.ImageProcessingFoundLine
RAYLASE.Marker.JobElement.ImageProcessingFoundTransition
RAYLASE.Marker.JobElement.ImageProcessingBaseFoundImageProcessingObject
RAYLASE.Marker.JobElement.ImageProcessingFoundLine
RAYLASE.Marker.JobElement.ImageProcessingFoundTransition
Namespace: RAYLASE.Marker.JobElement.ImageProcessing
Assembly: RAYLASE.Marker.JobElement (in RAYLASE.Marker.JobElement.dll) Version: 2.19.0
SyntaxC#
public class FoundTransition : FoundLine, IFoundObject
The FoundTransition type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | FoundTransition(FoundTransition) | Copy constructor. |
| FoundTransition(dvec3, Double, dvec3) | Constructs a transition based on the given point and an angle. |
| FoundTransition(Point, Point, dvec3) | Constructs the transition with the given points, sets z value to 0. |
| FoundTransition(dvec2, dvec2, dvec2, dvec3) | Constructs a transition based on the given two end points and the transition point. |
| FoundTransition(dvec3, dvec3, dvec3, Int32) | Constructs the transition. Its point will be by default in the middle of the two given points |
Properties| Name | Description | |
|---|---|---|
 | Angle |
The angle between the x axis and the line in rad, measured
counter clockwise, in the range [-pi,+pi]. (Same as "Alpha"
in the sketch above.)
(Inherited from FoundLine) |
| Area |
The area enclosed of the object's contour.
(Inherited from BaseFoundImageProcessingObject) |
| AveGrayValue | The average gray value on the whole scan line. |
| Center |
The center (midpoint) of the line.
(Inherited from FoundLine) |
| DistanceToOrigin | (Inherited from FoundLine) |
| DistanceToRoiCenter |
The distance between the found object's center and the center
of the region of interest in which the object has been found.
(Inherited from BaseFoundImageProcessingObject) |
| FilterFields |
Only for the GUI: This array controls which properties in the result
output will have a funnel for transferring a value range around the
current value into the filter/selection group. If empty, all
relevant properties will have a funnel.
(Inherited from FoundLine) |
| GrayValue | The gray value of the transition point. |
| GrayValueRange | The gray value range (MaxGrayValue-MinGrayValue) on the whole scan line. |
| ImageIndex |
The image processing plug-in has a ring buffer array of images
where the result of an object finding process is stored. This
index is stored here.
(Inherited from BaseFoundImageProcessingObject) |
| Length |
The length of the line.
(Inherited from FoundLine) |
| MaxGrayValue | The maximal gray value on the whole scan line. |
| MinGrayValue | The minimal gray value on the whole scan line. |
| ObjectColor |
The color a found object will have when drawn in a result image.
(Inherited from BaseFoundImageProcessingObject) |
| ObjectFields |
The list of the relevant parameters and their values in the result output.
(Inherited from FoundLine) |
| ObjectText |
The list of parameters and their values as string for showing in the GUI.
(Inherited from FoundLine) |
| ObjectTypeTitle | The title of an object entry in the list of results. |
| ObjectUnit |
The unit the found object's coordinate are in. Pixel or millimeter.
(Inherited from BaseFoundImageProcessingObject) |
| P1 |
The first point of the line.
(Inherited from FoundLine) |
| P2 |
The second point of the line.
(Inherited from FoundLine) |
| Phi |
The angle between the normal of the line and the x axis as used in
the Hessian normal form.
(Inherited from FoundLine) |
| PlumbPoint |
This is the point with the shortest distance between the line and
the origin.
(Inherited from FoundLine) |
| Point1 |
The first point of the line as type System.Drawing.Point.
(Inherited from FoundLine) |
| Point2 |
The second point of the line as type System.Drawing.Point.
(Inherited from FoundLine) |
| R |
The distance R between the origin and the line as used in the
Hessian normal form.
(Inherited from FoundLine) |
| RoiCenter |
The center of the region of interest in which the object has been
found in micrometers in world coordinates in the workspace's
coordinate system.
(Inherited from BaseFoundImageProcessingObject) |
| ScanPosition | The position of the scan line in x direction as percentage of the distance between P1 and P2 in the range of 0..100. |
| SearchNo |
The sequential number of the search which is done during the image
processing job. I. e. an identifier for the 1st, 2nd or 3rd search
an object has been found in; the value is 1, 2 or 3.
(Inherited from BaseFoundImageProcessingObject) |
| Size |
The size of the (possibly rotated) bounding box around the object.
(Inherited from BaseFoundImageProcessingObject) |
| TransitionPoint | The point where the scan line intersects with the found object. I. e. where the gray value along the scan line meets the defined condition. |
 | UnitFactor |
Unit factor to convert micrometers into millimeters in case the unit is not pixel.
(Inherited from BaseFoundImageProcessingObject) |
Methods| Name | Description | |
|---|---|---|
| AngleBetween |
Retrieves the angle, expressed in degrees, between the two specified lines.
(Inherited from FoundLine) |
| CalcDistance(dvec3) |
Calculates the distance between this line and the given point p.
(Inherited from FoundLine) |
| CalcDistance(PointF) |
Calculates the distance between this line and the given point p.
(Inherited from FoundLine) |
| CalcDistance(FoundLine, Boolean, dvec3) |
Distance between two lines:
The distance between two parallel lines 1 and 2 is just the
difference R2-R1. This calculation turned out to be instable in case
the angles of the lines differ too much. Too much can mean rather
small angles if R is big. Therefore another distance definition is
used if the flag isMidpointBased is true:
This line is the base line which defines the Angle. The given
"other" line in the argument is the line we want the distance to
know with its start and end points P1 and P2. For the "other line" the
mid point M is calculated, and its distance D to the plumb point will
be returned as the distance between the lines.
(Inherited from FoundLine) |
| CalcIntersectionPoint(FoundLine, PointF) |
Calculates the intersection point of this line with the given line.
(Inherited from FoundLine) |
| CalcIntersectionPoint(FoundLine, Nullabledvec3, Double) |
Calculates the intersection point of this line with the given line.
(Inherited from FoundLine) |
| CloneDeep | (Overrides FoundLineCloneDeep) |
| GetBorderPoints |
Calculates to this line the intersection points P1 and P2 with the
given quadrangle.
/ Line
/
P1 /
+-----------+---------+
\ / |
\ / |
\ / Quad- |
\ / +
\ / rangle /
P2 + /
/ \ /
/ \ /
/ \ /
/ \ /
\ /
\ /
+(Inherited from FoundLine) |
| GetTransitionPointCross(Double, dvec2, dvec2, dvec2, dvec2) | The same as the overload, but returning dvec2 points but Points. |
| GetTransitionPointCross(Double, Point, Point, Point, Point) |
Calculates four points p1, p2, p3, p4 around the transition point
in distance size forming a cross along the transition line defined
by P1 and P2.
P1 /
o + p3
o p1 /
+ /
oTP p2 o
/ + P2 /
/ o /
+ p4 / size
/ /
/
o |
| IsCenterEqual |
Checks if this object has the same center as the other object.
(Inherited from BaseFoundImageProcessingObject) |
| LinearFunction |
Calculates the gradient and y-intercept of the straight line.
(Inherited from FoundLine) |
 | SetFilter |
Only for the GUI: Sets a funnel button in front of the displayed property in
the result list when the property name is contained in the given string
array. The button transfers a value range around the property value into
the according value range fields in the dialog.
(Inherited from BaseFoundImageProcessingObject) |
| ToString |
Returns the list of all relevant properties as combined string.
(Inherited from BaseFoundImageProcessingObject) |
| Vector |
Returns from the two points P1 and P2 of the line the vector P1-P2.
(Inherited from FoundLine) |
Fields| Name | Description | |
|---|---|---|
 | _angle |
The angle, measured counter clockwise, between the object (in case
of a line) or its bounding box and the x axis.
(Inherited from BaseFoundImageProcessingObject) |
| _area |
The area enclosed by the object's contour.
(Inherited from BaseFoundImageProcessingObject) |
| _center |
The center point of the object.
(Inherited from BaseFoundImageProcessingObject) |
| _length |
The length or circumference of the object's contour.
(Inherited from BaseFoundImageProcessingObject) |
See Also