ShapeSheet™. Geometry functions

Main page /  Useful info about ShapeSheet™  / Visio ShapeSheet reference / ShapeSheet™. List of functions by category

ShapeSheet. Category Geometry functions

Note

This table contain functions which included in table for similar category in the book MS Visio 2003 Developer’s Survival Pack by Graham Wideman (see chapter 37) and also functions added in later versions.

The version information in which the function was added is taken from John's Goldsmith article Visio ShapeSheet Functions by Version


Name

Details

ACOS

Version Added: Pre 2003

Returns the arccosine of number, for example, the angle whose cosine is number.

Syntax

ACOS(number)

Read more about function ACOS

ANG360

Version Added: Pre 2003

Normalizes an angle's range to be 0 <= result < 2PI radians (0 <= result < 360 degrees).

Syntax

ANG360(angle)

Read more about function ANG360

ASIN

Version Added: Pre 2003

Returns the arcsine of a number, for example, the angle whose sine is number.

Syntax

ASIN(number)

Read more about function ASIN

ATAN

Version Added: Pre 2003

Returns the arctangent of a number, for example, the angle whose tangent is number. The resulting angle is in the range -PI/2 <= angle <= PI/2 radians (-90 <= angle <= 90 degrees).

Syntax

ATAN(number)

Read more about function ATAN

ATAN2

Version Added: Pre 2003

Returns the angle between the vector represented by x,y and the direction of the x-axis. The result is a number in the current unit of measure for angles.

Syntax

ATAN2(y,x)

Read more about function ATAN2

BOUNDINGBOXDIST

Version Added: 2010

Returns the measurement of the specified part of the shape's bounding box.

Syntax

BOUNDINGBOXDIST(Index)

Read more about function BOUNDINGBOXDIST

BOUNDINGBOXRECT

Version Added: 2010

Returns the coordinate of the specified edge of the shape's bounding box.

Syntax

BOUNDINGBOXRECT(Index)

Read more about function BOUNDINGBOXRECT

COS

Version Added: Pre 2003

Returns the cosine of an angle.

Syntax

COS(angle)

Read more about function COS

COSH

Version Added: Pre 2003

Returns the hyperbolic cosine of an angle.

Syntax

COSH(angle)

Read more about function COSH

DEG

Version Added: Pre 2003

Converts the value of an angle from radians to degrees.

Syntax

DEG(angle)

Read more about function DEG

DISTTOPATH

Version Added: 2010

Returns the shortest distance from the point represented by the specified coordinates to a point on the path.

Syntax

DISTTOPATH(section,x,y)

Read more about function DISTTOPATH

GRAVITY

Version Added: Pre 2003

Calculates a text block's correct angle of rotation for the indicated shape rotation to prevent the text from turning upside down.

Syntax

GRAVITY(angle,[limit1],[limit2])

Read more about function GRAVITY

INTERSECTX

Version Added: Pre 2003

Returns the x-coordinate (in the local coordinate system) of the point where two lines intersect.

Syntax

INTERSECTX(x1,y1,angle1,x2,y2,angle2)

Read more about function INTERSECTX

INTERSECTY

Version Added: Pre 2003

Returns the y-coordinate (in the local coordinate system) of the point where two lines intersect.

Syntax

INTERSECTX(x1,y1,angle1,x2,y2,angle2)

Read more about function INTERSECTY

MAGNITUDE

Version Added: Pre 2003

Returns the magnitude of the vector whose rise is A and whose run is B, multiplied by the respective constants constantA and constantB.

Syntax

MAGNITUDE(constantA,A,constantB,B)

Read more about function MAGNITUDE

NEARESTPOINTONPATH

Version Added: 2010

Returns the percentage of the distance along the path of the point that is nearest to the specified coordinates, as a value between 0 and 1.

Syntax

NEARESTPOINTONPATH(section,x,y)

Read more about function NEARESTPOINTONPATH

NURBS

Version Added: Pre 2003

Returns a nonuniform rational B-spline (NURBS). This function is used in the E cell in the NURBSTo geometry rows.

Syntax

NURBS(knotLast, degree, xType, yType, x1, y1, knot1, weight1, ...)

Read more about function NURBS

PATHLENGTH

Version Added: 2010

Returns the length of the path that is defined in the specified Geometry section.

Syntax

PATHLENGTH(section[,segment])

Read more about function PATHLENGTH

PATHSEGMENT

Version Added: 2010

Returns the 1-based segment number at the specified percentage mark along the specified path.

Syntax

PATHSEGMENT(section,travel)

Read more about function PATHSEGMENT

PI

Version Added: Pre 2003

Returns the mathematical constant pi, which is approximately 3.1415926535898.

Syntax

PI( )

Read more about function PI

POINTALONGPATH

Version Added: 2010

Returns the coordinates of a point on, or offset from, the path.

Syntax

POINTALONGPATH(section,travel[,offset][,segment])

Read more about function POINTALONGPATH

POLYLINE

Version Added: Pre 2003

Returns a polyline. This function is used in the A cell of PolyLineTo geometry rows.

Syntax

POLYLINE(xType, yType, x1, y1...)

Read more about function POLYLINE

RAD

Version Added: Pre 2003

Converts the value of an angle from degrees to radians.

Syntax

RAD(angle)

Read more about function RAD

RECTSECT

Version Added: Pre 2003

Calculates the sector of a rectangle associated with x and y and returns an integer 0 to 4, indicating the sector.

Syntax

RECTSECT(width,height,x,y,option)

Read more about function RECTSECT

SEGMENTCOUNT

Version Added: 2010

Returns the number of line segments that make up the path.

Syntax

SEGMENTCOUNT(pathRef)

Read more about function SEGMENTCOUNT

SIN

Version Added: Pre 2003

Returns the sine of an angle.

Syntax

SIN(angle)

Read more about function SIN

SINH

Version Added: Pre 2003

Returns the hyperbolic sine of an angle.

Syntax

SINH(angle)

Read more about function SINH

TAN

Version Added: Pre 2003

Returns the tangent of an angle.

Syntax

TAN(angle)

Read more about function TAN

TANH

Version Added: Pre 2003

Returns the hyperbolic tangent of an angle.

Syntax

TANH(angle)

Read more about function TANH