#!/usr/bin/env python2.7 # # Wenet fswebcam Wrapper Class. # # Copyright (C) 2018 Mark Jessop # Released under GNU GPL v3 or later # import time from threading import Thread import glob import os import sys import datetime if os.name == 'posix' and sys.version_info[0] < 3: import subprocess32 as subprocess else: import subprocess class WenetFSWebcam(object): """ fswebcam Wrapper Class fwebcam Image Source for Wenet. Captures multiple images (ideally, maybe not), picks the best, then transmits it via a PacketTX object. """ def __init__(self, fswebcam_config='fswebcam.conf', tx_resolution=(1680,1120), num_images=1, temp_filename_prefix = 'webcam_temp', debug_ptr = None, callsign = "N0CALL"): """ Instantiate a WenetGPhoto Object used to capture images using GPhoto. Keyword Arguments: callsign: The callsign to be used when converting images to SSDV. Must be <=6 characters in length. fswebcam_config: A configuration file containing the desired webcam capture parameters. Refer to the fswebcam man page for more information. tx_resolution: Tuple (x,y) containing desired image *transmit* resolution. NOTE: both x and y need to be multiples of 16 to be used with SSDV. NOTE: This will resize with NO REGARD FOR ASPECT RATIO - it's up to you to get that right. num_images: Number of images to capture in sequence when the 'capture' function is called. The 'best' (largest filesize) image is selected and saved. temp_filename_prefix: prefix used for temporary files. debug_ptr: 'pointer' to a function which can handle debug messages. This function needs to be able to accept a string. Used to get status messages into the downlink. """ self.debug_ptr = debug_ptr self.temp_filename_prefix = temp_filename_prefix self.num_images = num_images self.callsign = callsign self.tx_resolution = tx_resolution self.fswebcam_config = fswebcam_config # Attempt to set camera time. # This also tells us if we can communicate with the camera or not. proc = subprocess.Popen(['fswebcam','webcam_temp_1.jpg'],stdout=subprocess.PIPE, stderr=subprocess.PIPE) proc.wait() if "No such file or directory" in proc.stderr.read(): self.debug_message("No Camera Connected!") def debug_message(self, message): """ Write a debug message. If debug_ptr was set to a function during init, this will write pass the message to that function, else it will just print it. This is used mainly to get updates on image capture into the Wenet downlink. """ message = "Webcam Debug: " + message if self.debug_ptr != None: self.debug_ptr(message) else: print(message) def close(self): self.cam.close() pass def capture(self, filename='webcam.jpg'): """ Capture an image using GPhoto Keyword Arguments: filename: destination filename. """ # Attempt to capture a set of images. for i in range(self.num_images): self.debug_message("Capturing Image %d of %d" % (i+1,self.num_images)) # Wrap this in error handling in case we lose the camera for some reason. try: temp_filename = "%s_%d.jpg" % (self.temp_filename_prefix,i) start_time = time.time() proc = subprocess.Popen(['fswebcam','-c', self.fswebcam_config, temp_filename],stdout=subprocess.PIPE, stderr=subprocess.PIPE) (proc_stdout, proc_stderr) = proc.communicate(timeout=10) #print(proc_stdout) #print("stderr:") #print(proc_stderr) if "Writing JPEG image to" not in proc_stderr: self.debug_message("ERROR: Capture Failed.") return False else: print(time.time()-start_time) except Exception as e: # TODO: Narrow this down... self.debug_message("ERROR: %s" % str(e)) # Immediately return false. Not much point continuing to try and capture images. return False # Otherwise, continue to pick the 'best' image based on filesize. self.debug_message("Choosing Best Image.") pic_list = glob.glob("%s_*.jpg" % self.temp_filename_prefix) if len(pic_list) == 0: self.debug_message("ERROR: No Images Captured!") return False pic_sizes = [] # Iterate through list of images and get the file sizes. for pic in pic_list: pic_sizes.append(os.path.getsize(pic)) largest_pic = pic_list[pic_sizes.index(max(pic_sizes))] # Copy best image to target filename. self.debug_message("Copying image to storage.") os.system("cp %s %s" % (largest_pic, filename)) # Clean up temporary images. os.system("rm %s_*.jpg" % self.temp_filename_prefix) return True def ssdvify(self, filename="output.jpg", image_id=0, quality=6): """ Convert a supplied JPEG image to SSDV. Returns the filename of the converted SSDV image. Keyword Arguments: filename: Source JPEG filename. Output SSDV image will be saved to to a temporary file (webcam_temp.jpg) which should be transmitted immediately. image_id: Image ID number. Must be incremented between images. quality: JPEG quality level: 4 - 7, where 7 is 'lossless' (not recommended). 6 provides good quality at decent file-sizes. """ # Wrap image ID field if it's >255. image_id = image_id % 256 # Resize image to the desired resolution. self.debug_message("Resizing image.") return_code = os.system("convert %s -resize %dx%d\! webcam_temp.jpg" % (filename, self.tx_resolution[0], self.tx_resolution[1])) if return_code != 0: self.debug_message("Resize operation failed!") return "FAIL" # Get non-extension part of filename. file_basename = filename[:-4] # Construct SSDV command-line. ssdv_command = "ssdv -e -n -q %d -c %s -i %d webcam_temp.jpg webcam_temp.ssdv" % (quality, self.callsign, image_id) print(ssdv_command) # Update debug message. self.debug_message("Converting image to SSDV.") # Run SSDV converter. return_code = os.system(ssdv_command) if return_code != 0: self.debug_message("ERROR: Could not perform SSDV Conversion.") return "FAIL" else: return "webcam_temp.ssdv" auto_capture_running = False def auto_capture(self, destination_directory, tx, post_process_ptr=None, delay = 0, start_id = 0): """ Automatically capture and transmit images in a loop. Images are automatically saved to a supplied directory, with file-names defined using a timestamp. Use the run() and stop() functions to start/stop this running. Keyword Arguments: destination_directory: Folder to save images to. Both raw JPEG and SSDV images are saved here. tx: A reference to a PacketTX Object, which is used to transmit packets, and interrogate the TX queue. post_process_ptr: An optional function which is called after the image is captured. This function will be passed the path/filename of the captured image. This can be used to add overlays, etc to the image before it is SSDVified and transmitted. NOTE: This function need to modify the image in-place. delay: An optional delay in seconds between capturing images. Defaults to 0. This delay is added on top of any delays caused while waiting for the transmit queue to empty. start_id: Starting image ID. Defaults to 0. """ image_id = start_id while self.auto_capture_running: # Sleep before capturing next image. time.sleep(delay) # Grab current timestamp. capture_time = datetime.datetime.utcnow().strftime("%Y%m%d-%H%M%SZ") capture_filename = destination_directory + "/%s_webcam.jpg" % capture_time # Attempt to capture. capture_successful = self.capture(capture_filename) # If capture was unsuccessful, wait a few seconds and try and continue, # in case the camera is re-connected. if not capture_successful: time.sleep(10) continue # Otherwise, proceed to post-processing step. if post_process_ptr != None: try: self.debug_message("Running Image Post-Processing") post_process_ptr(capture_filename) except: self.debug_message("Image Post-Processing Failed.") # SSDV'ify the image. ssdv_filename = self.ssdvify(capture_filename, image_id=image_id) # Check the SSDV Conversion has completed properly. If not, wait a second then continue. if ssdv_filename == "FAIL": time.sleep(1) continue # Otherwise, read in the file and push into the TX buffer. file_size = os.path.getsize(ssdv_filename) # Wait until the transmit queue is empty before pushing in packets. self.debug_message("Waiting for SSDV TX queue to empty.") while tx.image_queue_empty() == False: time.sleep(0.05) # Sleep for a short amount of time. if self.auto_capture_running == False: return # Inform ground station we are about to send an image. self.debug_message("Transmitting %d Webcam SSDV Packets." % (file_size/256)) # Push SSDV file into transmit queue. tx.queue_image_file(ssdv_filename) # Increment image ID. image_id = (image_id + 1) % 256 # Loop! def run(self, destination_directory, tx, post_process_ptr=None, delay = 0, start_id = 0): """ Start auto-capturing images in a thread. Refer auto_capture function above. Keyword Arguments: destination_directory: Folder to save images to. Both raw JPEG and SSDV images are saved here. tx: A reference to a PacketTX Object, which is used to transmit packets, and interrogate the TX queue. post_process_ptr: An optional function which is called after the image is captured. This function will be passed the path/filename of the captured image. This can be used to add overlays, etc to the image before it is SSDVified and transmitted. NOTE: This function need to modify the image in-place. delay: An optional delay in seconds between capturing images. Defaults to 0. This delay is added on top of any delays caused while waiting for the transmit queue to empty. start_id: Starting image ID. Defaults to 0. """ self.auto_capture_running = True capture_thread = Thread(target=self.auto_capture, kwargs=dict( destination_directory=destination_directory, tx = tx, post_process_ptr=post_process_ptr, delay=delay, start_id=start_id)) capture_thread.start() def stop(self): self.auto_capture_running = False # TODO: Non-blocking image capture. capture_finished = False def trigger_capture(): pass # Basic transmission test script. if __name__ == "__main__": import PacketTX import argparse parser = argparse.ArgumentParser() parser.add_argument("callsign", default="N0CALL", help="Payload Callsign") args = parser.parse_args() callsign = args.callsign print("Using Callsign: %s" % callsign) def post_process(filename): print("Doing nothing with %s" % filename) tx = PacketTX.PacketTX(callsign=callsign) tx.start_tx() gphoto = WenetFSWebcam(callsign=callsign, debug_ptr=tx.transmit_text_message) gphoto.run(destination_directory="./tx_images/", tx = tx, post_process_ptr = post_process ) try: while True: tx.transmit_text_message("Waiting...") time.sleep(5) except KeyboardInterrupt: print("Closing") gphoto.stop() tx.close()