flex-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cframp...@apache.org
Subject svn commit: r1370028 [11/43] - in /incubator/flex/whiteboard/cframpton/adobe.next: ./ frameworks/ frameworks/projects/advancedgrids/src/mx/collections/ frameworks/projects/advancedgrids/src/mx/controls/ frameworks/projects/airframework/src/mx/managers/...
Date Mon, 06 Aug 2012 21:26:02 GMT
Modified: incubator/flex/whiteboard/cframpton/adobe.next/frameworks/projects/playerglobal/bundles/en_US/docs/flash.external.xml
URL: http://svn.apache.org/viewvc/incubator/flex/whiteboard/cframpton/adobe.next/frameworks/projects/playerglobal/bundles/en_US/docs/flash.external.xml?rev=1370028&r1=1370027&r2=1370028&view=diff
==============================================================================
--- incubator/flex/whiteboard/cframpton/adobe.next/frameworks/projects/playerglobal/bundles/en_US/docs/flash.external.xml (original)
+++ incubator/flex/whiteboard/cframpton/adobe.next/frameworks/projects/playerglobal/bundles/en_US/docs/flash.external.xml Mon Aug  6 21:25:54 2012
@@ -119,10 +119,12 @@
              <codeph class="+ topic/ph pr-d/codeph ">call()</codeph> method and cannot get or set the <codeph class="+ topic/ph pr-d/codeph ">actionScriptData</codeph> property.</p>
 			 
 		 	 </apiDesc></apiOperationDetail></apiOperation><apiOperation id="flash.external:ExtensionContext:getExtensionDirectory" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getExtensionDirectory</apiName><shortdesc class="- topic/shortdesc ">
-			 Returns the directory in which the extension is installed on the device.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic
 /section reference/section apiRef/apiDesc ">The directory does not exist. The most likely reason is that the specified
-			 <codeph class="+ topic/ph pr-d/codeph ">extensionID</codeph> is not valid.
+			 Returns the directory in which the extension is installed on the device.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic
 /section reference/section apiRef/apiDesc ">Parameter <codeph class="+ topic/ph pr-d/codeph ">extensionID</codeph> must be non-null.
 			 
-			 </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">IOError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.errors:IOError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">A File instance for the directory in which the extension is installed.
+			 </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">TypeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">TypeError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">The value specified for argument <codeph class="+ topic/ph pr-d/codeph ">extensionID</codeph> is invalid.
+			 The directory does not exist.
+			 
+			 </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">ArgumentError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">ArgumentError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">A File instance for the directory in which the extension is installed.
 			 
 			 </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.filesystem:File</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">extensionID</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">The extension identifier of the extension. This identifier has the same
 			 value as the <codeph class="+ topic/ph pr-d/codeph ">extensionID</codeph> parameter in <codeph class="+ topic/ph pr-d/codeph ">createExtensionContext()</codeph>. 

Modified: incubator/flex/whiteboard/cframpton/adobe.next/frameworks/projects/playerglobal/bundles/en_US/docs/flash.filesystem.xml
URL: http://svn.apache.org/viewvc/incubator/flex/whiteboard/cframpton/adobe.next/frameworks/projects/playerglobal/bundles/en_US/docs/flash.filesystem.xml?rev=1370028&r1=1370027&r2=1370028&view=diff
==============================================================================
--- incubator/flex/whiteboard/cframpton/adobe.next/frameworks/projects/playerglobal/bundles/en_US/docs/flash.filesystem.xml (original)
+++ incubator/flex/whiteboard/cframpton/adobe.next/frameworks/projects/playerglobal/bundles/en_US/docs/flash.filesystem.xml Mon Aug  6 21:25:54 2012
@@ -260,7 +260,7 @@ fileStream.close();
 	
 	</apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">The file cannot be read or the file is not open.</shortdesc></adobeApiEvent></apiOperation><apiOperation id="flash.filesystem:FileStream:readBytes" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">readBytes</apiName><shortdesc class="- topic/shortdesc ">
 	
-     Reads the number of data bytes, specified by the length parameter, 
+     Reads the number of data bytes, specified by the length parameter,
      from the file stream, byte stream, or byte array.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">The file has not been opened; the file has been opened, but it was not opened with
 	read capabilities; or for a file that has been opened for synchronous operations (by using the 
 	<codeph class="+ topic/ph pr-d/codeph ">open()</codeph> method), the file cannot be read (for example, because the file is missing).
@@ -276,9 +276,9 @@ fileStream.close();
                    of 0 causes all available data to be read.
      </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
 	
-     Reads the number of data bytes, specified by the <codeph class="+ topic/ph pr-d/codeph ">length</codeph> parameter, 
-     from the file stream, byte stream, or byte array. The bytes are read into the 
-     ByteArray objected specified by the <codeph class="+ topic/ph pr-d/codeph ">bytes</codeph> parameter, starting at 
+     Reads the number of data bytes, specified by the <codeph class="+ topic/ph pr-d/codeph ">length</codeph> parameter,
+     from the file stream, byte stream, or byte array. The bytes are read into the
+     ByteArray objected specified by the <codeph class="+ topic/ph pr-d/codeph ">bytes</codeph> parameter, starting at
      the position specified by <codeph class="+ topic/ph pr-d/codeph ">offset</codeph>.
      </apiDesc></apiOperationDetail><adobeApiEvent id="flash.filesystem:FileStream:readBytes_ioError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">ioError</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:IOErrorEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="-
  topic/section reference/section apiRef/apiDesc ">The file cannot be read or the file is not open. This event is dispatched 
 	only for files opened for asynchronous operations (by using the <codeph class="+ topic/ph pr-d/codeph ">openAsync()</codeph> method).
@@ -343,18 +343,18 @@ fileStream.close();
 	
 	</apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">EOFError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.errors:EOFError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">UTF-8 encoded string.
      </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">length</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">The number of bytes from the byte stream to read.
-     </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">charSet</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">The string denoting the character set to use to interpret the bytes. 
+     </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">charSet</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">The string denoting the character set to use to interpret the bytes.
      Possible character set strings include <codeph class="+ topic/ph pr-d/codeph ">"shift-jis"</codeph>, <codeph class="+ topic/ph pr-d/codeph ">"cn-gb"</codeph>,
      <codeph class="+ topic/ph pr-d/codeph ">"iso-8859-1"</codeph>, and others.
-     For a complete list, see <xref href="../../charset-codes.html" class="- topic/xref ">Supported Character Sets</xref>. 
+     For a complete list, see <xref href="../../charset-codes.html" class="- topic/xref ">Supported Character Sets</xref>.
      
