blob: 1ab416a7055e78c2768b17f275ec89bff19d8cab (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
|
/*
* Copyright (C) 2011 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package android.filterfw;
import android.filterfw.core.CachedFrameManager;
import android.filterfw.core.FilterContext;
import android.filterfw.core.FrameManager;
import android.filterfw.core.GLEnvironment;
/**
* Base class for mobile filter framework (MFF) frontend environments. These convenience classes
* allow using the filter framework without the requirement of performing manual setup of its
* required components.
*
* @hide
*/
public class MffEnvironment {
private FilterContext mContext;
/**
* Protected constructor to initialize the environment's essential components. These are the
* frame-manager and the filter-context. Passing in null for the frame-manager causes this
* to be auto-created.
*
* @param frameManager The FrameManager to use or null to auto-create one.
*/
protected MffEnvironment(FrameManager frameManager) {
// Get or create the frame manager
if (frameManager == null) {
frameManager = new CachedFrameManager();
}
// Setup the environment
mContext = new FilterContext();
mContext.setFrameManager(frameManager);
}
/**
* Returns the environment's filter-context.
*/
public FilterContext getContext() {
return mContext;
}
/**
* Set the environment's GL environment to the specified environment. This does not activate
* the environment.
*/
public void setGLEnvironment(GLEnvironment glEnvironment) {
mContext.initGLEnvironment(glEnvironment);
}
/**
* Create and activate a new GL environment for use in this filter context.
*/
public void createGLEnvironment() {
GLEnvironment glEnvironment = new GLEnvironment();
glEnvironment.initWithNewContext();
setGLEnvironment(glEnvironment);
}
/**
* Activate the GL environment for use in the current thread. A GL environment must have been
* previously set or created using setGLEnvironment() or createGLEnvironment()! Call this after
* having switched to a new thread for GL filter execution.
*/
public void activateGLEnvironment() {
GLEnvironment glEnv = mContext.getGLEnvironment();
if (glEnv != null) {
mContext.getGLEnvironment().activate();
} else {
throw new NullPointerException("No GLEnvironment in place to activate!");
}
}
/**
* Deactivate the GL environment from use in the current thread. A GL environment must have been
* previously set or created using setGLEnvironment() or createGLEnvironment()! Call this before
* running GL filters in another thread.
*/
public void deactivateGLEnvironment() {
GLEnvironment glEnv = mContext.getGLEnvironment();
if (glEnv != null) {
mContext.getGLEnvironment().deactivate();
} else {
throw new NullPointerException("No GLEnvironment in place to deactivate!");
}
}
}
|
