레퍼런스란 필요한 부분을 검색하여 원하는 정보를 찾아보는 대상을 의미 합니다. 레퍼런스는 그 자체로 이미 사전과 같은 역할을 하는 것인데 개발자 출신이 아닌 플래시 액션스크립터 지망생들은 이 레퍼런스를 어려워 하여 멀리하고 오히려 포털 검색으로 지식을 얻으려고 하는 경향이 있습니다.
차라리 검색을 구글에서라도 하면 상위에 리스트업 되는 Adobe 의 레퍼런스를 보게 될 텐데, 그것도 아니고 국내 포털 검색으로 주로 지식검색이나 카페에서 자신과 딱 맞는 케이스의 질문과 답변을 얻으려고 하니 참으로 딱한 상황이 아닐 수 없습니다. 이러한 경향은 지식검색이 만능이라고 생각하는 우리나라에서 좀더 두드러지는 경향이기도 하지만, 외국이라고 예외는 아니어서 RTFM 라는 재미있는 관용구도 있습니다.

어쨌건 이러한 형태의 레퍼런스에 친숙해 진다면 다른 언어로 개발하는 것도 꿈속의 일만은 아니게 되는것이죠. 우리에겐 레퍼런스가 있으니까요.

1. 패키지 영역

패키지는 여러 클래스의 묶음 단위라고 이해하면 어렵지 않습니다. 우리가 가장 많이 사용하는 flash.display 패키지를 클릭하면 아래쪽 클래스 영역의 내용이 flash.display 항목들로만 필터링 되서 보여지고, 본문 영역도 그에 맞게 화면이 변경 됩니다.
레퍼런스에서 패키지 영역은 일종의 대분류 목차와 같은 성격을 가지고 있습니다. 클래스 이름을 알고 있다면 굳이 클릭할 필요가 없는 영역이기도 하죠.

그러나 이 영역에만 있어 별도로 살펴봐야할 항목도 몇 가지 있습니다.
스크롤바를 죽 내려보면 “패키지” 부분과 “언어요소” 부분, 그리고 “부록” 부분이 있는데 이것들 중 아래에 나열한 것들은 한번 쯤 훑어 보고 뭐가 있는지는 파악해 놓는게 좋습니다.

• 최상위 : import 를 사용하지 않아도 바로 사용할 수 있는 클래스들과 전역상수, 전역함수 들이 나열되어 있습니다. 우리가 흔히 사용하는 Array, String, Number 등이 최상위 클래스에 속합니다.
• 연산자 : 사실상 액션스크립트의 모든 기호는 연산자 입니다. 게다가 new 같은 것들도 연산자의 범주에 들어갑니다.
• 명령문, 키워드 및 지시문 : 프로그래밍의 형식이나 골격을 구성하는 것들 입니다. package, class, public, var, this 등이 여기에 속합니다.
• ActionScript 2.0 마이그레이션 : AS2.0의 클래스, 메서드, 속성이 AS3.0 으로 어떻게 변경 되었는지 리스트업 되어있습니다. (이 문서가 여기 있다는것만 알면 됩니다.)

나머지 부분들은 읽어본다면 어떤 형태로건 도움이 될 수 있지만, 딱히 읽지 않아도 지장이 없는 부분이므로 대략 스물스물 넘어가도 되겠습니다.

2. 클래스 영역

이 영역은 크게 클래스와 인터페이스 항목으로 나뉘는데, 이 중 이탤릭체로 되어 있는 애들이 인터페이스 입니다. AS3.0을 처음 배워나가는 과정에서는 인터페이스를 몰라도 괜찮기도 하고, 이 포스트의 내용에서 벗어나는 내용이므로 다음 기회를 잡아 설명하도록 하겠습니다.

이 영역을 스크롤 해서 보면 액션스크립트에서 사용하는 모든 클래스들이 나열되어 있습니다. 클래스의 이름을 알고 있다면, 딱히 검색할 필요 없이 클릭으로 본문 영역에 필요한 정보를 펼칠 수가 있습니다.

