= CodeSwarm =



[[TOC(Projects/CodeSwarm, depth=2)]]


[http://code.google.com/p/codeswarm/ Code Swarm] is a FOSS project whose goal is to provide visualization of source code revision histories.  In simpler terms, using Code Swarm, one can create a video showing the commit history of a project.  

[wiki:TBR/User/JoelSherrill JoelSherrill] has created a Code Swarm video for RTEMS and has left some details of turning the raw Code Swarm output into a more meaningful video as tasks for students participating in [http://code.google.com/opensource/gci/2011-12/index.html Google Code-in 2011].  These tasks are:

 *  Produce a list of "interesting times" in the video which show high activity or interesting patterns.  
 *  An RTEMS developer will provide a description of the activity at each "interesting time"
 *  Add an introduction to the video consisting of at least
  *  a title 
  *  credits which associates the committer used ids in the video with real names, credits the person who produced the list of interesting times, the developer who documented those times, and the student adding the introduction
 *  Add text overlays at interesting times with descriptions.  The descriptions may have a size limit and have to be trimmed.

The Code Swarm video and a file containing the generated frames that comprise the video are available on the RTEMS FTP site which is accessible via [ftp://ftp.rtems.org/pub/rtems/people/joel/codeswarm ftp] or [http://www.rtems.org/ftp/pub/rtems/people/joel/codeswarm HTTP].
= Interesting Times in Video =


This is a list of interesting times in the video along with descriptions:

 *  12 May 1995 - Source code is moved from U.S. Army to OAR and CVS Repository started.
= Converting Frames to Video =


Instructions for converting the 12,000 frames that are in individual PNG files are at http://code.google.com/p/codeswarm/wiki/GeneratingAVideo.  The instructions use mencoder and various support libraries.
= Credits =


 *  [wiki:TBR/User/JoelSherrill JoelSherrill] - configured and ran Code Swarm to produce initial video