Gebruikershandleiding Horus Movie Player

Gebruikershandleiding Horus Movie Player
Horus Recorder Builder
User Manual
User manual Horus Recorder Builder
1
REVISION HISTORY
DATE
VERSION
AUTHOR
October 2013
May 2015
1.0
2.0
Bijwoordbeeld tekst en techniek
Bijwoordbeeld tekst en techniek
User manual Horus Recorder Builder
2
CONTENTS
1
WORKING WITH THE INSPECTION AND SURVEY SUITE
5
1.1
5
Introduction
2
STARTING THE HORUS RECORDER BUILDER
6
3
DESCRIPTION OF THE HORUS RECORDER BUILDER
7
3.1
7
Screen elements
4
DEVICES
5
GRABBERS – DESCRIPTION AND PROPERTIES
10
5.1
Arduino grabber
10
5.2
Audio grabber
10
5.3
Allied vision technologies (GigE) grabber
11
5.4
Basler grabber
12
5.5
FlyCapture Grabber
12
5.6
Game Pad grabber
13
5.7
Microflown grabber
13
5.8
HTTP grabber
14
5.9
IMU grabber
15
5.10
Ladybug grabber
15
5.11
Media foundation grabber
16
5.12
NMEA grabber
16
5.13
Ublox grabber
17
5.14
PTZ grabber
18
5.15
RTSP grabber
18
5.16
CSV Nmea grabber
19
5.17
Serial sensor grabber
20
5.18
Sony SNC grabber
20
5.19
Sony ZCL grabber
21
5.20
System status grabber
21
5.21
Trigger grabber
22
5.22
Ximea grabber
22
User manual Horus Recorder Builder
9
3
6
7
COMPONENTS – DESCRIPTION AND PROPERTIES
23
6.1
Recording location
23
6.2
Delay
24
6.3
Disk cleaner
24
6.4
File writer
25
6.5
Filter
26
6.6
Trigger on event
26
6.7
Console Writer
27
6.8
Image decoder
27
6.9
Image encoder
28
6.10
Image converter
28
6.11
Direct Show Audio
29
6.12
NamedMemory sink
29
6.13
Nmea Reader
30
6.14
Nmea Writer
30
6.15
Jpeg Encoder
30
6.16
Transforms Orientation
31
6.17
Transforms Quaternion Euler
32
6.18
Network reader
32
6.19
Network writer
33
CREATING A NEW PIPELINE
34
7.1
Adding components
34
7.2
Component properties
35
7.3
Opening an existing pipeline
36
7.4
Send a pipeline
36
8
GENERATING A CAMERA CONFIGURATION
9
INDEX 38
User manual Horus Recorder Builder
37
4
1
Working with the Inspection and Survey Suite
1.1
Introduction
The Horus Inspection and Survey Suite consists of three programs: the Horus Movie Recorder, the
Horus Movie Maker and the Horus Movie Player. The Horus Movie Recorder’s main function is to
record all the data from the camera’s and additional sensors. The Horus Movie Recorder has a simple
playback function, it is merely used to check the images that have just been recorded.
The Horus Movie Maker is used to edit the recordings, it is used to select the useful recordings and
allow you to cut out sections that aren’t needed. The Horus Movie Player is used for the actual
inspection and survey duties. This manual describes the Horus Movie Maker software. This program is
used to edit the recorded camera streams so the recordings are tailored for the Inventory and Survey
with the Horus Movie Player software.
This manual is written in the assumption that the reader has basic knowledge of video inspections and
basic computer knowledge.
User manual Horus Recorder Builder
5
2
Starting the Horus Recorder Builder
The Horus Recorder Builder is linked to the Data Grabber module, the Horus Recorder Builder will only
work when the Data Grabber is active. Before you can start working with the Horus Recorder Builder,
you need to start the Data Grabber first before the Horus Recorder Builder is started.
To start the Data Grabber, double click on the icon:
Fig. 1- Data Grabber icon
Wait until the Data Grabber is active:
Fig. 2- Data Grabber is active
Start the Horus Recorder Builder by double clicking the icon:
Fig. 3- Horus Recorder
Builder Icon
When the Horus Recorder Builder is started, the main screen is initially blank, this is because the
Horus Recorder Builder and the Data Grabber are not connected yet. Click the Connect icon in the
upper left corner:
Fig. 4- Connect icon
The Connect screen opens, specify the Host name and the port and click OK to connect:
Note: When the DataGrabber and the Horus Recorder Builder are installed on the same machine, the
default settings don not have to be changed.
Fig. 5- Connect screen
After the Horus Recorder Builder and the Data Grabber are connected, the Horus Recorder Builder is
ready to use.
User manual Horus Recorder Builder
6
3
Description of the Horus Recorder Builder
3.1
Screen elements
From left to right:
1
Toolbar
2
Component panels
3
Build screen
Fig. 6- Screen elements
The Horus Recorder Builder is used to build so called recording pipeline, a data stream in which
camera setups, grabbers and physical devices are connected. In the component panels (2) you can
select camera’s, grabbers, components and drag and drop them in the build screen (3). All
components that are placed in the main screen can be connected by simple drawing a line between the
components you want to connect. The pipeline that is created in the main screen can be exported as a
Horus Recorder Pipeline file.
3.1.1
Toolbar buttons
From left to right:
Connect
Fig. 7- Horus Recorder Builder toolbar
New pipeline
Load pipeline
Import on top of current pipeline
Send pipeline
Start pipeline
Stop pipeline
Generate camera configuration
User manual Horus Recorder Builder
7
3.1.2
Component panels
The component screen consists of four separate panels that represent a group of components:
Devices, grabbers, Components and the Properties of the components:
Fig. 8- Component panels
3.1.3
Component properties
The component properties are shown at the bottom of the Component panels. By using the pull down
menus and the fill in field you can set the properties of a component. The settings are described in
section 7.2
3.1.4
Expand or collapse a group
The component groups can be expanded or collapsed using the arrows in the group title:
Fig. 9- Expand / collapse arrows
User manual Horus Recorder Builder
8
4
Devices
The upper section in the component panel displays the Devices. In this section all the components that
the DataGrabber detects (devices connected to the computer) are shown, for instance a webcam,
microphone and cameras that are directly connected to the computer.
Fig. 10- Devices section
User manual Horus Recorder Builder
9
5
Grabbers – description and properties
Grabbers are used to ‘grab’ the data from the camera and transfer the data into a data stream that is
useable for further data transportation and processing.
5.1
Arduino grabber
Fig. 11- Arduino grabber
The Arduino grabber is a trigger grabber, based on frequency triggering. The properties of the Arduino
grabber can be set in the Properties panel.
PROPERTY
DESCRIPTION
Baud rate
Com port
Mode
Name
SerialNmeaOutput
SystemCoordinate
Type
Defines the pulse frequency, default is 115200 baud
Sets the COM port
The mode of the Arduino grabber 1=Stop, 2-=PPS, 3= Freerun, 4=External
Sets the name of the grabber instance in the pipeline
Select this option to let the Arduino write $HRS and other Nmea messages
Select this option to regard the Arduino output as the main system coordinate
Selects the trigger type. For Horus software, this is 1: Trigger_1
5.2
Audio grabber
Fig. 12- Audio grabber
The Audio grabber records the audio from audio input 1 on the computer.
5.2.1
Audio grabber properties
PROPERTY
DESCRIPTION
Name
StreamIndex
Sets the name of the grabber instance in the pipeline
Sets the stream index
User manual Horus Recorder Builder
10
5.3
Allied vision technologies (GigE) grabber
Fig. 13- Allied Vision grabber
This grabber is used to capture image streams from Allied Vision Technologies GigE cameras.
Drag the grabber to the build screen and complete the SerialNumber property. You should enter the
serial number of the camera you wish to capture here (this number should be mentioned on the casing
of the camera). Alternatively, you can expand the Devices panel at the top and drag a discovered
camera to your build screen for which the serial number property will be automatically entered.
Note that these cameras often output raw image data without any compression. Due to the size of
these packets, storing them on disk or transmitting them over a network may be unfeasible. You can
use a JPEG encoder component or image converter component between this grabber and the rest of
the pipeline to compress the images to a smaller size.
5.3.1
Allied Vision grabber properties
PROPERTY
DESCRIPTION
Name
ConfigFileIndex
SerialNumber
The name of the grabber instance.
The index number of a configuration that is stored on the camera.
The serial number of the camera that should be capured.
User manual Horus Recorder Builder
11
5.4
Basler grabber
Fig. 14- Basler grabber
The Basler grabber is used to grab the data from Basler cameras. The following properties of the
Basler grabber can be set:
5.4.1
Basler grabber properties
PROPERTY
DESCRIPTION
Auto exposure
Method
Name
Select this option to enable auto exposure
Selects the protocol, either MJPEG or JPEG
Used to change the name of the grabber in the pipeline
5.5
FlyCapture Grabber
Fig. 15- Fly Capture grabber
The FlyCapture grabber is used to grab the data from Point Grey FlyCapture cameras. When the
PointGrey camera's are directly attached to the system, the cameras will be displayed in the Devices
section. The camera's can be dragged and dropped in the Horus Recorder Builder workspace. The
following properties of the FlyCapture grabber can be set:
5.5.1
FlyCapture grabber properties
PROPERTY
DESCRIPTION
Branch
Configuration Index
Name
Serial Number
Stream Index
Can be left empty
The configuration index that needs to be loaded
The name that is displayed in the Horus Recorder Builder
The serial number of the camera that captures the images
Sets the stream index
User manual Horus Recorder Builder
12
5.6
Game Pad grabber
Fig. 16- Game Pad grabber
This grabber is used to allow control via an X-Box game controller. The device is automatically
recognized when connected and displayed in the Devices section.
5.7
Microflown grabber
Fig. 17- Microflown grabber
This grabber processes events generated by the Microflown gunshot detector. Drag the grabber to the
build screen and complete the Port property. You should enter the same port as you entered in the
Microflown sensor software. The grabber will listen on this port for events from the Microflown
software.
5.7.1
Microflown grabber properties
PROPERTY
DESCRIPTION
Name
Port
The name of the grabber instance.
The UDP port to listen on for event messages. Defaults to 1234.
User manual Horus Recorder Builder
13
5.8
HTTP grabber
Fig. 18- Grabbers in the component panels
The HTTP grabber in the Horus Recorder Builder can capture HTTP (MJPEG) streams from cameras
that provide such data. To connect a grabber, drag a grabber to the build screen and enter the URL
where the camera provides the MJPEG stream.
5.8.1
HTTP Grabber properties
PROPERTY
DESCRIPTION
Name
URL
The name of the grabber instance.
The URL where the camera provides the MJPEG stream. For example:
http://192.168.1.43/axis-cgi/mjpg/video.cgi
User manual Horus Recorder Builder
14
5.9
IMU grabber
Fig. 19- IMU grabber
This grabber registers the motion (e.g. roll, pitch, yaw) of the unit is mounted on. The data of the IMU
can be enriched into other grabber data.
Drag the grabber to the build screen and complete the COM_BAUDRATE and COM_PORT properties.
Set these to the baud rate and com port that the IMU device uses. Select the sentence the IMU should
deliver and select the type of IMU from the pull down menu.
5.9.1
IMU grabber properties
PROPERTY
DESCRIPTION
Baud rate
Com port
The baud rate (speed) that the device uses.
Which com port the PTZ device sending sentences to. For example:
“COM3”.
Sets the polling frequency to the IMU / GPS unit.
The name of the grabber instance.
(Supported) type of IMU.
Frequency
Name
Type
5.10
Ladybug grabber
Fig. 20- ladybug grabber
This grabber is used to capture streams from Ladybug cameras. Drag the Ladybug grabber to the build
screen. The grabber currently only supports capturing a single Ladybug camera and will automatically
capture the first Ladybug camera it finds.
5.10.1 Ladybug grabber properties
PROPERTY
DESCRIPTION
Name
FrameRate
The name of the grabber instance.
The frame rate to set the camera to. Only applicable if the camera is not in
triggered mode.
Whether to set the camera to triggered mode. In triggered mode, the camera
will only capture a panorama when it receives a signal on its trigger port. You
should therefore only enable this if you have a hardware trigger connected to
your Ladybug camera.
Triggered
User manual Horus Recorder Builder
15
5.11
Media foundation grabber
Fig. 21- Media foundation grabber
This grabber is used to capture streams from windows media foundation devices. These are devices
that are recognized by Microsoft Windows, such as webcams and other USB cameras.
The most convenient way to connect a media foundation device is to use the discovery feature: expand
the Devices panel (see 3.1.2) at the top and drag any discovered Media Foundation devices. You can also
configure the grabber by hand by dragging the grabber from the Grabbers panel and completing the
Source property. You should enter (part of) the name of the desired device for the source property.
5.11.1 Media foundation grabber properties
PROPERTY
DESCRIPTION
Name
Decode
Height
The name of the grabber instance.
Whether the output should be decoded to raw video.
The desired output width. If the exact combination of width and height is not
available for the selected source, the nearest width and height will be used.
The desired output width. If the exact combination of width and height is not
available for the selected source, the nearest width and height will be used.
The media foundation source. This can be (1) part of a name of an audio or video
device or (2) empty to use the first video device in the system.
Width
Source
5.12
NMEA grabber
Fig. 22- NMEA grabber
This grabber captures NMEA (such as GPS) data from a serial port. Drag the grabber to the build
screen and complete the COM_BAUDRATE and COM_PORT properties. Set these to the baud rate and
com port that the NMEA device uses.
User manual Horus Recorder Builder
16
5.12.1 NMEA grabber properties
PROPERTY
DESCRIPTION
Name
SystemCoordinateSentence
The name of the grabber instance.
Which NMEA sentence is marked as system coordinate. Refer to the
manual section on system coordinates.
Which com port the NMEA device sending sentences to. For example:
“COM3”.
The baud rate (speed) that the device uses to transmit NMEA sentences.
COM_PORT
COM_BAUDRATE
5.13
Ublox grabber
Fig. 23- Ublox grabber
This grabber captures UBlox (GPS) data from a serial port. Drag the grabber to the workspace and
complete the COM_BAUDRATE and COM_PORT properties. Set these to the baud rate and com port
that the Ublox devices uses.
5.13.1 Ublox grabber properties
PROPERTY
DESCRIPTION
Name
SystemCoordinateSentence
The name of the grabber instance.
Which NMEA sentence is marked as system coordinate. Refer to the
manual section on system coordinates.
Which com port the NMEA device sending sentences to. For example:
“COM3”.
The baud rate (speed) that the device uses to transmit NMEA sentences.
COM_PORT
COM_BAUDRATE
User manual Horus Recorder Builder
17
5.14
PTZ grabber
Fig. 24- PTZ grabber
This grabber captures pan tilt zoom (PTZ) commands from a serial port. It can process different PTZ
protocols, such as Pelco-D. Drag the grabber to the build screen and complete the COM_BAUDRATE
and COM_PORT properties. Set these to the baud rate and com port that the PTZ device uses.
5.14.1 PTZ grabber properties
PROPERTY
DESCRIPTION
Name
Protocol
The name of the grabber instance.
The protocol that the PTZ device uses. Valid values are:
Pelco-D: the frequently used Pelco-D protocol
Horus ASCII: an proprietary format used primarily for test purposes
Which com port the PTZ device sending sentences to. For example: “COM3”.
The baud rate (speed) that the device uses.
COM_PORT
COM_BAUDRATE
5.15
RTSP grabber
Fig. 25- RTSP grabber
This grabber captures Real Time Streaming Protocol (RTSP) network streams from cameras and other
sources that provide one. Drag the grabber to the build screen and complete the URL property.
5.15.1 RSTP grabber properties
PROPERTY
DESCRIPTION
Name
URL
The name of the grabber instance.
The URL of the RTSP stream to capture. For cameras, this URL can often be
obtained from the camera’s documentation. For example: “rtsp://192.168.1.5”.
User manual Horus Recorder Builder
18
5.16
CSV Nmea grabber
Fig. 26- CSV Nmea grabber
The CSV NMEA grabber reads out a string from a COM port. And can parse the STRING to extract the
right data from the string that is published on the COM port.
PROPERTY
DESCRIPTION
Altindex
Baud rate
Branch
COM port
Delimiter
EPSG
Exclude filter
HeadingIndex
IdIndex
Latindex
LonIndex
Name
PitchIndex
RollIndex
System-Coordinate
Use As Line feed
UtcIndex
YawIndex
Column which represents the Altitude value
Baudrate of the COM port -> usually 115200
Can be left empty
Sets the COM port is the devices connected to the system
Delimiters used in the output string of the attached device
EPSG:4326: Coordinate system
If a line contains the exclusion filter, it will be ignored
Column which represents the Heading value
Column which represents the indentiefier value
Column which represents the Latitude value
Column which represents the Longitude value
Can be left empty
Column which represents the Pitch value
Column which represents the Roll value
Specifies wether or not it is a system coordinate
Ignores all other properties and generates TEXT data
Column which represents the Utc value
Column which represents the Yaw value
User manual Horus Recorder Builder
19
5.17
Serial sensor grabber
Fig. 27- Serial sensor grabber
5.18
Sony SNC grabber
Fig. 28- Sony SNC grabber
This grabber captures streams from Sony cameras that use the Sony Network Camera (SNC) API. Drag
the grabber to the build screen and complete all properties. Alternatively, you can expand the Devices
panel at the top and drag a discovered SNC camera to your build screen for all properties will
automatically be completed. Note that the username and password will both be set to admin for
discovered devices. If your camera uses a different username and password, you should adjust these
properties accordingly.
5.18.1 Sony SNC grabber properties
PROPERTY
DESCRIPTION
Name
IPAddress
Port
Protocol
The name of the grabber instance.
The IP address of the camera.
The port the camera accepts connections on.
The protocol to use to communicate with the camera. Valid values are:
http
https
rtp_over_udp
The username that should be used to connect to the camera.
The password that should be used to connect to the camera.
Whether or not the grabber should provide credentials when connecting to the
camera. When this property is unchecked, the Username and Password
properties will be ignored.
Username
Password
UseAuthentication
User manual Horus Recorder Builder
20
5.19
Sony ZCL grabber
Fig. 29- Sony ZCL grabber
This grabber is used for grabbing images from Sony ZCL cameras. Install the device driver software of
the Sony ZCL camera. Sony ZCL uses their own gige device drivers to connect their camera. Once the
drivers are installed. The grabber can be used in the software.
5.19.1 Sony ZCL grabber properties
PROPERTY
DESCRIPTION
Name
MacAddress
UserSettings
The name of the grabber instance.
Device id of the camera to connect with.
Load internal camera settings with id.
5.20
System status grabber
Fig. 30- System status grabber
This grabber captures the current state of the system that the recorder is running on. It can record
CPU usage and remaining disk space. It is frequently used in combination with the “Disk cleaner”
component to ensure enough free disk space is available. Refer to the documentation of said
component for more information on the interaction between them.
Drag the grabber to the build screen to capture CPU usage. If you also wish the capture free disk
space, complete the DiskSpaceMeasurementPaths property.
5.20.1 System status grabber properties
PROPERTY
DESCRIPTION
Name
CpuUsageMeasurementInterval
The name of the grabber instance.
The interval with which to measure the CPU usage in hh:mm:ss
format. The default is every second (00:00:01).
The interval with which to measure the remaining free disk space in
hh:mm:ss format. The default is every second (00:00:01).
The paths to the disks for which remaining disk space should be
measured, separated by new lines (enters). For example: “c:\”.
DiskSpaceMeasurementInterval
DiskSpaceMeasurementPaths
User manual Horus Recorder Builder
21
5.21
Trigger grabber
Fig. 31- Trigger grabber
This grabber will log trigger signals sent to a serial port. This can be used to record at which times an
external hardware trigger fired. Drag the grabber to the build screen and complete the
COM_BAUDRATE and COM_PORT properties. Set these to the baud rate and com port the trigger is
connected to.
5.21.1 Trigger grabber properties
PROPERTY
DESCRIPTION
Name
COM_PORT
COM_BAUDRATE
The name of the grabber instance.
Which com port. For example: “COM3”.
Baudrate of the port. For example “115200”.
5.22
Ximea grabber
Fig. 32- Ximea grabber
The Ximea grabber is used to grab the data from Ximea cameras. The following properties of the Ximea
grabber can be set:
PROPERTY
DESCRIPTION
Auto exposure
Downsampling
Name
Pixel format
Trigger mode
StreamIndex
Select this option to enable auto exposure
Enables / Disables Downwsampling
Set the name of the Ximea grabber in the pipeline
Selects the output pixel format: Mono8, Mono16, BGRA or Bayer
Selects the the trigger mode: Off, Rising Edge, Falling Edge
Sets the stream index
User manual Horus Recorder Builder
22
6
Components – Description and properties
6.1
Recording location
Fig. 33- Recording location component
The recording location component is a container component for the file writer component. It does not
have any inputs or outputs itself, but is instead used to place file writer components on. It represents a
disk and directory where the file writers will write their incoming packets to.
Drag a recording location to the build screen and enter a valid path in the Recording location property.
You can then drag file writer components to the recording location.
6.1.1
Recording location properties
PROPERTY
DESCRIPTION
Name
The name of the component.
RecordingLocation
The path that the file writer components in the recording location
will write their data to. Note that the actual data will be placed in
recording subdirectories of the specified path.
MaximumLocationTotalSize
The maximum size that a single recording directory can consume
for this recording location. If this limit is reached, a new recording
directory will be created. You can enter the value as bytes (e.g.
'123'), kilobytes (e.g. '123kb'), megabytes or gigabytes (e.g. ‘10GB’).
MaximumLocationSingleFileSize
The maximum size that any file writer in a recording directory can
consume for this recording location. If this limit is reached, a new
recording directory will be created. You can enter the value as bytes
(e.g. '123'), kilobytes (e.g. '123kb'), megabytes or gigabytes (e.g.
‘10GB’).
User manual Horus Recorder Builder
23
6.2
Delay
Fig. 34- Delay
The delay component is a software delay that can be used to synchronize audio and video. The delay is
set in milliseconds in the Properties panel.
6.3
Disk cleaner
Fig. 35- Disk cleaner component
The disk cleaner component can be used to ensure that sufficient free disk space remains available at
all times. It should be used together with the System status grabber (see 5.15), as it processes packets
generated by said grabber. The system status grabber measures the available disk space and provides
this data to the disk cleaner component. The disk cleaner component can then delete old recordings
when the available free disk space drops below a predefined threshold.
The input of the disk cleaner component should originate from the System Status grabber. The disk
cleaner component has no output. The setup should thus be as follows:
Fig. 36- Connection example
User manual Horus Recorder Builder
24
6.3.1
Disk cleaner properties
PROPERTY
DESCRIPTION
Name
CleanupPolicy
The name of the component.
The policy that will be used to determine which directories to remove in order to
create more free disk space. Valid values are:
DELETE_EARLIEST_MODIFICATION_DATE: deletes the directory that has the
oldest modification date.
The paths that recordings will be deleted from. Warning: be very careful of what
you input here, as the component will remove directories from these locations.
For this reason, top level directories such as “/” or “c:\\” are ignored to prevent
accidental removal of important data.
The minimum space that any disk should have. When the disk space on any
watched paths drops below this number, directories are deleted from the
configured paths using the configured policy. You can enter the value as a
number in bytes, or as text such as '10GB' or '128MB'.
DiskCleanupPaths
MinimumDiskSpace
6.4
File writer
Fig. 37- File writer placed in a recording location
The file writer component stores the packets it receives on disk. It can thus be used to make a
recording of data generated by grabbers.
Drag a file writer component into a recording location component, which acts as a container. You
cannot drop a file writer without a recording location: the recording location specifies the disk and
directory where one or more file writers store their data. The file writer takes one or more inputs and
has no outputs.
6.4.1
File writer properties
PROPERTY
DESCRIPTION
Name
Attachments
The name of the component.
One or more files that will be stored alongside the data of this file
writer. Can be used to output additional files to recording
directories. This is often used to store the "setup.hsf" (See section 8,
page 37) file into a recording directory.
The file name of the file that this file writer writes to.
Copied from the recording location the file writer is placed on.
Cannot be edited.
Copied from the recording location the file writer is placed on.
Cannot be edited.
Copied from the recording location the file writer is placed on.
Cannot be edited.
Device
MaximumLocationTotalSize
MaximumLocationSingleFileSize
RecordingLocation
User manual Horus Recorder Builder
25
6.5
Filter
Fig. 38- Filter component
This component can be used to filter the data passing through it. For example, you can use the filter to
block everything but image key frames. This can be useful to limit the throughput of image formats that
use key frames, such as H264.
The filter should be placed in between two pipeline elements. It will examine the incoming data and
only transmit messages that satisfy the specified criteria. For example:
Fig. 39- Connection example
6.5.1
Filter properties
PROPERTY
DESCRIPTION
Name
KeyFramesOnly
The name of the component.
Whether to only let packets through that (1) contain image data and (2) contain
image data that represents an image key frame.
6.6
Trigger on event
Fig. 40- Trigger on event component
This component is used for generating a trigger when an event occurs. With this component the
behavior of the pipeline can be altered by events that this component receives.
A Trigger on event component can be connected to grabbers and components that are able to generate
an event. A trigger will never occur if this component is connected to non-event generating
components or grabbers.
6.6.1
Trigger on event properties
PROPERTY
DESCRIPTION
Name
The name of the Trigger on event instance.
User manual Horus Recorder Builder
26
6.7
Console Writer
Fig. 41- Console writer component
This component gives the user feedback on one or multiple component(s) or grabber(s) in the pipeline.
The console writer lists all the streams that pass the console writer and updates the information every
couple of seconds. If a stream isn't producing any data anymore the stream will be shown in red. The
output of the Console Writer is available as data in the DataGrabber component
The Console Writer can be connected to any or multiple component(s) or grabber(s). The Console
Writer produces data that can be seen in the DataGrabber..
6.7.1
Console writer properties
PROPERTY
DESCRIPTION
Name
The name of the component.
6.8
Image decoder
Fig. 42- Image decoder component
This component is able to decode encoded source streams to RAW images. The image encoder can be
connected to any component or grabber in the pipeline that produces RAW images or encoded images
(Bayer format not yet supported.) The raw image stream can be picked up for further processing in the
pipeline.
6.8.1
Image decoder properties
PROPERTY
DESCRIPTION
Name
The name of the component.
User manual Horus Recorder Builder
27
6.9
Image encoder
Fig. 43- Image encoder component
This component encodes (RAW) source images to a preset of selected encoded output formats. The
image encoder can be connected to any component or grabber in the pipeline that produces RAW
images (Bayer format not yet supported.) The encoded image stream can be picked up for further
processing in the pipeline.
6.9.1
Image encoder properties
PROPERTY
DESCRIPTION
Name
Preset
The name of the component.
A predefined encoder setting to be chosen from. Currently only H264 or MJPEG
streams are implemented.
6.10
Image converter
Fig. 44- Image converter component
This component is able to transform the size and underlying pixel format of the (RAW) source images.
The size can be changed to default size values or a percentage of the original. The pixel format can be
used to change the internal representation of the source image.
The image converter can be connected to any component or grabber in the pipeline that produces RAW
images (Bayer format not yet supported.) The transformed image stream can be picked up for further
processing in the pipeline.
User manual Horus Recorder Builder
28
6.10.1 Image converter properties
PROPERTY
DESCRIPTION
Name
Pixel format
The name of the component.
Change the internal pixel representation for the source image. Formats can be
changed from and to RGB(A)/BGR(A) red green blue (alpha) to Chroma
Luminance (YUV) or Black and White (Mono) representations.
Change the size of the image to default settings or a percentage of the original.
Size
6.11
Direct Show Audio
Fig. 45- Direct Show Audio
Direct Show Audio offers a audio stream via the Media Foundation Services. Note: Only be used when
advised by the Horus Crew
6.12
NamedMemory sink
Fig. 46- Named memory sink
The Named Memory sink: a methode to sent raw memory blocks between applications. Note: Only be
used when advised by the Horus Crew
User manual Horus Recorder Builder
29
6.13
Nmea Reader
Fig. 47- Nmea Reader
The NMEA Reader transforms the incoming NMEA streams to a valid Horus Format. Note: Only be
used when advised by the Horus Crew
6.14
Nmea Writer
Fig. 48- Nmea Writer
The NMEA Writer transforms the Horus stream to a NMEA stream. Note: Only be used when advised by
the Horus Crew
6.15
Jpeg Encoder
Fig. 49- Jpeg encoder
This component encodes the incoming image packets to JPEG format. This is particularly useful for
cameras that do not have any compression method built in: storing and/or transmitting raw image data
can often be infeasible. Encoding raw image data to JPEG reduces the required bandwidth and storage
space.
Connect the camera grabber to the Jpeg Encoder component and link the Jpeg Encoder component to
the filewriter to store mjpeg on the fly. Be sure that the camera can produce RGB(A)/BGR(A) or
YUV420/422/444 images, else the image converter is needed to change the pixel format of the source.
User manual Horus Recorder Builder
30
Fig. 50- Connection example
6.15.1 Jpeg Encoder properties
PROPERTY
DESCRIPTION
Name
DCT method
The name of the component.
Advanced option. The discrete cosine transform (DCT) method can be used to
fine-tune performance versus quality.
The quality of the resulting image [0-100]. A lower quality results in faster
encoding but in a lower quality image.
Quality
6.16
Transforms Orientation
Fig. 51- Transforms orientation
The transforms orientation component is used to correct the offset of an IMU. This is done when the
IMU data is not corresponding with the factual situation.
6.16.1 Transforms Orientation properties
PROPERTY
DESCRIPTION
Disable Rotation
Invert-X
Invert-Y
Invert-Z
Name
Rotate-X
Disables one of the axis.
Inverts the axis
Inverts the axis
Inverts the axis
Sets the name of the component
Corrects the rotation of the axis. This can be set with the up and down arrows
in this field.
Corrects the rotation of the axis. This can be set with the up and down arrows
in this field.
Corrects the rotation of the axis. This can be set with the up and down arrows
in this field.
Rotate-Y
Rotate-Z
User manual Horus Recorder Builder
31
6.17
Transforms Quaternion Euler
Fig. 52- Transforms Quaternion Euler
The Transforms Quaternions Euler component is used to transform three dimensional IMU data to
rotation orientation (Roll, Pitch, Yaw) or Euler angles.
6.17.1 Transform Quaternion Euler properties
PROPERTY
DESCRIPTION
Angles 2 Orientation
Check this box to transform sensor data from Degrees to Rotation Orientation
(Roll, Pitch, Yaw)
Check this box to transform sensor data from Degrees / Radion to Quaternions
Sets the name of the component
Check this box to transform Rotation Orientation data to Degrees
Check this box to transform Quaternions to Radian units
Angles 2 Quaternion
Name
Orientation 2 Angles
Quaternion 2 Angles
6.18
Network reader
Fig. 53- Network reader component
This component reads (ZeroMQ) network streams as generated by the Network writer component (see
6.7). It can be used to connect two different instances of the recorder software (on two different
computers for example): one should contain a network writer component and the other instance
should contain a network reader component. The reader receives packets from the network writer and
output them into its own pipeline.
The network reader component has no inputs and one or multiple outputs.
6.18.1 Network reader properties
PROPERTY
DESCRIPTION
Incoming Format
Defines the format of the incoming data, either Horus or Ascii. Non-Horus data
will automatically be converted to Horus, in order to produce usable data for
other components.
Sets the mode of the Network reader; Server or Client.
The name of the component.
Sets the COM port
Selects the transmisiion protocol: TCP (default) or UDP
Mode
Name
Port
Protocol
User manual Horus Recorder Builder
32
6.19
Network writer
Fig. 54 Network writer component
The network writer component listens on a network port and sends any packets it receives to all clients
that connect to this port. This is useful for transmitting data from the data grabber to other
applications, such as the Horus Movie Recorder (which can be used to view live streams of the images
being captured) or other instances of the data grabber running on other machines (see section 6.18 for
information on the Network reader component). The network writer has one or more inputs and no
outputs.
6.19.1 Network writer properties
PROPERTY
DESCRIPTION
Name
Protocol
The name of the component.
The protocol used for transmission. Valid values are “TCP” and “UDP”. TCP is a
good default.
The host the component will listen on for connections. When left empty, the
component will listen on all interfaces. Note that you should use an IP address
instead of a textual host name as the latter may not work.
The port the component will listen on for connections. When left empty, the
data grabber will use a random free port.
The behavior used when transmitting packets. Valid values are:
Publish/subscribe (fast): all incoming packets will be transmitted to the
network. Publish/subscribe (sleep): transmits one packet every X seconds. The
interval is specified using the “Sleep” property. In case of multiple input
streams, the component picks a different stream to send the last packet of
whenever the interval passes, so that data from all streams is transmitted.
Request/reply: currently under development. Should not be used.
The sleep interval in milliseconds. Should be used together with the
“Publish/subscribe (sleep)” protocol. Refer to the “Behavior” property for more
information.
Host
Port
Behavior
Sleep
User manual Horus Recorder Builder
33
7
Creating a new pipeline
To start building a new pipeline, click the New button in the toolbar. A blank build field is created:
Fig. 55- New pipeline button
7.1
Adding components
You can select the components (Devices, grabbers, components) in the Component panels on the left.
These can be dragged and dropped to the Build screen by left clicking. Select the components you want
to use for the pipeline and place them in the build screen:
Fig. 56- Components dropped in the build screen
7.1.1
Linking components
When the mouse pointer is placed on a component, four connecting boxes will appear:
Fig. 57- Connecting boxes
By left clicking on one of the connecting boxes you can start drawing a line that connects this
component to another. When the line reaches the connecting box of another component, one of the
connecting boxes turns green. This indicates that a connection can be made. By releasing the left
mouse button, the connection is made:
Fig. 58- Linked components
User manual Horus Recorder Builder
34
You can proceed by linking the selected components to another until the pipeline is complete. The
Horus Recorder Builder monitors the connections that are made. When you try to make a connection
that is not possible, the Horus Recorder Builder will refuse to connect. This is indicated by a red
connecting box and the Not allowed sign:
Fig. 59- Connection not possible
7.1.2
Removing components
To delete a component from the build screen, select the component and press the Delete button
7.2
Component properties
When all necessary connections are made, you can set the properties of the components in the
Component panels.
Select a component in the Build screen, the properties of that component are shown in the Properties
box:
Fig. 60- Properties settings
The name of the component is displayed in the upper field (1). The contents of a fill in field (2) can be
changed by entering / typing the desired name in this field. With the pull down menus (3) you can select
pre-defined settings. The info field (4) provides additional information for the selected field.
User manual Horus Recorder Builder
35
7.3
Opening an existing pipeline
To open an existing pipeline, click the Load button:
Fig. 61- Load button
Select the directory in which the .hrp file (Horus Recorder Pipeline) is stored and click Open:
Fig. 62- Select a directory and a.hrp file
The pipeline will be opened in the Build screen and can now be redesigned to your preferences. The
properties of the components in the pipeline can also be adjusted. When you are finished adjusting the
pipeline, you can save the pipeline with the Save button:
Fig. 63- Save button
If desired the file can be renamed in the Save as screen.
7.4
Send a pipeline
The pipeline that is built in the Build screen can be sent to the Data Grabber so it can be used instantly.
To do so, click the Send pipeline button
Fig. 64- Send pipeline button
7.4.1
Run / Stop a pipeline
To run or stop a sent pipeline, click the Run or Stop buttons in the toolbar:
Fig. 65- Run / Stop buttons
User manual Horus Recorder Builder
36
8
Generating a camera configuration
The Horus Recorder Builder can automatically generate a camera configuration and create a .hsf
(Horus Setup File). To do this, it is necessary that a camera is connected and that the related camera
drivers are installed on your computer.
To create a camera setup, click the Generate camera configuration button:
Fig. 66- Generate camera config
button
The Horus Recorder Builder will then open the Generate HSF screen in which you can select camera
for which you want to create a setup / configuration:
Fig. 67- Generate HSF screen
Select the camera(s) you want to use by marking the checkboxes and click Generate. The Horus
Recorder Builder will ask where you want to store the .hsf file. Select a directory and specify the file
name:
Fig. 68- Specify the filename and select a directory for the
.hsf file
Click Save to save the created .hsf file.
User manual Horus Recorder Builder
37
9
Index
Adding components ......................................... 34
Allied vision grabber ........................................ 11
Allied Vision grabber properties ..................... 11
Arduino grabber............................................... 10
Audio grabber .................................................. 10
Basler grabber................................................. 12
Component properties .................................8, 35
Components screen .......................................... 8
Connection not possible .................................. 35
Console Writer ................................................. 27
Console writer properties ............................... 27
Create camera config ...................................... 37
CSV Nmea grabber .......................................... 19
Delay ................................................................ 24
Description Recorder Builder ........................... 7
Direct Show Audio ........................................... 29
Disk cleaner ..................................................... 24
Disk cleaner properties ................................... 25
Expand / collapse group .................................... 8
File writer ......................................................... 25
Filter ................................................................. 26
Filter properties ............................................... 26
FlyCapture Grabber ......................................... 12
Game Pad grabber .......................................... 13
Grabbers
description ................................................... 10
properties .................................................... 10
HTTP Grabber .................................................. 14
HTTP Grabber properties ................................ 14
Image converter .............................................. 28
Image decoder ................................................. 27
Image decoder properties ............................... 27
Image encoder ................................................. 28
Image encoder properties ............................... 28
IMU grabber ..................................................... 15
IMU grabber properties ................................... 15
Introductive Security Suite ................................ 5
Ladybug grabber.............................................. 15
Ladybug grabber properties ........................... 15
Libjpeg Turbo ................................................... 30
LibJpeg Turbo properties ................................ 31
User manual Horus Recorder Builder
Linking components ........................................ 34
Media foundation grabber ............................... 16
Media foundation grabber properties ............. 16
Microflown grabber ......................................... 13
Microflown grabber properties ....................... 13
NamedMemory sink ........................................ 29
Network reader ................................................ 32
Network reader properties .............................. 32
Network writer ................................................. 33
New pipeline..................................................... 34
NMEA grabber ................................................. 16
NMEA grabber properties ............................... 17
Nmea Reader ................................................... 30
Nmea Writer..................................................... 30
Opening existing pipeline ................................ 36
PTZ grabber ..................................................... 18
Recording location ........................................... 23
Recording location properties ......................... 23
Removing components .................................... 35
RTSP grabber ................................................... 18
Run / Stop pipeline........................................... 36
Screen elements ................................................ 7
Send pipeline .................................................... 36
Serial sensor grabber ...................................... 20
Sony SNC grabber............................................ 20
Sony SNC grabber properties ......................... 20
Sony ZCL grabber ............................................ 21
Sony ZCL grabber properties .......................... 21
Starting the Recorder Builder ........................... 6
System status grabber .................................... 21
System status grabber properties .................. 21
Toolbar buttons .................................................. 7
Transforms Orientation ................................... 31
Transforms Quaternion Euler ......................... 32
Trigger grabber ................................................ 22
Trigger grabber properties .............................. 22
Trigger on event ............................................... 26
Trigger on event properties ............................. 26
Ublox grabber .................................................. 17
Ximea grabber .................................................. 22
38
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertisement