• R/O
  • SSH

GM: Commit

Main GraphicsMagick source repository


Commit MetaInfo

Revision7895f5a8b9c59cf44daa244125ad68965ae75149 (tree)
Time2022-01-16 01:23:05
AuthorBob Friesenhahn <bfriesen@Grap...>
CommiterBob Friesenhahn

Log Message

Add more documentation regarding HEIF/HVEC support.

Change Summary

Incremental Difference

diff -r 1aece932bb29 -r 7895f5a8b9c5 ChangeLog
--- a/ChangeLog Fri Jan 14 18:08:18 2022 -0600
+++ b/ChangeLog Sat Jan 15 10:23:05 2022 -0600
@@ -1,3 +1,10 @@
1+2022-01-15 Bob Friesenhahn <bfriesen@simple.dallas.tx.us>
2+
3+ * www/formats.rst: Add HEIF to the list of supported formats.
4+
5+ * README.txt: Expand the text regarding support for HEIF/HVEC
6+ support.
7+
18 2022-01-14 Bob Friesenhahn <bfriesen@simple.dallas.tx.us>
29
310 * coders/heif.c: HEIF reader written by Tobias Mark. From
diff -r 1aece932bb29 -r 7895f5a8b9c5 README.txt
--- a/README.txt Fri Jan 14 18:08:18 2022 -0600
+++ b/README.txt Sat Jan 15 10:23:05 2022 -0600
@@ -362,24 +362,42 @@
362362
363363 * GraphicsMagick requires the Zstandard (Zstd) library from
364364
365- https://facebook.github.io/zstd/
365+ https://facebook.github.io/zstd/
366366
367- or
367+ or
368368
369- https://github.com/facebook/zstd/releases
369+ https://github.com/facebook/zstd/releases
370370
371371 to read or write Zstd compressed TIFF images. In the future it is
372372 likely that other purposes will be found for Zstd.
373373
374374 * GraphicsMagick may require the deflate library to link with libtiff.
375375
376- Libtiff may optionally depend on the libdeflate library (from
377- https://github.com/ebiggers/libdeflate). Linking with this
378- library may be necessary for builds where libtiff depends on
379- libdeflate.
376+ Libtiff may optionally depend on the libdeflate library (from
377+ https://github.com/ebiggers/libdeflate). Linking with this library
378+ may be necessary for builds where libtiff depends on libdeflate.
380379
381380 * GraphicsMagick requires the heif library from
382381
383382 https://github.com/strukturag/libheif
384383
385- to read heif/heic files.
384+ and the libde265 library from
385+
386+ https://github.com/strukturag/libde265
387+
388+ to read HEIF/h.265 files. Libheif makes use of libde265 for
389+ h.265/HEVC decoding and libx265 for encoding. GraphicsMagick does
390+ not itself provide any h.265/HEVC algoriths and it does not
391+ currently support encoding.
392+
393+ The HEVC codec is covered by a huge number of patents (the MPEG LA
394+ HEVC patent list is 164 pages long!). While GraphicsMagick is
395+ unable to grant any patent usage rights to users or offer legal
396+ advice, HEVC patents are normally paid for "per device" and so it is
397+ possible and even likely that the user's modern "device" is already
398+ covered. For example, users of Windows 10, Apple's OS-X, or popular
399+ video cards may already be entitled to use the HEVC codec since the
400+ vendor has already paid for it. Some countries do not support
401+ software patents. The user is responsible for assuring that some
402+ entity has paid to allow use of any applicable HEVC patents on their
403+ device, or that the patents do not apply in their country.
diff -r 1aece932bb29 -r 7895f5a8b9c5 VisualMagick/installer/inc/version.isx
--- a/VisualMagick/installer/inc/version.isx Fri Jan 14 18:08:18 2022 -0600
+++ b/VisualMagick/installer/inc/version.isx Sat Jan 15 10:23:05 2022 -0600
@@ -10,5 +10,5 @@
1010
1111 #define public MagickPackageName "GraphicsMagick"
1212 #define public MagickPackageVersion "1.4"
13-#define public MagickPackageVersionAddendum ".020220114"
14-#define public MagickPackageReleaseDate "snapshot-20220114"
13+#define public MagickPackageVersionAddendum ".020220115"
14+#define public MagickPackageReleaseDate "snapshot-20220115"
diff -r 1aece932bb29 -r 7895f5a8b9c5 magick/version.h
--- a/magick/version.h Fri Jan 14 18:08:18 2022 -0600
+++ b/magick/version.h Sat Jan 15 10:23:05 2022 -0600
@@ -38,8 +38,8 @@
3838 #define MagickLibVersion 0x262300
3939 #define MagickLibVersionText "1.4"
4040 #define MagickLibVersionNumber 26,23,0
41-#define MagickChangeDate "20220114"
42-#define MagickReleaseDate "snapshot-20220114"
41+#define MagickChangeDate "20220115"
42+#define MagickReleaseDate "snapshot-20220115"
4343
4444 /*
4545 The MagickLibInterfaceNewest and MagickLibInterfaceOldest defines
diff -r 1aece932bb29 -r 7895f5a8b9c5 www/Changelog.html
--- a/www/Changelog.html Fri Jan 14 18:08:18 2022 -0600
+++ b/www/Changelog.html Sat Jan 15 10:23:05 2022 -0600
@@ -35,6 +35,12 @@
3535 <div class="document">
3636
3737
38+<p>2022-01-15 Bob Friesenhahn &lt;<a class="reference external" href="mailto:bfriesen&#37;&#52;&#48;simple&#46;dallas&#46;tx&#46;us">bfriesen<span>&#64;</span>simple<span>&#46;</span>dallas<span>&#46;</span>tx<span>&#46;</span>us</a>&gt;</p>
39+<blockquote>
40+<p>* www/formats.rst: Add HEIF to the list of supported formats.</p>
41+<p>* README.txt: Expand the text regarding support for HEIF/HVEC
42+support.</p>
43+</blockquote>
3844 <p>2022-01-14 Bob Friesenhahn &lt;<a class="reference external" href="mailto:bfriesen&#37;&#52;&#48;simple&#46;dallas&#46;tx&#46;us">bfriesen<span>&#64;</span>simple<span>&#46;</span>dallas<span>&#46;</span>tx<span>&#46;</span>us</a>&gt;</p>
3945 <blockquote>
4046 <p>* coders/heif.c: HEIF reader written by Tobias Mark. From
diff -r 1aece932bb29 -r 7895f5a8b9c5 www/README.html
--- a/www/README.html Fri Jan 14 18:08:18 2022 -0600
+++ b/www/README.html Sat Jan 15 10:23:05 2022 -0600
@@ -390,25 +390,40 @@
390390 <li><p class="first">GraphicsMagick requires the Zstandard (Zstd) library from</p>
391391 <blockquote>
392392 <p><a class="reference external" href="https://facebook.github.io/zstd/">https://facebook.github.io/zstd/</a></p>
393+<blockquote>
393394 <p>or</p>
395+</blockquote>
394396 <p><a class="reference external" href="https://github.com/facebook/zstd/releases">https://github.com/facebook/zstd/releases</a></p>
395397 </blockquote>
396398 <p>to read or write Zstd compressed TIFF images. In the future it is
397399 likely that other purposes will be found for Zstd.</p>
398400 </li>
399401 <li><p class="first">GraphicsMagick may require the deflate library to link with libtiff.</p>
400-<blockquote>
401402 <p>Libtiff may optionally depend on the libdeflate library (from
402-<a class="reference external" href="https://github.com/ebiggers/libdeflate">https://github.com/ebiggers/libdeflate</a>). Linking with this
403-library may be necessary for builds where libtiff depends on
404-libdeflate.</p>
405-</blockquote>
403+<a class="reference external" href="https://github.com/ebiggers/libdeflate">https://github.com/ebiggers/libdeflate</a>). Linking with this library
404+may be necessary for builds where libtiff depends on libdeflate.</p>
406405 </li>
407406 <li><p class="first">GraphicsMagick requires the heif library from</p>
408407 <blockquote>
409408 <p><a class="reference external" href="https://github.com/strukturag/libheif">https://github.com/strukturag/libheif</a></p>
410-<p>to read heif/heic files.</p>
409+<p>and the libde265 library from</p>
410+<p><a class="reference external" href="https://github.com/strukturag/libde265">https://github.com/strukturag/libde265</a></p>
411411 </blockquote>
412+<p>to read HEIF/h.265 files. Libheif makes use of libde265 for
413+h.265/HEVC decoding and libx265 for encoding. GraphicsMagick does
414+not itself provide any h.265/HEVC algoriths and it does not
415+currently support encoding.</p>
416+<p>The HEVC codec is covered by a huge number of patents (the MPEG LA
417+HEVC patent list is 164 pages long!). While GraphicsMagick is
418+unable to grant any patent usage rights to users or offer legal
419+advice, HEVC patents are normally paid for &quot;per device&quot; and so it is
420+possible and even likely that the user's modern &quot;device&quot; is already
421+covered. For example, users of Windows 10, Apple's OS-X, or popular
422+video cards may already be entitled to use the HEVC codec since the
423+vendor has already paid for it. Some countries do not support
424+software patents. The user is responsible for assuring that some
425+entity has paid to allow use of any applicable HEVC patents on their
426+device, or that the patents do not apply in their country.</p>
412427 </li>
413428 </ul>
414429 </div>
diff -r 1aece932bb29 -r 7895f5a8b9c5 www/formats.html
--- a/www/formats.html Fri Jan 14 18:08:18 2022 -0600
+++ b/www/formats.html Sat Jan 15 10:23:05 2022 -0600
@@ -261,6 +261,15 @@
261261 <td>Use -size, -depth, and -endian to specify the
262262 image width, height, depth, and byte order.</td>
263263 </tr>
264+<tr><td><a class="reference external" href="https://en.wikipedia.org/wiki/High_Efficiency_Image_File_Format">HEIF</a></td>
265+<td>R</td>
266+<td>High Efficiency Image
267+File Format (with
268+h.265/HEVC encoding)</td>
269+<td>HEIF is a container format supporting multiple
270+codecs. HEIF with h.265/HEVC encoding
271+is supported via libheif and libde265.</td>
272+</tr>
264273 <tr><td>HPGL</td>
265274 <td>R</td>
266275 <td>HP-GL plotter language</td>
diff -r 1aece932bb29 -r 7895f5a8b9c5 www/formats.rst
--- a/www/formats.rst Fri Jan 14 18:08:18 2022 -0600
+++ b/www/formats.rst Sat Jan 15 10:23:05 2022 -0600
@@ -31,6 +31,7 @@
3131 .. _Ghostscript : http://pages.cs.wisc.edu/~ghost/
3232 .. _GIF : http://www.fileformat.info/format/gif/egff.htm
3333 .. _`Hald CLUT` : http://www.quelsolaar.com/technology/clut.html
34+.. _HEIF : https://en.wikipedia.org/wiki/High_Efficiency_Image_File_Format
3435 .. _JBIG : http://www.jpeg.org/
3536 .. _JNG : http://www.libmng.com/
3637 .. _JPEG : http://www.jpeg.org/
@@ -192,6 +193,10 @@
192193 | GRAYA | RW | Raw gray samples + alpha | Use -size, -depth, and -endian to specify the |
193194 | | | | image width, height, depth, and byte order. |
194195 +--------------+------+---------------------------+--------------------------------------------------+
196+ | HEIF_ | R | High Efficiency Image | HEIF is a container format supporting multiple |
197+ | | | File Format (with | codecs. HEIF with h.265/HEVC encoding |
198+ | | | h.265/HEVC encoding) | is supported via libheif and libde265. |
199+ +--------------+------+---------------------------+--------------------------------------------------+
195200 | HPGL | R | HP-GL plotter language | Requires hp2xx_ 3.2.0 or later |
196201 +--------------+------+---------------------------+--------------------------------------------------+
197202 | | | Hypertext Markup Language | |
Show on old repository browser