Март 2011

Подробное описание перечисленных методов можно найти в описании класса BitmapData в справочнике по языку ActionScript корпорации Adobe.

Класс BitmapData также поддерживает различные фильтры, эффекты и операции копирования, которые могут быть использованы для управления пикселами растрового изображения. Дополнительную информацию можно получить далее, в разд. «Копирование графики в объект BitmapData» и «Применение фильтров и эффектов» этой главы.

Изменение размеров растрового изображения

Когда изменяются размеры объекта Bitmap, ссылающегося на объект BitmapData, с помощью переменных scaleX и scaleY или width и height, размеры изображения на экране меняются, однако нижележащий объект BitmapData остается неизменным. Чтобы изменить размер нижележащего объекта BitmapData на самом деле, мы должны произвести его повторную выборку с помощью метода экземпляра draw ( ) класса BitmapData {повторная выборка означает изменение числа пикселов в изображении). Общая методика выглядит следующим образом.

1. Получить ссылку на исходный объект BitmapData.

2. Нарисовать масштабированную версию исходного объекта BitmapData в новом объекте BitmapData.

3. Наконец, связать исходный объект Bitmap с новым, масштабированным объектом BitmapData.

Перечисленные шаги продемонстрированы в листинге 26.7.

Листинг 26.7. Повторная выборка растрового изображения

// Получаем временную ссылку на исходный объект BitmapData var originalBitmapData:BitmapData = originalBitmap. bitmapData;

// Устанавливаем величину, которая будет определять коэффициент // масштабирования растрового изображения var scaleFactonNumber = .5:

// Вычисляем новые размеры масштабированного растрового изображения var newWidth:int = originalBitmapData. width * scaleFactor, var newHeight;int = originalBitmapData. height * scaleFactor;

// Создаем новый объект BitmapData, размеры которого позволят уместить // масштабированное растровое изображение

var scaledBitmapData:BitmapData = new BitmapData(newWidth, newHeight,

ori gi nalBitmapData. transparent);

// Создаем матрицу преобразований, с помощью которой будет происходить // масштабирование растрового изображения var scaleMatrixiMatrix = new Matrix( ); matrix. scale(scaleFactor, scaleFactor);

// Переносим масштабированное растровое изображение

// в новый объект BitmapData

sealedBi tmapData. draw(ori gi nalBi tmapData, matri x);

// Заменяем исходный объект BitmapData. новым масштабированным объектом BitmapData originalBitmap. bitmapData = scaledBitmapData;

В следующем разделе мы узнаем более подробно о методе draw ( ).

Копирование графики в объект BitmapData

Значения цвета пикселов могут быть скопированы в объект BitmapData из двух источников: другого объекта BitmapData или любого экземпляра DisplayOb j ect.

Чтобы скопировать любой экземпляр класса Di splayOb j ect в объект BitmapData, мы применяем метод draw ( ), который копирует значения цвета из объекта-источника в объект-получатель BitmapData. В процессе копирования пикселы, сохраняемые в объекте BitmapData, могут быть преобразованы, смешаны или сглажены.

Чтобы скопировать значения цвета из другого объекта BitmapData, можно использовать либо метод draw ( ), либо любой из следующих методов класса BitmapData.

? copyPixels ( ) —копирует значения цвета из прямоугольной области пикселов объекта-источника BitmapData в объект-получатель BitmapData. Источ-

ник и получатель могут являться одним объектом, позволяя копировать пикселы из одной области изображения в другую область того же изображения.

? copyChannel ( ) — копирует отдельный цветовой канал из прямоугольной области пикселов объекта-источника BitmapData в объект-получатель BitmapData. Источник и получатель могут являться одним объектом, позволяя копировать пикселы из одной области изображения в другую область того же изображения.

? clone ( ) —создает новый объект BitmapData, дублируя существующий объект BitmapData.

? merge ( ) — смешивает вместе каналы двух объектов BitmapData, создавая новое изображение, в котором одно изображение оказывается наложенным на другое. Объект-источник и объект-получатель BitmapData могут быть одним объектом, позволяя смешивать два канала одного и того же изображения.

В этом разделе мы сосредоточимся на методах draw ( ) ncopyPixels ( ). Дополнительную информацию о других методах копирования можно найти в описании класса BitmapData в справочнике по языку ActionScript корпорации Adobe.

Метод экземпляра draw() класса BitmapData

Метод draw ( ) имеет следующий обобщенный вид:

целевой0бъектВ1tmapData. йгам(источник, матрицаПреобразования, цветовыеПреобразования, режимСмешения, областьОбрезки, сглаживание)

Здесь целевойОбъектВ! tmapData — объект BitmapData, в который будут перенесены пикселы. Параметры метода draw ( ) описаны ниже.

? источник — экземпляр класса DisplayObject или BitmapData, графические данные которого будут перенесены в объект целевой0бъектВ1 tmapData. Это единственный обязательный параметр метода draw ( ). Стоит отметить, что, когда значением параметра источник является объект DisplayObject, при переносе в объект целевой0бъектВ1 tmapData его преобразования не включаются. Тем не менее преобразования объекта источник могут быть включены вручную путем передачи значения переменной источник. transform. matrix в качестве параметра матрицаПреобразований метода draw ( ), а значение переменной ^crovwM. transform. colorTransform — в качестве параметра цветовоеПреобразование метода draw ( ). В качестве альтернативы объект целевойОбъектВ! tmapData может быть связан с объектом BitmapData, переменная экземпляра transform которого ссылается на переменную источник. transform.

? матрицаПреобразования — необязательный объект Matrix, описывающий любое перемещение (то есть изменение позиции), масштабирование, вращение и искажение, которое должно быть применено к пикселам, переносимым в объект целевойОбъектВ! tmapData. Информацию об использовании объекта Matrix для выполнения графических преобразований можно найти в описании класса Matrix в справочнике по языку ActionScript корпорации Adobe и в разделе Programming ActionScript 3.0 > Flash Player APIs > Working With Geometry > Using Matrix objects документации корпорации Adobe. Общий пример матричных преобразований можно найти по адресу http://windowssdk. msdn. microsoft. com/en-us/library/ms536397.aspx и http://www. senocular. com/flash/tutorials/transformmatrix.

Стоит отметить, что гарантировать достаточный размер объекта целевойОбъ-ектЕН tmapData для хранения преобразованного объекта источник должен программист. В интерфейсе API приложения Flash Player 9 не предусмотрено никакой возможности для предварительного получения размера преобразованного объекта источник. Такая возможность может быть включена в будущие версии сред Flash, например, в виде метода generateTransf ormRect ( ) (разработанного после существующего метода generateFilterRect ( ) ). Чтобы отдать свой голос в поддержку подобного метода, посетите страницу http://www. adobe. com/ cfusion/mmform/index. cfm? name=wishform.

? цветовыеПреобразования — необязательный объект ColorTransf orm, описывающий любые цветовые изменения, которые должны быть применены к пикселам, переносимым в объект целевойОбьектВ1tmapData. Цветовые преобразования задаются независимо для каждого цветового канала либо с помощью множителя (числа, на которое умножается существующее значение цветового канала), либо с помощью смещения (числа, которое прибавляется к существующему значению цветового канала), либо с помощью обоих способов. Информацию по использованию объекта ColorTransf orm для выполнения графических преобразований можно найти в описании класса ColorTransformB справочнике по языку ActionScript корпорации Adobe.

