ARMeshNode Class Reference

#import <ARMeshNode.h>

Inherits ARNode.

Inherited by ARAlphaVideoNode, ARImageNode, ARPointNode, and ARVideoNode.

Class Methods
(instancetype)	+ testMeshNodeWithRed:green:blue:
(instancetype)	+ testMeshNodeWithTexture:
(instancetype)	+ meshNodeWithTexture:width:height:
(instancetype)	+ meshNodeWithRed:green:blue:width:height:
Class Methods inherited from ARNode
(instancetype)	+ nodeWithName:

Properties
ARMesh *	mesh
ARMaterial *	material
BOOL	cull
Properties inherited from ARNode
NSString *	name
ARNode *	parent
NSArray< ARNode * > *	children
NSArray *	descendants
ARVector3 *	position
ARVector3 *	scale
ARQuaternion *	orientation
ARMatrix4 *	localTransform
ARMatrix4 *	worldTransform
ARMatrix4 *	fullTransform
ARQuaternion *	fullOrientation
ARQuaternion *	worldOrientation
ARVector3 *	worldScale
ARVector3 *	worldPosition
ARVector3 *	fullPosition
ARNode *	world
NSUInteger	childCount
BOOL	visible

Additional Inherited Members
Instance Methods inherited from ARNode
(void)	- addChild:
(void)	- addChildren:
(void)	- removeChild:
(void)	- removeAllChildren
(void)	- remove
(ARNode *)	- findChildWithName:
(void)	- markWorldTransformAsDirty
(void)	- translateByX:y:z:
(void)	- translateByX:y:z:transformSpace:
(void)	- translateByVector:
(void)	- translateByVector:transformSpace:
(void)	- scaleByUniform:
(void)	- scaleByX:y:z:
(void)	- scaleByVector:
(void)	- rotateByDegrees:axisX:y:z:
(void)	- rotateByRadians:axisX:y:z:
(void)	- rotateByQuaternion:
(ARVector3 *)	- positionToWorld:
(ARVector3 *)	- positionToEye:
(ARQuaternion *)	- orientationToWorld:
(ARQuaternion *)	- orientationToEye:
(CGPoint)	- viewPortFromNodePosition:
(void)	- render
(void)	- preRender
(void)	- postRender
(void)	- addTouchTarget:withAction:
(void)	- didReceiveTouch
(ARVector3 *)	- nodeFromViewPort:
Protected Types inherited from ARNode
enum	TransformSpace { ARNodeTransformSpaceLocal, ARNodeTransformSpaceParent, ARNodeTransformSpaceWorld }

Detailed Description

An ARMeshNode is a subclass of ARNode that represents a drawable mesh. The geometry to be used, as well as its shading, is specified via this node. This class does not specify any of the mesh data, it simply contains an associated ARMesh.

Method Documentation

meshNodeWithRed:green:blue:width:height:

+ (instancetype) meshNodeWithRed:		(float)	red
green:		(float)	green
blue:		(float)	blue
width:		(float)	width
height:		(float)	height

Creates a mesh node with an RGB colour material made from the given red, green and blue colour values and dimensinos from the given width and height.

Parameters

red	Colour value between 0..1.
green	Colour value between 0..1.
blue	Colour value between 0..1.
width	Mesh width.
height	Mesh height.

Returns

ARMeshNode

meshNodeWithTexture:width:height:

+ (instancetype) meshNodeWithTexture:		(ARTexture *)	texture
width:		(float)	width
height:		(float)	height

Creates a mesh node with a textured material made from the given texture and dimensions from the given width and height.

Parameters

texture	The texture used to colour the mesh
width	Mesh width.
height	Mesh height.

Returns

ARMeshNode

testMeshNodeWithRed:green:blue:

+ (instancetype) testMeshNodeWithRed:		(float)	red
green:		(float)	green
blue:		(float)	blue

Creates a mesh node with a square test mesh with a RGB colour material and dimensions of 10x10.

Parameters

red	Colour value between 0..1.
green	Colour value between 0..1.
blue	Colour value between 0..1.

Returns

ARMeshNode

testMeshNodeWithTexture:

+ (instancetype) testMeshNodeWithTexture:

(ARTexture *)

texture

Creates a mesh node with a square test mesh with dimensions of 100x100.

Parameters

texture

The texture used to colour the mesh.

Returns

ARMeshNode

Property Documentation

cull

- (BOOL) cull

readwritenonatomicassign

Whether or not this mesh node uses face culling. The face culling mode is set in ARMaterial. Default is NO.

material

- (ARMaterial*) material

readwritenonatomicassign

The material to use for shading the mesh attached to this node. If the material is not specified, the shader cannot get any properties to correctly shade the mesh, so it will not be drawn. Materials can be shared between ARMeshNode objects.

Example of how to set a material:

ARModelImporter *importer = [[ARModelImporter alloc] initWithBundled:@"example.armodel"];
ARModelNode *modelNode = [importer getNode];
 
ARLightMaterial *lightMaterial = [[ARLightMaterial alloc] init];
lightMaterial.ambient.value = [ARVector3 vectorWithValues:0.7];
lightMaterial.colour.value = [ARVector3 vectorWithValuesX:0.6 y:0.6 z:0.6];
 
for (ARMeshNode *meshNode in modelNode.meshNodes)
{
   meshNode.material = lightMaterial;
}

mesh

- (ARMesh*) mesh

readwritenonatomicassign

The mesh geometry to use. Meshes can be shared between ARMeshNode objects.

---

The documentation for this class was generated from the following files:

• ARMeshNode.h
• ARMeshNode.m