WheelsBridge TiVi701 User manual

TiVi701 Camera Manual
TiVi701Camera ver1.5 Page 1
W
WW
W
W
WW
W
h
hh
h
h
hh
h
eels
eelseels
eels
eels
eelseels
eels
B
BB
B
B
BB
B
ridge
ridge ridge
ridge
ridge
ridge ridge
ridge
W
WW
W
W
WW
W
h
hh
h
h
hh
h
eels
eelseels
eels
eels
eelseels
eels
B
BB
B
B
BB
B
ridge
ridge ridge
ridge
ridge
ridge ridge
ridge
W
WW
W
W
WW
W
h
hh
h
h
hh
h
eels
eelseels
eels
eels
eelseels
eels
B
BB
B
B
BB
B
ridge
ridge ridge
ridge
ridge
ridge ridge
ridge
W
WW
W
W
WW
W
h
hh
h
h
hh
h
eels
eelseels
eels
eels
eelseels
eels
B
BB
B
B
BB
B
ridge
ridge ridge
ridge
ridge
ridge ridge
ridge
TiVi701 Camera Manual
User Manual 1.6
February 2019
TISSUE VIABILITY IMAGER

TiVi701 Camera Manual
TiVi701Camera ver1.5 Page 2
Information in this document is subject to change without notice and does not represent a
commitment on the part of WheelsBridge AB. No part of this manual may be reproduced or
transmitted in any form or by any means, electronically or mechanically, including
photocopying and recording, for any purpose without the express written permission of
WheelsBridge AB.
Any use or application of WheelsBridge AB products must be performed by properly trained
and qualified personnel. WheelsBridge AB takes no responsibility for action taken on the
basis of information derived from the use of the product described in this manual or from
consequential damages in connection with the furnishing, performance or use of this material.
Licensee’s limited rights are governed by the license agreement between WheelsBridge AB
and MathWorks. Licensee may not modify or remove any license agreement file
(MarthWorks or third party) that is included with the MCR Libraries (“MCR Library
License”). Licensee of this Application accepts the terms of the MCR Library License.
The TiVi700 Tissue Viability Imager is patented and/or patents are pending in several
countries.
The TiVi700 Tissue Viability Imager is not registered as a Medical Device. It is intended for
research applications only.
WheelsBridge is a registered trade mark.

TiVi701 Camera Manual
TiVi701Camera ver1.5 Page 3
CONTENT
Part I Setting up the camera
Part II Camera controls setting
Part III Attaching the Illuminator
Part IV Selecting co – or cross-polarization
Part V Battery operation
Part VI Capturing photos
Part VII The TiVi 01 Camera software
Part VIII The Positioner
Part IX Live View and TiVi Video
Part X Software Installation Procedure
Part XI Working with two cameras (optional)
Part XII Calibrating the length scale in mm
Part XII Using a Reference photo for alignment

TiVi701 Camera Manual
TiVi701Camera ver1.5 Page 4
Part I Setting up the camera
1. Fix the swivel end-plate to the camera.
2. Insert the battery eliminator connector (open the door at the bottom of the camera
housing).
3. Attach the camera to the swivel.
Part II Camera controls setting
1. Set the camera wheel to the “Av” position.
2. Set the Auto-Focus control to AF and the Stabilizer control to ON.

TiVi701 Camera Manual
TiVi701Camera ver1.5 Page 5
3. Set the Zoom-in by manually rotating the lens.
Part III Attaching the Illuminator
1. Screw on the Illuminator to the camera lens (fine thread).
2. Connect Illuminator power adapter to the Illuminator.

TiVi701 Camera Manual
TiVi701Camera ver1.5 Page 6
3. Connect the power adapter to the mains supply.
4. Switch on the Illuminator. 96 light emitting diodes illuminate the object.
Part IV Selecting co – or cross-polarization
1. The Illuminator is switched between the co- and cross-polarized mode by turning the
Illuminator 90 degrees. When the red lock is next to the metal-coloured magnet, the
Illuminator is in cross-polarized mode. When the black lock is next to the magnet, the
Illuminator is in co-polarized mode. The Illuminator can be locked in position by
turning the red or the black lock.
Part V Battery operation
1. Both the camera and the Illuminator can be operated in battery mode.
2. After charging the camera battery, remove the battery eliminator connector from the
camera housing and insert the battery.

TiVi701 Camera Manual
TiVi701Camera ver1.5 Page 7
3. After charging the Illuminator battery, replace the battery-illuminator connector with
the battery cable connector. When not in use switch off the Illuminator by use of the
switch on the battery eliminator cable.
Part VI Capturing photos
To capture good quality photos always
1. Switch off the ambient light in the room.
2. Place the object on a green coloured background.
To prepare the camera for capturing photos remotely and disconnected from the computer,
disconnect the camera from the computer and set the Camera Dial to “Av”. Click the Menu
button until the information page becomes visible on the camera display (the text “Av”
should be visible in the top left corner of the display). Click the “WB” button on the camera
several times until the “Shade” symbol appear marked. Then click the SET button. The white
balance is now set to “Shade”.

