Python is nowadays an essential programming language. Due to its simple syntax and its wide library collection, it is easy to use and learn for the beginner. But is also ideal for prototyping and visualisation. These are actually my main usage of python. For speed-critical programs, I would recommend other languages though, such as C++ (10 – 100 times faster than native Python code), but that’s another topic which is not the goal of this post. <\/p>\n\n\n\n
In this post, I will show how easy it is to make a video using the OpenCV (CV2) python package<\/a>, based on a series of images (or frames). <\/p>\n\n\n\n Before starting, you need to install the CV2 package. In Unix-based systems, it is likely that you will use pip3<\/a> or conda<\/a>. In MacOS, you may also use brew<\/a>. <\/p>\n\n\n\n Let’s straight start with the core function that converts images to a movie. I will then explain it part-by-part,<\/p>\n\n\n\n First, you have the usual import<\/strong> command and the function declaration part<\/strong>, with some comments<\/strong> on the role of each parameters. We use the cv2<\/strong> package but also the glob<\/strong> package here. Then starts the main code<\/strong> of this example.<\/p>\n\n\n\n The code requires two mandatory parameters and two optional ones. The mandatory ones are:<\/p>\n\n\n\n The optional ones control the name of the output file ( The first part of the code use glob<\/strong> in order to retrieve the list of files within the Then we have a section that allows to exit the program with an error\/debug message if the image files were somewhat not found,<\/p>\n\n\n\n If we did not exit with an error, the program reads all of the image file one-by-one and store them into the The line The instruction that follows declares the video container. The codec here is set to ‘DIVX’, which should work on any OS, but others may be used if you have specific purpose in mind (but it may require some codec installation, such as for most web videos – in h264 -),<\/p>\n\n\n\n Finally, we sequentially write the images into the container using the inherited function out.write():<\/p>\n\n\n\n And the file should not be forgotten to be closed, using That’s it, you should end-up with a video, like this one:<\/p>\n\n\n\nimport cv2\nimport glob\ndef jpg2movie(dir_img, fps, file_out='output.avi', extension='jpg'):\n '''\n Make a movie from a sequence of jpg images. Images must be ordered by index so that \n the program can guess their order. The best is to use unambiguous filenames:\n 000.jpg, 001.jpg, ..., 999.jpg\n dir_jpg: directory that contains the image files. \n fps: cadence of the frame\n file_out (optional): name of the output file for the AVI. If not provided, it will be 'output.avi'\n extension (optional): extension of the image files that we look for within the dir_img directory\n '''\n img_array = []\n files=sorted(glob.glob(dir_img+'\/*.'+extension))\n if files ==[]:\n print('Error: No file found that match the provided extension in the requested directory')\n print(' File Extension: ', extension)\n print(' Searched Directory: ', dir_img)\n exit()\n for filename in files:\n img = cv2.imread(filename)\n height, width, layers = img.shape\n img_array.append(img)\n size = (width,height)\n #\n out = cv2.VideoWriter(file_out,cv2.VideoWriter_fourcc(*'DIVX'), fps, size) \n for i in range(len(img_array)):\n out.write(img_array[i])\n out.release()<\/code><\/pre>\n\n\n\ndir_img: <\/code>specifies where are located the image files that you wish to use as frames of your video<\/p>\n\n\n\nfps:<\/code> specifies the number of frame\/images to be shown per second. It will directly control the duration of your final video. If you have only a few image files, you might need to set this to a low value (eg. fps=2<\/code> images per second). But typical cameras will record at a rate of fps=24<\/code> images \/ second (or even faster to get a smooth animation). That value will therefore depends a lot on your use-case. Personally, I use movies for data visualisation (and debugging) and I need slow motion to get time to understand the images.<\/p>\n\n\n\nfile_out<\/code>), set by default to output.avi<\/code> and the extension<\/code> of the image files present in the dir_img<\/code> directory. By default it assumes JPEG images (jpg extension), but you may need to change that for your usage.<\/p>\n\n\n\ndir_img<\/code> directory that match the extension<\/code> argument, after having declared an empty list img_array<\/code> that will contain all of our images later. You will also note that I impose the files to be sorted<\/strong>, so that they are framed in a predictive manner. If you do not do so, you will likely end-up with a completely incoherent video. A corollary is that you have to be careful in the way you prepare your frames: These should be named using a pattern that is predictive. It is assumed here some kind of numeral or alphabetical sorted order (eg. myimage_000.jpg, myimage_001.jpg, …),<\/p>\n\n\n\nimg_array = []\nfiles=sorted(glob.glob(dir_img+'\/*.'+extension))<\/code><\/pre>\n\n\n\nif files ==[]:\n print('Error: No file found that match the provided extension in the requested directory')\n print(' File Extension: ', extension)\n print(' Searched Directory: ', dir_img)\n exit()<\/code><\/pre>\n\n\n\nimg_array<\/code>. This is done using the cv2.imread()<\/code> function,<\/p>\n\n\n\nfor filename in files:\n img = cv2.imread(filename)\n height, width, layers = img.shape\n img_array.append(img)<\/code><\/pre>\n\n\n\nsize = (width,height)<\/code> specifies the size of the output image. As you guess here, it is supposed to be a constant, so make sure that all your image files have the same size. Otherwise, you may end-up with some surprises.<\/p>\n\n\n\nout = cv2.VideoWriter(file_out,cv2.VideoWriter_fourcc(*'DIVX'), fps, size)<\/code><\/pre>\n\n\n\nfor i in range(len(img_array)):\n out.write(img_array[i])<\/code><\/pre>\n\n\n\nout.release()<\/code><\/p>\n\n\n\n