Optional parameters for Images and JPEG Streams

Various settings can be set on demand.

Video Size

• Size Parameter
  size sets height and width of the image. It scales your images to any size

  Examples:

  JPEG stream: http://localhost:8080/current.mjpg?size=640x480
  scaled screen shot http://localhost:8080/current.jpg?size=320x240
  
• Height Parameter
  the height parameter sets the height of the image and maintains aspect ratio

  Examples:

  JPEG stream: http://localhost:8080/current.mjpg?height=100
  
• Width Parameter
  the width parameter sets the width of the image and maintains aspect ratio

  Examples:

  JPEG stream: http://localhost:8080/current.mjpg?width=200
  

 

note: height and width are not available for screen shots

 

Picture border

you may request a picture with a frame around it. The image will be scaled to fit the remaining space.

• borderwidth=w
  w = width of the border in pixels. Values 0-99 are allowed
• bordercolor=RrGgBb?
  RGB value of the border color. Example: bordercolor=FF0000 for a red border

Examples:

black border http://localhost:8080/current.jpg?borderwidth=5&bordercolor=000000
light blue http://localhost:8080/current.jpg?borderwidth=2&bordercolor=8888FF

Picture border is only available for current.jpg, not for screen shots or motion JPEG streams.

 

Frame rate

all JPEG streams can stream at a selectable frame rate. The maximum frame rate is defined for the video device in Devices

To set the frame rate on demand, define the fps parameter.

Examples:

http://localhost:8080/current.mjpg?fps=2
http://localhost:8080/screen.mjpg?fps=0.5
http://localhost:8080/motion.mjpg?fps=15

 

Selection for replay of stored shots

to filter picture replay, use the filter parameter:

Example:

http://localhost:8080/motion.mjpg?filter=20051019*
this will show pictures taken on Oct 19th 2005 (if pictures were save with time based names)

Combine parameters

to use more than one parameter in a request, combine them using &

Example:

http://localhost:8080/screen.mjpg?size=640x480&fps=1
this will show your desktop sized to 640x480 and refreshed once per second