Examples of ptolemy.kernel.util.Configurable

ptolemy.kernel.util.Configurable

Objects that can be configured by reading a file or configuration information given as text, typically in XML format, should implement this interface. This enables a user of a component to recognize that such file-based configuration is possible, and permits configuration to be specified via the MoML configure element. For example, a plotter actor implements this interface to allow the visual appearance of the plot to be set using PlotML. An icon for an actor implements this interface to allow the actor-specific visual features of the icon to be specified using graphics markup. Additionally, a filter actor could implement this interface to allow the filter specification to be given using markup.

This interface can also be used for actors which load configuration information from non-XML formats, such as GIF images or binary lookup tables. The source argument of the configure() method simply points to such a file.

This interface is designed to be reversible, so that an object can also provide enough information to reconstruct its current configuration. This mechanism is used when writing MoML from instantiated objects, although it could also be used to write a description of the object in other forms. In order for this to work properly calling the configure method on any object of the same type, given the data returned by the getSource and getText methods should result in an object that resemble the first as closely as possible. @author Edward A. Lee, Steve Neuendorffer @version $Id: Configurable.java,v 1.22 2005/07/08 19:59:15 cxh Exp $ @since Ptolemy II 1.0 @Pt.ProposedRating Green (neuendor) @Pt.AcceptedRating Green (bart) @see ptolemy.actor.CompositeActor @see ptolemy.actor.AtomicActor

                // close the skipping.
                _skipElement--;
            }
        } else if (elementName.equals("configure")) {
            try {
                Configurable castCurrent = (Configurable) _current;
                String previousSource = castCurrent.getConfigureSource();
                String previousText = castCurrent.getConfigureText();
                castCurrent.configure(_base, _configureSource, _currentCharData
                        .toString());


                // Propagate to derived classes and instances.
                try {
                    // This has the side effect of marking the value
                    // overridden.
                    _current.propagateValue();
                } catch (IllegalActionException ex) {
                    // Propagation failed. Restore previous value.
                    castCurrent.configure(_base, previousSource, previousText);
                    throw ex;
                }
            } catch (NoClassDefFoundError e) {
                // If we are running without a display and diva.jar
                // is not in the classpath, then we may get"

        String portName = port.getName(_toplevel);
        String labelName = portName.replace('.', '_');
        Attribute label = _toplevel.getAttribute(labelName);


        if (label != null) {
            Configurable config = (Configurable) label
                    .getAttribute("_iconDescription");


            if (config != null) {
                String moml = "<property name=" + "\"_iconDescription\" "
                        + "class=\"ptolemy.kernel.util"

Examples of ptolemy.kernel.util.Configurable

Related Classes of ptolemy.kernel.util.Configurable