_images/ring.jpg _images/ringdiagram.png
ring(pos=vec(0, 0, 0), axis=vec(1, 0, 0), radius = 2, thickness = 0.2. color=color.cyan)
  • pos (vector) – Default <0,0,0>.

  • color (vector) – Default color.white

  • axis (vector) – Perpendicular to plane of ring. Default <1,0,0>.

  • radius (scalar) – Radius of the ring. Default 1.

  • thickness (scalar) – Half the diameter of the cross section of the ring. Default 0.1*radius.

  • size (vector) – Size of a box surrounding the object. Default <0.2, 2,2, 2.2>.

The pos of a ring is at its center. The axis of a ring determines only the orientation of the ring; the magnitude of axis is ignored. The default size of a ring is unusual: <0.2, 2, 2>. The outer radius is radius+thickness, and the inner radius is radius-thickness.

Setting radius or thickness overrides size. Size is < length, height, width>. To make the ring oval, specify size with different height and width.

Attributes used less often:

ring(opacity=0.5, shininess=0.2, texture=textures.wood, make_trail=True, canvas=mycanvas, emissive=False)
  • opacity (scalar) – Default 1.0; Range 0-1.

  • shininess (scalar) – Default 0.6; Range 0-1.

  • emissive (boolean) – Default False. Object glows, losing all shading, if True.

  • texture (class element or path) – Default None.

  • visible (boolean) – If False, object is not displayed. Default: True

  • canvas (object) – Default is scene.

  • make_trail (boolean) – If True, object leaves a trail when moved. See Attaching a Trail for more options.

  • up (vector) – A vector perpendicular to the axis.

  • group (object) – The group to which this object belongs.