com.motorola.iden.micro3d
Class Point

java.lang.Object
  |
  +--com.motorola.iden.micro3d.Object3D
        |
        +--com.motorola.iden.micro3d.Primitive
              |
              +--com.motorola.iden.micro3d.Point

public class Point

extends Primitive

Point primitive. The Point primitive is a single pixel point. Only the color and blending type can be specified for a point. If a texture or a sphere texture is assigned to a Point object, it will be ignored and will not affect rendering. Point also will not be affected by the lighting parameters. Color key transparency is not applicable to a point.

A point is defined by a single Vector3D object which contains the coordinates of the point. Therefore the only valid vertex ID for the Point is Primitive.VERTEX_A. It is not possible to assign a vertex normal or a face normal to a point.

MOTOROLA and the Stylized M Logo are registered trademarks of Motorola, Inc. Reg. U.S. Pat. & Tm. Off.
© COPYRIGHT 2003-2004 MOTOROLA, Inc. All Rights Reserved.

Fields inherited from class com.motorola.iden.micro3d.Primitive

BLENDING_ADD, BLENDING_HALF, BLENDING_NONE, BLENDING_SUB, FACE_NORMAL, NORMAL, VERTEX_A, VERTEX_B, VERTEX_C, VERTEX_D

Constructor Summary

Point(Vector3D vertexA, Layout3D layout, int color)
Creates a Point primitive with the coordinates described by vertexA parameter.

Method Summary

Vector3D	getVector(int vectorID) Returns the Vector3D for the specified vertex.
void	setVector(int vectorID, Vector3D vector) Sets the specified vertex to the Vector3D provided.

Methods inherited from class com.motorola.iden.micro3d.Primitive

enableColorKeyTransparency, getBlendingType, getColor, hasColorKeyTransparency, setBlendingType, setColor

Methods inherited from class com.motorola.iden.micro3d.Object3D

getLayout, getSphereTexture, getTexture, setLayout, setSphereTexture, setTexture

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Point

public Point(Vector3D vertexA,
             Layout3D layout,
             int color)
      throws java.lang.NullPointerException

Creates a Point primitive with the coordinates described by vertexA parameter. The Point will be rendered using the color and Layout3D provided. If the specified Layout3D is null the point will not be rendered. The specified vertex cannot be null. See Graphics for information on specifying RGB values.

Parameters:

vertexA - the vertex for the point.

layout - the Layout3D to use to render this Point.

color - the color to render this point with.

Throws:

java.lang.NullPointerException - if the specified vertex is null.

See Also:

Graphics

Method Detail

getVector

public Vector3D getVector(int vectorID)
                   throws java.lang.IllegalArgumentException

Returns the Vector3D for the specified vertex. Point only supports Primitive.VERTEX_A.

Overrides:

getVector in class Primitive

Parameters:

vectorID - the ID of the vector to return.

Returns:

the Vector3D for the specified vertex.

Throws:

java.lang.IllegalArgumentException - if an invalid vectorID is specified.

See Also:

Primitive.VERTEX_A

setVector

public void setVector(int vectorID,
                      Vector3D vector)
               throws java.lang.NullPointerException,
                      java.lang.IllegalArgumentException

Sets the specified vertex to the Vector3D provided. Point only supports Primitive.VERTEX_A. It is not possible to assign a normal or a face normal to a point.

Overrides:

setVector in class Primitive

Parameters:

vectorID - the ID of the vector being set.

vector - the Vector3D to set.

Throws:

java.lang.IllegalArgumentException - if an invalid vectorID is specified.

java.lang.NullPointerException - if the vector is null.

See Also:

Primitive.VERTEX_A