1 /* 2 * Copyright (c) 2019, 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 #ifndef HEADLESS 27 28 #include "sun_java2d_metal_MTLMaskFill.h" 29 30 #include "MTLMaskFill.h" 31 #include "MTLRenderQueue.h" 32 #include "MTLVertexCache.h" 33 34 /** 35 * This implementation first copies the alpha tile into a texture and then 36 * maps that texture to the destination surface. This approach appears to 37 * offer the best performance despite being a two-step process. 38 * 39 * When the source paint is a Color, we can simply use the GL_MODULATE 40 * function to multiply the current color (already premultiplied with the 41 * extra alpha value from the AlphaComposite) with the alpha value from 42 * the mask texture tile. In picture form, this process looks like: 43 * 44 * A R G B 45 * primary color Pa Pr Pg Pb (modulated with...) 46 * texture unit 0 Ca Ca Ca Ca 47 * --------------------------------------- 48 * resulting color Ra Rr Rg Rb 49 * 50 * where: 51 * Px = current color (already premultiplied by extra alpha) 52 * Cx = coverage value from mask tile 53 * Rx = resulting color/alpha component 54 * 55 * When the source paint is not a Color, it means that we are rendering with 56 * a complex paint (e.g. GradientPaint, TexturePaint). In this case, we 57 * rely on the GL_ARB_multitexture extension to effectively multiply the 58 * paint fragments (autogenerated on texture unit 1, see the 59 * MTLPaints_Set{Gradient,Texture,etc}Paint() methods for more details) 60 * with the coverage values from the mask texture tile (provided on texture 61 * unit 0), all of which is multiplied with the current color value (which 62 * contains the extra alpha value). In picture form: 63 * 64 * A R G B 65 * primary color Ea Ea Ea Ea (modulated with...) 66 * texture unit 0 Ca Ca Ca Ca (modulated with...) 67 * texture unit 1 Pa Pr Pg Pb 68 * --------------------------------------- 69 * resulting color Ra Rr Rg Rb 70 * 71 * where: 72 * Ea = extra alpha 73 * Cx = coverage value from mask tile 74 * Px = gradient/texture paint color (generated for each fragment) 75 * Rx = resulting color/alpha component 76 * 77 * Here are some descriptions of the many variables used in this method: 78 * x,y - upper left corner of the tile destination 79 * w,h - width/height of the mask tile 80 * x0 - placekeeper for the original destination x location 81 * tw,th - width/height of the actual texture tile in pixels 82 * sx1,sy1 - upper left corner of the mask tile source region 83 * sx2,sy2 - lower left corner of the mask tile source region 84 * sx,sy - "current" upper left corner of the mask tile region of interest 85 */ 86 void 87 MTLMaskFill_MaskFill(MTLContext *mtlc, 88 jint x, jint y, jint w, jint h, 89 jint maskoff, jint maskscan, jint masklen, 90 unsigned char *pMask) 91 { 92 //TODO 93 J2dTraceNotImplPrimitive("MTLMaskFill_MaskFill"); 94 J2dTraceLn(J2D_TRACE_INFO, "MTLMaskFill_MaskFill"); 95 } 96 97 JNIEXPORT void JNICALL 98 Java_sun_java2d_metal_MTLMaskFill_maskFill 99 (JNIEnv *env, jobject self, 100 jint x, jint y, jint w, jint h, 101 jint maskoff, jint maskscan, jint masklen, 102 jbyteArray maskArray) 103 { 104 MTLContext *mtlc = MTLRenderQueue_GetCurrentContext(); 105 unsigned char *mask; 106 //TODO 107 J2dTraceNotImplPrimitive("MTLMaskFill_maskFill"); 108 J2dTraceLn(J2D_TRACE_ERROR, "MTLMaskFill_maskFill"); 109 } 110 111 #endif /* !HEADLESS */