### Install heic2any with Yarn

Source: https://github.com/alexcorvi/heic2any/blob/master/docs/getting-started.md

Instructions to add the `heic2any` library to your project using the Yarn package manager. This command downloads and installs the package and its dependencies, making it available for use in your application.

```bash
yarn add heic2any
```

--------------------------------

### Install heic2any with npm

Source: https://github.com/alexcorvi/heic2any/blob/master/docs/getting-started.md

Instructions to add the `heic2any` library to your project using the npm package manager. This command downloads and installs the package and its dependencies, integrating it into your project's build system.

```bash
npm install heic2any
```

--------------------------------

### Include heic2any via script tag

Source: https://github.com/alexcorvi/heic2any/blob/master/docs/getting-started.md

Instructions to include the `heic2any` library directly in an HTML file without a module bundler. This method makes the library globally available in the browser environment, suitable for simple web pages.

```html
<!-- just include the file in a script tag -->
<script src="./dist/heic2any.js">
```

--------------------------------

### Import heic2any in JavaScript

Source: https://github.com/alexcorvi/heic2any/blob/master/docs/getting-started.md

Demonstrates how to import the `heic2any` library into a JavaScript project using either ES module syntax (`import`) or CommonJS (`require`). This step is essential when working with module bundlers like Webpack or Rollup.

```javascript
import heic2any from "heic2any";
// or
const heic2any = require("heic2any");
// skip the lines above if you're not using a module bundler
```

--------------------------------

### Convert HEIC to PNG with heic2any

Source: https://github.com/alexcorvi/heic2any/blob/master/docs/getting-started.md

Shows the basic usage of `heic2any` to convert a HEIC image file to a PNG format. It involves fetching the HEIC image as a Blob, passing it to the `heic2any` function, and then handling the successful conversion or any potential errors. The result is a Blob of the PNG formatted image.

```javascript
fetch("./my-image.heic")
	.then((res) => res.blob())
	.then((blob) => heic2any({ blob }))
	.then((conversionResult) => {
		// conversionResult is a BLOB
		// of the PNG formatted image
	})
	.catch((e) => {
		// see error handling section
	});
```

--------------------------------

### Convert animated HEIC to GIF with heic2any

Source: https://github.com/alexcorvi/heic2any/blob/master/docs/getting-started.md

Demonstrates how to convert a multi-frame HEIC image, often representing an animation or burst sequence, into a GIF. The `toType` is set to `image/gif`, and `gifInterval` controls the duration each frame is displayed. The output is a single Blob of the animated GIF.

```javascript
fetch("./my-image.heic")
	.then((res) => res.blob())
	.then((blob) =>
		heic2any({
			blob,
			toType: "image/gif",
			gifInterval: 0.3, // switch frames every 0.3 second
		})
	)
	.then((conversionResult) => {
		// conversionResult is a BLOB
		// of the gif formatted image
	})
	.catch((e) => {
		// see error handling section
	});
```

--------------------------------

### Convert HEIC to JPEG with quality compression using heic2any

Source: https://github.com/alexcorvi/heic2any/blob/master/docs/getting-started.md

Illustrates how to convert a HEIC image to JPEG format while simultaneously reducing its quality and file size. The `toType` option specifies the output format, and the `quality` parameter controls the compression level. The output is a JPEG Blob with the specified quality.

```javascript
fetch("./my-image.heic")
	.then((res) => res.blob())
	.then((blob) =>
		heic2any({
			blob,
			toType: "image/jpeg",
			quality: 0.5, // cuts the quality and size by half
		})
	)
	.then((conversionResult) => {
		// conversionResult is a BLOB
		// of the JPEG formatted image
		// with low quality
	})
	.catch((e) => {
		// see error handling section
	});
```

--------------------------------

### Extract multiple images from HEIC to PNG with heic2any

Source: https://github.com/alexcorvi/heic2any/blob/master/docs/getting-started.md

Explains how to handle HEIC files that contain multiple images, such as burst photos, by extracting each into separate PNG blobs. By setting the `multiple` option to `true`, the library returns an array of PNG formatted image blobs, one for each image within the HEIC file.

