Table Of Contents
Camera¶
The Camera
widget is used to capture and display video from a camera.
Once the widget is created, the texture inside the widget will be automatically
updated. Our CameraBase
implementation is used under
the hood:
cam = Camera()
By default, the first camera found on your system is used. To use a different camera, set the index property:
cam = Camera(index=1)
You can also select the camera resolution:
cam = Camera(resolution=(320, 240))
Warning
The camera texture is not updated as soon as you have created the object. The camera initialization is asynchronous, so there may be a delay before the requested texture is created.
- class kivy.uix.camera.Camera(**kwargs)[source]¶
Bases:
kivy.uix.image.Image
Camera class. See module documentation for more information.
- index¶
Index of the used camera, starting from 0.
index
is aNumericProperty
and defaults to -1 to allow auto selection.
- play¶
Boolean indicating whether the camera is playing or not. You can start/stop the camera by setting this property:
# start the camera playing at creation cam = Camera(play=True) # create the camera, and start later (default) cam = Camera(play=False) # and later cam.play = True
play
is aBooleanProperty
and defaults to False.
- resolution¶
Preferred resolution to use when invoking the camera. If you are using [-1, -1], the resolution will be the default one:
# create a camera object with the best image available cam = Camera() # create a camera object with an image of 320x240 if possible cam = Camera(resolution=(320, 240))
Warning
Depending on the implementation, the camera may not respect this property.
resolution
is aListProperty
and defaults to [-1, -1].