1227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks/* 2227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks * Copyright (C) 2013 The Android Open Source Project 3227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks * 4227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks * Licensed under the Apache License, Version 2.0 (the "License"); 5227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks * you may not use this file except in compliance with the License. 6227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks * You may obtain a copy of the License at 7227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks * 8227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks * http://www.apache.org/licenses/LICENSE-2.0 9227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks * 10227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks * Unless required by applicable law or agreed to in writing, software 11227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks * distributed under the License is distributed on an "AS IS" BASIS, 12227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks * See the License for the specific language governing permissions and 14227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks * limitations under the License. 15227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks */ 16227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendrickspackage androidx.media.filterfw; 17227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks 18227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricksimport java.util.LinkedList; 19227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricksimport java.util.Queue; 20227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks 21227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks/** 22227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks * A {@link Filter} that pushes out externally injected frames. 23227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks * <p> When a frame is injected using {@link #injectFrame(Frame)}, this source will push it on its 24227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks * output port and then sleep until another frame is injected. 25227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks * <p> Multiple frames may be injected before any frame is pushed out. In this case they will be 26227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks * queued and pushed in FIFO order. 27227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks */ 28227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricksclass FrameSourceFilter extends Filter { 29227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks 30227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks private final Queue<Frame> mFrames = new LinkedList<Frame>(); 31227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks 32227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks FrameSourceFilter(MffContext context, String name) { 33227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks super(context, name); 34227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks } 35227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks 36227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks @Override 37227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks public Signature getSignature() { 38227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks return new Signature() 39227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks .addOutputPort("output", Signature.PORT_REQUIRED, FrameType.any()) 40227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks .disallowOtherPorts(); 41227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks } 42227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks 43227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks private synchronized Frame obtainFrame() { 44227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks if (mFrames.isEmpty()) { 45227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks enterSleepState(); 46227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks return null; 47227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks } else { 48227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks return mFrames.poll(); 49227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks } 50227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks } 51227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks 52227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks /** 53227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks * Call this method to inject a frame that will be pushed in a future execution of the filter. 54227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks * <p> If multiple frames are injected then they will be pushed one per execution in FIFO order. 55227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks */ 56227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks public synchronized void injectFrame(Frame frame) { 57227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks mFrames.add(frame); 58227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks wakeUp(); 59227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks } 60227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks 61227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks @Override 62227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks protected void onProcess() { 63227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks Frame frame = obtainFrame(); 64227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks if (frame != null) { 65227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks getConnectedOutputPort("output").pushFrame(frame); 66227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks } 67227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks } 68227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks 69227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks} 70