Setting Up Papervision3D in Eclipse/FDT3

I’ve recently decided to take the plunge and start playing around a bit with Papervision3D. I’ve seen too many cool things coming out of that camp and I wanted to get my hands down and dirty and experimenting with the possibilities to move my work forward. I use Eclipse/FDT3 on a Mac so getting up and running with PV3D was relatively simple.

If you haven’t yet, now would probably be a good time to read over my setup tutorial with Eclipse and FDT3 as that is what we are going to be using in this as well.

The first thing people who want to start playing with PV3D realize is that there is no way to download the classes (as of this writing) in just a simple zip file. You can download version 1.5 that way from the Google Code homepage for Papervision3D but you cannot download the latest 2.0 version (named GreatWhite) unless you know how to use Subversion. I won’t get into Subversion here and what it is because there are plenty of great resources out there for that information but I will show you how to get a Subversion client up and running in Eclipse.

Step 1: Installing Subclipse
Eclipse doesn’t come pre-packaged with a Subversion perspective like it does with a CVS one so we’ll be using a perspective called Subclipse which is the best SVN perspective I have found for Eclipse. It’s really simple to use actually and very simple to install. After you’ve opened Eclipse, go to Help > Software Updates > Find & Install. Select Search for new features to install and click Next. Click the New Remote Site button and and in the New Update Site window enter Subclipse for the name and http://subclipse.tigris.org/update_1.2.x for the URL. Click OK and then Finish.

Installing Subclipse.

When Eclipse finds Subclipse, it will bring up the Updates dialog where you want to click the little triangle next to Subclipse and select Subclipse Plugin. If you don’t do this, Subclipse will tell you there is an error because you need some Buckminster plug-in and I have no clue what that is nor do I need it so just trust me on this one. 😛 Once you got that selected, click Next and accept the terms and click Next again and then click Finish.

Subclipse will begin to download and you will be alarmed that it is not digitally signed. This is fine so go ahead and click Install All. When you get asked to restart, click Yes and let Eclipse restart itself. You will then be asked for the workspace you want to use when it re-launches so go ahead and use whatever workspace you are working in (I’m still using Eclipse Setup from the previous tutorial).

Step 2: Download GreatWhite
We now have a Subversion client that we could use to download GreatWhite so let’s get started. Open up the Subclipse perspective by going to Window > Open Perspective > Other > SVN Repository Exploring. You will see a window open up here that has a tab for SVN Repository and SVN Annotate. In the SVN Repository tab right-click and select New > Repository Location. The code base for Papervision3D is hosted on Google Code at http://code.google.com/p/papervision3d/ so if you go to that site and click on Source and see that the SVN checkout URL is http://papervision3d.googlecode.com/svn/trunk/. Click the Finish button.

You will now have a tree view of the PV3D repository in the SVN Repository window. Open it up and then open branches > GreatWhite. Here is what we want to grab out of the repository. Right-click the GreatWhite folder and select Checkout. We will select the Check out as a project configured using the New Project Wizard option and click Finish. Then select Flash > New Flash Project and click Next. Let’s give the project the name Papervision3D and de-select Use default location. The reason I am doing this is because I’m going to store PV3D in my code bank that I talked about in the previous tutorial so that I can have it in one centralized spot on my hard drive and add it as a linked resource in FDT. So I’m going to click Browse and locate my code bank and put it in there. Then click Finish. When you get asked to Confirm Overwrite, click OK and the downloading of the repository begins to your specified location on your hard drive.

We can now see on our hard drive that we have a Papervision3D folder in our code bank and we can use this as a linked resource in FDT3 for when we want to develop Papervision3D projects. We probably want to save this in our preferences so that we can load it up in any project in the future so lets do that. Go to Eclipse > Preferences > General > Workspace > Linked Resources and click New. Let’s put GreatWhite in for the name and click the Folder button to search for our Papervision3D folder. Once you find the folder, click into it and select the src folder. This is where the files that we want to add in for use in FDT are. Select Choose and the PV3D source files will be added to our linked resources.

When you want to use PV3D in a project in the future, all you have to do is right-click in your Flash Explorer for your project and go to New > Linked Libraries. Click Add and select GreatWhite from the list of linked libraries. Click OK and then Finish and you can now use it in your projects.

As you can see it’s pretty easy to get up and running with Papervision3D in Eclipse and FDT3. If you have any questions, please don’t hesitate to ask and enjoy your adventures in the wonderful world of Flash and 3D!

Resources:

If you found this post useful, please consider leaving a comment, subscribing to the feed, or making a small donation.

2 Comments

[…] Example Get Papervision3D [Tutorial] Get TweenMax Download […]

[…] Example Get Papervision3D [Tutorial] Get TweenMax Download […]

Leave a comment

(required)

(required)