This document is also available in the Director 7 application folder located on your hard drive. After installing Director 7.02 or running the Director 7.02 updater, look in the Director 7 application folder for the file "Doc_Changes.htm".

Introduction

New Features in Director 7.0.2

Additions and Changes to the Documentation

Changes to the Lingo Dictionary

Introduction

The following information has been added to the documentation after the initial release of Director 7.0 (English). Some information may have appeared in the documentation released with Director 7.0.1 (Japanese, German, and French). Some information may also already appear in the online documentation.

For the most up to date information about Director 7, visit our website at https://helpx.adobe.com/director.html.

New Features in Director 7.0.2

Digital Video: Streaming of QuickTime cast members

QuickTime cast members may now be streamed into Director. Set the lingo property "the streaming of member" to "true" to enable this feature. This setting is "true" by default in Director 7.0.2, but "false" by default for any existing ( 7.0 and earlier ) QuickTime cast members.

Note: QuickTime 4 must be installed to enable streaming.

If a streaming QuickTime file contains cue points, then you must set the text track to be preloaded (use a QuickTime editor such as MoviePlayerPro to do this). If you do not preload the text track, Director will disable the cue points in the QuickTime file so it can stream without downloading the entire file. A new warning dialog appears to advise you of this behavior. You will need to reload the file after editing the QuickTime movie to preload the cue point track.

It is now possible to import an rtsp stream as a QuickTime cast member. Make sure the rtsp:// url ends with a .mov file so that Director knows it is a QuickTime stream.

Flash Asset Xtra

The Flash Asset Xtra now supports Flash 4 movies.

A new global property, the soundMixMedia, enables Flash cast members to mix their sound with sounds in the score sound channels when it is set to true. When it is set to false, these sounds will play separately. This property defaults to true for Director 7 movies and false for earlier ones.

Fonts: Embedding fonts in movies

The Font Cast Member Properties dialog has been updated.

To install a specified font, select a font face from the font face pop-up menu. Bold, Italic, and BoldItalic options are only available for fonts with custom faces; all others will default to Plain. (Most Japanese fonts do not have custom font faces, and will therefore display Plain as the only available option).

To include bitmap versions of the font in specified sizes, click the Sizes button for Bitmaps and enter the point sizes you want to include separated by spaces or commas. For example, 9, 10, 14.

Select Bold or Italic or both in order to specify the face of the bitmapped subset. Choosing neither will default to Plain.

To specify the characters included in the font, choose an option for Characters.

Entire Set includes every character (symbols, punctuation, numbers, and so on) with the font.

Partial Set lets you choose exactly which characters are included. To choose a group of characters, check Punctuation, Numbers, Roman Characters, or Other. If you choose Other, enter the characters to be included in the box on the right. In some double-byte languages, other groups of characters may appear.

Lingo: Additions to the environment property list

The environment property list now includes these new properties: #productBuildVersion, #uiLanguage, and #internetConnected.

The productBuildVersion returns the number of the build associated with the current player. For example, you could use this property to make sure that Shockwave users have a particular version of the Shockwave player before playing your movie.

The uiLanguage returns the language used to display the user interface on the user's system.

The internetConnected returns an indicator of whether or not the user is connected to the Internet. For example:

put (the environment).internetConnected -- possible returns -- #online -- there is an active Internet connection. -- #offline -- there is not an active Internet connection. -- #unknown -- there may or may not be an active Internet connection.

The shockMachine returns TRUE when Shockmachine is installed on the machine running the movie, regardless of whether the movie is played in authoring, projectors, or Shockwave.

The shockmachineVersion returns a four-character string with version information, such as "1.00", when the movie is playing inside Shockmachine. This string will always represent a decimal number with two digits of precision. The shockmachineVersion will return EMPTY (an empty string, "") when the movie is not running inside ckmachine.

Lingo: The applicationName

Use the lingo function the applicationName to determine the name of the currently running projector. This function has been disabled in Shockwave.

Netlingo: New parameters for getNetText and postNetText

For a description of these changes, see the new Lingo Dictionary entries below for getNetText,postNetText, and URL Encode.

Projectors: Compressed projectors

See information below under Distribution formats and Projectors: Creating.

Sound: MP3 streaming support

MP3-format sound may be streamed using the SWA Asset Xtra. Make sure that the bit rate of the MP3 is reasonable for your pipe size and that other SWA properties are returning useful info.

Sound: DirectSound support on Windows

Director 7.0.1 for Windows includes a new sound device Xtra (or sound mixer Xtra), the DirectSound Xtra.

This Xtra permits low-latency mixing of Director's sound channel outputs by using DirectSound if it is installed on a given system. If it is not present, Director will use Macromix or the device specified with the "set the soundDevice"' lingo statement.

Developers must download the DirectSound runtime from Microsoft and agree to the Microsoft redistribution license before they can redistribute it with their content.

Text: The "byte" chunk expression

On double-byte systems such as Japanese, the "byte" chunk expression enables you to access individual bytes in multibyte characters. For example to find out the number of bytes in line 3, use this lingo:

myTextMember.line[3].byte.count

Use this lingo to access the first byte of a multibyte character:

myTextMember.char[5].byte[1]

On Roman systems "byte" has the same meaning as "char".

Text: Setting text cast member properties

To make text appear on the Stage faster, choose an option for Pre-Render.

