Canon network camera VBC50Fi User Manual

							
Creating Web  Pages
5-19
Using the Viewer for Java to Distribute Videos
Specifies whether or not connection to the camera server should be 
established simultaneously with applet startup. Specify either “on”\
 or “off”. 
When “on”, a connection is established simultaneously with applet \
startup; 
when “off”, no connection is established when the applet starts up\
 and the 
character string specified for no_connect_msg is displayed. The connect(\
) 
method is called up in order to make connections.
Ye sauto_connect
Specifies the size of the image when Glimpse is started. There are 4 siz\
es: 80 
× 60, 160  × 120, 320  × 240 and 640  × 480 for NTSC, and 96  × 72, 192  × 144, 
384  × 288 and 768  × 576 for PAL. The default is the specified size in the Video 
Transmission of the Camera and Video Setting Page ( → P.3-8). capture_size 
is unrelated to the size of the image displayed on the monitor of your P\
C. To 
change the size of the image on the monitor, specify with width and heig\
ht of 
the applet tag.
Ye scapture_size
This parameter specifies the comment text string displayed as an overlay\
 on 
the applet. If this parameter is omitted, no comment is displayed.Ye scomment
Specifies the character string to be displayed while a connection to the\
 camera 
server is being established. The default is “now connecting”.Ye sconnect_msg
Specifies the character string to be displayed when a connection to the \
camera 
server is disconnected. The default is “disconnected”.Ye sdisconnect_msg
Specifies the character string to be displayed when an attempt to connec\
t to 
the camera server has failed. The default is “can’t connect”.Ye serror_msg
Specifies the font size for connect_msg, disconnect_msg, error_msg, and \
no_connect_msg, when these messages are displayed. The default is to 
depend on the display area.Ye sf ont_size
This parameter specifies the host name displayed in the applet. This val\
ue is 
used as the host name in messages displayed during connection, etc. If t\
his 
parameter is omitted, no host name is displayed.Ye shostname
Specifies the character string to be displayed after the applet starts u\
p, if “off” is 
specified for auto_connect. The default is “no connection”.Ye sno_connect_msg
This function displays the frame count as an overlay on the video image.\
 
Specify “on” or “off”. The default value is “off”.Ye sshow_counter
This function displays the host name as an overlay on the video image. S\
pecify 
“on” or “off”. The default value is “off”. Note that t\
his parameter is only valid if 
the “hostname” parameter is specified.Ye sshow_hostname
This parameter specifies the interval (in milliseconds) at which the s\
creen is 
updated. If this parameter is omitted, the screen is updated at 5-second\
 
intervals. Because the Glimpse applet is designed to be used for display\
ing 
multiple sites as a list, this parameter is provided as a means of reduc\
ing the 
processing load. Intervals between 0 and 80,000 ms can be set. If 0 is 
specified, the interval is not adjusted.
Ye ssleep
Specify the URL of the HTTP server for applet access. Specify the IP add\
ress 
and port number that match those specified in the codebase attribute.Nourl
DescriptionOmissibleP arameter Name
Glimpse
C
O
P
Y  
						

							
5-20
Using the Viewer for Java to Distribute Videos
Tip
When specifying an address included in the codebase attribute of the app\
let tag and
a URL parameter of the LiveApplet, specify one that can be accessed from\
 the client’s
PC. This is particular necessary when using NAT (→ P.5-26).
Specify LiveApplet.zip or Glimpse.zip.Ye sarchive
This parameter specifies the applet file name. Enter “LiveApplet.clas\
s” or 
“Glimpse.class”. If this parameter is not specified correctly, the\
 applet 
(LiveApplet or Glimpse) is not downloaded.Nocode
This parameter specifies the directory that contains the applet. 
http://HTTP server IP address: port number/directory/
If this parameter is not specified correctly, the applet (LiveApplet or\
 Glimpse) is 
