Tutorial: Away3D TypeScript: Primitives – Wireframe Cone

This is a quick overview tutorial of the WireframeCone primitive in the Away3D TypeScript library.

We will be recreating the scene as seen above.

To use a WireframeCone primitive, we’ll need to:

  • Declare, instantiate, and initialize a new WireframeCone object.
  • Add the WireframeCone object to the scene.

Notice, we do not place the wireframe in a Mesh object. This is because a Mesh would be overkill, trying to apply materials, shaders, and what have you. So just add the wireframe object as a child of the scene itself.

This tutorial builds off of the Away3D TypeScript: Primitives – Cone. All the new or changed code will be highlighted in the full code block below.

WireframeCone.ts

Line 5 renames the class to WireframeCone.

Line 17 declares a variable named _objectWireframe of type WireFrameCone().

Line 60 instantiates a new WireFrameCone object referenced by the variable _objectWireframe. It was initialized with 300, 450, 16, 1, 0xFFFFFF, 1: which we’ll discuss more later.

Line 61 adds the WireFrameCone object to the scene.

Lines 76-77 adds a spin to our WireFrameCone object on every frame of animation.

Line 102 changes the called class name to WireframeCone.

That’s it, our object is in the scene.

However, we glazed over the initialization process, let’s take a closer look at the object’s constructor.

Constructor

The constructor looks as follows:

The Constructor’s Parameters:

  • radius:Number (default = 50) — The radius of the cone.
  • height:Number (default = 100) — The height of the cone.
  • segmentsW:uint (default = 16) — Defines the number of horizontal segments that make up the cone. Defaults to 16.
  • segmentsH :uint (default = 1) — Defines the number of vertical segments that make up the cone. Defaults to 1.
  • color:uint (default = 0xFFFFFF) — The colour of the wireframe lines
  • thickness:Number (default = 1) — The thickness of the wireframe lines

So in our initialization we stated:

Which created a Cone:

  • 300 units radius. (Half of the circular width).
  • 450 units high (or long depending how you look at it).
  • 16 segments in the circular width.
  • 1 segment along the length.
  • color:uint (default = 0xFFFFFF) — The color of the wireframe lines
  • thickness:Number (default = 1) — The thickness of the wireframe lines

In Closing

Adding a basic primitive is relatively easy. Just understanding the constructor and what the parameters are, is the hardest part. You can look at the official documentation here. **As of this writing, this page of the documents is missing.

If this tutorial helped you, you can follow us on Facebook or Twitter to keep an eye out for more tutorials.

Posted in Away3D TypeScript, HTML, JavaScript Tagged with: , , , , , , , , , ,

Leave a Reply

Your email address will not be published. Required fields are marked *

*