Guide to Getting Started in Papervision 3D

Starting Out

What tools should I use to developer with Papervision?

You have a couple choices when it comes to working with Papervision. Both Flash and Flex are options for publishing and you can use just about any text editor you wish. For the purpose of this tutorial, I am going to use FlashDevelop (www.flashdevelop.org) and the Flash IDE (www.adobe.com). When I am on my Mac, I prefer using TextMate (www.macromates.com)

What else do I need to start today?

Along with the tools, you also need the Papervision engine itself. To get this you need an SVN client. If you are using a PC I would recommend using Tortoise SVN (tortoisesvn.tigris.org) and on a Mac I have found that SvnX (http://www.apple.com/downloads/macosx/development_tools/svnx.html) to be useful.

Once you have installed one of those applications, you will need to connect to the Papervision repository (where they keep their code), it can be found here: http://papervision3d.googlecode.com/svn/trunk/ . If you already understand how subversion works and know how to work with it, please skip this section. I have included it because I was inexperience with SVN when I started working with Papervision and had to figure it out on my own when trying to get set up with Papervision.

With Tortoise, you can open windows explorer, go to the file menu. Tortoise will have added itself to that menu, so highlight Tortoise SVN and click Repo-browser to pop-open a dialog where you paste the above link to the SVN. This will open a SVN browser window with a couple of folders in it. For the purpose of this tutorial we are going to navigate to: http://papervision3d.googlecode.com/svn/trunk/as3/trunk/src . Right click the src folder and click checkout. Browse for the folder that you would like to store it in (or create a new one) and submit. The Papervision source code is now downloading.

With SvnX open the repository window and add a repository with the above path. Check out to a local folder of your choosing and let that download.

Hence forth, any time you would like to see if the source has been updated you can go to these folders and use Tortoise to update. With SvnX you will have to open the application and update from there.

Once you are synced up with the repository I would recommend loading Flash and going to Edit > Preferences. Go to the ActionScript category and select ActionScript 3.0 Settings. You are now faced with a list of classpaths (if you are like me), or a blank classpath window. Either way, click the little plus sign and then the target icon. Navigate to the folder that you just checked Papervision out to and click OK. Now you had made it so that if you ever want to use Papervision, Flash knows where to find the package.

A little tip: FlashDevelop also has classpaths that it uses for highlighting and auto-completion. I recommend adding the Papervision path to that list as well. This can be done by going to Tools > Global ClassPaths. That will open a dialog where you can set classpaths in any one of a number of languages, for this tutorial select AS3 from the combo box and click Add Classpath. Navigate to the Papervision path and you are good to go.

Now you are ready to being coding with Papervision.

Leave a Reply

Your email address will not be published. Required fields are marked *