1 /*
   2  * Copyright (c) 2011, 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 #import "QuartzSurfaceData.h"
  27 #import <pthread.h>
  28 
  29 typedef UInt8 Pixel8bit;
  30 typedef UInt16 Pixel16bit;
  31 typedef UInt32 Pixel32bit;
  32 
  33 typedef struct _ImageSDOps ImageSDOps;
  34 
  35 ImageSDOps*    LockImage(JNIEnv* env, jobject imageSurfaceData);
  36 void        UnlockImage(JNIEnv* env, ImageSDOps* isdo);
  37 ImageSDOps*    LockImagePixels(JNIEnv* env, jobject imageSurfaceData);
  38 void        UnlockImagePixels(JNIEnv* env, ImageSDOps* isdo);
  39 
  40 // if there is no image created for isdo.imgRef, it creates and image using the isdo.dataProvider
  41 // If there is an image present, this is a no-op
  42 void makeSureImageIsCreated(ImageSDOps* isdo);
  43 
  44 typedef struct _ContextInfo
  45 {
  46     BOOL                useWindowContextReference;
  47     BOOL                canUseJavaPixelsAsContext;
  48     size_t                bitsPerComponent;
  49     size_t                bytesPerPixel;
  50     size_t                bytesPerRow;
  51     CGImageAlphaInfo    alphaInfo;
  52     CGColorSpaceRef        colorSpace;
  53 } ContextInfo;
  54 
  55 typedef struct _ImageInfo
  56 {
  57     size_t                bitsPerComponent;
  58     size_t                bitsPerPixel;
  59     size_t                bytesPerPixel;
  60     size_t                bytesPerRow;
  61     CGImageAlphaInfo    alphaInfo;
  62     CGColorSpaceRef        colorSpace;
  63 } ImageInfo;
  64 
  65 struct _ImageSDOps
  66 {
  67     QuartzSDOps                qsdo; // must be the first entry!
  68 
  69     ContextInfo                contextInfo;
  70     ImageInfo                imageInfo;
  71     BOOL                    isSubImage;
  72 
  73     jint*                    javaImageInfo;
  74 
  75     // parameters specifying this BufferedImage given to us from Java
  76     jobject                    array;
  77     jint                    offset;
  78     jint                    width;
  79     jint                    height;
  80     jint                    javaPixelBytes;
  81     jint                    javaPixelsBytesPerRow;
  82     jobject                    icm;
  83     jint                    type;
  84 
  85     Pixel8bit*                pixels;
  86     Pixel8bit*                pixelsLocked;
  87 
  88     // needed by TYPE_BYTE_INDEXED
  89     UInt16*                    indexedColorTable;
  90     UInt32*                    lutData;
  91     UInt32                    lutDataSize;
  92 
  93     // Used as a cached image ref created from the isdo.dataprovider. This is only a chached image, and it might become invalid
  94     // if somebody draws on the bitmap context, or the pixels are changed in java. In that case, we need to NULL out
  95     // this image and recreate it from the data provider.
  96     CGImageRef                imgRef;
  97 
  98     // Cached instance of CGDataProvider. dataProvider is alloced the first time a bitmap context is created, providing the
  99     // native pixels as a source of the data. The dataProviders life cycle is the same as ISDO. The reference gets
 100     // released when we are done with the ISDO.
 101     CGDataProviderRef        dataProvider;
 102 
 103     // Pointer in memory that is used for create the CGBitmapContext and the CGDataProvider (used for imgRef). This is a native
 104     // copy of the pixels for the Image. There is a spearate copy of the pixels that lives in Java heap. There are two main
 105     // reasons why we keep those pixels spearate: 1) CG doesn't support all the Java pixel formats 2) The Garbage collector can
 106     // move the java pixels at any time. There are possible workarounds for both problems. Number 2) seems to be a more serious issue, since
 107     // we can solve 1) by only supporting certain image types.
 108     void *                    nativePixels;
 109     NSGraphicsContext*        nsRef;
 110 
 111     pthread_mutex_t            lock;
 112     jint                    nrOfPixelsOwners;
 113 };
 114