changelog

This library provides functionality to control any camera that conforms to the 1394-Based Digital C

2005-07-28 Damien <[e-mail]>
    * Interface harmonization (there's still some work to do)
	
2005-08-02 Damien <[e-mail]>
    * Now compiles with GCC-4.0
    * type for functions returns is now dc1394error_t (was int)

2005-08-04 Damien <[e-mail]>
    * fixed .c/.h coherency after a report from Irv Elshoff
    * version 2.0.0-pre4
	
2005-08-05 Damien <[e-mail]>
    * fixed wrong color filter definitions and functions (Tony Hague)

2005-08-10 Damien <[e-mail]>
    * fixed .c/.h coherency, again (Joshua Lamorie)

2005-08-17 Damien <[e-mail]>
    * added functions to grab all the properties of a format7 mode
      with a single call. This required the addition of new format7
      mode and modeset structures. The code of these functions comes
      from Coriander.

2005-08-18 Damien <[e-mail]>	
    * fixed memory leak in capture functions (dma device name not freed)
    * fixed trigger capabilities detection (Markus Niebel)
	
2005-08-30 Damien <[e-mail]>	
    * fixed the check of iidc 1.31 software version: probing the UDD should
      come before that.
    * fixed vendor/model strings: they are optional now (there seems to be a
      bug in Apple iSight rev 1.03 about this: two tags 0x81 are present but
      no 0x82 can be found)
    * Thanks to 'danalien' for the debug inputs.
	
2005-08-30 Damien <[e-mail]>
    * fixed invalid definition
	
2005-08-31 Damien <[e-mail]>
    * set several debug statements for testing with the iSight
	
2005-09-01 Damien <[e-mail]>
    * added debug modes in dc1394_register.h
    * fixed macro definitions: added braces around the code
    * removed debug statements introduced above.
    * added version definitions in dc1394_control.h
	
2005-09-09 Damien <[e-mail]>
    * fixed leak or invalid free with the dma_device_file (Johann Schoonees,
      Joshua Lamorie). Additional cleanups too.
    * _dc1394_basic_format7_setup() was called before setting port, etc. Fixed.

2005-09-09 Damien <[e-mail]>
    * fixed compilation errors. Duh!
    * removed debug by default (Joshua Lamorie)
    * include dc1394capture_t struct into dc1394camera_t struct. This avoids
      duplicate infomation (channel, port, node) but more importantly improves
      the interface by simplifying it a bit more.

2005-10-03 Damien <[e-mail]>
    * fixed bad array adressing in dc1394_format7_get_modeset()

2005-10-11 Damien <[e-mail]>
    * we were not looking at a non-initialized
      "camera->capture.dma_device_file" instead of the function argument
      "dma_device_file" (Thanks to Irv Elshoff)

2005-10-14 Damien <[e-mail]>
    * removed manual input of the video1394 device filename argument. The video
      device can be specified by a new function call before the setup: 
      dc1394_set_dma_device_filename(dc1394camera_t* camera, char *filename);
      If this call is not made the setup functions will try different common
      device names (/dev/video1394/x and /dev/video1394).
	
2005-10-16 Damien <[e-mail]>
    * fixed a memory leak in the camera detection

2005-10-29 Damien <[e-mail]>
    * fixed bad help message in grab_color_image (thanks to Hugo Costelha)

2005-12-02 Damien <[e-mail]>
    * fixed the headers and functions for software trigger access (thanks to
      Daniel Drake for spotting the bug)
    * use the 'restrict' C99 keyword for the conversion functions prototypes.
      (thanks to Frederic Devernay)
	
2005-12-10 Damien <[e-mail]>
    * new function to get the data depth of 16-bit video.
    * also check /dev/video1394-X when auto-opening the video1394 device file

2005-12-11 Damien <[e-mail]>
    * removed the frame_rate member of the capture struct: it was a simple copy
      of an input parameter.
    * the type of image buffers is uchat_t*, NOT uint_t*.
    * new functions to access the capture data (image buffer and fill time).
      The capture structure will removed from the API, but I don't know how
      yet.

2005-12-12 Damien <[e-mail]>
    * fixed the absolute settings.
	
2005-12-18 Damien <[e-mail]>
    * stronger typing: most enum types have now defined types, like
      dc1394framerate_t or dc1394video_mode_t
    * changed the video mode names from DC1394_MODE_xxx to
      DC1394_VIDEO_MODE_xxx

2005-12-19 Damien <[e-mail]>
    * start implementation of automatic ISO channel/bandwidth  allocation
    * updated configure script (we now require libraw1394 >= 1.2.0)
    * removed the old libraw1394 code since we need new stuff anyway.
	
2005-12-20 Damien <[e-mail]>
    * fixes concerning the auto ISO channel allocation
	
2005-12-21 Damien <[e-mail]>
    * Added VNG bayer decoding, thanks to Frederic Devernay. The trunk of
      the original code is from dcraw. It's very, very slow but looks nice.

2005-12-23 Damien <[e-mail]>
    * following a suggestion from Frederic Devernay, I have changed two things
      in the library installation:
      - the binaries are installed as libdc1394.a/la/so instead of 
	libdc1394_control.a/la/so.
      - the include files are now located in dc1394/ instead of libdc1394/
      This should allow simultaneous installation of the v1 and v2 libraries
      while sticking to the usual naming conventions. One more thing must be
      done: renaming the source files from dc1394_whatever.c/h to whatever.c/h.
      This requires a support request on SF so I don't do it at this time.
    * updarte some utility functions so that they work with format_7
	
2005-12-26 Damien <[e-mail]>
    * further hides formats. Only "video modes" are now visible, with the
      exception of "Format_7".
    * added a member 'color_coding' to dc1394formatmode_t.
    * updated conversion functions and cleanup their interface.

2005-12-27 Damien <[e-mail]>
    * update in the name conventions, notably replacing 'mode' by 'video mode'
      and 'color mode' by 'color coding', 'feature_id' by 'feature', etc...
    * more code cleanup and name changes
    * fixed a serious bug in feature detection. This was due to some macros
      that were changing the value of the feature_id argument, resulting in
      subsequent tests to be performed on features IDs like 2 or 3 or 15, while
      those should have been 418, 419 or 431. It dod not have much consequences
      thanks to most features falling into the 'default' section, but it killed
      the trigger stuff.

2006-01-03 Damien <[e-mail]>
    * fix missing "#ifdef __cplusplus", thanks to Boris Zingerman.
    
2006-01-10 Damien <[e-mail]>
    * fixed the order of size/position changes in _dc1394_basic_format7_setup
      thanks to Boris Zingerman.
    * added a test for Xv libraries.
    * dc1394_register.h is now exported.

2006-01-23 Damien <[e-mail]>
    * RAW8 and RAW16 formats are considered grayscale for conversion. If you
      want color you should run de-bayering before.

2006-01-25 Damien <[e-mail]>
    * cleaned up _dc1394_open_dma_device()
    * fixed dc1394_dma_release_camera()

2006-01-25 Damien <[e-mail]>
    * trigger modes > 3 added (4, 5, 14 and 15)
    * trigger source selection implemented
	
2006-02-07 Damien <[e-mail]>
    * force a DC1394_SLOW_DOWN delay even when the transaction returns
      successfuly Otherwise we can have too many requests following each other
      and the camera does not have time to adapt its ROM to reflect the changes
      made by the previous transaction. Thanks to Dirk Farin for finding this
      bug.
    * fixed a missing device assignement in _dc1394_open_dma_device. From Dirk
      Farin again ;-)