Pre-Render makes Director render text when the current member is loaded instead of when the member first appears on the Stage.

None provides no pre-rendering.

Copy Ink optimizes the pre-rendering for Copy Ink.

Other Ink pre-renders the text for all other ink types.

To further improve text rendering performance, turn on Save Bitmap to save the pre-rendered text bitmaps in the Director file.

This avoids the text rendering step altogether, but increases the file size. Save bitmap is only available with pre-rendered text, and should only be used for static, non-scrolling text.

Additions and Changes to the Documentation

Tutorial

There are several mistakes in the printed Director 7 tutorial. However, the tutorial in Director Help is correct. You can print a correct version of the tutorial from Director Help or by downloading and printing the corrected tutorial from the Director 7 Documentation Corrections in the Director Support and Developers Center at https://helpx.adobe.com/director.html.

ActiveX Control Xtra

While the majority of existing ActiveX controls work perfectly in Director, do not expect all controls to work as expected. In some cases the type of control created may be inappropriate (or superfluous) for the functionality of Director. In other cases, the programming of the ActiveX control may make assumptions about its host application which are in conflict with Director. Properties in an ActiveX control that have the same name as Director sprite properties cannot be accessed through Lingo. The Director sprite takes precedence over the control and does not pass the property call to the ActiveX control. Workaround: These properties can always be set manually through the Xtra's input dialog.

Other issues: Register() and UnRegister() do not seem to function properly. Loading and unloading ActiveX controls on the fly will produce unexpected results; it is recommended that any ActiveX controls used in a Director movie be loaded before the movie is run. For more information, consult the Director Support and Developers Center.

Aftershock

Aftershock 2.5 creates a static JPEG, rather than a static or animated GIF, as an alternate image. The Help for Aftershock 2.5 was not updated to reflect that change. The section that discusses the alternate image created by Aftershock is otherwise accurate.

(The following paragraph has been added to the Updating an existing HTML document with Aftershock topic:)

If you don't want to use Aftershock, you can manually create your own HTML document that runs Shockwave movies using the OBJECT and EMBED tags. For information on these tags and their parameters, see the On the Internet section of the Director Support and Developers Center.

Alpha Channel rendering

To set the alpha click threshold of a member containing alpha, be sure to set the member's ink mode to matte ink. Alpha click threshold will not work properly unless used with a matte ink sprite.

Performing Transform Bitmap on 32 bit images with embedded alpha causes the result to include masking effects. Workaround: Turn off Use Embedded Alpha in the cast member properties before applying Transform Bitmap.

Animated GIF

Animated GIFs which do not have their own global color tables are not supported.

Foreground and background color may be not be set for animated GIF sprites with inherent transparency.

Cast member sorting

When cast members are sorted, no distinction is made between Flash members and Vector shape members.

CPU usage on Windows

Director no longer utilizes all available system resources while running. You can lower the amount of CPU usage by increasing the idleHandlerPeriod (at the expense of executing idle handlers less frequently). CPU usage increases as the tempo of the movie increases and when extensive animation occurs on the stage. Older movies do not support this feature, so existing Shockwave content (or older movies not updated to Director 7) function as they have in the past.

Digital video

While rotation of QuickTime sprites is not supported in Director 7, cast member rotation is supported. You may get unexpected results if you attempt to rotate sprites through the sprite inspector, through the rotation tool in the tool palette, or through lingo. You can, however, rotate a QuickTime member (not sprite) by using the lingo command "set the rotation of member". This command will rotate the QuickTime content within its bounding box, leaving the bounding box stationary. Some of the image may move out of the viewable area, or be distorted to fit within the bounding rectangle, depending on how the sprite's "crop" property is set.

Newly Imported or Inserted QuickTime members have the streaming of member property set true by default. This means that cue points will be unavailable until the streaming of member is set to false.

Distribution Formats: Projectors and Shockwave

(To describe new features, the About distribution formats topic includes the following new information:)

Before deciding how to distribute a movie, it helps to understand how Director plays movies. A director movie can be played by the Shockwave player, or by a player in a project. The Shockwave player is a system component that can play movies in Web browsers and also outside browsers as stand-alone applications. A projector player can only play movies outside of a Web browser.

Distribute movies as Shockwave movies (DCRs), projectors, protected movies (DXRs), or Java applets. You should not distribute source movies (DIRs) unless you want your users to be able to change the movie in the Director authoring environment.

  • A Shockwave movie (also called a DCR) is a compressed version of a movie's data and does not include a player. Shockwave movies are created primarily to distribute over the Internet for playback in a Web browser. You can also use them when you want to compress movies distributed on a disk that are not contained in a projector. Saving a movie as a Shockwave movie compresses the data, removes all the information needed to edit the movie, and excludes the software that plays the movie. A Shockwave movie can be played in a Web browser with the proper Shockwave player installed in the system. It can also be played when opened by a projector or as a movie in a window.
  • A projector is a movie intended for play outside of a Web browser. A projector can include a player (called the Standard player), Xtras, multiple casts, and linked media in a single file. A projector can also include several different movie files. Configured in this way, a projector can be a completely stand-alone application.

Use the Shockwave player projector option to make a much smaller projector. A Shockwave projector uses an installed Shockwave player on the user's system to play a movie instead of including the player code in the projector itself. A Shockwave projector is excellent for distributing movies on the Internet that you don't want to play in a Web browser.

