GraphicsMagick: 2 new changesets
GraphicsMagick Commits <[email protected]> Sat, 16 Mar 2024 10:52:51 -0500
| Newsgroups | gmane.comp.video.graphicsmagick.cvs |
|---|---|
| Message-ID | <mailman.3227.1710604391.7795.graphicsmagick-commit@lists.sourceforge.net> |
changeset 86ef5ece9e47 in /hg/GraphicsMagick details: http://hg.GraphicsMagick.org/hg/GraphicsMagick?cmd=3Dchangeset;nod= e=3D86ef5ece9e47 summary: Fix spelling errors and out-of-date information in types.rst changeset 5d3812a1ee77 in /hg/GraphicsMagick details: http://hg.GraphicsMagick.org/hg/GraphicsMagick?cmd=3Dchangeset;nod= e=3D5d3812a1ee77 summary: Fix spelling errors and out-of-date information in types.rst diffstat: ChangeLog | 6 + VisualMagick/installer/inc/version.isx | 4 +- magick/version.h | 4 +- www/ChangeLog.html | 8 + www/api/types.html | 301 ++++++++++++++++++----------= ---- www/api/types.rst | 239 +++++++++++++------------ 6 files changed, 312 insertions(+), 250 deletions(-) diffs (truncated from 1427 to 500 lines): diff -r ee005758e1a6 -r 5d3812a1ee77 ChangeLog --- a/ChangeLog Fri Mar 15 08:49:55 2024 -0500 +++ b/ChangeLog Sat Mar 16 10:51:53 2024 -0500 @@ -1,3 +1,9 @@ +2024-03-16 Bob Friesenhahn <[email protected]> + + * www/api/types.rst: Fix spelling errors and out-of-date + information in types.rst. Resolves SourceForge patch #80 "Update + types.rst documentation". + 2024-03-15 Bob Friesenhahn <[email protected]> = * wand/magick_wand.c (MagickPingImage, MagickReadImage) diff -r ee005758e1a6 -r 5d3812a1ee77 VisualMagick/installer/inc/version.isx --- a/VisualMagick/installer/inc/version.isx Fri Mar 15 08:49:55 2024 -0500 +++ b/VisualMagick/installer/inc/version.isx Sat Mar 16 10:51:53 2024 -0500 @@ -10,5 +10,5 @@ = #define public MagickPackageName "GraphicsMagick" #define public MagickPackageVersion "1.4" -#define public MagickPackageVersionAddendum ".020240315" -#define public MagickPackageReleaseDate "snapshot-20240315" +#define public MagickPackageVersionAddendum ".020240316" +#define public MagickPackageReleaseDate "snapshot-20240316" diff -r ee005758e1a6 -r 5d3812a1ee77 magick/version.h --- a/magick/version.h Fri Mar 15 08:49:55 2024 -0500 +++ b/magick/version.h Sat Mar 16 10:51:53 2024 -0500 @@ -38,8 +38,8 @@ #define MagickLibVersion 0x272404 #define MagickLibVersionText "1.4" #define MagickLibVersionNumber 27,24,4 -#define MagickChangeDate "20240315" -#define MagickReleaseDate "snapshot-20240315" +#define MagickChangeDate "20240316" +#define MagickReleaseDate "snapshot-20240316" = /* The MagickLibInterfaceNewest and MagickLibInterfaceOldest defines diff -r ee005758e1a6 -r 5d3812a1ee77 www/ChangeLog.html --- a/www/ChangeLog.html Fri Mar 15 08:49:55 2024 -0500 +++ b/www/ChangeLog.html Sat Mar 16 10:51:53 2024 -0500 @@ -38,6 +38,14 @@ = <div class=3D"document" id=3D"graphicsmagick-changelog"> <h1 class=3D"title">GraphicsMagick ChangeLog</h1> +<p>2024-03-16 Bob Friesenhahn <<a class=3D"reference external" href= =3D"mailto:bfriesen%40simple.dallas.tx.us">bfriesen= <span>@</span>simple<span>.</span>dallas<span>.</span>tx<span>&= #46;</span>us</a>></p> +<blockquote> +<ul class=3D"simple"> +<li><p>www/api/types.rst: Fix spelling errors and out-of-date +information in types.rst. Resolves SourceForge patch #80 "Update +types.rst documentation".</p></li> +</ul> +</blockquote> <p>2024-03-15 Bob Friesenhahn <<a class=3D"reference external" href= =3D"mailto:bfriesen%40simple.dallas.tx.us">bfriesen= <span>@</span>simple<span>.</span>dallas<span>.</span>tx<span>&= #46;</span>us</a>></p> <blockquote> <ul class=3D"simple"> diff -r ee005758e1a6 -r 5d3812a1ee77 www/api/types.html --- a/www/api/types.html Fri Mar 15 08:49:55 2024 -0500 +++ b/www/api/types.html Sat Mar 16 10:51:53 2024 -0500 @@ -191,7 +191,7 @@ PixelPacket structures in RAM and/or in a disk file where color values are stored "directly". A PseudoClass representation of an image= is based on an array of IndexPacket values (also in RAM and/or in a disk -file ) which are the index values to the Image colormap (a small array +file) which are the index values to the Image colormap (a small array of PixelPacket values) where the color values corresponding to the pixel at the index are stored.</p> <p>It is possible for an image to be represented as DirectClass and @@ -257,13 +257,13 @@ <p>The ColorspaceType enumeration is used to specify the colorspace that quantization (color reduction and mapping) is done under or to specify the colorspace when encoding an output image. Colorspaces are ways of -describing colors to fit the requirements of a particular application -(e.g. Television, offset printing, color monitors). Color reduction, by -default, takes place in the RGBColorspace. Empirical evidence suggests +describing colors to fit the requirements of a particular application, +such as television, offset printing, and color monitors. Color reduction, +by default, takes place in the RGBColorspace. Empirical evidence suggests that distances in color spaces such as YUVColorspace or YIQColorspace -correspond to perceptual color differences more closely han do distances -in RGB space. These color spaces may give better results when color -reducing an image. Refer to quantize for more details.</p> +correspond to perceptual color differences more closely than do distances +in RGB space. These color spaces may give better results when reducing the +color of an image. Refer to <a class=3D"reference external" href=3D"quanti= ze.html">quantize</a> for more details.</p> <p>When encoding an output image, the colorspaces RGBColorspace, CMYKColorspace, and GRAYColorspace may be specified. The CMYKColorspace option is only applicable when writing TIFF, JPEG, and Adobe Photoshop @@ -363,12 +363,12 @@ pixel. Specify CompositeOperator to select a different algorithm.</p> <p>The image compositor requires a matte, or alpha channel in the image for some operations. This extra channel usually defines a mask which -represents a sort of a cookie-cutter for the image. This is the case when +represents a sort of cookie-cutter for the image. This is the case when matte is 255 (full coverage) for pixels inside the shape, zero outside, and between zero and 255 on the boundary. For certain operations, if image does not have a matte channel, it is initialized with 0 for any pixel matching in color to pixel location (0,0), otherwise 255 (to work -properly borderWidth must be 0).</p> +properly, borderWidth must be 0).</p> <table> <caption>CompositeOperator</caption> <colgroup> @@ -426,6 +426,10 @@ <td><p>The result of abs(composite image - image). This is useful for comp= aring two very similar images.</p></td> </tr> +<tr><td><p>MultiplyCompositeOp</p></td> +<td><p>The result of composite image =D7 image. This is useful for the cre= ation of +drop-shadows.</p></td> +</tr> <tr><td><p>BumpmapCompositeOp</p></td> <td><p>The result image shaded by composite image.</p></td> </tr> @@ -486,10 +490,10 @@ <td><p>Copy Brightness channel (from HSL colorspace).</p></td> </tr> <tr><td><p>ScreenCompositeOp</p></td> -<td><p>[Not yet implemented]</p></td> +<td></td> </tr> <tr><td><p>OverlayCompositeOp</p></td> -<td><p>[Not yet implemented]</p></td> +<td></td> </tr> <tr><td><p>CopyCyanCompositeOp</p></td> <td><p>Copy the Cyan channel.</p></td> @@ -506,16 +510,49 @@ <tr><td><p>DivideCompositeOp</p></td> <td></td> </tr> +<tr><td><p>HardLightCompositeOp</p></td> +<td></td> +</tr> +<tr><td><p>ExclusionCompositeOp</p></td> +<td></td> +</tr> +<tr><td><p>ColorDodgeCompositeOp</p></td> +<td></td> +</tr> +<tr><td><p>ColorBurnCompositeOp</p></td> +<td></td> +</tr> +<tr><td><p>SoftLightCompositeOp</p></td> +<td></td> +</tr> +<tr><td><p>LinearBurnCompositeOp</p></td> +<td></td> +</tr> +<tr><td><p>LinearDodgeCompositeOp</p></td> +<td></td> +</tr> +<tr><td><p>LinearLightCompositeOp</p></td> +<td></td> +</tr> +<tr><td><p>VividLightCompositeOp</p></td> +<td></td> +</tr> +<tr><td><p>PinLightCompositeOp</p></td> +<td></td> +</tr> +<tr><td><p>HardMixCompositeOp</p></td> +<td></td> +</tr> </tbody> </table> </div> <div class=3D"section" id=3D"compressiontype"> <h1><a class=3D"toc-backref" href=3D"#id12">CompressionType</a></h1> -<p>CompressionType is used to express the desired compression type when -encoding an image. Be aware that most image types only support a sub-set -of the available compression types. If the compression type specified is -incompatable with the image, GraphicsMagick selects a compression type -compatable with the image type, which might be no compression at all.</p> +<p>CompressionType is used to specify the desired compression type when +encoding an image. Be aware that most image types only support a subset +of the available compression types. If the specified compression type is +incompatible with the image, GraphicsMagick will select a compression type +compatible with the image type, which might be no compression at all.</p> <table> <caption>CompressionType</caption> <colgroup> @@ -644,10 +681,6 @@ <td><p>PixelPacket</p></td> <td><p>Border color</p></td> </tr> -<tr><td><p>box</p></td> -<td><p>PixelPacket</p></td> -<td><p>Text solid background color.</p></td> -</tr> <tr><td><p>decorate</p></td> <td><p>DecorationType</p></td> <td><p>Text decoration type.</p></td> @@ -897,11 +930,11 @@ </div> <div class=3D"section" id=3D"endiantype"> <h1><a class=3D"toc-backref" href=3D"#id16">EndianType</a></h1> -<p>Some formats (e.g. TIFF and DPX) allow storing data in multiple -"endian" orders and EndianType allows controlling that. With MSB +<p>Some formats, such as TIFF and DPX, allow storing data in multiple +"endian" orders and EndianType allows controlling that. With MSB endian and accessing memory bytes with increasing offset, the most -significant bytes are encountered first, while with LSB endian, the -least significant bytes are encountered first.</p> +significant byte is encountered first, while with LSB endian, the +least significant byte is encountered first.</p> <pre class=3D"literal-block">typedef enum { UndefinedEndian, @@ -1012,12 +1045,11 @@ <p>FilterTypes is used to adjust the filter algorithm used when resizing images. Different filters experience varying degrees of success with various images and can take significantly different amounts of processing -time. GraphicsMagick uses the LanczosFilter by default since this filter -has been shown to provide the best results for most images in a -reasonable amount of time. Other filter types (e.g. TriangleFilter) may -execute much faster but may show artifacts when the image is re-sized or -around diagonal lines. The only way to be sure is to test the filter with -sample images.</p> +time. GraphicsMagick defaults to using the LanczosFilter, which has been +proven to provide the best results for most images in a reasonable amount +of time. Other filter types, such as the TriangleFilter, may execute much = faster +but may show artifacts when the image is resized or around diagonal lines. +The only way to be sure is to test the filter with sample images.</p> <table> <caption>FilterTypes</caption> <colgroup> @@ -1096,8 +1128,8 @@ </div> <div class=3D"section" id=3D"gravitytype"> <h1><a class=3D"toc-backref" href=3D"#id23">GravityType</a></h1> -<p>GravityType specifies positioning of an object (e.g. text, image) within -a bounding region (e.g. an image). Gravity provides a convenient way to +<p>GravityType specifies positioning of an object, such as text or an imag= e, +within a bounding region. Gravity provides a convenient way to locate objects irrespective of the size of the bounding region, in other words, you don't need to provide absolute coordinates in order to position an object. A common default for gravity is NorthWestGravity.</p> @@ -1373,7 +1405,7 @@ Otherwise the colorspace is ignored.</p></td> </tr> <tr><td><p>columns</p></td> -<td><p>unsigned int</p></td> +<td><p>unsigned long</p></td> <td><p>Image width</p></td> </tr> <tr><td><p>compression</p></td> @@ -1382,7 +1414,7 @@ compression type of the specified image file.</p></td> </tr> <tr><td><p>delay</p></td> -<td><p>unsigned int</p></td> +<td><p>unsigned long</p></td> <td><p>Time in 1/100ths of a second (0 to 65535) which must expire before displaying the next image in an animated sequence. This option is useful for @@ -1401,12 +1433,16 @@ MIFF file which contains a directory.</p></td> </tr> <tr><td><p>dispose</p></td> -<td><p>unsigned int</p></td> +<td><p>DisposeType</p></td> <td><p>GIF disposal method. This option is used to control how successive frames are rendered (how the preceding frame is disposed of) when creating a GIF animation.</p></td> </tr> +<tr><td><p>endian</p></td> +<td><p>EndianType</p></td> +<td><p>The byte order to use when writing images.</p></td> +</tr> <tr><td><p>exception</p></td> <td><p>ExceptionInfo</p></td> <td><p>Record of any error which occurred when updating @@ -1427,7 +1463,7 @@ reducing most images.</p></td> </tr> <tr><td><p>fuzz</p></td> -<td><p>int</p></td> +<td><p>double</p></td> <td><p>Colors within this distance are considered equal. A number of algorithms search for a target color. By default the color must be exact. Use this @@ -1446,6 +1482,10 @@ <td><p>char *</p></td> <td><p>Preferred size of the image when encoding.</p></td> </tr> +<tr><td><p>gravity</p></td> +<td><p>GravityType</p></td> +<td><p>Positioning of the image within a bounding region.</p></td> +</tr> <tr><td><p>interlace</p></td> <td><p>InterlaceType</p></td> <td><p>The type of interlacing scheme (default @@ -1462,7 +1502,7 @@ image.</p></td> </tr> <tr><td><p>iterations</p></td> -<td><p>unsigned int</p></td> +<td><p>unsigned long</p></td> <td><p>Number of iterations to loop an animation (e.g. Netscape loop extension) for.</p></td> </tr> @@ -1472,7 +1512,7 @@ <td><p>Image encoding format (e.g. "GIF").</p></td> </tr> <tr><td><p>magick_columns</p></td> -<td><p>unsigned int</p></td> +<td><p>unsigned long</p></td> <td><p>Base image width (before transformations)</p></td> </tr> <tr><td><p>magick_filename</p></td> @@ -1481,12 +1521,12 @@ <td><p>Base image filename (before transformations)</p></td> </tr> <tr><td><p>magick_rows</p></td> -<td><p>unsigned int</p></td> +<td><p>unsigned long</p></td> <td><p>Base image height (before transformations)</p></td> </tr> <tr><td><p>matte</p></td> -<td><p>unsigned int</p></td> -<td><p>If non-zero, then the index member of pixels +<td><p>MagickBool</p></td> +<td><p>If true, then the index member of pixels represents the alpha channel.</p></td> </tr> <tr><td><p>matte_color</p></td> @@ -1503,7 +1543,7 @@ <td><p>Next image frame in sequence</p></td> </tr> <tr><td><p>offset</p></td> -<td><p>int</p></td> +<td><p>long</p></td> <td><p>Number of initial bytes to skip over when reading raw image.</p></td> </tr> @@ -1525,13 +1565,17 @@ <td><p>The type of rendering intent.</p></td> </tr> <tr><td><p>rows</p></td> -<td><p>unsigned int</p></td> +<td><p>unsigned long</p></td> <td><p>Image height</p></td> </tr> <tr><td><p>scene</p></td> -<td><p>unsigned int</p></td> +<td><p>unsigned long</p></td> <td><p>Image frame scene number.</p></td> </tr> +<tr><td><p>start_loop</p></td> +<td><p>long</p></td> +<td><p>Animation frame number to start looping at.</p></td> +</tr> <tr><td><p>storage_class</p></td> <td><p>ClassType</p></td> <td><p>Image storage class. If DirectClass then the image @@ -1579,8 +1623,8 @@ functions AllocateImage(), AnimateImages(), BlobToImage(), CloneAnnotateInfo(), DisplayImages(), GetAnnotateInfo(), ImageToBlob(), PingImage(), ReadImage(), ReadImages(), and, WriteImage(). These -functions update information in ImageInfo to reflect attributes of the -current image.</p> +functions update information in ImageInfo to reflect the attributes of +the current image.</p> <p>Use CloneImageInfo() to duplicate an existing ImageInfo structure or allocate a new one. Use DestroyImageInfo() to deallocate memory associated with an ImageInfo structure. Use GetImageInfo() to initialize @@ -1600,11 +1644,11 @@ <td><p>Description</p></td> </tr> <tr><td><p>adjoin</p></td> -<td><p>unsigned int</p></td> +<td><p>MagickBool</p></td> <td><p>Join images into a single multi-image file.</p></td> </tr> <tr><td><p>antialias</p></td> -<td><p>unsigned int</p></td> +<td><p>MagickBool</p></td> <td><p>Control antialiasing of rendered Postscript and Postscript or TrueType fonts. Enabled by default.</p></td> </tr> @@ -1628,13 +1672,6 @@ <td><p>Image compresion type. The default is the compression type of the specified image file.</p></td> </tr> -<tr><td><p>delay</p></td> -<td><p>char *</p></td> -<td><p>Time in 1/100ths of a second (0 to 65535) which must expire before -displaying the next image in an animated sequence. This option is -useful for regulating the animation of a sequence of GIF images -within Netscape.</p></td> -</tr> <tr><td><p>density</p></td> <td><p>char *</p></td> <td><p>Vertical and horizontal resolution in pixels of the image. This @@ -1642,18 +1679,12 @@ Portable Document page. Often used with page.</p></td> </tr> <tr><td><p>depth</p></td> -<td><p>unsigned int</p></td> +<td><p>unsigned long</p></td> <td><p>Image depth (8 or 16). QuantumLeap must be defined before a depth of 16 is valid.</p></td> </tr> -<tr><td><p>dispose</p></td> -<td><p>char *</p></td> -<td><p>GIF disposal method. This option is used to control how successive -frames are rendered (how the preceding frame is disposed of) when -creating a GIF animation.</p></td> -</tr> <tr><td><p>dither</p></td> -<td><p>unsigned int</p></td> +<td><p>MagickBool</p></td> <td><p>Apply Floyd/Steinberg error diffusion to the image. The basic strategy of dithering is to trade intensity resolution for spatial resolution by averaging the intensities of several neighboring @@ -1673,10 +1704,6 @@ [MaxTextExtent]</p></td> <td><p>Image file name to read or write.</p></td> </tr> -<tr><td><p>fill</p></td> -<td><p>PixelPacket</p></td> -<td><p>Drawing object fill color.</p></td> -</tr> <tr><td><p>font</p></td> <td><p>char *</p></td> <td><p>Text rendering font. If the font is a fully qualified X server font @@ -1685,7 +1712,7 @@ Postscript font name (e.g. "helvetica").</p></td> </tr> <tr><td><p>fuzz</p></td> -<td><p>int</p></td> +<td><p>double</p></td> <td><p>Colors within this distance are considered equal. A number of algorithms search for a target color. By default the color must be exact. Use this option to match colors that are close to the target @@ -1702,15 +1729,6 @@ image.G, and image.B). Use LineInterlace or PlaneInterlace to create an interlaced GIF or progressive JPEG image.</p></td> </tr> -<tr><td><p>iterations</p></td> -<td><p>char *</p></td> -<td><p>Number of iterations to loop an animation (e.g. Netscape loop -extension) for.</p></td> -</tr> -<tr><td><p>linewidth</p></td> -<td><p>unsigned int</p></td> -<td><p>Line width for drawing lines, circles, ellipses, etc.</p></td> -</tr> <tr><td><p>magick</p></td> <td><p>char [MaxTextExtent]</p></td> @@ -1721,30 +1739,23 @@ <td><p>Image matte (transparent) color.</p></td> </tr> <tr><td><p>monochrome</p></td> -<td><p>unsigned int</p></td> +<td><p>MagickBool</p></td> <td><p>Transform the image to black and white.</p></td> </tr> <tr><td><p>page</p></td> <td><p>char *</p></td> <td><p>Equivalent size of Postscript page.</p></td> </tr> -<tr><td><p>ping</p></td> -<td><p>unsigned int</p></td> -<td><p>Set to True to read enough of the image to determine the image -columns, rows, and filesize. The columns, rows, and size attributes -are valid after invoking ReadImage() while ping is set. The image -data is not valid after calling ReadImage() if ping is set.</p></td> +<tr><td><p>pen</p></td> +<td><p>PixelPacket</p></td> +<td><p>Drawing object stroke or fill color.</p></td> </tr> <tr><td><p>pointsize</p></td> <td><p>double</p></td> <td><p>Text rendering font point size.</p></td> </tr> -<tr><td><p>preview_type</p></td> -<td><p>PreviewType</p></td> -<td><p>Image manipulation preview option. Used by 'display'.</p></td> -</tr> <tr><td><p>quality</p></td> -<td><p>unsigned int</p></td> +<td><p>unsigned long</p></td> <td><p>JPEG/MIFF/PNG compression level (default 75).</p></td> </tr> <tr><td><p>server_name</p></td> @@ -1756,19 +1767,15 @@ <td><p>char *</p></td> <td><p>Width and height of a raw image (an image which does not support width and height information). Size may also be used to affect the -image size read from a multi-resolution format (e.g. Photo CD, +image size read from a multi-resolution format, such as Photo CD, JBIG, or JPEG.</p></td> </tr> -<tr><td><p>stroke</p></td> -<td><p>PixelPacket</p></td> -<td><p>Drawing object outline color.</p></td>