2006-02-12 Damien <[e-mail]>
    * upgraded grab_gray_image
	
2006-03-19 Damien <[e-mail]>
    * fixed broken link to "dc1394_internal.h" in dc1394_vendor_avt.h.
    * manual iso channel allocation is available. Iso channels handling
      was upgraded too.
    * release 2.0.0-pre6
	
2006-03-22 Damien <[e-mail]>
    * Applied a patch from Seemant Kulleen (replaces CLK_TCK with
      CLOCKS_PER_SEC)

2006-03-23 Damien <[e-mail]>
    * Capture functions have been simplified both in content and interface. One
      must now do the video settings before calling the capture_setup(_dma)
      functions. This allows F7 capture to be merged in the other capture
      functions. Oh, and names have been changed too ;-( Needless to say it's a
      compatibility break. Hopefuly the last big one.
    * A new function that sets up a format7 ROI is born from the ashes of the
      f7 capture function.
    * ISO channels and bandwidth are now allocated for RAW1394 too.
    * two more error handling macros have been added. The name of the macros
      have changed too. The macros are now:
	- DC1394_ERR (returns)
	- DC1394_ERR_RTN (returns an error code)
	- DC1394_ERR_CLN (execute cleanup function, then returns)
	- DC1394_ERR_CLN_RTN (cleanup followed by the return of an error code)
	
2006-03-24 Damien <[e-mail]>
    * fixed serious error with raw capture (garbled images of 1/4 size)
    * fixed grab_gray_image
    * merged dc1394_absolute.c in dc1394_control.c
    * a new function can be used to set a camera in broadcast mode.
    * functions that can influence capture settings are disabled (and return
      and error) if called while capture is set.
    * fixed the signedness of a few arguments of dc1394_format7_set_roi()
      (thanks to James Sherman)
    * properly free iso channel allocation if bandwidth allocation fails (James
      Sherman too)
	
2006-03-28 Damien <[e-mail]>
    * added missing dc1394_external_trigger_get_supported_sources()
    * this ChangeLog now respects the 80-columns format.

2006-03-31 Damien <[e-mail]>
    * fixed missing dc1394_free_cameras() in dc1394_find_cameras. Thanks to
      Jack Morrison for finding this bug.

2006-04-04 Damien <[e-mail]>
    * Add missing definition of dc1394_external_trigger_get_power() (the
      prototype was in the .h but nothing was in the .c!). Thanks to Diego Ruiz
      for the tip!

2006-04-07 Damien <[e-mail]>
    * applied a patch from Seemant Kulleen and Phil Lamoreaux which fixes the
      AVT mirroring function (it used to return DC1394_FAILURE everytime).

2006-04-24 Damien <[e-mail]>
    * fixed missing "#ifdef __cplusplus" in dc1394_register.h. THanks to Rober
      for bringing this to my attention.
	
2006-05-02 Damien <[e-mail]>
    * fixed a bug in AVT functions. Also added a check of the busy flag
      after setting the DSNU and BLEMISH controls.

2006-05-15 Damien <[e-mail]>
    * new vendor specific extensions for pixelink cameras thanks to Aravind
      Sundaresan and James Sherman.
	
2006-06-05 Damien <[e-mail]>
    * fixed a bug in the low-level access of absolute control registers. Thanks
      to David Moore for the patch.

2006-06-08 Damien <[e-mail]>
    * allow color filter access only when IIDC version is >= 1.31. Thanks to
      Alain Perrier.
    * missing #ifdef c++ added in dc1394_vendor_pixelink.h

2006-06-12 Damien <[e-mail]>
    * Important changes to allow compilation on other platforms (OSX comes in
      mind) Many thanks to David Moore for the phatt patch!

2006-07-04 Damien <[e-mail]>
    * fixed missing tranmission stop command in the examples, thanks to Diego
      Ruiz
	
2006-07-23 Damien <[e-mail]>
    * code cleanup
    * minor fixes
    * proper error codes are now returned
    * some new/changed/removed error codes
    * intriduced a new typedef replacing the drop-frames argument. We now use
      either DC1394_RING_BUFFER_NEXT or DC1394_RING_BUFFER_LAST
    * Oh yeah, and this is release RC1!!

2006-07-25 Damien <[e-mail]>
    * fixed serious issues concerning camera and feature detection

2006-07-25 Damien <[e-mail]>
    * removed autogen.sh. From now on you should use autoreconf instead.
    * small update of configure.in

2006-07-26 Brant Gurganus <[e-mail]>
    * Corrected Makefile.am in examples directory for VPATH builds
    * Updated more Autoconf macros to more non-obsolete variants

2006-07-31 David Moore <[e-mail]>
    * Major addition of Mac OS X control and capture functions

2006-08-02 Damien <[e-mail]>
    * remove debug output in channel allocations (Phil Lamoreaux)

2006-08-02 Damien <[e-mail]>
    * update the number of ports to 16, remove duplicate declaration
      (James Sherman)
	
2006-08-02 Damien <[e-mail]>
    * introduce missing dc1394_capture_get_frames_behind()
    * camera casting (camera > craw) in OSX changed to a macro.

2006-08-02 David Moore <[e-mail]>
    * Added the "update" mechanism to the Mac OS X NuDCL program according
      to suggestions from Apple engineers.
    * Added a few missing Mac OS X capture utility functions

2006-08-03 Damien <[e-mail]>
    * fixed invalid query of F7 color filter when a cam is not > IIDC 1.31
      (from David Moore)
	
2006-08-08 Damien <[e-mail]>
    * add PIO, SIO and strobe CSR register offset in dc1394camera_t. For
      future use.
    * following a suggestion of David Moore, don't allocate ISO/bandwidth in
      dc1394_video_set_transmission(). This way we can start the transmission
      from another program or a remote host.
    * release 2.0.0-rc3