? режимСмешения — необязательная константа класса В1 endMode, обозначающая тип смешения, который должен быть применен к пикселам, переносимым в объект целевойОбьектВ1tmapData. Смешение означает использование формул для объединения значений цвета объекта источник с отображаемыми объектами, которые визуально располагаются позади него, обычно с целью создания эффекта наложения. Поддерживаемыми режимами смешения являются BlendMode. MULTIPLY, BlendMode. SCREEN, BlendMode. HARDLIGHT и многие другие, которые знакомы пользователям программы Adobe Photoshop. Реализация режимов смешения в языке ActionScript основывается на стандарте SVG консорциума W3C (описание этого стандарта доступно по адресу http://www. w3.orgДR/2003/WD-SVG12-20030715/#compositing) и исследовании Дженса Грашела (Jens Gruschel), опубликованного по адресу http://www. pegtop. net/delphi/articles/blendmodes. Описание каждого доступного режима смешения и изображения, иллюстрирующие результаты применения этих режимов, можно найти в описании переменной экземпляра blendMode класса DisplayObject в справочнике по языку ActionScript корпорации Adobe.

? областьОбрезки — необязательный объект Rectangle, обозначающий прямоугольную область объекта целевойОбъектВ1 tmapData, в которую будут перенесены графические данные объекта источник.

? сглаживание — необязательный параметр типа Boolean, который обозначает, должно ли выполняться сглаживание растрового изображения во время рисования. Этот параметр оказывает влияние на результат только в том случае, когда объект источник является объектом BitmapData и указанный объект матрицаПреобразования задает параметры масштабирования или вращения. При этом, когда параметру сглаживание присвоено значение true, объект источник отображается в объекте целевойОбъектВ1 tmapData с использованием алгоритма сглаживания растровых изображений языка ActionScript. Когда параметру

сглаживание присвоено значение false, объект источник отображается в объекте целевойОбъектЕН tmapData без сглаживания. Изображение, выводимое с использованием сглаживания, выглядит менее «зазубренным» или «пикселизирован-ным», чем изображение, отображаемое без сглаживания. Это проиллюстрировано на рис. 26.6, где показано небольшое исходное изображение (вверху), которое увеличивается в три раза с помощью объекта Matrix с применением сглаживания (слева) и без применения сглаживания (справа).

Вывод на экран растрового изображения с применением сглаживания занимает больше времени, чем вывод без сглаживания. Чтобы достичь максимально возможной производительности, передавайте в качестве параметра сглаживание значение false; чтобы достичь максимально возможного качества изображения, передавайте в качестве параметра сглаживание значение true. Параметр сглаживание оказывает влияние только на текущую операцию draw ( ); он никак не влияет на применение сглаживания к объекту целевойОбьектВ! tmapData в дальнейшем.

Рис. 26.6. Сглаживание растрового изображения

Метод draw ( ) обычно применяется для:

? объединения нескольких отображаемых объектов в одно растровое изображение;

? растеризации векторного содержимого (то есть преобразования векторов в растровое изображение) с целью применения некоторого эффекта.

Рассмотрим пример каждого случая. Сначала мы создадим две векторные фигуры — прямоугольник и эллипс — и перенесем их в один объект BitmapData. Этот код показан в листинге 26.8.

—

ТА,

Векторные фигуры, переносимые в объект BitmapData, не обязаны находиться в списке отображения. Совершенно нормально создавать векторные объекты, не отображая их JJsV на экране, просто для того, чтобы скопировать эти объекты в растровое изображение (как показано в листингах 26.8 и 26.9).

Листинг 26.8. Отображаемые объекты, объединенные в растровом изображении

// Создаем прямоугольник var rect:Shape = new Shape( ); rect. graphics. begi nFi11(OxFFOOOO); rect. graphi cs. drawRect(0,0,25,50);

// Создаем эллипс var el 1ipse:Shape = new Shape( ); ell ipse. graphics. beginFi11(OxOOOOFF); el 1i pse. graphi cs. drawEl1i pse(0,0,35,25);

// Создаем объект BitmapData. Он будет выступать в роли холста

// для рисования, поэтому мы присваиваем его переменной с именем canvas.

var canvas:BitmapData = new BitmapDatadOO, 100, false, OxFFFFFFFF);

