meshcontrols v0.3.4

In Development

MeshControls.JS

Events that make it easier to manipulate ThreeJS meshes as well as speed up development.

Demo

Open the console

Instantiate

index.html

<script src="/three.min.js"></script>
<script src="meshcontrols/MeshControls.mini.js"></script

yourScript.js

var meshControls = new THREE.MeshControls(camera,scene,domElement);
options = {
    draggable: Boolean,
    draggableOn: string of: "isLeftBtn", "isRightBtn", "isMiddleBtn";
}

meshControls.attach(<MESH or 3DObject>, options)

Event Listeners

meshControls.addEventListener("<TYPE>",function(event){

});

Event Types

Types are strings

• click
• mousemove
• mousedown
• mouseover
• mouseleave
• conatainermouseup
• conatainermouseleave
• mouseup
• dragstart
• drag
• dragend
• keydown
• keypress
• keyup

All Types are triggered for the specified attached objects except for:

conatainermouseup: triggers when mouseup on domElement
conatainermouseleave: triggers when mouseleave on domElement
mousedown: triggers when mousedown on domElement

API Core

MeshControls.mouseOverOnce = true; 
Default: to false if set to true, mouse event only fires once 
per hover otherwise it fires as long as the mouse hovers over the object.

MeshControls.attach() 
Adds the object from which you will be able to get events for.

MeshControls.dispose(<Mesh or 3Dobject>)
Accepts an object and removes the listeners from it.

MeshControls.disposeAll()
Removes listeners from all attached objects and dom.

MeshControls.removeListeners()
Removes all eventlisteners from document.

MeshControls.setMap(_Plane)
Sets the plane from which drag and drop cordinates can be intersected.

MeshControls.toThreeCords(clientX, clientY, domElement)
Returns x and y according to threejs vectors.