TiVi701 Camera Manual
TiVi701Camera ver1.5 Page 8
Part VII The TiVi 01 Camera software
The camera must be connected to the computer before the TiVi701 Camera software is
started because the unique serial number of the camera is verified in the TiVi701
Camera software startup phase.
1. Start the TiVi701 Camera software from inside the TiVi700 Analyzer window
(File  Camera) or directly from Windows 7 Start (WheelsBridge  TiVi700 1.1
Tissue Viability Imager  Launch TiVi701Camera.exe).
2. Menu Panel
a. Shutter – to set the Av-value (shutter aperture) in steps of 5.6, 8.0, 10 or 20).
A low Av-value corresponds to a large shutter aperture. If a low Av-value is
selected, the focal depth becomes shallow while the shutter opening time
becomes short. A low Av-value is to be selected if the shutter opening time
must be short (as is the case when capturing photos of moving objects and
large magnification) to avoid blurring of the photo due to movement artifacts.
A large Av-value is to be selected if a large focal depth is needed (at for
instance investigation of sweat drop activity using the camera adapter macro
lens system).
b. Size Reduction – this pull-down menu contains three items ( No Size
Reduction , Minor Size Reduction (default), Major Size Reduction ). In No
Size Reduction the entire photo is utilized. In Minor Size Reduction (default)
the 10% of the photo closest to the borders is cut off. In Major Size
Reduction the 20% of the photo closest to the borders is cut off. Utilizing Size
Reduction eliminates possible shadow effects along the borders of the photo
caused by the limited field of view illumination by Camera Illuminator, which

TiVi701 Camera Manual
TiVi701Camera ver1.5 Page 9
may cause image distortion. This is achieved at the expense of a more
extensive image field view. The optimal distance between the camera head and
the object is about 10 - 30 cm or more. It is generally better to increase the
number of pixels in the images ( Photo Size ), increase the camera-object
distance and use Minor or Major Size Reduction to obtain a specific image
resolution than to work with a lower number of pixels and use No Size
Reduction .
c. Camera Supported – displays a window with the serial numbers of the
cameras supported. The camera serial number can be found on the camera
label.
d. Download Photos – to download photos from camera memory to file. If
photos are capture with the camera disconnected from the computer the photos
must be downloaded by clicking the Download Photos button and selecting a
folder into which the photos are to be saved, otherwise the photos will not be
tagged as TiVi-photos and cannot be analyzed by the TiVi700 Analyzer .
e. Register – to register the camera zoom-setting, polarization mode and distance
to object.
i. Register Zoom Settings – This feature is used to register the zoom
setting. Check one of the alternatives (18, 24, 35 or 55) and manually
adjust the zoom-lens accordingly. This information is saved as meta-
data with the photo and displayed in the TiVi701 Camera window
when the Reference Photo is uploaded or in the TiVi700 Analyzer
window when the photo is uploaded as the Actual Photo.
Rotate the zoom lens to adjust the Zoom. The actual setting
corresponds to the number next to the white bar on the camera housing.
ii. Register Polarization Mode – This feature is used to register the
setting of the polarization filter in front of the lens system by clicking
either the CR or CO radio-button. The CR-setting (crossed polarized)
is used for the investigation of sub-surface features such as RBC
concentration. Manually turning the Illuminator filter 90 degrees, sets
the camera system to co-polarization mode, i.e. the polarization planes

TiVi701 Camera Manual
TiVi701Camera ver1.5 Page 10
of the filter in front of the Illuminator LEDs and the lens system are in
parallel. This setting is used for the investigation of direct surface
reflections. CR and CO information is saved as meta-data with the
photo and displayed in the TiVi701 Camera window when the
Reference Photo is uploaded or in the TiVi700 Analyzer window
when the photo is uploaded as the Actual Photo.
iii. Register Distance – This feature is used to register the distance from
the edge of the Illuminator to the object. Measure the camera – object
distance manually and insert the distance (in mm) in the edit box. The
distance value is saved as meta-data with the photo and is retrieved and
displayed when the photo is uploaded as a Reference Photo (in the
TiVi701 Camera window) or as the Actual Photo in the TiVi700
Analyzer window . This information can later be used to adjust the
camera – object distance.
f. Calibrate – to calibrate the length-scale in mm (see Part XI).
g. Language – to select Language.
h. Manual – displays the on-line TiVi701Camera manual.
i. About – to display the About window.
j. Background Paper – select this option to display and print out a suitable
background paper for the object to be investigated. The green colour of the
background paper implies that it will automatically be classified as
“background” by the TiVi-system (negative TiVi-values). The raster pattern of
the background papers makes it possible for the camera to automatically focus
without any object placed on the background paper. If the camera is aimed to
capture a picture from a uniformly coloured object or object background, the
auto-focus feature may not work and the camera can go into a “freeze” mode
locking the software from further operation. If this happens the camera can be
released from the “freeze” mode by setting the switch on the camera housing to
OFF and then back to ON (restarting the camera).
k. Demo Assistant – interactive Demo Assistant to display how to capture photos
and use the Live View.
l. ToolTips – displays (ON) or hides (OFF) tooltips associated with the different
controls.
3. Photo / Image information
a. Size – shows the size of the photo displayed.
b. Registration – displays the value of the registered parameters.
c. Number – display the number of the photo displayed in a sequence of photos.

