Install

Papervision3D requires one Subversion client and one ActionScript editor.

Subversion clients - used to download Papervision3D files:

  1. svnX - Macintosh, open source
  2. TortoiseSVN - Windows, open source

ActionScript editors - used to create and edit Papervision3D files:

  1. Adobe Flash Builder
  2. Adobe Flash Professional
  3. FDT
  4. FlashDevelop - open source

Example

Top

Papervision3D Install

TortoiseSVN

Top

  1. Install TortoiseSVN
  2. Open Windows Explorer
  3. Click File
  4. Click New
  5. Click Folder, name folder svn - any location
  6. Right-click svn folder
  7. Click SVN Checkout...
  8. Under URL of Repository, type http://papervision3d.googlecode.com/svn/trunk/
  9. Click OK
  10. Click OK

Adobe Flash Builder

Top

  1. Install Adobe Flash Builder
  2. Open Adobe Flash Builder

Project:

  1. Click File
  2. Click New
  3. Click ActionScript Project
  4. After Project name:, type Example - any location except svn folder
  5. Click Finish

SVN:

  1. Click Project
  2. Click Properties
  3. Select ActionScript Build Path
  4. Select Source path tab, then click Add Folder...
  5. Click Browse...
  6. Select svn folder, then as3\trunk\src
  7. Click OK
  8. Click OK
  9. Click OK

AS:

  1. Copy and paste code below
  2. Click File
  3. Click Save

Run:

  1. Click Run
  2. Click Run Example

Adobe Flash Professional

Top

  1. Install Adobe Flash Professional
  2. Open Adobe Flash Professional

SVN:

  1. Click Edit
  2. Click Preferences...
  3. Under Category, select ActionScript
  4. Click ActionScript 3.0 Settings...
  5. Click Add New Path (plus icon)
  6. Click Browse To Path (target icon)
  7. Select svn folder, then as3\trunk\src
  8. Click OK
  9. Click OK
  10. Click OK

FLA:

  1. Click File
  2. Click New...
  3. Select General tab
  4. Select Flash File (ActionScript 3.0)
  5. Click OK
  6. Click Window
  7. Click Properties
  8. Click Properties
  9. After Document Class:, type Example
  10. Click File
  11. Click Save
  12. After File name:, type Example.fla - any location except svn folder
  13. Click Save

AS:

  1. Click File
  2. Click New...
  3. Select General tab
  4. Select ActionScript File
  5. Click OK
  6. Copy and paste code below
  7. Click File
  8. Click Save
  9. After File name:, type Example.as - same location as Example.fla
  10. Click Save

Test:

  1. Click Control
  2. Click Test Movie

FDT

Top

  1. Install FDT
  2. Open FDT
  3. Close Welcome

Project:

  1. Click File
  2. Click New
  3. Click New Flash Project
  4. After Project name:, type Example - any location except svn folder
  5. Click Finish
  6. Click Window
  7. Click Show View
  8. Click Flash Explorer
  9. Under Flash Explorer, select Example

SVN:

  1. Click Project
  2. Click Properties
  3. Select FDT Build Path
  4. Click Add Linked Libraries...
  5. Click Add...
  6. Click New...
  7. After Name:, type svn - or preferred name
  8. Click Folder...
  9. Select svn folder, then as3\trunk\src
  10. Click OK
  11. Click OK
  12. Click OK
  13. Click Finish
  14. Click OK

AS:

  1. Click File
  2. Click New
  3. Click Class
  4. After Source Folder:, type src
  5. After Class Name:, type Example
  6. Click Finish
  7. Copy and paste code below
  8. Click File
  9. Click Save

Run:

  1. Click Run
  2. Click Run
  3. Select FDT AS3 Application
  4. Click OK

FlashDevelop

Top

  1. Install Microsoft .NET Framework - 2.0+
  2. Install Java Runtime Environment - 1.6+
  3. Install Adobe Flex SDK - C:\flex_sdk_4 or preferred location
  4. Install Adobe Flash Player Debugger
  5. Install FlashDevelop
  6. Open FlashDevelop

SDK:

  1. Click Tools
  2. Click Program Settings...
  3. Under Plugins, click AS3 Context
  4. Under Language, after Flex SDK Location:, type C:\flex_sdk_4 - or preferred location
  5. Click Close

AS3PROJ:

  1. Click Project
  2. Click New Project...
  3. Under ActionScript 3, select Empty Project
  4. After Name:, type Example - any location except svn folder
  5. Click OK

SVN:

  1. Click Project
  2. Click Properties...
  3. Under Classpaths tab, click Edit Global Classpaths...
  4. Click Add Classpath...
  5. Select svn folder, then as3\trunk\src
  6. Click OK
  7. Click OK
  8. Click OK

AS:

  1. Click File
  2. Click New...
  3. Click Blank Document
  4. Copy and paste code below
  5. Click File
  6. Click Save
  7. After File name:, type Example.as - same location as Example.as3proj
  8. Click Save
  9. Click View
  10. Click Project Manager
  11. Right-click Example.as
  12. Check Always Compile

SWF:

  1. Click Project
  2. Click Properties...
  3. Under Output tab, after Output file:, type Example.swf - any location
  4. Click OK

Test:

  1. Click Project
  2. Click Test Movie

Code

Top

package
{
  import flash.display.Sprite;
  import flash.events.Event;

  import org.papervision3d.cameras.Camera3D;
  import org.papervision3d.events.InteractiveScene3DEvent;
  import org.papervision3d.materials.ColorMaterial;
  import org.papervision3d.objects.primitives.Plane;
  import org.papervision3d.render.BasicRenderEngine;
  import org.papervision3d.scenes.Scene3D;
  import org.papervision3d.view.Viewport3D;

  public class Example extends Sprite
  {
    private var scene    :Scene3D;
    private var camera   :Camera3D;
    private var viewport :Viewport3D;
    private var renderer :BasicRenderEngine;
    private var material :ColorMaterial;
    private var object   :Plane;

    public function Example()
    {
      scene = new Scene3D();

      camera = new Camera3D();

      viewport                  = new Viewport3D();
      viewport.autoScaleToStage = true;
      viewport.interactive      = true;
      addChild(viewport);

      renderer = new BasicRenderEngine();

      material             = new ColorMaterial(0x000000);
      material.doubleSided = true;
      material.interactive = true;

      object = new Plane(material);
      scene.addChild(object);

      object.addEventListener(InteractiveScene3DEvent.OBJECT_OVER, handleObjectOver);
      object.addEventListener(InteractiveScene3DEvent.OBJECT_OUT, handleObjectOut);
      object.addEventListener(InteractiveScene3DEvent.OBJECT_PRESS, handleObjectPress);

      addEventListener(Event.ENTER_FRAME, handleEnterFrame);
    }

    private function handleEnterFrame(e:Event):void
    {
      object.yaw(1);

      renderer.renderScene(scene, camera, viewport);
    }

    private function handleObjectOver(e:InteractiveScene3DEvent):void
    {
      viewport.containerSprite.buttonMode = true;
    }

    private function handleObjectOut(e:InteractiveScene3DEvent):void
    {
      viewport.containerSprite.buttonMode = false;
    }

    private function handleObjectPress(e:InteractiveScene3DEvent):void
    {
      material.fillColor = Math.random() * 0xFFFFFF;
    }
  }
}

Download