dvgrab 
(c) 2000-2003 Arne Schirmacher dvgrab@schirmacher.de
(c) 2002-2003 Dan Dennedy <dan@dennedy.org>

SEE the NEWS file for RELEASE NOTES!

2004-01-14  Dan Dennedy <dan@dennedy.org>
	- dvgrab.cc: bugfix --every option
                                      
2004-01-06  Dan Dennedy <dan@dennedy.org>
	- riff.h: 64bit OS fix.

2003-12-29  Dan Dennedy <dan@dennedy.org>
	- filehandler.cc, dvgrab.cc: bugfix autosplit first frame of new recording
	  appearing as last frame of previous file (DVGRAB-20).
	- dvgrab.cc: bugfix type 2 AVI audio stream frequency setting when
	  starting capture from non-playing state.
	- dvgrab.cc: enhanced autosplit by checking timecode continuity (DVGRAB-2).

2003-12-27  Arne Schirmacher <arne@schirmacher.de>
        - bugfix broken file when file size was between 1008 and 1024 MByte and 
          OpenDML was not turned on (DVGRAB-17, patch from Andrew Church)
        - bugfix file size displayed was always xxx.00 MB (DVGRAB-19, patch from 
          Andrew Church)

2003-12-09  Dan Dennedy <dan@dennedy.org>
	- ieee1394io.cc: revise AV/C Record mode to never issue a record command
	  on AVC::Play or AVC::Pause.
	- filehandler.cc: bugfix notification of capture file on autosplit.
	- dvgrab.1: bugfix to remove erroneous short option -i on --noavc.

2003-11-24  Dan Dennedy <dan@dennedy.org>
	- ieee1394io.cc, dvgrab.cc: make camera (AV/C Record) mode work correctly
	  (toggle record / pause).

----- v1.4 released -----

2003-11-16  Dan Dennedy <dan@dennedy.org>
	- dvgrab.cc:: in startCapture() check g_done when waiting for initial
	  frame to allow interruption.
	- all: remove use of deprecated strstream, using sstream and ostringstream.
	- all: fixup pretty make target and run against all code to reformat.
	- configure.in: bump version

2003-11-09  Dan Dennedy <dan@dennedy.org>
	- frame.cc: bugfix speed detection on DVCPRO (SMPTE 314M)
	- avi.cc: remove addition of JUNK chunks in the MOVI list to
	  reduce memory overhead of RIFF Directory and reduce file sizes.

2003-10-13  Dan Dennedy <dan@dennedy.org>
	- bugfix parsing new boolean options --stdin and --noavc if last on
	  command line.
	- bugfix sigint handling
	- added --guid option to select device.
	- make --noavc not do bus probes if not necessary.
	- make arg to --dv1394 optional for use with devfs.

