Canvas 3D - Quad Tag

From CDOT Wiki
Jump to: navigation, search

Quad Tag Reference

Back To XML 3D Main Page

Introduction

The Quad is one of the basic primitives that can be created on the fly. The Quad is a 2D face that can be displayed in a 3D world. The Quad Tag encompasses the various attributes that are associated with a Quad, such as position, size and orientation. In addition, the Quad can be textured with a predefined image from a specific location.

Tag Attributes

  • name
    • Usage: <quad name="myquad" />.
    • The name attribute is optional. If omited, the name is not used and thus cannot be retrieved within JavaScript.
    • The Quad is given an Identifier so that It can be retrieved and modified within JavaScript.
    • The name is a only accepts a string of Alpha-numeric characters.
  • position
    • Usage: <quad position="0.3, 5.5, 3.8" />.
    • The position attribute is optional. If omited, the position defaults to the Origin location at {0.0, 0.0, 0.0}.
    • The position attribute holds a set of three floating point numbers separated by commas that are associated with the distance away from the Origin Point on the X, Y, and Z axis.
  • orientation
    • Usage: <quad orientation="1.0, 1.0, 1.0" />.
    • The orientation attribute defines the direction in which the quad is facing. The direction is defined by a vector value.
    • The orientation value only accepts three numbers that are separated by commas.
  • size
    • Usage: <quad size="0.4" />.
    • The size attribute defines the size of the Quad on the screen.
    • The size value dictates the distance each face of the quad is away from it's center point.
  • texture
    • Usage: <quad texture="mytexture" />
    • The texture attribute contains the name identifier of a texture that is defined inside the canvas tag.
    • If the texture does not exist or is not defined, a default color of white is applied to the Quad.
    • The attribute must be Alpha-numeric and must point to a defined texture tag.

Syntax

<canvas>
  <Quad name="myquad" position="0.0, 0.3, 0.5" orientation="0.2, 0.6, 1.3" size="1.9" texture="mytexture" />
</canvas>

References

  • None.