8  * filtering function, including the range of depth levels, the disc blur radius
9  * of each depth level, how the depth levels are grouped into layers, which
12  *  <b> Here by "depth", we mean inverse depth. Pixels with larger depth values
15  *  For a layer n, its depth interval is (@code [layerInfo[n].backDepth,
19  * depth values.
36    * The minimum of the interval that is used to group depth levels into
42    * The starting index of depth quantization level. Must be positive as zero is
43    * reserved for invalid depth.
48    * The ending index of depth quantization level. It must be a power of 2.
58    * For each depth value {@code d} within [MIN_DEPTH,MAX_DEPTH], its blur disc
65    * A set of non-overlapping layers that covers all the depth levels. The
72    * The layer in which the focal depth belongs to. <b> For this layer, we
73    * assume that it is a single depth layer. That is, the front depth and back
74    * depth both equal to focal depth.
83    * Returns the blur disk radius of a depth level.
85    * @param depth depth level
86    * @return the blur disk radius of the depth level
88   public float getDiskRadius(int depth) {
89     return diskRadiusArray[depth - MIN_DEPTH];
104    * @return the number of depth levels in the layer
115    * Returns the depth given the layer and the relative depth in the layer.
118    * @param relativeDepthInLayer the relative depth index relative to the back
119    *        depth of a layer
120    * @return the depth
127    * Creates an instance of BlurStack using depth range, focal depth, desired
130    * @param depthTransform an object that translates between floating depth and
131    *        quantized depth.
132    * @param focusDepth3D focus depth in 3D
133    * @param depthOfField the range of depth values around focus depth 3D that
138    *        depth levels
145     // Finds the front and back depth levels for the focus layer.
148       Log.e(TAG, "Negative depth of field");
154     // Computes blur disk radius for all the depth levels.
197    * OpenGL depth is from 0(near) to 255(far). The depth in BlurStack is from
200    * @param openglDepth openGL depth.
201    * @return stackDepth stack depth.
208    * OpenGL depth is from 0(near) to 255(far). The depth in BlurStack is from
211    * @param stackDepth stack depth.
212    * @return openglDepth openGL depth.
225    * Quantizes the depth range into MAX_DEPTH levels in inverse depth space, and
228    * @param depthTransform an object that translates between floating depth and
229    *        quantized depth.
230    * @param frontFocalDepth front focal depth level
231    * @param backFocalDepth back focal depth level
244     // Computes the blur disk radius for each depth level.
245     for (int depth = MIN_DEPTH; depth <= MAX_DEPTH; ++depth) {
247           depthTransform.reconstruct(stackDepthToOpenglDepth(depth));
254       diskRadiusArray[depth - MIN_DEPTH] = Math.min(radius, MAX_DISC_RADIUS);
260    * depth, except that the focal layer contains frontFocalDepth and
265    * @param frontFocalDepth the front depth of focal layer.
266    * @param backFocalDepth the back depth of focal layer.
274     // Pushes single depth layers in front of the focal layer to layerInfo.
276     for (int depth = MAX_DEPTH; depth > frontFocalDepth; --depth, ++layer) {
277       layerInfo[layer] = new LayerInfo(depth);
285     // Pushes single depth layers behind the focal layer to layerInfo.
286     for (int depth = backFocalDepth - 1; depth >= MIN_DEPTH; --depth, ++layer) {
287       layerInfo[layer] = new LayerInfo(depth);
293    * variation due to depth difference is no larger than
299    * @param frontFocalDepth the front depth of focal layer.
300    * @param backFocalDepth the back depth of focal layer.
306     // Groups depth levels behind the focal depth into several layers.
312     // Groups depth levels in front of the focal depth into several layers.
319     // depth layer.
330         // which is ordered from focal depth to front-most.
337         // is ordered from focal depth to back-most.
345    * Groups depth levels behind the focal depth into several layers. The blur
349    * @param backFocalDepth the back depth of focal layer.
351    * @return layerInfo layering of depth levels behind the focal depth
364     // Moves to the first depth behind the focus depth and initializes a layer.
370     // Expands the layer to include depth levels so long as the blur disk
372     // Stops the expansion when current depth is already the minDepth.
374       // Moves to the next depth.
377         // Expands the current layer by lowering its back depth.
381         // Generates a new single-depth layer.
391    * Groups depth levels in front of the focal depth into several layers. The
395    * @param frontFocalDepth the back depth of focal layer.
397    * @return layerInfo layering of depth levels behind the focal depth
410     // Moves to the first depth in front of the focus depth and initializes a
417     // Expands the layer to include depth levels so long as the blur disk
419     // Stops the expansion when current depth is already the maxDepth.
421       // Moves to the next depth.
424         // Expands the current layer by increasing its front depth.
428         // Generates a new single-depth layer.

Indexes created Wed Aug 24 13:21:36 CEST 2016