| Package | away3d.containers |
| Class | public class View3D |
| Inheritance | View3D flash.display.Sprite |
| Property | Defined by | ||
|---|---|---|---|
| background : Sprite
A background sprite positioned under the rendered scene.
| View3D | ||
| camera : Camera3D
Camera used when rendering.
| View3D | ||
| clip : Clipping
Clipping area used when rendering.
| View3D | ||
| findhit : FindHit
Traverser used to find the current object under the mouse.
| View3D | ||
| hud : Sprite
A container for 2D overlays positioned over the rendered scene.
| View3D | ||
| mouseMaterial : IUVMaterial
Current material under the mouse.
| View3D | ||
| mouseObject : Object3D
Current object under the mouse.
| View3D | ||
| mouseZeroMove : Boolean
Forces mousemove events to fire even when cursor is static.
| View3D | ||
| primitives : Array
temporary store for rendered primitives.
| View3D | ||
| renderer : IRenderer
Renderer object used to traverse the scenegraph and output the drawing primitives required to render the scene to the view.
| View3D | ||
| scene : Scene3D
Scene used when rendering.
| View3D | ||
| session : AbstractRenderSession
Session object used to draw all drawing primitives returned from the renderer to the view container.
| View3D | ||
| sourceURL : String
Optional string for storing source url.
| View3D | ||
| stats : Boolean
Enables/Disables stats panel.
| View3D | ||
| statsOpen : Boolean
Keeps track of whether the stats panel is currently open.
| View3D | ||
| statsPanel : Stats
Object instance of the stats panel.
| View3D | ||
| Method | Defined by | ||
|---|---|---|---|
|
View3D
(init:Object = null)
Creates a new
View3D object. | View3D | ||
|
addOnMouseDown(listener:Function):void
Default method for adding a mouseDown3D event listener.
| View3D | ||
|
addOnMouseMove(listener:Function):void
Default method for adding a mouseMove3D event listener.
| View3D | ||
|
addOnMouseOut(listener:Function):void
Default method for adding a mouseOut3D event listener.
| View3D | ||
|
addOnMouseOver(listener:Function):void
Default method for adding a mouseOver3D event listener.
| View3D | ||
|
addOnMouseUp(listener:Function):void
Default method for adding a mouseUp3D event listener.
| View3D | ||
|
addSourceURL(url:String):void
Defines a source url string that can be accessed though a View Source option in the right-click menu.
| View3D | ||
|
clear():void
Clears previuosly rendered view from the session.
| View3D | ||
|
fireMouseMoveEvent(force:Boolean = false):void
Manually fires a mouseMove3D event.
| View3D | ||
|
flush():void
Completes the rendering of a view by flushing the session
| View3D | ||
|
getBitmapData():BitmapData
Returns the
bitmapData of the rendered scene. | View3D | ||
|
getContainer():DisplayObject
Returns the
DisplayObject container of the rendered scene. | View3D | ||
|
removeOnMouseDown(listener:Function):void
Default method for removing a mouseDown3D event listener.
| View3D | ||
|
removeOnMouseMove(listener:Function):void
Default method for removing a mouseMove3D event listener.
| View3D | ||
|
removeOnMouseOut(listener:Function):void
Default method for removing a mouseOut3D event listener.
| View3D | ||
|
removeOnMouseOver(listener:Function):void
Default method for removing a mouseOver3D event listener.
| View3D | ||
|
removeOnMouseUp(listener:Function):void
Default method for removing a mouseUp3D event listener.
| View3D | ||
|
render():void
Renders a snapshot of the view to the render session's view container.
| View3D | ||
| Event | Summary | Defined by | ||
|---|---|---|---|---|
| Dispatched when a user presses the let hand mouse button while the cursor is over a 3d object | View3D | |||
| Dispatched when a user moves the cursor while it is over a 3d object | View3D | |||
| Dispatched when a user moves the cursor away from a 3d object | View3D | |||
| Dispatched when a user moves the cursor over a 3d object | View3D | |||
| Dispatched when a user releases the let hand mouse button while the cursor is over a 3d object | View3D | |||
| background | property |
public var background:Sprite
A background sprite positioned under the rendered scene.
| camera | property |
| clip | property |
public var clip:Clipping
Clipping area used when rendering.
If null, the visible edges of the screen are located with the Clipping.screen() method.
See also
| findhit | property |
public var findhit:FindHit
Traverser used to find the current object under the mouse.
See also
| hud | property |
public var hud:Sprite
A container for 2D overlays positioned over the rendered scene.
| _interactiveLayer | property |
arcane var _interactiveLayer:Sprite
| mouseMaterial | property |
| mouseObject | property |
| mouseZeroMove | property |
public var mouseZeroMove:Boolean
Forces mousemove events to fire even when cursor is static.
| primitives | property |
public var primitives:Array
temporary store for rendered primitives.
| renderer | property |
renderer:IRenderer [read-write]Renderer object used to traverse the scenegraph and output the drawing primitives required to render the scene to the view.
Implementation public function get renderer():IRenderer
public function set renderer(value:IRenderer):void
| scene | property |
| session | property |
session:AbstractRenderSession [read-write]Session object used to draw all drawing primitives returned from the renderer to the view container.
Implementation public function get session():AbstractRenderSession
public function set session(value:AbstractRenderSession):void
See also
| sourceURL | property |
public var sourceURL:String
Optional string for storing source url.
| stats | property |
| statsOpen | property |
public var statsOpen:Boolean
Keeps track of whether the stats panel is currently open.
See also
| statsPanel | property |
| View3D | () | constructor |
public function View3D(init:Object = null)
init:Object (default = null) — [optional] An initialisation object for specifying default instance properties.
|
stats:Boolean (default = true) | |
scene:ObjectOrInit (default = Scene3D) | |
camera:ObjectOrInit (default = Camera3D) | |
renderer:Object | |
session:Object | |
clip:Object (default = Clipping) | |
x:Number (default = 0) | |
y:Number (default = 0) |
| addOnMouseDown | () | method |
public function addOnMouseDown(listener:Function):void
Default method for adding a mouseDown3D event listener.
Parameterslistener:Function — The listener function.
|
| addOnMouseMove | () | method |
public function addOnMouseMove(listener:Function):void
Default method for adding a mouseMove3D event listener.
Parameterslistener:Function — The listener function.
|
| addOnMouseOut | () | method |
public function addOnMouseOut(listener:Function):void
Default method for adding a mouseOut3D event listener.
Parameterslistener:Function — The listener function.
|
| addOnMouseOver | () | method |
public function addOnMouseOver(listener:Function):void
Default method for adding a mouseOver3D event listener.
Parameterslistener:Function — The listener function.
|
| addOnMouseUp | () | method |
public function addOnMouseUp(listener:Function):void
Default method for adding a mouseUp3D event listener.
Parameterslistener:Function — The listener function.
|
| addSourceURL | () | method |
public function addSourceURL(url:String):void
Defines a source url string that can be accessed though a View Source option in the right-click menu. Requires the stats panel to be enabled.
Parametersurl:String — The url to the source files.
|
| clear | () | method |
public function clear():void
Clears previuosly rendered view from the session.
See also
| dispatchMouseEvent | () | method |
| fireMouseMoveEvent | () | method |
public function fireMouseMoveEvent(force:Boolean = false):void
Manually fires a mouseMove3D event.
Parametersforce:Boolean (default = false) |
| flush | () | method |
public function flush():void
Completes the rendering of a view by flushing the session
See also
| getBitmapData | () | method |
public function getBitmapData():BitmapData
Returns the bitmapData of the rendered scene.
session is required to be an instance of BitmapRenderSession, otherwise an error is thrown.
BitmapData — The rendered view image.
|
— incorrect session object - require BitmapRenderSession.
|
See also
| getContainer | () | method |
public function getContainer():DisplayObject
Returns the DisplayObject container of the rendered scene.
DisplayObject — The DisplayObject containing the output from the render session of the view.
|
See also
| removeOnMouseDown | () | method |
public function removeOnMouseDown(listener:Function):void
Default method for removing a mouseDown3D event listener.
Parameterslistener:Function — The listener function.
|
| removeOnMouseMove | () | method |
public function removeOnMouseMove(listener:Function):void
Default method for removing a mouseMove3D event listener.
Parameterslistener:Function — The listener function.
|
| removeOnMouseOut | () | method |
public function removeOnMouseOut(listener:Function):void
Default method for removing a mouseOut3D event listener.
Parameterslistener:Function — The listener function.
|
| removeOnMouseOver | () | method |
public function removeOnMouseOver(listener:Function):void
Default method for removing a mouseOver3D event listener.
Parameterslistener:Function — The listener function.
|
| removeOnMouseUp | () | method |
public function removeOnMouseUp(listener:Function):void
Default method for removing a mouseUp3D event listener.
Parameterslistener:Function — The listener function.
|
| render | () | method |
public function render():void
Renders a snapshot of the view to the render session's view container.
See also
| mouseDown3D | event |
away3d.events.MouseEvent3D
Dispatched when a user presses the let hand mouse button while the cursor is over a 3d object
| mouseMove3D | event |
away3d.events.MouseEvent3D
Dispatched when a user moves the cursor while it is over a 3d object
| mouseOut3D | event |
away3d.events.MouseEvent3D
Dispatched when a user moves the cursor away from a 3d object
| mouseOver3D | event |
away3d.events.MouseEvent3D
Dispatched when a user moves the cursor over a 3d object
| mouseUp3D | event |
away3d.events.MouseEvent3D
Dispatched when a user releases the let hand mouse button while the cursor is over a 3d object
Complete View3D example based on V2.0
package
{
import away3d.containers.View3D;
import away3d.primitives.Sphere;
import flash.display.Sprite;
public class Basic01 extends Sprite
{
public function Basic01()
{
// create a viewport
var view:View3D = new View3D({x:275,y:200});
addChild(view);
// create a sphere and put it on the 3D stage
var sphere:Sphere = new Sphere();
view.scene.addChild(sphere);
// render the view
view.render();
}
}
}This code will create a new viewport (View3D), set it up and render a sphere. The x/y parameters passed to View3D should be exactly half the width/height of your SWF, so {x:275,y:200} is correct for the standard 550x400 pixel Flash Movie.
Place View3D in the middle of your SWF based on V1.9.2
var swd:Number=640;
var swh:Number=480;
var view:View3D=new View3D({x:swd / 2,y:swh / 2});