You can also reduce the file size of a projector by turning on projector options that compress the movie data, the player code, or both. Compressing the player code reduces the minimum projector size from approximately 1.4 MB to 800K for a Windows projector, and from 2.2 MB to 1.1 MB for a Macintosh projector.

External editors

Director 7 does not support external editing of URL-linked media. If you try to launch an external editor for URL-linked media on the Macintosh, the Paint window opens. If you attempt this in Windows, you receive an error saying the external editor is not properly configured.

You cannot use Fireworks as an external editor for images whosefile format it does not support. Currently Fireworks supports PNG, GIF, JPEG, PICT (Mac only), BMP, xRes LRG, TIFF. If you try to use Fireworks for any file format not included in the above list it will prompt you save the file as a .png file.

Photoshop cannot parse 16 or 32 bit .bmp files. This means that you cannot open a .bmp exported from Director if your monitor is set to 16 or 32 bits at export. Using Photoshop as an external editor for 16 or 32 bit .bmp files in Director will also fail.

Images containing alpha that were imported under the standard import option, will not retain their alpha if edited in an external editor. Alpha information does not get written to the external editor from Director unless the image file was imported with the import options set to "include original data for editing".

Fields

Editing large (>30k) field members at runtime may be slow. If you notice a significant lag between the time you enter text in the field member and when it appears on stage, try replacing the field member with a text member.

In Director 6, fields updated whenever changed. In Director 7, updates now occur when an updateStage command is executed, either explicitly, or when changing frames. This new behavior is most apparent when using the Debugger and stepping through Lingo that causes changes to fields (or text, which now supports dynamic manipulation). Use the Watcher window to see the actual changes occur.

File Open/Save

