3. Creating a Papervision Base Template

Published

on January 20, 2008

The first thing that you should do when creating a Papervision 3D project is to create a "Base Class" which will serve as a template to speed up the start of each papervision project you attempt.

1) Create a new FlashDevelop Project

Open up FlashDevelop. On the start page, click on the New: Project... Under the Recent Projects Window.

New Project....

The New Project dialog box will appear. Under Actionscript 3, click Empty Project. Type a name into the Name textbox, and tick the box labelled "Create Directory for Project".

New Project Dialog
(Click To Enlarge)

Click OK to close the dialog box. You will now see your project under the Project window. We need to add a source file to the project.

The first thing you need to do to your project is to import the papervision source so that your program can use it. From the menu at the top, choose Project, then Settings.

The Project settings dialog box will appear. Click on the Classpaths tab and click Add Classpath.

You now need to browse to the folder in which you downloaded the GreatWhite source code in tutorial number 2. Select the greatwhite folder (It should contain directories called org, fl and com) and click OK.

You should now have an icon which looks like a Lego Brick containing the GreatWhite source code under your project.

Project Tree

You now need to make a script to be executed when your program runs. Right click on your project in the project tree and goto Add > New Class.

Add New Class

Name the new class PaperBase.as and click OK. You will now have the Main.as file open in your editor. The code will look like this:

PLAIN TEXT

Actionscript:

/**
* ...
* @author Default
* @version 0.1
*/
package {
public class PaperBase {
public function PaperBase() {
}
}
}

This is a blank class. Firstly, we need to make this class compile when we run the project. To do this, right click on Main.as under the project tree and select "Always Compile".

We also need to specify the output SWF location. To do this, from the Project menu, select Properties.

On the Output tab under General, you'll see an input box labeled "Output File". Click Browse and choose where to place the output file.

Now, change the source code so that it looks this (Comments in the code explain each step of the way):

PLAIN TEXT

Actionscript:

package {
// These lines make differant 'pieces' available in your code.
import flash.display.Sprite; // To extend this class
import flash.events.Event; // To work out when a frame is entered.
import org.papervision3d.view.Viewport3D; // We need a viewport
import org.papervision3d.cameras.*; // Import all types of camera
import org.papervision3d.scenes.Scene3D; // We'll need at least one scene
import org.papervision3d.render.BasicRenderEngine; // And we need a renderer
public class PaperBase extends Sprite { //Must be "extends Sprite"
public var viewport:Viewport3D; // The Viewport
public var renderer:BasicRenderEngine; // Rendering engine
// -- Scenes -- //
public var default_scene:Scene3D; // A Scene
// -- Cameras --//
public var default_camera:Camera3D; // A Camera
public function init(vpWidth:Number = 800, vpHeight:Number = 600):void {
initPapervision(vpWidth, vpHeight); // Initialise papervision
init3d(); // Initialise the 3d stuff..
init2d(); // Initialise the interface..
initEvents(); // Set up any event listeners..
}
protected function initPapervision(vpWidth:Number, vpHeight:Number):void {
// Here is where we initialise everything we need to
// render a papervision scene.
viewport = new Viewport3D(vpWidth, vpHeight);
// The viewport is the object added to the flash scene.
// You 'look at' the papervision scene through the viewport
// window, which is placed on the flash stage.
addChild(viewport); // Add the viewport to the stage.
// Initialise the rendering engine.
renderer = new BasicRenderEngine();
// -- Initialise the Scenes -- //
default_scene = new Scene3D();
// -- Initialise the Cameras -- //
default_camera = new Camera3D(); // The argument passed to the camera
// is the object that it should look at. I've passed the scene object
// so that the camera is always pointing at the centre of the scene.
}
protected function init3d():void {
// This function should hold all of the stages needed
// to initialise everything used for papervision.
// Models, materials, cameras etc.
}
protected function init2d():void {
// This function should create all of the 2d items
// that will be overlayed on your papervision project.
// User interfaces, Heads up displays etc.
}
protected function initEvents():void {
// This function makes the onFrame function get called for
// every frame.
addEventListener(Event.ENTER_FRAME, onEnterFrame);
// This line of code makes the onEnterFrame function get
// called when every frame is entered.
}
protected function processFrame():void {
// Process any movement or animation here.
}
protected function onEnterFrame( ThisEvent:Event ):void {
//We need to render the scene and update anything here.
processFrame();
renderer.renderScene(default_scene, default_camera, viewport);
}
}
}

This is heavily commented, so it should explain everything that's happening.

When you run the project, you'll just see a blank screen, this is expected because you haven't added anything to the scene yet.

You can download the source file with the code comments or without using the links below:

Download Now

This file will now be used as the basis of any papervision projects that you do, and with very few lines added to that code, you can get really good results.

*EDIT*

Updated 20th August 2008, now works with the GreatWhite codebase changes

65 Responses to “3. Creating a Papervision Base Template”

Feed for this Entry Trackback Address

