Overview | Statement List | Example

Conic

Synopsis

obj = BSURF/CONSRF,num1,objlist,SPINE,obj1[,ENDOF,obj2][,RHO,nlist][,TOLER,num2][,APEX,obj3][,RESULT,num3][,IFERR,label:]

Description

Creates a B-surface using conic surface techniques. To completely define the surface, you must specify enough data to fulfill the five conditions required to define a conic, such as 3 points and 2 slopes.

For a more detailed description of the various conic surface techniques refer to the Modeling Help.

Parameters

Parameter	Description
CONSRF	Minor word indicating that the B-surface is to be created using a conic surface technique.
num1	A number indicating the conic surface technique to be used.

Number	Conic Surface Technique
1	5 point method
2	4 point, 1 slope method
3	3 point, 2 slope method
4	3 point, apex method
5	2 point, apex, rho method
6	2 point, 2 slope, rho method
7	2 point, 1 slope, arc method
8	3 point, arc method
9	3 point, 2 slope fillet method
10	2 point, 2 slope, rho fillet method

objlist

A list of objects whose interpretation depends on the surface creation technique previously specified, as follows:

Method: 5 Point (num1 = 1)
Objects	Interpretation
objlist[1]	start edge curve
objlist[2]	first interior curve
objlist[3]	second interior curve
objlist[4]	third interior curve
objlist[5]	end edge curve

Method: 4 Point, 1 Slope (num1 = 2)
Objects	Interpretation
objlist[1]	start edge curve
objlist[2]	start slope control curve
objlist[3]	first interior curve
objlist[4]	second interior curve
objlist[5]	end edge curve

Method: 3 Point, 2 Slope (num1 = 3)
Objects	Interpretation
objlist[1]	start edge curve
objlist[2]	start slope control curve
objlist[3]	shoulder curve
objlist[4]	end edge curve
objlist[5]	end slope control curve

Method: 3 Point, Apex (num1 = 4)
Objects	Interpretation
objlist[1]	start edge curve
objlist[2]	shoulder curve
objlist[3]	end edge curve
objlist[4]	apex curve

Method: 2 Point, Apex, Rho (num1 = 5)
Objects	Interpretation
objlist[1]	start edge curve
objlist[2]	end edge curve
objlist[3]	apex curve

Method: 2 Point, 2 Slope, Rho (num1 = 6)
Objects	Interpretation
objlist[1]	start edge curve
objlist[2]	start slope control curve
objlist[3]	end edge curve
objlist[4]	end slope control curve

Method: 2 Point, 1 Slope, Arc (num1 = 7)
Objects	Interpretation
objlist[1]	start edge curve
objlist[2]	start slope control curve
objlist[3]	end edge curve

Method: 3 Point, Arc (num1 = 8)
Objects	Interpretation
objlist[1]	start edge curve
objlist[2]	interior curve
objlist[3]	end edge curve

Method: 3 Point, 2 Slope Fillet (num1 = 9)
Objects	Interpretation
objlist[1]	first surface
objlist[2]	curve on first surface
objlist[3]	shoulder curve
objlist[4]	second surface
objlist[5]	curve on second surface

Method: 2 Point, 2 Slope, Rho Fillet (num1 = 10)
Objects	Interpretation
objlist[1]	first surface
objlist[2]	curve on first surface
objlist[3]	second surface
objlist[4]	curve on second surface

SPINE	Minor word indicating that a spine curve is to be specified.
obj1	The spine curve to be used in surface creation. Any curve can be specified.
ENDOF	Minor word indicating that the direction along the spine is to be specified.
obj2	A point which is closest to the end point of the spine that is to be used as the start point.
RHO	Minor word indicating that rho information is to follow. The system ignores this input if the specified surface creation technique does not require it.
nlist	A numerical list of rho information. The first number in this list indicates the rho information to follow.

Number	Rho Information
1	constant rho
2	linear variation of rho
3	cubic variation of rho
4	least tension rho

If nlist[1] = 1, then nlist[2] is a constant rho value.

If nlist[1] = 2 or nlist[1] = 3, then nlist[2] is the starting rho value and nlist[3] is the ending rho value.

If nlist[1] = 4, then no other input is expected.

TOLER	Minor word indicating that a distance tolerance for surface creation is to be specified. If none is specified, the default is the value set in the Unigraphics option Preferences—>Modeling. You can also read and set this tolerance using the GPA &DISTOL.
num2	Tolerance which specifies the maximum allowable distance between a true theoretical conic surface and the B-surface approximation that the system produces. Must be a positive value.
APEX	Minor word indicating that the system is to create the apex curve. The system ignores this optional input if the specified surface creation technique does not allow for it.
obj3	An object identifier of the apex curve, if the option is allowed by the specified surface creation technique. If not, this value is set to NULENT.
RESULT	Minor word indicating that a return variable is to be provided to denote error conditions.
num3	A return variable for error messages. The possible values of this variable, and the associated error conditions, are as follows:

Return Variable	Error Condition
-7	Invalid object list of input objects for this creation method.
-6	Creation method out of range; num1 must be between 1 and 10.
-5	Invalid object list of control curve/surface objects.
-4	Invalid spine object.
-3	Invalid rho information, or missing when required.
-2	Non-positive tolerance.
-1	Unable to allocate enough memory.
0	Successful conic surface creation.
1	Unable to intersect control curve with section plane.
2	No longer returned.
3	No longer returned.
4	Invalid spine curve definition.
5	Unable to construct conic.
6	Maximum size B-surface exceeded.
7	No longer returned.
8	Unable to construct conic, conic spans more than 180 degrees.
9	No longer returned.
10	No longer returned.
11	No longer returned.
12	No longer returned.
13	Unable to build surface through conics.
14	Unable to compute apex point.
15	Iteration produced null patches, no surface created.
16	User abort, no surface created.
17	Unable to build sheet

NOTE: These error conditions closely match those of the interactive Unigraphics option. Refer to the Modeling Help for more detailed descriptions.

IFERR,label:

Specifies a label to which program execution jumps if an error occurs.