Canon network camera VBC50iVBC50iR User Manual

							
Creating Web  Pages
5-17
Viewer for Java Parameters
You can specify applet parameters to provide an applet tailored to modif\
y the behavior or
appearance of applets. Refer to the table below to ensure that you thoro\
ughly understand the
parameters.
LiveApplet
Using the Viewer for Java to Distribute Videos
Specifies whether or not connection to the camera server should be 
established at the same time that the applet starts up. Select “on”\
 or “off”. 
When “on” is selected, connection is established when the applet s\
tarts up and 
moving pictures are displayed. With “off”, the connection is not e\
stablished 
when the applet starts up and the character string that was specified wi\
th the 
“no_connect_msg” parameter is displayed. The “connect()” m\
ethod is called up 
to establish connections.
Ye sauto_connect
Use this parameter to set the background color. The parameter specificat\
ion 
format is “#RRGGBB” (values between 0 and 255 for each component \
color 
expressed as a hexadecimal).
E.G. White: “#FFFFFF”, Grey: “#AAAAAA”, Green: “#00FF00”\
If this parameter is omitted, the default background color is used.
Ye sbg_color
The picture displayed in the background of LiveApplet can be specified. \
A 
JPEG or GIF image can be specified. The WebView Livescope logo is not 
displayed if specified. If not specified, the default picture is used. (\
Refer to 
image_offset about the display position.)
Ye sbg_image
Specifies the size of the image when LiveApplet is started. There are 4 \
sizes: 
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-7). 
capture_size is unrelated to the size of the image displayed on the moni\
tor of 
your PC. To change the size of the image on the monitor, specify video_w\
idth.
Ye scapture_size
Specifies behavior when a moving picture display area is clicked. “pt\
” specifies 
pan and tilt; “none” specifies no reaction. The default is “pt”\
.Ye sclick_action
You can use this parameter to specify the screen displayed in the video \
display 
window at the time of disconnection. Specify the name of a JPEG or GIF i\
mage. 
If this parameter is omitted, the default disconnection screen is displa\
yed.Ye sclose_image
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 that is displayed while connection to the\
 camera 
server is being established. The default is “now connecting”.Ye sconnect_msg
Specifies the GUI style for controlling the camera. “normal” speci\
fies the usual 
GUI style; “preset_only” specifies preset operation only; “none\
” specifies that 
the entire GUI will not be displayed. With “preset_only”, only the\
 Start Control 
button, the Camera Control Status window, the Preset Selection Box, and \
the 
Snapshot button are displayed.
Ye scontroller_style
Specifies the character string that is displayed when the connection to \
the 
camera server is aborted. The default is “disconnected”.Ye sdisconnect_msg
Specifies the character string that is displayed when connection to the \
camera 
server has failed. The default is “can’t connect”.Ye serror_msg
Specifies the display size for connect_msg, disconnect_msg, error_msg, n\
o_connect_msg, 
and too_many_msg. The default makes size dependent on the display area.Ye sfont_size
DescriptionOmissiblePa rameter Name
 005-VBC50i-E-US 06.7.6, 11:36 AM
17
C
O
P
Y  
						

							
5-18
Using the Viewer for Java to Distribute Videos
When a startup screen is specified in the “open_image” parameter, \
this parameter 
specifies the display time. The time is specified in milliseconds (1/10\
00 sec.), and 
the default value is 0. The image is displayed until the first video fra\
me appears. 
Values from 0 to 30000 (30 seconds) can be specified.
Ye sopen_image_time
Specifies the color of the character string specified for “comment”\
 and “hostname”. 
The color is specified at “#RRGGBB”. The default is yellow.Ye soverlay_font_color
This function specifies whether the Snapshot button is displayed. Specif\
y “on” or 
“off”. The default value is “on”. The button is always displ\
ayed unless “off” is explicitly 
specified.Ye sshow_capture
This function displays the comment as an overlay on the video image. Spe\
cify “on” 
or “off”. The default value is “off”. Note that this paramet\
er is only valid if the 
“comment” parameter is specified.Ye sshow_comment
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 frame rate as an overlay on the video image. \
Specify “on” 
or “off”. The default value is “off”.Ye sshow_fps
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 this paramet\
er is only valid if the 
“hostname” parameter is specified.Ye sshow_hostname
Specifies whether or not the WebView Livescope logo should appear in the\
 upper right 
of the screen. It appears if show_logo is “on” and does not appear\
 if it is “off”.Ye sshow_logo
Function for displaying the buttons to change the image size when LiveAp\
plet is 
running. Specify “on” or “off”. The default value is “off\
”.Ye sshow_toolbar
Specify whether or not to display the panorama window pop-up button.Ye sshow_panobutton
This function displays a bitmap image as an overlay on the video image. \
Specify the 
image using the “bitmap-filename,x,y” format. Use the GIF format f\
or bitmap images 
(transparent GIFs supported). The “x,y” parameters specify the c\
oordinates of the 
bitmap image position on the video frame. If “x,y” is omitted, the\
 image is displayed 