-     <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Note:</b> If the value for the <codeph class="+ topic/ph pr-d/codeph ">charSet</codeph> parameter is not recognized by the current 
-     system, then <ph class="- topic/ph ">Adobe<sup class="+ topic/ph hi-d/sup ">®</sup> Flash<sup class="+ topic/ph hi-d/sup ">®</sup> Player or</ph> 
-     Adobe<sup class="+ topic/ph hi-d/sup ">®</sup> AIR<sup class="+ topic/ph hi-d/sup ">®</sup> uses the system's default 
-     code page as the character set. For example, a value for the <codeph class="+ topic/ph pr-d/codeph ">charSet</codeph> parameter, as in 
+     <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Note:</b> If the value for the <codeph class="+ topic/ph pr-d/codeph ">charSet</codeph> parameter is not recognized by the current
+     system, then <ph class="- topic/ph ">Adobe<sup class="+ topic/ph hi-d/sup ">®</sup> Flash<sup class="+ topic/ph hi-d/sup ">®</sup> Player or</ph>
+     Adobe<sup class="+ topic/ph hi-d/sup ">®</sup> AIR<sup class="+ topic/ph hi-d/sup ">®</sup> uses the system's default
+     code page as the character set. For example, a value for the <codeph class="+ topic/ph pr-d/codeph ">charSet</codeph> parameter, as in
      <codeph class="+ topic/ph pr-d/codeph ">myTest.readMultiByte(22, "iso-8859-01")</codeph>, that uses  <codeph class="+ topic/ph pr-d/codeph ">01</codeph> instead of
      <codeph class="+ topic/ph pr-d/codeph ">1</codeph> might work on your development system, but not on another system. On the other
-     system, <ph class="- topic/ph ">Flash Player or</ph> the AIR runtime will use the system's 
+     system, <ph class="- topic/ph ">Flash Player or</ph> the AIR runtime will use the system's
      default code page.</p>
      
      </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
@@ -410,7 +410,7 @@ fileStream.close();
 	</apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">IOError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.errors:IOError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">The position specfied for reading data exceeds the number of bytes available 
 	(specified by the <codeph class="+ topic/ph pr-d/codeph ">bytesAvailable</codeph> property).
 	
-	</apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">EOFError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.errors:EOFError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">A UTF-8 string produced by the byte representation of characters of the specified length.     
+	</apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">EOFError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.errors:EOFError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">A UTF-8 string produced by the byte representation of characters of the specified length.
      </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">length</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">The number of bytes to read.
      </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
 	
@@ -449,7 +449,7 @@ fileStream.close();
 	</apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">IOError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.errors:IOError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">The position specfied for reading data exceeds the number of bytes available 
 	(specified by the <codeph class="+ topic/ph pr-d/codeph ">bytesAvailable</codeph> property).
 	
-	</apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">EOFError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.errors:EOFError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">The returned value is in the range 0 to 255.        
+	</apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">EOFError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.errors:EOFError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">The returned value is in the range 0 to 255.
      </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
 	
      Reads an unsigned byte from the file stream, byte stream, or byte array.
@@ -481,7 +481,7 @@ fileStream.close();
 	</apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">IOError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.errors:IOError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">The position specfied for reading data exceeds the number of bytes available 
 	(specified by the <codeph class="+ topic/ph pr-d/codeph ">bytesAvailable</codeph> property).
 	
-	</apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">EOFError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.errors:EOFError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">The returned value is in the range 0 to 65535. 
+	</apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">EOFError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.errors:EOFError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">The returned value is in the range 0 to 65535.
      </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
 	
      Reads an unsigned 16-bit integer from the file stream, byte stream, or byte array.
