VS:BeginSweep

From Vectorworks Developer
Jump to: navigation, search

.VectorScript|VectorScript ..VS:Function Reference|Function Reference ..VS:Function_Reference_Appendix|Appendix

Description

Procedure BeginSweep creates a three-dimensional sweep object in the VectorWorks document. A sweep object is a two-dimensional template object which has been rotated about a specified point to create a 3D object. For example, a circle of radius 1" that is swept about a point 2" to the right of the circles center wil create a sweep object resembling a donut, also known as a torus.

The sweep increment may also be thought of as the spacing between the duplication of radial sweep mesh lines. The "pitch", or vertical distance, is the distance that the sweep object will travel for every 360 degrees of rotation. In sweep objects, the 2D template object may also be translated as it rotates, resulting in a "corkscrew" effect. The vertical movement is determined by the following equation: vertical movement = pitch * ArcAngle/360.

  • 2D Object "Template" for Sweep

Sweep2d.gif

  • Sweep Object

Sweep3d.gif

PROCEDURE BeginSweep(
startAngle  :REAL;
arcAngle  :REAL;
incAngle  :REAL;
PitchDistance  :REAL);
def vs.BeginSweep(startAngle, arcAngle, incAngle, PitchDistance):
    return None

Parameters

startAngle REAL Starting angle of the sweep.
arcAngle REAL Angle of sweep.
incAngle REAL Increment of sweep.
PitchDistance REAL Pitch (translation distance) of sweep.

Example

VectorScript

BeginSweep(#0d,#360d,#10d,0');
Poly(3 1/4",-1/2",
3 1/4",-1",
2 3/4",-1",
2 1/4",-1/2",
2 1/4",1",
1 3/4",1 1/2",
-1 3/4",1 1/2",
-2 1/4",1",
-2 1/4",-1/2",
-2 3/4",-1",
-3 1/4",-1",
-3 1/4",-1/2",
-2 3/4",0",
-2 3/4",1 1/2",
-2 1/4",2",
2 1/4",2",
2 3/4",1 1/2",
2 3/4",0");
EndSweep;

Python

vs.BeginSweep(0,360,10,0)
vs.Poly(3 + 1/4,-1/2,
3 + 1/4,-1,
2 + 3/4,-1,
2 + 1/4,-1/2,
2 + 1/4,1,
1 + 3/4,1 + 1/2,
-1+ 3/4,1 + 1/2,
-2+ 1/4,1,
-2+ 1/4,-1/2,
-2+ 3/4,-1,
-3+ 1/4,-1,
-3+ 1/4,-1/2,
-2+ 3/4,0,
-2+ 3/4,1 + 1/2,
-2+ 1/4,2,
2 + 1/4,2,
2 + 3/4,1 + 1/2,
2 + 3/4,0)
vs.EndSweep()

Version

Availability: from All Versions
Personal tools
NamespacesFFFF

Variants
Actions
Advanced Search
See Also
Navigation
Toolbox