Move RenderScript from graphics/ to new fw/base subdirectory rs.
Change-Id: I30b6633578f063840e1bdbcc9ba513b727912a6d
This commit is contained in:
Tim Murray
353
rs/java/android/renderscript/Sampler.java
Normal file
353
rs/java/android/renderscript/Sampler.java
Normal file
@@ -0,0 +1,353 @@
|
||||
/*
|
||||
* Copyright (C) 2008 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.renderscript;
|
||||
|
||||
/**
|
||||
* Sampler object that defines how Allocations can be read as textures within a
|
||||
* kernel. Samplers are used in conjunction with the {@code rsSample} runtime
|
||||
* function to return values from normalized coordinates.
|
||||
*
|
||||
* Any Allocation used with a Sampler must have been created with {@link
|
||||
* android.renderscript.Allocation#USAGE_GRAPHICS_TEXTURE}; using a Sampler on
|
||||
* an {@link android.renderscript.Allocation} that was not created with {@link
|
||||
* android.renderscript.Allocation#USAGE_GRAPHICS_TEXTURE} is undefined.
|
||||
**/
|
||||
public class Sampler extends BaseObj {
|
||||
public enum Value {
|
||||
NEAREST (0),
|
||||
LINEAR (1),
|
||||
LINEAR_MIP_LINEAR (2),
|
||||
LINEAR_MIP_NEAREST (5),
|
||||
WRAP (3),
|
||||
CLAMP (4),
|
||||
MIRRORED_REPEAT (6);
|
||||
|
||||
int mID;
|
||||
Value(int id) {
|
||||
mID = id;
|
||||
}
|
||||
}
|
||||
|
||||
Value mMin;
|
||||
Value mMag;
|
||||
Value mWrapS;
|
||||
Value mWrapT;
|
||||
Value mWrapR;
|
||||
float mAniso;
|
||||
|
||||
Sampler(int id, RenderScript rs) {
|
||||
super(id, rs);
|
||||
}
|
||||
|
||||
/**
|
||||
* @return minification setting for the sampler
|
||||
*/
|
||||
public Value getMinification() {
|
||||
return mMin;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return magnification setting for the sampler
|
||||
*/
|
||||
public Value getMagnification() {
|
||||
return mMag;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return S wrapping mode for the sampler
|
||||
*/
|
||||
public Value getWrapS() {
|
||||
return mWrapS;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return T wrapping mode for the sampler
|
||||
*/
|
||||
public Value getWrapT() {
|
||||
return mWrapT;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return anisotropy setting for the sampler
|
||||
*/
|
||||
public float getAnisotropy() {
|
||||
return mAniso;
|
||||
}
|
||||
|
||||
/**
|
||||
* Retrieve a sampler with min and mag set to nearest and wrap modes set to
|
||||
* clamp.
|
||||
*
|
||||
* @param rs Context to which the sampler will belong.
|
||||
*
|
||||
* @return Sampler
|
||||
*/
|
||||
public static Sampler CLAMP_NEAREST(RenderScript rs) {
|
||||
if(rs.mSampler_CLAMP_NEAREST == null) {
|
||||
Builder b = new Builder(rs);
|
||||
b.setMinification(Value.NEAREST);
|
||||
b.setMagnification(Value.NEAREST);
|
||||
b.setWrapS(Value.CLAMP);
|
||||
b.setWrapT(Value.CLAMP);
|
||||
rs.mSampler_CLAMP_NEAREST = b.create();
|
||||
}
|
||||
return rs.mSampler_CLAMP_NEAREST;
|
||||
}
|
||||
|
||||
/**
|
||||
* Retrieve a sampler with min and mag set to linear and wrap modes set to
|
||||
* clamp.
|
||||
*
|
||||
* @param rs Context to which the sampler will belong.
|
||||
*
|
||||
* @return Sampler
|
||||
*/
|
||||
public static Sampler CLAMP_LINEAR(RenderScript rs) {
|
||||
if(rs.mSampler_CLAMP_LINEAR == null) {
|
||||
Builder b = new Builder(rs);
|
||||
b.setMinification(Value.LINEAR);
|
||||
b.setMagnification(Value.LINEAR);
|
||||
b.setWrapS(Value.CLAMP);
|
||||
b.setWrapT(Value.CLAMP);
|
||||
rs.mSampler_CLAMP_LINEAR = b.create();
|
||||
}
|
||||
return rs.mSampler_CLAMP_LINEAR;
|
||||
}
|
||||
|
||||
/**
|
||||
* Retrieve a sampler with mag set to linear, min linear mipmap linear, and
|
||||
* wrap modes set to clamp.
|
||||
*
|
||||
* @param rs Context to which the sampler will belong.
|
||||
*
|
||||
* @return Sampler
|
||||
*/
|
||||
public static Sampler CLAMP_LINEAR_MIP_LINEAR(RenderScript rs) {
|
||||
if(rs.mSampler_CLAMP_LINEAR_MIP_LINEAR == null) {
|
||||
Builder b = new Builder(rs);
|
||||
b.setMinification(Value.LINEAR_MIP_LINEAR);
|
||||
b.setMagnification(Value.LINEAR);
|
||||
b.setWrapS(Value.CLAMP);
|
||||
b.setWrapT(Value.CLAMP);
|
||||
rs.mSampler_CLAMP_LINEAR_MIP_LINEAR = b.create();
|
||||
}
|
||||
return rs.mSampler_CLAMP_LINEAR_MIP_LINEAR;
|
||||
}
|
||||
|
||||
/**
|
||||
* Retrieve a sampler with min and mag set to nearest and wrap modes set to
|
||||
* wrap.
|
||||
*
|
||||
* @param rs Context to which the sampler will belong.
|
||||
*
|
||||
* @return Sampler
|
||||
*/
|
||||
public static Sampler WRAP_NEAREST(RenderScript rs) {
|
||||
if(rs.mSampler_WRAP_NEAREST == null) {
|
||||
Builder b = new Builder(rs);
|
||||
b.setMinification(Value.NEAREST);
|
||||
b.setMagnification(Value.NEAREST);
|
||||
b.setWrapS(Value.WRAP);
|
||||
b.setWrapT(Value.WRAP);
|
||||
rs.mSampler_WRAP_NEAREST = b.create();
|
||||
}
|
||||
return rs.mSampler_WRAP_NEAREST;
|
||||
}
|
||||
|
||||
/**
|
||||
* Retrieve a sampler with min and mag set to linear and wrap modes set to
|
||||
* wrap.
|
||||
*
|
||||
* @param rs Context to which the sampler will belong.
|
||||
*
|
||||
* @return Sampler
|
||||
*/
|
||||
public static Sampler WRAP_LINEAR(RenderScript rs) {
|
||||
if(rs.mSampler_WRAP_LINEAR == null) {
|
||||
Builder b = new Builder(rs);
|
||||
b.setMinification(Value.LINEAR);
|
||||
b.setMagnification(Value.LINEAR);
|
||||
b.setWrapS(Value.WRAP);
|
||||
b.setWrapT(Value.WRAP);
|
||||
rs.mSampler_WRAP_LINEAR = b.create();
|
||||
}
|
||||
return rs.mSampler_WRAP_LINEAR;
|
||||
}
|
||||
|
||||
/**
|
||||
* Retrieve a sampler with mag set to linear, min linear mipmap linear, and
|
||||
* wrap modes set to wrap.
|
||||
*
|
||||
* @param rs Context to which the sampler will belong.
|
||||
*
|
||||
* @return Sampler
|
||||
*/
|
||||
public static Sampler WRAP_LINEAR_MIP_LINEAR(RenderScript rs) {
|
||||
if(rs.mSampler_WRAP_LINEAR_MIP_LINEAR == null) {
|
||||
Builder b = new Builder(rs);
|
||||
b.setMinification(Value.LINEAR_MIP_LINEAR);
|
||||
b.setMagnification(Value.LINEAR);
|
||||
b.setWrapS(Value.WRAP);
|
||||
b.setWrapT(Value.WRAP);
|
||||
rs.mSampler_WRAP_LINEAR_MIP_LINEAR = b.create();
|
||||
}
|
||||
return rs.mSampler_WRAP_LINEAR_MIP_LINEAR;
|
||||
}
|
||||
|
||||
/**
|
||||
* Retrieve a sampler with min and mag set to nearest and wrap modes set to
|
||||
* mirrored repeat.
|
||||
*
|
||||
* @param rs Context to which the sampler will belong.
|
||||
*
|
||||
* @return Sampler
|
||||
*/
|
||||
public static Sampler MIRRORED_REPEAT_NEAREST(RenderScript rs) {
|
||||
if(rs.mSampler_MIRRORED_REPEAT_NEAREST == null) {
|
||||
Builder b = new Builder(rs);
|
||||
b.setMinification(Value.NEAREST);
|
||||
b.setMagnification(Value.NEAREST);
|
||||
b.setWrapS(Value.MIRRORED_REPEAT);
|
||||
b.setWrapT(Value.MIRRORED_REPEAT);
|
||||
rs.mSampler_MIRRORED_REPEAT_NEAREST = b.create();
|
||||
}
|
||||
return rs.mSampler_MIRRORED_REPEAT_NEAREST;
|
||||
}
|
||||
|
||||
/**
|
||||
* Retrieve a sampler with min and mag set to linear and wrap modes set to
|
||||
* mirrored repeat.
|
||||
*
|
||||
* @param rs Context to which the sampler will belong.
|
||||
*
|
||||
* @return Sampler
|
||||
*/
|
||||
public static Sampler MIRRORED_REPEAT_LINEAR(RenderScript rs) {
|
||||
if(rs.mSampler_MIRRORED_REPEAT_LINEAR == null) {
|
||||
Builder b = new Builder(rs);
|
||||
b.setMinification(Value.LINEAR);
|
||||
b.setMagnification(Value.LINEAR);
|
||||
b.setWrapS(Value.MIRRORED_REPEAT);
|
||||
b.setWrapT(Value.MIRRORED_REPEAT);
|
||||
rs.mSampler_MIRRORED_REPEAT_LINEAR = b.create();
|
||||
}
|
||||
return rs.mSampler_MIRRORED_REPEAT_LINEAR;
|
||||
}
|
||||
|
||||
/**
|
||||
* Retrieve a sampler with min and mag set to linear and wrap modes set to
|
||||
* mirrored repeat.
|
||||
*
|
||||
* @param rs Context to which the sampler will belong.
|
||||
*
|
||||
* @return Sampler
|
||||
*/
|
||||
public static Sampler MIRRORED_REPEAT_LINEAR_MIP_LINEAR(RenderScript rs) {
|
||||
if(rs.mSampler_MIRRORED_REPEAT_LINEAR_MIP_LINEAR == null) {
|
||||
Builder b = new Builder(rs);
|
||||
b.setMinification(Value.LINEAR_MIP_LINEAR);
|
||||
b.setMagnification(Value.LINEAR);
|
||||
b.setWrapS(Value.MIRRORED_REPEAT);
|
||||
b.setWrapT(Value.MIRRORED_REPEAT);
|
||||
rs.mSampler_MIRRORED_REPEAT_LINEAR_MIP_LINEAR = b.create();
|
||||
}
|
||||
return rs.mSampler_MIRRORED_REPEAT_LINEAR_MIP_LINEAR;
|
||||
}
|
||||
|
||||
/**
|
||||
* Builder for creating non-standard samplers. This is only necessary if
|
||||
* a Sampler with different min and mag modes is desired.
|
||||
*/
|
||||
public static class Builder {
|
||||
RenderScript mRS;
|
||||
Value mMin;
|
||||
Value mMag;
|
||||
Value mWrapS;
|
||||
Value mWrapT;
|
||||
Value mWrapR;
|
||||
float mAniso;
|
||||
|
||||
public Builder(RenderScript rs) {
|
||||
mRS = rs;
|
||||
mMin = Value.NEAREST;
|
||||
mMag = Value.NEAREST;
|
||||
mWrapS = Value.WRAP;
|
||||
mWrapT = Value.WRAP;
|
||||
mWrapR = Value.WRAP;
|
||||
mAniso = 1.0f;
|
||||
}
|
||||
|
||||
public void setMinification(Value v) {
|
||||
if (v == Value.NEAREST ||
|
||||
v == Value.LINEAR ||
|
||||
v == Value.LINEAR_MIP_LINEAR ||
|
||||
v == Value.LINEAR_MIP_NEAREST) {
|
||||
mMin = v;
|
||||
} else {
|
||||
throw new IllegalArgumentException("Invalid value");
|
||||
}
|
||||
}
|
||||
|
||||
public void setMagnification(Value v) {
|
||||
if (v == Value.NEAREST || v == Value.LINEAR) {
|
||||
mMag = v;
|
||||
} else {
|
||||
throw new IllegalArgumentException("Invalid value");
|
||||
}
|
||||
}
|
||||
|
||||
public void setWrapS(Value v) {
|
||||
if (v == Value.WRAP || v == Value.CLAMP || v == Value.MIRRORED_REPEAT) {
|
||||
mWrapS = v;
|
||||
} else {
|
||||
throw new IllegalArgumentException("Invalid value");
|
||||
}
|
||||
}
|
||||
|
||||
public void setWrapT(Value v) {
|
||||
if (v == Value.WRAP || v == Value.CLAMP || v == Value.MIRRORED_REPEAT) {
|
||||
mWrapT = v;
|
||||
} else {
|
||||
throw new IllegalArgumentException("Invalid value");
|
||||
}
|
||||
}
|
||||
|
||||
public void setAnisotropy(float v) {
|
||||
if(v >= 0.0f) {
|
||||
mAniso = v;
|
||||
} else {
|
||||
throw new IllegalArgumentException("Invalid value");
|
||||
}
|
||||
}
|
||||
|
||||
public Sampler create() {
|
||||
mRS.validate();
|
||||
int id = mRS.nSamplerCreate(mMag.mID, mMin.mID,
|
||||
mWrapS.mID, mWrapT.mID, mWrapR.mID, mAniso);
|
||||
Sampler sampler = new Sampler(id, mRS);
|
||||
sampler.mMin = mMin;
|
||||
sampler.mMag = mMag;
|
||||
sampler.mWrapS = mWrapS;
|
||||
sampler.mWrapT = mWrapT;
|
||||
sampler.mWrapR = mWrapR;
|
||||
sampler.mAniso = mAniso;
|
||||
return sampler;
|
||||
}
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user