2003-10-09  Dan Dennedy <dan@dennedy.org>
	- dvgrab.cc, dvgrab.1: make default --frames = 0, document 0 is unlimited,
	  fix documentation of SMIL time (.ms optional
	- dvgrab.cc: make opendml default off, ring bell on frame drop

2003-10-08  Dan Dennedy <dan@dennedy.org>
	- added option --noavc to disable use of any AV/C.

2003-10-07  Dan Dennedy <dan@dennedy.org>
	- make --duration option work with piped output too.

2003-09-26  Dan Dennedy <dan@dennedy.org>
	- require option --stdin to read from a pipe.

----- v1.3 released -----

2003-09-26  Dan Dennedy <dan@dennedy.org>
	- added support for saving raw DV with .dif extension for MainActor5.
	- added support for reading raw DV on stdin instead of 1394 in non-
	  interactive mode.
	- added --duration option with SMIL time value parser.
	- updated man page.

2003-09-17  Dan Dennedy <dan@dennedy.org>
	- added interactive mode with AV/C control
	- send AV/C play prior to capture on non-interactive capture
	- make dv2 default format
	- simultaneous capture and rawdv on stdout
	- automatically discover camera on any port (overridden via --card)
	- bump version to 1.3

2003-04-21  Dan Dennedy <dan@dennedy.org>
	- Applied patch from Daniel Kobras with some changes. Return success/failure
	  on AVI and FileHandler WriteFrame methods. Automatically enable OpenDML
	  feature if --size >1GB or --size = 0 (unlimited).

2003-02-22  Dan Dennedy <dan@dennedy.org>
	- added JPEG overwriting mode (--jpeg-overwrite)
	  (update the same jpeg instead of seqentially numbering them).
	- added raw DV stdout (base filename = '-') mode
	- updated AVI code from Kino 0.6.4.
	- bugfix segfault on dv1394 buffer underrun
	- bump version to 1.2

2003-02-06  Dan Dennedy <dan@dennedy.org>
	- disable processing of jpeg options when not compile with libdv and jpeglib.

Changes in version 1.1b4 by Dan Dennedy
	- added JPEG output with deinterlace and scaling
	- bugfix an AVI write bug
	- bugfix dv1394 capture on PAL

Changes in version 1.1b3 by Dan Dennedy

	- pickup improved AVI classes from Kino.
	- pickup FileHandler class from Kino to unify operation
	  and features across formats. 
	- raw format always creates consistent bytes-per-frame files 
	  even if there is a dropped packet.
	- detect libdv and use it for audio extraction and metadata
	- detect libdv/dv1394.h to enable support for dv1394 (--dv1394)
	- split on a max file size (--size)
	- do not overwrite existing files.
	- detect libquicktime and add quicktime file support (--format qt).
	- change --index option to --opendml for dv2 format only.
	  dv1 always only contains large index.
	  dv2 contains only small index.
	  dv2+opendml contains both small and large index.
	- verified compilation on gcc 3.2.
	

Changes in version 1.1b2

	- more work on writing large files


Changes in version 1.1b1

	- writes files larger than 1 GByte. Currently only
	  with --format dv1 files.

	- lots of code refactoring


Changes in version 1.01

	- PAL/NTSC detection improved

	- minor changes to compile with g++ 3.0 (contributed by
	  Daniel Kobras)

	- buffer space for frames doubled: now 100 frames instead
	  of 50 (about 3-4 secs, 16 MByte RAM total)

	- bugfix: dvgrab will now reliably close the current
	  AVI file when aborted by ctrl-c (contributed by Glen
	  Nakamura)


Changes in version 1.0

	- adapted to libraw 0.9

	- packet assemble code modified - some camcorders send
	  only 492 bytes instead of 496


Changes in version 0.99

	- fixed a bug that caused dvgrab to crash when grabbing very
	  big files in AVI Type 2 format and NTSC mode

	- fixed the incorrect size of files in raw format (they always
	  had an extra 480 bytes)

	- fixed exception thrown when writing a 0 frames file

	- automake and debian files provided by Daniel Kobras


Changes in version 0.89:

	- added the raw1394_stop_iso_rcv call in the close routines


Changes in version 0.88:

	- support for 12 bit audio in AVI Type 2 files (courtesy
	  Mike Pieper)


Changes in version 0.87:

	- new feature (courtesy Stephane Gourichon): there is now a
	  parameter that allows to save every n-th frame only. Great
	  for monitoring purposes or when you need a rough overview of
	  the contents of a tape.

	- Type 2 audio has been slightly improved. Still no 12-bit
	  audio, but I'm getting close.

	- refactoring and cleanup of the code.

	- a few bug fixes: the --format raw mode now works again.


Changes in version 0.86:

	- some improvements in the Type 2 AVI audio code. Many
	  camcorders send audio data which is not defined in my 314m
	  specification, which caused clicks and distortions, because
	  the audio data was left out.
	  If you have extensive audio error messages, your camcorder
	  is using an unsupported audio mode, such as 12 bit audio data.

	- the --testmode parameter reads DV data from a testdata.raw
	  file created previously with the --format test parameter. No
	  camcorder is required.


Changes in version 0.85:

	- handling of additional file formats: 
		--format raw
		--format test


Changes in version 0.84:

	- major rewrite. dvgrab now uses a separate thread for
	  handling the ieee1394 interface. This improves the behavior
	  under load conditions very much.


Changes in version 0.83:

	- there is now audio support for --format dv2 AVIs.
	  Currently only 16 bit 48 kHz sound is supported.


Changes in version 0.82:

	- incorrect audio speed value fixed, overflow error for long
	  Type 2 AVIs fixed.

	- Added support for the --format raw data format.
	  This is just the raw DV data (120000 bytes for each NTSC
	  frame or 144000 bytes for each PAL frame) written to a
	  file. Can be used with the playdv program from the libdv
	  project.


Changes in version 0.81:

	- fixed a bug that prevented Type 1 AVIs from playing with
	  some players.


Changes in version 0.8:

	- the program can now write Type 1 and Type 2 DV AVI files.
	  The difference is that Type 1 contains only one data stream
	  which has audio and video data interleaved, whereas Type 2
	  AVIs contain an additional audio stream. Since the video
	  stream still has the audio data interleaved, this is some
	  waste of disk space, but MainActor can't read Type 1 files
	  so I had to add support for this other format too.

	  Note that this version currently writes empty audio tracks.
	  This means: no sound, but at least it loads nicely into
	  MainActor.

	  A free demo version of MainActor can be downloaded from:

	  http://www.mainconcept.com 

	- Because of the increasing number of supported file formats
	  I have changed the option for selecting them.

	  To write MainActor compatible AVI files use this command:

	  dvgrab --format dv2 outfile


Changes in version 0.7:

	- the previous algorithm for assembling the data packets did
	  not work for some camcorders. I rewrote it and the new
	  algorithm explicitly calculates the address in the frame
	  buffer for each data packet.

	- the program attempts to auto-detect NTSC and PAL format.
	  The --pal or --ntsc command line parameter is no longer
	  mandantory, but it will override the auto-detect feature if
	  applied. Use them if the auto-detect feature doesn´t work
	  for you.

	- The --timestamp parameter will put the date and time of the
	  recording into the AVI file name. If it doesn´t do that,
	  dvgrab can´t find any date and time related packages in the
	  DV data.	  

	- I included the little utilities riffdump (prints out the 
	  structure of an arbitrary AVI file) and rawdump (prints
	  out an ASCII dump of a file created with the --raw
	  option)


Changes in version 0.6:

	- switched to C++ code. The reason is that C++ provides the
	  exception mechanism, which I use for a more reasonable
	  error reporting.
	  Also the whole concept of the RIFF/AVI file structure leads
	  to an object oriented approach.

	- The program has now an auto-split function (see
	  dvgrab --help): It will start a new file whenever (1) the
	  file size approaches 2 GByte (exceeds 0x70000000 bytes, to
	  be specific), (2) the frame count is exceeded, or (3) the
	  recording of a new scene is detected. The program will loop
	  forever until you press CTRL-C. The current AVI file will be
	  properly closed, so you don´t lose any data (at least this
	  is the plan).

	- Closing the file is now reasonably fast.

	- there is some visual feedback if the device driver drops
	  data.


Changes in version 0.5:

	- implemented the extended AVI file format which allows for
	  files > 1 GByte. Note that Linux is currently still limited
	  to a maximum file size of 2 GByte, which corresponds to
	  approx. 14500 frames for PAL format or 17500 frames for
	  NTSC format.

	- more comments in the source code  


Changes in version 0.4:

	- implemented the NTSC file format.

	- there is now an error handler which intercepts the signals
	  1, 2, 3 and 15 and attempts to properly close the AVI
	  file. So you can safely press CTRL-C to stop capturing
	  without losing the data saved so far.


Changes in version 0.3:

	- implemented the ´raw´ capturing mode, wich simply saves
	  the raw DV data to a file. Useful for analyzing the data.

	- tested with files up to 2000 frames (288 MByte)


Changes in version 0.2:

	- a basic set of command line options. 
	  Run 'dvgrab --help' for a list.

	- more error checking

	- more comments

	- tested with the latest ohci driver
	  (no changes were necessary though)

Changes in version 0.1:

	- first version