HAngle.md

HAngle

Description

Function HAngle returns the angle of the referenced object.

FUNCTION HAngle(h : HANDLE): REAL;

def vs.HAngle(h):
    return REAL

Parameters

Name	Type	Description
h	HANDLE	Handle to object.

Remarks

You can use this routines for getting the angle (slope) of a straight wall as well. It will also detect the eventual reversion of the wall, consistent with the OIP.

On round walls the eventual reversion is NOT detected. Check if the wall is counterclockwise:

IF NOT GetObjectVariableBool(wallH, 570) THEN
  wallRot := -wallrot;

For rotated rectangle and oval, the angle is in range [-180;180].

Examples

VectorScript

PROCEDURE Example;
BEGIN
CallTool(-202);
Message(HAngle(FSActLayer));
END;
RUN(Example);

Python

def Example():
	vs.CallTool(-202)
	vs.Message(vs.HAngle(vs.FSActLayer()))

Example()

	IF usePolygon THEN objType := 5
	ELSE objType := GetType (objH);
	alpha := HAngle(objH);
	isValidObject := TRUE;
{
message ('objType = ',objType,'   alpha = ',alpha);
}

BEGIN
IF (IsArcBasedWall(wallHandle)) THEN
	RoundWallRadius := 5729.28 / ((100 * HAngle(wallHandle)) / HLength(wallHandle));
END;

BEGIN
	MoveTo( StartPt.x, StartPt.y );
	LineTo( EndPt.x, EndPt.y );
	LineHand := LNewObj;
	GetAngleFromLineFunc := HAngle( LineHand );
	DelObjectClearHandProc( LineHand );
END;

import vs

# Function HAngle returns the angle of the referenced object.
h = vs.FSActLayer()  # handle to the first selected object on the active layer

angle = vs.HAngle(h)
vs.Message('HAngle returned: ' + str(angle))

Version

Availability: from All Versions

Category

• Object Info