SclGraphicsInsertCircularWedge

Overview

Insert a circular wedge into the currently open node of the graphics database. A circular wedge is pie like portion of a circle.

Synopsis

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

Description

This command inserts a circular wedge which is defined by three points on its circumference. The order of the points is important. The wedge starts at the first point, passes through the second point and terminates at the third point. Defining a wedge in this way permits an wedge of any orientation to be defined. The arc 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 circular wedge. If the wedge is to be parallel with the horizontal plane then use the same Z value for all 3 points. If these values place the wedge outside the screen extents the wedge will not be visible.

Returns

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

Examples

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