uf5063 create an arc through three points
replaced by UF_CURVE_create_arc_thru_3pts
 

gateway

uf5070 create conic
replaced by UF_CURVE_convert_conic_to_std and UF_CURVE_create_conic
 

gateway

uf5071 read conic real data
replaced by UF_CURVE_ask_conic_data
 

gateway

uf5072 edit conic real data
No replacement
 

gateway

uf5072x edit conic real data without update
No Replacement
 

gateway

uf5073 read conic data
Replaced by UF_CURVE_ask_conic_data and UF_CURVE_convert_conic_to_gen
 

gateway

uf5074 edit conic data
No Replacement
 

gateway

uf5074x edit conic data without update
No Replacement
 

gateway

uf5075 create conic
Replaced by UF_CURVE_create_conic
 

gateway

uf5080 create spline
Replace by UF_MODL_create_fitted_spline
 

gateway

uf5081 create spline using complete definition
Replaced by UF_CURVE_create_spline_thru_pts
 

gateway

uf5082 read spline data
Replaced by UF_CURVE_ask_spline_thru_pts
 

gateway

uf5083 edit spline data
Replaced by UF_CURVE_edit_spline_thru_pts and
UF_CURVE_edit_move_mult_points
 

gateway

uf5083x edit spline data without update
No Replacement
 

gateway

uf5084 add spline knot point
Replaced by UF_CURVE_ask_spline_thru_pts and UF_CURVE_edit_spline_thru_pts
 

gateway

uf5085 count spline knot points
Replaced by UF_CURVE_ask_spine_thru_pts
 

( solid_modeling  or  drafting )

uf5445 create spline
Replaced by UF_MODL_create_spline
 

gateway

uf5446 read spline data
No Replacement
 

gateway

uf5447 create spline from points on curve or
Replace by UF_CURVE_create_spline_thru_pts and UF_CURVE_create_spline
 

gateway

uf5463 reads the count of poles
No Replacement
 

gateway

uf5466 create a spline from a curve
Replaced by UF_CURVE_create_joined_curve
 

gateway

uf5900 evaluate point on a curve
Replaced by UF_CURVE_evaluate_curve or UF_MODL_ask_curve_props
 

gateway

uf5901 evaluate curve point data
Replaced by UF_CURVE_evaluate_curve or UF_MODL_ask_curve_props
 

gateway

uf5903 trim curve by a given arclength
Replaced by UF_CURVE_edit_length
 

gateway

uf5910 evaluate point on a face
Replaced by UF_MODL_ask_face_props
 

gateway

uf5911 evaluate face point data
Replaced by UF_MODL_ask_face_props
 

gateway

uf5930 intersect two curves
Replaced by UF_CURVE_intersect or UF_MODL_intersect_objects
 

gateway

uf5931 intersect curve and face/plane
Replaced by UF_CURVE_intersect or UF_MODL_intersect_objects
 

gateway

uf5932 intersection of two faces
Replaced by UF_MODL_intersect_objects
 

gateway

Add a face collector to the offset data for the associated offset curve on
face feature.
If the offset data already has a face collector associated with it,
that existing face collector is ignored and the input face collector is used

Internal and External
 

( solid_modeling  or  drafting )

Add a string to an associated offset curve on face feature.
If the string is invalid, an error is returned.

Internal and External
 

( solid_modeling  or  drafting )

Returns the values of the Curve Analysis Display Options of
a line, circle, conic or spline

Internal and External

UF_CURVE_ask_spline_sap
UF_CURVE_set_analysis_display

Originally released in V16.0
 

gateway

Returns the data of an arc. The data is in the structure arc_coords
pointed to by UF_CURVE_arc_p_t and includes the matrix tag, start
and end angles (radian measure), the arc center coordinates, and the
arc radius. Another function that provides arc data is UF_EVAL_ask_arc.

Internal and External
 

gateway

Computes the arc length of a curve between two input parameters. It will also
compute the length of a solid edge.

Internal and External
 

gateway

Inquire a bridge curve feature

Internal and External

UF_CURVE_create_bridge_feature
UF_CURVE_edit_bridge_feature

