Package org.cytoscape.view.presentation.customgraphics

Interface CyCustomGraphicsFactory<T extends CustomGraphicLayer>

  • public interface CyCustomGraphicsFactory<T extends CustomGraphicLayer>
    This interface provides the factory to create CyCustomGraphics objects. CyCustomGraphicsFactory objects should be registered as services in OSGi and will be used by Renderers to create the actual custom graphics implementations. Note that the type of a CyCustomGraphicsFactory is the type of the underlying CustomGraphicLayer not the type of the resulting CyCustomGraphics object this creates. In general, the pattern is to add to your CyActivator class: 
            
                CyCustomGraphicsFactory myCustomGraphicsFactory = new MyCustomGraphicsFactory();
                registerService(bundleContext, myCustomGraphicsFactory, CyCustomGraphicsFactory.class, new Properties());

    Module: presentation-api

    To use this in your app, include the following dependency in your POM:

    <dependency>
    <groupId>org.cytoscape</groupId>
    <artifactId>presentation-api</artifactId>
</dependency>

    Cytoscape Backwards Compatibility (SPI Interface): We expect that this interface will be implemented. Therefore to maintain backwards compatibility this interface will only be modified for major version updates.

    • Method Detail

      • getPrefix

        String getPrefix()
        Return the prefix to identify this custom graphics factory. This is used by the passthrough mapping logic to figure out if a given String value should be mapped to this factory.
        Returns:
        the prefix for this CyCustomGraphics

      • supportsMime

        boolean supportsMime​(String mimeType)
        Given a mime type, return true if this CyCustomGraphicsFactory can utilize this type of data. If this factory doesn't support URL resources a tall, this should just always return false.
        Parameters:
        mimeType - the mime type string
        Returns:
        true if this mimeType is supported, false otherwise

      • getInstance

        CyCustomGraphics<T> getInstance​(URL url)
        Get a new instance of the CyCustomGraphics based on pulling the data from a URL. If this CyCustomGraphics type doesn't support URLs, this should always return null.
        Parameters:
        url - the url that points to the CyCustomGraphics data
        Returns:
        the new instance, or null if URL references are not supported

      • getInstance

        CyCustomGraphics<T> getInstance​(String input)
        Get a new instance of the CyCustomGraphics. The string argument may be used by some implementations to create the initial graphics objects. For example, a bitmap graphic implementation might use the input argument as a URI that gives the location of an image file. This is the method that will be used to take a String passthrough mapping and create the correct CyCustomGraphics instance. Note that the prefix defined above will get removed from the string before this method is called.
        Parameters:
        input - a possible input string that may be used to create the instance. Not all implementations will use this.
        Returns:
        the new instance

      • parseSerializableString

        CyCustomGraphics<T> parseSerializableString​(String string)
        Create a new CyCustomGraphics object by parsing the string resulting from the toSerializableString() method. This method will be used to suport serialization of discrete mappings.

      • getSupportedClass

        Class<? extends CyCustomGraphics> getSupportedClass()
        Return the class that this factory creates. This is used by the deserialization mechanism to find the factory method that can deserialize a given string.