```javascript
fetch("./my-image.heic")
	.then((res) => res.blob())
	.then((blob) =>
		heic2any({
			blob,
			toType: "image/png",
			multiple: true,
		})
	)
	.then((conversionResult) => {
		// conversionResult is an array
		// of BLOBs that are PNG
		// formatted images
	})
	.catch((e) => {
		// see error handling section
	});
```

--------------------------------

### Install Heic2any via NPM or Yarn

Source: https://github.com/alexcorvi/heic2any/blob/master/index.html

Instructions to install the Heic2any library using Node Package Manager (NPM) or Yarn package manager.

```Shell
$ npm i --save heic2any
$ yarn add heic2any
```

--------------------------------

### Example HEIC2ANY Error Object Structure

Source: https://github.com/alexcorvi/heic2any/blob/master/docs/errors.md

Illustrates the typical structure of an error object returned by the `heic2any` library when an error occurs. The object includes a numeric `code` property representing the error class and a `message` property providing more detailed information.

```json
{
	"code": 1,
	"message": "ERR_USER library only accepts BLOBs as input"
}
```

--------------------------------

### Initialize Syntax Highlighting

Source: https://github.com/alexcorvi/heic2any/blob/master/index.html

Initializes syntax highlighting on page load using the highlight.js library, commonly used for displaying code snippets.

```JavaScript
hljs.initHighlightingOnLoad();
```

--------------------------------

### heic2any Function Options

Source: https://github.com/alexcorvi/heic2any/blob/master/docs/options.md

Defines the configurable options for the `heic2any` function, including output type, quality, and handling of multiple images within a HEIC file. All options are optional. Note that when `toType` is set to `image/gif`, all other options except `gifInterval` are ignored.

```APIDOC
heic2any Options:
  - multiple:
      Type: boolean
      Default: false
      Explanation: Sometimes the `heic` file contains multiple files, so when outputting `image/jpeg` or `image/png` you will get only the primary image (if found) or the first image. However, setting this option to `true` the function will output multiple images in form of array of `blob` files instead of a single one, i.e. the function will output all the images contained in the `heic` file.
  - toType:
      Type: "image/png" | "image/gif" | "image/jpeg"
      Default: image/png
      Explanation: Using `image/png` you will get maximum quality & still image, to lower the quality use `image/jpeg` and set the quality option, and to get an animated `gif` out of an animated `heic` set this option to `image/gif`.
  - quality:
      Type: number, between `0` and `1`
      Default: 0.92
      Explanation: The parameter should be between 0 and 1, and it will only be considered when outputting a `image/jpeg`.
  - gifInterval:
      Type: number in seconds
      0.4
      Explanation: How many seconds for the gif image to move from one frame to another. Only considered when using `image/gif`.
```

--------------------------------

### HEIC2ANY Error Codes Reference

Source: https://github.com/alexcorvi/heic2any/blob/master/docs/errors.md

Provides a comprehensive reference for all error codes returned by the `heic2any` library. Each entry details the numeric code and a clear explanation of the error class it represents, helping users diagnose issues.

```APIDOC
Code: 1
  Explanation: A user error, user should revise the parameters given to the library function
Code: 2
  Explanation: LIBHEIF error, the error occurred when trying to decode the `heic` file
Code: 3
  Explanation: GIF error, the error occurred when trying to encode an animated `gif`.
Code: 4
  Explanation: DOM error, error occurred when trying to utilize the DOM API like the file reader, the Blob class and base64 encoders
Code: 5
  Explanation: Canvas error, error occurred when trying to setup the final conversion canvas, as the canvas api is used to convert pixel data to a real image
Code: 0
  Explanation: Unknown error, error doesn't belong to any of the above classes.
```

--------------------------------

### Handle HEIC Image Conversion Errors with JavaScript Promises

Source: https://github.com/alexcorvi/heic2any/blob/master/docs/errors.md

Demonstrates how to catch and log errors during HEIC image fetching and conversion using JavaScript Promises. The `.catch()` block is used to intercept any errors that occur in the promise chain, providing an `errorObject` for inspection.

```javascript
// fetching the heic image
fetch("./my-image.heic")
	.then((res) => res.blob())
	.then((blob) => heic2any({ blob }))
	.then((conversionResult) => {
		var url = URL.createObjectURL(conversionResult);
		document.getElementById("my-image").innerHTML = `<img src="${url}">`;
	})
	.catch((errorObject) => {
		console.log(errorObject);
	});
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.