Home Tutorials Forums Articles Blogs Movies Library Employment Press

Go Back   ActionScript.org Forums > ActionScript Forums Group > ActionScript 3.0

Reply
 
Thread Tools Rate Thread Display Modes
Old 11-07-2007, 09:59 AM   #1
matbury
What's up pussycat?
 
matbury's Avatar
 
Join Date: Dec 2006
Location: Toronto, Canada
Posts: 1,990
Default Where can I find some decent AS 3.0 documentation?

Ok, as far as I'm concerned, Flash AS 3.0 native documentation sucks.

Adobe's tutorials are great, I've learnt lots from them.

What I'd really like to know is if there's any really good reference material out there. What I'd really like to be able to do is look up a particular class or package and see comprehensive examples of all the methods, properties, etc. in use, with all the necessary syntax to make them work. (Like the old AS 2.0 documentation!).

Does anyone know where I can find that?
__________________
http://matbury.com/
matbury is offline   Reply With Quote
Old 11-07-2007, 10:08 AM   #2
panel
AS3
 
panel's Avatar
 
Join Date: Mar 2007
Location: Warsaw
Posts: 1,991
Send a message via Skype™ to panel
Default

Flex language reference
unfortunetly totady adobe server is down (First time as I recoll), so try tomorrow.
panel is offline   Reply With Quote
Old 11-07-2007, 11:08 AM   #3
matbury
What's up pussycat?
 
matbury's Avatar
 
Join Date: Dec 2006
Location: Toronto, Canada
Posts: 1,990
Default

Hi again panel,

I posted this thread because I'm dissatisfied with Adobe's native documentation for AS 3.0 and I'm hoping that someone can point in the direction of something more like what I'm looking for:

* Specific code examples for each method of the classes.

It's much easier to have this in a reference format that having to search through the limited number of application examples and tutorials in the hope of finding what I'm looking for.

The Actionscript 2.0 Bible (Wiley) was great for this but I still used Flash AS 2.0 help to fill in the gaps.

I've ordered the Actionscript 3.0 Bible but I'm wondering if there'llbe any gaps in that version (probably) and if so, I'll need some kind of reference to fill them in.

P.S. Here's an example of what I find insufficient in LiveDocs:

Quote:
Method Detail
startDrag () method

public function startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void

Parameters lockCenter:Boolean (default = false) — Specifies whether the draggable sprite is locked to the center of the mouse position (true), or locked to the point where the user first clicked the sprite (false).

bounds:Rectangle (default = null) — Value relative to the coordinates of the Sprite's parent that specify a constraint rectangle for the Sprite.

function mouseDown(event:MouseEvent):void {
circle.startDrag();
}
This is a shortened version, I'm sure you've all looked at this before. Where here can you find this?:

ActionScript Code:
import flash.geom.Rectangle; // no reference to this package or where to find it. var rectangle:Rectangle = new Rectangle(0,0,150,100); ///... circle.startDrag(false, rectangle); ///...

Call me lazy or stupid, but aren't code examples supposed to demonstrate ALL the aspects of a method not just give a brief summary that sends you rooting through yet more code examples just to find a few parameters?

Just 2 1/2 more lines of code could save so much hassle!
__________________
http://matbury.com/
matbury is offline   Reply With Quote
Old 11-07-2007, 11:15 AM   #4
producerism
Member
 
Join Date: Oct 2007
Posts: 95
Default

amen, the as3 documentation is kinda all over the place. you have to piece it together from various sources right now. I bet once Air is out of beta, and Flex 3 is out - the AS3 documentation for CS3 and Flex will start to trickle out and divide for each respective program.

It is a bit frustrating trying to stay on top of things, when you have to hunt it all down.
producerism is offline   Reply With Quote
Old 11-07-2007, 12:13 PM   #5
panel
AS3
 
panel's Avatar
 
Join Date: Mar 2007
Location: Warsaw
Posts: 1,991
Send a message via Skype™ to panel
Default

I got your point.
I agree documentation should me more accured especially when comes to examples.

Still I am not familiar with any 'bether documentation' to as3.
panel is offline   Reply With Quote
Old 11-07-2007, 12:32 PM   #6
senocular
six eyes
 