// Переносим векторное изображение прямоугольника на растровое изображение canvas. draw(rect);

// Переносим векторное изображение эллипса на растровое изображение. // Используем матрицу преобразования, чтобы поместить эллипс в точку // с координатой (10, 10) внутри объекта BitmapData. var matrix:Matrix = new Matrix( ); matrix. translatedO, 10); canvas. draw(ellipse, matrix);

// Связываем объект BitmapData с объектом Bitmap, чтобы отобразить его // на экране

var bmp;Bitmap = new Bitmap(canvas); addChild(bmp);

На рис. 26.7 показано растровое изображение, полученное в результате выполнения предыдущего кода, с увеличенным масштабом для более тщательного рассмотрения. Обратите внимание, что среда выполнения Flash сглаживает края эллипса, поэтому он смешивается с существующим прямоугольником.

Сглаживание содержимого, переносимого в объект BitmapData, происходит по отношению к существующему фону в растровом изображении.

Далее мы воспользуемся методом draw ( ) для выполнения растеризации объекта TextField, чтобы можно было применить к нему эффект растворения на уровне пикселов. Этот код представлен в листинге 26.9.

Рис. 26.7. Отображаемые объекты, объединенные в растровом изображении

Листинг 26.9. Растеризация и последующее растворение объекта TextField

package { import flash. display.*; import flash. utils.*; import flash. events.*; import flash. geom.*; import flash. text.*;

public class DissolveText extends Sprite { // Переменные, используемые для эффекта растворения private var randomSeed:int = Math. floor(Math. random( ) * int. MAX_VALUE);

private var destPoint:Point = new Point(0, 0); private var numberOfPixels:int = 10; private var destColor:uint = OxFFOOOOOO;

// Объект, в который будет переноситься текст private var bitmapData.-BitmapData;

// Таймер, используемый для периодического вызова метода pixelDissolve( ) private var t:Timer;

// Конструктор

public function DissolveText ( ) { // Создаем текст

var txt:TextField = new TextField( ); txt. text = «Essential ActionScript 3.0″; txt. autoSize = TextFieldAutoSize. LEFT; txt. textColor = OxFFFFFF;

// Создаем объект BitmapData с размерами, // достаточными для размещения текста

bitmapData = new BitmapData(txt. width, txt. height, false, destColor); // Переносим текст в объект BitmapData bitmapData. draw(txt);

// Связываем объект BitmapData с объектом Bitmap, чтобы отобразить его // на экране

var bitmap:Bitmap = new Bitmap(bitmapData); addChild(bitmap);

// Начинаем периодически вызывать метод pixelDissolve( ) t = new Timer(lO);

t. addEventLi stener(TimerEvent. TIMER, ti merLi stener); t. start( );

}

// Обрабатывает события TimerEvent. TIMER private function timerListener (e:TimerEvent):void { dissolve( );

}

// Выполняет растворение public function dissolve( ):void { // Вызываем метод pixelDissolve( ), чтобы растворить указанное // количество пикселов, и запоминаем возвращенное псевдослучайное // число для следующего раза. Использование возвращаемого // псевдослучайного числа гарантирует плавное растворение. randomSeed = bitmapData. pixelDissolve(bitmapData,

bitmapData. rect,

destPoint,

randomSeed,

numberOfPixels,

destColor);

// Прекращаем растворение, когда все пикселы будут иметь целевой цвет // (то есть когда ширина и высота области, в которой отсутствует // целевой цвет, будут равны 0) var coloredRegion:Rectangle =

bitmapData. getColorBoundsRect(OxFFFFFFFF, destColor, false): if (coloredRegion. width == 0 && coloredRegion. height == 0 ) { t. stop( ):

}

}

}

}

