1 /*
   2  * Copyright (c) 2007, 2016, Oracle and/or its affiliates. All rights reserved.
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * This code is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License version 2 only, as
   7  * published by the Free Software Foundation.  Oracle designates this
   8  * particular file as subject to the "Classpath" exception as provided
   9  * by Oracle in the LICENSE file that accompanied this code.
  10  *
  11  * This code is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package com.sun.marlin;
  27 
  28 import static com.sun.marlin.OffHeapArray.SIZE_INT;
  29 import jdk.internal.misc.Unsafe;
  30 
  31 public final class RendererNoAA implements MarlinRenderer, MarlinConst {
  32 
  33     static final boolean DISABLE_RENDER = false;
  34 
  35     private static final int ALL_BUT_LSB = 0xFFFFFFFE;
  36     private static final int ERR_STEP_MAX = 0x7FFFFFFF; // = 2^31 - 1
  37 
  38     private static final double POWER_2_TO_32 = 0x1.0p32;
  39 
  40     // 2048 (pixelSize) pixels (height) x 8 subpixels = 64K
  41     static final int INITIAL_BUCKET_ARRAY = INITIAL_PIXEL_DIM;
  42 
  43     // crossing capacity = edges count / 4 ~ 1024
  44     static final int INITIAL_CROSSING_COUNT = INITIAL_EDGES_COUNT >> 2;
  45 
  46     // common to all types of input path segments.
  47     // OFFSET as bytes
  48     // only integer values:
  49     public static final long OFF_CURX_OR  = 0;
  50     public static final long OFF_ERROR    = OFF_CURX_OR  + SIZE_INT;
  51     public static final long OFF_BUMP_X   = OFF_ERROR    + SIZE_INT;
  52     public static final long OFF_BUMP_ERR = OFF_BUMP_X   + SIZE_INT;
  53     public static final long OFF_NEXT     = OFF_BUMP_ERR + SIZE_INT;
  54     public static final long OFF_YMAX     = OFF_NEXT     + SIZE_INT;
  55 
  56     // size of one edge in bytes
  57     public static final int SIZEOF_EDGE_BYTES = (int)(OFF_YMAX + SIZE_INT);
  58 
  59     // curve break into lines
  60     // cubic error in subpixels to decrement step
  61     private static final float CUB_DEC_ERR_SUBPIX
  62         = 1.0f * (1.0f / 8.0f); // 1 pixel
  63     // cubic error in subpixels to increment step
  64     private static final float CUB_INC_ERR_SUBPIX
  65         = 0.4f * (1.0f / 8.0f); // 0.4 pixel
  66 
  67     // bad paths (59294/100000 == 59,29%, 94335 bad pixels (avg = 1,59), 3966 warnings (avg = 0,07)
  68 
  69     // cubic bind length to decrement step
  70     public static final float CUB_DEC_BND
  71         = 8.0f * CUB_DEC_ERR_SUBPIX;
  72     // cubic bind length to increment step
  73     public static final float CUB_INC_BND
  74         = 8.0f * CUB_INC_ERR_SUBPIX;
  75 
  76     // cubic countlg
  77     public static final int CUB_COUNT_LG = 2;
  78     // cubic count = 2^countlg
  79     private static final int CUB_COUNT = 1 << CUB_COUNT_LG;
  80     // cubic count^2 = 4^countlg
  81     private static final int CUB_COUNT_2 = 1 << (2 * CUB_COUNT_LG);
  82     // cubic count^3 = 8^countlg
  83     private static final int CUB_COUNT_3 = 1 << (3 * CUB_COUNT_LG);
  84     // cubic dt = 1 / count
  85     private static final float CUB_INV_COUNT = 1.0f / CUB_COUNT;
  86     // cubic dt^2 = 1 / count^2 = 1 / 4^countlg
  87     private static final float CUB_INV_COUNT_2 = 1.0f / CUB_COUNT_2;
  88     // cubic dt^3 = 1 / count^3 = 1 / 8^countlg
  89     private static final float CUB_INV_COUNT_3 = 1.0f / CUB_COUNT_3;
  90 
  91     // quad break into lines
  92     // quadratic error in subpixels
  93     private static final float QUAD_DEC_ERR_SUBPIX
  94         = 0.5f * (1.0f / 8.0f); // 0.5 pixel
  95 
  96     // bad paths (62916/100000 == 62,92%, 103818 bad pixels (avg = 1,65), 6514 warnings (avg = 0,10)
  97 
  98     // quadratic bind length to decrement step
  99     public static final float QUAD_DEC_BND
 100         = 8.0f * QUAD_DEC_ERR_SUBPIX;
 101 
 102 //////////////////////////////////////////////////////////////////////////////
 103 //  SCAN LINE
 104 //////////////////////////////////////////////////////////////////////////////
 105     // crossings ie subpixel edge x coordinates
 106     private int[] crossings;
 107     // auxiliary storage for crossings (merge sort)
 108     private int[] aux_crossings;
 109 
 110     // indices into the segment pointer lists. They indicate the "active"
 111     // sublist in the segment lists (the portion of the list that contains
 112     // all the segments that cross the next scan line).
 113     private int edgeCount;
 114     private int[] edgePtrs;
 115     // auxiliary storage for edge pointers (merge sort)
 116     private int[] aux_edgePtrs;
 117 
 118     // max used for both edgePtrs and crossings (stats only)
 119     private int activeEdgeMaxUsed;
 120 
 121     // crossings ref (dirty)
 122     private final IntArrayCache.Reference crossings_ref;
 123     // edgePtrs ref (dirty)
 124     private final IntArrayCache.Reference edgePtrs_ref;
 125     // merge sort initial arrays (large enough to satisfy most usages) (1024)
 126     // aux_crossings ref (dirty)
 127     private final IntArrayCache.Reference aux_crossings_ref;
 128     // aux_edgePtrs ref (dirty)
 129     private final IntArrayCache.Reference aux_edgePtrs_ref;
 130 
 131 //////////////////////////////////////////////////////////////////////////////
 132 //  EDGE LIST
 133 //////////////////////////////////////////////////////////////////////////////
 134     private int edgeMinY = Integer.MAX_VALUE;
 135     private int edgeMaxY = Integer.MIN_VALUE;
 136     private float edgeMinX = Float.POSITIVE_INFINITY;
 137     private float edgeMaxX = Float.NEGATIVE_INFINITY;
 138 
 139     // edges [ints] stored in off-heap memory
 140     private final OffHeapArray edges;
 141 
 142     private int[] edgeBuckets;
 143     private int[] edgeBucketCounts; // 2*newedges + (1 if pruning needed)
 144     // used range for edgeBuckets / edgeBucketCounts
 145     private int buckets_minY;
 146     private int buckets_maxY;
 147 
 148     // edgeBuckets ref (clean)
 149     private final IntArrayCache.Reference edgeBuckets_ref;
 150     // edgeBucketCounts ref (clean)
 151     private final IntArrayCache.Reference edgeBucketCounts_ref;
 152 
 153     boolean useRLE = false;
 154 
 155     // Flattens using adaptive forward differencing. This only carries out
 156     // one iteration of the AFD loop. All it does is update AFD variables (i.e.
 157     // X0, Y0, D*[X|Y], COUNT; not variables used for computing scanline crossings).
 158     private void quadBreakIntoLinesAndAdd(float x0, float y0,
 159                                           final Curve c,
 160                                           final float x2, final float y2)
 161     {
 162         int count = 1; // dt = 1 / count
 163 
 164         // maximum(ddX|Y) = norm(dbx, dby) * dt^2 (= 1)
 165         float maxDD = Math.abs(c.dbx) + Math.abs(c.dby);
 166 
 167         final float _DEC_BND = QUAD_DEC_BND;
 168 
 169         while (maxDD >= _DEC_BND) {
 170             // divide step by half:
 171             maxDD /= 4.0f; // error divided by 2^2 = 4
 172 
 173             count <<= 1;
 174             if (DO_STATS) {
 175                 rdrCtx.stats.stat_rdr_quadBreak_dec.add(count);
 176             }
 177         }
 178 
 179         int nL = 0; // line count
 180         if (count > 1) {
 181             final float icount = 1.0f / count; // dt
 182             final float icount2 = icount * icount; // dt^2
 183 
 184             final float ddx = c.dbx * icount2;
 185             final float ddy = c.dby * icount2;
 186             float dx = c.bx * icount2 + c.cx * icount;
 187             float dy = c.by * icount2 + c.cy * icount;
 188 
 189             float x1, y1;
 190 
 191             while (--count > 0) {
 192                 x1 = x0 + dx;
 193                 dx += ddx;
 194                 y1 = y0 + dy;
 195                 dy += ddy;
 196 
 197                 addLine(x0, y0, x1, y1);
 198 
 199                 if (DO_STATS) { nL++; }
 200                 x0 = x1;
 201                 y0 = y1;
 202             }
 203         }
 204         addLine(x0, y0, x2, y2);
 205 
 206         if (DO_STATS) {
 207             rdrCtx.stats.stat_rdr_quadBreak.add(nL + 1);
 208         }
 209     }
 210 
 211     // x0, y0 and x3,y3 are the endpoints of the curve. We could compute these
 212     // using c.xat(0),c.yat(0) and c.xat(1),c.yat(1), but this might introduce
 213     // numerical errors, and our callers already have the exact values.
 214     // Another alternative would be to pass all the control points, and call
 215     // c.set here, but then too many numbers are passed around.
 216     private void curveBreakIntoLinesAndAdd(float x0, float y0,
 217                                            final Curve c,
 218                                            final float x3, final float y3)
 219     {
 220         int count           = CUB_COUNT;
 221         final float icount  = CUB_INV_COUNT;   // dt
 222         final float icount2 = CUB_INV_COUNT_2; // dt^2
 223         final float icount3 = CUB_INV_COUNT_3; // dt^3
 224 
 225         // the dx and dy refer to forward differencing variables, not the last
 226         // coefficients of the "points" polynomial
 227         float dddx, dddy, ddx, ddy, dx, dy;
 228         dddx = 2.0f * c.dax * icount3;
 229         dddy = 2.0f * c.day * icount3;
 230         ddx = dddx + c.dbx * icount2;
 231         ddy = dddy + c.dby * icount2;
 232         dx = c.ax * icount3 + c.bx * icount2 + c.cx * icount;
 233         dy = c.ay * icount3 + c.by * icount2 + c.cy * icount;
 234 
 235         // we use x0, y0 to walk the line
 236         float x1 = x0, y1 = y0;
 237         int nL = 0; // line count
 238 
 239         final float _DEC_BND = CUB_DEC_BND;
 240         final float _INC_BND = CUB_INC_BND;
 241 
 242         while (count > 0) {
 243             // divide step by half:
 244             while (Math.abs(ddx) + Math.abs(ddy) >= _DEC_BND) {
 245                 dddx /= 8.0f;
 246                 dddy /= 8.0f;
 247                 ddx = ddx / 4.0f - dddx;
 248                 ddy = ddy / 4.0f - dddy;
 249                 dx = (dx - ddx) / 2.0f;
 250                 dy = (dy - ddy) / 2.0f;
 251 
 252                 count <<= 1;
 253                 if (DO_STATS) {
 254                     rdrCtx.stats.stat_rdr_curveBreak_dec.add(count);
 255                 }
 256             }
 257 
 258             // double step:
 259             // can only do this on even "count" values, because we must divide count by 2
 260             while (count % 2 == 0
 261                    && Math.abs(dx) + Math.abs(dy) <= _INC_BND)
 262             {
 263                 dx = 2.0f * dx + ddx;
 264                 dy = 2.0f * dy + ddy;
 265                 ddx = 4.0f * (ddx + dddx);
 266                 ddy = 4.0f * (ddy + dddy);
 267                 dddx *= 8.0f;
 268                 dddy *= 8.0f;
 269 
 270                 count >>= 1;
 271                 if (DO_STATS) {
 272                     rdrCtx.stats.stat_rdr_curveBreak_inc.add(count);
 273                 }
 274             }
 275             if (--count > 0) {
 276                 x1 += dx;
 277                 dx += ddx;
 278                 ddx += dddx;
 279                 y1 += dy;
 280                 dy += ddy;
 281                 ddy += dddy;
 282             } else {
 283                 x1 = x3;
 284                 y1 = y3;
 285             }
 286 
 287             addLine(x0, y0, x1, y1);
 288 
 289             if (DO_STATS) { nL++; }
 290             x0 = x1;
 291             y0 = y1;
 292         }
 293         if (DO_STATS) {
 294             rdrCtx.stats.stat_rdr_curveBreak.add(nL);
 295         }
 296     }
 297 
 298     private void addLine(float x1, float y1, float x2, float y2) {
 299         if (DO_MONITORS) {
 300             rdrCtx.stats.mon_rdr_addLine.start();
 301         }
 302         if (DO_STATS) {
 303             rdrCtx.stats.stat_rdr_addLine.add(1);
 304         }
 305         int or = 1; // orientation of the line. 1 if y increases, 0 otherwise.
 306         if (y2 < y1) {
 307             or = 0;
 308             float tmp = y2;
 309             y2 = y1;
 310             y1 = tmp;
 311             tmp = x2;
 312             x2 = x1;
 313             x1 = tmp;
 314         }
 315 
 316         // convert subpixel coordinates [float] into pixel positions [int]
 317 
 318         // The index of the pixel that holds the next HPC is at ceil(trueY - 0.5)
 319         // Since y1 and y2 are biased by -0.5 in tosubpixy(), this is simply
 320         // ceil(y1) or ceil(y2)
 321         // upper integer (inclusive)
 322         final int firstCrossing = FloatMath.max(FloatMath.ceil_int(y1), boundsMinY);
 323 
 324         // note: use boundsMaxY (last Y exclusive) to compute correct coverage
 325         // upper integer (exclusive)
 326         final int lastCrossing  = FloatMath.min(FloatMath.ceil_int(y2), boundsMaxY);
 327 
 328         /* skip horizontal lines in pixel space and clip edges
 329            out of y range [boundsMinY; boundsMaxY] */
 330         if (firstCrossing >= lastCrossing) {
 331             if (DO_MONITORS) {
 332                 rdrCtx.stats.mon_rdr_addLine.stop();
 333             }
 334             if (DO_STATS) {
 335                 rdrCtx.stats.stat_rdr_addLine_skip.add(1);
 336             }
 337             return;
 338         }
 339 
 340         // edge min/max X/Y are in subpixel space (half-open interval):
 341         // note: Use integer crossings to ensure consistent range within
 342         // edgeBuckets / edgeBucketCounts arrays in case of NaN values (int = 0)
 343         if (firstCrossing < edgeMinY) {
 344             edgeMinY = firstCrossing;
 345         }
 346         if (lastCrossing > edgeMaxY) {
 347             edgeMaxY = lastCrossing;
 348         }
 349 
 350         // Use double-precision for improved accuracy:
 351         final double x1d   = x1;
 352         final double y1d   = y1;
 353         final double slope = (x1d - x2) / (y1d - y2);
 354 
 355         if (slope >= 0.0d) { // <==> x1 < x2
 356             if (x1 < edgeMinX) {
 357                 edgeMinX = x1;
 358             }
 359             if (x2 > edgeMaxX) {
 360                 edgeMaxX = x2;
 361             }
 362         } else {
 363             if (x2 < edgeMinX) {
 364                 edgeMinX = x2;
 365             }
 366             if (x1 > edgeMaxX) {
 367                 edgeMaxX = x1;
 368             }
 369         }
 370 
 371         // local variables for performance:
 372         final int _SIZEOF_EDGE_BYTES = SIZEOF_EDGE_BYTES;
 373 
 374         final OffHeapArray _edges = edges;
 375 
 376         // get free pointer (ie length in bytes)
 377         final int edgePtr = _edges.used;
 378 
 379         // use substraction to avoid integer overflow:
 380         if (_edges.length - edgePtr < _SIZEOF_EDGE_BYTES) {
 381             // suppose _edges.length > _SIZEOF_EDGE_BYTES
 382             // so doubling size is enough to add needed bytes
 383             // note: throw IOOB if neededSize > 2Gb:
 384             final long edgeNewSize = ArrayCacheConst.getNewLargeSize(
 385                                         _edges.length,
 386                                         edgePtr + _SIZEOF_EDGE_BYTES);
 387 
 388             if (DO_STATS) {
 389                 rdrCtx.stats.stat_rdr_edges_resizes.add(edgeNewSize);
 390             }
 391             _edges.resize(edgeNewSize);
 392         }
 393 
 394 
 395         final Unsafe _unsafe = OffHeapArray.UNSAFE;
 396         final long SIZE_INT = 4L;
 397         long addr   = _edges.address + edgePtr;
 398 
 399         // The x value must be bumped up to its position at the next HPC we will evaluate.
 400         // "firstcrossing" is the (sub)pixel number where the next crossing occurs
 401         // thus, the actual coordinate of the next HPC is "firstcrossing + 0.5"
 402         // so the Y distance we cover is "firstcrossing + 0.5 - trueY".
 403         // Note that since y1 (and y2) are already biased by -0.5 in tosubpixy(), we have
 404         // y1 = trueY - 0.5
 405         // trueY = y1 + 0.5
 406         // firstcrossing + 0.5 - trueY = firstcrossing + 0.5 - (y1 + 0.5)
 407         //                             = firstcrossing - y1
 408         // The x coordinate at that HPC is then:
 409         // x1_intercept = x1 + (firstcrossing - y1) * slope
 410         // The next VPC is then given by:
 411         // VPC index = ceil(x1_intercept - 0.5), or alternately
 412         // VPC index = floor(x1_intercept - 0.5 + 1 - epsilon)
 413         // epsilon is hard to pin down in floating point, but easy in fixed point, so if
 414         // we convert to fixed point then these operations get easier:
 415         // long x1_fixed = x1_intercept * 2^32;  (fixed point 32.32 format)
 416         // curx = next VPC = fixed_floor(x1_fixed - 2^31 + 2^32 - 1)
 417         //                 = fixed_floor(x1_fixed + 2^31 - 1)
 418         //                 = fixed_floor(x1_fixed + 0x7FFFFFFF)
 419         // and error       = fixed_fract(x1_fixed + 0x7FFFFFFF)
 420         final double x1_intercept = x1d + (firstCrossing - y1d) * slope;
 421 
 422         // inlined scalb(x1_intercept, 32):
 423         final long x1_fixed_biased = ((long) (POWER_2_TO_32 * x1_intercept))
 424                                      + 0x7FFFFFFFL;
 425         // curx:
 426         // last bit corresponds to the orientation
 427         _unsafe.putInt(addr, (((int) (x1_fixed_biased >> 31L)) & ALL_BUT_LSB) | or);
 428         addr += SIZE_INT;
 429         _unsafe.putInt(addr,  ((int)  x1_fixed_biased) >>> 1);
 430         addr += SIZE_INT;
 431 
 432         // inlined scalb(slope, 32):
 433         final long slope_fixed = (long) (POWER_2_TO_32 * slope);
 434 
 435         // last bit set to 0 to keep orientation:
 436         _unsafe.putInt(addr, (((int) (slope_fixed >> 31L)) & ALL_BUT_LSB));
 437         addr += SIZE_INT;
 438         _unsafe.putInt(addr,  ((int)  slope_fixed) >>> 1);
 439         addr += SIZE_INT;
 440 
 441         final int[] _edgeBuckets      = edgeBuckets;
 442         final int[] _edgeBucketCounts = edgeBucketCounts;
 443 
 444         final int _boundsMinY = boundsMinY;
 445 
 446         // each bucket is a linked list. this method adds ptr to the
 447         // start of the "bucket"th linked list.
 448         final int bucketIdx = firstCrossing - _boundsMinY;
 449 
 450         // pointer from bucket
 451         _unsafe.putInt(addr, _edgeBuckets[bucketIdx]);
 452         addr += SIZE_INT;
 453         // y max (exclusive)
 454         _unsafe.putInt(addr,  lastCrossing);
 455 
 456         // Update buckets:
 457         // directly the edge struct "pointer"
 458         _edgeBuckets[bucketIdx]       = edgePtr;
 459         _edgeBucketCounts[bucketIdx] += 2; // 1 << 1
 460         // last bit means edge end
 461         _edgeBucketCounts[lastCrossing - _boundsMinY] |= 0x1;
 462 
 463         // update free pointer (ie length in bytes)
 464         _edges.used += _SIZEOF_EDGE_BYTES;
 465 
 466         if (DO_MONITORS) {
 467             rdrCtx.stats.mon_rdr_addLine.stop();
 468         }
 469     }
 470 
 471 // END EDGE LIST
 472 //////////////////////////////////////////////////////////////////////////////
 473 
 474     // Bounds of the drawing region, at subpixel precision.
 475     private int boundsMinX, boundsMinY, boundsMaxX, boundsMaxY;
 476 
 477     // Current winding rule
 478     private int windingRule;
 479 
 480     // Current drawing position, i.e., final point of last segment
 481     private float x0, y0;
 482 
 483     // Position of most recent 'moveTo' command
 484     private float sx0, sy0;
 485 
 486     // per-thread renderer context
 487     final RendererContext rdrCtx;
 488     // dirty curve
 489     private final Curve curve;
 490 
 491     // clean alpha array (zero filled)
 492     private int[] alphaLine;
 493 
 494     // alphaLine ref (clean)
 495     private final IntArrayCache.Reference alphaLine_ref;
 496 
 497     private boolean enableBlkFlags = false;
 498     private boolean prevUseBlkFlags = false;
 499 
 500     /* block flags (0|1) */
 501     private int[] blkFlags;
 502 
 503     // blkFlags ref (clean)
 504     private final IntArrayCache.Reference blkFlags_ref;
 505 
 506     RendererNoAA(final RendererContext rdrCtx) {
 507         this.rdrCtx = rdrCtx;
 508 
 509         this.edges = rdrCtx.newOffHeapArray(INITIAL_EDGES_CAPACITY); // 96K
 510 
 511         this.curve = rdrCtx.curve;
 512 
 513         edgeBuckets_ref      = rdrCtx.newCleanIntArrayRef(INITIAL_BUCKET_ARRAY); // 64K
 514         edgeBucketCounts_ref = rdrCtx.newCleanIntArrayRef(INITIAL_BUCKET_ARRAY); // 64K
 515 
 516         edgeBuckets      = edgeBuckets_ref.initial;
 517         edgeBucketCounts = edgeBucketCounts_ref.initial;
 518 
 519         // 2048 (pixelsize) pixel large
 520         alphaLine_ref = rdrCtx.newCleanIntArrayRef(INITIAL_AA_ARRAY); // 8K
 521         alphaLine     = alphaLine_ref.initial;
 522 
 523         crossings_ref     = rdrCtx.newDirtyIntArrayRef(INITIAL_CROSSING_COUNT); // 2K
 524         aux_crossings_ref = rdrCtx.newDirtyIntArrayRef(INITIAL_CROSSING_COUNT); // 2K
 525         edgePtrs_ref      = rdrCtx.newDirtyIntArrayRef(INITIAL_CROSSING_COUNT); // 2K
 526         aux_edgePtrs_ref  = rdrCtx.newDirtyIntArrayRef(INITIAL_CROSSING_COUNT); // 2K
 527 
 528         crossings     = crossings_ref.initial;
 529         aux_crossings = aux_crossings_ref.initial;
 530         edgePtrs      = edgePtrs_ref.initial;
 531         aux_edgePtrs  = aux_edgePtrs_ref.initial;
 532 
 533         blkFlags_ref = rdrCtx.newCleanIntArrayRef(INITIAL_ARRAY); // 1K = 1 tile line
 534         blkFlags     = blkFlags_ref.initial;
 535     }
 536 
 537     public RendererNoAA init(final int pix_boundsX, final int pix_boundsY,
 538                   final int pix_boundsWidth, final int pix_boundsHeight,
 539                   final int windingRule)
 540     {
 541         this.windingRule = windingRule;
 542 
 543         // bounds as half-open intervals: minX <= x < maxX and minY <= y < maxY
 544         this.boundsMinX = pix_boundsX;
 545         this.boundsMaxX = pix_boundsX + pix_boundsWidth;
 546         this.boundsMinY = pix_boundsY;
 547         this.boundsMaxY = pix_boundsY + pix_boundsHeight;
 548 
 549         if (DO_LOG_BOUNDS) {
 550             MarlinUtils.logInfo("boundsXY = [" + boundsMinX + " ... "
 551                                 + boundsMaxX + "[ [" + boundsMinY + " ... "
 552                                 + boundsMaxY + "[");
 553         }
 554 
 555         // see addLine: ceil(boundsMaxY) => boundsMaxY + 1
 556         // +1 for edgeBucketCounts
 557         final int edgeBucketsLength = (boundsMaxY - boundsMinY) + 1;
 558 
 559         if (edgeBucketsLength > INITIAL_BUCKET_ARRAY) {
 560             if (DO_STATS) {
 561                 rdrCtx.stats.stat_array_renderer_edgeBuckets
 562                     .add(edgeBucketsLength);
 563                 rdrCtx.stats.stat_array_renderer_edgeBucketCounts
 564                     .add(edgeBucketsLength);
 565             }
 566             edgeBuckets = edgeBuckets_ref.getArray(edgeBucketsLength);
 567             edgeBucketCounts = edgeBucketCounts_ref.getArray(edgeBucketsLength);
 568         }
 569 
 570         edgeMinY = Integer.MAX_VALUE;
 571         edgeMaxY = Integer.MIN_VALUE;
 572         edgeMinX = Float.POSITIVE_INFINITY;
 573         edgeMaxX = Float.NEGATIVE_INFINITY;
 574 
 575         // reset used mark:
 576         edgeCount = 0;
 577         activeEdgeMaxUsed = 0;
 578         edges.used = 0;
 579 
 580         // reset bbox:
 581         bboxX0 = 0;
 582         bboxX1 = 0;
 583 
 584         return this; // fluent API
 585     }
 586 
 587     /**
 588      * Disposes this renderer and recycle it clean up before reusing this instance
 589      */
 590     public void dispose() {
 591         if (DO_STATS) {
 592             rdrCtx.stats.stat_rdr_activeEdges.add(activeEdgeMaxUsed);
 593             rdrCtx.stats.stat_rdr_edges.add(edges.used);
 594             rdrCtx.stats.stat_rdr_edges_count.add(edges.used / SIZEOF_EDGE_BYTES);
 595             rdrCtx.stats.hist_rdr_edges_count.add(edges.used / SIZEOF_EDGE_BYTES);
 596             rdrCtx.stats.totalOffHeap += edges.length;
 597         }
 598         // Return arrays:
 599         crossings = crossings_ref.putArray(crossings);
 600         aux_crossings = aux_crossings_ref.putArray(aux_crossings);
 601 
 602         edgePtrs = edgePtrs_ref.putArray(edgePtrs);
 603         aux_edgePtrs = aux_edgePtrs_ref.putArray(aux_edgePtrs);
 604 
 605         alphaLine = alphaLine_ref.putArray(alphaLine, 0, 0); // already zero filled
 606         blkFlags  = blkFlags_ref.putArray(blkFlags, 0, 0); // already zero filled
 607 
 608         if (edgeMinY != Integer.MAX_VALUE) {
 609             // if context is maked as DIRTY:
 610             if (rdrCtx.dirty) {
 611                 // may happen if an exception if thrown in the pipeline processing:
 612                 // clear completely buckets arrays:
 613                 buckets_minY = 0;
 614                 buckets_maxY = boundsMaxY - boundsMinY;
 615             }
 616             // clear only used part
 617             edgeBuckets = edgeBuckets_ref.putArray(edgeBuckets, buckets_minY,
 618                                                                 buckets_maxY);
 619             edgeBucketCounts = edgeBucketCounts_ref.putArray(edgeBucketCounts,
 620                                                              buckets_minY,
 621                                                              buckets_maxY + 1);
 622         } else {
 623             // unused arrays
 624             edgeBuckets = edgeBuckets_ref.putArray(edgeBuckets, 0, 0);
 625             edgeBucketCounts = edgeBucketCounts_ref.putArray(edgeBucketCounts, 0, 0);
 626         }
 627 
 628         // At last: resize back off-heap edges to initial size
 629         if (edges.length != INITIAL_EDGES_CAPACITY) {
 630             // note: may throw OOME:
 631             edges.resize(INITIAL_EDGES_CAPACITY);
 632         }
 633         if (DO_CLEAN_DIRTY) {
 634             // Force zero-fill dirty arrays:
 635             edges.fill(BYTE_0);
 636         }
 637         if (DO_MONITORS) {
 638             rdrCtx.stats.mon_rdr_endRendering.stop();
 639         }
 640     }
 641 
 642     private static float tosubpixx(final float pix_x) {
 643         return pix_x;
 644     }
 645 
 646     private static float tosubpixy(final float pix_y) {
 647         // shift y by -0.5 for fast ceil(y - 0.5):
 648         return pix_y - 0.5f;
 649     }
 650 
 651     @Override
 652     public void moveTo(float pix_x0, float pix_y0) {
 653         closePath();
 654         final float sx = tosubpixx(pix_x0);
 655         final float sy = tosubpixy(pix_y0);
 656         this.sx0 = sx;
 657         this.sy0 = sy;
 658         this.x0 = sx;
 659         this.y0 = sy;
 660     }
 661 
 662     @Override
 663     public void lineTo(float pix_x1, float pix_y1) {
 664         final float x1 = tosubpixx(pix_x1);
 665         final float y1 = tosubpixy(pix_y1);
 666         addLine(x0, y0, x1, y1);
 667         x0 = x1;
 668         y0 = y1;
 669     }
 670 
 671     @Override
 672     public void curveTo(float x1, float y1,
 673             float x2, float y2,
 674             float x3, float y3)
 675     {
 676         final float xe = tosubpixx(x3);
 677         final float ye = tosubpixy(y3);
 678         curve.set(x0, y0, tosubpixx(x1), tosubpixy(y1),
 679                           tosubpixx(x2), tosubpixy(y2), xe, ye);
 680         curveBreakIntoLinesAndAdd(x0, y0, curve, xe, ye);
 681         x0 = xe;
 682         y0 = ye;
 683     }
 684 
 685     @Override
 686     public void quadTo(float x1, float y1, float x2, float y2) {
 687         final float xe = tosubpixx(x2);
 688         final float ye = tosubpixy(y2);
 689         curve.set(x0, y0, tosubpixx(x1), tosubpixy(y1), xe, ye);
 690         quadBreakIntoLinesAndAdd(x0, y0, curve, xe, ye);
 691         x0 = xe;
 692         y0 = ye;
 693     }
 694 
 695     @Override
 696     public void closePath() {
 697         addLine(x0, y0, sx0, sy0);
 698         x0 = sx0;
 699         y0 = sy0;
 700     }
 701 
 702     @Override
 703     public void pathDone() {
 704         closePath();
 705 
 706         // call endRendering() to determine the boundaries:
 707         endRendering();
 708     }
 709 
 710     private void _endRendering(final int ymin, final int ymax,
 711                                final MarlinAlphaConsumer ac)
 712     {
 713         if (DISABLE_RENDER) {
 714             return;
 715         }
 716 
 717         // Get X bounds as true pixel boundaries to compute correct pixel coverage:
 718         final int bboxx0 = bbox_spminX;
 719         final int bboxx1 = bbox_spmaxX;
 720 
 721         final boolean windingRuleEvenOdd = (windingRule == WIND_EVEN_ODD);
 722 
 723         // Useful when processing tile line by tile line
 724         final int[] _alpha = alphaLine;
 725 
 726         // local vars (performance):
 727         final OffHeapArray _edges = edges;
 728         final int[] _edgeBuckets = edgeBuckets;
 729         final int[] _edgeBucketCounts = edgeBucketCounts;
 730 
 731         int[] _crossings = this.crossings;
 732         int[] _edgePtrs  = this.edgePtrs;
 733 
 734         // merge sort auxiliary storage:
 735         int[] _aux_crossings = this.aux_crossings;
 736         int[] _aux_edgePtrs  = this.aux_edgePtrs;
 737 
 738         // copy constants:
 739         final long _OFF_ERROR    = OFF_ERROR;
 740         final long _OFF_BUMP_X   = OFF_BUMP_X;
 741         final long _OFF_BUMP_ERR = OFF_BUMP_ERR;
 742 
 743         final long _OFF_NEXT     = OFF_NEXT;
 744         final long _OFF_YMAX     = OFF_YMAX;
 745 
 746         final int _ALL_BUT_LSB   = ALL_BUT_LSB;
 747         final int _ERR_STEP_MAX  = ERR_STEP_MAX;
 748 
 749         // unsafe I/O:
 750         final Unsafe _unsafe = OffHeapArray.UNSAFE;
 751         final long    addr0  = _edges.address;
 752         long addr;
 753 
 754         final int _MIN_VALUE = Integer.MIN_VALUE;
 755         final int _MAX_VALUE = Integer.MAX_VALUE;
 756 
 757         // Now we iterate through the scanlines. We must tell emitRow the coord
 758         // of the first non-transparent pixel, so we must keep accumulators for
 759         // the first and last pixels of the section of the current pixel row
 760         // that we will emit.
 761         // We also need to accumulate pix_bbox, but the iterator does it
 762         // for us. We will just get the values from it once this loop is done
 763         int minX = _MAX_VALUE;
 764         int maxX = _MIN_VALUE;
 765 
 766         int y = ymin;
 767         int bucket = y - boundsMinY;
 768 
 769         int numCrossings = this.edgeCount;
 770         int edgePtrsLen = _edgePtrs.length;
 771         int crossingsLen = _crossings.length;
 772         int _arrayMaxUsed = activeEdgeMaxUsed;
 773         int ptrLen = 0, newCount, ptrEnd;
 774 
 775         int bucketcount, i, j, ecur;
 776         int cross, lastCross;
 777         int x0, x1, tmp, sum, prev, curx, curxo, crorientation, err;
 778 
 779         int low, high, mid, prevNumCrossings;
 780         boolean useBinarySearch;
 781 
 782         final int[] _blkFlags = blkFlags;
 783         final int _BLK_SIZE_LG = BLOCK_SIZE_LG;
 784         final int _BLK_SIZE = BLOCK_SIZE;
 785 
 786         final boolean _enableBlkFlagsHeuristics = ENABLE_BLOCK_FLAGS_HEURISTICS && this.enableBlkFlags;
 787 
 788         // Use block flags if large pixel span and few crossings:
 789         // ie mean(distance between crossings) is high
 790         boolean useBlkFlags = this.prevUseBlkFlags;
 791 
 792         final int stroking = rdrCtx.stroking;
 793 
 794         int lastY = -1; // last emited row
 795 
 796 
 797         // Iteration on scanlines
 798         for (; y < ymax; y++, bucket++) {
 799             // --- from former ScanLineIterator.next()
 800             bucketcount = _edgeBucketCounts[bucket];
 801 
 802             // marker on previously sorted edges:
 803             prevNumCrossings = numCrossings;
 804 
 805             // bucketCount indicates new edge / edge end:
 806             if (bucketcount != 0) {
 807                 if (DO_STATS) {
 808                     rdrCtx.stats.stat_rdr_activeEdges_updates.add(numCrossings);
 809                 }
 810 
 811                 // last bit set to 1 means that edges ends
 812                 if ((bucketcount & 0x1) != 0) {
 813                     // eviction in active edge list
 814                     // cache edges[] address + offset
 815                     addr = addr0 + _OFF_YMAX;
 816 
 817                     for (i = 0, newCount = 0; i < numCrossings; i++) {
 818                         // get the pointer to the edge
 819                         ecur = _edgePtrs[i];
 820                         // random access so use unsafe:
 821                         if (_unsafe.getInt(addr + ecur) > y) {
 822                             _edgePtrs[newCount++] = ecur;
 823                         }
 824                     }
 825                     // update marker on sorted edges minus removed edges:
 826                     prevNumCrossings = numCrossings = newCount;
 827                 }
 828 
 829                 ptrLen = bucketcount >> 1; // number of new edge
 830 
 831                 if (ptrLen != 0) {
 832                     if (DO_STATS) {
 833                         rdrCtx.stats.stat_rdr_activeEdges_adds.add(ptrLen);
 834                         if (ptrLen > 10) {
 835                             rdrCtx.stats.stat_rdr_activeEdges_adds_high.add(ptrLen);
 836                         }
 837                     }
 838                     ptrEnd = numCrossings + ptrLen;
 839 
 840                     if (edgePtrsLen < ptrEnd) {
 841                         if (DO_STATS) {
 842                             rdrCtx.stats.stat_array_renderer_edgePtrs.add(ptrEnd);
 843                         }
 844                         this.edgePtrs = _edgePtrs
 845                             = edgePtrs_ref.widenArray(_edgePtrs, numCrossings,
 846                                                       ptrEnd);
 847 
 848                         edgePtrsLen = _edgePtrs.length;
 849                         // Get larger auxiliary storage:
 850                         aux_edgePtrs_ref.putArray(_aux_edgePtrs);
 851 
 852                         // use ArrayCache.getNewSize() to use the same growing
 853                         // factor than widenArray():
 854                         if (DO_STATS) {
 855                             rdrCtx.stats.stat_array_renderer_aux_edgePtrs.add(ptrEnd);
 856                         }
 857                         this.aux_edgePtrs = _aux_edgePtrs
 858                             = aux_edgePtrs_ref.getArray(
 859                                 ArrayCacheConst.getNewSize(numCrossings, ptrEnd)
 860                             );
 861                     }
 862 
 863                     // cache edges[] address + offset
 864                     addr = addr0 + _OFF_NEXT;
 865 
 866                     // add new edges to active edge list:
 867                     for (ecur = _edgeBuckets[bucket];
 868                          numCrossings < ptrEnd; numCrossings++)
 869                     {
 870                         // store the pointer to the edge
 871                         _edgePtrs[numCrossings] = ecur;
 872                         // random access so use unsafe:
 873                         ecur = _unsafe.getInt(addr + ecur);
 874                     }
 875 
 876                     if (crossingsLen < numCrossings) {
 877                         // Get larger array:
 878                         crossings_ref.putArray(_crossings);
 879 
 880                         if (DO_STATS) {
 881                             rdrCtx.stats.stat_array_renderer_crossings
 882                                 .add(numCrossings);
 883                         }
 884                         this.crossings = _crossings
 885                             = crossings_ref.getArray(numCrossings);
 886 
 887                         // Get larger auxiliary storage:
 888                         aux_crossings_ref.putArray(_aux_crossings);
 889 
 890                         if (DO_STATS) {
 891                             rdrCtx.stats.stat_array_renderer_aux_crossings
 892                                 .add(numCrossings);
 893                         }
 894                         this.aux_crossings = _aux_crossings
 895                             = aux_crossings_ref.getArray(numCrossings);
 896 
 897                         crossingsLen = _crossings.length;
 898                     }
 899                     if (DO_STATS) {
 900                         // update max used mark
 901                         if (numCrossings > _arrayMaxUsed) {
 902                             _arrayMaxUsed = numCrossings;
 903                         }
 904                     }
 905                 } // ptrLen != 0
 906             } // bucketCount != 0
 907 
 908 
 909             if (numCrossings != 0) {
 910                 /*
 911                  * thresholds to switch to optimized merge sort
 912                  * for newly added edges + final merge pass.
 913                  */
 914                 if ((ptrLen < 10) || (numCrossings < 40)) {
 915                     if (DO_STATS) {
 916                         rdrCtx.stats.hist_rdr_crossings.add(numCrossings);
 917                         rdrCtx.stats.hist_rdr_crossings_adds.add(ptrLen);
 918                     }
 919 
 920                     /*
 921                      * threshold to use binary insertion sort instead of
 922                      * straight insertion sort (to reduce minimize comparisons).
 923                      */
 924                     useBinarySearch = (numCrossings >= 20);
 925 
 926                     // if small enough:
 927                     lastCross = _MIN_VALUE;
 928 
 929                     for (i = 0; i < numCrossings; i++) {
 930                         // get the pointer to the edge
 931                         ecur = _edgePtrs[i];
 932 
 933                         /* convert subpixel coordinates into pixel
 934                             positions for coming scanline */
 935                         /* note: it is faster to always update edges even
 936                            if it is removed from AEL for coming or last scanline */
 937 
 938                         // random access so use unsafe:
 939                         addr = addr0 + ecur; // ecur + OFF_F_CURX
 940 
 941                         // get current crossing:
 942                         curx = _unsafe.getInt(addr);
 943 
 944                         // update crossing with orientation at last bit:
 945                         cross = curx;
 946 
 947                         // Increment x using DDA (fixed point):
 948                         curx += _unsafe.getInt(addr + _OFF_BUMP_X);
 949 
 950                         // Increment error:
 951                         err  =  _unsafe.getInt(addr + _OFF_ERROR)
 952                               + _unsafe.getInt(addr + _OFF_BUMP_ERR);
 953 
 954                         // Manual carry handling:
 955                         // keep sign and carry bit only and ignore last bit (preserve orientation):
 956                         _unsafe.putInt(addr,               curx - ((err >> 30) & _ALL_BUT_LSB));
 957                         _unsafe.putInt(addr + _OFF_ERROR, (err & _ERR_STEP_MAX));
 958 
 959                         if (DO_STATS) {
 960                             rdrCtx.stats.stat_rdr_crossings_updates.add(numCrossings);
 961                         }
 962 
 963                         // insertion sort of crossings:
 964                         if (cross < lastCross) {
 965                             if (DO_STATS) {
 966                                 rdrCtx.stats.stat_rdr_crossings_sorts.add(i);
 967                             }
 968 
 969                             /* use binary search for newly added edges
 970                                in crossings if arrays are large enough */
 971                             if (useBinarySearch && (i >= prevNumCrossings)) {
 972                                 if (DO_STATS) {
 973                                     rdrCtx.stats.stat_rdr_crossings_bsearch.add(i);
 974                                 }
 975                                 low = 0;
 976                                 high = i - 1;
 977 
 978                                 do {
 979                                     // note: use signed shift (not >>>) for performance
 980                                     // as indices are small enough to exceed Integer.MAX_VALUE
 981                                     mid = (low + high) >> 1;
 982 
 983                                     if (_crossings[mid] < cross) {
 984                                         low = mid + 1;
 985                                     } else {
 986                                         high = mid - 1;
 987                                     }
 988                                 } while (low <= high);
 989 
 990                                 for (j = i - 1; j >= low; j--) {
 991                                     _crossings[j + 1] = _crossings[j];
 992                                     _edgePtrs [j + 1] = _edgePtrs[j];
 993                                 }
 994                                 _crossings[low] = cross;
 995                                 _edgePtrs [low] = ecur;
 996 
 997                             } else {
 998                                 j = i - 1;
 999                                 _crossings[i] = _crossings[j];
1000                                 _edgePtrs[i] = _edgePtrs[j];
1001 
1002                                 while ((--j >= 0) && (_crossings[j] > cross)) {
1003                                     _crossings[j + 1] = _crossings[j];
1004                                     _edgePtrs [j + 1] = _edgePtrs[j];
1005                                 }
1006                                 _crossings[j + 1] = cross;
1007                                 _edgePtrs [j + 1] = ecur;
1008                             }
1009 
1010                         } else {
1011                             _crossings[i] = lastCross = cross;
1012                         }
1013                     }
1014                 } else {
1015                     if (DO_STATS) {
1016                         rdrCtx.stats.stat_rdr_crossings_msorts.add(numCrossings);
1017                         rdrCtx.stats.hist_rdr_crossings_ratio
1018                             .add((1000 * ptrLen) / numCrossings);
1019                         rdrCtx.stats.hist_rdr_crossings_msorts.add(numCrossings);
1020                         rdrCtx.stats.hist_rdr_crossings_msorts_adds.add(ptrLen);
1021                     }
1022 
1023                     // Copy sorted data in auxiliary arrays
1024                     // and perform insertion sort on almost sorted data
1025                     // (ie i < prevNumCrossings):
1026 
1027                     lastCross = _MIN_VALUE;
1028 
1029                     for (i = 0; i < numCrossings; i++) {
1030                         // get the pointer to the edge
1031                         ecur = _edgePtrs[i];
1032 
1033                         /* convert subpixel coordinates into pixel
1034                             positions for coming scanline */
1035                         /* note: it is faster to always update edges even
1036                            if it is removed from AEL for coming or last scanline */
1037 
1038                         // random access so use unsafe:
1039                         addr = addr0 + ecur; // ecur + OFF_F_CURX
1040 
1041                         // get current crossing:
1042                         curx = _unsafe.getInt(addr);
1043 
1044                         // update crossing with orientation at last bit:
1045                         cross = curx;
1046 
1047                         // Increment x using DDA (fixed point):
1048                         curx += _unsafe.getInt(addr + _OFF_BUMP_X);
1049 
1050                         // Increment error:
1051                         err  =  _unsafe.getInt(addr + _OFF_ERROR)
1052                               + _unsafe.getInt(addr + _OFF_BUMP_ERR);
1053 
1054                         // Manual carry handling:
1055                         // keep sign and carry bit only and ignore last bit (preserve orientation):
1056                         _unsafe.putInt(addr,               curx - ((err >> 30) & _ALL_BUT_LSB));
1057                         _unsafe.putInt(addr + _OFF_ERROR, (err & _ERR_STEP_MAX));
1058 
1059                         if (DO_STATS) {
1060                             rdrCtx.stats.stat_rdr_crossings_updates.add(numCrossings);
1061                         }
1062 
1063                         if (i >= prevNumCrossings) {
1064                             // simply store crossing as edgePtrs is in-place:
1065                             // will be copied and sorted efficiently by mergesort later:
1066                             _crossings[i]     = cross;
1067 
1068                         } else if (cross < lastCross) {
1069                             if (DO_STATS) {
1070                                 rdrCtx.stats.stat_rdr_crossings_sorts.add(i);
1071                             }
1072 
1073                             // (straight) insertion sort of crossings:
1074                             j = i - 1;
1075                             _aux_crossings[i] = _aux_crossings[j];
1076                             _aux_edgePtrs[i] = _aux_edgePtrs[j];
1077 
1078                             while ((--j >= 0) && (_aux_crossings[j] > cross)) {
1079                                 _aux_crossings[j + 1] = _aux_crossings[j];
1080                                 _aux_edgePtrs [j + 1] = _aux_edgePtrs[j];
1081                             }
1082                             _aux_crossings[j + 1] = cross;
1083                             _aux_edgePtrs [j + 1] = ecur;
1084 
1085                         } else {
1086                             // auxiliary storage:
1087                             _aux_crossings[i] = lastCross = cross;
1088                             _aux_edgePtrs [i] = ecur;
1089                         }
1090                     }
1091 
1092                     // use Mergesort using auxiliary arrays (sort only right part)
1093                     MergeSort.mergeSortNoCopy(_crossings,     _edgePtrs,
1094                                               _aux_crossings, _aux_edgePtrs,
1095                                               numCrossings,   prevNumCrossings);
1096                 }
1097 
1098                 // reset ptrLen
1099                 ptrLen = 0;
1100                 // --- from former ScanLineIterator.next()
1101 
1102 
1103                 /* note: bboxx0 and bboxx1 must be pixel boundaries
1104                    to have correct coverage computation */
1105 
1106                 // right shift on crossings to get the x-coordinate:
1107                 curxo = _crossings[0];
1108                 x0    = curxo >> 1;
1109                 if (x0 < minX) {
1110                     minX = x0; // subpixel coordinate
1111                 }
1112 
1113                 x1 = _crossings[numCrossings - 1] >> 1;
1114                 if (x1 > maxX) {
1115                     maxX = x1; // subpixel coordinate
1116                 }
1117 
1118 
1119                 // compute pixel coverages
1120                 prev = curx = x0;
1121                 // to turn {0, 1} into {-1, 1}, multiply by 2 and subtract 1.
1122                 // last bit contains orientation (0 or 1)
1123                 crorientation = ((curxo & 0x1) << 1) - 1;
1124 
1125                 if (windingRuleEvenOdd) {
1126                     sum = crorientation;
1127 
1128                     // Even Odd winding rule: take care of mask ie sum(orientations)
1129                     for (i = 1; i < numCrossings; i++) {
1130                         curxo = _crossings[i];
1131                         curx  =  curxo >> 1;
1132                         // to turn {0, 1} into {-1, 1}, multiply by 2 and subtract 1.
1133                         // last bit contains orientation (0 or 1)
1134                         crorientation = ((curxo & 0x1) << 1) - 1;
1135 
1136                         if ((sum & 0x1) != 0) {
1137                             // TODO: perform line clipping on left-right sides
1138                             // to avoid such bound checks:
1139                             x0 = (prev > bboxx0) ? prev : bboxx0;
1140 
1141                             if (curx < bboxx1) {
1142                                 x1 = curx;
1143                             } else {
1144                                 x1 = bboxx1;
1145                                 // skip right side (fast exit loop):
1146                                 i = numCrossings;
1147                             }
1148 
1149                             if (x0 < x1) {
1150                                 x0 -= bboxx0; // turn x0, x1 from coords to indices
1151                                 x1 -= bboxx0; // in the alpha array.
1152 
1153                                 _alpha[x0] += 1;
1154                                 _alpha[x1] -= 1;
1155 
1156                                 if (useBlkFlags) {
1157                                     // flag used blocks:
1158                                     _blkFlags[x0 >> _BLK_SIZE_LG] = 1;
1159                                     _blkFlags[x1 >> _BLK_SIZE_LG] = 1;
1160                                 }
1161                             }
1162                         }
1163 
1164                         sum += crorientation;
1165                         prev = curx;
1166                     }
1167                 } else {
1168                     // Non-zero winding rule: optimize that case (default)
1169                     // and avoid processing intermediate crossings
1170                     for (i = 1, sum = 0;; i++) {
1171                         sum += crorientation;
1172 
1173                         if (sum != 0) {
1174                             // prev = min(curx)
1175                             if (prev > curx) {
1176                                 prev = curx;
1177                             }
1178                         } else {
1179                             // TODO: perform line clipping on left-right sides
1180                             // to avoid such bound checks:
1181                             x0 = (prev > bboxx0) ? prev : bboxx0;
1182 
1183                             if (curx < bboxx1) {
1184                                 x1 = curx;
1185                             } else {
1186                                 x1 = bboxx1;
1187                                 // skip right side (fast exit loop):
1188                                 i = numCrossings;
1189                             }
1190 
1191                             if (x0 < x1) {
1192                                 x0 -= bboxx0; // turn x0, x1 from coords to indices
1193                                 x1 -= bboxx0; // in the alpha array.
1194 
1195                                 _alpha[x0] += 1;
1196                                 _alpha[x1] -= 1;
1197 
1198                                 if (useBlkFlags) {
1199                                     // flag used blocks:
1200                                     _blkFlags[x0 >> _BLK_SIZE_LG] = 1;
1201                                     _blkFlags[x1 >> _BLK_SIZE_LG] = 1;
1202                                 }
1203                             }
1204                             prev = _MAX_VALUE;
1205                         }
1206 
1207                         if (i == numCrossings) {
1208                             break;
1209                         }
1210 
1211                         curxo = _crossings[i];
1212                         curx  =  curxo >> 1;
1213                         // to turn {0, 1} into {-1, 1}, multiply by 2 and subtract 1.
1214                         // last bit contains orientation (0 or 1)
1215                         crorientation = ((curxo & 0x1) << 1) - 1;
1216                     }
1217                 }
1218             } // numCrossings > 0
1219 
1220             // even if this last row had no crossings, alpha will be zeroed
1221             // from the last emitRow call. But this doesn't matter because
1222             // maxX < minX, so no row will be emitted to the AlphaConsumer.
1223             if (true) {
1224                 lastY = y;
1225 
1226                 // convert subpixel to pixel coordinate within boundaries:
1227                 minX = FloatMath.max(minX, bboxx0);
1228                 maxX = FloatMath.min(maxX, bboxx1);
1229 
1230                 if (maxX >= minX) {
1231                     // note: alpha array will be zeroed by copyAARow()
1232                     // +1 because alpha [pix_minX; pix_maxX[
1233                     // fix range [x0; x1[
1234                     // note: if x1=bboxx1, then alpha is written up to bboxx1+1
1235                     // inclusive: alpha[bboxx1] ignored, alpha[bboxx1+1] == 0
1236                     // (normally so never cleared below)
1237                     copyAARow(_alpha, lastY, minX, maxX + 1, useBlkFlags, ac);
1238 
1239                     // speculative for next pixel row (scanline coherence):
1240                     if (_enableBlkFlagsHeuristics) {
1241                         // Use block flags if large pixel span and few crossings:
1242                         // ie mean(distance between crossings) is larger than
1243                         // 1 block size;
1244 
1245                         // fast check width:
1246                         maxX -= minX;
1247 
1248                         // if stroking: numCrossings /= 2
1249                         // => shift numCrossings by 1
1250                         // condition = (width / (numCrossings - 1)) > blockSize
1251                         useBlkFlags = (maxX > _BLK_SIZE) && (maxX >
1252                             (((numCrossings >> stroking) - 1) << _BLK_SIZE_LG));
1253 
1254                         if (DO_STATS) {
1255                             tmp = FloatMath.max(1,
1256                                     ((numCrossings >> stroking) - 1));
1257                             rdrCtx.stats.hist_tile_generator_encoding_dist
1258                                 .add(maxX / tmp);
1259                         }
1260                     }
1261                 } else {
1262                     ac.clearAlphas(lastY);
1263                 }
1264                 minX = _MAX_VALUE;
1265                 maxX = _MIN_VALUE;
1266             }
1267         } // scan line iterator
1268 
1269         // Emit final row
1270         y--;
1271 
1272         // convert subpixel to pixel coordinate within boundaries:
1273         minX = FloatMath.max(minX, bboxx0);
1274         maxX = FloatMath.min(maxX, bboxx1);
1275 
1276         if (maxX >= minX) {
1277             // note: alpha array will be zeroed by copyAARow()
1278             // +1 because alpha [pix_minX; pix_maxX[
1279             // fix range [x0; x1[
1280             // note: if x1=bboxx1, then alpha is written up to bboxx1+1
1281             // inclusive: alpha[bboxx1] ignored then cleared and
1282             // alpha[bboxx1+1] == 0 (normally so never cleared after)
1283             copyAARow(_alpha, y, minX, maxX + 1, useBlkFlags, ac);
1284         } else if (y != lastY) {
1285             ac.clearAlphas(y);
1286         }
1287 
1288         // update member:
1289         edgeCount = numCrossings;
1290         prevUseBlkFlags = useBlkFlags;
1291 
1292         if (DO_STATS) {
1293             // update max used mark
1294             activeEdgeMaxUsed = _arrayMaxUsed;
1295         }
1296     }
1297 
1298     void endRendering() {
1299         if (DO_MONITORS) {
1300             rdrCtx.stats.mon_rdr_endRendering.start();
1301         }
1302         if (edgeMinY == Integer.MAX_VALUE) {
1303             return; // undefined edges bounds
1304         }
1305 
1306         // bounds as half-open intervals
1307         final int spminX = FloatMath.max(FloatMath.ceil_int(edgeMinX - 0.5f), boundsMinX);
1308         final int spmaxX = FloatMath.min(FloatMath.ceil_int(edgeMaxX - 0.5f), boundsMaxX);
1309 
1310         // edge Min/Max Y are already rounded to subpixels within bounds:
1311         final int spminY = edgeMinY;
1312         final int spmaxY = edgeMaxY;
1313 
1314         buckets_minY = spminY - boundsMinY;
1315         buckets_maxY = spmaxY - boundsMinY;
1316 
1317         if (DO_LOG_BOUNDS) {
1318             MarlinUtils.logInfo("edgesXY = [" + edgeMinX + " ... " + edgeMaxX
1319                                 + "[ [" + edgeMinY + " ... " + edgeMaxY + "[");
1320             MarlinUtils.logInfo("spXY    = [" + spminX + " ... " + spmaxX
1321                                 + "[ [" + spminY + " ... " + spmaxY + "[");
1322         }
1323 
1324         // test clipping for shapes out of bounds
1325         if ((spminX >= spmaxX) || (spminY >= spmaxY)) {
1326             return;
1327         }
1328 
1329         // half open intervals
1330         // inclusive:
1331         final int pminX = spminX;
1332         // exclusive:
1333         final int pmaxX = spmaxX;
1334         // inclusive:
1335         final int pminY = spminY;
1336         // exclusive:
1337         final int pmaxY = spmaxY;
1338 
1339         // store BBox to answer ptg.getBBox():
1340         initConsumer(pminX, pminY, pmaxX, pmaxY);
1341 
1342         // Heuristics for using block flags:
1343         if (ENABLE_BLOCK_FLAGS) {
1344             enableBlkFlags = this.useRLE;
1345             prevUseBlkFlags = enableBlkFlags && !ENABLE_BLOCK_FLAGS_HEURISTICS;
1346 
1347             if (enableBlkFlags) {
1348                 // ensure blockFlags array is large enough:
1349                 // note: +2 to ensure enough space left at end
1350                 final int blkLen = ((pmaxX - pminX) >> BLOCK_SIZE_LG) + 2;
1351                 if (blkLen > INITIAL_ARRAY) {
1352                     blkFlags = blkFlags_ref.getArray(blkLen);
1353                 }
1354             }
1355         }
1356 
1357         // memorize the rendering bounding box:
1358         /* note: bbox_spminX and bbox_spmaxX must be pixel boundaries
1359            to have correct coverage computation */
1360         // inclusive:
1361         bbox_spminX = pminX;
1362         // exclusive:
1363         bbox_spmaxX = pmaxX;
1364         // inclusive:
1365         bbox_spminY = spminY;
1366         // exclusive:
1367         bbox_spmaxY = spmaxY;
1368 
1369         if (DO_LOG_BOUNDS) {
1370             MarlinUtils.logInfo("pXY       = [" + pminX + " ... " + pmaxX
1371                                 + "[ [" + pminY + " ... " + pmaxY + "[");
1372             MarlinUtils.logInfo("bbox_spXY = [" + bbox_spminX + " ... "
1373                                 + bbox_spmaxX + "[ [" + bbox_spminY + " ... "
1374                                 + bbox_spmaxY + "[");
1375         }
1376 
1377         // Prepare alpha line:
1378         // add 2 to better deal with the last pixel in a pixel row.
1379         final int width = (pmaxX - pminX) + 2;
1380 
1381         // Useful when processing tile line by tile line
1382         if (width > INITIAL_AA_ARRAY) {
1383             if (DO_STATS) {
1384                 rdrCtx.stats.stat_array_renderer_alphaline.add(width);
1385             }
1386             alphaLine = alphaLine_ref.getArray(width);
1387         }
1388     }
1389 
1390     void initConsumer(int minx, int miny, int maxx, int maxy)
1391     {
1392         // assert maxy >= miny && maxx >= minx;
1393         bboxX0 = minx;
1394         bboxX1 = maxx;
1395         bboxY0 = miny;
1396         bboxY1 = maxy;
1397 
1398         final int width = (maxx - minx);
1399 
1400         if (FORCE_NO_RLE) {
1401             useRLE = false;
1402         } else if (FORCE_RLE) {
1403             useRLE = true;
1404         } else {
1405             // heuristics: use both bbox area and complexity
1406             // ie number of primitives:
1407 
1408             // fast check min width:
1409             if (width <= RLE_MIN_WIDTH) {
1410                 useRLE = false;
1411             } else {
1412                 useRLE = true;
1413             }
1414         }
1415     }
1416 
1417     private int bbox_spminX, bbox_spmaxX, bbox_spminY, bbox_spmaxY;
1418 
1419     public void produceAlphas(final MarlinAlphaConsumer ac) {
1420         ac.setMaxAlpha(1);
1421 
1422         if (enableBlkFlags && !ac.supportBlockFlags()) {
1423             // consumer does not support block flag optimization:
1424             enableBlkFlags = false;
1425             prevUseBlkFlags = false;
1426         }
1427 
1428         if (DO_MONITORS) {
1429             rdrCtx.stats.mon_rdr_endRendering_Y.start();
1430         }
1431 
1432         // Process all scan lines:
1433         _endRendering(bbox_spminY, bbox_spmaxY, ac);
1434 
1435         if (DO_MONITORS) {
1436             rdrCtx.stats.mon_rdr_endRendering_Y.stop();
1437         }
1438     }
1439 
1440     void copyAARow(final int[] alphaRow,
1441                    final int pix_y, final int pix_from, final int pix_to,
1442                    final boolean useBlockFlags,
1443                    final MarlinAlphaConsumer ac)
1444     {
1445         if (DO_MONITORS) {
1446             rdrCtx.stats.mon_rdr_copyAARow.start();
1447         }
1448         if (DO_STATS) {
1449             rdrCtx.stats.stat_cache_rowAA.add(pix_to - pix_from);
1450         }
1451 
1452         if (useBlockFlags) {
1453             if (DO_STATS) {
1454                 rdrCtx.stats.hist_tile_generator_encoding.add(1);
1455             }
1456             ac.setAndClearRelativeAlphas(blkFlags, alphaRow, pix_y, pix_from, pix_to);
1457         } else {
1458             if (DO_STATS) {
1459                 rdrCtx.stats.hist_tile_generator_encoding.add(0);
1460             }
1461             ac.setAndClearRelativeAlphas(alphaRow, pix_y, pix_from, pix_to);
1462         }
1463         if (DO_MONITORS) {
1464             rdrCtx.stats.mon_rdr_copyAARow.stop();
1465         }
1466     }
1467 
1468     // output pixel bounding box:
1469     int bboxX0, bboxX1, bboxY0, bboxY1;
1470 
1471     @Override
1472     public int getOutpixMinX() {
1473         return bboxX0;
1474     }
1475 
1476     @Override
1477     public int getOutpixMaxX() {
1478         return bboxX1;
1479     }
1480 
1481     @Override
1482     public int getOutpixMinY() {
1483         return bboxY0;
1484     }
1485 
1486     @Override
1487     public int getOutpixMaxY() {
1488         return bboxY1;
1489     }
1490 }