flash.py

"""
  Copyright (C) 2025 Allied Vision Technologies. All Rights Reserved.
  Subject to the BSD 3-Clause License.
"""

import sys
from vmbpy import *
from vmbpy.camera import CamerasTuple
from vmbpy.transportlayer import TransportLayersTuple

def print_preamble():
    print('////////////////////////////////////////')
    print('/// Smart Camera Trigger I/O Example ///')
    print('////////////////////////////////////////\n')


def print_usage():
    print('Usage:')
    print('    python flash.py')
    print('    python flash.py -h')
    print()


def abort(reason: str, return_code: int = 1, usage: bool = False):
    print(reason + '\n')

    if usage:
        print_usage()

    sys.exit(return_code)


def parse_args() -> None:
    args = sys.argv[1:]
    argc = len(args)

    for arg in args:
        if arg == '-h':
            print_usage()
            sys.exit(0)

    if argc > 0:
        abort(reason="Invalid number of arguments. Abort.", return_code=2, usage=True)
        

def frame_handler(camera: Camera, stream: Stream, frame: Frame):
    print('{} acquired {}'.format(camera, frame), flush=True)

    camera.queue_frame(frame)


if __name__ == '__main__':
    print_preamble()
    parse_args()
    
    with VmbSystem.get_instance() as vmb_system:

        transport_layers: TransportLayersTuple = vmb_system.get_all_transport_layers()
        if len(transport_layers) == 0:
            abort('No transport layer found.')
        transport_layer: TransportLayer = transport_layers[0]

        cameras: CamerasTuple = vmb_system.get_all_cameras()
        if len(cameras) == 0:
            abort('No camera found.')
            
        with cameras[0] as camera:
            
            # Set "Flashed Strobe" here for overdrive mode
            transport_layer.LightControllerMode.set("Continuous Strobe")
            transport_layer.LightBrightness.set(100)

            camera.LineSelector.set("Line1")
            try:
                camera.LineMode.set("Output")
            except:
                pass
            camera.LineSource.set("ExposureActive")
            # invert the signal because the external light output line is connected to an opto-coupler
            camera.LineInverter.set(True)
            camera.ExposureTime.set(10000)
                
            print('\nSetting external light output line to high whenever exposure is active.')
            print('Press <enter> to stop frame acquisition.')
            camera.start_streaming(handler=frame_handler)
            input()
            camera.stop_streaming()