Метод draw ( ) также используется для растеризации векторного содержимого с целью повышения производительности. Например, вспомните простую программу рисования ScribbleAS3, представленную ранее в листинге 26.6. Она рисует точки всякий раз, когда происходит перемещение мыши, но не соединяет нарисованные точки линиями. Одним из способов соединить точки является использование метода экземпляра 1 ineTo ( ) класса Graphics, который рисует векторную линию между двумя точками. Тем не менее применение векторов для рисования линий ограничивает производительность: теоретически можно нарисовать такое количество линий, которое не позволит приложению реагировать на действия пользователя (из-за ограничений в механизме отображения векторов среды выполнения Flash). Для решения этой проблемы мы можем рисовать линии с помощью метода 1 ineTo ( ) в экземпляре класса Shape, не отображаемом на экране. После рисования каждой линии мы копируем ее из объекта Shape в объект BitmapData, после чего очищаем данный экземпляр класса Shape. Поскольку за один раз рисуется только одна векторная линия, приложение никогда не прекратит реагировать на действия пользователя.

В листинге 26.10 продемонстрирован код, часть которого вам знакома из листинга 26.6. Обратите особое внимание на метод drawLine ( ), который выделен полужирным шрифтом.

Листинг 26.10. Приложение ScribbleAS3, версия с не отображаемыми на экране векторами

package { import flash. display.*; import flash. events.*; import flash. ui.*; import flash. geom.*;

// Простое приложение для рисования. В данной версии вектор рисуется // за пределами экрана, после чего он копируется на поверхность растрового // изображения, исключая снижение производительности, которое связано // с рисованием слишком большого количества векторов, public class ScribbleAS3_VectorV2 extends Sprite { private var canvas:Bitmap; // Холст растрового изображения,

// отображаемого на экране private var virtual Canvas:Shape; // Холст векторного изображения.

// не отображаемого на экране private var canvasContai ner:Sprite: // Содержит растровое изображение.

// обеспечивая интерактивность

private var isDrawing:Boolean = false; // Сообщает о том, нажата ли

// кнопка мыши в настоящий момент private var border:Shape; // Линия вокруг растрового изображения private var lastX:int; // х-координата последней точки,

// в которой щелкнул кнопкой мыши пользователь private var lastYrint; // у-координата последней точки,

// в которой щелкнул кнопкой мыши пользователь

// Конструктор

public function ScribbleAS3_VectorV2 ( ) { createCanvas( ); registerForInputEvents( );

// Предотвращаем изменение размеров окна приложения stage. scaleMode = StageScaleMode. N0_SCALE;

}

// Создает холст растрового изображения, отображаемого на экране,

// и холст векторного изображения, не отображаемого на экране

private function createCanvas (width:int = 200, height:int = 200):void {

// Создаем новый объект, не отображаемый на экране, в котором будет

// происходить рисование векторных линий перед их переносом

// в объект canvasData

virtual Canvas = new Shape( );

// Определяем объект данных, который будет хранить реальные пиксельные

// данные для рисунка пользователя. Линии копируются из объекта

// virtual Canvas в данный объект.

Var canvasData:BitmapData = new BitmapData(width,

height, false. OxFFFFFFFF);

// Создаем новый отображаемый объект Bitmap, используемый // для отображения объекта canvasData canvas = new Bitmap(canvasData);

// Создаем объект Sprite, который будет содержать объект Bitmap. Класс // Bitmap не поддерживает пересылаемые события ввода, поэтому помещаем его // в объект Sprite, чтобы пользователь мог взаимодействовать с этим объектом. canvasContainer = new Sprite( ); canvasContainer. addChild(canvas);

// Добавляем экземпляр canvasContainer класса Sprite (и содержащийся // в нем объект Bitmap) в иерархию отображения данного объекта addChi1d(canvasContai ner);

// Создаем границу вокруг области рисования.

border = new ShapeC );

border. graphi cs.1i neSty1e(1);

border. graphics. drawRect(0. 0, width, height);

addChild(border);

// Регистрирует приемники для необходимых событий мыши и клавиатуры private function registerForlnputEvents ( ):void { // Регистрируем приемники для событий нажатия кнопки мыши // и перемещения мыши от объекта canvasContainer canvasContai ner. addEventLi stener(MouseEvent. MOUSEJDOWN.

MouseDownListener); canvasContai ner. addEventLi stener(MouseEvent. M0USE_M0VE,

mouseMoveListener);

