PointCollection.PositionArray operator

Description

Sets or returns the point positions as a 2-dimensional Array, (the first dimension contains the x,y,z values). For non-scripted operators this property can only be set if the object has been frozen. This operation is not undoable.

C# Syntax

// get accessor
Object rtn = PointCollection.PositionArray;
// set accessor
PointCollection.PositionArray = Object;

Examples

1. VBScript Example

set oRoot = application.activeproject.activescene.root
set oObj = oRoot.addgeometry( "Cube", "MeshSurface" )
FreezeObj oObj
set oGeometry = oObj.activeprimitive.geometry
dGlobalPosY = oObj.Kinematics.global.parameters("posy").value
' get the geometry points in an array of x,y,z values
aPositions = oGeometry.Points.PositionArray
' squish all the points that are below the Y=0 axis
dSquishFactor = 3
for i = LBound(aPositions, 2) to UBound(aPositions, 2)
	' Compute the point's global Y position.
	dGlobalYPnt = aPositions(1, i) + dGlobalPosY 
	' If the point is below the Y=0 plane...
	If dGlobalYPnt < 0 Then
		' Compute the squish factor for the point.
		dSquishPnt = 1.0 - dGlobalYPnt * dSquishFactor
		' Squish the point.
		aPositions(0, i) = aPositions(0, i) * dSquishFactor
		aPositions(1, i) = - dGlobalPosY
		aPositions(2, i) = aPositions(2, i) * dSquishFactor
	End If	
next
' set the geometry points using the modified position array
oGeometry.Points.PositionArray = aPositions

2. JScript Example

TestPointsPositionArray();
function TestPointsPositionArray()
{
LogMessage( "----- Test PointCollection.PositionArray -----" );
var oCube = CreatePrim("Cube", "MeshSurface");
FreezeObj( oCube.name );
LogMessage( "--- current position array ---" );
var aPos = new VBArray(oCube.ActivePrimitive.Geometry.Points.PositionArray);
for (i = 0; i <= aPos.ubound(2); i++) {
LogMessage(i + " " + aPos.getItem(0, i) + " " + aPos.getItem(1, i) + " " + aPos.getItem(2, i));
}
LogMessage( "--- current position array (1 dim) ---" );
var aPos2 = aPos.toArray();
LogMessage(typeof(aPos2));
LogMessage(aPos2.length);
for (i = 0; i < aPos2.length; i += 3) {
LogMessage(i + " " + aPos2[i] + " " + aPos2[i+1] + " " + aPos2[i+2]);
}
aPos2[0] = -4;
aPos2[1] = -4;
aPos2[2] = -4;
aPos2[3] = 4;
aPos2[4] = -4;
aPos2[5] = -4;
aPos2[6] = -1;
aPos2[7] = 4;
aPos2[8] = -1;
aPos2[9] = 1;
aPos2[10] = 4;
aPos2[11] = -1;
aPos2[12] = -4;
aPos2[13] = -4;
aPos2[14] = 4;
aPos2[15] = 4;
aPos2[16] = -4;
aPos2[17] = 4;
aPos2[18] = -1;
aPos2[19] = 4;
aPos2[20] = 1;
aPos2[21] = 1;
aPos2[22] = 4;
aPos2[23] = 1;
oCube.ActivePrimitive.Geometry.Points.PositionArray = aPos2;
LogMessage( "--- new position array ---" );
var aPos = new VBArray(oCube.ActivePrimitive.Geometry.Points.PositionArray);
for (i = 0; i <= aPos.ubound(2); i++) {
LogMessage(i + " " + aPos.getItem(0, i) + " " + aPos.getItem(1, i) + " " + aPos.getItem(2, i));
}
return 0;
}