@@ -538,7 +538,7 @@ function fileClosed(event:Event):void {
 	write capabilities; or for a file that has been opened for synchronous operations (by using the 
 	<codeph class="+ topic/ph pr-d/codeph ">open()</codeph> method), the file cannot be written (for example, because the file is missing).
 	
-	</apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">IOError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.errors:IOError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">value</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">A Boolean value determining which byte is written. If the parameter is <codeph class="+ topic/ph pr-d/codeph ">true</codeph>, 
+	</apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">IOError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.errors:IOError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">value</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">A Boolean value determining which byte is written. If the parameter is <codeph class="+ topic/ph pr-d/codeph ">true</codeph>,
      1 is written; if <codeph class="+ topic/ph pr-d/codeph ">false</codeph>, 0 is written.
      
      </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
@@ -571,7 +571,7 @@ function fileClosed(event:Event):void {
 	
      Writes a sequence of bytes from the
      specified byte array, bytes,
-     starting at the byte specified by offset 
+     starting at the byte specified by offset
      (using a zero-based index)
      with a length specified by length,
      into the file stream, byte stream, or byte array.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">The file has not been opened; the file has been opened, but it was not opened with
@@ -586,7 +586,7 @@ function fileClosed(event:Event):void {
 	
      Writes a sequence of bytes from the
      specified byte array, <codeph class="+ topic/ph pr-d/codeph ">bytes</codeph>,
-     starting at the byte specified by <codeph class="+ topic/ph pr-d/codeph ">offset</codeph> 
+     starting at the byte specified by <codeph class="+ topic/ph pr-d/codeph ">offset</codeph>
      (using a zero-based index)
      with a length specified by <codeph class="+ topic/ph pr-d/codeph ">length</codeph>,
      into the file stream, byte stream, or byte array.
@@ -658,10 +658,10 @@ function fileClosed(event:Event):void {
 	</apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">IOError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.errors:IOError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">value</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">The string value to be written.
      </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">charSet</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">The string denoting the character set to use. Possible character set strings
      include <codeph class="+ topic/ph pr-d/codeph ">"shift-jis"</codeph>, <codeph class="+ topic/ph pr-d/codeph ">"cn-gb"</codeph>, <codeph class="+ topic/ph pr-d/codeph ">"iso-8859-1"</codeph>, and others.
-     For a complete list, see <xref href="../../charset-codes.html" class="- topic/xref ">Supported Character Sets</xref>. 
+     For a complete list, see <xref href="../../charset-codes.html" class="- topic/xref ">Supported Character Sets</xref>.
      </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
 	
-     Writes a multibyte string to the file stream, byte stream, or byte array, using the specified character set. 
+     Writes a multibyte string to the file stream, byte stream, or byte array, using the specified character set.
      
      </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.filesystem.xml#File/systemCharset" class="- topic/link "><linktext class="- topic/linktext ">File.systemCharset</linktext></link></related-links><adobeApiEvent id="flash.filesystem:FileStream:writeMultiByte_ioError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">ioError</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEv
 entClassifier ">flash.events:IOErrorEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">You cannot write to the file (for example, because the file is missing). 
 	This event is dispatched only for files that have been opened for asynchronous operations (by using the 
@@ -694,7 +694,7 @@ function fileClosed(event:Event):void {
      
      </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
 	
-     Writes a 16-bit integer. The low 16 bits of the parameter are used; 
+     Writes a 16-bit integer. The low 16 bits of the parameter are used;
      the high 16 bits are ignored.
      </apiDesc></apiOperationDetail><adobeApiEvent id="flash.filesystem:FileStream:writeShort_ioError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">ioError</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:IOErrorEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="
 - topic/section reference/section apiRef/apiDesc ">You cannot write to the file (for example, because the file is missing). 
 	This event is dispatched only for files that have been opened for asynchronous operations (by using the 
@@ -729,8 +729,8 @@ function fileClosed(event:Event):void {
      
      </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
 	
-     Writes a UTF-8 string to the file stream, byte stream, or byte array. The length of the UTF-8 string in bytes 
-     is written first, as a 16-bit integer, followed by the bytes representing the 
+     Writes a UTF-8 string to the file stream, byte stream, or byte array. The length of the UTF-8 string in bytes
+     is written first, as a 16-bit integer, followed by the bytes representing the
      characters of the string.
      </apiDesc></apiOperationDetail><adobeApiEvent id="flash.filesystem:FileStream:writeUTF_ioError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">ioError</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:IOErrorEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- 
 topic/section reference/section apiRef/apiDesc ">You cannot write to the file (for example, because the file is missing). 
 	This event is dispatched only for files that have been opened for asynchronous operations (by using the 
@@ -763,10 +763,10 @@ function fileClosed(event:Event):void {
      it with one of the read methods.
      </apiDesc><example conref="examples\FileStream.bytesAvailable.1.as" class="- topic/example "/></apiValueDetail></apiValue><apiValue id="flash.filesystem:FileStream:endian:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">endian</apiName><shortdesc class="- topic/shortdesc ">
 	
-     The byte order for the data, either the BIG_ENDIAN or LITTLE_ENDIAN constant 
+     The byte order for the data, either the BIG_ENDIAN or LITTLE_ENDIAN constant
      from the Endian class.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRe
 f/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
 	
-     The byte order for the data, either the <codeph class="+ topic/ph pr-d/codeph ">BIG_ENDIAN</codeph> or <codeph class="+ topic/ph pr-d/codeph ">LITTLE_ENDIAN</codeph> constant 
+     The byte order for the data, either the <codeph class="+ topic/ph pr-d/codeph ">BIG_ENDIAN</codeph> or <codeph class="+ topic/ph pr-d/codeph ">LITTLE_ENDIAN</codeph> constant
      from the Endian class.
      
      </apiDesc></apiValueDetail></apiValue><apiValue id="flash.filesystem:FileStream:objectEncoding:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">objectEncoding</apiName><shortdesc class="- topic/shortdesc ">

Modified: incubator/flex/whiteboard/cframpton/adobe.next/frameworks/projects/playerglobal/bundles/en_US/docs/flash.filters.xml
URL: http://svn.apache.org/viewvc/incubator/flex/whiteboard/cframpton/adobe.next/frameworks/projects/playerglobal/bundles/en_US/docs/flash.filters.xml?rev=1370028&r1=1370027&r2=1370028&view=diff
==============================================================================
--- incubator/flex/whiteboard/cframpton/adobe.next/frameworks/projects/playerglobal/bundles/en_US/docs/flash.filters.xml (original)
+++ incubator/flex/whiteboard/cframpton/adobe.next/frameworks/projects/playerglobal/bundles/en_US/docs/flash.filters.xml Mon Aug  6 21:25:54 2012
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="UTF-8"?><apiPackage xmlns:ditaarch="http://dita.oasis-open.org/architecture/2005/" id="flash.filters" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiPackage/apiPackage "><apiName class="- topic/title reference/title apiRef/apiName ">flash.filters</apiName><apiDetail class="- topic/body reference/refbody apiRef/apiDetail "/><apiClassifier languages="" id="flash.filters:GradientGlowFilter" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">GradientGlowFilter</apiName><shortdesc class="- topic/shortdesc ">
+<?xml version="1.0" encoding="UTF-8"?><apiPackage xmlns:ditaarch="http://dita.oasis-open.org/architecture/2005/" id="flash.filters" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiPackage/apiPackage "><apiName class="- topic/title reference/title apiRef/apiName ">flash.filters</apiName><apiDetail class="- topic/body reference/refbody apiRef/apiDetail "/><apiClassifier languages="" id="flash.filters:ColorMatrixFilter" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">ColorMatrixFilter</apiName><shortdesc class="- topic/shortdesc ">
 <!--
 
   Licensed to the Apache Software Foundation (ASF) under one or more
@@ -17,6 +17,245 @@
   limitations under the License.
 
 -->
+The ColorMatrixFilter class lets you apply a 4 x 5 matrix transformation on the RGBA color and alpha values
+of every pixel in the input image to produce a result with a new set of RGBA color and alpha values.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiTipTexts><
 apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Applies a color matrix transformation on the color and alpha transparency values of each pixel.
+</apiTipText></apiTipTexts><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">flash.filters:BitmapFilter</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
+The ColorMatrixFilter class lets you apply a 4 x 5 matrix transformation on the RGBA color and alpha values
+of every pixel in the input image to produce a result with a new set of RGBA color and alpha values.
+It allows saturation changes, hue rotation, luminance to alpha, and various other effects.
+You can apply the filter to any display object (that is, objects that inherit from the DisplayObject class),
+such as MovieClip, SimpleButton, TextField, and Video objects, as well as to BitmapData objects.
+
+<p class="- topic/p "><b class="+ topic/ph hi-d/b ">Note:</b> For RGBA values, the most significant byte represents the red channel value, 
+followed by green, blue, and then alpha.</p>
+
+<p class="- topic/p ">To create a new color matrix filter, use the syntax <codeph class="+ topic/ph pr-d/codeph ">new ColorMatrixFilter()</codeph>. 
+The use of filters depends on the object to which you apply the filter:</p>
+<ul class="- topic/ul "><li class="- topic/li ">To apply filters to movie clips, text fields, buttons, and video, use the
+<codeph class="+ topic/ph pr-d/codeph ">filters</codeph> property (inherited from DisplayObject). Setting the <codeph class="+ topic/ph pr-d/codeph ">filters</codeph>
+property of an object does not modify the object, and you can remove the filter by clearing the
+<codeph class="+ topic/ph pr-d/codeph ">filters</codeph> property. </li><li class="- topic/li ">To apply filters to BitmapData objects, use the <codeph class="+ topic/ph pr-d/codeph ">BitmapData.applyFilter()</codeph> method.
+Calling <codeph class="+ topic/ph pr-d/codeph ">applyFilter()</codeph> on a BitmapData object takes the source BitmapData object
+and the filter object and generates a filtered image as a result.</li></ul>
+
+<p class="- topic/p ">If you apply a filter to a display object, the <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> property of the
+display object is set to <codeph class="+ topic/ph pr-d/codeph ">true</codeph>. If you remove all filters, the original value of
+<codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> is restored.</p>
+
+<p class="- topic/p ">A filter is not applied if the resulting image exceeds the maximum dimensions.
+In  AIR 1.5 and Flash Player 10, the maximum is 8,191 pixels in width or height, 
+and the total number of pixels cannot exceed 16,777,215 pixels. (So, if an image is 8,191 pixels 
+wide, it can only be 2,048 pixels high.) In Flash Player 9 and earlier and AIR 1.1 and earlier, 
+the limitation is  2,880 pixels in height and 2,880 pixels in width.
+For example, if you zoom in on a large movie clip with a filter applied, the
+filter is turned off if the resulting image reaches the maximum dimensions.</p>
+
+</apiDesc><example conref="examples\ColorMatrixFilterExample.as" class="- topic/example "> The following example applies different color matrix filters to
+ an image file. The filter constructor calls
+ <codeph class="+ topic/ph pr-d/codeph ">buildChild()</codeph> four times to load and display four instances of the image.
+ The first call to <codeph class="+ topic/ph pr-d/codeph ">buildChild()</codeph> takes <codeph class="+ topic/ph pr-d/codeph ">null</codeph> as an argument,
+ applying no filter to the first instance. Each subsequent call to <codeph class="+ topic/ph pr-d/codeph ">buildChild()</codeph>
+ takes as an argument a function that applies a different color matrix filter to each 
+ subsequent instance of the image.
+ <p class="- topic/p ">The <codeph class="+ topic/ph pr-d/codeph ">buildChild()</codeph> function creates a new Loader object named
+ <codeph class="+ topic/ph pr-d/codeph ">loader</codeph>. For each call to <codeph class="+ topic/ph pr-d/codeph ">buildChild()</codeph>, 
+ attach an event listener to the Loader object to listen for <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> events,
+ which are handled by the function passed to <codeph class="+ topic/ph pr-d/codeph ">buildChild()</codeph>.</p>
+ 
+ <p class="- topic/p ">The <codeph class="+ topic/ph pr-d/codeph ">applyRed()</codeph>, <codeph class="+ topic/ph pr-d/codeph ">applyGreen()</codeph>, and <codeph class="+ topic/ph pr-d/codeph ">applyBlue()</codeph>
+ functions use different values for the <codeph class="+ topic/ph pr-d/codeph ">matrix</codeph> array to achieve different
+ effects.</p>
+ <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Note</b>: For best results, use an image approximately 80 pixels in width.
+ The name and location of the image file should match the value you pass to the 
+ <codeph class="+ topic/ph pr-d/codeph ">url</codeph> property. For example, the value passed to <codeph class="+ topic/ph pr-d/codeph ">url</codeph> in the example
+ points to an image file named "Image.jpg" that is in the same directory as your SWF file.
+ </p>
+ <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
+
+package {
+    import flash.display.DisplayObject;
+    import flash.display.Loader;
+    import flash.display.Sprite;
+    import flash.events.Event;
+    import flash.events.IOErrorEvent;
+    import flash.filters.ColorMatrixFilter;
+    import flash.net.URLRequest;
+
+    public class ColorMatrixFilterExample extends Sprite {
+        private var size:uint  = 140;
+        private var url:String = "Image.jpg";
+
+        public function ColorMatrixFilterExample() {
+            buildChild(null);
+            buildChild(applyRed);
+            buildChild(applyGreen);
+            buildChild(applyBlue);
+        }
+
+        private function buildChild(loadHandler:Function):void {
+            var loader:Loader = new Loader();
+            loader.x = numChildren * size;
+            loader.y = size;
+            loader.contentLoaderInfo.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
+            if (loadHandler != null) {
+                loader.contentLoaderInfo.addEventListener(Event.COMPLETE, loadHandler);
+            }
+
+            var request:URLRequest = new URLRequest(url);
+            loader.load(request);
+            addChild(loader);
+        }
+
+        private function applyRed(event:Event):void {
+            var child:DisplayObject = DisplayObject(event.target.loader);
+            var matrix:Array = new Array();
+            matrix = matrix.concat([1, 0, 0, 0, 0]); // red
+            matrix = matrix.concat([0, 0, 0, 0, 0]); // green
+            matrix = matrix.concat([0, 0, 0, 0, 0]); // blue
+            matrix = matrix.concat([0, 0, 0, 1, 0]); // alpha
+
+            applyFilter(child, matrix);
+        }
+
+        private function applyGreen(event:Event):void {
+            var child:DisplayObject = DisplayObject(event.target.loader);
+            var matrix:Array = new Array();
+            matrix = matrix.concat([0, 0, 0, 0, 0]); // red
+            matrix = matrix.concat([0, 1, 0, 0, 0]); // green
+            matrix = matrix.concat([0, 0, 0, 0, 0]); // blue
+            matrix = matrix.concat([0, 0, 0, 1, 0]); // alpha
+
+            applyFilter(child, matrix);
+        }
+
+        private function applyBlue(event:Event):void {
+            var child:DisplayObject = DisplayObject(event.target.loader);
+            var matrix:Array = new Array();
+            matrix = matrix.concat([0, 0, 0, 0, 0]); // red
+            matrix = matrix.concat([0, 0, 0, 0, 0]); // green
+            matrix = matrix.concat([0, 0, 1, 0, 0]); // blue
+            matrix = matrix.concat([0, 0, 0, 1, 0]); // alpha
+
+            applyFilter(child, matrix);
+        }
+
+        private function applyFilter(child:DisplayObject, matrix:Array):void {
+            var filter:ColorMatrixFilter = new ColorMatrixFilter(matrix);
+            var filters:Array = new Array();
+            filters.push(filter);
+            child.filters = filters;
+        }
+        
+        private function ioErrorHandler(event:IOErrorEvent):void {
+            trace("Unable to load image: " + url);
+        }
+    }
+}
+</codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="flash.display.xml#BitmapData/getPixel()" class="- topic/link "><linktext class="- topic/linktext ">flash.display.BitmapData.getPixel()</linktext></link><link href="flash.display.xml#BitmapData/applyFilter()" class="- topic/link "><linktext class="- topic/linktext ">flash.display.BitmapData.applyFilter()</linktext></link><link href="flash.display.xml#DisplayObject/filters" class="- topic/link "><linktext class="- topic/linktext ">flash.display.DisplayObject.filters</linktext></link><link href="flash.display.xml#DisplayObject/cacheAsBitmap" class="- topic/link "><linktext class="- topic/linktext ">flash.display.DisplayObject.cacheAsBitmap</linktext></link></related-links><apiConstructor id="flash.filters:ColorMatrixFilter:ColorMatrixFilter" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (top
 ic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">ColorMatrixFilter</apiName><shortdesc class="- topic/shortdesc ">
+	Initializes a new ColorMatrixFilter instance with the specified parameters.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">matrix</apiItemName><apiOperati
 onClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Array</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">An array of 20 items arranged as a 4 x 5 matrix.
+	</apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Initializes a new ColorMatrixFilter instance.
+	
+	</apiTipText></apiTipTexts></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
+	Initializes a new ColorMatrixFilter instance with the specified parameters.
+	
+	</apiDesc></apiConstructorDetail></apiConstructor><apiOperation id="flash.filters:ColorMatrixFilter:clone" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">clone</apiName><shortdesc class="- topic/shortdesc ">
+	Returns a copy of this filter object.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><maelexample>The following example creates a new ColorMatrixFilter instance and then
+ 	clones it using the <code>clone</code> method. The <code>matrix</code> property cannot be changed directly (for example,
+	<code>clonedFilter.matrix[2] = 1;</code>). Instead, you must get a reference
+	to the array, make the change, and reset the value using
+	<code>clonedFilter.matrix = changedMatrix</code>.
+	<listing version="2.0">
+	import flash.filters.ColorMatrixFilter;
+	
+	var matrix:Array = new Array();
+	matrix = matrix.concat([1, 0, 0, 0, 0]); // red
+	matrix = matrix.concat([0, 1, 0, 0, 0]); // green
+	matrix = matrix.concat([0, 0, 1, 0, 0]); // blue
+	matrix = matrix.concat([0, 0, 0, 1, 0]); // alpha
+	
+	var filter:ColorMatrixFilter = new ColorMatrixFilter(matrix);
+	trace("filter:       " + filter.matrix);
+	
+	var clonedFilter:ColorMatrixFilter = filter.clone();
+	matrix = clonedFilter.matrix;
+	matrix[2] = 1;
+	clonedFilter.matrix = matrix;
+	trace("clonedFilter: " + clonedFilter.matrix);
+	</listing>
+
+	</maelexample></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiIsOverride class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiIsOverride "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">A new ColorMatrixFilter instance with all of the same properties as the original
+	one.
+	
+	</apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.filters:BitmapFilter</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
+	Returns a copy of this filter object.
+	
+	</apiDesc></apiOperationDetail></apiOperation><apiValue id="flash.filters:ColorMatrixFilter:matrix:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">matrix</apiName><shortdesc class="- topic/shortdesc ">
+	An array of 20 items for 4 x 5 color transform.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><maelexample>The following example creates a new ColorMatrixFilter instance and then
+  	changes its <code>matrix</code> property. The <code>matrix</code> property cannot be changed by directly modifying
+  	its value (for example, <code>clonedFilter.matrix[2] = 1;</code>). Instead, you must
+  	get a reference to the array, make the change to the reference, and reset the
+	value using <code>clonedFilter.matrix = changedMatrix</code>.
+	<listing version="2.0">
+	import flash.filters.ColorMatrixFilter;
+	
+	var matrix:Array = new Array();
+	matrix = matrix.concat([1, 0, 0, 0, 0]); // red
+	matrix = matrix.concat([0, 1, 0, 0, 0]); // green
+	matrix = matrix.concat([0, 0, 1, 0, 0]); // blue
+	matrix = matrix.concat([0, 0, 0, 1, 0]); // alpha
+	
+	var filter:ColorMatrixFilter = new ColorMatrixFilter(matrix);
+	trace("filter: " + filter.matrix);
+	var changedMatrix:Array = filter.matrix;
+	changedMatrix[2] = 1;
+	filter.matrix = changedMatrix;
+	trace("filter: " + filter.matrix);
+	</listing>
+	</maelexample></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Array</apiValueClassifier><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">The Array is null when being set
+	
+	</apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">TypeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">TypeError</apiOperationClassifier></apiException></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
+	An array of 20 items for 4 x 5 color transform. The <codeph class="+ topic/ph pr-d/codeph ">matrix</codeph> property cannot
+	be changed by directly modifying its value (for example, <codeph class="+ topic/ph pr-d/codeph ">myFilter.matrix[2] = 1;</codeph>).
+	Instead, you must get a reference to the array, make the change to the reference, and reset the
+	value.
+	
+	<p class="- topic/p ">The color matrix filter separates each source pixel into its red, green, blue,
+	and alpha components as srcR, srcG, srcB, srcA. To calculate the result of each of
+	the four channels, the value of each pixel in the image is multiplied by the values in
+	the transformation matrix. An offset, between -255 and 255, can optionally be added
+	to each result (the fifth item in each row of the matrix). The filter combines each 
+	color component back into a single pixel and writes out the result. In the following formula,
+	a[0] through a[19] correspond to entries 0 through 19 in the 20-item array that is
+	passed to the <codeph class="+ topic/ph pr-d/codeph ">matrix</codeph> property:</p>
+	<pre xml:space="preserve" class="- topic/pre ">
+	redResult   = (a[0]  ~~ srcR) + (a[1]  ~~ srcG) + (a[2]  ~~ srcB) + (a[3]  ~~ srcA) + a[4]
+	greenResult = (a[5]  ~~ srcR) + (a[6]  ~~ srcG) + (a[7]  ~~ srcB) + (a[8]  ~~ srcA) + a[9]
+	blueResult  = (a[10] ~~ srcR) + (a[11] ~~ srcG) + (a[12] ~~ srcB) + (a[13] ~~ srcA) + a[14]
+	alphaResult = (a[15] ~~ srcR) + (a[16] ~~ srcG) + (a[17] ~~ srcB) + (a[18] ~~ srcA) + a[19]
+	</pre>
+	
+	<p class="- topic/p ">For each color value in the array, a value of 1 is equal to 100% of that channel 
+	being sent to the output, preserving the value of the color channel.</p>
+	
+	<p class="- topic/p ">The calculations are performed on unmultiplied color values. If the input graphic consists
+	of premultiplied color values, those values are automatically converted into unmultiplied color
+	values for this operation.</p>
+	
+	<p class="- topic/p ">Two optimized modes are available:</p>
+	
+	<p class="- topic/p "><b class="+ topic/ph hi-d/b ">Alpha only.</b> When you pass to the filter a matrix that adjusts only the alpha component, as shown here, the filter optimizes its performance:</p>
+	<pre xml:space="preserve" class="- topic/pre ">
+	    1 0 0 0 0
+	    0 1 0 0 0
+	    0 0 1 0 0
+	    0 0 0 N 0  (where N is between 0.0 and 1.0)
+	</pre>
+	
+	<p class="- topic/p "><b class="+ topic/ph hi-d/b ">Faster version</b>. Available only with SSE/AltiVec accelerator-enabled processors,
+	such as Intel<sup class="+ topic/ph hi-d/sup ">®</sup> Pentium<sup class="+ topic/ph hi-d/sup ">®</sup> 3 and later and Apple<sup class="+ topic/ph hi-d/sup ">®</sup> G4 and later. The accelerator is used when the multiplier terms are in the range
+	-15.99 to 15.99 and the adder terms a[4], a[9], a[14], and a[19] are in the range -8000 to 8000.</p>
+	
+	</apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="flash.filters:GradientGlowFilter" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">GradientGlowFilter</apiName><shortdesc class="- topic/shortdesc ">
  The GradientGlowFilter class lets you apply a gradient glow effect to display objects.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiTipTexts><apiTipText cl
 ass="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Lets you create a gradient glow effect.
  </apiTipText></apiTipTexts><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">flash.filters:BitmapFilter</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  The GradientGlowFilter class lets you apply a gradient glow effect to display objects.
@@ -761,245 +1000,6 @@ package {
 	The placement of the filter effect. Possible values are flash.filters.BitmapFilterType constants:
 	<ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">BitmapFilterType.OUTER</codeph> — Glow on the outer edge of the object</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">BitmapFilterType.INNER</codeph> — Glow on the inner edge of the object; the default.</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">BitmapFilterType.FULL</codeph> — Glow on top of the object</li></ul>
 	
-	</apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="flash.filters:ColorMatrixFilter" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">ColorMatrixFilter</apiName><shortdesc class="- topic/shortdesc ">
-The ColorMatrixFilter class lets you apply a 4 x 5 matrix transformation on the RGBA color and alpha values
-of every pixel in the input image to produce a result with a new set of RGBA color and alpha values.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiTipTexts><
 apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Applies a color matrix transformation on the color and alpha transparency values of each pixel.
-</apiTipText></apiTipTexts><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">flash.filters:BitmapFilter</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
-The ColorMatrixFilter class lets you apply a 4 x 5 matrix transformation on the RGBA color and alpha values
-of every pixel in the input image to produce a result with a new set of RGBA color and alpha values.
-It allows saturation changes, hue rotation, luminance to alpha, and various other effects.
-You can apply the filter to any display object (that is, objects that inherit from the DisplayObject class),
-such as MovieClip, SimpleButton, TextField, and Video objects, as well as to BitmapData objects.
-
-<p class="- topic/p "><b class="+ topic/ph hi-d/b ">Note:</b> For RGBA values, the most significant byte represents the red channel value, 
-followed by green, blue, and then alpha.</p>
-
-<p class="- topic/p ">To create a new color matrix filter, use the syntax <codeph class="+ topic/ph pr-d/codeph ">new ColorMatrixFilter()</codeph>. 
-The use of filters depends on the object to which you apply the filter:</p>
-<ul class="- topic/ul "><li class="- topic/li ">To apply filters to movie clips, text fields, buttons, and video, use the
-<codeph class="+ topic/ph pr-d/codeph ">filters</codeph> property (inherited from DisplayObject). Setting the <codeph class="+ topic/ph pr-d/codeph ">filters</codeph>
-property of an object does not modify the object, and you can remove the filter by clearing the
-<codeph class="+ topic/ph pr-d/codeph ">filters</codeph> property. </li><li class="- topic/li ">To apply filters to BitmapData objects, use the <codeph class="+ topic/ph pr-d/codeph ">BitmapData.applyFilter()</codeph> method.
-Calling <codeph class="+ topic/ph pr-d/codeph ">applyFilter()</codeph> on a BitmapData object takes the source BitmapData object
-and the filter object and generates a filtered image as a result.</li></ul>
-
-<p class="- topic/p ">If you apply a filter to a display object, the <codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> property of the
-display object is set to <codeph class="+ topic/ph pr-d/codeph ">true</codeph>. If you remove all filters, the original value of
-<codeph class="+ topic/ph pr-d/codeph ">cacheAsBitmap</codeph> is restored.</p>
-
-<p class="- topic/p ">A filter is not applied if the resulting image exceeds the maximum dimensions.
-In  AIR 1.5 and Flash Player 10, the maximum is 8,191 pixels in width or height, 
-and the total number of pixels cannot exceed 16,777,215 pixels. (So, if an image is 8,191 pixels 
-wide, it can only be 2,048 pixels high.) In Flash Player 9 and earlier and AIR 1.1 and earlier, 
-the limitation is  2,880 pixels in height and 2,880 pixels in width.
-For example, if you zoom in on a large movie clip with a filter applied, the
-filter is turned off if the resulting image reaches the maximum dimensions.</p>
-
-</apiDesc><example conref="examples\ColorMatrixFilterExample.as" class="- topic/example "> The following example applies different color matrix filters to
- an image file. The filter constructor calls
- <codeph class="+ topic/ph pr-d/codeph ">buildChild()</codeph> four times to load and display four instances of the image.
- The first call to <codeph class="+ topic/ph pr-d/codeph ">buildChild()</codeph> takes <codeph class="+ topic/ph pr-d/codeph ">null</codeph> as an argument,
- applying no filter to the first instance. Each subsequent call to <codeph class="+ topic/ph pr-d/codeph ">buildChild()</codeph>
- takes as an argument a function that applies a different color matrix filter to each 
- subsequent instance of the image.
- <p class="- topic/p ">The <codeph class="+ topic/ph pr-d/codeph ">buildChild()</codeph> function creates a new Loader object named
- <codeph class="+ topic/ph pr-d/codeph ">loader</codeph>. For each call to <codeph class="+ topic/ph pr-d/codeph ">buildChild()</codeph>, 
- attach an event listener to the Loader object to listen for <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> events,
- which are handled by the function passed to <codeph class="+ topic/ph pr-d/codeph ">buildChild()</codeph>.</p>
- 
- <p class="- topic/p ">The <codeph class="+ topic/ph pr-d/codeph ">applyRed()</codeph>, <codeph class="+ topic/ph pr-d/codeph ">applyGreen()</codeph>, and <codeph class="+ topic/ph pr-d/codeph ">applyBlue()</codeph>
- functions use different values for the <codeph class="+ topic/ph pr-d/codeph ">matrix</codeph> array to achieve different
- effects.</p>
- <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Note</b>: For best results, use an image approximately 80 pixels in width.
- The name and location of the image file should match the value you pass to the 
- <codeph class="+ topic/ph pr-d/codeph ">url</codeph> property. For example, the value passed to <codeph class="+ topic/ph pr-d/codeph ">url</codeph> in the example
- points to an image file named "Image.jpg" that is in the same directory as your SWF file.
- </p>
- <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
-
-package {
-    import flash.display.DisplayObject;
-    import flash.display.Loader;
-    import flash.display.Sprite;
-    import flash.events.Event;
-    import flash.events.IOErrorEvent;
-    import flash.filters.ColorMatrixFilter;
-    import flash.net.URLRequest;
-
-    public class ColorMatrixFilterExample extends Sprite {
-        private var size:uint  = 140;
-        private var url:String = "Image.jpg";
-
-        public function ColorMatrixFilterExample() {
-            buildChild(null);
-            buildChild(applyRed);
-            buildChild(applyGreen);
-            buildChild(applyBlue);
-        }
-
-        private function buildChild(loadHandler:Function):void {
-            var loader:Loader = new Loader();
-            loader.x = numChildren * size;
-            loader.y = size;
-            loader.contentLoaderInfo.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
-            if (loadHandler != null) {
-                loader.contentLoaderInfo.addEventListener(Event.COMPLETE, loadHandler);
-            }
-
-            var request:URLRequest = new URLRequest(url);
-            loader.load(request);
-            addChild(loader);
-        }
-
-        private function applyRed(event:Event):void {
-            var child:DisplayObject = DisplayObject(event.target.loader);
-            var matrix:Array = new Array();
-            matrix = matrix.concat([1, 0, 0, 0, 0]); // red
-            matrix = matrix.concat([0, 0, 0, 0, 0]); // green
-            matrix = matrix.concat([0, 0, 0, 0, 0]); // blue
-            matrix = matrix.concat([0, 0, 0, 1, 0]); // alpha
-
-            applyFilter(child, matrix);
-        }
-
-        private function applyGreen(event:Event):void {
-            var child:DisplayObject = DisplayObject(event.target.loader);
-            var matrix:Array = new Array();
-            matrix = matrix.concat([0, 0, 0, 0, 0]); // red
-            matrix = matrix.concat([0, 1, 0, 0, 0]); // green
-            matrix = matrix.concat([0, 0, 0, 0, 0]); // blue
-            matrix = matrix.concat([0, 0, 0, 1, 0]); // alpha
-
-            applyFilter(child, matrix);
-        }
-
-        private function applyBlue(event:Event):void {
-            var child:DisplayObject = DisplayObject(event.target.loader);
-            var matrix:Array = new Array();
-            matrix = matrix.concat([0, 0, 0, 0, 0]); // red
-            matrix = matrix.concat([0, 0, 0, 0, 0]); // green
-            matrix = matrix.concat([0, 0, 1, 0, 0]); // blue
-            matrix = matrix.concat([0, 0, 0, 1, 0]); // alpha
-
-            applyFilter(child, matrix);
-        }
-
-        private function applyFilter(child:DisplayObject, matrix:Array):void {
-            var filter:ColorMatrixFilter = new ColorMatrixFilter(matrix);
-            var filters:Array = new Array();
-            filters.push(filter);
-            child.filters = filters;
-        }
-        
-        private function ioErrorHandler(event:IOErrorEvent):void {
-            trace("Unable to load image: " + url);
-        }
-    }
-}
-</codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="flash.display.xml#BitmapData/getPixel()" class="- topic/link "><linktext class="- topic/linktext ">flash.display.BitmapData.getPixel()</linktext></link><link href="flash.display.xml#BitmapData/applyFilter()" class="- topic/link "><linktext class="- topic/linktext ">flash.display.BitmapData.applyFilter()</linktext></link><link href="flash.display.xml#DisplayObject/filters" class="- topic/link "><linktext class="- topic/linktext ">flash.display.DisplayObject.filters</linktext></link><link href="flash.display.xml#DisplayObject/cacheAsBitmap" class="- topic/link "><linktext class="- topic/linktext ">flash.display.DisplayObject.cacheAsBitmap</linktext></link></related-links><apiConstructor id="flash.filters:ColorMatrixFilter:ColorMatrixFilter" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (top
 ic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">ColorMatrixFilter</apiName><shortdesc class="- topic/shortdesc ">
-	Initializes a new ColorMatrixFilter instance with the specified parameters.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">matrix</apiItemName><apiOperati
 onClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Array</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">An array of 20 items arranged as a 4 x 5 matrix.
-	</apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Initializes a new ColorMatrixFilter instance.
-	
-	</apiTipText></apiTipTexts></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
-	Initializes a new ColorMatrixFilter instance with the specified parameters.
-	
-	</apiDesc></apiConstructorDetail></apiConstructor><apiOperation id="flash.filters:ColorMatrixFilter:clone" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">clone</apiName><shortdesc class="- topic/shortdesc ">
-	Returns a copy of this filter object.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><maelexample>The following example creates a new ColorMatrixFilter instance and then
- 	clones it using the <code>clone</code> method. The <code>matrix</code> property cannot be changed directly (for example,
-	<code>clonedFilter.matrix[2] = 1;</code>). Instead, you must get a reference
-	to the array, make the change, and reset the value using
-	<code>clonedFilter.matrix = changedMatrix</code>.
-	<listing version="2.0">
-	import flash.filters.ColorMatrixFilter;
-	
-	var matrix:Array = new Array();
-	matrix = matrix.concat([1, 0, 0, 0, 0]); // red
-	matrix = matrix.concat([0, 1, 0, 0, 0]); // green
-	matrix = matrix.concat([0, 0, 1, 0, 0]); // blue
-	matrix = matrix.concat([0, 0, 0, 1, 0]); // alpha
-	
-	var filter:ColorMatrixFilter = new ColorMatrixFilter(matrix);
-	trace("filter:       " + filter.matrix);
-	
-	var clonedFilter:ColorMatrixFilter = filter.clone();
-	matrix = clonedFilter.matrix;
-	matrix[2] = 1;
-	clonedFilter.matrix = matrix;
-	trace("clonedFilter: " + clonedFilter.matrix);
-	</listing>
-
-	</maelexample></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiIsOverride class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiIsOverride "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">A new ColorMatrixFilter instance with all of the same properties as the original
-	one.
-	
-	</apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.filters:BitmapFilter</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
-	Returns a copy of this filter object.
-	
-	</apiDesc></apiOperationDetail></apiOperation><apiValue id="flash.filters:ColorMatrixFilter:matrix:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">matrix</apiName><shortdesc class="- topic/shortdesc ">
-	An array of 20 items for 4 x 5 color transform.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><maelexample>The following example creates a new ColorMatrixFilter instance and then
-  	changes its <code>matrix</code> property. The <code>matrix</code> property cannot be changed by directly modifying
-  	its value (for example, <code>clonedFilter.matrix[2] = 1;</code>). Instead, you must
-  	get a reference to the array, make the change to the reference, and reset the
-	value using <code>clonedFilter.matrix = changedMatrix</code>.
-	<listing version="2.0">
-	import flash.filters.ColorMatrixFilter;
-	
-	var matrix:Array = new Array();
-	matrix = matrix.concat([1, 0, 0, 0, 0]); // red
-	matrix = matrix.concat([0, 1, 0, 0, 0]); // green
-	matrix = matrix.concat([0, 0, 1, 0, 0]); // blue
-	matrix = matrix.concat([0, 0, 0, 1, 0]); // alpha
-	
-	var filter:ColorMatrixFilter = new ColorMatrixFilter(matrix);
-	trace("filter: " + filter.matrix);
-	var changedMatrix:Array = filter.matrix;
-	changedMatrix[2] = 1;
-	filter.matrix = changedMatrix;
-	trace("filter: " + filter.matrix);
-	</listing>
-	</maelexample></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Array</apiValueClassifier><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">The Array is null when being set
-	
-	</apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">TypeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">TypeError</apiOperationClassifier></apiException></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
-	An array of 20 items for 4 x 5 color transform. The <codeph class="+ topic/ph pr-d/codeph ">matrix</codeph> property cannot
-	be changed by directly modifying its value (for example, <codeph class="+ topic/ph pr-d/codeph ">myFilter.matrix[2] = 1;</codeph>).
-	Instead, you must get a reference to the array, make the change to the reference, and reset the
-	value.
-	
-	<p class="- topic/p ">The color matrix filter separates each source pixel into its red, green, blue,
-	and alpha components as srcR, srcG, srcB, srcA. To calculate the result of each of
-	the four channels, the value of each pixel in the image is multiplied by the values in
-	the transformation matrix. An offset, between -255 and 255, can optionally be added
-	to each result (the fifth item in each row of the matrix). The filter combines each 
-	color component back into a single pixel and writes out the result. In the following formula,
-	a[0] through a[19] correspond to entries 0 through 19 in the 20-item array that is
-	passed to the <codeph class="+ topic/ph pr-d/codeph ">matrix</codeph> property:</p>
-	<pre xml:space="preserve" class="- topic/pre ">
-	redResult   = (a[0]  ~~ srcR) + (a[1]  ~~ srcG) + (a[2]  ~~ srcB) + (a[3]  ~~ srcA) + a[4]
-	greenResult = (a[5]  ~~ srcR) + (a[6]  ~~ srcG) + (a[7]  ~~ srcB) + (a[8]  ~~ srcA) + a[9]
-	blueResult  = (a[10] ~~ srcR) + (a[11] ~~ srcG) + (a[12] ~~ srcB) + (a[13] ~~ srcA) + a[14]
-	alphaResult = (a[15] ~~ srcR) + (a[16] ~~ srcG) + (a[17] ~~ srcB) + (a[18] ~~ srcA) + a[19]
-	</pre>
-	
-	<p class="- topic/p ">For each color value in the array, a value of 1 is equal to 100% of that channel 
-	being sent to the output, preserving the value of the color channel.</p>
-	
-	<p class="- topic/p ">The calculations are performed on unmultiplied color values. If the input graphic consists
-	of premultiplied color values, those values are automatically converted into unmultiplied color
-	values for this operation.</p>
-	
-	<p class="- topic/p ">Two optimized modes are available:</p>
-	
-	<p class="- topic/p "><b class="+ topic/ph hi-d/b ">Alpha only.</b> When you pass to the filter a matrix that adjusts only the alpha component, as shown here, the filter optimizes its performance:</p>
-	<pre xml:space="preserve" class="- topic/pre ">
-	    1 0 0 0 0
-	    0 1 0 0 0
-	    0 0 1 0 0
-	    0 0 0 N 0  (where N is between 0.0 and 1.0)
-	</pre>
-	
-	<p class="- topic/p "><b class="+ topic/ph hi-d/b ">Faster version</b>. Available only with SSE/AltiVec accelerator-enabled processors,
-	such as Intel<sup class="+ topic/ph hi-d/sup ">®</sup> Pentium<sup class="+ topic/ph hi-d/sup ">®</sup> 3 and later and Apple<sup class="+ topic/ph hi-d/sup ">®</sup> G4 and later. The accelerator is used when the multiplier terms are in the range
-	-15.99 to 15.99 and the adder terms a[4], a[9], a[14], and a[19] are in the range -8000 to 8000.</p>
-	
 	</apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="flash.filters:DisplacementMapFilter" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">DisplacementMapFilter</apiName><shortdesc class="- topic/shortdesc ">
 The DisplacementMapFilter class uses the pixel values from the specified BitmapData object 
 (called the displacement map image) to perform a displacement of an object.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiTipTexts><apiTipText class="+ topic
 /state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Displaces the original object to which the filter is applied.



Mime
View raw message