User manual MACROMEDIA FLEX-FLEX ACTIONSCRIPT LANGUAGE REFERENCE

[. . . ] Flex ActionScript Language Reference Trademarks ActiveEdit, ActiveTest, Add Life to the Web, Afterburner, Aftershock, Andromedia, Allaire, Animation PowerPack, Aria, Attain, Authorware, Authorware Star, Backstage, Blue Sky Software, Blue Sky, Breeze, Bright Tiger, Clustercats, ColdFusion, Contents Tab Composer, Contribute, Design In Motion, Director, Dream Templates, Dreamweaver, Drumbeat 2000, EDJE, EJIPT, Extreme 3D, Fireworks, Flash, FlashHelp, Flash Lite, FlashPaper, Flex, Flex Builder, Fontographer, FreeHand, Generator, Help To Source, HomeSite, Hotspot Studio, HTML Help Studio, JFusion, JRun, Kawa, Know Your Site, Knowledge Objects, Knowledge Stream, Knowledge Track, LikeMinds, Lingo, Live Effects, MacRecorder Logo and Design, Macromedia, Macromedia Action!, Macromedia Central, Macromedia Flash, Macromedia M Logo and Design, Macromedia Spectra, Macromedia xRes Logo and Design, MacroModel, Made with Macromedia, Made with Macromedia Logo and Design, MAGIC Logo and Design, Mediamaker, Movie Critic, Open Sesame!, RoboDemo, RoboEngine JFusion, RoboHelp, RoboHelp Office, RoboInfo, RoboInsight, RoboPDF, 1-Step RoboPDF, RoboFlash, RoboLinker, RoboScreenCapture, ReSize, Roundtrip, Roundtrip HTML, Shockwave, Sitespring, Smart Publishing Wizard, Software Video Camera, SoundEdit, Titlemaker, UltraDev, Web Design 101, what the web can be, WinHelp, WinHelp 2000, WinHelp BugHunter, WinHelp Find+, WinHelp Graphics Locator, WinHelp Hyperviewer, WinHelp Inspector, and Xtra are either registered trademarks or trademarks of Macromedia, Inc. and may be registered in the United States or in other jurisdictions including internationally. Other product names, logos, designs, titles, words, or phrases mentioned within this publication may be trademarks, service marks, or trade names of Macromedia, Inc. or other entities and may be registered in certain jurisdictions including internationally. [. . . ] After the user responds to the dialog box, this method is called again and returns either true or is also invoked with a code property of SharedObject. Flush. Success or SharedObject. Flush. Failed. false; SharedObject. onStatus For more information, see "Local disk space considerations" on page 398. 402 Chapter 6: ActionScript Core Classes Example The following function gets a shared object, my_so, and fills writable properties with userprovided settings. Finally, flush() is called to save the settings and allot a minimum of 1000 bytes of disk space. this. syncSettingsCore = function(soName:String, override:Boolean, settings:Object) { var my_so:SharedObject = SharedObject. getLocal(soName, "http:// www. mydomain. com/app/sys"); // settings list index var i; // For each specified value in settings: // If override is true, set the persistent setting to the provided value. // If override is false, fetch the persistent setting, unless there // isn't one, in which case, set it to the provided value. for (i in settings) { if (override || (my_so. data[i] == null)) { my_so. data[i] = settings[i]; } else { settings[i] = my_so. data[i]; } } my_so. flush(1000); }; SharedObject. getLocal() Availability Flash Player 6. Usage SharedObject. getLocal(objectName:String [, localPath:String]) : SharedObject Note: The correct syntax is SharedObject. getLocal. To assign the object to a variable, use syntax like myLocal_so = SharedObject. getLocal. Parameters objectName A string that represents the name of the object. The name can include forward slashes (/); for example, work/addresses is a legal name. Spaces are not allowed in a shared object name, nor are the following characters: ~%&\;: "', <>?# localPath An optional string parameter that specifies the full or partial path to the SWF file that created the shared object, and that determines where the shared object will be stored locally. See the Description section for a discussion of this parameter's importance. Returns A reference to a shared object that is persistent locally and is available only to the current client. If Flash can't create or find the shared object (for example, if localPath was specified but no such directory exists), this method returns null. SharedObject. getLocal() 403 Description Method; returns a reference to a locally persistent shared object that is available only to the current client. Note: If the user has selected to never allow local storage for this domain, the object is not saved locally, even if a value for localPath is specified. For more information, see "Local disk space considerations" on page 398. To avoid name collisions, Flash looks at the location of the SWF file that is creating the shared object. For example, if a SWF file at www. myCompany. com/apps/stockwatcher. swf creates a shared object named portfolio, that shared object will not conflict with another object named portfolio that was created by a SWF file at www. yourCompany. com/photoshoot. swf because the SWF files originate from different directories. Although the localPath parameter is optional, developers should give some thought to its use, especially if other SWF files will need to access the shared object. If the data in the shared object are specific to one SWF file that will not be moved to another location, then use of the default value makes sense. If other SWF files need access to the shared object or if the SWF file that creates the shared object will later be moved, then the value of this parameter can have a profound effect on whether any SWF files will be able to access the shared object. For example, if you create a shared object with localPath set to the default value of the full path to the SWF file, then no other SWF file will be able to access that shared object. If you later move the original SWF file to another location, then not even that SWF file will be able to access the data already stored in the shared object. You can reduce the likelihood that you will inadvertently restrict access to a shared object by using the localpath parameter. The most permissive option is to set the localPath parameter to "/", which makes the shared object available to all SWF files in the domain, but will increase the likelihood of name collisions with other shared objects in the domain. More restrictive options are available to the extent that you can append the localPath parameter with folder names that are contained in the full path to the SWF file. For example, your localPath parameter options for the portfolio shared object created by the SWF file at www. myCompany. com/apps/ stockwatcher. swf are: "/"; "/apps"; or "/apps/stockwatcher. swf". You will need to determine which option provides enough flexibility for your application. Example The following example creates a shared object that stores text typed into a TextInput component instance. [. . . ] · 2: Always use the deblocking filter. The deblocking filter has an effect on overall playback performance, and it is usually not necessary for high-bandwidth video. If your system is not powerful enough, you might experience difficulties playing back video with this filter enabled. Example The following example plays video1. flv in the my_video video object, and lets the user change the deblocking filter behavior on video1. flv. Add a video object called my_video and a ComboBox instance called deblocking_cb to your file, and then add the following ActionScript to your FLA or AS file. var deblocking_cb:mx. controls. ComboBox; 804 Chapter 7: ActionScript for Flash var my_video:Video; // my_video is a Video object on the Stage var my_nc:NetConnection = new NetConnection(); my_nc. connect(null); var my_ns:NetStream = new NetStream(my_nc); my_video. attachVideo(my_ns); my_ns. play("video1. flv"); deblocking_cb. addItem({data:0, label:'Auto'}); deblocking_cb. addItem({data:1, label:'No'}); deblocking_cb. addItem({data:2, label:'Yes'}); var cbListener:Object = new Object(); cbListener. change = function(evt:Object) { my_video. deblocking = evt. target. selectedItem. data; }; deblocking_cb. addEventListener("change", cbListener); Use the ComboBox instance to change the deblocking filter behavior on video1. flv. Video. height Availability Flash Player 6. Usage my_video. height:Number Description Property (read-only); an integer specifying the height of the video stream, in pixels. For live streams, this value is the same as the Camera. height property of the Camera object that is capturing the video stream. [. . . ]