1 Dan Zen
October 22, 2008 at 5:15 pm

Sorry - looks like it was finding my old papervision which is odd because I put in a class path that was higher up… now getting a viewport error - will look into that - saw mention of it up above somewhere…
2 Clay
October 29, 2008 at 7:50 pm

Running process: C:\Documents and Settings\cbinion\Local Settings\Application Data\FlashDevelop\Tools\fdbuild\fdbuild.exe “C:\Documents and Settings\cbinion\My Documents\Testing\Testing.as3proj” -ipc e4deff2b-ca3a-485a-badc-d7d90d960ade -compiler “C:\Documents and Settings\cbinion\Desktop\Tests\Flex” -library “C:\Documents and Settings\cbinion\Local Settings\Application Data\FlashDevelop\Library” -cp “C:\Program Files\Adobe\Adobe Flash CS3\en\Configuration\ActionScript 3.0\Classes” -cp “C:\Program Files\Adobe\Adobe Flash CS3\en\Configuration\Component Source\ActionScript 3.0\User Interface”
HINT: Improve your build speed when compiling in FlashDevelop3 by placing the Adobe Flex Compiler Shell in your Flex2 bin path.
Building Testing
mxmlc -load-config+=obj\TestingConfig.xml -debug=true -benchmark=false -o obj\Testing633608855776912593
Loading configuration file C:\Documents and Settings\cbinion\Desktop\Tests\Flex\frameworks\flex-config.xml
Loading configuration file C:\Documents and Settings\cbinion\My Documents\Testing\obj\TestingConfig.xml
C:\Documents and Settings\cbinion\My Documents\Testing\PaperBase.as(2): col: 7 Error: Syntax error: package is unexpected.