TiVi701 Camera Manual
TiVi701Camera ver1.5 Page 11
d. Size Reduction – displays the size reduction used.
e. Name – name of the photo just captured.
4. Controls panel
a. Test Photo – displays test photos successively with the actual camera
parameters set until the Abort button is clicked. If a Reference Photo is
loaded a new window – the Positioner – is opened (see below). If the camera
cannot focus, because the object contrast is too low, an error message is
displayed and the testing process is interrupted. Rearrange the object to
increase contrast and try again.
b. Live View – opens the Live View window (see below).
c. Align – opens the Align window (see below).
d. Capture Photos – captures a sequence of photos in accordance with the
camera parameters set and displays the result in the Photo and Image panels.
If the camera cannot focus, because the object contrast is too low, an error
message is displayed and the capturing process is interrupted. Rearrange the
object to increase contrast and try again.
e. Abort – interrupts a photo capturing procedure.
f. Reset – resets the system parameters.
g. Analyzer – opens the TiVi700 Analyzer software.
h. Monitor ON/OFF – to open or hide the monitor.
i. Close – closes the Camera Settings window.
5. Load Settings – allows the user to load a file with user-determined camera parameter
default values. The actual file name is displayed in the associated text box. At start-up
the default values stored in the DefaultCam701 file are loaded.
6. Save Settings – allows the user to store the actual camera parameter settings on file.
The actual file name is displayed in the corresponding text box. If new parameter
settings are to be evoked at the start up, store these parameters under the file name
“DefaultCam701”.
7. Save Photos – allows the user to select the folder and file name of the sequence of
photos to be saved. If this edit box is left empty, the actual photo sequence is
automatically stored under the name ‘Data_xxx’ in the DataDirectory. If the photos
are stored under another prefix name and this already exists, the new photo will still be