not downloaded. 
Directories are fixed for each applet.
Directory (LiveApplet)=-wvdoc-01-/LiveApplet
Directory (Glimpse)=-wvdoc-01-/Glimpse
Nocodebase
This parameter specifies the size of the area acquired for the applet (\
in pixels).
For LiveApplet, if the value specified is smaller than the LiveApplet dr\
awing 
area, the applet may not be displayed correctly. If the camera control f\
unction 
GUI is to be added (controller_style=normal), add about 140 to the val\
ue. E.G. 
For an image size of 320  × 240, height=380.
For Glimpse, because the areas used for the applet and for the video dis\
play 
are the same size, specify the same value as the image height. E.G. For \
an 
image size of 320  × 240, height=240.
Noheight
This parameter specifies the size of the area acquired for the applet (\
in pixels).
For LiveApplet, if the value specified is smaller than the LiveApplet dr\
awing 
area, the applet may not be displayed correctly. If the camera control f\
unction 
GUI is to be added (controller_style=normal), add about 130 to the val\
ue. E.G. 
For an image size of 320  × 240, width=450.
For Glimpse, because the areas used for the applet and for the video dis\
play 
are the same size, specify the same value as the image width. E.G. For a\
n 
image size of 320  × 240, width=320.
Nowidth
DescriptionOmissibleAttribute Name
Applet Tag Descriptions
C
O
P
Y  
						

							
Creating Web  Pages
5-21
This section describes how to use the Viewer for PC to provide videos. A\
pplication examples are
also given.
If a client is using the Viewer for PC to receive videos, the video send\
er must set up the Web
server and create the necessary wvh files.MIME type video/x-webview-h
Extension wvh
For Apache
In the settings for added the MIME type in Apache, edit the “mime.typ\
es” file in the “conf”
directory.
● Use the following syntax to add the required MIME type to the PC:
type/subtype extension
●  The settings for Viewer are as follows:
video/x-webview-h wvh
Using the Viewer for PC to Distribute Videos
Note
If the MIME setting is not specified correctly for the Web server, you m\
ay not be able
to launch the Viewer for PC. Be sure to specify the setting correctly.
Tip
● The settings below are not required if the VB-C50FSi/VB-C50Fi’s built\
-in Web server
is used.
● See page 5-8 for saving Web page data.
Setting Up the Web Server
Set up the Web server to be used for providing Web pages. Add the MIME t\
ype to the Web server
software and specify the extension. Refer to the manual for your Web ser\
ver software for details.
C
O
P
Y  
						

							
5-22
Tip
Instead of an IP address, you can also type in  (→ P.5-9).
Example:  65310  65311
wvhttp: 80
wvaudio:  80 (Only available with a particular model
of the VB-C50FSi)
Using the Viewer for PC to Distribute Videos
1. Use a text editor or similar program to create a new text file and type \
thefollowing type of code in the file:
(Example)
192.168.100.1 65310
192.168.100.1 65311
wvhttp:
192.168.100.1 80
wvaudio:
192.168.100.1 80 (Only available with a particular model
of the VB-C50FSi)
* The underlined portion is a sample IP address. Enter the actual IP addre\
ss that was set on the VB-
C50FSi/VB-C50Fi ( → P.3-6).
●The first line gives the IP address (or host name) of the VB-C50FSi/VB\
-C50Fi and the TCP
port number used for the video transmission. The default setting is 6531\
0 ( → P.3-17). The
default setting will be used if no particular value is specified.
● The second line gives the IP address (or host name) of the VB-C50FSi/V\
B-C50Fi and the
TCP port number used for the camera control. The default setting is 6531\
1 ( → P.3-17). The
default setting will be used if no particular value is specified.
● The third line gives the setting for the Viewer for PC to use HTTP proto\
col. After “wvhttp:”,
type in the IP address of the VB-C50FSi/VB-C50Fi and “80” as the H\
TTP port number. As a
result of this, you will be able to view video from the VB-C50FSi/VB-C50\
Fi through firewalls.
● The fourth line is settings to listen to audio on the PC viewer. After “\
wvhttp:”, type in the IP
address of the VB-C50FSi and “80” as the HTTP port number. As a re\
sult of this, you can
receive audio from the VB-C50FSi. To receive audio, you need to set “\
Audio Transmission”
to “Used” in the Audio Server settings ( → P.3-18).*
* 
Only available with a particular model ( → P.iii)
2. After you save the text file and quit the text editor program, create a \
wvh file
by changing the file name and extension.
Be sure to add the “.wvh” extension, as in “WebView.wvh”.
Creating wvh Files
This section describes how to create the wvh file required for launching\
 the Viewer for PC
