Commit a0db5fb0 authored by nshah's avatar nshah

Tagging OCAP MSM stubs used for 1.2.2 Release

parent 2248549c
<?xml version="1.0" encoding="UTF-8"?>
<classpath>
<classpathentry kind="src" path="src"/>
<classpathentry combineaccessrules="false" exported="true" kind="src" path="/ocap_api"/>
<classpathentry kind="output" path="bin"/>
</classpath>
<?xml version="1.0" encoding="UTF-8"?>
<projectDescription>
<name>ocap_msm</name>
<comment></comment>
<projects>
</projects>
<buildSpec>
<buildCommand>
<name>org.eclipse.jdt.core.javabuilder</name>
<arguments>
</arguments>
</buildCommand>
</buildSpec>
<natures>
<nature>org.eclipse.jdt.core.javanature</nature>
</natures>
</projectDescription>
#Fri Oct 19 13:37:09 MDT 2007
eclipse.preferences.version=1
org.eclipse.jdt.core.compiler.codegen.inlineJsrBytecode=enabled
org.eclipse.jdt.core.compiler.codegen.targetPlatform=1.5
org.eclipse.jdt.core.compiler.codegen.unusedLocal=preserve
org.eclipse.jdt.core.compiler.compliance=1.5
org.eclipse.jdt.core.compiler.debug.lineNumber=generate
org.eclipse.jdt.core.compiler.debug.localVariable=generate
org.eclipse.jdt.core.compiler.debug.sourceFile=generate
org.eclipse.jdt.core.compiler.problem.assertIdentifier=error
org.eclipse.jdt.core.compiler.problem.enumIdentifier=error
org.eclipse.jdt.core.compiler.source=1.5
#Fri Oct 19 13:37:09 MDT 2007
eclipse.preferences.version=1
internal.default.compliance=default
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
package org.ocap.ui.event;
/**
* A <code>MultiScreenConfigurationEvent</code> is used to report
* changes to the global state of the <code>MultiScreenManager</code>
* instance or the state of some display <code>HScreen</code> with
* respect to the per-platform or some per-display multiscreen
* configuration, respectively, or to changes to a specific
* <code>MultiScreenConfiguration</code> instance.
*
* <p>The following types of changes SHALL cause the generation of this
* event:</p>
*
* <ul>
* <li>The currently active per-platform multiscreen configuration as determined by
* the <code>MultiScreenManager</code> changes from one multiscreen
* configuration to another multiscreen configuration;</li>
* <li>The currently active per-display multiscreen configuration as determined by
* some display <code>HScreen</code> changes from one multiscreen
* configuration to another multiscreen configuration;</li>
* <li>The set of screens associated with a
* <code>MultiScreenConfiguration</code> changes (i.e., a screen is
* added or removed from the multiscreen configuration);</li>
* </ul>
*
* @author Glenn Adams
* @since MSM I01
*
**/
public class MultiScreenConfigurationEvent extends MultiScreenEvent
{
/**
* A change to the currently active per-platform or some per-display
* <code>MultiScreenConfiguration</code> as determined by the
* <code>MultiScreenManager</code> or some display
* <code>HScreen</code> has been initiated, in which case the value
* returned by <code>getSource()</code> SHALL be the affected
* <code>MultiScreenManager</code> or display <code>HScreen</code>,
* and the value returned by <code>getRelated()</code> SHALL be the
* subsequently active <code>MultiScreenConfiguration</code>.
*
* <p>A <code>MULTI_SCREEN_CONFIGURATION_CHANGING</code> event
* SHALL NOT be dispatched to an application that has not been
* granted
* <code>MonitorAppPermission("multiscreen.configuration")</code>.</p>
*
* @since MSM I01
**/
public static final int MULTI_SCREEN_CONFIGURATION_CHANGING = MULTI_SCREEN_CONFIGURATION_FIRST + 0;
/**
* The currently active per-platform or some per-display
* <code>MultiScreenConfiguration</code> as determined by the
* <code>MultiScreenManager</code> or some display
* <code>HScreen</code> has changed, in which case the value
* returned by <code>getSource()</code> SHALL be the affected
* <code>MultiScreenManager</code> or display <code>HScreen</code>,
* and the value returned by <code>getRelated()</code> SHALL be the
* previously active <code>MultiScreenConfiguration</code>.
*
* @since MSM I01
**/
public static final int MULTI_SCREEN_CONFIGURATION_CHANGED = MULTI_SCREEN_CONFIGURATION_FIRST + 1;
/**
* The set of screens associated with a
* <code>MultiScreenConfiguration</code> has changed, with a new
* screen having been added,
* in which case the value returned by <code>getSource()</code> SHALL be
* the affected <code>MultiScreenConfiguration</code>,
* and the value returned by <code>getRelated()</code> SHALL be
* the newly added <code>HScreen</code>.
*
* <p>Except during the interval between the last dispatching of an
* <code>MULTI_SCREEN_CONFIGURATION_CHANGING</code> event and the
* generation of a corresponding
* <code>MULTI_SCREEN_CONFIGURATION_CHANGED</code> event, a screen
* SHALL NOT be added to and a
* <code>MULTI_SCREEN_CONFIGURATION_SCREEN_ADDED</code> event SHALL
* NOT be generated for a multiscreen configuration that is the
* current per-platform or some current per-display multiscreen
* configuration.</p>
*
* @since MSM I01
**/
public static final int MULTI_SCREEN_CONFIGURATION_SCREEN_ADDED = MULTI_SCREEN_CONFIGURATION_FIRST + 2;
/**
* The set of screens associated with a
* <code>MultiScreenConfiguration</code> has changed, with an
* existing screen having been removed, in which case the value
* returned by <code>getSource()</code> SHALL be the affected
* <code>MultiScreenConfiguration</code>, and the value returned by
* <code>getRelated()</code> SHALL be the newly removed
* <code>HScreen</code>.
*
* <p>Except during the interval between the last dispatching of an
* <code>MULTI_SCREEN_CONFIGURATION_CHANGING</code> event and the
* generation of a corresponding
* <code>MULTI_SCREEN_CONFIGURATION_CHANGED</code> event, a screen
* SHALL NOT be removed from and a
* <code>MULTI_SCREEN_CONFIGURATION_SCREEN_REMOVED</code> event SHALL
* NOT be generated for a multiscreen configuration that is the
* current per-platform or some current per-display multiscreen
* configuration.</p>
*
* @since MSM I01
**/
public static final int MULTI_SCREEN_CONFIGURATION_SCREEN_REMOVED = MULTI_SCREEN_CONFIGURATION_FIRST + 3;
/**
* Last event identifier assigned to <code>MultiScreenConfigurationEvent</code>
* event identifiers.
*
* @since MSM I01
**/
public static final int MULTI_SCREEN_CONFIGURATION_LAST = MULTI_SCREEN_CONFIGURATION_FIRST + 3;
/**
* Construct an <code>MultiScreenConfigurationEvent</code>.
*
* @param source A reference to a <code>MultiScreenManager</code>
* instance, a display <code>HScreen</code> instance, or a
* <code>MultiScreenConfiguration</code> instance in accordance with
* the specific event as specified above.
*
* @param id The event identifier of this event, the value of which
* SHALL be one of the following:
* <code>MULTI_SCREEN_CONFIGURATION_CHANGING</code>,
* <code>MULTI_SCREEN_CONFIGURATION_CHANGED</code>,
* <code>MULTI_SCREEN_CONFIGURATION_SCREEN_ADDED</code>, or
* <code>MULTI_SCREEN_CONFIGURATION_SCREEN_REMOVED</code>.
*
* @param related A reference to a <code>MultiScreenConfiguration</code>
* instance or an <code>HScreen</code> instance in
* accordanced with the specific event as specified above.
*
* @since MSM I01
**/
public MultiScreenConfigurationEvent ( Object source, int id, Object related )
{
super ( source, id );
}
/**
* Obtain a related object associated with this event.
*
* @return The related object instance of this event, the value of which
* SHALL be one of the following as determined by the specific
* event type:
* a reference to a <code>MultiScreenConfiguration</code> instance
* or
* a reference to an <code>HScreen</code> instance.
*
* @since MSM I01
**/
public Object getRelated()
{
return null;
}
}
package org.ocap.ui.event;
import java.util.EventListener;
/**
* This listener is used to provide notifications regarding system and
* application induced changes to the global state of the
* <code>MultiScreenManager</code> instance or the state of some display
* <code>HScreen</code> with respect to the per-platform or some
* per-display multiscreen configuration, respectively, or to changes to
* a specific <code>MultiScreenConfiguration</code> instance.
*
* @author Glenn Adams
* @since MSM I01
**/
public interface MultiScreenConfigurationListener extends EventListener
{
/**
* <p>When a <code>MultiScreenConfigurationEvent</code> is
* generated, the implempentation SHALL invoke this method on all
* registered listeners in order to report event information to each
* listener as required by specific event semantics.</p>
*
* <p>In case the event is
* <code>MultiScreenConfigurationEvent.MULTI_SCREEN_CONFIGURATION_CHANGING</code>,
* this method SHALL NOT be invoked unless the application that
* registered this listener has been granted
* <code>MonitorAppPermission("multiscreen.configuration")</code>.
* Furthermore, an implementation of this method SHOULD severely
* limit the amount of processing that may occur, since an absolute
* time limit is placed on the invocation of this method for the set
* of all applicable listeners. </p>
*
* @param evt A <code>MultiScreenConfigurationEvent</code> instance.
*
* @since MSM I01
**/
public void notify ( MultiScreenConfigurationEvent evt );
}
package org.ocap.ui.event;
/**
* A <code>MultiScreenContextEvent</code> is used to report a change to a
* <code>MultiScreenContext</code> to interested listeners.
*
* <p>The following types of changes cause the generation of this
* event:</p>
*
* <ul>
* <li>Change of associated <code>ServiceContext</code>;</li>
* <li>Change of associated display <code>HScreen</code>;</li>
* <li>Change of associated display <code>HScreen</code> area (extent)
* assignment;</li>
* <li>Change of associated set of <code>VideoOutputPort</code>s;</li>
* <li>Change of audio focus of a display <code>HScreen</code>;</li>
* <li>Change of screen visibility;</li>
* <li>Change of screen z-order.</li>
* <li>Change of set of underlying <code>HScreenDevice</code> that
* contribute audio sources to an <code>HScreen</code>;</li>
* <li>Change of set of underlying <code>HScreenDevice</code>
* instances, e.g., due to addition or removal of a
* <code>HScreenDevice</code> from an <code>HScreen</code>;</li>
* <li>Change of the z-order of the underlying <code>HScreenDevice</code>
* instances of an <code>HScreen</code>;</li>
* </ul>
*
* @author Glenn Adams
* @since MSM I01
*/
public class MultiScreenContextEvent extends MultiScreenEvent
{
/**
* The set of <code>HScreenDevice</code> instances associated with the underlying
* <code>HScreen</code> of the source <code>MultiScreenContext</code> has
* changed.
*
* @since MSM I01
**/
public static final int MULTI_SCREEN_CONTEXT_DEVICES_CHANGED = MULTI_SCREEN_CONTEXT_FIRST + 0;
/**
* The z-order of the set of <code>HScreenDevice</code> instances associated with the underlying
* <code>HScreen</code> of the source <code>MultiScreenContext</code> has
* changed.
*
* @since MSM I01
**/
public static final int MULTI_SCREEN_CONTEXT_DEVICES_Z_ORDER_CHANGED = MULTI_SCREEN_CONTEXT_FIRST + 1;
/**
* The <code>ServiceContext</code> associated with the underlying
* <code>HScreen</code> of the source <code>MultiScreenContext</code> has
* changed.
*
* @since MSM I01
**/
public static final int MULTI_SCREEN_CONTEXT_SERVICE_CONTEXT_CHANGED = MULTI_SCREEN_CONTEXT_FIRST + 2;
/**
* The display <code>HScreen</code> associated with the underlying
* <code>HScreen</code> of the source code>MultiScreenContext</code> has
* <changed.
*
* @since MSM I01
**/
public static final int MULTI_SCREEN_CONTEXT_DISPLAY_SCREEN_CHANGED = MULTI_SCREEN_CONTEXT_FIRST + 3;
/**
* The area (extent) of the display <code>HScreen</code> to which the
* underlying <code>HScreen</code> of the source <code>MultiScreenContext</code>
* is assigned has changed.
*
* @since MSM I01
**/
public static final int MULTI_SCREEN_CONTEXT_DISPLAY_AREA_CHANGED = MULTI_SCREEN_CONTEXT_FIRST + 4;
/**
* The set of video output ports associated with underlying
* <code>HScreen</code> of the source <code>MultiScreenContext</code> has
* changed.
*
* @since MSM I01
**/
public static final int MULTI_SCREEN_CONTEXT_OUTPUT_PORT_CHANGED = MULTI_SCREEN_CONTEXT_FIRST + 5;
/**
* The visibility of the underlying <code>HScreen</code> of the source
* <code>MultiScreenContext</code> has changed.
*
* @since MSM I01
**/
public static final int MULTI_SCREEN_CONTEXT_VISIBILITY_CHANGED = MULTI_SCREEN_CONTEXT_FIRST + 6;
/**
* The z-order of the underlying <code>HScreen</code> of the source
* <code>MultiScreenContext</code> has changed.
*
* @since MSM I01
**/
public static final int MULTI_SCREEN_CONTEXT_Z_ORDER_CHANGED = MULTI_SCREEN_CONTEXT_FIRST + 7;
/**
* The audio sources of the underlying <code>HScreen</code> of the source
* <code>MultiScreenContext</code> has changed.
*
* @since MSM I01
**/
public static final int MULTI_SCREEN_CONTEXT_AUDIO_SOURCES_CHANGED = MULTI_SCREEN_CONTEXT_FIRST + 8;
/**
* The audio focus screen of the underlying <code>HScreen</code> of the source
* <code>MultiScreenContext</code> has changed. When the audio
* focus screen of a display <code>HScreen</code> changes, then
* this event SHALL be generated twice (after completing the
* change): firstly to the <code>MultiScreenContext</code> of the
* logical screen which has lost audio focus (if such logical
* screen existed), and secondly to the
* <code>MultiScreenContext</code> of the display screen. In both
* of these cases, the source <code>MultiScreenContext</code> SHALL
* be the display screen.
*
* @since MSM I01
**/
public static final int MULTI_SCREEN_CONTEXT_AUDIO_FOCUS_CHANGED = MULTI_SCREEN_CONTEXT_FIRST + 9;
/**
* Last event identifier assigned to <code>MultiScreenConfigurationEvent</code>
* event identifiers.
*
* @since MSM I01
**/
public static final int MULTI_SCREEN_CONTEXTS_LAST = MULTI_SCREEN_CONTEXT_FIRST + 9;
/**
* Construct a <code>MultiScreenContextEvent</code>.
*
* @param source A reference to a <code>MultiScreenContext</code>
* interface.
*
* @param id The event identifier of this event, the value of which
* SHALL be one of the following:
* <code>MULTI_SCREEN_CONTEXT_DEVICES_CHANGED</code>,
* <code>MULTI_SCREEN_CONTEXT_DEVICES_Z_ORDER_CHANGED</code>,
* <code>MULTI_SCREEN_CONTEXT_SERVICE_CONTEXT_CHANGED</code>,
* <code>MULTI_SCREEN_CONTEXT_DISPLAY_SCREEN_CHANGED</code>,
* <code>MULTI_SCREEN_CONTEXT_DISPLAY_AREA_CHANGED</code>,
* <code>MULTI_SCREEN_CONTEXT_OUTPUT_PORT_CHANGED</code>,
* <code>MULTI_SCREEN_CONTEXT_VISIBILITY_CHANGED</code>,
* <code>MULTI_SCREEN_CONTEXT_Z_ORDER_CHANGED</code>,
* <code>MULTI_SCREEN_CONTEXT_AUDIO_SOURCES_CHANGED</code>, or
* <code>MULTI_SCREEN_CONTEXT_AUDIO_FOCUS_CHANGED</code>.
*
* @since MSM I01
**/
public MultiScreenContextEvent ( Object source, int id )
{
super ( source, id );
}
}
package org.ocap.ui.event;
import java.util.EventListener;
/**
* This listener is used to provide notifications regarding system and
* application induced changes to a <code>MultiScreenContext</code>.
*
* @author Glenn Adams
* @since OCAP 1.0 I16 (ECN XXXX)
**/
public interface MultiScreenContextListener extends EventListener
{
/**
* <p>When an OCAP implementation makes any change to a <code>MultiScreenContext</code>
* that causes generation of a
* <code>MultiScreenContextEvent</code>, then the
* implementation SHALL invoke this method on all registered listeners in
* order to report change information to the listener.</p>
*
* <p>If the application that registered this listener has not been
* granted <code>MonitorAppPermission("multiscreen.context")</code>
* and the source <code>MultiScreenContext</code> associated with
* the specified <code>MultiScreenContextEvent</code> is associated
* with no <code>ServiceContext</code> or a
* <code>ServiceContext</code> that is not accessible to that
* application, then this method SHALL
* NOT be invoked on this listener; otherwise it SHALL be invoked on
* this listener.</p>
*
* <p>A <code>ServiceContext</code> is accessible to an application if it is
* returned from the <code>ServiceContextFactory.getServiceContexts()</code>
* method.</p>
*
* @param evt A <code>MultiScreenContextEvent</code> instance.
*
* @since MSM I01
**/
public void notify ( MultiScreenContextEvent evt );
}
package org.ocap.ui.event;
import java.util.EventObject;
/**
* <p>A <code>MultiScreenEvent</code> is an abstract, base classs used to
* organize event identification codes used by disparate types of events
* related to multiple screen management functionality.</p>
*
* @author Glenn Adams
* @since MSM I01
**/
public abstract class MultiScreenEvent extends EventObject
{
/**
* First event identifier assigned to <code>MultiScreenConfigurationEvent</code>
* event identifiers.
*
* @since MSM I01
**/
public static final int MULTI_SCREEN_CONFIGURATION_FIRST = 0;
/**
* First event identifier assigned to <code>MultiScreenContextEvent</code>
* event identifiers.
*
* @since MSM I01
**/
public static final int MULTI_SCREEN_CONTEXT_FIRST = 32;
/**
* Protected constructor for an <code>MultiScreenEvent</code>.
*
* @param source A reference to an event source as defined by a
* concrete subclass of this class.
*
* @param id The event identifier of this event.
*
* @since MSM I01
**/
protected MultiScreenEvent ( Object source, int id )
{
super ( source );
}
/**
* Obtain the event identifier associated with this event.
*
* @return The event identifier of this event, for which see
* the sub-classes of this class:
* <code>MultiScreenConfigurationEvent</code> and
* <code>MultiScreenContextEvent</code>.
*
* @since MSM I01
*
* @see MultiScreenConfigurationEvent
* @see MultiScreenContextEvent
**/
public int getId()
{
return 0;
}
}
package org.ocap.ui.event;
import java.util.EventObject;
import org.davic.resources.ResourceStatusEvent;
/**
* <p>A <code>MultiScreenResourceEvent</code> is used to report
* changes regarding the resource status of multiscreen related
* resources.</p>
*
* @author Glenn Adams
* @since MSM I01
*
* @see org.davic.resources.ResourceStatusEvent
**/
public class MultiScreenResourceEvent extends ResourceStatusEvent
{
/**
* The reservation on a screen has just been released, indicating
* that the screen (or its constituent screen devices) MAY now be
* reserved (i.e., they are now unreserved).
*
* @since MSM I01
**/
public static final int MULTI_SCREEN_RESOURCE_SCREEN_RELEASED = 0;
/**
* The reservation on a screen has just been granted to an
* application, indicating that the screen (including its constituent
* screen devices) is no longer unreserved.
*
* @since MSM I01
**/
public static final int MULTI_SCREEN_RESOURCE_SCREEN_RESERVED = 0;
/**
* Constructor for an <code>MultiScreenResourceEvent</code>.
*
* @param source A reference to an <code>HScreen</code> instance
* whose resource status has changed.
*
* @param id The event identifier of this event.
*
* @since MSM I01
**/
public MultiScreenResourceEvent ( Object source, int id )
{
super ( source );
}
/**
* Obtain the source object that generated this event.
*
* @return A reference to an <code>HScreen</code> instance, or a
* subclass thereof.
*
* @since MSM I01
**/
public Object getSource()
{
return null;
}
/**
* Obtain the resource event identifier associated with this event.
*
* @return The event identifier of this event, where the identifier
* is one of the following: {
* <code>MULTI_SCREEN_RESOURCE_SCREEN_RELEASED</code>,
* <code>MULTI_SCREEN_RESOURCE_SCREEN_RESERVED</code> }.
*
* @since MSM I01
**/
public int getId()
{
return 0;
}
}
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment