1 /*
   2  * Copyright (c) 1997, 2008, 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 AWT_DRAWING_SURFACE_H
  27 #define AWT_DRAWING_SURFACE_H
  28 
  29 #include "stdhdrs.h"
  30 #include <jawt.h>
  31 #include <jawt_md.h>
  32 #include "awt_Component.h"
  33 #include <ddraw.h>
  34 
  35 class JAWTDrawingSurface;
  36 class JAWTOffscreenDrawingSurface;
  37 class JAWTOffscreenDrawingSurfaceInfo;
  38 
  39 /*
  40  * New structure for 1.4.1_02 release that allows access to
  41  * offscreen drawing surfaces.
  42  * This structure is slightly different from the old Win32
  43  * structure because the type of information we pass back
  44  * to the caller is dependent upon runtime configuration.
  45  * For example, we may have a DirectX7 surface pointer if
  46  * the runtime system had DX7 installed, but we may only have
  47  * a DirectX5 surface if that was the latest version installed.
  48  * We may also, in the future, offer different types of
  49  * surface, such as OpenGL surfaces, based on runtime
  50  * configuration and user options.
  51  * Given this variability, the correct usage of this structure
  52  * involves checking the surfaceType variable to see what type
  53  * of pointer we have returned and then casting the lpSurface
  54  * variable and using it based on the surfaceType.
  55  */
  56 typedef struct jawt_Win32OffscreenDrawingSurfaceInfo {
  57     IDirectDrawSurface  *dxSurface;
  58     IDirectDrawSurface7 *dx7Surface;
  59 } JAWT_Win32OffscreenDrawingSurfaceInfo;
  60 
  61 
  62 /*
  63  * Drawing surface info houses the important drawing information.
  64  * Here we multiply inherit from both structures, the platform-specific
  65  * and the platform-independent versions, so they are treated as the
  66  * same object.
  67  */
  68 class JAWTDrawingSurfaceInfo : public JAWT_Win32DrawingSurfaceInfo,
  69     public JAWT_DrawingSurfaceInfo {
  70 public:
  71     jint Init(JAWTDrawingSurface* parent);
  72 public:
  73     JAWT_Rectangle clipRect;
  74 };
  75 
  76 /*
  77  * Same as above except for offscreen surfaces instead of onscreen
  78  * Components.
  79  */
  80 class JAWTOffscreenDrawingSurfaceInfo :
  81     public JAWT_Win32OffscreenDrawingSurfaceInfo,
  82     public JAWT_DrawingSurfaceInfo
  83 {
  84 public:
  85     jint Init(JAWTOffscreenDrawingSurface* parent);
  86 
  87 };
  88 
  89 /*
  90  * The drawing surface wrapper.
  91  */
  92 class JAWTDrawingSurface : public JAWT_DrawingSurface {
  93 public:
  94     JAWTDrawingSurface() {}
  95     JAWTDrawingSurface(JNIEnv* env, jobject rTarget);
  96     virtual ~JAWTDrawingSurface();
  97 
  98 public:
  99     JAWTDrawingSurfaceInfo info;
 100 
 101 // Static function pointers
 102 public:
 103     static jint JNICALL LockSurface
 104         (JAWT_DrawingSurface* ds);
 105 
 106     static JAWT_DrawingSurfaceInfo* JNICALL GetDSI
 107         (JAWT_DrawingSurface* ds);
 108 
 109     static void JNICALL FreeDSI
 110         (JAWT_DrawingSurfaceInfo* dsi);
 111 
 112     static void JNICALL UnlockSurface
 113         (JAWT_DrawingSurface* ds);
 114 };
 115 
 116 /*
 117  * Same as above except for offscreen surfaces instead of onscreen
 118  * Components.
 119  */
 120 class JAWTOffscreenDrawingSurface : public JAWTDrawingSurface {
 121 public:
 122     JAWTOffscreenDrawingSurface() {}
 123     JAWTOffscreenDrawingSurface(JNIEnv* env, jobject rTarget);
 124     virtual ~JAWTOffscreenDrawingSurface();
 125 
 126 public:
 127     JAWTOffscreenDrawingSurfaceInfo info;
 128 
 129 // Static function pointers
 130 public:
 131     static JAWT_DrawingSurfaceInfo* JNICALL GetDSI
 132         (JAWT_DrawingSurface* ds);
 133 
 134     static void JNICALL FreeDSI
 135         (JAWT_DrawingSurfaceInfo* dsi);
 136 
 137     static jint JNICALL LockSurface
 138         (JAWT_DrawingSurface* ds);
 139 
 140     static void JNICALL UnlockSurface
 141         (JAWT_DrawingSurface* ds);
 142 };
 143 
 144 #ifdef __cplusplus
 145 extern "C" {
 146 #endif
 147     _JNI_IMPORT_OR_EXPORT_
 148     JAWT_DrawingSurface* JNICALL DSGetDrawingSurface
 149         (JNIEnv* env, jobject target);
 150 
 151     _JNI_IMPORT_OR_EXPORT_
 152     void JNICALL DSFreeDrawingSurface
 153         (JAWT_DrawingSurface* ds);
 154 
 155     _JNI_IMPORT_OR_EXPORT_
 156     void JNICALL DSLockAWT(JNIEnv* env);
 157 
 158     _JNI_IMPORT_OR_EXPORT_
 159     void JNICALL DSUnlockAWT(JNIEnv* env);
 160 
 161     _JNI_IMPORT_OR_EXPORT_
 162     jobject JNICALL DSGetComponent(
 163         JNIEnv* env, void* platformInfo);
 164 
 165 #ifdef __cplusplus
 166 } /* extern "C" */
 167 #endif
 168 
 169 #endif /* AWT_DRAWING_SURFACE_H */