Originally released in V16.0
 

gateway

Computes the centroid (center of gravity) of a curve or solid edge.

Internal and External

Refer to the example
 

gateway

Retrieves the parameters used to create parametric curve(s) by
combining two curves along specified direction vectors.

Internal and External

Refer to the example
For structure refer
UF_CURVE_combine_curves_direction_t
 

gateway

Reads the data from the conic arc and returns it in the data structure
provided.

Internal and External

Original release was in V13.0
 

gateway

Ask curve fit data from the curve feature

Internal and External

UF_CURVE_edit_by_curve_fit_data

This function is introduced in NX3.0.
 

gateway

Calculates inflection points of a curves projection by inputting the
curves tag, the projection matrix, and the relative range (in
percentage) in which the inflection points are to be found.

Internal and External

Refer to the example
 

gateway

Gets the structure pointer corresponding to the specified curve id.

NOTE: This routine is to be permanently withdrawn in the near
future. Use the routines in the UF_EVAL module instead.
Gets the structure pointer corresponding to the specified curve id.

Internal and External

Refer to the example
 

gateway

Allows you to get the curve type and data for a specified curve
structure.

NOTE: This routine is to be permanently withdrawn in the near
future. Use the routines in the UF_EVAL module instead.
Allows you to get the curve type and data for a specified curve
structure. You may obtain the curve structure id using
UF_CURVE_ask_curve_struct.

Depending on the object type, curve_data may have the following data:
POINT curve_data[0 - 2]

LINE curve_data[0] = t0
curve_data[1] = tscale
curve_data[2] = periodicity
curve_data[3 - 5] = first point
curve_data[6 - 8] = second point

ARC curve_data[0] = t0
curve_data[1] = tscale
curve_data[2] = periodicity
curve_data[3] = start angle
curve_data[4] = end angle (radians)
curve_data[5] = radius
curve_data[6 - 8] = center
curve_data[9 - 11] = X axis of the
construction plane
curve_data[12 - 14] = Y axis of the
construction plane

CONIC curve_data[0] = t0
curve_data[1] = tscale
curve_data[2] = periodicity
curve_data[3] = T1
curve_data[4] = T2
curve_data[5] = K1
curve_data[6] = K2
curve_data[7] = conic type
curve_data[8 - 10] = center
curve_data[11 - 13] = axis1
curve_data[14 - 16] = axis2

B-CURVE curve_data[0] = t0
curve_data[1] = tscale
curve_data[2] = periodicity
curve_data[3] = number of poles
curve_data[4] = order
curve_data[] = knot sequence
( curve_data[3] +
curve_data[4] )
curve_data[] = array of homogeneous
poles (wx, wy, wz, w), for
each pole.

Internal and External

Refer to the example
 

gateway

Returns the angle made up by a curve as it wanders through space. The angle
is taken on a projection plane defined by the orientation vector.

Internal and External
 

gateway

Returns the output curves of a curve feature.

Internal and External.

This function was originally released in V15.0
 

gateway

Given an intersection curve feature, returns the Object identifier of
the intersection curve object and the object identifiers of the two
objects that produced the intersection curve. Returns an error if the
intersection curve does not belong to an intersection curve object.

Internal and External
 

gateway

Returns an array of intersection curve tags.

Internal and External
 

gateway

Reads the creation parameters of an intersection curve feature.
Returns array of tags to the sets of input intersection objects.

Internal and External
 

gateway

Reads the creation parameters of an intersection curve feature.
Returns array of tags to the sets of input intersection objects.
This also has the ability to return the tag of collector in case
the objects intersecting are collectors.

Internal and External
 

gateway

Ask isocline curve feature data
Returns the parameters of a joined curve feature.

Internal and External

UF_CURVE_edit_isocline
 

gateway

Returns the parameters of a joined curve feature.

Internal and External.

UF_STRING_p_t AKA string_list

This function was originally released in V15.0
 

gateway

Populates the supplied pointer to line_arc_data struct for the given
associative line/arc feature.

error code

Internal and External

UF_CURVE_create_line_arc
UF_CURVE_edit_line_arc
UF_CURVE_ask_line_arc_output
 