application.
C
O
P
Y  
						

							
Creating Web  Pages
5-23
Using the Viewer for PC to Distribute Videos
Include the tags that link to the wvh file in the text or images in the \
Web page.
1Lets view the image
1Click the link to launch the Viewer.
Example of a Web page Using the Viewer for PC
This section describes a sample Web page in which the Viewer for PC is u\
sed.
Tip
To use the sample page template in the VB-C50FSi/VB-C50Fi to supply vide\
os, specify
.
Tip
Viewer for PC supports WebView Livescope protocol and HTTP protocol.
●WebView Livescope protocol:
Cannot be viewed through firewalls. This protocol is primarily for clien\
ts who are
connected directly to the Internet.
● HTTP protocol:
In general, this protocol is used with Web browsers. By using this proto\
col, clients
inside firewalls can view video by penetrating fire walls. The Viewer fo\
r Java also
uses this protocol.
C
O
P
Y  
						

							
5-24
Distributing Videos Using a Browser Only
You can also use the WebView-HTTP protocol to provide videos from the VB\
-C50FSi/VB-C50Fi directly
to a Web browser. Some example of this are described in this section.

  (or)

* The underlined portion is a sample IP address. Enter the actual IP add\
ress set for the VB-C50FSi/VB-C50Fi (→  P.3-6).
Tip
Setting frame_count=no_limit removes the limits on the number of image f\
rames.

* The underlined portion is a sample IP address. Enter the actual IP add\
ress set for the VB-C50FSi/VB-C50Fi
(→  P.3-6).
Displaying the Live Video at Access as a Still Picture
When a client accesses the Web page that provides
videos, the video shot at that point can be supplied as
a still picture.
Displaying a Specified Number Of Live Video Frames As a Video at Access
The Server Push format provided as an extended
function by Netscape Communications Corp. can be
used to distribute multiple-frame images. However,
these images can only be displayed on Netscape
Navigator. In the coding example below, 100 frames
of live video are distributed when the client accesses
the server.
C
O
P
Y  
						

							
Creating Web  Pages
5-25
GetStillImage Parameters
Parameter Description
z or  zoom Specifies camera zoom. “z” is ten times the zoom ratio of the wide\
st angle, and
“zoom” is the view angle in 0.01
° units (horizontal direction). If this parameter is
omitted, camera zoom is not controlled.
b  or  back_light Specifies camera backlight compensation. When this parameter is set to o\
n, the
picture captured will be bright and when this parameter is set to off, t\
he picture
captured will be dark. If this parameter is omitted, camera backlight co\
mpensation
is not controlled.
delay
Waiting time until camera focus is stabilized (in milliseconds).
Specified in the range 0 to 10000.
optionSpecifies how errors are dealt with. When “skip_on_error” is speci\
fied, the process
will be continued. When “quit_on_error” is specified, the process \
will be aborted.
The following errors can occur: failure to acquire camera control right,\
 loss of
camera control, camera selection errors and camera control errors. To om\
it, the
default value is “quit_on_error”.
seq
Allows any number (sequence number) to be specified to avoid displayin\
g old
still pictures (numeric value).
v
 or  image_size
Specifies picture display size. This can be set to 160  × 120, 320  × 240, and 640
×  480 for NTSC, and 192  × 144, 384  × 288, and 768  × 576 for PAL. The formats
for specifying “v” and “image_size” are different: “v”\
 specifies the horizontal
dimension only and uses the format “v=640”, for instance, while “\
image_size”
specifies both horizontal and vertical dimensions and uses the format
“image_size=320  × 240”, for instance.
Distributing Videos Using a Browser Only
Note
If old still pictures are displayed, you can prevent this recurring by s\
pecifying a
sequence number in the seq parameter.

* The underlined portion is a sample IP address. Enter the actual IP add\
ress set for the VB-C50FSi/VB-C50Fi
(→  P.3-6).
Displaying Live Video from a Specified Zoom Magnification as Still Pictu\
res
By specifying the camera zoom magnification as a parameter in the HTML c\
ode beforehand, you
can display the picture from a specified camera zoom magnification. The \
example below displays
a still picture shot with the camera zoom at 10x.
C
O
P
Y  
						

							
5-26
NoteContact respective manufacturers for details on setting the router.
One fixed global address is required if the VB-C50FSi/VB-C50Fi is being \
used to distribute live
videos on the Internet. An Internet service provider (ISP) that offers\
 a single-address fixed global
address service can be used. In this case, a router with NAT function is\
 required.
Example: In this example, we use the global address 192.168.1.10 assigned by the \
ISP. We also set
the local address 192.168.100.2 in the VB-C50FSi/VB-C50Fi (and 192.168.\
100.1 for the router).
Example of Video Distribution Using One Global Address
A sample page of the VB-C50FSi/VB-C50Fi is automatically generated based\
 on the IP address that
was actually assigned (192.168.100.2 in this case). In this case, this\
 page cannot be viewed in the