senocular's Avatar
 
Join Date: Jan 2003
Location: San Francisco, CA (USA)
Posts: 7,875
Send a message via ICQ to senocular Send a message via AIM to senocular Send a message via MSN to senocular Send a message via Yahoo to senocular
Default

There is no better documentation because... well, do you know how long it would take to make an example for EVERY class/method/property that shows ALL aspects of that particular API? Very long. So long no one else has come close or probably even tried (actually I know there were some community-based initiatives out there, but I'm pretty sure they're far from complete). AS3 has only been out for one cycle - actually a little more than one since it was out for Flex 2 before the CS3 release but that's still only a little more than a year (then again, maybe less because the cycle is only half-way through). Its a new language. Only so much can be done in so much time. If you think there's a hole, let adobe know.
adobe.com/go/wish
__________________
(6)
senocular is offline   Reply With Quote
Old 11-07-2007, 01:13 PM   #7
CyanBlue
Super Moderator
 
CyanBlue's Avatar
 
Join Date: Jan 2002
Location: Centreville, VA
Posts: 26,666
Default

A community driven code depot type of system would be nice...
__________________
CyanBlue / Jason Je / Macromedia Certified Flash Developer & Designer
http://CyanBlue.FlashVacuum.com
http://www.FlashVacuum.com
http://tutorials.FlashVacuum.com

Do NOT PM, Email or Call me... Your question belongs right in this forum...
CyanBlue is offline   Reply With Quote
Old 11-07-2007, 01:29 PM   #8
matbury
What's up pussycat?
 
matbury's Avatar
 
Join Date: Dec 2006
Location: Toronto, Canada
Posts: 1,990
Default

Maybe on Actionscript.org?!!

A wiki wouldn't be that hard to set up and the guys here could give the Adobe/Macromedia team a run for their money!
__________________
http://matbury.com/
matbury is offline   Reply With Quote
Old 11-07-2007, 01:36 PM   #9
CyanBlue
Super Moderator
 
CyanBlue's Avatar
 
Join Date: Jan 2002
Location: Centreville, VA
Posts: 26,666
Default

Not a bad idea... The question would be how to somehow integrate that with the existing 'Library' page of the site...
__________________
CyanBlue / Jason Je / Macromedia Certified Flash Developer & Designer
http://CyanBlue.FlashVacuum.com
http://www.FlashVacuum.com
http://tutorials.FlashVacuum.com

Do NOT PM, Email or Call me... Your question belongs right in this forum...
CyanBlue is offline   Reply With Quote
Old 11-07-2007, 01:52 PM   #10
matbury
What's up pussycat?
 
matbury's Avatar
 
Join Date: Dec 2006
Location: Toronto, Canada
Posts: 1,990
Default

Looks like someone's already trying to set one up at sourceforge:

http://sourceforge.net/projects/flashstdlib/

I think there's definitely a demand.
__________________
http://matbury.com/
matbury is offline   Reply With Quote
Reply


Thread Tools
Display Modes Rate This Thread
Rate This Thread:

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off

Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
Learning Actionscript 3.0 From 1.0 and 2.0 gfrank ActionScript 3.0 9 10-09-2007 05:57 PM
More documentation for Object hierarchy??? absolutezero3424 ActionScript 3.0 5 09-05-2007 05:20 PM
find all xml nodes with a specific parameter and value DrElvisToad ActionScript 3.0 8 08-17-2007 11:21 PM
Find x and y coordinates of a string in textbox Ryratt ActionScript 2.0 1 01-03-2007 01:18 AM
MX objects that i could not find documentation on jefmyers ActionScript 1.0 (and below) 0 04-18-2002 04:13 PM


All times are GMT. The time now is 09:46 AM.

///
Follow actionscriptorg on Twitter

 


Powered by vBulletin® Version 3.8.5
Copyright ©2000 - 2014, Jelsoft Enterprises Ltd.
Ad Management plugin by RedTyger
Copyright 2000-2013 ActionScript.org. All Rights Reserved.
Your use of this site is subject to our Privacy Policy and Terms of Use.