gateway

Returns the ID of the line/arc created by the associative line/arc feature.

error code

Internal and External

UF_CURVE_create_line_arc
UF_CURVE_edit_line_arc
UF_CURVE_ask_line_arc_data
 

gateway

Returns the coordinates of a line with respect to the absolute
coordinate system.

Internal and External

UF_CURVE_line_p_t
 

gateway

Returns the offset data for a given associated offset curve on face feature.
This data can be modified and then UF_CURVE_edit_ocf_feature invoked to
modify a feature.
Memory is allocated when this data is returned. It is the responsibility of
the caller to free that memory by calling UF_CURVE_free_ocf_data

Internal and External
 

gateway

Returns an array of offset curve object identifiers.

Internal and External
 

gateway

Returns the offset direction vector and the draft direction vector for a
string of curves. These vectors define the positive direction. If you
want to offset in the opposite direction, then negate the values for
distance, draft height, and/or draft angle. The input string of curves
must be coplanar.

Internal and External

The following example is an internal Open API program that uses the new
offset curve Open API routines. The intention of this Open API program
is to give you and idea of how to set up the inputs and use the outputs from
these routines. Thus, the data used in this example is very simple and is not
representative of the capabilities of this function.

The flow of the code is as follows. First it creates the geometry needed as
input. It creates two arcs and then a ruled surface from the arcs. A string
is set up for the input curves from the arcs and two of the edges of the ruled
surface.

UF_CURVE_ask_offset_direction_2
is called with the string as input to find the offset and draft direction
vectors. UF_VEC3_dot is called to compare the offset direction vector to the
+X axis to see if they are going in the same direction. If not, the distance
string will be negated.

Structures are set up to create a UF_CURVE_OFFSET_DISTANCE_FILLET type offset
curve. These curves will be non-associative. Next, UF_CURVE_create_offset_object
is called to create a UF_CURVE_OFFSET_DISTANCE_TANGENT type associative offset
curve object. Then UF_CURVE_ask_offset_curves
is called to retrieve the output offset curves. These curves will replace the
previous input curves in the input curve string.

UF_CURVE_create_offset_object
is called again to create the next set of offset curves. UF_CURVE_ask_offset_parms
is called to read the creation parameters of the object just created. Then the
offset type is changed to UF_CURVE_OFFSET_DISTANCE_NO_TRIM and UF_CURVE_edit_offset_object
is called to update the last object. Finally, UF_CURVE_free_offset_parms
is called to free the memory allocated by UF_CURVE_ask_offset_parms

The following is the output that is generated by the example program.
Input curves are in gray and resultant curves are in green.





Refer to the example code for this program.

Documentation for UF_STRING_p_t and UF_STRING_t can be found in the NX Open
Reference Manual under uf_modl -> Types -> string_list.

This function was modified in V13.0 to add the base_point parameter.
Original function was UF_CURVE_ask_offset_direction, in NX6.0.2 this function was
added to return correct offset direction.
 

gateway

Reads the creation parameters of an offset curve object.

Internal and External

UF_CURVE_free_offset_parms
 

gateway

Returns the parameter range and periodicity for any curve or edge.
This function returns the "natural" parameter range. Arcs, ellipses
and hyperbolas return the start and end angles.

Internal and External

This function was originally released in V15.0.
 

gateway

Returns the coordinates for the specified object identifier of a point.

Internal and External
 

gateway

Given an input projected curve, determines the feature identifier, the
target object identifier (sheet_body/face/plane/datum_plane), and the defining
curve identifier of the projected curves.

The projected curve must be a curve that was produced by
UF_CURVE_create_proj_curves. You can get this curve by calling the
function UF_CURVE_ask_proj_curves. An error is returned if the
projected curve does not belong to a projected curves feature.
The following example creates a block at origin (0,0,0) with edge
lengths of (300,25,150). The program creates and projects a line onto
the faces of the block. Next the projected curves are found, and then
the face the curves projected onto and the defining curves generating
the projected curves are determined.

Internal and External

Refer to the example
 

gateway

