New: Support for HEIC image format

Author: ollm

CHANGELOG.md

@@ -12,7 +12,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 - Support for `JP2` image format [`e11046b`](https://github.com/ollm/OpenComic/commit/e11046b4eca758f8b15c1caeb831a235a5f3d62c)
 - Support for `JXR` image format [`0e24922`](https://github.com/ollm/OpenComic/commit/0e2492264e1dbc94126c7d79e3e3c50fc426846c)
 - Support for `JXL` image format [`bd6fb0a`](https://github.com/ollm/OpenComic/commit/bd6fb0a8c8be3685b48c88fa21bbe2d3c384a491)
-- Thumbnail generation speed has been improved
+- Thumbnail generation speed has been improved [`155f064`](https://github.com/ollm/OpenComic/commit/155f064b4c9716c050a6231e44323169686997ea)
+- Support for `HEIC` image format
 
 
 ## [v1.4.1](https://github.com/ollm/OpenComic/releases/tag/v1.4.1) (08-02-2025)

package-lock.json

@@ -86,6 +86,7 @@
 		"fs-extra": "^11.3.0",
 		"gm": "^1.25.0",
 		"handlebars": "^4.7.8",
+		"heic-decode": "^2.0.0",
 		"image-size": "^1.2.0",
 		"jimp": "^1.6.0",
 		"jpegxr": "^0.3.0",

package.json

@@ -1,4 +1,4 @@
-var sharp = false, jimp = false, imageMagick = false, graphicsMagick = false, imageSize = false;
+var sharp = false, jimp = false, imageMagick = false, graphicsMagick = false, imageSize = false, heic = false;
 
 async function resize(fromImage, toImage, config = {})
 {
@@ -384,7 +384,21 @@ async function getSizes(images)
 							{
 								const extension = fileExtension(image.image);
 
-								if(inArray(extension, imageExtensions.jp2))
+								if(inArray(extension, imageExtensions.heic))
+								{
+									if(heic === false)
+										heic = require('heic-decode');
+
+									const buffer = await fsp.readFile(image.image);
+									const images = await heic.all({buffer});
+									const properties = images[0] || {width: 1, height: 1};
+
+									size = {
+										width: properties.width,
+										height: properties.height,
+									};
+								}
+								else if(inArray(extension, imageExtensions.jp2))
 								{
 									if(pdfjsDecoders === false)
 										await loadPdfjsDecoders();

scripts/image.js

@@ -155,6 +155,10 @@ var compatibleMime = [
 	'image/webp',
 	'image/avif',
 	'image/avif-sequence',
+	'image/heic',
+	'image/heif',
+	'image/heic-sequence',
+	'image/heif-sequence',
 ];
 
 // This image formats requires conversion to Blob to be displayed
@@ -165,6 +169,11 @@ var blobMime = [
 	'image/jpm', 
 	// jxl
 	'image/jxl',
+	// heic
+	'image/heic',
+	'image/heif',
+	'image/heic-sequence',
+	'image/heif-sequence',
 ];
 
 // This image formats requires conversion to PNG to be displayed
@@ -301,6 +310,8 @@ var imageExtensions = {
 		'webp',
 		'avif',
 		'avifs',
+		'heic',
+		'heif',
 	],
 	blob: [ // This image formats requires conversion to Blob to be displayed
 		// jp2
@@ -314,6 +325,9 @@ var imageExtensions = {
 		'jpx',
 		// jxl
 		'jxl',
+		// heic
+		'heic',
+		'heif',
 	],
 	convert: [ // This image formats requires conversion to PNG to be displayed
 		// jxr
@@ -374,6 +388,10 @@ var imageExtensions = {
 		'avif',
 		'avifs',
 	],
+	heic: [
+		'heic',
+		'heif',
+	],
 };
 
 var compatibleImageExtensions = [

scripts/opencomic.js

@@ -1,6 +1,6 @@
 const fs = require('fs');
 
-var jpegxr = false;
+var jpegxr = false, heic = false;
 
 async function jp2(path)
 {
@@ -69,7 +69,6 @@ async function jxr(path)
 			bitsString: pixelInfo.bitDepth,
 			bitsPerPixel: pixelInfo.bitsPerPixel,
 			premultiplied: pixelInfo.premultipledAlpha,
-			pixelInfo: pixelInfo,
 			removeAlpha: true,
 		};
 	}
@@ -111,6 +110,41 @@ async function jxl(path)
 	return false;
 }
 
+async function _heic(path)
+{
+	const buffer = fs.readFileSync(path);
+
+	if(heic === false)
+		heic = require('heic-decode');
+
+	try
+	{
+		const image = await heic({buffer});
+
+		const len = image.data.length;
+
+		const width = image.width;
+		const height = image.height;
+
+		const channels = Math.round(len / (width * height));
+
+		return {
+			buffer: image.data,
+			width: width,
+			height: height,
+			length: len,
+			channels: channels,
+			bits: channels > 4 ? 16 : 8,
+		};
+	}
+	catch(error)
+	{
+		return {error: error};
+	}
+
+	return false;
+}
+
 async function convert(path, mime)
 {
 	switch (mime)
@@ -133,6 +167,15 @@ async function convert(path, mime)
 			return jxl(path);
 
 			break;
+		case 'image/heic':
+		case 'image/heif':
+		case 'image/heic-sequence':
+		case 'image/heif-sequence':
+
+			return _heic(path);
+
+			break;
+
 	}
 
 	return false;

scripts/worker/convert-image.js

@@ -245,7 +245,7 @@ async function convertImage(path, options = {})
 	{
 		const bits = result.bits;
 
-		if(bits > 8 && result.buffer instanceof Uint8Array)
+		if(bits > 8 && (result.buffer instanceof Uint8Array || result.buffer instanceof Uint8ClampedArray))
 			result.buffer = convertBuffer(result.buffer, bits, result.bitsString);
 
 		const raw = {
@@ -300,7 +300,7 @@ async function convertImageToBlob(path, options = {})
 	{
 		const bits = result.bits;
 
-		if(bits > 8 && result.buffer instanceof Uint8Array)
+		if(bits > 8 && (result.buffer instanceof Uint8Array || result.buffer instanceof Uint8ClampedArray))
 			result.buffer = convertBuffer(result.buffer, bits, result.bitsString);
 
 		const raw = {