// Регистрируем приемники для событий отпускания кнопки мыши и нажатия

// клавиши от объекта Stage (то есть для глобальных событий).

// Используем объект Stage, поскольку событие отпускания кнопки мыши

// должно всегда завершать рисование, даже если указатель мыши

// не находится над областью рисования. Подобным образом, нажатие

// пробела должно всегда приводить к стиранию рисунка, даже когда

// объект canvasContainer не имеет фокуса.

stage. addEventLi stener(MouseEvent. MOUSEJJP, mouseUpLi stener);

stage. addEventLi stener(KeyboardEvent. KEYJDOWN, keyDownLi stener);

}

// Устанавливает цвет указанного пиксела. Используем этот способ

// для рисования одиночного пиксела, поскольку метод Graphics. lineTo( )

// не рисует одиночные пикселы

public function drawPoint (х:int, y:int. color:uint = OxFFOOOOOO):void { // Устанавливаем цвет указанного пиксела canvas. bitmapData. setPixel(х. у, color);

}

// Рисует векторную линию в объекте virtual Canvas, а затем копирует // растровое представление этой линии в объект canvasData (доступ // к растровому представлению осуществляется через переменную // canvas. bitmapData)

public function drawLine (xl:int, yl:int, x2:int, y2:int,

col or:uint = OxFFOOOOOO):void { // Рисуем линию в объекте virtual Canvas virtualCanvas. graphics. clear( ); virtual Canvas, graphics. lineStyled, 0×000000, 1, true,

LineScaleMode. NORMAL, CapsStyle. NONE); vi rtualCanvas. graphi cs. moveTo(xl, yl); vi rtualCanvas. graphi cs.1i neTo(x2, y2); // Копируем линию в объект canvasData canvas. bitmapData. draw(vi rtualCanvas);

}

// Отвечает на события MouseEvent. MOUSEJDOWN

private function mouseDownListener (e:MouseEvent):void {

// Устанавливаем флажок, указывающий на то, что основная кнопка мыши

// в настоящий момент нажата

isDrawing = true;

// Запоминаем точку, в которой щелкнул пользователь, чтобы в случае // перемещения мыши мы могли нарисовать линию из этой точки lastX = e. localX;

lastY = е. localY;

// Рисуем точку в позиции, где произошел щелчок кнопкой мыши drawPoint(e. localX, е. localY);

}

// Отвечает на события MouseEvent. M0USE_M0VE

private function mouseMoveListener (e:MouseEvent):void {

// Рисуем линию, когда мышь перемещается над областью рисования

// при нажатой основной кнопке мыши

if (isDrawing) {

// Используем переменные 1ocalX и localY, чтобы получить позицию // указателя относительно объекта canvasContainer. var thisX:int = e. localX; var thisY:int = e. localY;

// Рисуем линию в новую позицию указателя мыши drawLinedastX. lastY, thisX, thisY);

// Запоминаем последнюю позицию указателя мыши // для следующего раза lastX = thisX; lastY = thisY;

// Обновляем экран сразу после завершения выполнения // данной функции-приемника события е. updateAfterEvent( );

}

// Отвечает на события MouseEvent. MOUSEJJP

private function mouseUpListener (e:MouseEvent):void {

// Устанавливаем флажок, указывающий на то, что в настоящий момент

// основная кнопка мыши отпущена

isDrawing = false;

}

// Отвечает на события KeyboardEvent. KEYJDOWN private function keyDownListener (e:KeyboardEvent):void { // Стираем рисунок, когда пользователь нажимает клавишу Пробел. // Чтобы очистить рисунок, мы присваиваем всем пикселам // значение белого цвета, if (е. charCode == Keyboard. SPACE) { canvas. bitmapData. fillRect(new Rectangle(0. 0,

canvas. width, canvas. height),

