--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/mmapi_qt/baseline/javasrc/com/nokia/microedition/media/tone/PlayBlockEvent.java	Tue May 11 16:07:20 2010 +0300
@@ -0,0 +1,138 @@
+/*
+* Copyright (c) 2002 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:  Event processor class for tone sequence PLAY_BLOCK events
+*
+*/
+
+
+package com.nokia.microedition.media.tone;
+
+import javax.microedition.media.control.ToneControl;
+
+/**
+ * Processor for play block events
+ */
+public class PlayBlockEvent extends Event
+{
+
+    // CONSTANTS
+
+    /* Maximum and minimum values for block number */
+    public static final int PLAY_BLOCK_MAX_VALUE = 127;
+    public static final int PLAY_BLOCK_MIN_VALUE = 0;
+
+    PlayBlockEvent(byte[] aSequence, MidiSequence aMidiSequence)
+    {
+        super(aSequence, aMidiSequence);
+    }
+
+    /**
+     * Inherited from Event
+     */
+    public int advance(int aPosition)
+    {
+        int retVal = doValidate(aPosition);
+        if (retVal != 0)
+        {
+            // Push the position to stack that is going to be
+            // played after this play block has completed
+            iReturnPositionStack.push(new Integer(aPosition + EVENT_SIZE));
+
+            int data = iSequence[ aPosition + 1 ];
+            retVal = findBlock(data) - aPosition;
+        }
+        return retVal;
+    }
+
+    /**
+     * Child class defined functionality for validate
+     * @param aPosition position in tone sequence array where to validate
+     * @return new position offset related to aPosition in tone sequence
+     * array. Must be positive.
+     */
+    protected int doValidate(int aPosition)
+    throws IllegalArgumentException
+    {
+        // it is already checked that there is at least two bytes left
+        int type = iSequence[ aPosition ];
+        int data = iSequence[ aPosition + 1 ];
+        int retVal = 0;
+
+        if (type == ToneControl.PLAY_BLOCK)
+        {
+            if (data < PLAY_BLOCK_MIN_VALUE ||
+                    data > PLAY_BLOCK_MAX_VALUE)
+            {
+                throw new IllegalArgumentException(
+                    "Block number out of range");
+            }
+            findBlock(data);   // for check only
+            retVal = EVENT_SIZE;
+        }
+        return retVal;
+    }
+
+    /**
+     * Find block
+     * @param block number
+     * @return position of corresponding BLOCK_START event
+     * @exception IllegalArgumentException if block is not found
+     */
+    private int findBlock(int aBlockNumber)
+    {
+        for (int i = 0; i < iSequence.length; i += EVENT_SIZE)
+        {
+            if (iSequence[ i ] == ToneControl.BLOCK_START &&
+                    iSequence[ i + 1 ] == aBlockNumber)
+            {
+                return i;
+            }
+        }
+        // if block is not found, input is illegal
+        throw new IllegalArgumentException("No block found, sequence is corrupted");
+    }
+
+    /**
+     * Child class defined functionality for checkEventAtNextPosition
+     * @param aPosition position in tone sequence array where to check
+     */
+    protected void checkEventAtNextPosition(int aPosition)
+    throws IllegalArgumentException
+    {
+        // After this event there can be:
+        // Tone, BlockEnd PlayBlock, Volume, Repeat or end of sequence
+
+        int type = 0;
+        try
+        {
+            type = iSequence[ aPosition ];
+        }
+        catch (ArrayIndexOutOfBoundsException aioobe)
+        {
+            return; // end of sequence is OK
+        }
+
+
+        if (type >= ToneControl.SILENCE ||
+                type == ToneControl.BLOCK_END ||
+                type == ToneControl.PLAY_BLOCK ||
+                type == ToneControl.SET_VOLUME ||
+                type == ToneControl.REPEAT)
+        {
+            return;
+        }
+        throw new IllegalArgumentException("Illegal event found, sequence is corrupted");
+    }
+} // end of class
+