3. 본문 영역

우리가 가장 흔하게 사용하는 객체인 Sprite 를 펼쳐보겠습니다.

(1) 패키지

이 클래스가 어디 소속인지 알려줍니다. Sprite 클래스는 물리적으로 flash.display.Sprite 라는 경로에 있다는 것을 의미하죠. 실제로 액션스크립트의 내장 클래스는 플래시 플레이어에 내부에 들어 있으므로 실재로 Sprite.as 파일이 존재하지는 않습니다만,^[02] 실제로 파일이 존재한다고 생각해도 무방합니다.

(2) 클래스

클래스 정의를 표현 합니다. Sprite 클래스의 경우 어디서나 자유롭게 불러 사용할 수 있는 public 접근 제한을 가지고 있으며, class 라는 것을 의미합니다.

(3) 상속

이 클래스의 상속 체인을 모두 표시해 줍니다. Sprite 클래스가 정말 저렇게 5단계에 걸친 많은 클래스를 상속하고 있냐고요? 네 정말 그렇습니다. Sprite 는 이벤트를 발생시키기도 해야하고(EventDispatcher), 시각적인 표현도 해야하고(DisplayObject), 마우스 인터랙션도 받아야 하는데다가(InteractiveObject), Sprite 안에 있는 여러 가지 다른 요소들의 위 아래 순서도 정의해야 하기 때문에(DisplayObjectContainer) 해야 할 일이 꽤나 많은편이죠.

(4) 하위클래스

Sprite 클래스를 상속한 클래스의 목록 입니다.

(5) 언어 버전

이 클래스를 사용할 수 있는 액션스크립트의 버전입니다. Sprite 의 경우에는 ActionScript 3.0 부터 사용할 수 있다는 의미입니다.

여기서 잠깐 여러분의 이해를 돕고자 재미있는 이야기를 하나 꺼내보겠습니다.
현재 이 레퍼런스를 사용할 수 있는 ActionScript 버전 중에는 3.0이 가장 낮은 버전입니다. “당연하잖아!” 라고 생각하시는 분들에게 아래와 같이 질문을 드려볼까요?

“AS2.0 의 MovieClip 과 AS3.0 의 MovieClip 은 같은 클래스인가요, 다른 클래스 인가요?”

우리는 AS2.0과 3.0 모두에서 MovieClip 을 사용할 수 있고, 사용 방법 또한 같으며, 성질도 다르지 않습니다. 그러나 아래의 스크린샷을 볼까요?

그런데 뭔가 이상하죠? MovieClip 은 분명 AS2.0 에서도 사용할 수 있는데, 어째서 언어 버전이 ActionScript 3.0 이라고 써 있으며 런타임 버전 AIR 1.0, Flash Player 9 일까요?

그 해답은 AS2.0 레퍼런스를 보면 알 수 있습니다. 이걸 보면 AS2.0의 MovieClip 과 AS3.0의 MovieClip 은 클래스 이름은 같지만 엄밀히 말하면 별개의 클래스라는 것을 알 수 있습니다.

우선 상속 체인이 완전히 다릅니다. AS2.0은 Object 에서 단 한번 상속했을 뿐이지만, AS3.0의 MovieClip 은 위에서 살펴본 Sprite 를 상속 했으니까 무려 6단계의 상속 체인을 가지고 있습니다.

또한 속성도 다르죠. AS2.0이 AS3.0으로 바꼈어도 MovieClip 이라는 클래스 명은 동일하기 때문에 개발의 편의를 위하여 대부분의 속성명을 동일하게 유지했지만, 속성명 앞에 있던 _ (언더 바 또는 언더 스코어) 들이 사라졌습니다. 다르게 말한다면 속성이 죄다 바뀐거라고 할 수 있습니다.

(6) 런타임 버전

Flash Player 또는 AIR 런타임^[03] 의 최소 요구 버전을 나타냅니다.
초보분들은 Flash Player 의 버전과 ActionScript 의 버전, 그리고 Flash IDE의 CS 버전은 서로 다른 것을 이야기하는 것이므로 혼동하지 마시기 바랍니다.

(7) 그리고 개괄적 설명

이 부분은 이 클래스의 성격과 특성을 나타내므로 새로운 클래스를 만나게 되면 한번씩은 정독 해주는것을 권장합니다.

(8) 참고 사항

이 부분은 레퍼런스에 존재하는 관련 사항의 링크나 Adobe Flash용 Adobe ActionScript 3.0 프로그래밍쪽의 관련 페이지 링크를 제공하기도 합니다. 문제 해결에 결정적인 도움을 주기도 하는 부분이니 디버깅 할 경우라면 주의깊게 살펴보세요.

* * * * *

여기부터는 본문의 속성, 메서드, 이벤트 목록을 표시하는 부분 입니다.

- Public 속성 -

“상속되는 Public 속성 표시” 는 클릭하면 “상속되는 Public 속성 숨기기”로 링크가 변경됩니다. 이 기능은 클래스가 상속을 하게 되면 부모의 속성, 메서드, 이벤트도 모두 가지게 되기 때문에 상속체인상의 하위 클래스로 갈수록 속성, 메서드, 이벤트의 숫자가 상당히 많아집니다. Sprite 만 봐도 상당히 많은 숫자를 볼 수 있죠.

위 그림에서 우리가 흔하게 사용하는 alpha 속성을 잠시 살펴볼까요? alpha 는 소수점 표시를 해야하기 때문에 Number 의 데이터 형을 가지고 있다는 것을 표시하고 있고, 간단한 설명도 볼 수 있습니다.
오른쪽을 보면 “다음에 의해 정의됨” 항목에 DisplayObject 라고 되어 있군요. 즉, alpha 라는 속성은 DisplayObject 에서 정의되어 있으므로 상속 체인상에서 DisplayObject 를 포함한 InteractiveObject, DisplayObjectContainer, Sprite 의 자식 클래스에서 사용 가능하고, 상위 클래스인 EventDispatcher 나 Object 에서는 사용할 수 없는 속성이 되겠습니다.

여기서 잠깐 !

정말 쌩초보스럽지만 정말 중요한 질문하나가 있습니다.
속성은 어떻게 사용하나요?
코드로 보면 아래와 같습니다.

0
1
2
3
4
5
6
7
8
9
10

// 객체 생성 및 초기화
var instance:Sprite = new Sprite();
 
// 객체 속성에 값을 대입함
// buttonMode 속성은 Boolean 데이터 형이므로 true 아니면 false 둘 중 하나를 대입해야 함
// 객체.속성 = 속성값
instance.buttonMode = true;
 
// 객체 속성을 참조함
// 출력 : true
trace( instance.buttonMode );

속성은 클래스 내부에서 getter/setter 로 구현합니다. 읽기전용, 쓰기전용, 읽기쓰기 모두가능의 3가지가 있지만 쓰기전용이라는 것은 실제 사용할 일이 별로 없으므로, 일반적으로 getter 메서드만 있는 읽기전용, getter/setter 둘다 있는 읽기쓰기 모두가능한 두 가지 속성으로 나뉜다고 볼 수 있습니다.
위에서 코드로 예를 든 것과 같이 buttonMode 속성의 경우에는 읽기/쓰기가 모두 가능한 속성이므로 속성에 값을 대입할 수도 있고 값을 참조할 수도 있지만, numChildren 속성 같은 경우는 읽기전용 이므로 대입연산자 = 를 통해 값을 입력할 수 없는 차이가 있습니다.

getter/setter 는 어려운 내용은 아니지만 개념에 대한 이해가 필요하므로 이에대한 설명을 나중에 별도의 포스팅을 하겠습니다.

- Public 메서드 -

