javauis/m2g_qt/javasrc/com/nokia/microedition/m2g/Platform.java
author hgs
Fri, 23 Jul 2010 12:27:20 +0300
changeset 56 abc41079b313
permissions -rw-r--r--
v2.2.7_1
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
56
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
     1
/*
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
     2
* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
     3
* All rights reserved.
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
     5
* under the terms of "Eclipse Public License v1.0"
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
     8
*
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
     9
* Initial Contributors:
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    11
*
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    12
* Contributors:
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    13
*
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    14
* Description:
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    15
*
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    16
*/
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    17
/**
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    18
 * \file
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    19
 * \brief Target platform dependent Java module for Symbian.
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    20
 *
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    21
 */
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    22
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    23
package com.nokia.microedition.m2g;
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    24
import javax.microedition.lcdui.Graphics;
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    25
import javax.microedition.lcdui.Image;
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    26
import org.eclipse.swt.widgets.Display;
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    27
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    28
import com.nokia.mj.impl.nokialcdui.LCDUIInvoker;
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    29
import org.eclipse.swt.internal.extension.DisplayExtension;
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    30
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    31
/**
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    32
 * Implements platform-dependent functionality. At the moment, this
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    33
 * includes native finalization and some helper methods for
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    34
 * synchronizing 2D and 3D rendering.
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    35
 */
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    36
class Platform
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    37
{
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    38
    /**
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    39
     * eSWT display for ui thread access
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    40
     */
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    41
    private static Display display = null;
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    42
    private static boolean libraryLoaded = false;
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    43
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    44
    //------------------------------------------------------------------
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    45
    // Package private methods
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    46
    //------------------------------------------------------------------
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    47
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    48
    /**
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    49
     * Executes given runnable in UI thread if caller thread is not UI thread
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    50
     */
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    51
    static void executeInUIThread(M2GRunnableQt obj)
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    52
    {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    53
        if (display == null)
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    54
        {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    55
            if (!uiThreadAvailable())
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    56
            {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    57
                throw new Error("Ui thread not available");
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    58
            }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    59
        }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    60
        if (display.isDisposed())
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    61
        {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    62
            throw new Error("Display already disposed");
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    63
        }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    64
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    65
        if (obj != null)
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    66
        {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    67
            // If we are not in UI thread use display
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    68
            if (Thread.currentThread() != display.getThread())
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    69
            {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    70
                display.syncExec(obj);
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    71
            }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    72
            else
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    73
            {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    74
                // In this case we are in UI thread so just execute directly
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    75
                obj.run();
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    76
            }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    77
            // Check if any exceptions occured in execution
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    78
            // and throw forward in caller thread
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    79
            obj.checkAndThrow();
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    80
        }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    81
    }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    82
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    83
    /**
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    84
     * Check the UI thread / toolkit init status and store display if it is available
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    85
     * @return true if either lcdui or eswt toolkit is initialized and ui thread is accessible
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    86
     *              otherwise false
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    87
     */
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    88
    static boolean uiThreadAvailable()
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    89
    {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    90
        if (display != null)
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    91
        {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    92
            return true;
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    93
        }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    94
        else
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    95
        {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    96
            display = DisplayExtension.getDisplayInstance();
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    97
						System.out.println("P-UI Thread not available Case" );			                    	
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    98
						if (display == null)
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
    99
            {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   100
                return false;
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   101
            }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   102
            else
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   103
            {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   104
            		System.out.println("P-UI Thread available Case" );			                    	
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   105
                // UI thread is available, so load native library if not already loaded
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   106
                if (!libraryLoaded)
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   107
                {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   108
                		System.out.println("P-UI Thread not available Case Javam2g loaded" );			                    	
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   109
                    com.nokia.mj.impl.rt.support.Jvm.loadSystemLibrary("javam2g");
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   110
                    libraryLoaded = true;
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   111
                }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   112
                return true;
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   113
            }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   114
        }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   115
    }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   116
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   117
    /**
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   118
     * Registers an Object3D in the global handle-to-object map. The
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   119
     * handle of the object must already be set at this point!
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   120
     */
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   121
//    static final void registerFinalizer(Object3D obj)
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   122
//    {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   123
//        //heuristicGC();
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   124
//    }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   125
//
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   126
//    /**
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   127
//     * Registers a Graphics3D object (not derived from Object3D) for
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   128
//     * finalization.
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   129
//     */
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   130
//    static final void registerFinalizer(Graphics3D g3d)
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   131
//    {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   132
//        //heuristicGC();
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   133
//    }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   134
//
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   135
//    /**
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   136
//     * Registers an Interface object for finalization
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   137
//     */
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   138
//    static final void registerFinalizer(Interface m2G)
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   139
//    {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   140
//    }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   141
//
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   142
//    /**
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   143
//     * Registers a Loader object for finalization
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   144
//     */
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   145
//    static final void registerFinalizer(Loader loader)
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   146
//    {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   147
//    }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   148
//
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   149
//    /**
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   150
//     * Flushes all pending rendering to a Graphics context and blocks
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   151
//     * until finished
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   152
//     */
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   153
//    static final void sync(Graphics g)
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   154
//    {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   155
//        //ToolkitInvoker invoker = ToolkitInvoker.getToolkitInvoker();
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   156
//        //invoker.toolkitSync(invoker.getToolkit());
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   157
//    }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   158
//
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   159
//    /**
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   160
//     * Flushes all pending rendering to an Image object
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   161
//     */
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   162
//    static final void sync(Image img)
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   163
//    {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   164
//        //ToolkitInvoker invoker = ToolkitInvoker.getToolkitInvoker();
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   165
//        //invoker.toolkitSync(invoker.getToolkit());
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   166
//    }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   167
//
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   168
//    /**
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   169
//     * Finalizes the native peer of an interface
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   170
//     */
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   171
//    static final native void finalizeInterface(int handle);
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   172
//
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   173
//    /**
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   174
//     * Finalizes the native peer of an object
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   175
//     * JCF: added this wrapper method so we could pass the toolkit handle to the native method.
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   176
//     */
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   177
    static final void finalizeObject(int handle)
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   178
    {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   179
        try
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   180
        {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   181
            final int finalHandle = handle;
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   182
            executeInUIThread(
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   183
                new M2GRunnableQt()
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   184
            {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   185
                void doRun()
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   186
                {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   187
                    _finalizeObject(finalHandle);
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   188
                }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   189
            });
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   190
        }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   191
        catch (Exception e)
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   192
        {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   193
            // do nothing
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   194
        }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   195
    }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   196
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   197
    /**
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   198
     * Finalizes the native peer of an object associated with
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   199
     * given Interface instance
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   200
     */
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   201
//    static final void finalizeObject(int handle, Interface aInterface)
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   202
//    {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   203
//        try
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   204
//        {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   205
//            final int finalHandle = handle;
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   206
//            executeInUIThread(
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   207
//                new M2GRunnable()
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   208
//            {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   209
//                public void doRun()
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   210
//                {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   211
//                    _finalizeObject(finalHandle);
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   212
//                }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   213
//            });
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   214
//        }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   215
//        catch (Exception e)
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   216
//        {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   217
//            // do nothing
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   218
//        }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   219
//    }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   220
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   221
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   222
    //------------------------------------------------------------------
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   223
    // Private methods
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   224
    //------------------------------------------------------------------
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   225
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   226
    /**
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   227
     * Trigger GC if minimum free memory limit has been exceeded in the native side
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   228
     */
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   229
    static final void heuristicGC()
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   230
    {
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   231
    }
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   232
    private static final native void _finalizeObject(int handle);
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   233
}
abc41079b313 v2.2.7_1
hgs
parents:
diff changeset
   234