Plus applications user manual  2.9.0.d0fd355
Software library for tracked ultrasound image acquisition, calibration, and processing.
Microsoft Media Foundation compatible imaging device

Supported hardware devices

Any compatible frame grabbers, surgical microscopes (for example Zeiss Pentero), endoscopes, webcams, etc. through Microsoft Media Foundation interface.

Supported platforms

Installation

Media foundation require Microsoft Windows 7 or later.

If your framegrabber uses a "crossbar" for switching between multiple inputs (e.g., composite, s-video) then you may need to connect to your device through a virtual camera software (such as http://splitcamera.com/ or https://manycam.com/). It is recommended to upgrade to a more recent UVC 1.1 compatible device (http://en.wikipedia.org/wiki/USB_video_device_class) or use Imaging controls analog USB frame grabber or Epiphan frame grabber imaging devices that Plus has built-in native support for.

Device configuration settings

  • attribute.png
    Type = "MmfVideo"
    required.png
  • attribute.png
    AcquisitionRate
    optional.png
    Default = "30"
  • attribute.png
    LocalTimeOffsetSec
    optional.png
    Default = "0"
  • attribute.png
    FrameSize Size of the video frame.
    optional.png
    Default = "640 480"
  • attribute.png
    VideoFormat It specifies the video subtype format. All the available formats are described here.
    optional.png
    Default = "YUY2"
  • attribute.png
    CaptureDeviceId Identifier of the capture device. The first device id is 0.
    optional.png
    Default = "0"
  • attribute.png
    CaptureStreamIndex Index of the output stream of the device. The first stream index is 0.
    optional.png
    Default = "0"
  • element.png
    DataSources Exactly one DataSource child element is required.
    required.png

Example configuration file PlusDeviceSet_Server_MmfColorVideoCapture.xml

<PlusConfiguration version="2.0">
<DataCollection StartupDelaySec="1.0" >
<DeviceSet
Name="PlusServer: Media Foundation video capture device - color"
Description="Broadcasting acquired video through OpenIGTLink" />
<Device
Id="VideoDevice"
Type="MmfVideo"
FrameSize="640 480"
VideoFormat="YUY2"
CaptureDeviceId="0" >
<DataSources>
<DataSource Type="Video" Id="Video" PortUsImageOrientation="MF" ImageType="RGB_COLOR" />
</DataSources>
<OutputChannels>
<OutputChannel Id="VideoStream" VideoDataSourceId="Video" />
</OutputChannels>
</Device>
<Device
Id="CaptureDevice"
Type="VirtualCapture"
BaseFilename="RecordingTest.igs.mha"
EnableCapturingOnStart="FALSE" >
<InputChannels>
<InputChannel Id="VideoStream" />
</InputChannels>
</Device>
</DataCollection>
<CoordinateDefinitions>
<Transform From="Image" To="Reference"
Matrix="
0.2 0.0 0.0 0.0
0.0 0.2 0.0 0.0
0.0 0.0 0.2 0.0
0 0 0 1" />
</CoordinateDefinitions>
<PlusOpenIGTLinkServer
MaxNumberOfIgtlMessagesToSend="1"
MaxTimeSpentWithProcessingMs="50"
ListeningPort="18944"
SendValidTransformsOnly="true"
OutputChannelId="VideoStream" >
<DefaultClientInfo>
<MessageTypes>
<Message Type="IMAGE" />
</MessageTypes>
<ImageNames>
<Image Name="Image" EmbeddedTransformToFrame="Reference" />
</ImageNames>
</DefaultClientInfo>
</PlusOpenIGTLinkServer>
</PlusConfiguration>