OxFFFFFFFF);

}

}

}

}

Как метод draw( ) использует значения канала Alpha. Когда прозрачный объект-источник BitmapData копируется в прозрачный целевой объект BitmapData

с помощью метода draw ( ), каналы Alpha двух объектов BitmapData объединяются вместе на уровне пикселов с использованием алгоритма режима смешения BlendMode. SCREEN, который записывается следующим образом:

(значениемрЬаИсходногоОбъекта * (2ЬЬ-значениеМр1лаЦелевого0бъекта) I 256) + значениеА 1р11аЦелевого0бъекта

Когда значения канала Alpha двух объединяемых объектов находятся в диапазоне от 1 до 254, результатом будет являться значение канала Alpha с большей непрозрачностью, чем любое из исходных значений канала Alpha. Если объединяемый источник является полностью прозрачным, целевой объект BitmapData сохраняет свое исходное значение канала Alpha. Если целевой объект является полностью прозрачным, его значение канала Alpha заменяется значением канала Alpha объекта-источника.

Чтобы полностью заменить значения канала Alpha в целевом объекте BitmapData значениями объекта-источника BitmapData (вместо объединения двух значений), используйте метод copyPixels ( ) вместо метода draw ( ). Дополнительную информацию можно найти в подразд. «Метод экземпляра copyPixels( ) класса BitmapData» данного раздела.

Невозможность произвольного захвата изображения экрана. Стоит отметить, что в ActionScript невозможно захватить изображение экрана в произвольной прямоугольной области. Язык ActionScript позволяет лишь преобразовывать отображаемые объекты в растровый формат. В ActionScript ближайшим аналогом операции захвата изображения области отображения является использование экземпляра класса Stage в качестве параметра источник метода draw ( ), как показано в следующем коде:

var canvas:BitmapData = new BitmapDatadOO. 100, false. OxFFFFFFFF); canvas Ага^(некий0бьект01spl ayObject. stage);

Здесь некий0бъектй1spl ayObject — это экземпляр класса DisplayObject, находящийся в списке отображения. Предыдущий код создает растровое изображение, содержащее все объекты, которые в настоящий момент находятся в списке отображения, со следующими оговорками:

? цвет фона SWF-файла не копируется в растровое изображение;

? если доступ к объектам, находящимся в списке отображения, запрещен из-за ограничений безопасности, они не копируются в растровое изображение и генерируется исключение SecurityError.

Метод экземпляра copyPixelst) класса BitmapData

Как и draw ( ), метод copyPixels ( ) применяется для копирования значений цвета пикселов из объекта-источника в целевой объект BitmapData. Однако в отличие от метода draw ( ), который копирует пиксельные данные из любого экземпляра класса DisplayOb j ect или объекта BitmapData, метод copyPixels ( ) может копировать их только из объектов BitmapData. Этот метод отличается производительностью и удобством использования. Тестирование показывает, что операции copyPixels ( ) быстрее эквивалентных операций draw ( ) на 25-300 %.

I Чтобы достичь максимальной производительности при копировании значений цвета м?’ 4 „ пикселов между двумя объектами BitmapData, используйте метод copyPixels() вместо *Ц’ метода draw().

Помимо того что метод copyPixels ( ) производительнее метода draw ( ), он предоставляет разработчику простой доступ к таким операциям, как:

? размещение пикселов из объекта-источника в определенной точке объекта-получателя;

? объединение канала Alpha одного растрового изображения с каналом Alpha другого растрового изображения;

? перезапись значений канала Alpha целевого растрового изображения при копировании в него пикселов из исходного растрового изображения.

Хотя все три перечисленные операции также могут быть реализованы с помощью метода draw ( ) совместно с другими методами класса BitmapData, метод copyPixels ( ) обычно предпочтителен благодаря его удобству.

