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 Hendricks/**
19227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks * A {@link Filter} that consumes frames and allows to register a listener to observe when
20227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks * a new frame has been consumed.
21227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks */
22227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricksclass FrameTargetFilter extends Filter {
23227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks
24227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks    interface Listener {
25227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks        /**
26227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks         * Called each time this filter receives a new frame. The implementer of this method is
27227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks         * responsible for releasing the frame.
28227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks         */
29227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks        void onFramePushed(String filterName, Frame frame);
30227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks    }
31227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks
32227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks    private Listener mListener;
33227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks
34227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks    FrameTargetFilter(MffContext context, String name) {
35227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks        super(context, name);
36227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks    }
37227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks
38227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks    @Override
39227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks    public Signature getSignature() {
40227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks        return new Signature()
41227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks                .addInputPort("input", Signature.PORT_REQUIRED, FrameType.any())
42227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks                .disallowOtherPorts();
43227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks    }
44227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks
45227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks    public synchronized void setListener(Listener listener) {
46227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks        mListener = listener;
47227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks    }
48227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks
49227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks    @Override
50227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks    protected synchronized void onProcess() {
51227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks        Frame frame = getConnectedInputPort("input").pullFrame();
52227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks        if (mListener != null) {
53227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks            frame.retain();
54227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks            mListener.onFramePushed(getName(), frame);
55227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks        }
56227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks    }
57227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks
58227b47625d7482b5b47ad0e4c70ce0a246236adeBenjamin Hendricks}
59