Table of Contents


Numeric Operations

Basic arithmetic and trigonometric operations etc. are supported in c_shape_edit. Numeric arguments can be constants (see Command Language Reference for the precise formats) or named variables with numeric values.

 Note that the basic arithmetic operations use infix notation (i.e. num1 op num2). Parentheses can be used to specify precedence of infix operators. The results of infix operators can be assigned to variables just like any other function:

x : 1;
y : 2 * (x + 2);
z : y * 47.5;

Predefined Constants

The value of pi is provided as a predefined constant. For example:
    Circumference : 2 * Pi * circleRad( Circle );
There are also predefined constants for curve and surface orders.


Basic Arithmetic Operations

num1 + num2
Returns
<number> Add two numbers.
num1
<number> The first number.
num2
<number> The second number.
num1 - num2
Returns
<number> Subtract two numbers.
num1
<number> The first number.
num2
<number> The second number.
num1 * num2
Returns
<number> Multiply two numbers.
num1
<number> The first number.
num2
<number> The second number.
num1 / num2
Returns
<number> Divide two numbers.
num1
<number> The first number.
num2
<number> The second number.
num1 % num2
Returns
<number> Return the modulo of two numbers. (The remainder of dividing the first by the second.)
num1
<number> The first number.
num2
<number> The second number.
base ** power
Returns
<number> Return the exponentiation of two numbers. (Same as pow.)
base
<number> The base number.
power
<number> The power to raise the base to.
Minimum and Maximum Functions

Minimum and Maximum Functions

min( num1, num2 )
Returns
<number> Return the minimum of two numbers.
num1
<number> The first number.
num2
<number> The second number.
max( num1, num2 )
Returns
<number> Return the maximum of two numbers.
num1
<number> The first number.
num2
<number> The second number.

Trigonometric Functions

sin( angle )
Returns
<number> Compute the sine of an angle (given in radians).
angle
<number> The angle.
cos( angle )
Returns
<number> Compute the cosine of an angle (given in radians).
angle
<number> The angle.
tan( angle )
Returns
<number> Compute the tangent of an angle (given in radians).
angle
<number> The angle.
sinD( angle )
Returns
<number> Compute the sine of an angle (given in degrees).
angle
<number> The angle.
cosD( angle )
Returns
<number> Compute the cosine of an angle (given in degrees).
angle
<number> The angle.
tanD( angle )
Returns
<number> Compute the tangent of an angle (given in degrees).
angle
<number> The angle.
aSin( num )
Returns
<number> Computes the arcsine (in radians) of a number.
num
<number> The number to be used.
aCos( num )
Returns
<number> Computes the arccosine (in radians) of a number.
num
<number> The number to be used.
aTan( num )
Returns
<number> Computes the arctangent (in radians) of a number.
num
<number> The number to be used.
aTan2( num )
Returns
<number> Computes the arctangent (in radians) of a number.
num
<number> The number to be used.
aSinD( num )
Returns
<number> Computes the arcsine (in degrees) of a number.
num
<number> The number to be used.
aCosD( num )
Returns
<number> Computes the arccosine (in degrees) of a number.
num
<number> The number to be used.
aTanD( num )
Returns
<number> Computes the arctangent (in degrees) of a number.
num
<number> The number to be used.
aTan2D( num )
Returns
<number> Computes the arctangent (in degrees) of a number.
num
<number> The number to be used.

Arrays


    Groups should be usually used for collecting objects under a single name when modeling. Arrays are required as arguments for some constructors. Here is a document detailing the semantics of arrays.
array( arg1,... )
Returns
<array> A zero-based array of arguments of any type known to Alpha_1.
arg
<any> Any datatype known to Alpha_1. Arguments may be arrays for nesting.
a[ n ]
Returns
<any> Extracts the nth element of the array. May be repeated for nested arrays, e.g. A[I][J]. Many other aggregate object types such as group, shell, ctlPoly and polyline may also be array indexed.
a
<array> A zero-based array of arguments of any indexable type known to Alpha_1.
n
<integer> An integer.
setIndex( array, n, obj )
Returns
<array | group> Returns a new array or group with the nth element of the input array replaced by a new object. A group is returned if a group is input rather than an array.
array
<array | group> An array or group.
n
<integer> An integer index into the array.
obj
<Any> Any Alpha_1 datatype.
size( a )
Returns
<number> The number of elements in the array. (One greater than the index of the last element in the array.)
a
<array> An array.
arrayP( obj )
Returns
<boolean> The arrayP predicate returns true if its argument is an array, false if not.
obj
<any> Any model object.
append( array1, array2 )
Returns
<array | group> An array or group which is the result of appending array2 to array1. A group is returned if either of the arguments is a group.
array1
<array | group> The first array.
array2
<array | group> The second array.

Ceiling and Floor Functions

ceil( num )
Returns
<integer> Returns the nearest integer greater than or equal to a number.
num
<number> The number to be used.
floor( num )
Returns
<integer> Returns the nearest integer less than or equal to a number.
num
<number> The number to be used.

Exponential and Logarithmic Functions

exp( num )
Returns
<number> Returns e^x where e = 2.71828.
num
<number> Then number to calculate the exponential from.
log( num )
Returns
<number> Returns ln(x) where ln is the natual logarithm.
num
<number> The number to take the natural logarithm of.
log10( num )
Returns
<number> Returns the base-10 logarithm of a number.
num
<number> The number to take the logarithm of.
pow( base, power )
Returns
<number> Returns a base number raised to a power. (base^power)
(Same as **.)
base
<number> The base number.
power
<number> The power to raise the base to.

Other Arithmetic Functions

fAbs( num )
Returns
<number> Returns the absolute value of a number. (Floating point)
num
<number> The number to be used.
sqrt( num )
Returns
<number> Returns the square root of a number.
num
<number> The number to be square rooted.
mm2In( millimeters )
Returns
<number> A conversion function to convert from milliliters to inches.
millimeters
<number> The number of milliliters.
numberRamp( start, end, steps )
Returns
<array> Returns an array of numbers spanning start to end with steps number of steps.
start, end
<number> The start and end of the number range.
steps
<integer> The number of steps to go from start to end.
mergeNumberVecs( array1, array2 )
Returns
<array> Returns an array of numbers from merging the two input arrays of ascending numbers. steps number of steps.
array1, array2
<array> An array of numbers in ascending order.

C_Shape_Edit User's Manual Home Page 
Alpha_1 User's Manual.
Copyright © 1998, University of Utah
a1-web@gr.cs.utah.edu