TiVi701 Camera Manual
TiVi701Camera ver1.5 Page 12
stored under this prefix name but under the next number in the same sequence of
photos.
8. Load Ref Photo – loads a reference photo to be used in the alignment process (see
below).
9. Select Photo Size pull-down menu – to select the size and quality of the photo(s) to be
captured. Small photos are easier and quicker to analyze while larger photos allows for
zoom-in without loss of resolution.
10. No of Photos – insert the number of photos to be recorded in the associated text box
and press Enter .
11. Delay (sec) – insert the delay time in seconds between the capture of two successive
photos.
12. Pause – allows for halting photo capturing. The Pause -button is now labeled
Continue . When the button is clicked again, the photo capturing process is resumed.
13. Comments – Opens a word pad into which comments about the image capturing
process can be inserted. This word pad is linked to the photo as meta-data and can be
opened and edited in the TiVi700 Analyzer . All comments entered into the word pad
at capturing time will be added to all photos of the sequence.
When the Monitor button is clicked the monitor function opens. The monitor is used for
following changes in TiVi-values within regions of interest (ROIs) during the capturing
procedure.
1. First capture a test photo by clicking the Test Photo button.
2. Click the Abort button to stop the capturing of test photos.
3. Draw the ROIs in the photo (ROIs can be moved, removed or reshaped – for further
details on ROI operations please see the TiVi700 Analyzer manual.

TiVi701 Camera Manual
TiVi701Camera ver1.5 Page 13
4. When all ROIs have been set to the correct positions, click the Capture Photos
button to start the photo capturing process.
5. As the photos are successively captured, the curves corresponding to the TiVi values
within the ROIs are drawn in the monitor diagram.
Part VIII The Positioner
When capturing photos belonging to the same sequence at different points in time, it is
essential that the distance between the camera and the object and the view angle under which
the object is seen from the camera are kept as identical as possible (especially if the integrated
Wizards are to be used in the image analysis). By using the first photo in a sequence as the
Reference Photo on the basis of which camera-object positioning is made before the
successive photos in the sequence are captured, the analysis can readily be made using the
integrated Wizards with possible assistance of the Pre-Processor features for further
alignment of the photos as necessary. Proceed as follows:
1. With the TiVi700 Camera window open, click the Save Photos button and name and
store the first photo in the sequence.
2. Click the Capture Photo button to capture and store the first photo in the sequence.
3. When the second and the successive photos in the sequence are to be captured, again
open the TiVi700 Camera window.
4. Load the saved Reference Photo by clicking the Load Ref Photo button after having
navigated to the folder in which the Reference Photo was saved.

TiVi701 Camera Manual
TiVi701Camera ver1.5 Page 14
5. The Reference Photo is now displayed in the Photo panel in the TiVi700 Camera
window. At the same time the prefix is automatically set in the Save Photo edit box
and the actual photo size to the size of the Reference Photo .
6. Set the Number of Photos to be captured and saved.
7. Click the Test Photo button. A new window – the Positioner – is now opened.
8. The Reference Photo is displayed in black and white.
9. Capture a new Test Photo by clicking the Test Photo button. This photo will now be
superimposed on the Reference photo and displayed in the Positioner window.
10. Drag the Blend slider to the right so the Reference Photo appears sharper.
11. To adjust for any alteration in camera – objective distance, the distance between two
selected landmarks in the Reference Photo and new Test Photo is to be compared
and a compensation adjustment of the camera –object distance calculated and
displayed.
12. As the first landmark the tip of the third finger may be used. Move the mouse pointer
to this position and click the left mouse button. A red cross-marker now appears at this
point.

TiVi701 Camera Manual
TiVi701Camera ver1.5 Page 15
13. As the second landmark the base of the third finger may be used. Move the mouse
pointer to this position and click the left mouse button. A red cross-marker now
appears at this point and a red line is drawn between the two landmarks .
14. Drag the Blend slider to the left so the Actual Photo appears sharper.

TiVi701 Camera Manual
TiVi701Camera ver1.5 Page 16
15. As the first landmark the tip of the third in the Actual Photo is to be used. Move the
mouse pointer to this position and click the left mouse button. A blue cross-marker
now appears at this point.
16. As the second landmark the base of the third finger is to be used. Move the mouse
pointer to this position and click the left mouse button. A blue cross-marker now
appears at this point and a blue line is drawn between the two landmarks. If the
camera-object distance is registered, the necessary adjustment of this distance (in mm)
is displayed in the photo. If no camera-object distance is registered, the necessary
adjustment of the distance is given in relative terms.

TiVi701 Camera Manual
TiVi701Camera ver1.5 Page 17
17. The relation between the lengths of the two lines is now automatically calculated and
the suggested action (in this particular case: Reduce Distance by 88 mm) is displayed.
18. Repeat the procedure from step 10 if necessary.
19. Adjust the camera – object distance and view angle to approximately the same as
those which were used when the Reference Photo was captured.
20. Click the Test Photo button to capture a new test photo. This photo will now be
superimposed on the Reference photo and displayed in the Positioner window.

TiVi701 Camera Manual
TiVi701Camera ver1.5 Page 18
21. The photo can be rotated by clicking the Rotate button (each step represents a 90
degree rotation).
22. The degree of blending in the Reference Photo over the Test Photo can be adjusted
by moving the Blend slider. In its leftmost position only the Test Photo is displayed.
In its rightmost position only the Reference Photo is displayed. In its neutral central
position the Reference Photo and the Test Photo are blended in to the same extent.

TiVi701 Camera Manual
TiVi701Camera ver1.5 Page 19
23. Readjust the lateral camera-object position by guidance of the displayed photo to
reach a better overlap. Again capture a Test Photo to display the result.
24. When the overlap is considered acceptable click the Capture button to start capturing
new Photos which are saved under the same prefix as the Reference Photo and
displayed in the TiVi main window.
25. If no Photos are to be captured and saved, click the Close button to close the
Positioner window.

TiVi701 Camera Manual
TiVi701Camera ver1.5 Page 20
Part IX Live View and TiVi Video
The Live View and TiVi video can be used for:
• Correctly positioning the object in the field of view.
• Visualizing the microcirculation maps at video rate.
• Recording and saving videos at a high resolution and frame rate.
1. Correctly positioning the object in the field of view.
a) Open TiVi Video window by clicking the Live View button in the TiVi701Camera
window.
b) Click the Start Button to start the visualization process.
c) Click the Video radio-button to display the moving object in video-mode.
d) Move the object (or the camera) to the correct position.
e) Click the Stop button.
f) Start capturing photos from the TiVi701Camera window.
2. Visualizing the microcirculation maps at video rate.
a) Open TiVi Video window by clicking the Live View button in the TiVi701Camera
window.