Lingo Dictionary Macromedia Director MX Trademarks Afterburner, AppletAce, Attain, Attain Enterprise Learning System, Attain Essentials, Attain Objects for Dreamweaver, Authorware, Authorware Attain, Authorware Interactive Studio, Authorware Star, Authorware Synergy, Backstage, Backstage Designer, Backstage Desktop Studio, Backstage Enterprise Studio, Backstage Internet Studio, Contribute, Design in Motion, Director, Director Multimedia Studio, Doc Around the Clock, Dreamweaver, Dreamweaver Attain, Drumbeat, Drumbeat 2000, Extreme 3D, Fireworks, Flash, Fontographer, FreeHand, FreeHand Graphics Studio, Generator, Generator Developer's Studio, Generator Dynamic Graphics Server, Knowledge Objects, Knowledge Stream, Knowledge Track, Lingo, Live Effects, Macromedia, Macromedia M Logo & Design, Macromedia Contribute, Macromedia Flash, Macromedia Xres, Macromind, Macromind Action, MAGIC, Mediamaker, Object Authoring, Power Applets, Priority Access, Roundtrip HTML, Scriptlets, SoundEdit, ShockRave, Shockmachine, Shockwave, Shockwave Remote, Shockwave Internet Studio, Showcase, Tools to Power Your Ideas, Universal Media, Virtuoso, Web Design 101, Whirlwind and Xtra are trademarks of Macromedia, Inc. and may be registered in the United States or in other jurisdictions including internationally. Other product names, logos, designs, titles, words or phrases mentioned within this publication may be trademarks, servicemarks, or tradenames of Macromedia, Inc. or other entities and may be registered in certain jurisdictions including internationally. This guide contains links to third-party Web sites that are not under the control of Macromedia, and Macromedia is not responsible for the content on any linked site. If you access a third-party Web site mentioned in this guide, then you do so at your own risk. Macromedia provides these links only as a convenience, and the inclusion of the link does not imply that Macromedia endorses or accepts any responsibility for the content on those third-party sites. Apple Disclaimer APPLE COMPUTER, INC. MAKES NO WARRANTIES, EITHER EXPRESS OR IMPLIED, REGARDING THE ENCLOSED COMPUTER SOFTWARE PACKAGE, ITS MERCHANTABILITY OR ITS FITNESS FOR ANY PARTICULAR PURPOSE. THE EXCLUSION OF IMPLIED WARRANTIES IS NOT PERMITTED BY SOME STATES. THE ABOVE EXCLUSION MAY NOT APPLY TO YOU. THIS WARRANTY PROVIDES YOU WITH SPECIFIC LEGAL RIGHTS. THERE MAY BE OTHER RIGHTS THAT YOU MAY HAVE WHICH VARY FROM STATE TO STATE. Copyright © 2002 Macromedia, Inc. All rights reserved. This manual may not be copied, photocopied, reproduced, translated, or converted to any electronic or machine-readable form in whole or in part without prior written approval of Macromedia, Inc. Third Party Software Notices and/or Additional Terms and Conditions can be found at http://www.macromedia.com/go/thirdparty/. Part Number ZDR90M200 Acknowledgments Writing: Jay Armstrong, George Brown, Stephanie Gowin, and, Tim Statler Editing: Rosana Francescato, Mary Ferguson, Mary Kraemer, and Noreen Maher Project Management: Stuart Manning Production: Chris Basmajian, Caroline Branch, John Francis, and Patrice O'Neill Multimedia: Aaron Begley and Benjamin Salles First Edition: December 2002 Macromedia, Inc. 600 Townsend St. San Francisco, CA 94103 CHAPTER 1 Lingo by Feature This chapter lists various Macromedia Director MX features and the corresponding Lingo elements that you can use to implement those features. Accessibility These terms are useful for making movies accessible to the disabled: Text-to-speech voiceCount() voiceGet() voiceGetPitch() voiceGetRate() voiceGetVolume() voiceInitialize() voicePause() voiceResume() voiceSet() voiceSetPitch() voiceSetRate() voiceSetVolume() voiceSpeak() voiceState() voiceStop() voiceWordPos() Keyboard navigation autoTab hilite (command) keyboardFocusSprite selection (text cast member property) selection() (function) selection (cast property) selectedText selEnd selStart 3 Animated GIFs These terms are useful for working with animated GIFs: directToStage frameRate linked moviePath pause (movie playback) playBackMode resume sprite rewind sprite Animation These terms are useful for creating animation with Lingo: blend ink loc locH locV member (sprite property) regPoint tweened Behaviors The terms in this section are useful for authoring behaviors and using behaviors while the movie plays. Authoring behaviors Use these terms to set up behaviors and the behavior's Parameters dialog box: ancestor on runPropertyDialog on getBehaviorTooltip on isOKToAttach on getBehaviorDescription on getPropertyDescriptionList property Sending messages to behaviors Use these commands to send messages to behaviors attached to sprites: call callAncestor sendSprite sendAllSprites Identifying behaviors Use these terms to identify the behaviors attached to sprites: currentSpriteNum me scriptInstanceList spriteNum 4 Chapter 1 Bitmaps The terms in this section are useful for working with bitmaps. Bitmap properties Use these terms to check and set bitmap properties: alphaThreshold backColor blend depth dither trimWhiteSpace (property) imageQuality movieImageQuality foreColor palette picture (cast member property) pictureP() rect (member) imageCompression movieImageCompression Alpha channel Use these terms to control alpha channel effects: alphaThreshold depth createMask() extractAlpha() dither useAlpha createMatte() setAlpha() Image objects Use these terms to create and control image objects: copyPixels() crop() (image object command) draw() duplicate() (image function) getPixel() fill() image image() rect (image) setPixel() Buttons See Buttons and check boxes in the Interface Elements section. Lingo by Feature 5 Cast members The terms in this section are useful for working with cast members. Creating cast members Use importFileInto and new() to create cast members. Authoring Use duplicate member, erase during authoring. Graphic cast members Use these terms to check and set the images assigned to graphic cast members: center crop (cast member property) depth media palette picture (cast member property) pictureP() regPoint member, and pasteClipBoardInto to work with cast members General cast member properties Use these terms to check and set cast member properties: fileName (cast member property) media modified name (cast member property) number (cast member property) preLoadMode type (cast member property) URL Graphic cast member dimensions Use height, rect (member), and width to check and set dimensions for graphic cast members. Casts The terms in this section are useful for working with casts. Loading casts Use preLoadMode to check and set when Director preloads a cast. Cast properties Use these terms to specify cast properties: castLib fileName (cast property) name (cast property) number (cast property) number (system property) 6 Chapter 1 Cast management Use these terms to manage casts: activeCastLib duplicate member erase member findEmpty() move member number of members pasteClipBoardInto save castLib selection (cast property) Computer and operating system Use these terms to check and control the computer: beep beepOn cpuHogTicks emulateMultiButtonMouse floatPrecision freeBlock() freeBytes() maxInteger multiSound romanLingo Operating system control Use restart and shutDown to control the operating system. Data types These terms are useful for specifying data types: # (symbol) float() floatP() integer() integerP() objectP() string() stringP() symbol() symbolP() VOID voidP() Digital video These terms are useful for working with AVI and QuickTime digital video: controller digitalVideoTimeScale digitalVideoType directToStage duration frameRate loop (cast member property) movieRate trackNextSampleTime trackPreviousKeyTime trackPreviousSampleTime trackStartTime (sprite property) trackStartTime (cast member property) trackStopTime (sprite property) trackStopTime (cast member property) trackText Lingo by Feature 7 movieTime pausedAtStart (Flash, digital video) quickTimeVersion() timeScale trackEnabled trackNextKeyTime trackType (cast member property) trackType (sprite property) trackCount (cast member property) trackCount (sprite property) video (QuickTime, AVI) videoForWindowsPresent QuickTime Use these terms to work with QuickTime: enableHotSpot fieldOfView getHotSpotRect() hotSpotExitCallback hotSpotEnterCallback invertMask isVRMovie loopBounds mask motionQuality mouseLevel node nodeEnterCallback nodeExitCallback nodeType nudge pan (QTVR property) ptToHotSpotID() quickTimeVersion() rotation scale swing() staticQuality tilt translation triggerCallback warpMode RealMedia video Use these terms to with RealMedia video: audio (RealMedia) currentTime (RealMedia) displayRealLogo duration (RealMedia) image (RealMedia) lastError mediaStatus password pause (RealMedia) pausedAtStart (RealMedia) percentBuffered play realPlayerNativeAudio() realPlayerPromptToInstall() realPlayerVersion() seek soundChannel (RealMedia) state (RealMedia) stop (RealMedia) userName (RealMedia) video (RealMedia) 8 Chapter 1 Events Use these event handlers for Lingo that runs when a specific event occurs: activeCastLib close window on cuePassed on deactivateWindow on enterFrame on EvalScript on exitFrame on idle on keyDown on keyUp on mouseDown (event handler) on mouseEnter on mouseLeave on mouseUp (event handler) on stopMovie on endSprite on moveWindow on mouseWithin open window on prepareFrame on prepareMovie on resizeWindow on mouseUpOutside on rightMouseDown (event handler) on rightMouseUp (event handler) on startMovie on stepFrame on streamStatus on timeOut on zoomWindow on beginSprite on hyperlinkClicked Use the pass and stopEvent commands to override the way that Director passes messages along the message hierarchy. External files The terms in this section are useful for working with external files. Path names and filenames Use these terms to check and set path names and filenames: @ (pathname) applicationPath fileName (cast property) fileName (cast member property) getNthFileNameInFolder() moviePath searchCurrentFolder URL Obtaining external media Use these terms to obtain external media: downloadNetThing importFileInto preloadNetThing() Lingo by Feature 9 Managing external files Use these terms to manage external files: closeXlib open openXlib showXlib sound playFile Flash These terms are useful for working with Flash cast members: actionsEnabled broadcastProps bufferSize buttonsEnabled bytesStreamed callFrame() centerRegPoint clearError clickMode defaultRect defaultRectMode directToStage endTellTarget() See tellTarget() eventPassMode findLabel() fixedRate flashRect flashToStage() frame() (function) frame (sprite property) frameCount frameRate frameReady() getError() getFlashProperty() getFrameLabel() getVariable() goToFrame originV pathName (movie property) pausedAtStart (Flash, digital video) percentStreamed play playBackMode playing posterFrame print() printAsBitmap() quality rewind sprite rotation scale scaleMode on sendXML setCallback() settingsPanel() setFlashProperty() setVariable() showProps() sound the soundMixMedia sourceFileName stageToFlash() state (Flash, SWA) static stop (Flash) 10 Chapter 1 hitTest() hold imageEnabled linked loop (keyword) mouseOverButton newObject() obeyScoreRotation originH originMode originPoint stream streamMode streamSize tellTarget() URL viewH viewPoint viewScale viewV volume (cast member property) These terms are useful for working with global Flash objects, which do not require a Flash cast member: clearAsObjects() newObject() setCallback() Frames The Lingo terms in this section let you work with frames. Frame events Use the on enterFrame, on exitFrame, and on that runs at specific events within a frame. prepareFrame event handlers to contain Lingo Frame properties Use these Lingo terms to check and set frame properties: frameLabel framePalette frameScript frameSound1 frameSound2 the markerList frameTempo frameTransition label() labelList marker() Lingo by Feature 11 Interface elements The Lingo terms in this section are useful for working with interface elements. Menus Use these terms to create menus: enabled installMenu menu name (menu property) name (menu item property) number (menu items) number (menus) script Buttons and check boxes Use these terms to specify buttons and check boxes: alert buttonStyle buttonType checkBoxAccess checkBoxType checkMark hilite (cast member property) Keys The Lingo terms in this section are related to using the keyboard. Identifying keys Use these terms to identify keys: charToNum() commandDown controlDown key() keyCode() keyPressed() mouseChar numToChar() optionDown shiftDown Keyboard interaction Use keyPressed(), lastEvent(), and lastKey to detect what the user types at the keyboard. Keyboard events Use these terms to set up handlers that respond to pressing keys: on keyDown on keyUp flushInputEvents keyDownScript keyUpScript 12 Chapter 1 Lingo The Lingo terms in t ...