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 sizeExamples:
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 ratioExamples:
JPEG stream: http://localhost:8080/current.mjpg?height=100
- Width Parameter
the width parameter sets the width of the image and maintains aspect ratioExamples:
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=000000light 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 DevicesTo set the frame rate on demand, define the fps parameter.
Examples:
http://localhost:8080/current.mjpg?fps=2http://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
comments:
quality --DerekD?, Sat, 26 Sep 2009 08:28:49 +0200 reply