Пакет | mx.graphics |
Класс | public dynamic class ImageSnapshot |
Наследование | ImageSnapshot Object |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
flash.display. IBitmapDrawable
, включая UIComponents Flex.
Экземпляр этого класса может передаваться в LiveCycle Data Services как RemoteObject для генерации PDF-файла изображения на стороне клиента. При необходимости указания дополнительных свойств изображения наряду с его свойствами contentType
, width
и height
следует определить пары имя/значение для объекта properties
.
В более ранних версиях Flex эти дополнительные свойства устанавливались непосредственно в экземпляре ImageSnapshot. В целях обеспечения этого условия данный класс по-прежнему является динамическим, однако в будущих версиях Flex он может больше не быть динамическим.
Свойство | Определено | ||
---|---|---|---|
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
contentType : String
Тип содержимого MIME для формата кодировки изображения, который использовался для захвата этого снимка. | ImageSnapshot | ||
data : ByteArray
Кодированные данные, представляющие снимок изображения. | ImageSnapshot | ||
defaultEncoder : Class [статические]
Для захвата изображения используется реализация по умолчанию mx.graphics.codec. IImageEncoder. | ImageSnapshot | ||
height : int
Высота изображения в пикселях. | ImageSnapshot | ||
properties : Object
Object, содержащий пары «имя/значение», которые указывают дополнительные свойства изображения. | ImageSnapshot | ||
width : int
Ширина изображения в пикселях. | ImageSnapshot |
Метод | Определено | ||
---|---|---|---|
Конструктор. | ImageSnapshot | ||
captureBitmapData(source:IBitmapDrawable, matrix:Matrix = null, colorTransform:flash.geom:ColorTransform = null, blendMode:String = null, clipRect:Rectangle = null, smoothing:Boolean = false):BitmapData [статические]
Служебный метод для захвата необработанного снимка компонента UI в виде BitmapData. | ImageSnapshot | ||
captureImage(source:IBitmapDrawable, dpi:Number = 0, encoder:IImageEncoder = null, scaleLimited:Boolean = true):ImageSnapshot [статические]
Служебный метод для захвата снимка компонента, масштабируемого до определенного разрешения (dpi) и кодируемого в изображение определенного формата. | ImageSnapshot | ||
[статические]
Служебный метод для преобразования ImageSnapshot в строку в кодировке Base-64 для передачи в форматы сериализации на основе текста, например XML. | ImageSnapshot | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
Возвращает строковое представление заданного объекта. | Object | ||
Возвращает элементарное значение заданного объекта. | Object |
Константа | Определено | ||
---|---|---|---|
MAX_BITMAP_DIMENSION : int = 2880 [статические]
Максимальная ширина и высота растрового изображения. | ImageSnapshot |
contentType | свойство |
contentType:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Тип содержимого MIME для формата кодировки изображения, который использовался для захвата этого снимка. Для изображений в формате PNG используется тип MIME image/png. Для изображений в формате JPG или JPEG используется тип MIME image/jpeg
Реализация
public function get contentType():String
public function set contentType(value:String):void
data | свойство |
defaultEncoder | свойство |
public static var defaultEncoder:Class
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Для захвата изображения используется реализация по умолчанию mx.graphics.codec. IImageEncoder
. Используются следующие две реализации: PNGEncoder и JPEGEncoder. Кодировщик по умолчанию использует формат PNG.
height | свойство |
properties | свойство |
properties:Object
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Object, содержащий пары «имя/значение», которые указывают дополнительные свойства изображения.
Как правило, такая информация предоставляется только в случае передачи экземпляра ImageSnapshot в LiveCycle Data Services Adobe в целях генерации файла PDF. Можно либо установить весь объект, либо задать отдельные пары «имя-значение» для существующего ранее пустого объекта.
Значением по умолчанию является {}.
Реализация
public function get properties():Object
public function set properties(value:Object):void
width | свойство |
ImageSnapshot | () | Конструктор |
public function ImageSnapshot(width:int = 0, height:int = 0, data:ByteArray = null, contentType:String = null)
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Конструктор.
Параметрыwidth:int (default = 0 ) — Ширина изображения.
| |
height:int (default = 0 ) — Высота изображения.
| |
data:ByteArray (default = null ) — Байтовый массив, содержащий изображение.
| |
contentType:String (default = null ) — Тип формата кодировщика для изображения: либо PNGEncoder, либо JPEGEncoder.
|
captureBitmapData | () | метод |
public static function captureBitmapData(source:IBitmapDrawable, matrix:Matrix = null, colorTransform:flash.geom:ColorTransform = null, blendMode:String = null, clipRect:Rectangle = null, smoothing:Boolean = false):BitmapData
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Служебный метод для захвата необработанного снимка компонента UI в виде BitmapData.
Параметры
source:IBitmapDrawable — Объект, реализующий интерфейс flash.display. IBitmapDrawable .
| |
matrix:Matrix (default = null ) — Объект Matrix, используемый для масштабирования, поворота и преобразования координат полученного растрового изображения. Если не требуется применять преобразование матрицы в изображение, задайте для этого параметра идентификационную матрицу, созданную с помощью конструктора new Matrix() по умолчанию, или передайте значение null.
| |
colorTransform:flash.geom:ColorTransform (default = null ) — Объект ColorTransform, используемый для настройки значений цвета растрового изображения. Если объект не указан, цвета растрового изображения не преобразуются. Если вам необходимо передать этот параметр, но преобразовывать изображение не нужно, задайте для него объект ColorTransform, созданный с помощью конструктора new ColorTransform() по умолчанию.
| |
blendMode:String (default = null ) — Строковое значение класса flash.display.BlendMode, задающее режим наложения, которые будет применен к полученному растровому изображению.
| |
clipRect:Rectangle (default = null ) — Объект Rectangle, определяющий для рисования область исходного объекта. Если это значение не задано, то обрезка не производится и исходный объект рисуется полностью.
| |
smoothing:Boolean (default = false ) — Значение Boolean, определяющее необходимость сглаживания объекта BitmapData при масштабировании.
|
BitmapData — Объект BitmapData, представляющий захваченный снимок экрана, или null, если источник не имеет видимых границ.
|
captureImage | () | метод |
public static function captureImage(source:IBitmapDrawable, dpi:Number = 0, encoder:IImageEncoder = null, scaleLimited:Boolean = true):ImageSnapshot
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Служебный метод для захвата снимка компонента, масштабируемого до определенного разрешения (dpi) и кодируемого в изображение определенного формата.
Параметры
source:IBitmapDrawable — Объект, реализующий интерфейс flash.display. IBitmapDrawable .
| |
dpi:Number (default = 0 ) — Разрешение в точках на дюйм. Если разрешение не определено, по умолчанию используется текущее разрешение экрана.
| |
encoder:IImageEncoder (default = null ) — Формат изображения, используемый для кодирования необработанного растрового изображения. Используются следующие два кодировщика: PNGEncoder и JPEGEncoder. Если кодировщик не определен, по умолчанию используется PNGEncoder.
| |
scaleLimited:Boolean (default = true ) — Максимальная ширина или высота растрового изображения в приложении Flash составляет 2880 пикселей; если для scaleLimited установлено значение true, то разрешение пропорционально уменьшается таким образом, чтобы оно не выходило за пределы 2880 пикселей, в противном случае, если scaleLimited имеет значение false, крупное изображение захватывается из ряда окон меньшего размера. Значение по умолчанию равно true.
|
ImageSnapshot — ImageSnapshot содержит захваченный кодированный снимок и связанные метаданные изображения.
|
encodeImageAsBase64 | () | метод |
public static function encodeImageAsBase64(snapshot:ImageSnapshot):String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Служебный метод для преобразования ImageSnapshot в строку в кодировке Base-64 для передачи в форматы сериализации на основе текста, например XML.
Параметры
snapshot:ImageSnapshot — Изображение, захваченное как mx.graphics.ImageSnapshot .
|
String — Строка, представляющая снимок в кодировке Base-64.
|
Связанные элементы API
MAX_BITMAP_DIMENSION | Константа |
public static const MAX_BITMAP_DIMENSION:int = 2880
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Максимальная ширина и высота растрового изображения.
Tue Jun 12 2018, 11:34 AM Z