Returns the curves associated with a projected curve feature.

Internal and External

UF_CURVE_create_proj_curves
UF_MODL_create_proj_curves
UF_MODL_ask_proj_curves
 

gateway

Reads the spline data and puts it in the data structure whose address
is provided.

Internal and External

UF_CURVE_ask_parameterization
 

gateway

Inquire a general spline feature.
Output object id of the referenced smart spline.

error code

Internal and External

UF_CURVE_create_spline_feature
UF_CURVE_edit_spline_feature

Originally released in V18.0
 

gateway

Returns the values of the Shape Analysis Parameters (SAP) of a
B-curve. Shape Analysis Parameters are a set of parameters used to
display B-curves characteristics. The current SAP includes four
integer flags used to indicate the display status of the control polygon,
curvature comb, inflection points and peak points of a B-curve, and a
real value used to scale the teeth length of the curvature comb.

Please use UF_CURVE_ask_analysis_display instead of UF_CURVE_ask_spline_sap,
as UF_CURVE_ask_spline_sap will eventually become obsolete.

Internal and External

UF_CURVE_set_spline_sap
UF_CURVE_ask_analysis_display
 

gateway

Reads a splines defining data structure. The defining data returns
regardless of whether the spline is in or out of synchronization with its
defining data. However, if you pass the returned data structure to the
routine UF_CURVE_edit_spline_thru_pts, the spline is recreated from
the input data. Any previous change to the spline by modifying its pole
data will be discarded. If there is no defining data stored with the
spline, an error code will be returned.

The length of the array of parameters is num_points for non-periodic
curves and (num_points+1) for periodic ones.

Internal and External

UF_CURVE_create_spline_thru_pts
UF_CURVE_edit_spline_thru_pts
UF_CURVE_pt_slope_crvatr_t
Refer to the example

Original release was in V13.0
 

gateway

Retrieve the current parameters of an associative trim curve feature.

Internal and External

Refer to the example

Originally released in V16.0
 

gateway

Reads the creation parameters pertaining to a wrap or unwrap curve.

Internal and External
 

gateway

Reads the creation parameters of a wrap or unwrap curves feature.

Internal and External
 

gateway

Reads the creation parameters of a wrap or unwrap curves feature.

Internal and External
 

gateway

Sorts through a set of unordered curves, joining curves where
appropriate. Curves must meet the following criteria in order to join:
The curve must be open. Closed curves such as a circle or ellipse
cannot be joined.

Only curves that share a common end point can be joined.
Only valid curves can be joined (line, arc, b-spline, conics).

Internal and External
 

( solid_modeling  or  drafting )

The conic in standard form is converted to its general form. The
matrix of the general form is always the same as for the standard form.

Internal and External

UF_CURVE_ask_conic_data

Original release was in V13.0
 

( solid_modeling  or  drafting )

Converts general form conic data to standard form data.

The matrix for each form defines the orientation, or construction
space; the conic arc is parallel to its XY plane. The Z coordinate of
the center point gives the offset from the XY plane. The matrix for
the standard form is always the same as it was for the general form.
In the standard form, there is no way to specify the direction of
parameterization. The start and end points of the general form can
define a parameterization direction opposite that of the standard
form. When this is the case the sense argument is returned false.

For an ellipse, the process of extracting the angle of
rotation from the general form coefficients does not reliably yield the
same rotation angle with which it was created. The result may be a
parameterization in standard form between p and 3p. For this reason
many workers change the matrix of an ellipse (and possibly parabolas
and hyperbolas too) to incorporate the rotation angle and make the
conics rotation angle be zero. This produces a reliable
parameterization for the general form.

Internal and External

Original release was in V13.0
 

( solid_modeling  or  drafting )

Creates an arc. You input the matrix tag, start and end angles in
radians, the coordinates of the arc center, and the radius by filling out
the arc_coords data structure pointed to by UF_CURVE_arc_p_t.
The arc is drawn counterclockwise from the start angle to the end angle
as shown below.


This function returns an error if the absolute value of the difference
between the start and end angle is greater than two pi (plus the system
tolerance). An error is also returned if the start angle is greater than
the end angle.