in the center of the video frame.
Ye ssuperimpose
Specifies the character string that is displayed when connection to the \
camera 
server fails because the limit on the number of connections was exceeded\
. The 
default is “too many clients”.  Ye stoo_many_msg
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
This parameter specifies the video image display size (in pixels). Spe\
cify the width. The 
display sizes are 80 to 640, and any value can be set as the width. The \
height is calculated 
as 3/4 of the specified width. E.G. video_width=“240” (height = 2\
40 × 3/4 = 180.)Ye svideo_width
Specifies the display position of the picture file specified at bg_image\
. With the upper 
left coordinates of the picture at “0,0” and the right direction g\
iven as x and the down 
direction as y, image_offset is specified as “x,y”. The default is\
 “335,0”.Ye simage_offset
Specifies the character string to be displayed following applet startup \
when 
auto_connect is “off”. The default is “no connection”.Ye sno_connect_msg
You can use this parameter to specify the screen that appears in the vid\
eo display 
window until the first video image appears. Specify the name of a JPEG o\
r GIF image. 
If this parameter is omitted, the default startup screen is displayed.Ye sopen_image
DescriptionOmissibleParameter Name
Specifies whether the panorama window should be pop-up displayed or embe\
dded 
in the page. Specify “embed” for making it an embedded display. Wh\
en specifying 
“embed”, the Width and Height of the applet tags must be specified\
 a little larger 
(E.G. width=500; height=660).
Ye sgui_type
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 this p\
arameter is 
omitted, no host name is displayed.Ye shostname
C
O
P
Y  
						

							
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-7). 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
 005-VBC50i-E-US 06.7.6, 11:36 AM
20
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.types” 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-C50i/VB-C50iR’s built-i\
n 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.
 005-VBC50i-E-US 06.7.6, 11:36 AM
21
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 two particular models)
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 two particular models)
* The underlined portion is a sample IP address. Enter the actual IP addre\
ss that was set on the VB-
C50i/VB-C50iR ( → P.3-6).
●The first line gives the IP address (or host name) of the VB-C50i/VB-C\
50iR and the TCP
port number used for the video transmission. The default setting is 6531\
0 ( → P.3-18). 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-C50i/VB-\
C50iR and the TCP
port number used for the camera control. The default setting is 65311 (\
 → P.3-18). 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-C50i/VB-C50iR and “80” as the HTT\
P port number. As a
result of this, you will be able to view video from the VB-C50i/VB-C50iR\
 through firewalls.
● The fourth line is settings to listen to audio on the PC viewer. After “\
wvaudio:”, type in the IP
address of the VB-C50i/VB-C50iR and “80” as the HTTP port number. \
As a result of this,
you can receive audio from the VB-C50i/VB-C50iR. To receive audio, you n\
eed to set “Audio
Transmission” to “Used” in the Audio Server settings ( → P.3-19).*
*
 Only available with two particular models ( → P.iii)
Creating wvh Files
This section describes how to create the wvh file required for launching\
 the Viewer for PC
application.
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”.
 005-VBC50i-E-US 06.7.6, 11:36 AM
22
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 used.
Tip
To use the sample page template in the VB-C50i/VB-C50iR to supply videos\
, 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.
 005-VBC50i-E-US 06.7.6, 11:36 AM
23
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\
-C50i/VB-C50iR 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-C50i/VB-C50iR (→  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-C50i/VB-C50iR
(→  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.
 005-VBC50i-E-US 06.7.6, 11:36 AM
24
C
O
P
Y  
						

							
Creating Web  Pages
5-25
GetStillImage Parameters
Parameter Description
p or  pan Specifies the camera pan angle. “p” is a 1
° unit, and “pan” is a 0.01 ° unit.
For example if the camera pans right 20 °, then p is 20 and pan is 2000. If this
parameter is omitted, the camera pan angle is not controlled.
t  or  tilt Specifies the camera tilt angle. “t” is a 1
° unit, and “tilt” is a 0.01 ° unit. If this
parameter is omitted, the camera tilt angle is not controlled.
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-C50i/VB-C50iR
(→  P.3-6).
Displaying Live Video from a Specified Angle as Still Pictures
By specifying the camera angle as a parameter in the HTML code beforehan\
d, you can display
the picture from a specified camera angle. The example below displays a \
still picture shot with the
camera panned right by 40 ° and tilted down 10 °.
 005-VBC50i-E-US 06.7.6, 11:36 AM
25
C
O
P
Y  
						

							
5-26
NoteContact respective manufacturers for details on setting the router.
One fixed global address is required if the VB-C50i/VB-C50iR is being us\
ed 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-C50i/VB-C50iR (and 192.168.10\
0.1 for the router).
Example of Video Distribution Using One Global Address
A sample page of the VB-C50i/VB-C50iR is automatically generated based on the IP addr\
ess 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/sample/” \
is accessed through the Internet.
Set “Global Address for Web Pages” ( → P.3-17) to 192.168.1.10. If you are not using the
VB-C50i/VB-C50iR’s Web server, describe the Web pages for distributin\
g 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 two particular models)
* The underlined portion is a sample IP address. Enter the actual IP add\
ress set for the Global Address for Web Pages ( → P.3-17).
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-C50i/VB-C50iR
 005-VBC50i-E-US
06.7.6, 11:36 AM
26
C
O
P
Y