Метод copyPixels ( ) имеет следующий вид:

целевойОбъектШtmapData. copyPi xel s(исходныйОбъектШtmapData, исходнаяОбласть, целеваяТочка, обьектВ! tmapDataHaHanaA Ipha. точкаКаналаАIpha. обьединениеКаналовАIpha)

Здесь целевой0бъектВ1tmapData — это объект BitmapData, в который будут перенесены пикселы. Рассмотрим параметры метода draw ( ).

? исходный0бьектВ1 tmapData — экземпляр класса BitmapData, который будет скопирован в объект целевой0бъектВ1 tmapData. Объекты исходный0бъектВ1 tmapData и це-левой0бъектВ1tmapData могут являться одним объектом, позволяя копировать пикселы из одной области изображения в другую область того же изображения.

? исходнаяОбласть — объект Rectangle, определяющий область объекта исходный-0бьектВ1tmapData, которая будет скопирована в объект целевойОбъектВ! tmapData. Чтобы скопировать весь объект исходныйОбъектВт tmapData, используйте переменную исходныйОбъектВ! tmapData. rect. Если в функцию передается аргумент обьектВ1tmapDataKaнaлaAльфa, данный параметр также определяет ширину и высоту прямоугольной области внутри объекта объектВ! tmapDataKananaA Ipha, значения канала Alpha которой будут скопированы в объект целевойОбьект-BitmapData.

? целеваяТочка — объект Point, определяющий позицию левого верхнего угла прямоугольной области внутри объекта целевой0бьектВ1tmapData, в которую будут помещены копируемые пикселы.

? 06beKTBitmapDataKaHanaA Ipha — необязательный объект BitmapData, отличный от объекта исходныйОбъектВ! tmapData, значения канала Alpha которого станут новыми значениями канала Alpha пикселов, переносимых в объект целевой0бьектВ1 tmapData. Высота и ширина конкретной прямоугольной области, значения канала Alpha которой будут скопированы в объект целевойОбъектВ! tmapData, определяются параметром исходнаяОбласть.

С помощью этого параметра мы можем объединять RGB-каналы одного растрового изображения (исходныйОбъектШ tmapData) с каналом Alpha другого растрового изображения (oObeKTBitmapDataKaHanaA Ipha). Подобная методика может быть использована, например, для создания на фотографиях в электронном приложении, имитирующем альбом для наклеивания газетных вырезок, эффекта краев неправильной формы. Каждая фотография могла бы храниться в своем собственном объекте BitmapData, а края неправильной формы можно было бы хранить в виде значений канала Alpha в одном повторно используемом объекте BitmapData. С помощью параметра o6bet ? WHKaKaHanaAlpha — объект Point, определяющий левый верхний угол прямоугольной области внутри объекта объектВт tmapDataKaHanaA Ipha, из которой будут получены значения канала Alpha. Ширина и высота прямоугольной области задаются параметром исходнаяОбласть.

? объединениеКаналовА Ipha — значение типа Boolean, которое показывает, должны ли значения каналов Alpha объектов целевой0бъектВ1 tmapData и исходныйОбь-ектВ1 tmapData в процессе копирования данных объединяться (true), или значения канала Alpha объекта исходный0бъектВ1 tmapData должны полностью заменять существующие значения канала Alpha объекта целевойОбъектВ!’tmapData (false). Этот параметр оказывает влияние на результат только в том случае, когда оба объекта целевой0бьектВ1 tmapData и исходный0бъектВ1 tmapData являются прозрачными растровыми изображениями. Значением по умолчанию является false, указывающее, что значения канала Alpha объекта исходный0бъектВ1 tmapData полностью заменяют существующие значения канала Alpha объекта целевойОбъ-eKTBitmapData. Алгоритм, используемый для объединения значений каналов Alpha, соответствует алгоритму, рассмотренному ранее в подразд. «Метод экземпляра draw( ) класса BitmapData» данного раздела.