Internal and External

UF_CURVE_arc_p_t
Refer to the example
 

( solid_modeling  or  drafting )

Create an associative arc feature through three points.

error code

Internal and External

UF_CURVE_create_line_arc
 

( solid_modeling  or  drafting )

Create an associative arc feature through tangent to three curves.

error code

Internal and External

UF_CURVE_create_line_arc
 

( solid_modeling  or  drafting )

Create an associative arc feature of given radius and specific center

error code

Internal and External

UF_CURVE_create_line_arc
 

( solid_modeling  or  drafting )

Create an associative arc feature tangent to a curve and specific center.

error code

Internal and External

UF_CURVE_create_line_arc
 

( solid_modeling  or  drafting )

Create an associative arc feature through a start point and specific center.

error code

Internal and External

UF_CURVE_create_line_arc
 

( solid_modeling  or  drafting )

Create an associative arc feature through two points and of specific radius.

error code

Internal and External

UF_CURVE_create_line_arc
 

( solid_modeling  or  drafting )

Create an associative arc feature through two points and tangent to a curve.

error code

Internal and External

UF_CURVE_create_line_arc
 

( solid_modeling  or  drafting )

Create an associative arc feature through two points and tangent to a curve.

error code

Internal and External

UF_CURVE_create_line_arc
 

( solid_modeling  or  drafting )

Create an associative arc feature through one point, tangent to a curve and of specific radius.

error code

Internal and External

UF_CURVE_create_line_arc
 

( solid_modeling  or  drafting )

Create an associative arc feature through a point and tangent to two curves.

error code

Internal and External

UF_CURVE_create_line_arc
 

( solid_modeling  or  drafting )

Create an associative arc feature through two points and tangent to a curve.

error code

Internal and External

UF_CURVE_create_line_arc
 

( solid_modeling  or  drafting )

Create an associative arc feature through a point and tangent to two curves.

error code

Internal and External

UF_CURVE_create_line_arc
 

( solid_modeling  or  drafting )

Create an associative arc feature through a point and tangent to two curves.

error code

Internal and External

UF_CURVE_create_line_arc
 

( solid_modeling  or  drafting )

Create an associative arc feature tangent to two curves and of specific radius.

error code

Internal and External

UF_CURVE_create_line_arc
 

( solid_modeling  or  drafting )

Create an arc or a circle passing through the user specified input points.

Internal and External

Originally released in V16.0
 

( solid_modeling  or  drafting )

Bridges two curves/edges by matching tangents or matching curvatures. You
can control the connection of the bridge curve along the two curves/edges by
specifying the parameter along each curve/edge. You have the ability to
reverse the tangent direction vector at the parameter along the curves/edges.
The routine returns the object identifier of the new bridge curve.

Internal and External
 

( solid_modeling  or  drafting )

Creates a new bridge curve feature by bridging 2 input curves.
You can control the connection of the bridge curve along the two curves by
specifying the parameter along each curve. You have the ability to
reverse the tangent direction vector at the parameter along the curves.
You can control the shape of the curve by specifing a reference curve
or by indicating shape control values.

The routine returns the object identifier of the new bridge curve feature.
The new bridge curve is associative to the input curves and any expressions
used to determine shape or end point location.

Internal and External

UF_CURVE_edit_bridge_feature
UF_CURVE_ask_bridge_feature

Originally released in V16.0
 

( solid_modeling  or  drafting )

Creates parametric curve(s) by combining two curves along specified
direction vectors. When "normal to plane of curve" is specified as the
projection type, the curve must be planar. An error will be given if the
above is not true.

Internal and External

UF_CURVE_combine_curves_direction_t
Refer to the example
 

( solid_modeling  or  drafting )

Creates a conic curve. See the description of the data structure for
details on the interpretation of the data items.

Internal and External

Original release was in V13.0.
 

( solid_modeling  or  drafting )

Creates a fillet between the specified curves. The curves can be any
combination of points, lines, arcs, conics, or splines.

A two curve fillet is an arc generated in the
counterclockwise direction from the first curve to the
second. The fillet formed is tangent to both curves. The counterclockwise
direction is determined based on the current views orientation, not the
absolute or WCS coordinate systems.

