{"id":3955,"date":"2019-12-20T12:12:25","date_gmt":"2019-12-20T17:12:25","guid":{"rendered":"https:\/\/blogs.mathworks.com\/steve\/?p=3955"},"modified":"2019-12-24T11:14:04","modified_gmt":"2019-12-24T16:14:04","slug":"how-to-write-animated-png-apng-files-from-matlab","status":"publish","type":"post","link":"https:\/\/blogs.mathworks.com\/steve\/2019\/12\/20\/how-to-write-animated-png-apng-files-from-matlab\/","title":{"rendered":"How to Write Animated PNG (APNG) Files from MATLAB"},"content":{"rendered":"

Today, I'm writing about how to create animated PNG (APNG) files, such as this one:<\/p>

\"\" <\/p>

I first wrote about APNG files last February<\/a>. An APNG file is a valid PNG image file that uses file metadata in a clever way to compress and store the frames of a full animation. See the 07-Feb-2019 post<\/a> for more details about this.<\/p>

Just recently, I created a MATLAB utility for creating APNG files. It is available on the File Exchange<\/a> and also on GitHub<\/a>. This utility makes use of the program APNG Assember<\/i>, which is available under separate license terms. The utility will automatically download this program for you the first time you use it.<\/p>

To demonstrate its use, I will use it to create an animation of some pursuit curves that I first showed in my 14-Feb-2019 blog post<\/a>. Here is the code for one version of the pursuit curves:<\/p>

theta = 0:60:330;\r\nP = cosd(theta) + 1i*sind(theta);\r\nP = reshape(P,1,[]);\r\nN = length(P);\r\nd = 0.01;\r\nfor<\/span> k = 1:1000\r\n    V = P(end,[(2:N) 1]) - P(end,:);\r\n    P(end+1,:) = P(end,:) + d*V;\r\nend<\/span>\r\nhold on<\/span>\r\nfor<\/span> k = 1:N\r\n    plot(real(P(:,k)),imag(P(:,k)))\r\nend<\/span>\r\nhold off<\/span>\r\naxis equal<\/span>\r\n<\/pre>\"\" 
This relatively simplistic way to compute the curves doesn't work so well for animating them, however, because the spacing of the computed points gets smaller and smaller as the points get closer to the center. The animation would appear to slow down.<\/p>
So, I wrote a little code to resample the generated curve in approximately equal arc-length segments. Here's what that looks like:<\/p>
step_distance = abs(diff(P(:,1),1));\r\ncumulative_step_distance = [0; cumsum(step_distance,1)];\r\nmax_travel_distance = cumulative_step_distance(end);\r\nnum_resampled_steps = 10000;\r\nx = linspace(0,max_travel_distance,num_resampled_steps);\r\nPr = interp1(cumulative_step_distance,P,x);\r\n<\/pre>
And here's the code to generate one frame of the animation at a time.<\/p>
num_frames = 100;\r\nq = round(linspace(1,size(Pr,1),num_frames));\r\n\r\nfig = gcf;\r\nfig.Position(3:4) = 300;\r\n\r\nframes = zeros(0,0,'uint8'<\/span>);\r\nfor<\/span> k = 1:length(q)\r\n    clf\r\n    hold on<\/span>\r\n    for<\/span> v = 1:N\r\n        plot(real(Pr(1:q(k),v)),imag(Pr(1:q(k),v)))\r\n    end<\/span>\r\n    hold off<\/span>\r\n    axis(limits)\r\n    axis equal<\/span>\r\n    axis off<\/span>\r\n    frame = print(fig,'-r150'<\/span>,'-RGBImage'<\/span>);\r\n    frames = cat(4,frames,frame);\r\nend<\/span>\r\n<\/pre>\"\" 
Here's an extra wrinkle. Although APNG is widely supported by browsers today, there are plenty of programs around that display image files and that don't know about the extra animation metadata in APNG files. I want these viewers to show the last<\/b> frame of the animation because that's the frame that includes the complete curves. So I will prepend that frame to the beginning, and then I'll tell the APNG utility class to skip the first frame for animations.<\/p>
frames = cat(4,frame,frames);\r\n\r\n% Create the APNG file.<\/span>\r\nw = animatedPNGWriter('animated-pursuit-curves.png'<\/span>);\r\nw.FramesPerSecond = 20;\r\nw.SkipFirstFrame = true;\r\nfor<\/span> k = 1:size(frames,4)\r\n    addframe(w,frames(:,:,:,k));\r\nend<\/span>\r\nfinish(w);\r\n<\/pre>
Download and give animatedPNGWriter<\/tt> a try. If you find trouble with it, feel free to report an issue on its GitHub repository<\/a>.<\/p>