SclGraphicsInsertCircle

Overview

Insert a circle into the currently open node of the graphics database.

Synopsis

SclGraphicsInsertCircle $x1 $y1 $z1 $x2 $y2 $z2 $x3 $y3 $z3

Description

This command inserts a circle which is defined by three points on its circumference. Defining a circle in this way permits a circle of any orientation to be defined. The circle edge weight, edge pattern, and colour are determined by other SclGraphics commands.

Arguments

x1, y1, z1, x2, y2, z2, x3, y3, z3

Pass by value. The XYZ coordinates of three points on the circle circumference. If the circle is to be parallel with the horizontal plane then use the same Z value for all 3 points. If these values place the circle outside the screen extents the circle will not be visible.

Returns

The key to the circle so that it can be selectively deleted using SclGraphicsDeleteByKey.

Examples

#
# Create a node and insert a circle
#
SclGraphicsOpen mygraphicsnode
  # insert the circle and remember its key
  set key [SclGraphicsInsertCircle 100 200 50 110 210 50 120 200 50 ]
  # set the rendering attributes
  SclGraphicsSetColour "edges=yellow,faces=pink"
  SclGraphicsSetVisibility "faces=on"
  SclGraphicsSetEdgeWeight 2
  SclGraphicsSetEdgePattern "-.-."
  SclGraphicsSetFacePattern "##"
SclGraphicsClose
# and now make sure we can see it
SclGraphicsUpdateDisplay