| Revision | 7895f5a8b9c59cf44daa244125ad68965ae75149 (tree) |
|---|---|
| Time | 2022-01-16 01:23:05 |
| Author | Bob Friesenhahn <bfriesen@Grap...> |
| Commiter | Bob Friesenhahn |
Add more documentation regarding HEIF/HVEC support.
ChangeLog (diff)
README.txt (diff) VisualMagick/installer/inc/version.isx (diff)
magick/version.h (diff)
www/Changelog.html (diff) www/README.html (diff) www/formats.html (diff) www/formats.rst (diff)| @@ -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 | + | |
| 1 | 8 | 2022-01-14 Bob Friesenhahn <bfriesen@simple.dallas.tx.us> |
| 2 | 9 | |
| 3 | 10 | * coders/heif.c: HEIF reader written by Tobias Mark. From |
| @@ -362,24 +362,42 @@ | ||
| 362 | 362 | |
| 363 | 363 | * GraphicsMagick requires the Zstandard (Zstd) library from |
| 364 | 364 | |
| 365 | - https://facebook.github.io/zstd/ | |
| 365 | + https://facebook.github.io/zstd/ | |
| 366 | 366 | |
| 367 | - or | |
| 367 | + or | |
| 368 | 368 | |
| 369 | - https://github.com/facebook/zstd/releases | |
| 369 | + https://github.com/facebook/zstd/releases | |
| 370 | 370 | |
| 371 | 371 | to read or write Zstd compressed TIFF images. In the future it is |
| 372 | 372 | likely that other purposes will be found for Zstd. |
| 373 | 373 | |
| 374 | 374 | * GraphicsMagick may require the deflate library to link with libtiff. |
| 375 | 375 | |
| 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. | |
| 380 | 379 | |
| 381 | 380 | * GraphicsMagick requires the heif library from |
| 382 | 381 | |
| 383 | 382 | https://github.com/strukturag/libheif |
| 384 | 383 | |
| 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. |
| @@ -10,5 +10,5 @@ | ||
| 10 | 10 | |
| 11 | 11 | #define public MagickPackageName "GraphicsMagick" |
| 12 | 12 | #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" |
| @@ -38,8 +38,8 @@ | ||
| 38 | 38 | #define MagickLibVersion 0x262300 |
| 39 | 39 | #define MagickLibVersionText "1.4" |
| 40 | 40 | #define MagickLibVersionNumber 26,23,0 |
| 41 | -#define MagickChangeDate "20220114" | |
| 42 | -#define MagickReleaseDate "snapshot-20220114" | |
| 41 | +#define MagickChangeDate "20220115" | |
| 42 | +#define MagickReleaseDate "snapshot-20220115" | |
| 43 | 43 | |
| 44 | 44 | /* |
| 45 | 45 | The MagickLibInterfaceNewest and MagickLibInterfaceOldest defines |
| @@ -35,6 +35,12 @@ | ||
| 35 | 35 | <div class="document"> |
| 36 | 36 | |
| 37 | 37 | |
| 38 | +<p>2022-01-15 Bob Friesenhahn <<a class="reference external" href="mailto:bfriesen%40simple.dallas.tx.us">bfriesen<span>@</span>simple<span>.</span>dallas<span>.</span>tx<span>.</span>us</a>></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> | |
| 38 | 44 | <p>2022-01-14 Bob Friesenhahn <<a class="reference external" href="mailto:bfriesen%40simple.dallas.tx.us">bfriesen<span>@</span>simple<span>.</span>dallas<span>.</span>tx<span>.</span>us</a>></p> |
| 39 | 45 | <blockquote> |
| 40 | 46 | <p>* coders/heif.c: HEIF reader written by Tobias Mark. From |
| @@ -390,25 +390,40 @@ | ||
| 390 | 390 | <li><p class="first">GraphicsMagick requires the Zstandard (Zstd) library from</p> |
| 391 | 391 | <blockquote> |
| 392 | 392 | <p><a class="reference external" href="https://facebook.github.io/zstd/">https://facebook.github.io/zstd/</a></p> |
| 393 | +<blockquote> | |
| 393 | 394 | <p>or</p> |
| 395 | +</blockquote> | |
| 394 | 396 | <p><a class="reference external" href="https://github.com/facebook/zstd/releases">https://github.com/facebook/zstd/releases</a></p> |
| 395 | 397 | </blockquote> |
| 396 | 398 | <p>to read or write Zstd compressed TIFF images. In the future it is |
| 397 | 399 | likely that other purposes will be found for Zstd.</p> |
| 398 | 400 | </li> |
| 399 | 401 | <li><p class="first">GraphicsMagick may require the deflate library to link with libtiff.</p> |
| 400 | -<blockquote> | |
| 401 | 402 | <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> | |
| 406 | 405 | </li> |
| 407 | 406 | <li><p class="first">GraphicsMagick requires the heif library from</p> |
| 408 | 407 | <blockquote> |
| 409 | 408 | <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> | |
| 411 | 411 | </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 "per device" and so it is | |
| 420 | +possible and even likely that the user's modern "device" 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> | |
| 412 | 427 | </li> |
| 413 | 428 | </ul> |
| 414 | 429 | </div> |
| @@ -261,6 +261,15 @@ | ||
| 261 | 261 | <td>Use -size, -depth, and -endian to specify the |
| 262 | 262 | image width, height, depth, and byte order.</td> |
| 263 | 263 | </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> | |
| 264 | 273 | <tr><td>HPGL</td> |
| 265 | 274 | <td>R</td> |
| 266 | 275 | <td>HP-GL plotter language</td> |
| @@ -31,6 +31,7 @@ | ||
| 31 | 31 | .. _Ghostscript : http://pages.cs.wisc.edu/~ghost/ |
| 32 | 32 | .. _GIF : http://www.fileformat.info/format/gif/egff.htm |
| 33 | 33 | .. _`Hald CLUT` : http://www.quelsolaar.com/technology/clut.html |
| 34 | +.. _HEIF : https://en.wikipedia.org/wiki/High_Efficiency_Image_File_Format | |
| 34 | 35 | .. _JBIG : http://www.jpeg.org/ |
| 35 | 36 | .. _JNG : http://www.libmng.com/ |
| 36 | 37 | .. _JPEG : http://www.jpeg.org/ |
| @@ -192,6 +193,10 @@ | ||
| 192 | 193 | | GRAYA | RW | Raw gray samples + alpha | Use -size, -depth, and -endian to specify the | |
| 193 | 194 | | | | | image width, height, depth, and byte order. | |
| 194 | 195 | +--------------+------+---------------------------+--------------------------------------------------+ |
| 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 | + +--------------+------+---------------------------+--------------------------------------------------+ | |
| 195 | 200 | | HPGL | R | HP-GL plotter language | Requires hp2xx_ 3.2.0 or later | |
| 196 | 201 | +--------------+------+---------------------------+--------------------------------------------------+ |
| 197 | 202 | | | | Hypertext Markup Language | | |
Fork