메서드 역시 부모로부터 상속한 모든 메서드를 사용할 수 있습니다. Sprite 클래스에서 정의한 메서드는 Sprite(), startDrag(), stopDrag() 이 세 가지 뿐이군요.^[04] 나머지는 모두 부모 클래스에서 정의한 메서드들이라는 의미 입니다.
위 그림중 우리가 흔하게 사용하는 addChild() 메서드를 살펴보도록 하죠. 함수연산자 () 안에 DisplayObject 타입의 객체가 들어와야 한다는 것을 나타내고 있습니다. child 라는 이름 자체는 의미가 없습니다. 다만 메서드명이 addChild() 이므로 add 하는 대상이 무엇인지 힌트를 주고 있는 것이죠.
그리고 addChild() 메서드가 반환하는 값 역시 DisplayObject 라고 되어있죠? addChild() 의 파마미터에 넣은 child 가 메서드 실행의 결과로 반환됩니다.

- 이벤트 -

이벤트는 addEventListener() 나 dispatchEvent() 메서드를 통해 사용하게 됩니다. dispatchEvent() 는 어떻게 사용하는 건데? 라는 질문을 하고 싶은 분이라고 하더라도 나중에 필요할 때 알게 됩니다. addEventListener() 만 사용할 줄 알아도 당장 AS3.0에 입문하는데 지장 없으니 걱정하지 마세요.

이벤트 목록의 오른쪽에 있는 “다음에 의해 정의됨”을 보면 Sprite 클래스에서는 정의한 이벤트가 없고 모두 부모 클래스에서 상속한 이벤트 뿐이군요. 사용자의 인터랙션, 즉 마우스나 키보드 입력에 의한 이벤트는 InteractiveObject 에서 상속했고, 인터랙션과 관계 없는 이벤트는 DisplayObject 에서 상속했습니다. 요약설명 부분에 [브로드캐스트 이벤트] 라고 표시되어 있는 것들 중에 몇몇 이벤트는 EventDispatcher 까지 거슬러 올라가기도 합니다.
브로드캐스트 이벤트가 뭔지 궁금한 분은 여기를 클릭해서 “DisplayObject 클래스에는 몇 가지 브로드캐스트 이벤트가…” 부분을 읽어보세요. 아직까지는 딱히 몰라도 관계 없습니다.

* * * * *

여기부터는 목록 더 아랫 부분의 상세 설명 본문 부분 입니다.

- 속성 정보, 생성자 정보, 메서드 정보 -

레퍼런스의 더 아랫 부분은 위의 이미지와 같은 현재 선택한 클래스의 속성, 메서드, 이벤트에 대한 좀더 자세한 설명이 있습니다. 각 속성이나 메서드의 상세 설명은 사실 알고 있으면 좋지만, 레퍼런스의 모든 부분을 읽는다는건 입문자에겐 불가능할 뿐더러, 읽는다 하더라도 전체적인 그림이 머리속에 그려지지 않은 상태에서는 사실 무슨 의미인지 이해가 되지 않는 경우가 많습니다. 그러므로 아래의 두 가지 방법 중 하나를 선택하는 것이 현실적인 방법 입니다.

1. 실제 코딩을 하면서 처음보는 속성이나 메서드가 나오면 레퍼런스에서 찾아서 한번 읽어 보는, 약간 더디지만 확실한 학습 방법.
2. 일단 코딩하면서 문제가 생기게 되면 문제가 생긴 부분의 레퍼런스를 읽어보는, 뭔가 빼먹을 가능성이 있긴 하지만 좀더 빠른 방법.

둘 중 자신에게 맞다고 생각하는 방법으로 그때그때 맞게 읽어 나가면 되겠습니다.
중요한 것은 무작정 레퍼런스나 책을 정독 또는 독파한다고 실력이 느는 것이 아니라, 실제 코딩을 해 나가면서 여러가지 문제에 봉착해 보고 해결 방법을 습득해 나가야 한다는 것입니다. 코딩 한줄 하지 않고 실력이 저절로 늘수는 없거든요.

