SclGraphicsInsertEllipse

Overview

Insert an ellipse into the currently open node of the graphics database.

Synopsis

SclGraphicsInsertEllipse $xcen $ycen $zcen $xmajor $ymajor $zmajor $xminor $yminor $zminor

Description

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

Arguments

xcen, ycen, zcen

Pass by value. The XYZ coordinates of the centre of the ellipse.

xmajor, ymajor, zmajor

Pass by value. The XYZ coordinates of one end of the major axis of the ellipse.

xminor, yminor, zminor

Pass by value. The XYZ coordinates of one end of the minor axis of the ellipse.

Returns

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

Examples

#
# Create a node and insert an ellipse
#
SclGraphicsOpen mygraphicsnode
  # insert the circle and remember its key
  set key [SclGraphicsInsertEllipse 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