Использование шейдера в автономном режиме

Flash Player 10 и более поздних версий, Adobe AIR 1.5 и более поздних версий

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

  • Обработка неграфических данных. В автономном режиме шейдеру можно передать произвольные двоичные или числовые данные вместо данных растрового изображения. Можно указать, что шейдер должен вернуть полученный результат как двоичные или числовые данные, в дополнение к данным растрового изображения.

  • Фоновая обработка. При работе в автономном режиме шейдер по умолчанию выполняется асинхронно. Это означает, что шейдер выполняется в фоне, не вмешиваясь в работу приложения. Вывод передается коду после завершения обработки. Так можно использовать шейдер, на выполнение которого требуется много времени, чтобы он не «замораживал» пользовательский интерфейс приложения и другие операции обработки.

Объект ShaderJob служит для выполнения шейдера в автономном режиме. Сначала создается объект ShaderJob и связывается с объектом Shader, представляющим шейдер, который нужно выполнить. 

var job:ShaderJob = new ShaderJob(myShader);

Затем задаются значения ввода или параметры, необходимые для работы шейдера. Если шейдер выполняется в фоновом режиме, также необходимо зарегистрировать прослушиватель для события complete объекта ShaderJob. Прослушиватель вызывается после завершения работы шейдера. 

function completeHandler(event:ShaderEvent):void 
{ 
    // do something with the shader result 
} 
 
job.addEventListener(ShaderEvent.COMPLETE, completeHandler);

Затем создается объект, в который будет записан вывод шейдера после завершения операции. Этот объект назначается свойству target объекта ShaderJob. 

var jobResult:BitmapData = new BitmapData(100, 75); 
job.target = jobResult;

Назначьте свойству target объект BitmapData, если ShaderJob используется для обработки изображения. Если же обрабатываются двоичные или числовые данные, назначьте объект ByteArray или Vector.<Number> свойству target . В этом случае необходимо задать свойства width и height объекта ShaderJob, чтобы указать объем данных для вывода в объект target .

Примечание. Чтобы одновременно задать свойства shader , target , width и height объекта ShaderJob, нужно передать аргументы конструктору ShaderJob() , например: var job:ShaderJob = new ShaderJob(myShader, myTarget, myWidth, myHeight);

Когда потребуется выполнить шейдер, вызовите метод start( ) объекта ShaderJob. 

job.start();

По умолчанию при вызове метода start() запускается асинхронное выполнение ShaderJob. В этом случае выполнение программы сразу переходит к следующей строке кода, а не ожидает завершения обработки шейдера. После завершения операции шейдера объект ShaderJob вызывает свои прослушиватели события complete , сообщая им о готовности. На этом этапе (то есть в теле прослушивателя события complete ) объект target содержит результат операции шейдера.

Примечание. Вместо использования объекта, назначенного свойству target , вывод шейдера непосредственно можно получить из объекта события, переданного методу прослушивателя. Объект события является экземпляром ShaderEvent. Объект ShaderEvent имеет три свойства, которые можно использовать для получения вывода в зависимости от типа данных объекта, заданного в свойстве target : ShaderEvent.bitmapData , ShaderEvent.byteArray и ShaderEvent.vector .

Также можно передать аргумент true методу start() . В этом случае операция шейдера выполняется синхронно. Выполнение всего кода (включая взаимодействие с пользовательским интерфейсом и другими событиями) приостанавливается до завершения обработки шейдера. После выполнения операции шейдера объект target получает вывод шейдера, и программа переходит к следующей строке кода. 

job.start(true);