본문 영역 중간중간에 해당 속성과 메서드에 해당하는 예제 코드가 있고 가장 아래쪽에 현재 선택된 클래스를 아울러 설명해 주는 예제 코드도 있으니 나중에 필요할 때 이용하면 되겠습니다.
커뮤니티 질문게시판에 올라오는 90%는 이미 레퍼런스에 있는 내용입니다. 버젓이 질문내용과 동일한 코드 예제가 있는 경우도 허다하죠. 다만 어디 있는지 못찾는 것이거나, 찾기 귀찮거나 둘 중 하나입니다.

자, 이렇게 레퍼런스의 구석구석을 설명을 통해 알아 봤습니다. 이제는 레퍼런스의 특정 부분의 의미를 몰라서 레퍼런스를 기피하는 현상은 좀 줄어드리라 기대해 봅니다.

* * * * *

글을 쓰는 현재 시점(2010년 1월)은 Flash CS5 가 나오기 직전의 시점이고 CS5 가 베타 버전으로 존재합니다. Flash Player 는 10.1 이 되는군요. 언어 버전은 AS3.0 으로 현재와 변화가 없으므로 골격이나 구조의 변화는 없고 마이너한 요소들이 추가되었습니다.

위에서도 잠깐 설명했지만 액션스크립트의 내장 클래스들은 Flash Player 에 존재합니다. CS4, CS5 와 같은 Flash IDE 버전에 따라 액션스크립트 API가 버전이 올라간다고 생각하기 쉽지만 그렇지 않습니다. Flash IDE는 저작 환경일 뿐이고 액션스크립트 버전과는 직접적인 관계가 없습니다.^[05]

마지막으로 Flash CS5와 함께 공개될 새로운 레퍼런스의 모습을 구경해 볼까요?
CS4 버전의 현재 레퍼런스와 크게 달라지는 부분은 없습니다. Beta 라고 군데군데 명시되어 있고, Flex Builder 3 에서 Flash Builder 4 로 명칭이 변경된 만큼 Flex 에서 사용하던 mx 패키지가 들어왔습니다. (예전엔 서로 별개의 레퍼런스처럼 취급되었죠)

베타 레퍼런스에 도입된 필터링 시스템 중 Runtimes 필터링

Products 의 필터링

이전에는 없던 필터링 기능이 눈에 띄는데, Runtimes 으로 Flash Player와 AIR를 구분하여 버전별로 필터링 할 수 있게 했고, Products 에는 Flex SDK 버전과 Flash IDE 버전 그리고 Blaze 서버와 LiveCycle, ColdFusion 까지, 액션스크립트와 관련을 가지는 다른 프로그램들의 레퍼런스들을 총 망라 하고 있습니다.
그 결과 왼쪽 패키지 목록과 클래스 목록에서 다루는 패키지와 클래스의 갯수가 꽤 많이 늘어 난 것처럼 보이는데, 적절한 필터링을 해서 사용하면 되겠습니다.

Flash Player 10.1 에 새로 추가된 Multitouch 클래스

이렇게 버전이 올라서 새로운 클래스가 업데이트 되어도 현재의 레퍼런스와는 크게 달라지는 점이 없습니다. 현재의 레퍼런스를 읽는데 어려움이 없다면 앞으로 훨씬 순조로운 개발을 할 수 있게되겠죠.

1. ASDoc은 작은의미로 Flex SDK에 포함된 레퍼런스를 만드는 프로그램의 이름이기도 한데, 이 포스트에서는 그것보다는 큰 의미로 레퍼런스와 동일한 의미로 사용하였습니다.
2. 모든 내장 클래스들이 마찬가지 입니다.
3. AIR의 R은 이미 Runtime 의 이니셜 입니다만, 여기서는 런타임이라는 것을 강조하기 위하여 상가”집” 식의 중복을 사용했습니다.
4. Flash Player 10.1 부터는 모바일 디바이스를 위한 터치관련 메서드들이 조금 더 추가됩니다.
5. 그러나 한편으로는 Flash IDE버전에 올라가면 Flash Player 의 버전도 같이 올라가는 경우가 대부분이므로 완전히 별개라고 보기에도 어려움이 있긴 합니다.

