background image

Chapter 3

144

Examples

This statement performs a math operation:

palColorObj = paletteIndex(20)
put palColorObj
-- paletteIndex(20)
put palColorObj / 2
-- paletteIndex(10)

This statement converts one color type to another type:

newColorObj = color(#rgb, 155, 0, 75)
put newColorObj
-- rgb(155, 0, 75)
newColorObj.colorType = #paletteIndex
put newColorObj
-- paletteIndex(106)

This statement obtains the hexadecimal representation of a color regardless of its type:

someColorObj = color(#paletteIndex, 32)
put someColorObj.hexString()
-- "#FF0099"

This statement determines individual RGB components and the 

paletteIndex

 value of a color 

regardless of its type:

newColorObj = color(#rgb, 155, 0, 75)
put newColorObj.green
-- 0
put newColorObj.paletteIndex
-- 106
newColorObj.green = 100
put newColorObj.paletteIndex
-- 94
put newColorObj
-- rgb(155, 100, 75)
newColorObj.paletteIndex = 45
put newColorObj
-- paletteIndex(45)

This statement changes the color of the fourth through the seventh characters of text member 
myQuotes:

member("myQuotes").char[4..7].color = rgb(200, 150, 75)

This Lingo displays the color of sprite 6 in the Message window, and then sets the color of sprite 
6 to a new RGB value:

put sprite(6).color
-- rgb( 255, 204, 102 )
sprite(6).color = rgb(122, 98, 210)

Note: 

Setting the 

paletteIndex

 value of an RGB color type changes 

colorType

 to 

paletteIndex

. Setting 

the RGB color type of a 

paletteIndex

 color sets its 

colorType

 value to RGB.

See also

bgColor

Summary of Contents for DIRECTOR MX-LINGO DICTIONARY

Page 1: ...Lingo Dictionary Macromedia Director MX...

Page 2: ...de 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 mentio...

Page 3: ...movies accessible to the disabled Text to speech Keyboard navigation voiceCount voiceSet voiceGet voiceSetPitch voiceGetPitch voiceSetRate voiceGetRate voiceSetVolume voiceGetVolume voiceSpeak voiceI...

Page 4: ...essages to behaviors Use these commands to send messages to behaviors attached to sprites Identifying behaviors Use these terms to identify the behaviors attached to sprites directToStage pause movie...

Page 5: ...objects Buttons See Buttons and check boxes in the Interface Elements section alphaThreshold foreColor backColor palette blend picture cast member property depth pictureP dither rect member trimWhiteS...

Page 6: ...es 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...

Page 7: ...er pasteClipBoardInto erase member save castLib findEmpty selection cast property move member beep freeBlock beepOn freeBytes cpuHogTicks maxInteger emulateMultiButtonMouse multiSound floatPrecision r...

Page 8: ...HotSpotRect pan QTVR property hotSpotExitCallback ptToHotSpotID hotSpotEnterCallback quickTimeVersion invertMask rotation isVRMovie scale loopBounds swing mask staticQuality motionQuality tilt mouseLe...

Page 9: ...Window close window on mouseWithin on cuePassed open window on deactivateWindow on prepareFrame on enterFrame on prepareMovie on EvalScript on resizeWindow on exitFrame on mouseUpOutside on idle on ri...

Page 10: ...playBackMode centerRegPoint playing clearError posterFrame clickMode print defaultRect printAsBitmap defaultRectMode quality directToStage rewind sprite endTellTarget See tellTarget rotation eventPas...

Page 11: ...at specific events within a frame Frame properties Use these Lingo terms to check and set frame properties hitTest stream hold streamMode imageEnabled streamSize linked tellTarget loop keyword URL mo...

Page 12: ...eyboard 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 enabled name men...

Page 13: ...to control how a script executes Code structures Use if to create if then statements Use case end case and otherwise in case statements Use these terms for repeat loops Syntax elements Use these terms...

Page 14: ...eving values from a list Use these terms to retrieve values from a list Getting information about lists Use these terms to get information about lists Setting values in a list Use these terms to set v...

Page 15: ...erms to load media into memory and check whether media are available Available memory Use these terms to check how much memory is available cuePointNames on cuePassed cuePointTimes isPastCuePoint most...

Page 16: ...itor Mouse interaction The terms in this section are useful for Lingo related to using the mouse Mouse clicks Use these terms to detect what the user does with the mouse put traceLoad showXlib traceLo...

Page 17: ...hese terms for opening and closing windows Window appearance Use these terms to check and set the appearance of a movie s window mouseDownScript on mouseUp event handler mouseUpScript on mouseUpOutsid...

Page 18: ...s being worked on by more than one person Saving movies Use saveMovie and updateMovieEnabled to save changes to a movie Error checking Use the alertHook event to post alerts that describe errors in a...

Page 19: ...dia Use these terms to obtain or stream media from the network Checking availability Use frameReady and mediaReady to check whether specific media are completely downloaded Using network operations Us...

Page 20: ...mValue to access EMBED and OBJECT parameter tags Operators The terms in this section are operators available in Lingo Math operators Use these terms for math statements Comparison operators Use and no...

Page 21: ...working with projectors Puppets Use these terms to control the puppet property of sprites and effects channels Random numbers Use random and randomSeed to generate random numbers actorList property a...

Page 22: ...eam and play Shockwave audio sounds beginRecording scoreSelection clearFrame scriptNum deleteFrame scriptType duplicateFrame tweened endRecording updateFrame insertFrame updateLock scoreColor filled p...

Page 23: ...Lingo that you want to run when a sprite begins or ends Assigning cast members to sprites Use castLibNum member sprite property or memberNum to specify a sprite s cast member channelCount soundEnabled...

Page 24: ...ck and set the size of a sprite s bounding rectangle You can also manipulate a sprite s bounding rectangle with Lingo for rectangles See Points and rectangles Sprite locations Use the loc locH and loc...

Page 25: ...e strings Chunk expressions Use these terms to identify chunks of text backColor color sprite and cast member property bgColor foreColor centerStage stageColor fixStageSize stageLeft picture window pr...

Page 26: ...content of a text cast member Lingo that applies to chunk expressions is also available to the text within a text cast member line of string number characters stringP number items value number lines w...

Page 27: ...k with constants Time The terms in this section are useful for working with time Current date and time Use these terms to determine the current date and time pointInHyperlink pointToParagraph pointToC...

Page 28: ...ariables Testing and changing variables Use these terms to check and change the values assigned to variables framesToHMS ticks HMStoFrames time milliseconds timer startTimer timeoutKeyDown timeoutMous...

Page 29: ...iginH closed originMode defaultRect originPoint defaultRectMode originV deleteVertex rotation directToStage scale endColor scaleMode fillColor showProps fillCycles skew fillDirection static fillMode s...

Page 30: ...Chapter 1 30 Xtra extensions Use these terms to work with Xtra extensions movieXtraList xtra name system property xtraList number of xtras xtras...

Page 31: ...so the lists of terms for the Keyframe player and Bones player modifiers Anti aliasing Use these terms to work with anti aliasing animationEnabled pause 3D autoblend play 3D blendTime playing 3D clone...

Page 32: ...ackdrop scale backdrop and overlay insertOverlay source loc backdrop and overlay autoblend play 3D blendTime playing 3D bonesPlayer modifier playlist count playNext 3D currentTime 3D playRate getBoneI...

Page 33: ...iew 3D translate hither userData isInWorld worldPosition name yon newCamera addChild count child parent collision modifier pointOfContact collisionData registerForEvent collisionNormal registerScript...

Page 34: ...emoveBackdrop deleteModel removeFromWorld deleteModelResource removeOverlay deleteMotion color fog far fog decayMode fog enabled fog near fog addChild newGroup addToWorld pointAt boundingSphere pointA...

Page 35: ...yNext 3D count playRate currentLoopState positionReset currentTime 3D queue 3D keyframePlayer modifier removeLast lockTranslation rootLock pause 3D rotationReset play 3D update auto level bias lod mod...

Page 36: ...eform neighbor clearAtRender resetWorld clearValue revertToWorldDefaults directToStage sendEvent loadFile setCollisionCallback registerForEvent unregisterAllEvents registerScript revertToWorldDefaults...

Page 37: ...Use these terms to manage nodes A node is any object that exists in the world including lights cameras models and groups Particle systems See Primitives Picking See Selecting models name userData new...

Page 38: ...control properties of 3D meshes Particle systems Use these terms to control properties of 3D particle systems back length 3D bottom 3D lengthVertices front right 3D height 3D top 3D heightVertices wid...

Page 39: ...rag region gravity sizeRange contains end and start lifetime texture loop emitter tweenMode maxSpeed wind length 3D width 3D lengthVertices widthVertices endAngle resolution radius state 3D modelsUnde...

Page 40: ...e streaming of 3D cast members diffuseColor textureModeList diffuseLightMap textureRepeat emissive textureRepeatList flat textureTransform glossMap textureTransformList name transparent newShader type...

Page 41: ...the Toon modifier depth 3D sds modifier enabled sds subdivision error tension autoCameraPosition displayMode bevelDepth extrude3D bevelType smoothness displayFace tunnelDepth compressed newTexture co...

Page 42: ...nterpolate rotate interpolateTo rotation transform inverse scale transform invert transform property multiply translate pointAt worldPosition pointAtOrientation xAxis position transform yAxis preMulti...

Page 43: ...by any number of alphabetical or numerical characters A symbol can do the following Assign a value to a variable Compare strings integers rectangles and points Pass a parameter to a handler or method...

Page 44: ...statement displays the current member contained by the sprite in channel 10 put sprite 10 member To use the alternate syntax and call a function you can use this form myColorObject color rgb 124 22 23...

Page 45: ...her than a Lingo statement The Director player for Java accepts Lingo that uses this delimiter but comments do not appear in the final Java code Example This handler uses a double hyphen to make the s...

Page 46: ...in the Message window put abra cadabra The result is the string abracadabra This statement concatenates the strings and the content of the price variable and then assigns the concatenated string to t...

Page 47: ...operator to define a pathname and filename Director interprets only the string before the operator as the filename For example Lingo interprets the statement open window the applicationPath theMovie a...

Page 48: ...age window put 2 3 This statement adds the floating point numbers 2 5 and 3 25 and displays the result 5 7500 a floating point number in the Message window put 2 5 3 25 addition 3D Syntax vector1 vect...

Page 49: ...plies the transform by the vector and returns a new vector The new vector is the result of applying the positional and rotational changes defined by transform to the vector Note that vector transform...

Page 50: ...and determines whether expression1 is less than or equal to expression2 TRUE or whether expression1 is greater than expression2 FALSE This operator can compare strings integers floating point numbers...

Page 51: ...s less than or equal to expression2 FALSE This operator can compare strings integers floating point numbers rects and points Be aware that comparisons performed on rects or points are handled as if th...

Page 52: ...ty in a linear list When using strings as entries in a list enclose the string in quotation marks For example 6 3 8 is a linear list The numbers have no properties associated with them However gears 6...

Page 53: ...ty list create the list pieces as a string before converting them into a useful list myListString numToChar 91 numToChar 93 put myListString myList myListString value put myList put myList listP 1 myL...

Page 54: ...acter instead See continuation It is recommended that you replace this symbol with the symbol in your older scripts continuation Syntax first part of a statement on this line second part of the statem...

Page 55: ...specify subfolders and files within folders You can use relative pathnames in Lingo to indicate the location of a linked file in a folder different than the movie s folder Examples These are equivalen...

Page 56: ...nction calculates the absolute value of a numerical expression If numericExpression is an integer its absolute value is also an integer If numericExpression is a floating point number its absolute val...

Page 57: ...ot the actionsEnabled of sprite whichSprite end activateApplication Syntax on activateApplication Description Built in handler runs when the projector is brought to the foreground This handler is usef...

Page 58: ...open active3dRenderer Syntax the active3dRenderer Description 3D Lingo movie property indicates the renderer currently in use by the movie for drawing 3D sprites This property is equivalent to the get...

Page 59: ...An equivalent way to write this is selectedMembers castLib the activeCastLib selection activeWindow Syntax the activeWindow Description Movie property indicates which movie window is currently active...

Page 60: ...tatement adds a child object created from the parent script Moving Ball All three values are parameters that the script requires add the actorList new script MovingBall 1 200 200 This statement displa...

Page 61: ...value addAt list position value Description List command for linear lists only adds a value specified by value to a list at the position specified by position This command returns an error when used w...

Page 62: ...multiple views within the sprite Example This statement inserts the camera named FlightCam at the fifth index position of the list of cameras of sprite 12 sprite 12 addCamera member scene camera Flig...

Page 63: ...ber model whichModel addModifier modifierType Description 3D model command adds the specified modifier to the model Possible modifiers are as follows bonesPlayer collision inker keyframePlayer lod lev...

Page 64: ...ber Scene camera 1 addOverlay t1 point 20 20 45 See also removeOverlay addProp Syntax list addProp property value addProp list property value Description Property list command for property lists only...

Page 65: ...gbCyl addToWorld See also isInWorld removeFromWorld addVertex Syntax member memberRef AddVertex indexToAddAt pointToAddVertex controlLocH controlLocV controlLocH controlLocV addVertex member memberRef...

Page 66: ...ipt that contains the on alertHook handler Use alertHook to control the display of alerts about file errors or Lingo script errors When an error occurs and a parent script is assigned to alertHook Dir...

Page 67: ...ook script Alert end parent script Alert on alertHook me err msg member Output text err msg return 1 end See also safePlayer alignment Syntax member whichCastMember alignment the alignment of member w...

Page 68: ...omCaching Syntax the allowCustomCaching Description Movie property will contain information regarding a private cache in future versions of Director This property defaults to TRUE and can be tested an...

Page 69: ...l Description Movie property This property is provided to allow for enhancements in future versions of Shockwave This property defaults to TRUE and can be tested and set See also allowGraphicMenu allo...

Page 70: ...hat point is equal to or greater than the threshold Setting the alphaThreshold to 0 makes all pixels opaque to hit detection regardless of the contents of the alpha channel See also useAlpha ambient S...

Page 71: ...ember Room ambientColor rgb 255 0 0 See also directionalColor directionalPreset ambient ancestor Syntax property optionalProperties ancestor Description Object property allows child objects and behavi...

Page 72: ...y variable breed to Mutt sets the ancestor of Dog to the Animal script and sets the legCount variable that is stored in the ancestor script to 4 property breed ancestor on new me set breed Mutt set th...

Page 73: ...n property However the direction of emission of a given particle will deviate from that vector by a random angle between 0 and the value of the emitter s angle property The effective range of this pro...

Page 74: ...uce high quality rendering but possibly slower playback of the movie The antiAlias property is TRUE by default For vector shapes TRUE is the equivalent of the high quality setting for a Flash asset an...

Page 75: ...liasingSupported property If anti aliasing is supported the second statement turns on anti aliasing for the sprite with the antiAliasingEnabled property if sprite 2 antiAliasingSupported TRUE then spr...

Page 76: ...e list s order This command returns a script error when used with a property list Example This statement adds the value 2 at the end of the sorted list named bids which contains 1 3 4 even though this...

Page 77: ...intosh application menu This is useful for projectors and MIAWs that play back without a title bar See also windowType atan Syntax number atan atan number Description Math function calculates the arct...

Page 78: ...r 5 0 0 darkening it slightly member 3d world light HouseLight attenuation vector 5 0 0 See also color light attributeName Syntax XMLnode attributeName attributeNumber Description XML property returns...

Page 79: ...llows you to play TRUE or mute FALSE the audio in the RealMedia stream The default setting for this property is TRUE 1 Integer values other than 1 or 0 are treated as TRUE 1 Setting this property has...

Page 80: ...modeling programs The value of the type property of the model resources used by these models is fromFile The modifier cannot be added to primitives created within Director Example This statement sets...

Page 81: ...sition property of the cast member named Headline to FALSE When the cast member is displayed in 3D mode the camera will not be positioned automatically member Headline autoCameraPosition FALSE See als...

Page 82: ...ember Comments autotab TRUE Verbose Lingo syntax set the autoTab of member Comments to TRUE axisAngle Syntax member whichCastmember model whichModel transform axisAngle member whichCastmember camera w...

Page 83: ...ound color from the tool palette when the sprite is selected on the Stage For the value that Lingo sets to last beyond the current sprite the sprite must be a puppet The background color applies only...

Page 84: ...ation member whichCastmember camera whichCamera backdrop index rotation sprite whichSprite camera index backdrop index regPoint member whichCastmember camera whichCamera backdrop index regPoint sprite...

Page 85: ...See also overlay backgroundColor Syntax member whichVectorMember backgroundColor the backgroundColor of member whichVectorMember Description Vector shape cast member property sets the background color...

Page 86: ...TY then beep 2 beepOn Syntax the beepOn Description Movie property determines whether the computer automatically beeps when the user clicks on anything except an active sprite TRUE or not FALSE defaul...

Page 87: ...statements that run when the playhead moves to a frame that contains a sprite that was not previously encountered Like endSprite this event is generated only one time even if the playhead loops on a f...

Page 88: ...10 0 Example In this example the cast member named Logo is a text cast member This statement sets the bevelDepth of logo to 5 5 When logo is displayed in 3D mode if its bevelType property is set to mi...

Page 89: ...ty system property and 3D cast member property determines the background color of the sprite specified by whichSprite the color of the Stage or the background color of the 3D cast member Setting the b...

Page 90: ...his statement sets the bias property of the lod modifier of the model named Spaceship to 10 If the lod modifier s auto property is set to TRUE the modifier will very aggressively lower the level of de...

Page 91: ...s 12 14 18 See also recordFont characterSet originalFont bitNot Syntax integer bitNot bitNot integer Description Function converts the specified integer to a 32 bit binary number and reverses the valu...

Page 92: ...e also bitNot bitAnd bitXor bitRate Syntax member whichCastMember bitRate the bitRate of member whichCastMember Description Shockwave Audio SWA cast member property returns the bit rate in kilobits pe...

Page 93: ...property can be tested but not set Example This statement assigns the original bit rate of the file used in SWA streaming cast member Paul Robeson to the field cast member How Deep Dot syntax put mem...

Page 94: ...nly For best results use the blend ink with images that have a color depth greater than 8 bit Examples The following statement sets the blend value of sprite 3 to 40 percent Dot syntax sprite 3 blend...

Page 95: ...atio used for the first texture layer of the shader If the shader s useDiffuseWithTexture property is set to TRUE the texture blends with the color set by the shader s diffuse property If useDiffuseWi...

Page 96: ...Source property of the corresponding texture layer is set to constant The range of this property is 0 to 100 the default is 50 Example In this example the shader list of the model named MysteryBox con...

Page 97: ...ePlayer modifier blendFunction Syntax member whichCastmember shader whichShader blendFunction member whichCastmember model whichModel shader blendFunction member whichCastmember model whichModel shade...

Page 98: ...ame value at one time by not specifying the optional index parameter Use the index parameter to set the list one index position at a time Each index position of the blend function list can have one of...

Page 99: ...ange end Description 3D property when used with a model resource whose type is particle allows you to get or set the start and end of the model resource s blend range The opacity of particles in the s...

Page 100: ...property are as follows alpha causes the alpha information in the texture to determine the blend ratio of each pixel of the texture with the color being used for blending see above constant causes th...

Page 101: ...nstantList for more information The default value of this property is constant Example In this example the shader list of the model MysteryBox contains six shaders Each shader has a texture list that...

Page 102: ...ntries for count bonesPlayer modifier transform property and worldTransform for more details See also count bonesPlayer modifier transform property worldTransform bonesPlayer modifier Syntax member wh...

Page 103: ...e lockTranslation indicates whether the model can be displaced from the specified planes positionReset indicates whether the model returns to its starting position after the end of a motion or each it...

Page 104: ...tom of sprite whichSprite Description Sprite property specifies the bottom vertical coordinate of the bounding rectangle of the sprite specified by whichSprite When a movie plays back as an applet thi...

Page 105: ...of the cylinder intersected by its Y axis is sealed TRUE or open FALSE The default value for this property is TRUE Example This statement sets the bottomCap property of the model resource named Tube t...

Page 106: ...member whichCastmember model whichModel inker boundary member whichCastmember model whichModel toon boundary Description 3D inker and toon modifier property allows you to set whether a line is drawn a...

Page 107: ...determines the size in pixels of the drop shadow for the box of the field cast member specified by whichCastMember Example This statement makes the drop shadow of field cast member Title 10 pixels wid...

Page 108: ...ion 3D newsprint and engraver shader property indicates the amount of white blended into the shader The range of this property is 1 to 100 the default value is 0 Example This statement sets the bright...

Page 109: ...browserName pathName browserName browserName enabled trueOrFalse Description System property command and function specifies the path or location of the browser You can use the FileIO Xtra to display...

Page 110: ...esStreamed preLoadRAM stream streamMode build Syntax member whichCastmember modelResource whichModelResource build Description 3D mesh command constructs a mesh This command is only used with model re...

Page 111: ...ember Shapes newModel TriModel nm See also generateNormals newMesh face buttonsEnabled Syntax sprite whichFlashSprite buttonsEnabled the buttonsEnabled of sprite whichFlashSprite member whichFlashMemb...

Page 112: ...ted with that button This property can be tested and set in any type of script Examples The following statement sets the buttonStyle property to 1 the buttonStyle 1 This statement remembers the curren...

Page 113: ...the Message window how many bytes have been streamed Dot syntax on fetchMovie whichFlashMovie repeat while member whichFlashMovie percentStreamed 100 stream member whichFlashMovie put Number of bytes...

Page 114: ...ion is not valid for Shockwave movies because they use the network settings of the browser in which they run on resetCache current cacheDocVerify if current once then alert Turning cache verification...

Page 115: ...ot passed to other scripts attached to the sprite cast member scripts frame scripts or movie scripts Examples This handler sends the message bumpCounter to the first behavior script attached to sprite...

Page 116: ...nces the script instance or a list of script instances and args are any optional parameters to be passed to the handler If script is a single script instance an error alert occurs if the handler is no...

Page 117: ...is statement creates a second instance of the parent script set m2 new script man This statement sends a message to the ancestor script for both men callAncestor run m m2 Animal running with 2 legs An...

Page 118: ...amera property of a sprite is the first camera in the list of cameras of the sprite The camera referred to by sprite whichSprite camera is the same as sprite whichSprite camera 1 Use the addCamera and...

Page 119: ...x member whichCastMember cameraRotation sprite whichSprite cameraRotation Description 3D cast member and sprite property indicates the position of the default camera The default value of this property...

Page 120: ...ing expression When more than one possible match could cause Lingo to execute the same statements the expressions must be separated by commas The syntax line containing expression3 and expresssion4 is...

Page 121: ...ember castLibNum the castLibNum of member whichCastMember sprite whichSprite castLibNum the castLibNum of sprite whichSprite Description Cast member and sprite property determines the number of the ca...

Page 122: ...ist of cast members that make up the frames of a cursor For whichCursorCastMember substitute a cast member name within quotation marks or a cast member number You can also specify cast members from di...

Page 123: ...ee also crop cast member property centerRegPoint regPoint scale centerRegPoint Syntax member whichCastMember centerRegPoint the centerRegPoint of member whichCastMember Description Flash vector shape...

Page 124: ...rojector This property can be tested and set Note Be aware that behavior while playing back in a projector differs between Windows and Macintosh systems Settings selected during creation of the projec...

Page 125: ...not set Examples This statement determines the number of channels in the sound cast member Jazz Dot syntax put member Jazz channelCount Verbose syntax put the channelCount of member Jazz This stateme...

Page 126: ...Set the characterSet of member whichFontMember Description Font cast member property returns a string containing the characters included for import when the cast member was created If all characters i...

Page 127: ...of the string is identified If lastCharacter is before firstCharacter the function returns the value EMPTY To see an example of chars used in a completed movie see the Text movie in the Learning Ling...

Page 128: ...for testing the ASCII value of characters created by combining keys such as the Control key and another alphanumeric key Director treats uppercase and lowercase letters the same if you compare them u...

Page 129: ...s to 1 This statement records the current setting of the checkBoxAccess property by putting the value in the variable oldAccess oldAccess to the checkBoxAccess See also hilite cast member property che...

Page 130: ...ms script menu child Syntax member whichCastmember model whichParentNode child whichChildNodeName member whichCastmember model whichParentNode child index Description 3D model group light and camera p...

Page 131: ...yntax member whichCastMember chunkSize the chunkSize of member whichCastMember Description Transition cast member property determines the transition s chunk size in pixels from 1 to 128 and is equival...

Page 132: ...clearAsObjects See also newObject setCallback clearAtRender Syntax member whichCastmember camera whichCamera colorBuffer clearAtRender sprite whichSprite camera index colorBuffer clearAtRender Descri...

Page 133: ...cast member s pathName linked and preload properties also automatically clears the error condition Example This handler checks to see if an out of memory error occurred for a Flash cast member named D...

Page 134: ...ng a new movie that requires a new set of global variables Example This statement sets all global variables to VOID clearGlobals clearValue Syntax member whichCastmember camera whichCamera colorBuffer...

Page 135: ...ere within the sprite s bounding rectangle and detects rollovers at the sprite s boundaries opaque default Detects mouse click events only when the pointer is over an opaque portion of the sprite and...

Page 136: ...ssociated with it When the user clicks the Stage clickOn returns 0 To detect whether the user clicks a sprite with no script you must assign a placeholder script to it for example so that it can be de...

Page 137: ...pot clone Teapot2 See also cloneDeep cloneModelFromCastmember cloneMotionFromCastmember loadFile cloneDeep Syntax member whichCastmember model whichModel cloneDeep cloneName member whichCastmember gro...

Page 138: ...The children of Pluto are also imported as are the model resources shaders and textures used by Pluto and its children member Scene2 cloneModelFromCastmember Planet Pluto member Scene See also cloneMo...

Page 139: ...number in windowList Closing a window that is already closed has no effect Be aware that closing a window does not stop the movie in the window nor clear it from memory This command simply closes the...

Page 140: ...specify a pathname If no file is specified all open Xlibraries are closed Xtra extensions are stored in Xlibrary files Xlibrary files are resource files that contain Xtra extensions HyperCard XCMDs an...

Page 141: ...ollision events see the registerForEvent entry A collideAny event is generated when a collision occurs between models to which the collision modifier has been attached A collideWith event is generated...

Page 142: ...ollideAny putDetails 0 on putDetails me collisionData put collisionData modelA put collisionData modelB put collisionData pointOfContact put collisionData collisionNormal end model GreenBall model Yel...

Page 143: ...e particle nmr emitter mode burst nmr emitter loop 0 nmr emitter minSpeed 30 nmr emitter maxSpeed 50 nmr emitter angle 45 nmr colorRange start rgb 0 0 255 nmr colorRange end rgb 255 0 0 nmr lifetime 5...

Page 144: ...olor regardless of its type newColorObj color rgb 155 0 75 put newColorObj green 0 put newColorObj paletteIndex 106 newColorObj green 100 put newColorObj paletteIndex 94 put newColorObj rgb 155 100 75...

Page 145: ...b value of the light The default value of this property is rgb 191 191 191 Example This statement sets the color of the light named RoomLight to rgb 255 0 255 member Room light RoomLight color rgb 255...

Page 146: ...ngs This property can be tested but not set Example This statement shows that the colorBufferDepth value of the user s video card is 32 put getRendererServices colorBufferDepth 32 See also getRenderer...

Page 147: ...e change your system to desiredDepth color depth and reboot return false end if end When changing the user s monitor color depth settings it is good practice to restore the original depth when the mov...

Page 148: ...to the value of end over the course of its life The start and end properties have a default value of rgb 255 255 255 Example This statement sets the colorRange properties of the model resource named T...

Page 149: ...the generateNormals command Line 7 uses the build command to construct the mesh Line 8 creates a new model named TriModel that uses the new mesh nm member Shapes newMesh Triangle 1 3 0 3 0 nm vertexLi...

Page 150: ...ie and thus responds to and intercepts any key combinations that are also browser keyboard shortcuts For example if the user presses Control R or Command R the browser reloads the current page the mov...

Page 151: ...tandard compression used for bitmap cast members when a Director movie is saved The default value for this property is TRUE Example This statement sets the compressed property of the texture Plutomap...

Page 152: ...or a slider control or to restrict where on the screen a user can drag an object in a game The constraint sprite property affects moveable sprites and the locH and locV sprite properties The constrain...

Page 153: ...nV function for sprite 1 when it has top and bottom coordinates of 40 and 60 put constrainV 1 20 40 put constrainV 1 55 55 put constrainV 1 100 60 This statement constrains a moveable slider sprite 1...

Page 154: ...he Director player for Java this function returns TRUE only if a second key is pressed simultaneously with the Control key If the Control key is pressed by itself controlDown returns FALSE The Directo...

Page 155: ...al video always returns FALSE The digital video must be in direct to stage playback mode to display the controller Example This statement causes the QuickTime cast member Demo to display its controlle...

Page 156: ...symbol or the corresponding numeric ink value The default ink is copy See ink for the list of possible values blendLevel The degree of blend transparency to apply to the copied pixels The range of va...

Page 157: ...mber flower it is pasted over member flower image copyPixels member Happy image member Happy rect member Happy rect blendLevel 50 See also ink color copyrightInfo Syntax member whichCastMember copyrig...

Page 158: ...o cos Syntax angle cos cos angle Description Function calculates the cosine of the specified angle which must be expressed in radians Example The following statement calculates the cosine of PI divide...

Page 159: ...child count sprite whichSprite camera index backdrop count member whichCastmember camera whichCamera backdrop count sprite whichSprite camera index overlay count member whichCastmember camera whichCam...

Page 160: ...raCount cpuHogTicks Syntax the cpuHogTicks Description System property determines how often Director releases control of the CPU to let the computer process background events such as events in other a...

Page 161: ...ll be drawn at all creases in the model that exceed this threshold This setting will only take effect if the inker modifier s creases property is set to TRUE member shapes model Teapot inker creaseAng...

Page 162: ...ient2 image createMask maskOffset point 10 10 See also copyPixels createMatte ink createMatte Syntax imageObject createMatte alphaThreshold Description This function creates and returns a matte object...

Page 163: ...image object that contains a copy of the given image object cropped to the given rect The original image object is unchanged The new image object does not belong to any cast member and has no associat...

Page 164: ...rops the resulting image to a rectangle equal to sprite 10 member stage image picture the stage picture member stage image crop sprite 10 rect See also picture cast member property crop cast member pr...

Page 165: ...oduct perpendicularTo crossProduct Syntax vector1 crossProduct vector2 Description 3D vector method returns a vector which is perpendicular to both vector1 and vector2 Example In this example pos1 is...

Page 166: ...n t generate sounds Example This handler placed in a Movie or Frame script reports any cue points in sound channel 1 to the Message window on cuePassed channel number name if channel Sound1 then put C...

Page 167: ...entLoopState Syntax member whichCastmember model whichModel keyframePlayer currentLoopState member whichCastmember model whichModel bonesPlayer currentLoopState Description 3D keyframePlayer and bones...

Page 168: ...ent on mouseDown sprite the currentSpriteNum member member DownPict end See also me spriteNum currentTime Syntax sprite whichSprite currentTime the currentTime of sprite whichSprite sound channelNum c...

Page 169: ...y or queue command is multiplied by the modifier s playRate property and the resulting value is multiplied by the motion s original speed to determine how fast the model will execute the motion and ho...

Page 170: ...0 to the duration of the stream Setting currentTime is equivalent to invoking the seek command x seek n is the same as x currentTime n Changing currentTime or calling seek will require the stream to b...

Page 171: ...movie that is loaded in a presentation using a custom cursor for multiple movies store any special cursor resource number as a global variable that remains in memory between movies Cursor commands ca...

Page 172: ...r to specify default system cursors The term whichCursor must be one of the following integer values To use custom cursors set the cursor sprite property to a list containing the cast member to be use...

Page 173: ...r whichCursorCastMember Bitmap cast members smaller than the specified size are displayed at full size and larger ones are scaled proportionally to the specified size The default value is 32 for Windo...

Page 174: ...es the first vertex of the first curve in a vector shape down and to the right by 10 pixels member 1 curve 1 vertex 1 member 1 curve 1 vertex 1 point 10 10 The following code moves a sprite to the loc...

Page 175: ...rs if char 1 to 4 of the date 1 1 then alert Happy New Year Note The three date formats vary depending on the country for which your operating system was designed These examples are for the United Sta...

Page 176: ...ndler is useful when a projector runs in a window and the user can send it to the background to work with other applications Any MIAWs running in the projector can also make use of this handler During...

Page 177: ...del Dog debug TRUE See also boundingSphere debugPlaybackEnabled Syntax the debugPlaybackEnabled Description Property in Windows opens a Message window for debugging purposes in Shockwave and projector...

Page 178: ...rty is set to 100 and the far property is set to 1000 the fog will begin 100 world units in front of the camera and gradually increase in density to a distance of 1000 world units in front of the came...

Page 179: ...operty can have these values flash default Sets the default rectangle using the size of the movie as it was originally created in Flash fixed Sets the default rectangle using the fixed size specified...

Page 180: ...rFrame or on exitFrame handler To mimic the behavior of a halt in a handler when the playhead is not moving use the startTimer command or assign the current value of timer to a variable and wait for t...

Page 181: ...word 1 This statement deletes the first character of the string in the variable bidAmount if that character is the dollar sign if bidAmount char 1 then delete bidAmount char 1 See also char of field i...

Page 182: ...in a cast member this command removes the camera from the cast member and the 3D world Children of the camera are removed from the 3D world but not deleted It is not possible to delete the default cam...

Page 183: ...e endRecording end See also beginRecording endRecording updateFrame deleteGroup Syntax member whichCastmember deleteGroup whichGroup member whichCastmember deleteGroup index Description 3D command rem...

Page 184: ...the 3D world but not deleted Examples The first line of this example deletes the model named Player3 from the cast member named gbWorld The second line deletes the ninth model of gbWorld member gbWorl...

Page 185: ...with the deleted value If the value appears in the list more than once deleteOne deletes only the first occurrence Attempting to delete a property has no effect Example The first statement creates a l...

Page 186: ...leteShader index Description 3D command removes the shader from the cast member Example The first line of this example deletes the shader Road from the cast member named StreetScene The second line de...

Page 187: ...or dots used to create the effects of these specialized shader types Higher values result in more lines or dots For engraver shaders this property adjusts the number of lines used to create the image...

Page 188: ...s sds modifier property specifies the maximum number of levels of resolution that the model can display when using the sds modifier If the sds modifier s error and tension settings are low increasing...

Page 189: ...pop up windows appear entirely on one screen The result is a list of rectangles where each rectangle is the boundary of a monitor The coordinates for each monitor are relative to the upper left corne...

Page 190: ...ed Globe to rgb 255 0 0 member MysteryWorld shader Globe diffuse rgb 255 0 0 See also diffuseColor useDiffuseWithTexture blendFunction blendSource blendConstant diffuseColor Syntax member whichCastmem...

Page 191: ...glossMap region specularLightMap digitalVideoTimeScale Syntax the digitalVideoTimeScale Description System property determines the time scale in units per second that the system uses to track digital...

Page 192: ...e direction in which the particles of a particle system are emitted A particle system is a model resource whose type is particle The primary direction of particle emission is the vector set by the emi...

Page 193: ...n 3D cast member property indicates the direction from which the default directional light shines relative to the camera of the sprite Changing the value of this property results in changes to the pos...

Page 194: ...ite directly to the screen without first compositing it in the Director offscreen buffer The result can be similar to the trails ink effect of the Stage Explicitly refresh a trailed area by turning th...

Page 195: ...In this example the model resource of the model named Slogan is extruded text This statement sets the displayFace property of Slogan s model resource to back tunnel The front face of Slogan will not b...

Page 196: ...hich means that the RealNetworks logo is displayed when the movie starts to play and when it is stopped or rewound put sprite 2 displayRealLogo 1 put member Real displayRealLogo 1 The following exampl...

Page 197: ...when it is displayed at a color depth of 8 bits or less 256 colors if the display must show a color gradation not in the cast member TRUE or tells Director to choose the nearest color out of those ava...

Page 198: ...of two vectors multiply the x component of vector1 by the x component of vector2 then multiply the y component of vector1 by the y component of vector2 then multiply the z component of vector1 by the...

Page 199: ...Normalized function returns the normalized values of pos5 and pos6 and stores them in the variables norm1 and norm2 The dotProduct of norm1 and norm2 is 0 7071 which is the cosine of 45 pos5 vector 10...

Page 200: ...FTP or HTTP server an HTML page an external cast member a Director movie or a graphic localFile The pathname and filename for the file on the local disk Director movies in authoring mode and projecto...

Page 201: ...aws a line or an unfilled shape of color colorObject in a rectangular region of the given image object as specified in any of the three ways shown The draw returns a value of 1 if there is no error Yo...

Page 202: ...be tested and set Example This statement displays the current coordinates of the movie window called Control Panel put the drawRect of window Control Panel rect 10 20 200 300 The following statement...

Page 203: ...unction as the insertFrame command Example When used in the following handler the duplicateFrame command creates a series of frames that have cast member Ball in the external cast Toys assigned to spr...

Page 204: ...able workingImage workingImage member Lunar Surface image duplicate See also duplicate member duplicate member Syntax member originalMember duplicate member originalMember duplicate new duplicate memb...

Page 205: ...effect as the Duration setting in the Frame Transition dialog box This property can be tested for all cast members that support it but only set for transitions To see an example of duration used in a...

Page 206: ...D duration RealMedia Syntax sprite whichSprite duration member whichCastmember duration Description RealMedia sprite or cast member property returns the duration of the RealMedia stream in millisecond...

Page 207: ...e by using the Editable option in the Field Cast Member Properties dialog box You can make a field sprite editable by using the Editable option in the Score For the value set by Lingo to last beyond t...

Page 208: ...ess of any looping setting of the currentTime or other manipulation Use the currentTime to test for the current absolute time within the sound The value of this property is a floating point number all...

Page 209: ...lResource emitter region member whichCastmember modelResource whichModelResource emitter distribution member whichCastmember modelResource whichModelResource emitter angle member whichCastmember model...

Page 210: ...responses for cross platform movies Example The following statement checks if the computer is a Macintosh and if so sets the emulateMultiButtonMouse property to TRUE if the platform contains Macintos...

Page 211: ...sion property allows you to get or set whether TRUE or not FALSE collisions are detected on models Setting this property to FALSE temporarily disables the collision modifier without removing it from t...

Page 212: ...without an error message Be careful when using the sds modifier with the lod modifier For more information see the sds modifier entry Example This statement turns on the sds modifier attached to the m...

Page 213: ...by sweeping a 2D line around the sphere s Y axis from startAngle to endAngle If startAngle is set to 0 and endAngle is set to 360 the result is a complete cylinder To draw a section of a cylinder set...

Page 214: ...e endFrame Syntax sprite whichSprite endFrame Description Function returns the frame number of the end frame of the sprite span This function is useful in determining the span in the Score of a partic...

Page 215: ...essage and event handler contains Lingo that runs when the playhead leaves a sprite and goes to a frame in which the sprite doesn t exist It is generated after exitFrame Place on endSprite handlers in...

Page 216: ...Lingo checks whether the sound member Jingle is set to play all the way through in sound channel 1 if sound 1 startTime 0 and sound 1 endTime member Jingle duration then alert Not playing the whole s...

Page 217: ...ript has its own handler If the frame script has its own handler the on enterFrame handler in the frame script overrides the on enterFrame handler in the movie script The order of frame events is step...

Page 218: ...achine Integer TRUE or FALSE value indicating whether the movie is playing in ShockMachine shockMachineVersion String indicating the installed version number of ShockMachine platform String containing...

Page 219: ...th setting is high and its subdivision setting is adaptive this will cause a very pronounced effect on Baby s geometry member Scene model Baby sds error 0 See also sds modifier subdivision depth 3D te...

Page 220: ...ipt aParam if word 1 of aParam myHandler then do aParam end if end The following handler normally requires a string as its argument The argument is received as a symbol and then converted to a string...

Page 221: ...n else sprite 5 eventPassMode passAlways end if end exit Syntax exit Description Keyword instructs Lingo to leave a handler and return to where the handler was called If the handler is nested within a...

Page 222: ...prepareFrame enterFrame and exitFrame Examples This handler turns off all puppet conditions when the playhead exits the frame on exitFrame me repeat with i 48 down to 1 sprite i puppet FALSE end repea...

Page 223: ...peat loop when a specified condition such as two values being equal or a variable being a certain value exists Example The following handler searches for the position of the first vowel in a string re...

Page 224: ...define and name this function in the HTML header In the movie the function name and parameters are defined as a string in externalEvent Because the parameters must be interpreted by the browser as se...

Page 225: ...yntax externalParamName n Description Function returns the name of a specific parameter in the list of external parameters from an HTML EMBED or OBJECT tag This function is valid only for Shockwave mo...

Page 226: ...the applet s parameters instead of the EMBED tag parameters Accepts only string parameters Returns a zero length string rather than VOID See Parameters for OBJECT and EMBED tags and Parameters access...

Page 227: ...ate a model named 3dLogo myTextModelResource member Logo extrude3d member Scene member Scene newModel 3dLogo myTextModelResource See also bevelDepth bevelType displayFace smoothness tunnelDepth displa...

Page 228: ...e coordinate list of the model resource to use for each of the vertices of the face vertices indicates which indices in the vertex list of the model resource to use to define the face See the entry fo...

Page 229: ...deOut milliseconds fadeOut sound channelNum milliseconds Description This function gradually reduces the volume of sound channel channelNum to zero over the given number of milliseconds or 1000 millis...

Page 230: ...ALSE has the numerical value of 0 Conversely 0 is treated as FALSE Example This statement turns off the soundEnabled property by setting it to FALSE the soundEnabled FALSE See also if not TRUE far fog...

Page 231: ...Syntax sprite whichQTVRSprite fieldOfView the fieldOfView of sprite whichQTVRSprite Description QTVR sprite property gives the specified sprite s current field of view in degrees This property can be...

Page 232: ...rom the Internet and minimize download time use the downloadNetThing or preloadNetThing command to download the cast s file to a local disk first and then set fileName castLib to the file on the disk...

Page 233: ...in the background before assigning a new file to a cast member Changing the fileName member property in a movie playing as an applet can make the applet wait for the new file to download This property...

Page 234: ...m colorObjectOrParameterList imageObject fill point x y point x y colorObjectOrParameterList imageObject fill rect colorObjectOrParameterList Description This function fills a rectangular region with...

Page 235: ...f fillColor used in a completed movie see the Vector Shapes movie in the Learning Lingo Examples folder inside the Director application folder Example This statement sets the fill color of the member...

Page 236: ...cast member is filled with a pattern TRUE or not FALSE Example The following statements make the shape cast member Target Area a filled shape and assign it the pattern numbered 1 which is a solid colo...

Page 237: ...xample This statement changes the fill offset of the vector shape cast member miette to a horizontal offset of 33 pixels and a vertical offset of 27 pixels member miette fillOffset point 33 27 See als...

Page 238: ...abel doesn t exist or if that portion of the Flash movie has not yet been streamed in findPos Syntax list findPos property findPos list property Description List command identifies the position of the...

Page 239: ...of the value with the most similar alphanumeric name This command is useful in finding the name that is the closest match in a sorted directory of names Example This statement identifies the position...

Page 240: ...f each line in the chunkExpression portion of the text cast member The value itself is an integer indicating height in absolute pixels of each line The default value is 0 which results in natural heig...

Page 241: ...ageSize property cannot change the Stage size for a movie that is currently playing This property can be tested and set Examples The following statement determines whether the fixStageSize property is...

Page 242: ...its upper left corner The cast member s originPoint property is used only for rotation and scaling not to calculate movie coordinates The flashToStage and the corresponding stageToFlash functions are...

Page 243: ...te whichSpriteNumber flipH the flipH of sprite whichSpriteNumber Description Sprite property indicates whether a sprite s image has been flipped horizontally on the Stage TRUE or not FALSE The image i...

Page 244: ...cision 1 put 2 2 4 put 2 float 2 4 0 the floatPrecision 4 put 22 7 3 put 22 float 7 3 1429 See also floatPrecision ilk floatP Syntax expression floatP floatP expression Description Function indicates...

Page 245: ...nt numbers are rounded to the absolute value for the number of decimal places Trailing zeros are dropped This property can be tested and set Examples This statement rounds off the square root of 3 0 t...

Page 246: ...lso color fog decayMode enabled fog far fog near fog font Syntax member whichCastMember font the font of member whichCastMember Description Text and field cast member property determines the font used...

Page 247: ...sted and set When tested it returns the height of the first line in the field When set it affects every line in the field To see an example of fontSize used in a completed movie see the Text movie in...

Page 248: ...in the Learning Lingo Examples folder inside the Director application folder Examples This statement sets the variable named oldStyle to the current fontStyle setting for the field cast member Rokujo...

Page 249: ...oreground color of sprite 5 oldColor sprite 5 foreColor The following statement makes 36 the number for the foreground color of a random sprite from sprites 11 to 13 sprite 10 random 3 foreColor 36 Th...

Page 250: ...respond to the forget command Example This statement instructs Lingo to delete the window Control Panel when the movie no longer uses the window window Control Panel forget See also close window open...

Page 251: ...member property indicates the number of frames in the Flash movie cast member The frameCount member property can have integer values This property can be tested but not set Example This sprite script...

Page 252: ...Palette 45 See also puppetPalette frameRate Syntax member whichCastMember frameRate the frameRate of member whichCastMember Description Cast member property specifies the playback frame rate for the s...

Page 253: ...sprite whichFlashSprite frameNumber Description Function for a Flash movie determines whether a streaming movie is ready for display If enough of a sprite has streamed into memory to render the frame...

Page 254: ...layhead proceed to the next frame of the Director movie on exitFrame if the frameReady sprite 5 25 FALSE then go to the frame else play sprite 5 end if end See also mediaReady frameScript Syntax the f...

Page 255: ...ding session this statement assigns the sound cast member Jazz to the second sound channel the frameSound2 member Jazz number framesToHMS Syntax framesToHMS frames tempo dropFrame fractionalSeconds De...

Page 256: ...tement checks the tempo used in the current frame In this case the tempo is 15 frames per second put the frameTempo 15 See also puppetTempo frameTransition Syntax the frameTransition Description Frame...

Page 257: ...freeBytes Syntax the freeBytes Description Function indicates the total number of bytes of free memory which may not be contiguous A kilobyte K is 1024 bytes A megabyte MB is 1024 kilobytes This func...

Page 258: ...tem property indicates which movie in a window MIAW is currently frontmost on the screen When the Stage is frontmost front window is the Stage When a media editor or floating palette is frontmost fron...

Page 259: ...led by that normal are determined by the shader If the vertex normal points away from the camera the area of the mesh controlled by that normal will be non visible After using the generateNormals comm...

Page 260: ...doesn t exist a script error will occur if the property doesn t exist when using bracket access See also getAt getOne getProp setaProp setAt getAt Syntax getAt list position list position Description...

Page 261: ...loyeeInfoList 1 put firstPerson Dennis consulting 510 firstPersonDept firstPerson 2 put firstPersonDept consulting As with getAt brackets can be nested firstPersonDept employeeInfoList 1 2 See also ge...

Page 262: ...tiple line descriptions Example This statement displays Jigsaw puzzle piece in the description pane on getBehaviorTooltip return Jigsaw puzzle piece end See also on getPropertyDescriptionList on getBe...

Page 263: ...rom loading fileFormat The file was found but it appears to be of the wrong type or an error occurred while reading the file other Some other error occurred When an error occurs as a cast member strea...

Page 264: ...Artists else go to frame Sorry end if end if end See also clearError getErrorString state Flash SWA getError XML Syntax parserObject getError Description Function returns the descriptive error string...

Page 265: ...ovie clips or levels within a Flash movie This is similar to testing sprite properties within Director The targetName is the name of the movie clip or level whose property you want to get within the g...

Page 266: ...t with information about the user s video card The list contains the following properties present is a Boolean value indicating whether the computer has hardware video acceleration vendor indicates th...

Page 267: ...the hot spot doesn t exist or isn t visible on the Stage this function returns rect 0 0 0 0 If the hot spot is partially visible this function returns the bounding rectangle for the visible portion ge...

Page 268: ...meter propertyList to take a property list for CGI queries The property list is URL encoded and the URL sent is urlstring encodedproplist Use the optional parameter serverOSString to encode any return...

Page 269: ...as the previous example but it uses a property list to submit a CGI query and does the URL encoding for you getNetText http www yourserver com cgi bin query cgi name Bill See also netDone netError ne...

Page 270: ...tosh use a pathname such as HardDisk Director Movies To look for files on the Macintosh desktop use the path HardDisk Desktop Folder This function is not available in Shockwave Example The following h...

Page 271: ...ing on the bit depth of the image If you include the optional parameter value integer however it s returned as a raw number If you re setting a lot pixels to the color of another pixel it s faster to...

Page 272: ...rtTime 3000 endTime 10000 loopCount 5 loopStartTime 8000 loopEndTime 8900 sound 2 play put sound 2 getPlaylist end member member 12 of castLib 2 startTime 3000 endTime 10000 loopCount 5 loopStartTime...

Page 273: ...prefFileName with the name of a file created by the setPref function If no such file exists getPref returns VOID The filename used for prefFileName must be a valid filename only not a full path Direct...

Page 274: ...on for property lists only identifies the property name associated with the position specified by index in the property list specified by list If the specified item isn t in the list or if you use get...

Page 275: ...so addProp on getBehaviorDescription on runPropertyDialog getRendererServices Syntax getRendererServices getRendererServices whichGetRendererServicesProperty Description 3D command returns the rendere...

Page 276: ...amStatus URLString Description Function returns a property list matching the format used for the globally available tellStreamStatus function that can be used with callbacks to sprites or objects The...

Page 277: ...not be a valid object reference Examples This statement sets the variable tValue to the string value of the Flash variable named gOtherVar in the Flash movie in sprite 3 tValue sprite 3 getVariable gO...

Page 278: ...mber 3d world model Box getworldTransform rotation vector 0 0000 0 0000 0 0000 See also worldPosition transform property global Syntax global variable1 variable2 variable3 Description Keyword defines...

Page 279: ...in the list with the associated paired value You can use the following list operations on globals count Returns the number of entries in the list getPropAt n Returns the name of the nth entry getProp...

Page 280: ...u to get or set the gravity property of the resource as a vector This property defines the gravity force applied to all particles in each simulation step The default value for this property is vector...

Page 281: ...vie file to a local disk first and then use the go to movie command to go to that movie on the local disk The following are reset when a movie is loaded beepOn and constraint properties keyDownScript...

Page 282: ...frame 1 if there are no markers in the movie The go next command is equivalent to the statement go marker 1 that was used in earlier versions of Lingo Example This statement sends the playhead to the...

Page 283: ...ng handler branches to different points within a Flash movie in channel 5 It accepts a parameter that indicates which frame to go to on Navigate whereTo sprite 5 goToFrame whereTo end gotoNetMovie Syn...

Page 284: ...that window or frame If targetName isn t a frame or window that is currently open goToNetPage opens a new window Using the string _new always opens a new window If targetName is not included gotoNetPa...

Page 285: ...gradientType linear else member backdrop gradientType radial end if end See also fillMode group Syntax member whichCastmember group whichGroup member whichCastmember group index Description 3D element...

Page 286: ...SE if it does not The script object must be a parent script a child object or a behavior Example This Lingo code invokes a handler on an object only if that handler exists if spiderObject handler poun...

Page 287: ...s setting the sprite s height automatically sets the sprite s stretch property to TRUE For the value set by Lingo to last beyond the current sprite the sprite must be a puppet This property can be tes...

Page 288: ...model s resource Set the renderStyle property to point to see just the vertices of the mesh The value of this property must be greater than or equal to 2 The default value is 4 Example The following...

Page 289: ...ength property of the toon modifier for the model named Teapot to 0 5 The model s highlights will be moderately bright member shapes model Teapot toon highlightStrength 0 5 See also highlightPercentag...

Page 290: ...to select the button cast member powerSwitch by setting the hilite member property for the cast member to TRUE member powerSwitch hilite TRUE See also checkBoxAccess checkBoxType hitTest Syntax sprit...

Page 291: ...tes the distance in world units from the camera beyond which models are drawn Objects closer to the camera than hither are not drawn The value of this property must be greater than or equal to 1 0 and...

Page 292: ...tempo is 30 frames per second Neither the dropFrame nor fractionalSeconds arguments is used put HMStoFrames 00 01 30 10 30 FALSE FALSE 2710 This statement converts 600 seconds into minutes put framesT...

Page 293: ...utside the bounds of the cursor produces an error For example setting the hotspot of a 16 by 16 pixel cursor to point 16 16 produces an error because the starting point is 0 0 not 1 1 This property ca...

Page 294: ...Syntax member whichMember HTML Description Cast member property accesses text and tags that control the layout of the text within an HTML formatted text cast member This property can be tested and set...

Page 295: ...e character range of the hyperlink in the text It s possible to get the text of the range itself by using the syntax member Ref char range 1 range 2 This handler should be attached to a sprite as a be...

Page 296: ...ndow put member Glossary hyperlinks 3 8 10 16 41 54 hyperlinkState Syntax textChunk hyperlinkState Description Text cast member property contains the current state of the hyperlink Possible values for...

Page 297: ...the model named Box to the identity transform member 3d world model Box transform identity See also transform property getWorldTransform on idle Syntax on idle statement s end Description System messa...

Page 298: ...ount of time between idle events is determined by idleHandlerPeriod Possible settings for idleHandlerPeriod are 0 As many idle events as possible 1 Up to 60 per second 2 Up to 30 per second 3 Up to 20...

Page 299: ...ds according to the following values 0 Does not perform idle loading 1 Performs idle loading when there is free time between frames 2 Performs idle loading during idle events 3 Performs idle loading a...

Page 300: ...puter is idle The idleLoadTag is a convenience that identifies the cast members in a group that you want to preload The property can be tested and set using any number that you choose Example This sta...

Page 301: ...ondition that is met or not met Thus faster code may be created by nesting if then statements on separate lines instead of placing them all on the first line to be evaluated When the condition is a pr...

Page 302: ...easure end if end if See also case ignoreWhiteSpace Syntax XMLparserObject ignoreWhiteSpace trueOrFalse Description XML Command specifies whether the parser should ignore or retain white space when ge...

Page 303: ...space character XMLtext sample sub phrase 1 sub sample gparser ignoreWhiteSpace FALSE gparser parseString XMLtext theList gparser makeList put theList ROOT OF XML DOCUMENT ATTRIBUTES sample ATTRIBUTES...

Page 304: ...llo void void void ilk void picture picture picture ilk member 2 picture parent script instance instance object ilk new script blahblah xtra instance instance object ilk new xtra fileio member member...

Page 305: ...e object to the specified type If the object is of the specified type the ilk function returns TRUE It the object is not of the specified type the ilk function returns FALSE The following table shows...

Page 306: ...to the image of the specified member or window If you make changes to the image the contents of the cast member or window change immediately If you plan to make a lot of changes to an item s image pr...

Page 307: ...member or window To see an example of image used in a completed movie see the Imaging movie in the Learning Lingo Examples folder inside the Director application folder Example These statements create...

Page 308: ...mpression that Director will apply to the member when saving the movie in Shockwave format This property can be tested and set and has no effect at runtime Its value can be any one of these symbols Yo...

Page 309: ...a later frame of the movie this frame script checks to see if the Flash movie sprite specified by the global variable gStreamingSprite has finished streaming into memory If it has not the script keeps...

Page 310: ...ful as a way of improving performance during animation because models that do not move do not need to be checked for collisions by Lingo This property has a default value of FALSE Example This stateme...

Page 311: ...ion of the download before using importFileInto with the file In Director and projectors importFileInto automatically downloads the file for you Example This handler assigns a URL that contains a GIF...

Page 312: ...on reduces the rectangle s size Examples This statement increases the rectangle s width by 4 pixels and the height by 2 pixels rect 10 10 20 20 inflate 2 1 rect 8 9 22 21 This statement decreases the...

Page 313: ...amples This statement changes the variable currentInk to the value for the ink effect of sprite 3 currentInk sprite 3 ink This statement gives sprite i 1 a matte ink effect by setting the ink effect o...

Page 314: ...perty allows the user to enter double byte characters directly into the Director Text Field Script and Message windows on Japanese systems This property can be tested and set The default value is dete...

Page 315: ...yntax sprite whichSprite camera index insertOverlay index texture locWithinSprite rotation member whichCastmember camera whichCamera insertOverlay index texture locWithinSprite rotation Description 3D...

Page 316: ...playing To remove the custom menus use the installMenu command with no argument or with 0 as the argument This command doesn t work with hierarchical menus For an explanation of how menu items are def...

Page 317: ...ion Description Function indicates whether the expression specified by expression can be evaluated to an integer 1 or TRUE or not 0 or FALSE P in integerP stands for predicate Examples This statement...

Page 318: ...fference of two numbers by the percentage For example interpolation from 4 to 8 by 50 percent yields 6 Example In this example tBox is the transform of the model named Box and tSphere is the transform...

Page 319: ...ectangle toolKit intersect Ramp See also map rect union interval Syntax member whichCursorCastMember interval the interval of member whichCursorCastMember Description Cursor cast member property speci...

Page 320: ...he invert function Example This statement inverts a copy of the transform of the model named Chair boxInv member 3d world model Chair transform inverse See also invert invert Syntax member whichCastme...

Page 321: ...nnelNum isBusy Description Function returns TRUE if sound channel channelNum is currently playing or pausing a sound and FALSE if it hasn t started playing any of its queued sounds or has been stopped...

Page 322: ...an add this handler to a behavior in order to check the type of sprite the behavior is being attached to and prevent the behavior from being attached to inappropriate sprite types When the behavior is...

Page 323: ...WA sounds can appear as sprites in sprite channels but they play sound in a sound channel It is recommended that you refer to SWA sound sprites by their sprite channel number rather than their sound c...

Page 324: ...me VR movie FALSE Testing for this property in anything other than an asset whose type is quickTimeMedia produces an error message This property can be tested but not set Example The following handler...

Page 325: ...chunk between the commas The following statement looks for the third through fifth items in the chunk expression Because there are only four items in the chunk expression only the third item is used a...

Page 326: ...s automatically kerned when the contents of the text cast member are changed When set to TRUE kerning is automatic when set to FALSE kerning is not done This property defaults to TRUE See also kerning...

Page 327: ...ler checks whether the Return key is pressed and if it is navigates to the main menu marker on prepareMovie the keyDownScript checkKey end prepareMovie on checkKey if the key RETURN then go to frame M...

Page 328: ...Lingo to test which characters correspond to different keys on different keyboards This function can be tested but not set Examples This handler uses the Message window to display the appropriate key...

Page 329: ...in the applet before the applet can receive any keys that the user types When the movie plays back as an applet an on keyDown handler always traps key presses even if the handler is empty If the user...

Page 330: ...s The following statement sets keyDownScript to if the key RETURN then go to the frame 1 When this statement is in effect the movie always goes to the next frame whenever the user presses the Return k...

Page 331: ...dicates whether the model can be displaced from the specified planes positionReset indicates whether the model returns to its starting position after the end of a motion or each iteration of a loop ro...

Page 332: ...n Lingo is in a repeat loop Use the sample movie Keyboard Lingo to test which characters correspond to different keys on different keyboards This property can be tested but not set Examples The follow...

Page 333: ...the field Where you place an on keyUp handler can affect when it runs as follows To apply the handler to a specific editable field sprite put it in a behavior To apply the handler to an editable field...

Page 334: ...ker label specified by expression The term expression should be a label in the current movie if it s not this function returns 0 Examples This statement sends the playhead to the tenth frame after the...

Page 335: ...lines and ranges within containers Examples This statement identifies the last word of the string Macromedia the multimedia company and displays the result in the Message window put the last word of M...

Page 336: ...er lastError Description RealMedia sprite or cast member property allows you to get the last error symbol returned by RealPlayer as a Lingo symbol The error symbols returned by RealPlayer are strings...

Page 337: ...the lastKey Description System property gives the time in ticks 1 tick 1 60 of a second since the last key was pressed Example This statement checks whether 10 seconds have passed since the last key w...

Page 338: ...e Stage s left edge the script runs the handler offLeftEdge if sprite 3 left 0 then offLeftEdge This statement measures the left horizontal coordinate of the sprite numbered i 1 and assigns the value...

Page 339: ...he number of characters in the string specified by string including spaces and control characters such as TAB and RETURN Examples This statement displays the number of characters in the string Macro m...

Page 340: ...shader to wire to see the faces of the mesh of the model s resource Set the renderStyle property to point to see just the vertices of the mesh The value of this property must be greater than or equal...

Page 341: ...icle This statement sets the lifetime property of ThermoSystem to 90 0 This means each particle of ThermoSystem will exist for 90 milliseconds member 8 2 modelResource ThermoSystem lifetime 90 0 See a...

Page 342: ...e Action to the field cast member To Do member To Do text Action line 1 4 This statement inserts the word and after the second word of the third line of the string assigned to the variable Notes put a...

Page 343: ...ns a 0 or 1 indicating the slope of the line drawn If the line is inclined from left to right the property is set to 1 and if it is declined from left to right the property is set to 0 This property c...

Page 344: ...member whichCastmember model whichModel toon lineOffset member whichCastmember model whichModel inker lineOffset Description 3D toon and inker modifier property indicates the apparent distance from t...

Page 345: ...ng of the member If Lingo changes the member s lineSize setting while a sprite is on the Stage the sprite s lineSize setting remains in effect until the sprite is finished For the value set by Lingo t...

Page 346: ...inked member to an internally stored member member homeBodies linked 0 See also fileName cast member property pathName cast member property list Syntax list value1 value2 value3 Description Function a...

Page 347: ...y whichCastMember is loaded into memory TRUE or not FALSE Different cast member types have slightly different behaviors for loading Shape and script cast members are always loaded into memory Movie ca...

Page 348: ...Roadway If any imported objects have the same names as objects already in Roadway Director will create new names for them member Roadway loadFile Truck W3d FALSE TRUE The following statement imports...

Page 349: ...3D locH Syntax sprite whichSprite locH the locH of sprite whichSprite Description Sprite property indicates the horizontal position of the specified sprite s registration point Sprite coordinates are...

Page 350: ...del bonesPlayer lockTranslation member whichCastmember model whichModel keyframePlayer lockTranslation Description 3D bonesPlayer and keyframePlayer modifier property prevents displacement from the sp...

Page 351: ...mouseV See also bottom height left loc locH point right top updateStage width locVToLinePos Syntax member whichCastMember locVToLinePos locV locVToLinePos member whichCastMember locV Description Func...

Page 352: ...epare for the next mouseUp call on mouseUp me global gHighestSprite sprite me spriteNum locZ gHighestSprite 1 gHighestSprite gHighestSprite 1 end See also locH locV lod modifier Syntax member whichCas...

Page 353: ...property is 0 0 to 100 00 Note For more detailed information about these properties see the individual property entries See also sds modifier auto bias level addModifier log Syntax log number Descrip...

Page 354: ...fined by the emitter s region property A value of FALSE causes the particles to die at the end of their lifetime The default setting for this property is TRUE Example In this example ThermoSystem is a...

Page 355: ...downloading the movie advances to the next frame and the loop property of the Flash movie in channel 6 is set to FALSE so that it will continue playing through to the end and then stop imagine that t...

Page 356: ...lNum loopCount the loopCount of sound channelNum Description Cast member property the total number of times the current sound in sound channel channelNum is set to loop The default is 1 for sounds tha...

Page 357: ...playback to fractions of a millisecond This property can only be set when passed as a property in a queue or setPlaylist command Example This handler plays sound cast member introMusic in sound chann...

Page 358: ...ating point number allowing you to measure and control sound playback to fractions of a millisecond The default is the startTime of the sound if no loop has been defined This property can only be set...

Page 359: ...000 MyVec2 vector 100 100 0 put MyVec2 magnitude 141 4214 See also length 3D identity makeList Syntax parserObject makeList Description Function returns a property list based on the XML document parse...

Page 360: ...based on the relationship of a source rectangle to a target rectangle The relationship of the targetRect to the sourceRect governs the relationship of the result of the function to the destinationRect...

Page 361: ...eck The model will sit down and look up at the same time member Restaurant motion SitDown map LookUp Neck See also motion duration 3D cloneMotionFromCastmember mapMemberToStage Syntax sprite whichSpri...

Page 362: ...ze in pixels of the margin inside the field box Example The following statement sets the margin inside the box for the field cast member Today s News to 15 pixels member Today s News margin 15 marker...

Page 363: ...Credits 15 Main Menu 26 Closing Credits marker mask Syntax member whichQuickTimeMember mask the mask of member whichQuickTimeMember Description Cast member property specifies a black and white 1 bit c...

Page 364: ...est value in the specified list or the highest of a given series of values The max function also works with ASCII characters similar to the way and operators work with strings Example The following ha...

Page 365: ...In this example ThermoSystem is a model resource of the type particle This statement sets the maxSpeed property of ThermoSystem to 15 which causes the fastest particles of ThermoSystem to move fairly...

Page 366: ...the script named Bird The me keyword accepts the parameter script Bird and is used to return that parameter myBird1 new script Bird This is the on new handler of the Bird script on new me return me e...

Page 367: ...er Dawn by setting the media member property value for Dawn to the media member property value for Sunrise member Dawn media member Sunrise media See also type cast member property media mediaReady Sy...

Page 368: ...ring indicates that the RealMedia stream is being downloaded into the playback buffer When buffering is complete percentBuffered equals 100 the RealMedia stream begins to play if the pausedAtStart pro...

Page 369: ...16 1 put member scene texture gbTexture member member 16 of castLib 1 member keyword Syntax member whichCastMember member whichCastMember of castLib whichCast member whichCastMember whichCastLib Descr...

Page 370: ...alert Sorry that member doesn t exist Alternatively you can check for the existence of a member by testing for its type memberCheck member Epiphany type if memberCheck empty then alert Sorry that memb...

Page 371: ...property by using the phrase the number of the member of sprite x You can also retrieve other cast member properties by using phrases such as the name of the member of sprite x or the rect of the mem...

Page 372: ...within a script while the playhead is not moving be sure to use the updateStage command to redraw the Stage This property can be tested and set Examples The following statement switches the cast membe...

Page 373: ...here is not enough memory to run this movie See also freeBlock freeBytes ramNeeded size menu Syntax menu menuName itemName script itemName script or menu menuName itemName script itemName script more...

Page 374: ...tom handler convertThis menu File Open O go to frame Open Close W go to frame Close Convert C convertThis Quit Q go to frame Quit See also installMenu name menu property name menu item property number...

Page 375: ...d set access to the properties of the specified texture layer face index allows you to get or set the vertices normals texture coordinates colors and shaders used by the faces of the specified mesh fa...

Page 376: ...of faces in the model named gbFace put member 3D World model gbFace meshDeform face count 432 The following statement displays the number of meshes in the model named gbFace put member 3D World model...

Page 377: ...end See also max minSpeed Syntax member whichCastmember modelResource whichModelResource emitter minSpeed Description 3D property when used with a model resource whose type is particle allows you to g...

Page 378: ...e expression is the integer remainder of the division It always has the sign of integerExpression1 This is an arithmetic operator with a precedence level of 4 Examples This statement divides 7 by 4 an...

Page 379: ...odal window property is FALSE movies can respond to events outside the window Setting the modal window property to TRUE lets you make a specific movie in a window the only movie that the user can inte...

Page 380: ...Description 3D collision modifier property indicates the geometry to be used in the collision detection algorithm Using simpler geometry such as the bounding sphere leads to better performance The po...

Page 381: ...e to the model named Player Avatar in the variable thismodel thismodel member 3DWorld model Player Avatar This statement stores a reference to the eighth model of the cast member named 3DWorld in the...

Page 382: ...gument with the collideWith and collideAny events to the handler specified in the registerForEvent registerScript and setCollisionCallback commands The collideWith and collideAny events are sent when...

Page 383: ...ource thismodelResource member 3DWorld modelResource HouseA This statement stores a reference to the fourteenth model resource of the cast member named 3DWorld in the variable thismodelResource thismo...

Page 384: ...furthest from the viewer Only one intersection the closest intersection is returned per model The command returns an empty list if there are no models found under the specified point Example The firs...

Page 385: ...to index into the face list of the meshDeform modifier vertices is a 3 element list of vectors that represent the world space positions of the vertices of the intersected face uvCoord is a property l...

Page 386: ...nt The third line displays the result in the message window on mouseUp pt the mouseLoc point sprite 5 left sprite 5 top m sprite 5 camera modelUnderLoc pt put m end See also modelsUnderLoc modelsUnder...

Page 387: ...dDate Syntax member modifiedDate the modifiedDate of member Description Cast member property indicates the date and time that the cast member was last changed using the system time on the authoring co...

Page 388: ...index within the model s attached modifier list The value returned is a symbol If no modifier is found at the specified position then this property s value is void To obtain information about a model...

Page 389: ...ement tells the Message window to display the number for the most recent cue point passed in the sprite in sprite channel 1 put sprite 1 mostRecentCuePoint This statement returns the ordinal number of...

Page 390: ...ins the number of the character that is under the pointer when the property is called The count is from the beginning of the field If the mouse pointer is not over a field or is in the gutter of a fie...

Page 391: ...d to explicitly pass the mouseDown message on to the next location To have the same response throughout the movie when pressing the mouse button set mouseDownScript or put a mouseDown handler in a Mov...

Page 392: ...u try to test mouseDown inside a repeat loop in an applet the applet hangs Example This handler causes the movie to beep until the user clicks the mouse on enterFrame repeat while the mouseDown FALSE...

Page 393: ...nScript go next In this statement when the user clicks anywhere on the Stage the computer beeps the mouseDownScript if the clickOn 0 then beep The following statement sets mouseDownScript to the custo...

Page 394: ...pixels the cursor is positioned from the left edge of the Stage The mouseH function is useful for moving sprites to the horizontal position of the mouse pointer and checking whether the pointer is wit...

Page 395: ...to a local variable Examples This statement determines whether the pointer is over a field sprite and changes the content of the field cast member Instructions to Please point to an item when it is n...

Page 396: ...tMember sprite spritenum member number sprite spritenum member currentMember 1 end See also on mouseEnter on mouseWithin mouseLevel Syntax sprite whichQuickTimeSprite mouseLevel the mouseLevel of spri...

Page 397: ...handler or repeat loop If a handler or repeat loop uses this property multiple times it s usually a good idea to call the property once and assign its value to a local variable Examples This statemen...

Page 398: ...ith a consistent value assign the mouseMember value to a local variable when the handler starts and use the variable For casts other than cast 1 mouseMember returns a value that does not distinguish b...

Page 399: ...lick here to go to the next page FALSE member Message Line text end case updatestage end on mouseUp event handler Syntax on mouseUp statement s end Description System message and event handler contain...

Page 400: ...pt reference me Example This handler assigned to sprite 10 switches the cast member assigned to sprite 10 when the user releases the mouse button after clicking the sprite on mouseUp sprite 10 member...

Page 401: ...eUpScript property is defined Lingo executes the instructions specified for the mouseUpScript property first Unless the instructions include the pass command so that the mouseUp message can be passed...

Page 402: ...e Director player for Java doesn t update the mouseV property when Lingo is in a repeat loop This property can be tested but not set Examples This handler moves sprite 1 to the mouse pointer location...

Page 403: ...od idea to call the function once and assign its value to a local variable Examples This statement determines whether the pointer is over a field sprite and changes the content of the field cast membe...

Page 404: ...ent checks whether a sprite is moveable and if it is not displays a message if sprite 13 moveableSprite FALSE then member Notice text You can t drag this item by using the mouse See also mouseLoc move...

Page 405: ...ont myWindow If the you know the name of the window you want to move to the front use the syntax window Demo Window moveToFront moveVertex Syntax member memberRef MoveVertex vertexIndex xChange yChang...

Page 406: ...of the second vertex point in the vector shape Archie 15 pixels to the right and 5 pixels up MoveVertexHandle member Archie 2 1 15 5 See also addVertex deleteVertex originMode vertexList on moveWindow...

Page 407: ...ure versions of Shockwave This property can be tested but not set Example This statement displays the copyright information in a text cast member member Display text Copyright the movieCopyrightInfo S...

Page 408: ...the movieFileVersion 800 movieImageCompression Syntax the movieImageCompression Description Movie property indicates the type of compression that Director applies to internal non linked bitmap member...

Page 409: ...tax the movieName Description Movie property indicates the simple name of the current movie In the Director authoring environment a new movie that has not been saved has an empty string as this proper...

Page 410: ...actors such as the performance of the computer the movie is playing on and whether the digital video sprite is stretched This property can be tested and set To see an example of movieRate used in a co...

Page 411: ...name entry such as when the Xtra exists only on one platform packagefiles Set only when the Xtra is marked for downloading The value of this property is another list containing a property list for eac...

Page 412: ...ne sound channel if the multiSound then sound playFile 2 Music wav name Syntax member whichCastmember texture whichTexture name member whichCastmember shader whichShader name member whichCastmember mo...

Page 413: ...n Cast member property determines the name of the specified cast member The argument whichCastMember is a string when is used as the cast member name or an integer when used as the cast member number...

Page 414: ...menus name menu item property name menu item property Syntax the name of menuItem whichItem of menu whichMenu the name of menuItem whichItem of menu whichMenu Description Menu property determines the...

Page 415: ...o Xtra Xtra extensions that provide support services or other functions not available to Lingo will not support this property This property can be tested but not set Example This statement displays th...

Page 416: ...Lingo return value indicates that a specified Lingo expression is not a number This statement attempts to display the square root of 1 which is not a number in the Message window put 1 sqrt NAN See a...

Page 417: ...improves appearance at the expense of performance with bilinear being less performance costly than trilinear When the property s value is TRUE bilinear filtering is used When the value is FALSE biline...

Page 418: ...seUp netAbort myNetID end See also getNetText postNetText netDone Syntax netDone netDone netID Description Function indicates whether a background loading operation such as getNetText preloadNetThing...

Page 419: ...work operation Use netError netID to test the network operation specified by netID Several possible error codes may be returned 0 Everything is okay 4 Bad MOA class The required network or nonnetwork...

Page 420: ...that the operation is complete and successful After the next operation starts the Director movie or projector discards the results of the previous operation to conserve memory The actual date string i...

Page 421: ...yMimeType of image jpeg go frame jpeg info image gif go frame gif info application x director goToNetMovie theURL text html goToNetPage theURL otherwise alert Please choose a different item end case e...

Page 422: ...e file on the network If the specified network operation was postNetText the result is the server s response After the next operation starts Director discards the results of the previous operation to...

Page 423: ...cast members the type parameter sets the cast member s type Possible predefined values correspond to the existing cast member types bitmap field and so on The new function can also create Xtra cast me...

Page 424: ...ax set newMember new bitmap After the line has been executed newMember will contain the member reference to the cast member just created put newMember member 1 of castLib 1 The following startMovie sc...

Page 425: ...child object the speed of the object is displayed in the Message window myBird1 script Bird new 15 myBird2 script Bird new 25 myBird1 fly myBird2 fly This message appears in the Message window I am fl...

Page 426: ...new group newGroupName and adds it to the group palette You cannot have two groups in the palette with the same name Example This statement creates a group called gbGroup2 within the cast member Scen...

Page 427: ...is argument to get default white color per face corner numTextureCoordinates is the optional number of user specified texture coordinates used by all the faces Enter 0 or omit this argument to get the...

Page 428: ...Shapes newModel Pyramid1 nm See also newModelResource newModel Syntax member whichCastmember newModel newModelName whichModelResource Description 3D command creates a new model in the referenced cast...

Page 429: ...ing front back both A facing of both creates the double amount of meshes and consequently produces double the number of shader entries in the shaderList There will be 2 for planes and spheres for the...

Page 430: ...t be separated by a comma The command returns a reference to the new object The following syntax creates an object within a Flash sprite flashSpriteReference newObject objectType arg1 arg2 The followi...

Page 431: ...all of the standard properties colorSteps hilightPercentage hilightStrength name shadowPercentage shadowStrength and style engraver shaders are lined have the appearance of an engraving and have the...

Page 432: ...eference parameter must be a cast member reference if you specify fromCastMember or must be a Lingo image object if you specify fromImageObject Example The first line of this statement creates a new t...

Page 433: ...t node ID displayed by the sprite This property can be tested and set nodeEnterCallback Syntax sprite whichQTVRSprite nodeEnterCallback the nodeEnterCallback of sprite whichQTVRSprite Description Quic...

Page 434: ...callback The QuickTime VR sprite receives the message first To avoid a performance penalty set a callback property only when necessary This property can be tested and set nodeType Syntax sprite which...

Page 435: ...List property may be generated for you by the generateNormals method of mesh model resources In the context of the meshDeform modifier the normalList property is similarly a linear list of vectors fro...

Page 436: ...ms a logical negation on a logical expression This is the equivalent of making a TRUE value FALSE and making a FALSE value TRUE It is useful when testing to see if a certain known condition is not the...

Page 437: ...This handler instructs the movie to do nothing so long as the mouse button is being pressed on mouseDown repeat while the stillDown nothing end repeat end mouseDown See also if nudge Syntax sprite wh...

Page 438: ...CastMember is an integer The property is a unique identifier for the cast member that is a single integer describing its location in and position in the castLib This property can be tested but not set...

Page 439: ...aracters in the word i located in the string Names charCounter the number of chars in member Names word i You can accomplish the same thing with text cast members using the syntax charCounter member N...

Page 440: ...lines and ranges in containers Note The count function provides a more efficient alternative for determining the number of lines in a chunk expression Examples This statement displays the number of l...

Page 441: ...o set up a custom menu bar Note Menus are not available in Shockwave Examples This statement sets the variable fileItems to the number of menu items in the custom File menu fileItems the number of men...

Page 442: ...the multimedia company The result is 4 This handler reverses the order of words in the string specified by the argument wordList on reverse wordList theList EMPTY repeat with i 1 to the number of word...

Page 443: ...r monaural or 2 for stereo This property is available only after the SWA streaming cast member begins playing or after the file has been preloaded using the preLoadBuffer command This property can be...

Page 444: ...ss of the cylinder s surface depends upon the value specified for this property The greater the property value the smoother the cylinder s surface will appear Example This statement sets the numSegmen...

Page 445: ...tion from the Score or the older rotation property of Flash assets This property is automatically set to FALSE for all movies created in Director prior to version 7 in order to preserve old functional...

Page 446: ...movie or section that you don t want to repeat if objectP gDataBase then nothing else gDataBase script Database Controller new end if See also floatP ilk integerP stringP symbolP of The word of is pa...

Page 447: ...tput end See also chars length contains starts offset rectangle function Syntax rectangle offset horizontalChange verticalChange offset rectangle horizontalChange verticalChange Description Function y...

Page 448: ...n specified by the string whichApplication Use whichDocument to specify a document that the application opens when it is launched When either is in a different folder than the current movie you must s...

Page 449: ...waiting for the movie to download For local media the movie is not loaded into memory until the open movie command is executed This can create a noticeable delay if you don t use preloadMovie to load...

Page 450: ...Stuff Transporter Xtras See also closeXlib interface showXlib optionDown Syntax the optionDown Description System property determines whether the user is pressing the Alt key Windows or the Option ke...

Page 451: ...ates in the Message window whether at least one of the expressions 1 2 and 1 2 is TRUE put 1 2 or 1 2 Because the first expression is TRUE the result is 1 which is the numerical equivalent of TRUE Thi...

Page 452: ...See also recordFont bitmapSizes characterSet originH Syntax sprite whichVectorOrFlashSprite originH the originH of sprite whichVectorOrFlashSprite member whichVectorOrFlashMember originH the originH o...

Page 453: ...erty sets the origin point around which scaling and rotation occurs as follows center default The origin point is at the center of the Flash movie topleft The origin point is at the top left of the Fl...

Page 454: ...to integers As a rule of thumb use the originH and originV properties for precision use the originPoint property for speed and convenience You can set the originPoint property only if the originMode p...

Page 455: ...riteNum originMode point sprite me spriteNum originH 100 sprite me spriteNum originV 80 end See also originH originPoint scaleMode otherwise Syntax otherwise statement s Description Keyword precedes i...

Page 456: ...overlays contained in the camera s list of overlays to be displayed When used as overlay count this property returns the total number of overlays contained in the camera s list of overlays to be displ...

Page 457: ...put member Today s News pageHeight palette Syntax member whichCastMember palette the palette of member whichCastMember Description Cast member property for bitmap cast members only determines which p...

Page 458: ...gle on the screen appears in remapped colors Example This statement tells the movie to remap the movie s palette whenever necessary set the paletteMapping TRUE paletteRef Syntax member whichCastMember...

Page 459: ...ee the Sound Control movie in the Learning Lingo Examples folder inside the Director application folder Example This Lingo pans the sound in sound channel 2 from the left channel to the right channel...

Page 460: ...set counter the paramCount parent Syntax member whichCastmember model whichModel parent member whichCastmember camera whichCamera parent member whichCastmember light whichLight parent member whichCast...

Page 461: ...the variable gParserObject will contain the parsed XML data errorCode gParserObject parseString member XMLtext See also getError XML parseURL parseURL Syntax parserObject parseURL URLstring handlerTo...

Page 462: ...ie script contains the on parseDone handler on parseDone global gParserObject if voidP gParserObject getError then put Successful parse else put Parse error put gParserObject getError end if end This...

Page 463: ...the handler would otherwise intercept the event Example This handler checks the keypresses being entered and allows them to pass through to the editable text sprite if they are valid characters on ke...

Page 464: ...specified by whichCastMember and erases the exiting cast member For example pasting a bitmap into a field cast member makes the bitmap the cast member and erases the field cast member You can paste an...

Page 465: ...me of member whichFlashMember Description Cast member property controls the location of an external file that stores the assets of a Flash movie cast member are stored You can link a Flash movie to an...

Page 466: ...and set Example In this example ThermoSystem is a model resource of the type particle This statement sets the pathStrength property of ThermoSystem to 0 97 If a path is outlined by ThermoSystem s emi...

Page 467: ...use Description 3D keyframePlayer and bonesPlayer modifier command halts the motion currently being executed by the model Use the play command to unpause the motion When a model s motion has been paus...

Page 468: ...video Syntax member whichFlashOrDigitalVideoMember pausedAtStart the pausedAtStart of member whichFlashOrDigitalVideoMember Description Cast member property controls whether the digital video or Flas...

Page 469: ...ow that the pausedAtStart property of sprite 2 and the cast member Real is set to FALSE which means that the RealMedia stream will automatically begin to play once buffering is complete put sprite 2 p...

Page 470: ...er soundSWA pause else member soundSWA play end if end See also play member stop member pause sprite Syntax sprite whichGIFSpriteNumber pause pause sprite whichGIFSpriteNumber Description Command caus...

Page 471: ...g process and then displaying the stream on the Stage as it actually begins to play For more information see the example in the pausedAtStart RealMedia entry Examples The following examples show that...

Page 472: ...streamed from an HTTP or FTP server For SWA this property differs from the percentPlayed property in that it includes the amount of the file that has been buffered but not yet played This property ca...

Page 473: ...to 100 There is no default value for this property Example This statement shows that the cast member PartyScene has finished loading put member PartyScene percentStreamed 100 period Syntax timeoutObj...

Page 474: ...eoutObject persistent Description Object property determines whether the given timeoutObject is removed from the timeoutList when the current movie stops playing If TRUE timeoutObject remains active I...

Page 475: ...ame property use the following statement member whichCastMember picture member whichCastMember picture where you replace whichCastMember with the name or number of the affected cast member Because cha...

Page 476: ...eValue The second statement checks whether Shrine is a picture by checking the value assigned to pictureValue set pictureValue to the picture of member Shrine put pictureP pictureValue The result is 1...

Page 477: ...her folder whichMovie must specify a path The play command is like the go to command except that when the current sequence finishes playing play automatically returns the playhead to the frame where p...

Page 478: ...play motionName looped startTime endTime scale offset member whichCastmember model whichModel keyframePlayer play motionName looped startTime endTime scale offset Description 3D keyframePlayer and bon...

Page 479: ...nitiated motion When the newly initiated motion ends if it is non looping or if the playNext command is issued the interrupted motion will resume playback at the point where it was interrupted Example...

Page 480: ...property list you can specify exact playback settings for a sound These properties may be optionally set To see an example of play sound used in a completed movie see the Sound Control movie in the L...

Page 481: ...possible lockStep Plays the Flash movie or GIF file frame for frame with the Director movie fixed Plays the Flash movie or GIF file at the rate specified by the fixedRate property This property can b...

Page 482: ...h movie sprite in channel 5 is playing and if it is not starts the movie on enterFrame if not sprite 5 playing then sprite 5 play end if end playing 3D Syntax member whichCastmember model whichModel k...

Page 483: ...erty to determine the actual speed of the motion s playback The playlist property can be tested but not set Use the queue play playNext and removeLast commands to manipulate it Example The following s...

Page 484: ...yntax member whichMember model whichModel bonesPlayer playNext member whichMember model whichModel keyframePlayer playNext Description 3D keyframePlayer and bonesPlayer modifier command initiates play...

Page 485: ...r playRate 3 See also play 3D queue 3D playlist currentTime 3D point Syntax point horizontal vertical Description Function and data type yields a point that has the horizontal coordinate specified by...

Page 486: ...ward direction vector points at the world relative position specified by vectorPosition then it rotates the referenced object to point it s up direction vector in the direction hinted at by the world...

Page 487: ...node pointAt vector 0 0 0 non default pointAtOrientation node transform scale scale See also pointAtOrientation pointAtOrientation Syntax member whichCastmember model whichModel pointAtOrientation mem...

Page 488: ...ointOfContact Syntax collisionData pointOfContact Description 3D collisionData property returns a vector describing the point of contact in a collision between two models The collisionData object is s...

Page 489: ...de burst nmr emitter loop 0 nmr emitter minSpeed 30 nmr emitter maxSpeed 50 nmr emitter direction vector 0 0 1 nmr colorRange start rgb 0 0 255 nmr colorRange end rgb 255 0 0 nmr lifetime 5000 nm memb...

Page 490: ...emText end See also itemDelimiter mouseLoc pointToChar pointToWord pointToItem pointToLine pointToParagraph pointToLine Syntax sprite whichSpriteNumber pointToLine pointToTranslate pointToLine sprite...

Page 491: ...put Clicked paragraph paragraphNum the text paragraphText end See also itemDelimiter mouseLoc pointToChar pointToWord pointToItem pointToLine pointToWord Syntax sprite whichSpriteNumber pointToWord po...

Page 492: ...rtcut to the getWorldTransform position version of this property for that object Examples The following statement displays the parent relative position of the model named Tire put member scene model T...

Page 493: ...ng postNetText url postText serverOSString serverCharSetString Description Command sends a POST request to url which is an HTTP URL with postText as the data This command is similar to getNetText As w...

Page 494: ...rbitrarily long whereas the getNetText query is limited to the length of a URL 1K or 4K depending on the browser Note If you use postNetText to post data to a domain different from the one the movie i...

Page 495: ...s property is used as the default for the Renderer Services object s renderer property This property differs from the getRendererServices object s renderer property in that the preferred3dRenderer spe...

Page 496: ...es into memory and stops when memory is full or when all of the specified cast members have been preloaded as follows When used without arguments the command preloads all cast members used from the cu...

Page 497: ...memory This property can be tested and set Examples This statement reports in the Message window whether the QuickTime movie Rotating Chair can be preloaded into memory put member Rotating Chair prel...

Page 498: ...hen all of the specified cast members have been preloaded The preLoadMember command returns the cast member number of the last cast member successfully loaded To obtain this value use the result funct...

Page 499: ...following statement tells Director to load the members of the cast Buttons before the movie enters frame 1 CastLib Buttons preLoadMode 1 preLoadMovie Syntax preLoadMovie whichMovie Description Command...

Page 500: ...unction does not parse a Director file s links Thus even if a Director file is linked to casts and graphic files preloadNetThing downloads only the Director file You still must preload other linked ob...

Page 501: ...elNum preLoadTime Description Cast member and sound channel property for cast members specifies the amount of the Shockwave Audio SWA streaming cast member to download in seconds before playback begin...

Page 502: ...s the transform of the model Mars to the transform of the model Pluto member scene model Pluto transform preMultiply member scene model Mars transform on prepareFrame Syntax on prepareFrame statement...

Page 503: ...isabled in an on prepareMovie handler Example This handler creates a global variable when the movie starts on prepareMovie global currentScore set currentScore 0 end See also on enterFrame on startMov...

Page 504: ...cene model bip01 rotate 20 20 20 Generally preRotate is only useful when dealing with transform variables This line will orbit the camera about the point 100 0 0 in space around the y axis by 180 t tr...

Page 505: ...Increment yIncrement zIncrement transformReference preTranslate vector member whichCastmember node transform preTranslate xIncrement yIncrement zIncrement member whichCastmember node transform preTran...

Page 506: ...s have been labeled the whole movie prints Both arguments to this function are optional The target movie is the movie or movie clip to be printed If you do not specify a target or if the target is 0 t...

Page 507: ...a projection member whichCastmember camera whichCamera projection Description 3D property allows you to get or set the projection style of the camera Possible values are perspective the default and or...

Page 508: ...manipulating other properties For example this statement sets the motionStyle property of a child object set the motionStyle of myBouncingObject to frenetic Use the count function to determine the num...

Page 509: ...tement returns the IP address string of an HTTP proxy server put proxyServer http This statement turns off an FTP proxy server proxyServer ftp stop ptToHotSpotID Syntax ptToHotSpotID whichQTVRSprite p...

Page 510: ...ting in the palette channel of the Score and assign palettes to the movie The puppetPalette command sets the current palette to the palette cast member specified by whichPalette If whichPalette evalua...

Page 511: ...ns control of the sound channel to the Score Puppet sounds can be useful for playing a sound while a different movie is being loaded into memory The Director player for Java supports the following ver...

Page 512: ...licit control is still useful if you want to retain complete control over a channel s contents even after a sprite span has finished playing Examples This statement makes the sprite in channel 15 a pu...

Page 513: ...t 27 Random rows 02 Wipe left 28 Random columns 03 Wipe down 29 Cover down 04 Wipe up 30 Cover down left 05 Center out horizontal 31 Cover down right 06 Edges in horizontal 32 Cover left 07 Center out...

Page 514: ...ty the purgePriority of member whichCastMember Description Cast member property specifies the purge priority of the cast member specified by whichCastMember Cast members purge priorities determine the...

Page 515: ...evaluates a Lingo expression converts the value to a string and inserts the resulting string after a specified chunk in a container without replacing the container s contents If chunkExpression speci...

Page 516: ...graph word of put after put into put into Syntax put expression into chunkExpression Description Command evaluates a Lingo expression converts the value to a string and uses the resulting string to re...

Page 517: ...ion level key not a system level key After the application unregisters the key only movies encrypted with this key continue to play Other media will no longer be accessible See also qtRegisterAccessKe...

Page 518: ...ion Flash cast member and sprite property controls whether Director uses anti aliasing to render a Flash movie sprite producing high quality rendering but possibly slower movie playback The quality pr...

Page 519: ...pping is higher in quality and uses more memory than bilinear mipmapping Mipmapping is not the same as filtering although both improve texture appearance Filtering spreads errors out across the textur...

Page 520: ...ayed starting at its 3 second point with a loop repeated 5 times from the 8 second point to the 8 9 second point and stopping at the 10 second point on playMusic sound 2 queue member member Chimes sou...

Page 521: ...e motion to play to the end scaleismultipliedbytheplayRatepropertyofthemodel skeyframePlayermodifierorbonesPlayer modifier to determine the actual speed of the motion s playback offset is measured in...

Page 522: ...ickTimeVersion quit Syntax quit Description Command exits from Director or a projector to the Windows desktop or Macintosh Finder Example This statement tells the computer to exit to the Windows deskt...

Page 523: ...ramNeeded Syntax ramNeeded firstFrame lastFrame Description Function determines the memory needed in bytes to display a range of frames For example youcantestthesizeofframescontaining32 bitartwork if...

Page 524: ...s random values to the variable diceRoll set diceRoll random 6 random 6 This statement randomly changes the foreground color of sprite 10 sprite 10 forecolor random 256 1 This handler randomly chooses...

Page 525: ...and set Example This statement displays the random seed number in the Message window put the randomSeed See also random ticks randomVector Syntax randomVector Description 3D command returns a unit vec...

Page 526: ...ns the previous value of the flag To be effective this flag must be set before RealPlayer is first loaded when the first RealMedia cast member is encountered in the Score or with the first Lingo refer...

Page 527: ...nd alert system using the realPlayerVersion function and custom code If this flag is set to FALSE and an alternate RealPlayer 8 detection and alert system is not in place users without RealPlayer will...

Page 528: ...ed in Lingo or appear in the Score This function should be set in a prepareMovie event handler in a movie script Use the xtraList system property to verify that the Xtra for RealMedia RealMedia Asset...

Page 529: ...more memory characterSubset String of characters to be encoded Only the specified characters will be available in the font If this argument is all characters are encoded If only certain characters are...

Page 530: ...mple This statement sets the rect of the default camera of sprite 5 to rect 0 0 200 550 sprite 5 camera rect rect 0 0 200 550 See also cameraPosition cameraRotation rect Syntax rect left top right bot...

Page 531: ...tangle put rect 60 40 120 200 80 rect 140 120 200 280 This statement divides each coordinate in a rectangle by 3 put rect 60 40 120 200 3 rect 20 13 40 66 See also point quad rect image Syntax imageOb...

Page 532: ...0 0 The Director player for Java can t set the rect member property This property can be tested It can be set for field cast members only Examples This statement displays the coordinates of bitmap ca...

Page 533: ...ourceRect ref Syntax chunkExpression ref Description Text chunk expression property this provides a convenient way to refer to a chunk expression within a text cast member Examples Without references...

Page 534: ...FunctionList 3 blend shader blendSourceList 3 constant shader blendConstantList 3 50 0 When tested this property returns the texture associated with the model s third texture layer The default is void...

Page 535: ...efault value for this property is vector 0 0 0 Example In this example ThermoSystem is a model resource of the type particle This statement specifies the four corners of a rectangle from which the par...

Page 536: ...he begin parameter have elapsed after registerForEvent is called The period parameter determines the number of milliseconds between timeMS events when the value of repetitions is greater then 0 If rep...

Page 537: ...roup registerScript eventName handlerName scriptObject begin period repetitions Description 3D command registers the specified handler to be called when the specified event occurs for the referenced n...

Page 538: ...repetitions is 0 the timeMS event occurs indefinitely The handler you specify is sent the following arguments type is always 0 delta is the elapsed time in milliseconds since the last timeMS event tim...

Page 539: ...et to FALSE This property can be tested and set Examples This statement displays the registration point of the bitmap cast member Desk in the Message window put member Desk regPoint This statement cha...

Page 540: ...relative See pathname removeBackdrop Syntax member whichCastmember camera whichCamera removeBackdrop index Description 3D command removes the backdrop found in the position specified by index from th...

Page 541: ...playlist Example This statement removes the last motion from the playlist of the bonesPlayer modifier for the model named Walker member MyWorld model Walker bonesPlayer removelast removeModifier Synta...

Page 542: ...ext menu in Shockwave If the user selects the Obey content settings option the renderer specifiedbytherenderer orpreferred3DRendererpropertiesisusedtodrawthemovie ifavailable on the users system other...

Page 543: ...Format Syntax member whichCastmember texture whichTexture renderFormat member whichCastmember texture index renderFormat member whichCastmember shader whichShader texture renderFormat member whichCast...

Page 544: ...to get or set the renderStyle for a shader as determined by the geometry of the underlying model resource This property has the following values fill specifies that the shader is drawn to completely f...

Page 545: ...d countTime See also exit exit repeat repeat with keyPressed repeat with Syntax repeat with counter start to finish statement s end repeat Description Keyword executes the Lingo specified by statement...

Page 546: ...erefore repeat loops are best used for short fast operations or when you know the user won t be doing other things While in a repeat loop Lingo ignores other events To check the current key in a repea...

Page 547: ...n t detect mouse movements update properties that indicate the mouse s position or update the status of mouse button presses when Lingo is in a repeat loop Example This statement displays four values...

Page 548: ...e when the window that the movie is playing in is resized on resizeWindow centerPlace sprite 3 loc centerPlace end See also drawRect sourceRect resolution Syntax member whichCastmember modelResource w...

Page 549: ...ee also collisionData collisionNormal modelA modelB pointOfContact resolveA Syntax collisionData resolveA bResolve Description 3D collision method overrides the collision behavior set by the collision...

Page 550: ...e resolution 20 restart Syntax restart Description Command closes all open applications and restarts the computer Example This statement restarts the computer when the user presses Command R Macintosh...

Page 551: ...frame after the current frame if it s been paused This command has no effect if the animated GIF sprite has not been paused See also pause sprite rewind sprite RETURN constant Syntax RETURN Descriptio...

Page 552: ...ives you a way to pass back a reference to an object that was created so it can be assigned to a variable name The return keyword isn t the same as the character constant RETURN which indicates a carr...

Page 553: ...Scene to the values stored when the member was first created member Scene revertToWorldDefaults See also resetWorld rewind Syntax sound channelNum rewind rewind sound channelNum Description Function...

Page 554: ...s a color based on a the value specified for red green and blue The range for each of the threee color values is 0 255 Example This Lingo displays the color of sprite 6 in the Message window and then...

Page 555: ...her the right of the box is sealed TRUE or open FALSE The default value is TRUE Example This statement sets the right property of the model resource Crate to TRUE meaning the right side of this box wi...

Page 556: ...ing pressed TRUE or not FALSE OntheMacintosh rightMouseDownisTRUEonlyiftheemulateMultiButtonMousepropertyisTRUE Example This statement checks whether the right mouse button in Windows is being pressed...

Page 557: ...ude parentheses The rollOver function is typically used in frame scripts and is useful for creating handlers that perform an action when the user places the pointer over a specific sprite It can also...

Page 558: ...uses a single byte character set Normally romanLingo is set when Director is first started and is determined by the local version of the system software If you are using a non Roman script system but...

Page 559: ...positional rotational and scale offsets held by the node s transform object or the directly referenced transform object The rotation must be specified as a set of three angles each of which specify an...

Page 560: ...Member rotation sprite whichSprite rotation the rotation of sprite whichSprite Description Cast member property and sprite property controls the rotation of a QuickTime movie animated GIF Flash movie...

Page 561: ...layhead continues to the next frame on exitFrame if sprite 5 rotation 360 then sprite 5 rotation sprite 5 rotation 16 go the frame end if end This handler accepts a sprite reference as a parameter and...

Page 562: ...ject Setting the rotation of a node s transform defines that object s rotation within the transform s frame of reference Setting the rotation property of an object s world relative transform using get...

Page 563: ...aintains rotation around its z axis when the currently playing motion or loop ends member NewAlien model Monster bonesPlayer rotationReset z See also positionReset bonesPlayer modifier RTF Syntax memb...

Page 564: ...the behavior is attached to a sprite or when the user changes the initial property values of a sprite s behavior The current settings for a behavior s initial properties are passed to the handler as a...

Page 565: ...orcloseResFilecommand is disabled Saving a movie or cast by using Lingo is disabled Printing by using the printFrom command is disabled Opening an application by using the open command is disabled The...

Page 566: ...44100 When multiple sounds are queued in a sound channel Director plays them all with the channelCount sampleRate and sampleSize of the first sound queued resampling the rest for smooth playback Direc...

Page 567: ...me newFileName is included in a new file If no filename is given the original cast must be linked Further operations or references to the cast use the saved cast member This command does not work with...

Page 568: ...ale the sprite s bounding rectangle or the sprite s controller Instead it scales the image around the image s center point within the bounding rectangle The scaling is specified as a Director list con...

Page 569: ...ie s scale to 0 so it disappears and then scales it up again in 5 increments until it is full size 100 again on scaleMovie whichSprite sprite whichSprite scale 0 updatestage repeat with i 1 to 20 spri...

Page 570: ...scale command adjusts the referenced node s transform scale property but it does not have any visual effect on lights or cameras as they do not contain geometry The scaling values provided must be gre...

Page 571: ...his statement sets the scale property of the transform of the model named Moon to vector 2 5 3 member Scene model Moon transform scale vector 2 5 3 See also transform property getWorldTransform positi...

Page 572: ...ript checks the Stage color of the Director movie and if the Stage color is indexed to position 0 in the current palette the script sets the scaleMode property of a Flash movie sprite to showAll Other...

Page 573: ...ar list of linear lists Each contiguous selection is in a list format consisting of the starting channel number ending channel number starting frame number and ending frame number Specify sprite chann...

Page 574: ...irector application folder Examples This statement makes goHandler the handler that is executed when the user chooses the Go command from the custom menu Control set the script of menuItem Go of menu...

Page 575: ...tList It may not be set during a score recording session Example This statement displays the list of scripts attached to sprite 1 in the Message window put sprite 1 scriptList member2ofcastLib1 myRota...

Page 576: ...scriptText the scriptText of member whichCastMember Description Cast member property indicates the content of the script if any assigned to the cast member specified by whichCastMember The text of a...

Page 577: ...tive the field scrolls down When amount is negative the field scrolls up Examples This statement scrolls the field cast member Today s News down five lines member Today s News scrollbyline 5 This stat...

Page 578: ...ield This is a way to make custom scrolling behaviors for text and field members For example the following Lingo moves the field cast member Credits up or down within a field s box depending on the va...

Page 579: ...ifier to a model resource you can get or set the following properties enabled indicates whether subdivision surfaces functionality is enabled TRUE ordisabled FALSE The default setting for this propert...

Page 580: ...rchCurrentFolder TRUE See also searchPaths searchPath This is obsolete Use searchPaths searchPaths Syntax the searchPaths Description System property a list of paths that Director searches when trying...

Page 581: ...ent is the same except that trailing colons have been omitted set the searchPaths hard drive director projects cdrom sources These statements cause Director to search in a folder named Sounds which is...

Page 582: ...ing the stream rebuffers and automatically begins playing at the new location in the stream If seek is called when mediaStatus is closed nothing happens If you attempt to seek beyond the stream s dura...

Page 583: ...tion to select a string of characters Example This statement checks whether any characters are selected and if none are displays the alert Please select a word if the selection EMPTY then alert Please...

Page 584: ...o that characters 6 through 10 are highlighted member myAnswer selection 6 10 See also color selStart selEnd selEnd Syntax the selEnd Description Global property specifies the last character of a sele...

Page 585: ...prite that was involved in the event As with any other message the message is sent to every script attached to the sprite unless the stopEvent command is used For best results send the message only to...

Page 586: ...called when the jump event is sent The fourth line sends the jump event The handlers jumpMars in a moviescript and jumpPluto arecalled along withanyotherhandlers registered for the jump event Note tha...

Page 587: ...global Flash XML object created in Lingo When this happens the Lingo on sendXML handler is called and the same parameters are passed to the handler The following Lingo illustrates how the parameters...

Page 588: ...ing member User Info text displayString end See also organizationName userName window set to set Syntax set the lingoProperty to expression the lingoProperty expression set variable to expression vari...

Page 589: ...ing the alpha layer from an image member Foreground image setAlpha 255 member Foreground image useAlpha FALSE This Lingo gets the alpha layer from the cast member Sunrise and places it into the alpha...

Page 590: ...pecified by value in the list specified by list When orderNumber is greater than the number of items in a property list the setAt command returns a script error When orderNumber is greater than the nu...

Page 591: ...al Flash commands to work correctly You add Xtra extensions to the Xtra list by choosing Modify Movie Xtras For more information see Managing Xtra extensions for distributed movies in Using Director E...

Page 592: ...when the model named Sphere collides with another model member 3d world model Sphere collision setCollisionCallback bounce member colScript See also collisionData collision modifier resolve resolveA r...

Page 593: ...SetPixel function returns FALSE if the specified pixel falls outside the specified image To see an example of setPixel used in a completed movie see the Imaging movie in the Learning Lingo Examples f...

Page 594: ...for the file name After the setPref command runs if the movie is playing in a browser a folder named Prefs is created in the Plug In Support folder The setPref command can write only to that folder I...

Page 595: ...ield cast member Text Entry in a file named DayWare settings on mouseUp me setPref CurPrefs member Text Entry text end See also getPref setProp Syntax setProp list property newValue list listProperty...

Page 596: ...opened by right clicking Windows or Control clicking Macintosh on a Flash movie playing in a browser The integerPanelIndex can have a value of 0 1 2 or 3 indicating which panel to activate when the d...

Page 597: ...acks this means they will no longer be updated on the screen To test whether a track is already enabled test the trackEnabled sprite property Example This statement enables track 3 of the digital vide...

Page 598: ...ing used by a model is deleted Thesyntaxmember whichCastmember model whichModel shadergivesaccesstothefirstshaderin the model s shaderlist and is equivalent to member whichCastmember model whichModel...

Page 599: ...t with this syntax member whichCastmember model whichModel shaderList index whichProperty propValue Set a property of all of the shaders of a model to the same value with this syntax note the absence...

Page 600: ...whichShader shadowStrength Description 3D toon modifier and painter shader property indicates the brightness of the area of the model s surface where light does not create highlights The default valu...

Page 601: ...key See also commandDown controlDown key optionDown shininess Syntax member whichCastmember shader whichShader shininess member whichCastmember model whichModel shader shininess member whichCastmember...

Page 602: ...window This command is useful only within handlers or parent scripts that contain local variables to display All variables used in the Message window are automatically global Local variables in a han...

Page 603: ...RETURN member i whichCast showProps end if end repeat end See also queue setPlaylist showResFile Description This Lingo is obsolete showXlib Syntax showXlib Xlibfilename Description Command shows all...

Page 604: ...el Silhouette lines are drawn around the model s 2D image on the camera s projection plane Their relationship to the model s mesh is not fixed unlike crease or boundary lines which are drawn on featur...

Page 605: ...tart and sizeRange end over the lifetime of each particle This property must be an integer greater than 0 and has a default value of 1 Example In this example mrFount is a model resource of the type p...

Page 606: ...t an integer controlling the number of segments used to create a 3D text cast member The higher the number the smoother the text appears The range of this property is 1 to 10 and the default value is...

Page 607: ...r inside the Director application folder Example This handler accepts a member reference and toggles the member s sound property on or off on ToggleSound whichMember member whichMember sound not membe...

Page 608: ...ells the SWA streaming cast member Frank Zappa to play in sound channel 3 member Frank Zappa soundChannel 3 soundChannel RealMedia Syntax sprite whichSprite soundChannel member whichCastmember soundCh...

Page 609: ...und close This is obsolete Use puppetSound instead soundDevice Syntax the soundDevice Description System property allows the sound mixing device to be set while the movie plays The possible settings a...

Page 610: ...mines whether the sound is on TRUE default or off FALSE When you set this property to FALSE the sound is turned off but the volume setting is not changed This property can be tested and set Example Th...

Page 611: ...5000 See also sound fadeOut fadeTo sound fadeOut Syntax sound whichChannel fadeOut sound whichChannel fadeOut milliseconds sound fadeOut whichChannel sound fadeOut whichChannel ticks Description Comma...

Page 612: ...the sound has finished Setting this property to FALSE may adversely affect performance if sound playback is used frequently throughout the Director application This property can be tested and set Exam...

Page 613: ...cast members It is possible that slight differences may occur in the way Flash sounds play back To hear the Flash sounds exactly they would be rendered in Flash set this property to FALSE sound playF...

Page 614: ...und 1 stop This statement checks whether a sound is playing in sound channel 1 and if it is stops the sound if soundBusy 1 then sound 1 stop See also puppetSound soundBusy source Syntax sprite whichSp...

Page 615: ...window whichWindow Description Window property specifies the original Stage coordinates of the movie playing in the window specified by whichWindow This property is useful for returning a window to i...

Page 616: ...cular FALSE See also silhouettes specularLightMap specular shader Syntax member whichCastmember shader whichShader specular Description 3D standard shader property allows you get or set the specular c...

Page 617: ...tMap Syntax member whichCastmember shader whichShader specularLightMap member whichCastmember model whichModel shader specularLightMap member whichCastmember model whichModel shaderList shaderListInde...

Page 618: ...t s intensity falls off with the distance from the camera The default value for this property is FALSE Example The following statement sets the spotDecay property of light 1 to TRUE Models that are fa...

Page 619: ...d cast member Notice to You placed it correctly if sprite i intersects j then put You placed it correctly into member Notice See also sprite within quad sprite within Syntax sprite sprite1 within spri...

Page 620: ...ler uses the automatic value inserted into the spriteNum property to assign the sprite reference to a new property variable pMySpriteRef as a convenience property spriteNum pMySpriteRef on beginSprite...

Page 621: ...ion plane of the camera of sprite 5 put sprite 5 camera spriteSpaceToWorldSpace point 50 50 vector 1993 6699 52 0773 2263 7446 See also worldSpaceToSpriteSpace rect camera camera sqrt Syntax sqrt numb...

Page 622: ...nce of 50 pixels from the bottom edge of the Stage stageHeight the stageBottom the stageTop sprite 3 locV stageHeight 50 Sprite coordinates are expressed relative to the upper left corner of the Stage...

Page 623: ...ty is 0 which is the location of the left side of the applet This property can be tested but not set Sprite coordinates are expressed relative to the upper left corner of the Stage Example This statem...

Page 624: ...coordinates it is used only for rotation and scaling The stageToFlash function and the corresponding flashToStage function are helpful for determining which Flash movie coordinate is directly over a D...

Page 625: ...as a floating point value from 0 0 to 360 0 The default value for this property is 0 0 The startAngle property determines the starting sweep angle of the model resource and works in conjunction with...

Page 626: ...rFrame event An on startMovie handler is a good place to put Lingo that initializes sprites in the first frame of the movie Example This handler makes sprites invisible when the movie starts on startM...

Page 627: ...playback For sound channels this property indicates the start time of the currently playing or paused sound as set when the sound was queued It cannot be set after the sound has been queued If no valu...

Page 628: ...upon creation of the model file will be loaded at this time because they are part of the initial load segment You can perform most 3D Lingo associated with objects that have a load priority of zero D...

Page 629: ...treaming has stopped 1 The cast member is reloading 2 Preloading ended successfully 3 The cast member is playing 4 The cast member is paused 5 The cast member has finished streaming 9 An error occurre...

Page 630: ...Media cast member For each state there is one or more corresponding mediaStatus property value each mediaStatus value is observed only in one state For example the mediaStatus property values seeking...

Page 631: ...ing for the mediaStatus property 4 playing indicates that the RealMedia stream is playing or paused without problems or errors Thisisthestateduringnormal playback Thisstateistheequivalent of playing o...

Page 632: ...age is static Possible values are minQuality maxQuality and normalQuality This property can be tested and set status Syntax soundObject status the status of soundObject Description Read only property...

Page 633: ...epareFrame message Assign objects to actorList so they respond to stepFrame messages Objects must have an on stepFrame handler to use this built in functionality with actorList The go play and updateS...

Page 634: ...on enterFrame repeat with i 5 to 10 sprite i stop end repeat end See also hold stop RealMedia Syntax sprite whichSprite stop member whichCastmember stop Description RealMedia sprite or cast member met...

Page 635: ...also applies to sprite scripts Use the stopEvent command to stop the message in a primary event handler or a sprite script thus making the message unavailable for subsequent sprite scripts By default...

Page 636: ...Movie Syntax on stopMovie statement s end Description System message and event handler contains statements that run when the movie stops playing An on stopMovie handler is a good place to put Lingo th...

Page 637: ...umber of bytes to stream as an integer value If you omit the numberOfBytes parameter Director tries to stream the number of bytes set by the cast member s bufferSize property The stream command return...

Page 638: ...f end streaming Syntax member whichMember streaming the streaming of member whichMember Description QuickTime cast member property When TRUE allows QuickTime playing over the Internet to begin playing...

Page 639: ...n be tested and set Example This startMovie script searches the internal cast for Flash movie cast members and sets their streamMode properties to manual on startMovie repeat with i 1 to the number of...

Page 640: ...of bytes for the cast member using the streamSize member property The script keeps the playhead looping in the current frame until the movie finishes loading into memory on exitFrame if member Intro...

Page 641: ...external cast member from a URL A streamStatus handler will be called with information about all network streams Place the streamStatus handler in a movie script Example This handler determines the s...

Page 642: ...a string TRUE or not FALSE The P in stringP stands for predicate Examples This statement checks whether 3 is a string put stringP 3 The result is 1 which is the numeric equivalent of TRUE This statem...

Page 643: ...dth 10 style Syntax member whichCastmember model whichModel toon style member whichCastmember model whichModel shader style member whichCastmember shader whichShader style Description 3D toon modifier...

Page 644: ...odifier entry for more information Example The following statement sets the subdivision property of the sds modifier of the model named Baby to adaptive Baby s geometry will not be modified uniformly...

Page 645: ...rite containing a VR Pano around to the new view settings The swing is a smooth camera dolly effect whichQTVRSprite Sprite number of the sprite with the QuickTime VR member pan New pan position in deg...

Page 646: ...or s color depth is higher than that of the movie reducing the monitor s color depth plays the movie using the minimum amount of memory loads cast members more efficiently and causes animation to occu...

Page 647: ...systemDate Syntax the systemDate Description System property returns the current date in a standard date format and can be used in conjunction with other date operations for international and cross p...

Page 648: ...property indicates how many unique tab stops are in the specified chunk expression of the text cast member The value is an integer equal to or greater than 0 and may be tested but not set tabs Syntax...

Page 649: ...cannot be used in a Lingo expression See also PI target Syntax timeoutObject target Description Timeout object property indicates the child object that the given timeoutObject will send its timeout e...

Page 650: ...indow specified by whichWindow The tell command is useful for allowing movies to interact It can be used within a main movie to send a message to a movie playing in a window or to send a message from...

Page 651: ...ge to go frame Main Menu When you use the tell command to call a handler in another movie make sure that you do not have a handler by the same name in the same script in the local movie If you do the...

Page 652: ...ntaining a loaded Flash movie certain commands act on the targeted components rather than on the main Timeline To switch focus back to the main Timeline call endTellTarget The only valid argument for...

Page 653: ...mber whichCastMember text the text of member whichCastMember Description Text cast member property determines the character string in the field cast member specified by whichCastMember The text cast m...

Page 654: ...t layers of textures These eight texture layers are either created from bitmap cast members or image objects within Director or imported with models from 3D modeling programs Create and delete texture...

Page 655: ...change the mapping between textureCoordinates and the corners of a mesh face Example put member 5 2 modelResource mesh square textureCoordinateList 0 1 0 1 0 2 0 1 0 3 0 1 0 1 0 2 0 2 0 2 0 3 0 2 0 1...

Page 656: ...ayer a texturecoordinatelist model meshdeform texturelayer b texturecoordinatelist See also meshDeform modifier mesh property textureCoordinateList add 3D texture count texture textureModeList texture...

Page 657: ...member shader whichShader textureMode member whichCastmember model whichModel shader textureMode member whichCastmember model whichModel shaderList index textureMode Description 3D standard shader pro...

Page 658: ...exture coordinates are generated in model space With an identity wrapTransform List textureLayerIndex the default the cylindrical mapping is oriented such that the texture is wrapped from the Y axis s...

Page 659: ...t formats i e 32 bit variants such as rgba8888 generally look better In order to use alpha transparency in a texture the last bit must be nonzero In order to get smooth transparency gradations the alp...

Page 660: ...and the value of the x and or y components of shaderReference textureTransform scaleislessthan1 thetextureistiled repeated acrossthe surface of the model When textureRepeat is set to FALSE the texture...

Page 661: ...surfaces rather than tile across those surfaces when the shaderReference textureTransform textureLayerIndex scale is less than 1 in x or y Think of it as shrinking the source image within the frame o...

Page 662: ...ween 0 0 and 1 0 in that case To apply a rotation to a texture layer use shaderReference texture Transform rotate 0 0 angle Rotations around the Z axis are rotated around the 0 0 2d image point which...

Page 663: ...o avoid 0 0 scales even in Z as that will negate the effect of the entire texture To offset the image by point xOffset yOffset use textureTransformList whichTextureLayer translate xOffset yOffset 0 0...

Page 664: ...assuming that textureList 3 is a 128x128 sized texture s member scene shader gbCyl3 s textureTransformList 3 translate 64 64 0 s textureTransformList 3 rotate 0 0 90 s textureTransformList 3 translat...

Page 665: ...member in the Cast window This image can be customized for any cast member This property can be tested and set only during authoring Example The following statement shows how to use a placeholder cast...

Page 666: ...United States theshort and abbreviated formats are the same Example The following statements display the time in different formats in the Message window Possible results appear below each statement p...

Page 667: ...eout name new to add a new timeout object to the timeoutList See new Example This handler deletes the timeout object named Random Lightning on exitFrame timeout Random Lightning forget end See also fo...

Page 668: ...timeoutKeyDown Syntax the timeoutKeyDown Description System property determines whether keyDown events set the timeoutLapsed property to 0 TRUE default or not FALSE This property is useful for restart...

Page 669: ...s or 3 minutes Example This statement sets timeoutLength to 10 seconds set the timeoutLength to 10 60 or the timeoutLength 10 60 timeoutList Syntax the timeoutList Description System property a linear...

Page 670: ...be tested and set Example ThisstatementsetstimeoutPlaytoTRUE whichtellsLingotoresetthetimeoutLapsedpropertyto0 after a movie is played set the timeoutPlay to TRUE or the timeoutPlay TRUE timeoutScrip...

Page 671: ...elay on beginSprite startTimer end on exitFrame if the timer 60 2 then go the frame end This statement sets the variable startTicks to the current timer value startTicks the timer See also lastClick l...

Page 672: ...eat with set to set toon modifier Syntax member whichCastmember model whichModel toon toonModifierProperty Description 3D modifier once you have added the toon modifier to a model you can get and set...

Page 673: ...to 100 The default is 50 highlightStrength allows you to get or set the level of brightness applied to the highlighted portion of the model s surface Possible values are any non negative floating poin...

Page 674: ...x modelResourceObjectReference top Description 3D command when used with a model resource whose type is box allows you to both get and set the top property of the model resource The top property deter...

Page 675: ...value greater than 0 models using Tube will be conical member 3D World modelResource Tube topRadius 0 0 topSpacing Syntax chunkExpression topSpacing Description Text cast member property allows you t...

Page 676: ...e This statement causes the movie to display the names of cast members as they are loaded the traceLoad 1 traceLogFile Syntax the traceLogFile Description System property specifies the name of the fil...

Page 677: ...s in the specified digital video sprite This property can be tested but not set Example This statement determines the number of tracks in the digital video sprite assigned to channel 10 and displays t...

Page 678: ...sprite property indicates the time of the next sample that follows the digital video s current time This property is useful for locating text tracks in a digital video This property can be tested but...

Page 679: ...ck Description Digital video cast member property returns the start time of the specified track of the specified digital video cast member This property can be tested but not set Example This statemen...

Page 680: ...property returns the stop time of the specified track of the specified digital video sprite When a digital video movie is played trackStopTime is when playback halts or loops if the loop property is...

Page 681: ...on checkForText if member Today s News trackType 5 text then textFormat end trackType sprite property Syntax sprite whichDigitalVideoSprite trackType whichTrack trackType sprite whichSprite whichTrac...

Page 682: ...a Examples This statement creates an identity transform and stores it in the variable tTransform tTransform transform This statement creates an identity transform by specifying all 16 of its elements...

Page 683: ...transform of a bone represents the bone s rotation relative to its parent bone and its position relative to its original joint position The original joint position is determine upon creation of the mo...

Page 684: ...transform position vector 94 1448 119 0128 0 0000 put member 3d world model box transform rotation vector 0 0000 0 0000 0 0000 See also interpolateTo scale transform rotation transform position transf...

Page 685: ...elative to the node s parent s coordinate system This value is used as the default if you use the translate command with a transform reference and the relativeTo parameter is not specified world appli...

Page 686: ...ty is set to FALSE the translation property is ignored and the sprite is always positioned at the upper left corner of the sprite s rectangle This property can be tested and set Example The following...

Page 687: ...r returns determines how the movie processes the hotspot If the handler returns continue the QuickTime VR sprite continues to process the hotspot normally If the handler returns cancel the default beh...

Page 688: ...he result in a new image object Example This statement trims the white space from member Flower and returns the new trimmed image object in the variable trimmedImage trimmedImage member flower image t...

Page 689: ...ill be extremely deep member scene model Slogan resource tunnelDepth 1000 See also extrude3D tweened Syntax sprite whichSprite tweened the tweened of sprite whichSprite Description Sprite property det...

Page 690: ...ib type member whichCastMember of castLib whichCast type the type of member whichCastMember of castLib whichCast Description Cast member property indicates the specified cast member s type This proper...

Page 691: ...this type cast their light evenly on all surfaces The intensity of ambient lights is not affected by distance from the light source directional lights appear to shine in a particular direction but are...

Page 692: ...and sphere indicates that this model resource is a primitive sphere resource created using the newModelResource command fromFile indicates that this model resource was created external to Director and...

Page 693: ...er shader newsprint indicates that this is a newsprint shader engraver indicates that this is an engraver shader Examples This statement shows that the shader used by the model named box2 is a painter...

Page 694: ...mage property using the newTexture command fromImageObject indicates that this is texture was created from an image object using the newTexture command importedFromFile indicates that this texture was...

Page 695: ...the least recently used cast members to accommodate preLoad commands or normal cast loading When used without an argument the unLoad command clears from memory the cast members in all the frames of a...

Page 696: ...ber name or number that you specify When used with the arguments firstCastMember and lastCastMember the unLoadMember command unloads all cast members in the range specified When used in a new movie wi...

Page 697: ...the registerForEvent command will no longer be triggered when those events occur Example This statement unregisters the cast member named Scene for all event notifications member Scene unregisterAllEv...

Page 698: ...e recording FALSE or not TRUE You can keep the Stage display constant during a Score recording session by setting updateLock to TRUE before Lingo updates the Score If updateLock is FALSE the Stage upd...

Page 699: ...he sprite appears in the new location without having to wait for the playhead to move on moveRight whichSprite howFar sprite whichSprite locH sprite whichSprite locH howFar updateStage end moveRight U...

Page 700: ...data is handled exactly as by getNetText converted from the named character set to Shift JIS If you use AUTO the posted data from the local character set is not translated the results sent back by the...

Page 701: ...s a texture list which contains up to eight textures The diffuseColor property of the cast member Level2 is set to rgb 255 0 0 The blendFunction property of all six shaders is set to blend and the ble...

Page 702: ...e This behavior toggles the formatting of hypertext on and off in text cast member myText on mouseUp member myText usehypertextStyles not member myText usehypertextStyles end useLineOffset Syntax memb...

Page 703: ...Prop and deleteProp commands documented in the main Lingo Dictionary Examples This statement displays the userData property of the model named New Body put member Car model New Body userData driver Bo...

Page 704: ...e following examples show that the user name for the RealMedia stream in the cast member Real or sprite 2 has never been set put sprite 2 userName put member Real userName The following examples set t...

Page 705: ...o text fields by end users string expressions passed to Lingo by Xtra extensions or any other expression you need to convert from a string to a Lingo value Keep in mind that there may be some situatio...

Page 706: ...and orientation This function returns a vector object Vector values can be operated upon by the and operators See their individual definitions for more information Examples This statement creates a v...

Page 707: ...f the location is 0 0 Each vertex can have two control handles that determine the curve between this vertex and the adjacent vertices In vertexList the coordinates of the control handles for a vertex...

Page 708: ...f any size for this property but it will store only the number of items specified when using the newMesh command to create the mesh model resource Example This statement sets the vertexList of the mod...

Page 709: ...achieve an outward pointing surface normal If you make changes to this property or use the generateNormals command you will need to call the build command in order to rebuild the mesh Example This ex...

Page 710: ...n and off during playback Examples The following examples show that the video property for sprite 2 and the cast member Real is set to TRUE put sprite 2 video 1 put member Real video 1 The following e...

Page 711: ...w entirely This property can be tested and set Note This property must be set to the default value if the scaleMode property is set to autoSize or the sprite will not display correctly Example This ha...

Page 712: ...sion use the originPoint property for speed and convenience This property can be tested and set The default value is point 0 0 Note This property must be set to the default value if the scaleMode prop...

Page 713: ...ber and sprite property controls the vertical coordinate of a Flash movie and vector shape s view point specified in pixel units The values can be floating point numbers The default value is 0 A Flash...

Page 714: ...will not automatically reset to TRUE when the sprite ends You must set the visible property of the sprite to TRUE in order to see any other members using that channel Example This statement makes spri...

Page 715: ...an integer This number of voices can be used with voiceSet and voiceGet to specify a particular voice to be active Example This statement sets the variable numVoices to the number of available text to...

Page 716: ...is a string Possible values include Teen Adult Toddler and Senior as well as numeric values such as 35 Actual values depend on the operating system speech software version and voices installed gender...

Page 717: ...unction returns the current playback rate of the text to speech engine The return value is an integer The valid range of values depends on the text to speech software and operating system platform In...

Page 718: ...puter s text to speech engine and then test for whether the text to speech engine has completed loading before using the voiceSpeak command to speak the phrase Welcome to Shockwave err voiceInitialize...

Page 719: ...fied must be an integer The valid range of values depends on the number of voices installed on the user s computer If an out of range value is specified the voice is set to the nearest valid value If...

Page 720: ...st valid value Example This statement sets the playback rate of the text to speech engine to 7 voiceSetRate 7 See also voiceSpeak voicePause voiceResume voiceStop voiceGetRate voiceGetPitch voiceSetPi...

Page 721: ...WordPos voiceState Syntax voiceState Description Function returns the current status of the voice as a symbol The possible return values are playing paused and stopped Example These statements check w...

Page 722: ...st member is being spoken when the function is used the return value is 5 Example The following statements cause the sentence Hello how are you to be spoken and display the current word position in th...

Page 723: ...member to half the possible volume member SWAfile volume 128 volume sound channel Syntax sound whichChannel volume the volume of sound channelNum Description System property determines the volume of...

Page 724: ...lues of 0 or less mute the sound Values exceeding 256 are loud and introduce considerable distortion Example This statement sets the volume of the QuickTime movie playing in sprite channel 7 to 256 wh...

Page 725: ...ment assigns the width of member 50 to the variable height height member 50 width This statement sets the width of sprite 10 to 26 pixels sprite 10 width 26 This statement assigns the width of sprite...

Page 726: ...wind modelResourceObjectReference wind Description 3D property allows you to get or set the wind property of a model resource whose type is particle as a vector This wind property defines the directi...

Page 727: ...windowList the windowList See also windowPresent windowPresent Syntax windowPresent windowName Description Function indicates whether the object specified by windowName is running as a movie in a wind...

Page 728: ...49 specifies a stationary window You can set this property before opening the window Numbers 6 7 9 10 11 13 14 15 and 17 through 48 have no effect when used as the windowType value You can change the...

Page 729: ...nd text cast members and variables that hold strings To see an example of word of used in a completed movie see the Text movie in the Learning Lingo Examples folder inside the Director application fol...

Page 730: ...es is the vector 1333 2097 0 0000 211 0973 put member scene model Mars worldPosition vector 1333 2097 0 0000 211 0973 See also getWorldTransform position transform worldSpaceToSpriteSpace Syntax membe...

Page 731: ...mber whichCastmember model modelName shader wrapTransform member whichCastmember model shaderlist shaderListIndex wrapTransform Description 3D standard shader property this property provides access to...

Page 732: ...only the orientation of how the shader applies the texture Note wrapTransformList textureLayerIndex only has an effect when textureModeList textureLayerIndex is set to planar spherical or cylindrical...

Page 733: ...is now the vector 0 0000 0 0000 1 0000 This means that the x axis of ModCylinder now is aligned with the negative z axis of the world member Engine model ModCylinder transform identity put member Engi...

Page 734: ...their information listOfXtras the xtraList Initialize the local variable to contain the version theVersion Iterate through all the Xtra extensions listed repeat with currentXtra in listOfXtras If the...

Page 735: ...odCylinder to the identity transform The next two lines show that the Y axis of ModCylinder is the vector 0 0000 1 0000 0 0000 This means that the y axis of ModCylinder is aligned with the y axis of t...

Page 736: ...ts the yon property of camera 1 to 50000 member 3d world camera 1 yon 50000 See also hither z vector property Syntax member whichCastmember vector z member whichCastmember vector 3 Description 3D prop...

Page 737: ...e the expanding windows in the Macintosh Finder The zoom effect starts at the bounding rectangle of startSprite and finishes at the bounding rectangle of endSprite The zoomBox command uses the followi...

Page 738: ...sprite 3 to the coordinates stored in the variable centerPlace when the window that the movie is playing in is resized on zoomWindow centerPlace point 10 10 sprite 3 loc centerPlace end See also drawR...

Page 739: ...es 613 alert command 66 alertHook event handler 215 alignment of member field property 67 allowZooming movie property 70 Alt key Windows 450 ampersand operators or 45 46 ancestor sending messages to 1...

Page 740: ...mbers 238 438 castLibNum of member 121 changing cast member names 413 changing cast members used for cursors 170 copying 158 204 367 475 creating 423 cursor command 170 deleting 218 determining if loa...

Page 741: ...acter constant 210 ending character in selections 584 expressions as 642 field keyword 231 highlighting 289 in field cast members 653 integer function 317 item of keyword 324 last function 335 length...

Page 742: ...OTE 522 RETURN 551 SPACE 615 TAB 648 TRUE 688 VOID 722 continuation symbol 54 Control key Macintosh 154 Control key Windows 150 154 converting ASCII codes to characters 444 characters to ASCII codes 1...

Page 743: ...ale for 191 turning play of on or off 709 714 digital video sprite properties trackNextKeyTime 678 trackNextSampleTime 678 trackPreviousKeyTime 678 trackPreviousSampleTime 679 trackText 680 trackType...

Page 744: ...in 244 logical negation of 436 F fading in sound 610 fading out sound 611 FALSE logical constant 230 field cast member properties autoTab of member 82 border of member 104 boxDropShadow of member 107...

Page 745: ...function 291 inserting 315 labels assigned to 251 listing frame labels 334 marker function 362 marker labels and 334 markers before and after 362 memory needed to display 523 number of palette in 252...

Page 746: ...sh 450 RETURN character constant 551 Shift key 601 Tab key 648 L labels 251 334 launching applications 448 less than operator 50 less than or equal to operator 50 level of detail LOD modifier 35 modif...

Page 747: ...w display 676 logarithm functions 223 353 logical constants FALSE 230 TRUE 688 logical expressions 72 logical negation of expressions 436 long time format 666 loops loop keyword 354 next repeat keywor...

Page 748: ...motion 389 playback 478 timing 169 mouse clicks assigning scripts for 392 401 clickLoc function 135 clickOn function 136 determining if mouse button is pressed 392 398 doubleClick function 199 emulate...

Page 749: ...files on 268 new line symbol 54 newsprint shader Lingo for 40 nodes deleting 182 managing with Lingo 37 parent child Lingo for 33 normals 259 375 434 list of 435 not equal operator 50 not logical oper...

Page 750: ...sprites 168 plus sign 48 points coordinates of 485 identifying 347 point function 485 positioning and sizing 360 type of 303 position of cast members 126 of mouse pointer 394 402 403 of sprites 152 3...

Page 751: ...679 saving changes to casts 567 movies 568 698 Score associated with current movie 572 channels selected in 573 recording 86 214 Score color assigned to sprites 573 updating 86 698 screens centering S...

Page 752: ...ume of sound 723 volume of sprite 724 sound sprites current playing time of 168 space character 615 specular 3D property light property 616 shader property 616 specularity 616 spheres Lingo for 39 spr...

Page 753: ...browser window 422 do command 197 EMPTY character constant 210 ending character selections 584 expressions as 642 field keyword 231 highlighting 289 in field cast members 653 integer function 317 ite...

Page 754: ...comparison operator 626 strings in field cast members 653 text boxes for cast members 107 textures 654 coordinates 375 Lingo for 41 ticks converting time to 665 lastClick function 336 lastKey functio...

Page 755: ...windows 422 events outside of 379 forget window command 250 frontmost movie in 258 moving windows behind other windows 405 moving windows in front of other windows 405 naming 415 on activateWindow eve...

Page 756: ...Index 756...

Reviews: