javauis/m3g_qt/javasrc/javax/microedition/m3g/Node.java
author hgs
Mon, 04 Oct 2010 11:29:25 +0300
changeset 78 71ad690e91f5
parent 35 85266cc22c7f
permissions -rw-r--r--
v2.2.17_1

/*
* Copyright (c) 2003 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:
*
*/


package javax.microedition.m3g;

public abstract class Node extends Transformable
{
    //------------------------------------------------------------------
    // Static data
    //------------------------------------------------------------------

    public static final int NONE = 144;
    public static final int ORIGIN = 145;
    public static final int X_AXIS = 146;
    public static final int Y_AXIS = 147;
    public static final int Z_AXIS = 148;

    //------------------------------------------------------------------
    // Instance data
    //------------------------------------------------------------------

    // The node references are kept on the Java side to avoid having
    // to replicate garbage collection in the native implementation.
    // Instead, we let Java manage Node reachability detection and
    // deletion.

    private Node parent;
    private Node zRef, yRef;

    //------------------------------------------------------------------
    // Constructor(s)
    //------------------------------------------------------------------

    /**
     * There is only a package private constructor. Applications can not extend
     * this class directly.</p>
     */
    Node(int handle)
    {
        super(handle);
        parent = (Node) getInstance(_getParent(handle));
        zRef = (Node) getInstance(_getZRef(handle));
        yRef = (Node) getInstance(_getYRef(handle));
    }

    //------------------------------------------------------------------
    // Public methods
    //------------------------------------------------------------------

    public Node getParent()
    {
        return parent;
    }

    public boolean getTransformTo(Node target, Transform transform)
    {
        return _getTransformTo(handle,
                               target.handle,
                               transform != null ? transform.matrix : null);
    }

    public void setAlignment(Node zReference, int zTarget,
                             Node yReference, int yTarget)
    {
        _setAlignment(handle,
                      zReference != null ? zReference.handle : 0, zTarget,
                      yReference != null ? yReference.handle : 0, yTarget);
        zRef = zReference;
        yRef = yReference;
    }

    public void setAlphaFactor(float alphaFactor)
    {
        _setAlphaFactor(handle, alphaFactor);
    }

    public float getAlphaFactor()
    {
        return _getAlphaFactor(handle);
    }

    public void setRenderingEnable(boolean enable)
    {
        _enable(handle, Defs.SETGET_RENDERING, enable);
    }

    public boolean isRenderingEnabled()
    {
        return _isEnabled(handle, Defs.SETGET_RENDERING);
    }

    public void setPickingEnable(boolean enable)
    {
        _enable(handle, Defs.SETGET_PICKING, enable);
    }

    public boolean isPickingEnabled()
    {
        return _isEnabled(handle, Defs.SETGET_PICKING);
    }

    public void setScope(int id)
    {
        _setScope(handle, id);
    }

    public int getScope()
    {
        return _getScope(handle);
    }

    public final void align(Node reference)
    {
        _align(handle, reference != null ? reference.handle : 0);
    }

    // M3G 1.1 Maintenance release getters

    public Node getAlignmentReference(int axis)
    {
        switch (axis)
        {
        case Y_AXIS:
            return yRef;
        case Z_AXIS:
            return zRef;
        default:
            throw new IllegalArgumentException();
        }
    }

    public int getAlignmentTarget(int axis)
    {
        return _getAlignmentTarget(handle, axis);
    }


    //------------------------------------------------------------------
    // Private methods
    //------------------------------------------------------------------

    void setParent(Node parent)
    {
        this.parent = parent;
    }

    // Native methods
    private static native boolean _getTransformTo(int handle,
            int hTarget,
            byte[] transform);

    private static native void _align(int handle, int refHandle);
    private static native void _setAlignment(int handle,
            int hZReference, int zTarget,
            int hYReference, int yTarget);

    private static native void _setAlphaFactor(int handle, float alphaFactor);
    private static native float _getAlphaFactor(int handle);

    private static native void _enable(int handle, int which, boolean enable);
    private static native boolean _isEnabled(int handle, int which);

    private static native void _setScope(int handle, int id);
    private static native int _getScope(int handle);

    private static native int _getParent(int handle);
    private static native int _getZRef(int handle);
    private static native int _getYRef(int handle);
    static native int _getSubtreeSize(int handle);

    // M3G 1.1 Maintenance release getters
    private static native int _getAlignmentTarget(int handle, int axis);
}