add_metrology_object_ellipse_measureT_add_metrology_object_ellipse_measureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasure — Add an ellipse or an elliptic arc to a metrology model.
add_metrology_object_ellipse_measureadd_metrology_object_ellipse_measureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasure adds a metrology object
of type ellipse or elliptic arc to a metrology model and prepares the
rectangular measure regions. The handle of the model is passed in
MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle.
For an explanation of the concept of 2D metrology see the
introduction of chapter 2D Metrology.
The parameter specifies the angle at
the start point of an elliptic arc. The angle at the start point
is measured relative to the positive main axis specified with
PhiPhiPhiPhiphi and corresponds to the smallest surrounding circle
of the ellipse. The actual start point of the ellipse is the
intersection of the ellipse with the orthogonal projection of the
corresponding circle point onto the main axis. The angle refers
to the coordinate system of the ellipse, i.e., it is specified
relative to the main axis and in a mathematical positive
direction. Thus, the two main poles correspond to the
angles 0 and , the two minor poles to the
angle and . To create a
closed ellipse the value of the parameter 'start_phi'"start_phi""start_phi""start_phi""start_phi"
is set to 0 and the value of the parameter
'end_phi'"end_phi""end_phi""end_phi""end_phi" is set to (with positive
point order). The input value is mapped internally
automatically to the interval .
List of values:0.0, 0.78,
6.28318
Default value:0.0
'end_phi'"end_phi""end_phi""end_phi""end_phi":
The parameter specifies the angle at
the end point of an elliptic arc. The angle at the end point are
measured relative to the positive main axis specified with
PhiPhiPhiPhiphi and corresponds to the smallest surrounding circle
of the ellipse. The actual end point of the ellipse is the
intersection of the ellipse with the orthogonal projection of the
corresponding circle point onto the main axis. The angle refers
to the coordinate system of the ellipse, i.e., it is specified
relative to the main axis and in a mathematical positive direction.
Thus, the two main poles correspond to the
angles 0 and , the two minor poles to the
angle and . To create a
closed ellipse the value of the parameter 'start_phi'"start_phi""start_phi""start_phi""start_phi" is
set to 0 and the value of the parameter 'end_phi'"end_phi""end_phi""end_phi""end_phi"
is set to (with positive point order).
The input value is mapped automatically
to the interval .
The parameter specifies the direction
of the elliptic arc. For the value 'positive'"positive""positive""positive""positive", the elliptic
arc is defined between 'start_phi'"start_phi""start_phi""start_phi""start_phi" and 'end_phi'"end_phi""end_phi""end_phi""end_phi"
in mathematically positive direction (counterclockwise).
For the value 'negative'"negative""negative""negative""negative", the elliptic arc is defined
between 'start_phi'"start_phi""start_phi""start_phi""start_phi" and 'end_phi'"end_phi""end_phi""end_phi""end_phi" in
mathematically negative direction (clockwise).
List of values:'positive'"positive""positive""positive""positive", 'negative'"negative""negative""negative""negative"
If the parameters are valid, the operator
add_metrology_object_ellipse_measureadd_metrology_object_ellipse_measureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasure returns the value 2 (H_MSG_TRUE). If
necessary, an exception is raised.