When Director 6 files are opened, the Save command is available immediately (even if you don't make any changes). Choosing Save opens a warning dialog explaining that your Director 6 (or previous) file will be updated to Director 7 format if you choose to Save.

Flash Asset Xtra

The only inks that work as expected with Flash members and Vector shapes are copy and background transparent; all other inks display as copy except transparent and blend which both display as background transparent.

Fonts

If a font cast member is recorded with a partial set of characters, users can still attempt to enter unrecorded characters into a text field on stage rendered with that font. In that case, Director will display a wide space character in place of the nondisplayable character.

We suggest using only one compressed font member per source font. We further suggest to use the default names suggested (sourceFontName *) so that you can tell whether a movie already has a compressed font based on a particular source font.

If an embedded version of a font exists, text set to that font will always default to use this cached embedded font version if text is anti-aliased. For example, if you have created a delimited character set for a embedded font member, you may have problems trying to use the full character set if you set the text back to the regular version of that font. If you see this problem, you can try setting anti-aliasing to none in the text cast member properties dialog, or you can remove the embedded font member from your movie.

Creating Japanese character sets requires a great deal of memory because the sets are so large. Make sure you have plenty of free memory before inserting either a complete character set or multiple partial sets.

Import

Director 4 movies do not import properly in Director 7. If you have problems importing Director movies, be sure that these movies were updated in either Director 5 or Director 6.

Imported SWA requires MIX Services, SWA Import Export Xtra, and the Sound Import Export Xtra for playback. Using imported SWA members in a Shockwave movie causes a download of 3 Xtra packages before the movie can be played.

Director imports only a single alpha channel. If your image contains multiple alpha channels, only the first channel will be imported. For Photoshop users: If you create an image in Photoshop which has a transparent background and an alpha channel, Director will read the transparent background as the alpha information. Director will not merge the transparent background with the alpha layer before importing. If you wish to import the alpha channel information, you must first flatten the image.

If you are having problems importing files from Photoshop, make sure that the files were saved with the compatibility option ON. In Photoshop 4, this preference is labeled "Options: [option] '2.5 Compatibility.'" In Photoshop 5, this option has been re-labeled "File Compatibility: [option] Include composited image with layered files." In both versions, the default for this option is ON.

(The following paragraphs have been added to the About importing bitmaps topic):

The list of supported image types in this topic should be the following: BMP, GIF, JPEG, LRG (xRes), Photoshop 3.0 (or later), MacPaint, PNG, TIFF, PICT, Targa - Windows only: FLC, FLI - Macintosh only: PICS, Scrapbook.

Note: PCX, WMF, EPS, and PCD are no longer supported.

Director supports JPEG compression at runtime for internal cast members imported through the Standard or Include Original Data for Editing import options. A JPEG imported with either of these options contains both the original compressed bits as well as decompressed bits. Once imported, the JPEG will decompress in the authoring environment. Your cast member size will display the member's size in RAM after it has been decompressed. The amount of RAM required to display a JPEG is larger than its size on disk so do not be surprised that your cast member size is larger than its original size on disk in the cast properties window.

Director takes advantage of compressed JPEG data at runtime. The original compressed data bits are saved in a Shockwave movie or a projector (if the Shockwave compression option is on). If you edit the member in Director in the Paint window, the compressed data will be lost. An alert appears before the data is overwritten.

Director does not support the following inks for animated GIFs: Background Transparent, Reverse, Not Reverse, Darkest, Lightest, Add, Add Pin, Subtract, Subtract Pin.

Lingo

Check the Director Support and Developers Center at https://helpx.adobe.com/director.html for more information about how to use the new dot syntax. (This documentation is still in the planning stages at the time of this release, so if you don't find what you need check back later.)

Mixing the new dot syntax with old-style syntax may produce unexpected results; such expressions as set a.b to 2 andtheList.getAt(1).a = 0 do not function.

The addPropAt command should be removed from the Adding and deleting items in a list topic.

The fullColorPermit property is obsolete and should not be used; the documentation incorrectly states that older movies authored with this property still work in Director 7.

References to "the media of window" should be changed to "the picture of window."

Lists with a different number of elements compare based on the number of elements; the list with more elements is considered larger than the list with fewer elements.

SendSprite and sendAllSprites returns a value (null) when no handler is invoked.

Points and rects in Director 7 can now contain floating point coordinates.

The Lingo.ini file is now available for Macintosh. The on startUp handler within the Lingo.ini file now gets executed before the message window is created. This means that put commands don't display within the message window as in previous versions. The handler is executing correctly.

The lingo properties "the productVersion" and the global variable "version" now return "7.x". In the past they returned a language version indicator, such as "6.0.1J". Use the #uiLanguage property of the environment function to determine the language.

Multiuser Server

The Multiuser Server and Xtra will support up to 50 simultaneous users. Future versions may support more users. Please visit our Web site for any updated information on this topic.

There is now a Seek command for the Director Multiuser Server. This command sets the current record pointer to the first record in the current database which contains the search criteria. See the updated Multiuser documentation on the Macromedia Web site for details.

While hosting peer connections, the Multiuser Xtra now receives messages sent to the host user name, as well as messages sent to nonexistent users or users who have disconnected from the peer host.

Test connections with the Multiuser Xtra may now be established while a movie is running in Shockwave. This requires that the server being connected to with a test connection is the same server on which the movie resides.

The Multiuser.cfg file used by the Director Multiuser Server may now be pointed to with shortcuts or aliases. This allows the Multiuser.cfg file to be placed in a location of the administrator's choice. The shortcut or alias must also be called "Multiuser.cfg".

A library of behaviors that facilitate the Multiuser Server and Xtra (available only with the Director 7 Studio) is included in the Director 7 Library palette. The library includes a Connection Manager behavior, which is designed to be placed on a "Connect to Server" button sprite. This behavior creates the connection to a Director Multiuser Server and adds itself to the Lingo actorList allowing calls to be made into it by the other Multiuser behaviors at any time in a movie, regardless of whether or not its sprite persists in the score. The remaining behaviors in the library depend on the use of this Connection Manager. They include behaviors for a chat text input field, a chat output field, a field displaying the current members of a chat group, and a "Disconnect" button sprite. Always use this Disconnect behavior with the Connection Manager. The Disconnect behavior calls the Connection Manager's "destroy" method, which removes it and its instance of the Multiuser Xtra from the actorList.

Paint window

Pixel artifacts displayed in the Paint window are usually due to video driver problems. Please verify that you have the most recently available drivers for your video card and monitor.

Preview in Browser

When using the Preview in Browser feature on Macintosh, please be aware that the movie can perform more slowly than expected since Director is running in the background. Quit Director to improve performance.

If Preview in Browser does not launch the browser, make sure you have:

  • Enough memory to run both Director and a browser simultaneously.
  • Your Director network preferences set to a browser on your hard drive.

(The following paragraph has been added to the Previewing a movie in a browser topic:)

You may notice that linked media does not work as expected when you preview a movie in a browser. Because of security restrictions, movies playing in a browser cannot read files from a local disk unless they are in a folder named dswmedia. If you are trying to preview a movie that uses linked media, put the movie and all of its linked media in a dswmedia folder. The movie can open a file in a subfolder of dswmedia provided it has the same relative path to the media as when it was originally linked. When you move the movie and its media to another server, preserve the same folder structure and all the linked media will continue to work. For details about security issues when playing a movie in a browser, see "Director and Internet Security," on the Director Support and Developers Center.

Projectors: Creating

(The following step replaces step 9 in the procedure for creating projectors):

  • To determine how the player code is included in the projector, choose an option for Player.

Standard includes the uncompressed player code in the projector file. This option starts the movie faster than other options, but creates the largest projector file.

Compressed includes a compressed version of the player code in the projector file. This substantially reduces the projector file size, but decompressing the player code adds a few seconds to the startup time of a movie.

Shockwave makes the projector use the Shockwave player installed in a user's system instead of including the player code in the projector file. If the Shockwave player is not available when the movie runs, the movie prompts the user to download it.

Save as Java

Before using Save as Java on the Macintosh, increase the recommended memory partition by at least 8 MB.

Save as Java will export all internal bitmaps and text cast members as JPEG images, except those imported from GIF files. This is a change from Director 6.5, which allowed a choice between GIF and JPEG format export. We recommend that you import your bitmap cast members from GIF files to avoid unwanted rendering artifacts that may appear with JPEGs.

Due to browser limitations on the Macintosh, the matte ink effect applied to linked GIF members will change to copy ink effect when saved as Java. The workaround for this is to save your GIF file with a transparency, setting the transparency color to white (255,255,255). This is an export option in most image editing applications, including Macromedia's Fireworks.

Security

Entering safePlayer mode does not protect against already existing unsafe Xtras.

For more details about security concerns when playing a movie on the Internet, see "Director and Internet Security," on the Director Support and Developers Center.

Shockwave Playback

Director 7 has removed support for the embed tag option 'Palette=Foreground'. Older movies that used this option will now be remapped to the Web safe palette by their browser. This may require re-authoring of some older Shockwave movies.

In Shockwave, the Mix Services and Sound Import Export Xtras must be downloaded to the end user's machine in order to achieve full sound functionality. If these Xtras are not present, certain limitations will apply:

  • Using ImportFileInto to import an AIFF with internal loop points loops the whole sound, instead of utilizing any internal loopbacks.
  • IMA-compressed WAVs will not function.
  • Cue points of linked WAVs are not usable.

Sound

All references to SoundEdit as the preferred Macintosh sound editor should refer to Peak LE 2 instead.

The soundLevel fails on some Windows machines. This is due to limitations with specific sound cards.

On Macintosh, the Modify>Movies>Xtras dialog displays a reference to "Macromix.x32" and "DirectSound.x32". While not used on the Macintosh itself, these Xtras are necessary for playback in Windows. Do not remove these references.

Using the Import dialog, SWA can now be fully imported or linked to create traditional sound cast members. These cast members have the standard capabilities of other standard sound members. However, they are quite different from SWA members created through the Insert menu, which creates SWA Asset members such as in previous Director and Shockwave releases. SWA specific Lingo only works on these asset members and causes errors if applied to the new imported SWA members.

(The following points in the Using sound in Windows topic have been changed:)

  • In Windows, a sound that is already playing in either sound channel overrides the sound in a QuickTime or AVI video or a Flash movie. It also prevents the video sound from playing even after the sound in the sound channel has stopped. Once the sound in a digital video has started, however, it overrides a sound in either sound channel. To mix QuickTime audio tracks with internal Director sounds, use the soundDevice system property to specify QT3Mix. See soundDevice in the Lingo Dictionary. Check the Director Support and Developers Center Web site for the latest developments related to this issue.
  • The default number of sounds that Director can mix in Windows is eight. This number can be decreased by modifying the value for MinMaxChannels in the Director.ini file in the Director folder.

Stage

The Stage comes to the front only if you select it by clicking on its title bar. Clicking in the body of the Stage leaves the Stage in the background, as in previous releases. Choosing Window>Stage currently brings the Stage to the front (from the back) or closes it. Moving the Stage by dragging on its title bar does not change the location settings displayed in Movie Properties. The Center option in the General Preference dialog also does not alter the location settings in Movie Properties or within movies.

If you drag the Stage during authoring, the Stage location is not reflected in Movie Properties. The easiest way to return the Stage to its position as listed in Movie Properties is to open General Preferences and Center the Stage, then close the dialog. Then reopen the dialog and uncheck Center.

Streaming

You must select Save and Compact before movies will stream properly.

Casts whose properties are set to preload "Before Frame One" or "After Frame One" may force the bulk of a movie's media to download before it begins to play (in authoring and projectors, but not Shockwave). To avoid this potential conflict altogether, ensure that the Cast is set to preload "As Needed" (the default).

Director 6 .dir files do not stream in Director 7 (.dcr files do stream as expected). Update the movies to Director 7 format to enable streaming.

Compressed fonts preload their media prior to movie playing, significantly increasing the time it takes for the first frame to appear on playback.

Take care when using mouse handlers on text cast members that contain hypertext links. Text marked as hypertext performs certain standard actions based on mouse movements. If the mouse is moved over a link, the cursor changes to the pointing hand. Similarly, if a mouseDown occurs on the link, the color of the link changes. Director uses standard mouse events to create these actions, so if you place mouseDown, mouseWithin, or mouseUp behaviors on the text sprite, be sure that you include the "pass" command at the end of each event handler or else the built-in hypertext actions will not occur.

Text: Resetting line height

The line height of text and field cast members may be reset to its default by assigning a value of 0 to the line height edit field in the Text Inspector, or in the Toolbar, or in the Editor windows for those cast member types or through Lingo.

Text: Scrolling

(The Setting field cast member properties topic includes the following new description:)

Scrolling attaches a scroll bar to the right side of the text box. This is useful when there is a large amount of text. A scroll bar for a field cast member is controlled by system software and therefore appears in front of all other sprites. Create a custom scroll bar if you want it to appear behind other sprites.

Text: Size limitation

Large (over 3200 pixels high) text sprites display as blank members on stage. The backing buffer for these sprites cannot be properly created as they are so large. Workaround: Set member to fixed or scrolling and reduce the size of the sprite.

Transitions

Transitions: the Dissolve Bits, Bits Fast, Pixel, and Pixel Fast transitions will have a more boxy look than in Director 6 if any window is overlapping the stage during playback.

Updating movies

We recommend updating movies made in a previous version before working with them.

If you receive an "out of memory: must Save or Quit" dialog, a Save is guaranteed only if the movie is a Director 7 movie. If you are editing an older movie, the Save may run out of memory and fail.

The #digitalVideo member type is now reserved for AVI files only. QuickTime videos use a new type, #quickTimeMedia. In movies made with previous versions of Director, replace uses of the term #digitalVideo that apply to QuickTime videos with the new syntax, #quickTimeMedia.

Due to the new dot syntax, periods can no longer be used in Lingo variable names.

The lingo syntax member(X) of castLib Y will generate an error message. Replace it with member(X,Y).

Global variables must be expressly declared as such; if you encounter odd lingo errors in an updated movie, check that you are not depending on an undeclared global.

Director 4 movies must be updated or opened and saved in Director 5 or 6 before they can be opened in Director 7. If you intend to user Director 4 movies as film loops within Director 7, they too must be updated before they are imported into Director 7.

Director 6 does not show sprite colors for text (you must use lingo to verify colors). Director 7 shows the colors for text sprites. If your text members look different in Director 7 after updating movies, check the forecolor and backcolor of sprite through lingo in Director 6 to see if it has been set to a nonwhite color.

If you update a movie that uses fields and notice that transitions stop working, you can either change all uses of fields to text cast members or change any text field manipulation from other handlers to enterFrame handlers. This way the text change takes place after the transition has already been completed.

Text that disappears when a movie is updated may have a blend value of 0. Director 6 ignored blend values for text sprites, but Director 7 operates on these values. Similarly, blend with copy ink has the effect of blending a Flash sprite into its background color; if its bgcolor is white, and the blend is 0%, you see just a white square.

Movies authored under Director 6 that used RSX to synchronize multiple sounds playing at once need to use a different sound device, as RSX is no longer supported.

Vector shapes

Vector shape, Flash, and QuickDraw shape cast members all leave a ghost image if their blend is set to 0 (with the ink set to background transparent). Workaround: set the visible of sprite = false.

Xtra distribution

To use Xtra downloading in Authoring, Projectors and Shockwave, you must issue a gotoNetMovie "moviefilename" to the movie with the attached packages. Simply opening a movie in Authoring, or wrapping a movie into projector will not download the necessary Xtras.

The Xtras delivered in Shockwave do not need to be marked as "Download If Needed" for Shockwave. This list consists of CBrowser Xtra, Flash Asset, Font Asset, Font Xtra, InetUrl Xtra, Multiusr, NetFile Xtra, NetLingo Xtra, Prefs Xtra, SWA Decomp Xtra, SWA Streaming Xtra, TextAsset, TextXtra, and WinSock Lib.

You may distribute Xtras that have been signed by Macromedia from your Intranet.

(The following paragraphs have been added to the Managing Xtras for distributed movies topic:)

Xtras that are not included with the Shockwave player must be installed in a user's system before the movie plays. Use the Download If Needed option in the Movie Xtras dialog box to make the movie prompt the user to download the Xtra. Director downloads Xtras from the URL specified in the Xtrainfo.txt file in the Director application folder.

Xtrainfo.txt includes URLs for all Macromedia Xtras included with Director, but you many need to manually edit Xtrainfo.txt to add the URL for third party Xtras or Macromedia Xtras not included with Director. Xtrainfo.txt includes a description of how to enter this information. Xtra developers may also provide installation programs or other means of modifying Xtrainfo.txt automatically.

If a user chooses to download an Xtra, Director retrieves the Xtra from the URL specified in Xtrainfo.txt using the Verisign download security system. Verisign is a standard means of downloading software from secure sources.

Changes to the Lingo Dictionary

General

Occasionally you will come across examples of lingo in the Dictionary that contain "smart" (or "curly") quotation marks. If you paste these examples into your own lingo, they will produce script errors. To eliminate the errors, simply replace the quotation marks with the "straight" kind.

addVertex

(The description of this function has been changed as follows:)

The syntax example should be:

addVertex (member memberRef, indexToAddAt, pointToAddVertex {,[controlLocH, controlLocV], [controlLocH, controlLocV]})

bgColor

(The following example has been added to this topic:)

Example: This example sets the color of the stage to an RGB value.

set the bgcolor of the stage = rgb(255, 153, 0)

charSpacing

(The description of this function has been changed as follows:)

Add this dot syntax example:

The following handler increases the current character spacing of the third through fifth words within the text member "myCaption" by a value of 2:

on myCharSpacer mySpaceValue = member("myCaption").word[3..5].charSpacing member("myCaption")Word[3..5].charSpacing = (mySpaceValue + 2) end

color

(The description of this function has been changed as follows:)

Add this example for text:

The following example changes the color of the 4th through the 7th characters of text member "myQuotes":

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

emulateMultiButtonMouse

(The example for this topic has been changed as follows:)

Example: The following statement checks if machineType is greater or less than 256 (a Windows computer) and if so, sets the emulateMultiButtonMouse property to TRUE:

if the machineType <> 256 then set the emulateMultiButtonMouse to TRUE

eventPassMode

This property passes an event message to the next location in the message hierarchy, not just to behaviors (as implied in the Dictionary definition).

fixStageSize

(The example for this movie property has been changed as follows:)

Example: This statement determines whether the fixStageSize property is turned on. If fixStageSize is false, it sends the playback head to a specified frame.

if the fixStageSize = FALSE then go to frame "proper size"

font

The description should state that this property is available for both field and text cast members.

fontSize

(The description of this function has been changed as follows:)

Add this dot syntax example:

The following example sets the third line of text member "myMenu" to 24 points:

member("myMenu").line[3].fontSize = 24

fontSpacing

This is not a valid Lingo term and has been removed from the Lingo Dictionary.

fontStyle

(The description of this function has been changed as follows:)

Add this dot syntax example:

The following example sets the fontStyle member property of word 1 through word 4 of text member "myNote" to bold italics:

member("myNote")Word[1..4].fontStyle = [#bold, #italic]

forecolor

(The description of this function has been changed as follows:)

Add this dot syntax example:

The following example sets the forecolor of word 3 of line 2 of text member "myDescription" to a value of 27:

member("myDescription")Line[2]Word[3].forecolor = 27

frameLabel

This function incorrectly appears under the list of lingo associated with Flash in the lingo by feature section.

getFrameLabel

(This function has been added to the Lingo dictionary:)

Syntax: getFrameLabel(sprite whichFlashSprite, whichLabelNumber)

Description: Function; returns the frame label within a Flash movie that is associated with the frame number requested. If thelabel doesn't exist, or that portion of the Flash movie has not yet been streamed in, this function returns an empty string.

getNetText()

(The description of this function has been changed as follows:)

Syntax: getNetText(URL {, serverOSString} {, characterSet})
getNetText(URL, propertyList {, serverOSString} {, characterSet})

Description: Function; starts the retrieval of text from a file usually on an HTTP or FTP server, or initiates a CGI query.

The first syntax shown starts the retrieval of text. HTTP CGI queries may be submitted this way, and must be properly encoded in the URL. The second syntax includes a property list and submits a CGI query, providing the proper URL-encoding.

Use the optional parameter 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 characters in propertylist. The value defaults to "Unix" but may be set to "Win" or "Mac" and translates any Return characters in the propertylist argument into those used on the server. For most applications, this setting is unnecessary because line breaks are usually not used in form responses.

Optional parameter characterSet applies only if the user is running on a shift-JIS (Japanese) system. Its possible settings are "JIS", "EUC", "ASCII", and "AUTO". Retrieved data is converted from shift-JIS to the named character set. The "AUTO" setting will try to determine what character set the retrieved text is in and translate it to the character set on the local machine. The default setting is "ASCII".

For a movie that plays back as an applet, the getNetText command retrieves text only from the domain that contains the applet. This behavior differs from Shockwave and is necessary due to Java's security model.

Use netDone to find out when the getNetText operation is complete, and netError to find out if the operation was successful. Use netTextResult to return the text retrieved by getNetText.

The function works with relative URLs.

For all examples, the correct syntax of getNetText parameters should be as follows:

getNetText ("<http://BigServer.com/sample.txt>http://BigServer.com/sample.txt")

gotoNetMovie

(The following information has been added to the description of this command:)

It is good practice to loop playback after executing a gotoNetMovie to ensure that the current movie is still running when enough of the calling movie is ready to be played. For example, inserting a "go to the frame" script on a frame after the execution of the gotoNetMovie would ensure the initial movie is running, and therefore a successful execution of the gotoNetMovie.

hilite

(The description of this function has been changed as follows:)

Add this example of how to remove highlighting from a field:

Example: The following example will cause highlighted text within the sprite for field "myRecipes" to be displayed without highlighting:

myLineCount = (the number of lines of field "myRecipes") hilite line (myLineCount + 1) of field "myRecipes"

Also: The selection property should be listed in the "See also" section.

idleHandlerPeriod

The default value of the idleHandlerPeriod has changed from 0 (in Director 6) to 1 (in Director 7). Movies updated from Director 6 to Director 7 may seem to play slowly do to this change.

ilk()

(This function has been added to the Lingo dictionary:)

Syntax: ilk(type)
ilk(object,type)

Description: Function; indicates the type of an object, including lists, rects, colors, dates, or points.

-- The syntax ilk(object) returns a value indicating the type of an object. If the object is a list, ilk(object) returns #list; if the object is a property list, ilk(object) returns #propList.

-- The syntax ilk(object, type) and object.ilk(type) compares the object represented by object to the specified type. If the object is of the specified type, the ilk function returns TRUE. If the object is not of the specified type, the ilk function returns FALSE. The following values are returned for each combination of objects and types:

Item Possible type=returned value

color #color=1,#date=0, #list=0, #linearlist=0, #proplist=0, #point=0, #rect=0, #instance=0

date #color=0,#date=1, #list=0, #linearlist=0, #proplist=0, #point=0, #rect=0, #instance=0

Linear list #color=0,#date=0, #list=1, #linearlist=1, #proplist=0, #point=0, #rect=0, #instance=0

Property list #color=0,#date=0, #list=1, #linearlist=0, #proplist=1, #point=0, #rect=0, #instance=0

Point #color=0,#date=0, #list=1, #linearlist=0, #proplist=0, #point=1, #rect=0, #instance=0

Rect #color=0,#date=0, #list=1, #linearlist=0, #proplist=0, #point=0, #rect=1, #instance=0

Instance #color=0,#date=0, #list=1, #linearlist=0, #proplist=0, #point=0, #rect=0, #instance=1

Example: The following statement identifies the type of the object named Bids.

Set Bids to [:] put ilk( Bids ) -- #proplist

Example: The following statement tests whether the variable named Bids is a property list and displays the result in the Message window:

set Bids to [:] put ilk( Bids, #proplist ) -- 1

Because Bids is a property list, the Message window displays 1, which is the numeric equivalent of TRUE.

Example: The following statement tests whether the variable Total is a list and displays the result in the Message window:

set Total to 2+2 put ilk( Total, #list ) -- 0

In this case, since the variable Total is not a list, the Message window displays 0, which is the numeric equivalent of FALSE.

Example: The following example tests a variable named myVariable and verifies that it is a date object before putting it in the Message window:

set myVariable to the systemDate if myVariable.ilk(#date) then put myVariable
See also: color(), date() (formats)

machineType

Movies which rely on the machineType to be less than 256 to detect a Macintosh may return the wrong result; we recommend using another system property, the platform, to determine this information. Here's why: Apple has run out of room to uniquely identify each computer type within a single byte. Now "the machineType" returns values between 1 and 255 or greater than 257 for Macintosh computers. A Macintosh G3, for instance, returns 406.

mask

(The description of this function has been changed as follows:)

The 1st line of the 3rd paragraph of the description should be the following:

For best results, set a QuickTime cast member's mask property before any of its sprites appear on the Stage in the on beginSprite event handler.

netError()

When operating on an invalid URL, it is still conceivable to have netError() return "OK." It is common for servers to return error pages when a requested file does not exist. These error pages usually have a mime-type of "text/html" and are therefore reported as successful transfers by netError(). To verify a successful operation, it is recommended that you test for the expected mime-type with "netMime()" in addition to netError().

obeyScoreRotation

This element should be in the Flash section of the Lingo By Feature topic.

open window

The "see also" list under this item should include the "forget window" command.

pausedAtStart

This property is for Flash cast members only, not for sprites.

postNetText

(The description of this function includes the following new information:)

Optional parameter serverOSString defaults to UNIX but may be set to Win or Mac and translates any Return characters in the postText argument into those used on the server to avoid confusion. For most applications, this setting is unnecessary because line breaks are usually not used in form responses.

Optional parameter serverCharSetString applies only if the user is running on a shift-JIS (Japanese) system. Its possible settings are "JIS", "EUC", "ASCII", and "AUTO". Posted data is converted from shift-JIS to the named character set. Returned data is handled exactly as by getNetText (converted from the named character set to shift-JIS). If you use "AUTO", no translation of the posted data from the local character set occurs; the results sent back by the server will be translated as they are for getNetText. "ASCII" is the default if serverCharSetString is omitted. "ASCII" provides no translation for posting or results.

Example: This script retrieves text from the URL http://BigServer.com/sample.txt and updates the field cast member the mouse is on when it's clicked:

property spriteNum property theNetID on mouseUp me set  theNetID = getNetText "http://BigServer.com/sample.txt" end on exitFrame me if  netDone(theNetID) then set  the text of member (the member of sprite spriteNum) = netTextResult(theNetID) end  if end

Example: This example retrieves the results of a CGI query:

getNetText("http://www.yourserver.com/cgi-bin/query.cgi?name=Bill%20Smith")

Example: This is the same 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 Smith"])
See also netDone(), netError() , netTextResult()

selection

(The description of this function has been changed as follows:)

Add this dot syntax example:

The following example sets the selection displayed by the sprite of text member "myAnswer" so that characters six through 10 are hilited:

member("myAnswer").selection = [6, 10]

Also, the color property should be in the "See also" section.

shutDown

(The example for this command has been changed as follows:)

Example: This statement checks whether the user has pressed Control-S (Windows) or Command-S (Macintosh) and, if so, shuts down the computer:

if the key = "s" and the commandDown then shutdown end if

stageColor

(The description of this property has been changed as follows:)

Syntax: the stageColor

Description: System property; determines the color of the movie background for index color only.

Use bgColor for more accurate, reliable, and flexible stage color specification with RGB values.

URLEncode

(The following new function has been added to the Lingo Dictionary:)

Syntax: URLEncode(proplist_or_string {, serverOSString} {, characterSet})

Description: Function, returns the URL-encoded string for it's first argument. Allows CGI parameters to be used in other commands. The same translation is done as for postNetText and getNetText when they are given a property list.

Use the optional parameter serverOSString to encode any return characters in proplist_or_string. The value defaults to "UNIX" but may be set to "Win" or "Mac" and translates any Return characters in the proplist_or_string argument into those used on the server. For most applications, this setting is unnecessary because line breaks are usually not used in form responses.

Optional parameter characterSet applies only if the user is running on a shift-JIS (Japanese) system. Its possible settings are "JIS", "EUC", "ASCII", and "AUTO". Retrieved data is converted from shift-JIS to the named character set. Returned data is handled exactly as by getNetText (converted from the named character set to shift-JIS). If you use "AUTO", no translation of the posted data from the local character set will be done; the results sent back by the server will be translated as they are for getNetText. "ASCII" is the default if characterSet is omitted. "ASCII" provides no translation for posting or results.

Example: In the following example, URLEncode supplies the URL-encoded string to a CGI query at the specified location.

URL = "http://aserver/cgi-bin/echoquery.cgi" gotonetpage URL & "?" & URLEncode( [#name: "Ken", #hobby: "What?"] )
See also: getNetText(), postNetText

volume (sound channel)

(This topic includes the following new information:)

This property does not support dot syntax. Use the syntax exactly as shown here.

Example: This statement sets the volume of sound channel 2 to 130, which is a medium sound level setting:

set the volume of sound 2 to 130

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy