from openflexure_microscope.api.utilities import gen, JsonResponse from labthings.core.utilities import get_by_path, set_by_path, create_from_path from labthings.server.find import find_component from labthings.server.view import View from labthings.server.decorators import doc_response, ThingProperty from flask import Response @ThingProperty class MjpegStream(View): """ Real-time MJPEG stream from the microscope camera """ @doc_response(200, mimetype="multipart/x-mixed-replace") def get(self): """ MJPEG stream from the microscope camera. Note: While the code actually getting frame data from a camera and storing it in camera.frame runs in a thread, the gen(microscope.camera) generator does not. This response is therefore blocking. The generator just yields the most recent frame from the camera object, passed to the Flask response, and then repeats until the connection is closed. Without monkey patching with gevent, or using a native threaded server, the stream will block all proceeding requests. """ microscope = find_component("org.openflexure.microscope") # Restart stream worker thread microscope.camera.start_worker() return Response( gen(microscope.camera), mimetype="multipart/x-mixed-replace; boundary=frame" ) @ThingProperty class SnapshotStream(View): """ Single JPEG snapshot from the camera stream """ @doc_response(200, description="Snapshot taken", mimetype="image/jpeg") def get(self): """ Single snapshot from the camera stream """ microscope = find_component("org.openflexure.microscope") # Restart stream worker thread microscope.camera.start_worker() return Response(microscope.camera.get_frame(), mimetype="image/jpeg")