Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 03a05144 authored by Mark Harman's avatar Mark Harman Committed by Mohammed Althaf T
Browse files

Fix comments.

parent d00cd214
Loading
Loading
Loading
Loading
+11 −4
Original line number Original line Diff line number Diff line
@@ -272,26 +272,33 @@ public abstract class CameraController {
     */
     */
    public interface PictureCallback {
    public interface PictureCallback {
        void onStarted(); // called immediately before we start capturing the picture
        void onStarted(); // called immediately before we start capturing the picture

        void onCompleted(); // called after all relevant on*PictureTaken() callbacks have been called and returned
        void onCompleted(); // called after all relevant on*PictureTaken() callbacks have been called and returned

        void onPictureTaken(byte[] data);
        void onPictureTaken(byte[] data);

        /** Only called if RAW is requested.
        /** Only called if RAW is requested.
         *  Caller should call raw_image.close() when done with the image.
         *  Caller should call raw_image.close() when done with the image.
         */
         */
        void onRawPictureTaken(RawImage raw_image);
        void onRawPictureTaken(RawImage raw_image);

        /** Only called if burst is requested.
        /** Only called if burst is requested.
         */
         */
        void onBurstPictureTaken(List<byte[]> images);
        void onBurstPictureTaken(List<byte[]> images);

        /** Only called if burst is requested.
        /** Only called if burst is requested.
         */
         */
        void onRawBurstPictureTaken(List<RawImage> raw_images);
        void onRawBurstPictureTaken(List<RawImage> raw_images);
        /* This is called for flash_frontscreen_auto or flash_frontscreen_on mode to indicate the caller should light up the screen

         * (for flash_frontscreen_auto it will only be called if the scene is considered dark enough to require the screen flash).
         * The screen flash can be removed when or after onCompleted() is called.
         */
        /* This is called for when burst mode is BURSTTYPE_FOCUS or BURSTTYPE_CONTINUOUS, to ask whether it's safe to take
        /* This is called for when burst mode is BURSTTYPE_FOCUS or BURSTTYPE_CONTINUOUS, to ask whether it's safe to take
         * n_raw extra RAW images and n_jpegs extra JPEG images, or whether to wait.
         * n_raw extra RAW images and n_jpegs extra JPEG images, or whether to wait.
         */
         */
        boolean imageQueueWouldBlock(int n_raw, int n_jpegs);
        boolean imageQueueWouldBlock(int n_raw, int n_jpegs);

        /* This is called for flash_frontscreen_auto or flash_frontscreen_on mode to indicate the caller should light up the screen
         * (for flash_frontscreen_auto it will only be called if the scene is considered dark enough to require the screen flash).
         * The screen flash can be removed when or after onCompleted() is called.
         */
        void onFrontScreenTurnOn();
        void onFrontScreenTurnOn();
    }
    }