com.kuka.roboticsAPI.deviceModel
Interface IDeviceFactory

All Superinterfaces:

IEngine

All Known Implementing Classes:

DeviceFactory

public interface IDeviceFactory
extends IEngine

This class can create devices for the controllers during the initialization phase. Controller implementations may use this class to let it create their devices.

This is useful, because with a user defined factory, he has the possibility to use custom devices in the RoboticsAPI.

This element is an undocumented internal feature. It is not intended to be used by applications as it might change or be removed in future versions.

Method Summary

Device

createDevice(Controller controller, String name, String proposedFullQualifiedClassName, ITransformation deviceRoot) Creates the device for the given controller, device name and the proposed class name.

Methods inherited from interface com.kuka.roboticsAPI.IEngine

dispose, getContext, getEngineType, initialize, setParameters

Method Detail

createDevice

Device createDevice(Controller controller,
                    String name,
                    String proposedFullQualifiedClassName,
                    ITransformation deviceRoot)

Creates the device for the given controller, device name and the proposed class name. This is just a proposal and may be ignored by the concrete factory implementation.

Please note that the device must be initialized after this call.

The call should fail with a runtime exception when the device could not be created.

Parameters:

controller - The controller to which the device is attached.

name - The name of the device.

proposedFullQualifiedClassName - The full qualified class name as a proposal for the device type. Will be a subclass of Device.

deviceRoot - The desired root frame for this device.

Returns:

The created device.

This element is an undocumented internal feature. It is not intended to be used by applications as it might change or be removed in future versions.