package {
^

Build halted with errors (mxmlc).
Done (1)

So what does all this mean?
3 Wilbo
October 30, 2008 at 4:53 pm

Hi, first up, ace tutorials - wish all tuts were as good as this.

OK now for my questions!
1. I downloaded the source by following the link at the top of Tutorial 2 but I only have two folders: org and nochump instead of org com and fla. Is this right? Will it still work?

2. When you specify the output file, does it matter what I call it?

3.I don’t get main.as when I add a new class, I just get PaperBase.as. I assume this is the same, right?

I tried to run it and I got a whole mess of errors, so I’m guessing that I have a problem with one of the above.

Thanks for the great site,

Wilbo
4 Wilbo
October 30, 2008 at 5:05 pm

Should I still be getting the Greatwhite thing?
5 Riccardo Bartoli
November 9, 2008 at 8:20 pm

It’s better to use this class or to extend BasicView?
6 hrodgair
November 12, 2008 at 5:37 pm

Hi,

I’ve been trying to get into Papervision for a while now, and this site is just what I was looking for. These tuts are just awesome. Thanks Luke! But I keep getting 2 errors whenever I compile a project.

This is what the output says:

[path\to\]AbstractLightShadeMaterial.as(34): col: 12 Error: Implicit coercion of a value of type String to an unrelated type org.papervision3d.objects:DisplayObject3D.

[path\to\]CompositeMaterial.as(32): col: 12 Error: Implicit coercion of a value of type String to an unrelated type org.papervision3d.objects:DisplayObject3D.

I get the same output in Flash CS3.

I downloaded the last version of Papervision. I was getting this error before, with version 1.5, and upgraded, but with no success. I’m running it on Win XP in a 2Quad CPU Q6600 @ 2.41GHz with 4GB of RAM

Any clues on what the heck is going on?
7 peter
November 12, 2008 at 5:51 pm

Hello
I do not understand these lines

default_camera = new Camera3D(); // The argument passed to the camera
// is the object that it should look at. I’ve passed the scene object
// so that the camera is always pointing at the centre of the scene.

do you mean in future code you pass this
maybe like
default_camera (object to point at)

sorry is this is a dumb question
but I am a newbie
your tut’s rock
8 Tony D
February 8, 2009 at 4:55 am

Great Tutorials!

I’m very new to papervision and am having trouble getting the blank example to run. this is what is coming up in the output -

Running process: C:\Program Files\FlashDevelop\Tools\fdbuild\fdbuild.exe “C:\Documents and Settings\tony.dimovski\Desktop\other\PaperBase\PaperBase.as3proj” -ipc bcf670df-9298-4ee6-89ba-7a5f19e02068 -compiler “C:\Documents and Settings\tony.dimovski\Desktop\other\flex2″ -library “C:\Program Files\FlashDevelop\Library”
Building PaperBase
mxmlc -load-config+=obj\PaperBaseConfig.xml -debug=true -benchmark=false -o obj\PaperBase633696461124531250
Exception: The system cannot find the file specified
Done (1)

Any help would be VERY VERY appreciated.

Thanks
9 Newbie T
March 4, 2009 at 7:05 am

Let me preface this with “I am new to this and annoying”. Now, I am having a slew of error messages related to type not count or call to a possibly undefined method. Any ideas?

C:\Documents and Settings\ \My Documents\paperbase\PaperBase.as(20): col: 23 Error: Type was not found or was not a compile-time constant: Viewport3D.

public var viewport:Viewport3D; // The Viewport
^

C:\Documents and Settings\ \My Documents\paperbase\PaperBase.as(21): col: 23 Error: Type was not found or was not a compile-time constant: BasicRenderEngine.

public var renderer:BasicRenderEngine; // Rendering engine
^

C:\Documents and Settings\ \My Documents\paperbase\PaperBase.as(23): col: 28 Error: Type was not found or was not a compile-time constant: Scene3D.

public var current_scene:Scene3D;
^

C:\Documents and Settings\Tyler Malin\My Documents\paperbase\PaperBase.as(24): col: 29 Error: Type was not found or was not a compile-time constant: CameraObject3D.

public var current_camera:CameraObject3D;
^

C:\Documents and Settings\ \My Documents\paperbase\PaperBase.as(25): col: 31 Error: Type was not found or was not a compile-time constant: Viewport3D.

public var current_viewport:Viewport3D;
^

C:\Documents and Settings\ \My Documents\paperbase\PaperBase.as(27): col: 28 Error: Type was not found or was not a compile-time constant: Scene3D.

public var default_scene:Scene3D; // A Scene
^

C:\Documents and Settings\ \My Documents\paperbase\PaperBase.as(29): col: 29 Error: Type was not found or was not a compile-time constant: Camera3D.

public var default_camera:Camera3D; // A Camera
^

C:\Documents and Settings\ \My Documents\paperbase\PaperBase.as(42): col: 20 Error: Call to a possibly undefined method Viewport3D.

viewport = new Viewport3D(stage.width, stage.height, true, true);
^

C:\Documents and Settings\ \My Documents\paperbase\PaperBase.as(44): col: 20 Error: Call to a possibly undefined method Viewport3D.

viewport = new Viewport3D(vpWidth, vpHeight, false, true);
^

C:\Documents and Settings\ \My Documents\paperbase\PaperBase.as(51): col: 19 Error: Call to a possibly undefined method BasicRenderEngine.

renderer = new BasicRenderEngine();
^

C:\Documents and Settings\Tyler Malin\My Documents\paperbase\PaperBase.as(53): col: 24 Error: Call to a possibly undefined method Scene3D.

default_scene = new Scene3D();
^

C:\Documents and Settings\ \My Documents\paperbase\PaperBase.as(55): col: 25 Error: Call to a possibly undefined method Camera3D.

default_camera = new Camera3D();
^

C:\Documents and Settings\ \My Documents\paperbase\PaperBase.as(11): col: 38 Error: Definition org.papervision3d.core.proto:CameraObject3D could not be found.

import org.papervision3d.core.proto.CameraObject3D;
^

C:\Documents and Settings\ \My Documents\paperbase\PaperBase.as(13): col: 32 Error: Definition org.papervision3d.view:Viewport3D could not be found.

import org.papervision3d.view.Viewport3D; // We need a viewport
^

C:\Documents and Settings\Tyler Malin\My Documents\paperbase\PaperBase.as(14): col: 35 Error: Definition org.papervision3d.cameras could not be found.

import org.papervision3d.cameras.*; // Import all types of camera
^

C:\Documents and Settings\ \My Documents\paperbase\PaperBase.as(15): col: 34 Error: Definition org.papervision3d.scenes:Scene3D could not be found.

import org.papervision3d.scenes.Scene3D; // We’ll need at least one scene
^

C:\Documents and Settings\ \My Documents\paperbase\PaperBase.as(16): col: 34 Error: Definition org.papervision3d.render:BasicRenderEngine could not be found.

import org.papervision3d.render.BasicRenderEngine; // And we need a renderer
^

Build halted with errors (mxmlc).
Done (1)
10 hellogrish
March 15, 2009 at 7:34 am

Newbie T, got the same problem, right click on your project (”PaperBase”)
>classpaths, and add path to your papervision code (folder where you have “nochump” and “org”)

g
11 Charlie
March 21, 2009 at 8:41 pm

Excuse me, I find that this example will also work if do not add the parentMovie. We can interact with material directly. So why do we need this hack tech to do the interaction. Is there any advantage?
12 Andrew
March 24, 2009 at 12:38 am

works a charm if you follow the tutorials step by step. Cheers
13 oren
March 30, 2009 at 10:41 am

what does that means?

Error: A file found in a source-path ‘paperBase’ must have the same name as the class definition inside the file ‘PaperBase’.
Build halted with errors (fcsh).
14 Vilmondes
April 21, 2009 at 12:18 am

i’m having the same problem of the Tony D.
Is showing the error:
‘Exception: The system cannot find the file specified’

Thanks!
15 Vilmondes
April 21, 2009 at 12:43 am

I solved the problem. Just need install de virtual machine java and it works ;D.