dmtools 0.5.0 (December 2021) Release Notes

dmtools is still in a state of rapid development. During this time, there is no
promise of backwards compatibility between versions. The intent is to have
monthly releases during this period to make the new tools and bug fixes
available quickly. This release includes a variety of new funcionality and
tools (summarized below). Additionally, there was significant effort to improve
the quality of documentation. The README was updated, new tutorials were added,
and there is now a mechanism to check correctness of example scripts.

Deprecations:
  - The write_ascii function was moved to the io module. As a result, the ascii
    module was removed.

New Functionality:
  - Provide image metadata when writing (based on PNG metadata). Most notably,
    the souce code of the script is written to the metadata by default.
  - Function for recovering the script from the metadata of an image.
  - Support for 4-channel images: 3 color channels and 1 alpha channel.
  - Versioning support for image write functions: automatically increment the
    version number of an image if there are duplicates found.

New Tools:
  - transform.composite: Image alpha compositing (based on Cairo).
  - transform.crop: Crop an image using an (x,y) point, width, and height.
  - transform.substitute: Substitute a portion of an image.

dmtools 0.4.0 Release Notes

This release features a few substantial changes. The first major change is the
move from a standard image format of [0,255] to [0,1]. This eliminates the need
to keep track of an image's max gradient value allowing a NumPy array to be
sufficent in representing an image (ignoring colorspace which is still assumed
to be RGB). The io module also features significant changes / improvements.
The raw Netpbm file format now has better support and a general image read
function was added which supports Netpbm formats and PNG. This eliminates the
need for a special Netpbm class and the netpbm module which were deleted. The
last major change is the addition of the adjustments module which features a
function apply_curve which acts as a curves tool.

Outside of major changes and added functionality, there were a handful of minor
bug fixes as well as additional testing added to the testing suite.

dmtools 0.3.0 Release Notes

The Gaussian filter was added to the list of built-in filters. Furthermore,
this filter was used to implement a Gaussian blurring function called blur
which can blur an image to varying degrees. In addition, the clip, normalize,
and wraparound functions were added to get values of an image into range
before exporting to PNG. This addition stemmed from a change in convention in
which image modification algorithms are no longer responsible for maintaining
a valid PNG image. Lastly, this release includes a patch for the Catmull-Rom
filter which was incorrectly implemented.

dmtools 0.2.1 Release Notes

The minor changes in this release are
- scikit-image dependency removed in favor of custom rescale code
- specify clip argument in rescale function
- io module with read/write methods for png files (imageio wrapper)

dmtools 0.2.0 Release Notes

This release adds the transformation module which currently includes a rescale
function. The point, box, triangle, and Catmull-Rom rescaling filters are
included and the desired filter can be provided as a parameter to the rescale
function. Furthermore, one can explictly provide a weighting function and
support to define a custom filter used to rescale.

dmtools 0.1.3 Release Notes

This release addresses a bug in the initial v0.1.0 release where necessary
files in the resources directory were not included in the distribution. The
version was incremented more than once due to errors in the first two patches.

dmtools 0.1.0 Release Notes

This is the initial release for dmtools, a python package providing low-level
tools for working with digital media programmatically. This minimal initial
release includes the following modules:

- netpbm: read/write the Netpbm image format
- ascii: write ASCII images
- sound: write WAV audio format
- animation: write the MP4 video format
- colorspace: transform colorspaces of images
- arrange: create a grid of images

These modules mainly fall into one of two categories: modules that deal with
the reading and writing of a certain file format or modules that provide
functionality for transforming images, video, or audio.