플래시 개발자들은 최신의 API 활용과 Flash Player 컴파일을 위해 Flash IDE 를 최신 버전으로 항상 유지 합니다.(유지해야 합니다)

그런 반면, Flash IDE 버전이 항상 구 버전인 디자이너들도 있죠. 디자이너들은 대체로 보수적이고 한번 습득한 지식을 계속 움켜쥐고 놓지 않으려는 습성이 강합니다.^[02] 그들은 새로운 기술에도 둔감하고 기존에 잘 사용하고 있던 어떤 시스템이나 tool을 어지간하면 바꾸려 하지 않습니다.
어느 정도냐 하면, 지금 글을 쓰고 있는 시기가 2009년에서 2010년으로 바뀌는 시점이고 곧 Flash CS5 버전이 나올텐데, 아직도 Flash 8 을 사용하는 디자이너들이 많습니다. 심지어 MX 2004 버전을 사용 하는 경우도 있더군요. 아무리 AS3.0 을 사용할 일 없는 디자이너라고 해도 말이죠.

문제는 이 두 부류의 사람들이 사용하는 Flash IDE의 버전이 다른데서 옵니다. 아시다시피 fla 파일 포맷은 하위 호환성이 없으므로, 상위 버전에서 만든 fla 파일을 별도로 하위 버전에서 열리게끔 한단계 낮게 저장^[03] 하지 않는 이상 Ctrl + S 로 저장하면 하위 버전에서 fla 를 열 수가 없습니다.

상위 버전으로도 한 단계는 가능하지만 두 단계 이상의 상위버전에서는 불가능하죠. Flash 8에서 저장한 fla 파일은 CS4에서 열리지 않습니다.

플래시 같이 기술의 변화가 급격한 성향을 띄는 프로그램은 항상 최신 버전을 사용해야 함을 잊지 마세요.

***

2. 필요하다면 한글판 Flash IDE를 사용하세요.

컴파일 에러나, 대화상자를 읽지 못하는 사람들이 있습니다. 다른 이유가 있는게 아니라 단지 영어를 해석 못해서라면 이런 분들은 한글판 Flash IDE를 사용해야 합니다. 한글판은 뭔가 어색하고 뽀대가 안난다는 이유로 영문판을 고집하는 걸로 알고 있습니다만, 결코 컴파일 에러의 올바른 이해보다 중요하지 않습니다.

저는 모든 Adobe 프로그램들을 영문판으로 사용하지만,^[04] 유일하게 Flash만은 한글판을 사용하고 있습니다. AS3.0을 공부할 때 컴파일 에러 메세지를 정확하게 이해하기 위해서 처음 사용하기 시작했고, 지금은 한글판을 사용할 필요가 거의 없어졌어도 오래 사용하다 보니 이미 한글판의 어색함 따위는 느껴지지 않기 때문에 그냥 계속 한글판을 사용하고 있습니다.

그리고 컴파일 에러 뿐만 아니라 여러가지 대화상자의 의미 또한 명확하게 이해할 수 있게 됩니다.

영문판에서의 이 경고 메세지의 의미를 정확히 이해하십니까?

맥OS 에서는 이렇게 보이는 경고 창 입니다.

의미를 모른 채 Don’t warn me again 에 체크한 후 OK 를 누르지는 않았나요?

이런 대화상자의 경우 한글판에서 보면 명확하게 이해 됩니다.

1. 우리가 흔히 말하는 Flash CS4, CS5 같은 것들을 Flash IDE (Integrated Development Environment : 통합 개발 환경)라고 말합니다.
2. 손에 쥐고 있는 것이 썩은 도끼 자루인지도 모르고 말이죠.
3. 이 저장 방법은 정말 매번 귀찮은 작업입니다.
4. Photoshop 같은 경우는 한글판의 메뉴 명칭이 과도하게 번역되어 혼동을 일으키는 경우가 실제로 있습니다.