NOTE: The ability to specify whether an input curve is to be
trimmed is provided. If a "spline-type" curve is flagged to be
trimmed, the defining points and associated dimensions will be
deleted. If a trimmed curve has a length equal to zero and there is no
associative connection to the curve, the curve will be deleted.

NOTE: The center point coordinates (for 2-curve fillet) will be
projected along the Z-axis of the WCS, to the construction plane of
the fillet if necessary.

There is no 3 curve fillet so the documentation for this option has been removed.

Internal and External

Refer to the example
 

( solid_modeling  or  drafting )

Intersects two sets of objects. Objects to intersect must be 1 body, 1
datum plane, 1 face collector or multiple faces (from same body) per set.
Datum planes cannot be input for both sets since the result is a
non-associative line. If you wish to intersect two datum planes you
can use UF_MODL_intersect_objects.

Internal and External

UF_MODL_intersect_objects
 

( solid_modeling  or  drafting )

Creates a new joined curve feature that consists of a new spline curve
that represents the input list of joined curves and edges. The curves
can be sketch curves. The curves or edges that you join may not have
gaps.

The Modeling distance and angle tolerance are used to create and
validate the resulting spline curve. The modeling tolerance can be
modified by UF_MODL_set_distance_tolerance or UF_MODL_set_angle_tolerance.

Internal and External

Refer to the example
UF_MODL_create_isocline_curves
UF_CURVE_ask_isocline
UF_CURVE_edit_isocline
 

( solid_modeling  or  drafting )

Creates a new spline curve that represents the input list of joined
curves and edges. The curves or edges that you join may not have gaps.

The Modeling distance and angle tolerance are used to create and
validate the resulting spline curve. The modeling tolerance can be
modified by UF_MODL_set_distance_tolerance or UF_MODL_set_angle_tolerance.

The curves you join must be input in order: either clockwise or
counterclockwise.

Internal and External

Refer to the example

Creation method has the advanced option in NX3.0.
 

( solid_modeling  or  drafting )

Creates a new joined curve feature that consists of a new spline curve
that represents the input list of joined curves and edges. The curves
can be sketch curves. The curves or edges that you join may not have
gaps.

The Modeling distance and angle tolerance are used to create and
validate the resulting spline curve. The modeling tolerance can be
modified by UF_MODL_set_distance_tolerance or UF_MODL_set_angle_tolerance.

Internal and External.

UF_MODL_set_distance_tolerance
UF_MODL_set_angle_tolerance
UF_STRING_p_t AKA string_list
UF_MODL_init_string_list
UF_MODL_create_string_list
UF_MODL_free_string_list

This function was originally released in V15.0.
Creation method has the advanced option in NX3.0.
 

( solid_modeling  or  drafting )

Creates a line. You input the start and end points of the line by filling
out the line_coords data structure pointed to by UF_CURVE_line_p_t.

Internal and External

UF_CURVE_line_p_t
 

( solid_modeling  or  drafting )

Create an associative line/arc feature. You input a UF_CURVE_line_arc_t data structure,
which specified the data needed for the line/arc to be created. Output is the
object identifier of the associative line/arc feature. An error is returned if
line/arc cannot be created with the specified data.

error code

Internal and External

UF_CURVE_edit_line_arc
UF_CURVE_ask_line_arc_data
UF_CURVE_ask_line_arc_output
 

( solid_modeling  or  drafting )

Create an associative line feature through a point and at an angle to a linear curve/edge.

error code

Internal and External

UF_CURVE_create_line_arc
 

( solid_modeling  or  drafting )

Create an associative line feature through two points.

error code

Internal and External

UF_CURVE_create_line_arc
 

( solid_modeling  or  drafting )

Create an associative line feature through a point and along any one principal axis.

error code

Internal and External

UF_CURVE_create_line_arc
 

( solid_modeling  or  drafting )

Create an associative line feature through point and tangent to curve.

error code

Internal and External

UF_CURVE_create_line_arc
 

( solid_modeling  or  drafting )