Viewer for Java or the Viewer for PC when “http://192.168.100.2/sampl\
e/” is accessed through the
Internet.
Set “Global Address for Web Pages” ( → P.3-16) to 192.168.1.10. If you are not using the
VB-C50FSi/VB-C50Fi’s Web server, describe the Web pages for distribut\
ing videos as follows:
Set the Viewer for Java description  (→  P.5-7) as follows:

 
 
 
 
Set the wvh file description of the Viewer for PC  (→  P.5-22) as follows:
192.168.1.10  65310
192.168.1.10  65311
wvhttp: 
192.168.1.10  80
wvaudio: 
192.168.1.10  80 (Only available with a particular model of the VB-C50F\
Si)
* The underlined portion is a sample IP address. Enter the actual IP add\
ress set for the Global Address for Web Pages ( → P.3-16).
Internet
Router
Viewer PC
Web 
server
Global address
192.168.1.10
Add support for private address 
192.168.100.2 (router NAT function). 192.168.100.2
192.168.100.1
VB-C50FSi
C
O
P
Y  
						

							
Creating Web  Pages
5-27
You can view still images and control the camera using the Web service o\
f a mobile phone. You
can easily create still image distribution pages for mobile phones with \
HTML which uses the
command still.jpg. Sample pages for still image distribution for mobile \
phones have been provided
for the VB-C50FSi/VB-C50Fi. See below for how to view them.
Distributing Still Images to a Mobile Phone
Tip
●You can control the camera only when other users do not have control pri\
vileges.
● The sample screen above is for when the VB-C50FSi/VB-C50Fi is being used\
. If
you are using an external camera, the camera control link does not appea\
r.
Note
Depending on the model of the mobile phone, there may be cases where the\
 images
do not appear or where it is not possible to control the camera.
1. Start up your browser and enter the following URL.
http://
192.168.100.1:80/mobile/index.html
*The underlined portion is a sample IP address:HTTP port number. Enter th\
e actual IP address and HTTP
port number that were set on the VB-C50FSi/VB-C50Fi ( → P.3-6, 3-16).
2. Select the language (English or Japanese).
3. The sample page appears.
The sample page has been created in such a way that you can control the \
camera. Adjust the
zoom and brightness, and specify the camera position. You can perform th\
e operation
corresponding to each key by pressing the dial keys on your mobile phone\
.
C
O
P
Y  
						

							
5-28
Example of Creating a Screen for Distribution of a Still Image to a Mobi\
le Phone
Overwriting Sample Pages
You can change screen displays and the content of operations by overwrit\
ing the HTML file below
the “mobile” folder on the CD-ROM.
POS1.htm



For example, to change the control position for Position [1], overwrite \
the underlined value in
“pos1.html”. See the table below for details of the parameters of \
the still.jpg command.
Note
● If you are going to overwrite the sample pages, please do so after you h\
ave copied
the “mobile” folder to your PC.
● Please delete the “mobile” folder beforehand if it is already save\
d in the VB-C50FSi/
VB-C50Fi.
still.jpg parameters
Command Description
camera_id Specifies the camera when you switch between cameras. 1 is this camera, \
and
2 is an external camera. When there is no specification, you are deemed \
to
have specified the current camera.
z
 or  zoom Specifies the zoom magnification of the camera. z is ten times zoom magn\
ification
of maximum wide angle and zoom is in units of 0.01˚.
b
 or  back_light Specifies camera backlight compensation. When this parameter is set to o\
n, the
picture captured will be bright and when this parameter is set to off, t\
he picture
captured will be dark. If this parameter is omitted, camera backlight co\
mpensation
is not controlled.
v
 or  image_size Specifies image size. You can specify 160 
× 120, 320  × 240, and 640  × 480 for
NTSC, and 192  × 144, 384  × 288, and 768  × 576 for PAL. The format for v and
image_size is different. v only specifies horizontal size, e.g. v=640. i\
mage_size
specifies vertical and horizontal size, e.g. image_size=320  × 240.
option Specifies how errors are dealt with. When “skip_on_error” is speci\
fied, the process
will be continued. When “quit_on_error” is specified, the process \
will be aborted.
The following errors can occur: failure to acquire camera control right,\
 loss of
camera control, camera selection errors and camera control errors. To om\
it, the
default value is “quit_on_error”.
Tip
Specifying with the current position which appears as “d” and the \
percentage for the
current angle which appears as “c” (percentage) is also possible\
 for z (zoom).
For example:
z=c200 sets twice the current zoom magnification.
C
O
P
Y