1 /* 2 * Copyright (C) 2012 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 package android.renderscript; 18 19 /** 20 * 21 * Intrinsic for converting RGB to RGBA by using a 3D lookup table. The 22 * incoming r,g,b values are use as normalized x,y,z coordinates into a 3D 23 * allocation. The 8 nearest values are sampled and linearly interpolated. The 24 * result is placed in the output. 25 * 26 * @deprecated Renderscript has been deprecated in API level 31. Please refer to the <a 27 * href="https://developer.android.com/guide/topics/renderscript/migration-guide">migration 28 * guide</a> for the proposed alternatives. 29 **/ 30 @Deprecated 31 public final class ScriptIntrinsic3DLUT extends ScriptIntrinsic { 32 private Allocation mLUT; 33 private Element mElement; 34 ScriptIntrinsic3DLUT(long id, RenderScript rs, Element e)35 private ScriptIntrinsic3DLUT(long id, RenderScript rs, Element e) { 36 super(id, rs); 37 mElement = e; 38 } 39 40 /** 41 * Supported elements types are {@link Element#U8_4} 42 * 43 * The defaults tables are identity. 44 * 45 * @param rs The RenderScript context 46 * @param e Element type for intputs and outputs 47 * 48 * @return ScriptIntrinsic3DLUT 49 */ create(RenderScript rs, Element e)50 public static ScriptIntrinsic3DLUT create(RenderScript rs, Element e) { 51 long id = rs.nScriptIntrinsicCreate(8, e.getID(rs)); 52 53 if (!e.isCompatible(Element.U8_4(rs))) { 54 throw new RSIllegalArgumentException("Element must be compatible with uchar4."); 55 } 56 57 return new ScriptIntrinsic3DLUT(id, rs, e); 58 } 59 60 /** 61 * Sets the {@link android.renderscript.Allocation} to be used as the lookup table. 62 * 63 * The lookup table must use the same {@link android.renderscript.Element} as the intrinsic. 64 * 65 */ 66 setLUT(Allocation lut)67 public void setLUT(Allocation lut) { 68 final Type t = lut.getType(); 69 70 if (t.getZ() == 0) { 71 throw new RSIllegalArgumentException("LUT must be 3d."); 72 } 73 74 if (!t.getElement().isCompatible(mElement)) { 75 throw new RSIllegalArgumentException("LUT element type must match."); 76 } 77 78 mLUT = lut; 79 setVar(0, mLUT); 80 } 81 82 83 /** 84 * Invoke the kernel and apply the lookup to each cell of ain 85 * and copy to aout. 86 * 87 * @param ain Input allocation 88 * @param aout Output allocation 89 */ forEach(Allocation ain, Allocation aout)90 public void forEach(Allocation ain, Allocation aout) { 91 forEach(ain, aout, null); 92 } 93 94 /** 95 * Invoke the kernel and apply the lookup to each cell of ain 96 * and copy to aout. 97 * 98 * @param ain Input allocation 99 * @param aout Output allocation 100 * @param opt Launch options for kernel 101 */ forEach(Allocation ain, Allocation aout, Script.LaunchOptions opt)102 public void forEach(Allocation ain, Allocation aout, Script.LaunchOptions opt) { 103 forEach(0, ain, aout, null, opt); 104 } 105 106 107 /** 108 * Get a KernelID for this intrinsic kernel. 109 * 110 * @return Script.KernelID The KernelID object. 111 */ getKernelID()112 public Script.KernelID getKernelID() { 113 return createKernelID(0, 3, null, null); 114 } 115 } 116 117