[ P&SC ] Pentagrams & Summoning Circles v1.45 : real-time 3D geometry

Pentagrams & Summoning Circles is a set of functions that will allow you to draw, in real-time, various 2D and 3D geometric forms using a wide selection of media including visual effects and placeable objects.

The script should work on all versions. The demonstration module requires SoU and HotU 1.66.

Update August 11, 2005 : New star, sinusoid and gengon geometric forms; new pigpen code text font; new automatic Scan-and-Build waypoint system. Read attached text for details.

Update April 30, 2006 : visualeffects.2da in recolored visual effects pack now updated and compatible with patch 1.67.

=============================================
PENTAGRAMS & SUMMONING CIRCLES          v1.45
=============================================
gaoneng                      January 17, 2005
#include "inc_draw"

last updated on August 8, 2005
=============================================

This is an include script that should work with all versions, as I only used
basic math operators and some primeval functions. The demonstration module,
however, requires SoU and HotU 1.66, since that's what I have.


==========
WHAT'S NEW
==========

[] Added new geometric forms - gengon, star, star spiral, star spring, and
   sinusoid.
[] Added new text font - the pig-pen code.
[] Added new utility function - GroupPlayAnimation
[] Removed vector rotation calculations from all functions and replaced with
   simple custom function - this reduced the length of "inc_draw" by over 700
   lines.
[] Added new parameter to the text functions - fRotate - to adjust the facing
   of fonts directly.
[] Fixed an error where BeamPentacle and BeamPolygon attempt to close even if
   revolution is not full.
[] Added new extension library - gao_draw_build - which is a P&SC equivalent
   to the popular Dynamic Build system.


=========================
CURRENT LIST OF FUNCTIONS
=========================

There are currently eighty-one primary functions, thirty secondary functions,
seven utility functions and two extension function available in Pentagrams &
Summoning Circles. In total, one hundred and twenty functions are available.
Additionally, a sub-system of P&SC build is also now available for quick-and-
easy construction of geometric patterns.


[ primary functions ]

DrawCircle               PlaceCircle
DrawEllipse              PlaceEllipse
DrawEllipticalSpiral     PlaceEllipticalSpiral
DrawEllipticalSpring     PlaceEllipticalSpring
DrawHemisphere           PlaceHemisphere
DrawLineFromCenter       PlaceLineFromCenter       BeamLineFromCenter
DrawLineToCenter         PlaceLineToCenter         BeamLineToCenter
DrawPentacle             PlacePentacle             BeamPentacle
DrawPentaclicSpiral      PlacePentaclicSpiral      BeamPentaclicSpiral
DrawPentaclicSpring      PlacePentaclicSpring      BeamPentaclicSpring
DrawPolygon              PlacePolygon              BeamPolygon
DrawPolygonalHemisphere  PlacePolygonalHemisphere  BeamPolygonalHemisphere
DrawPolygonalSpiral      PlacePolygonalSpiral      BeamPolygonalSpiral
DrawPolygonalSpring      PlacePolygonalSpring      BeamPolygonalSpring
                                                   BeamCuboctahedron
                                                   BeamDodecahedron
                                                   BeamGengon
                         PlaceIcosahedron          BeamIcosahedron
                                                   BeamSmallRhombicuboctahedron
                         PlaceStellaOctangula      BeamStellaOctangula
                                                   BeamTriacontahedron
DrawEpicycloid           PlaceEpicycloid
DrawHypocycloid          PlaceHypocycloid
DrawRhodonea             PlaceRhodonea
DrawEpicycloidSpring     PlaceEpicycloidSpring
DrawHypocycloidSpring    PlaceHypocycloidSpring
DrawRhodoneaSpring       PlaceRhodoneaSpring
DrawSinusoid             PlaceSinusoid
DrawSphere               PlaceSphere
DrawSpiral               PlaceSpiral
DrawSpring               PlaceSpring
DrawStar                 PlaceStar                 BeamStar
DrawStarSpiral           PlaceStarSpiral           BeamStarSpiral
DrawStarSpring           PlaceStarSpring           BeamStarSpring
DrawToroidalSpiral       PlaceToroidalSpiral
DrawToroidalSpring       PlaceToroidalSpring
DrawTorus                PlaceTorus


[ secondary functions ]

ObjectBeamCuboctahedron             ObjectPlaceEllipticalSpring
ObjectBeamDodecahedron              ObjectPlaceEpicycloidSpring
ObjectBeamGengon                    ObjectPlaceHemisphere
ObjectBeamIcosahedron               ObjectPlaceHypocycloidSpring
ObjectBeamLineFromCenter            ObjectPlaceIcosahedron
ObjectBeamLineToCenter              ObjectPlacePentaclicSpring
ObjectBeamPentacle                  ObjectPlacePolygonalHemisphere
ObjectBeamPentaclicSpring           ObjectPlacePolygonalSpring
ObjectBeamPolygon                   ObjectPlaceRhodoneaSpring
ObjectBeamPolygonalHemisphere       ObjectPlaceSinusoid
ObjectBeamPolygonalSpring           ObjectPlaceSpring
ObjectBeamSmallRhombicuboctahedron  ObjectPlaceStellaOctangula
ObjectBeamStar                      ObjectPlaceToroidalSpring
ObjectBeamStarSpring
ObjectBeamStellaOctangula
ObjectBeamTriacontahedron


[ utility functions ]

GroupApplyEffectToObject
GroupDestroyObject
GroupExecuteScript
GroupPlayAnimation
GroupSetFacing
GroupSetFacingPoint
GroupSetPlotFlag


[ extension functions ]

TextMessage
TextPigPenMessage