1"use strict";(self.webpackChunkelectronjs=self.webpackChunkelectronjs||[]).push([["13570"],{43404(e,t,n){n.r(t),n.d(t,{metadata:()=>o,default:()=>d,frontMatter:()=>r,contentTitle:()=>c,toc:()=>p,assets:()=>f});var o=JSON.parse('{"id":"latest/api/native-image","title":"nativeImage","description":"Create tray, dock, and application icons using PNG or JPG files.","source":"@site/docs/latest/api/native-image.md","sourceDirName":"latest/api","slug":"/latest/api/native-image","permalink":"/docs/latest/api/native-image","draft":false,"unlisted":false,"editUrl":"https://github.com/electron/electron/edit/main/docs/api/native-image.md","tags":[],"version":"current","frontMatter":{"title":"nativeImage","description":"Create tray, dock, and application icons using PNG or JPG files.","slug":"native-image","hide_title":false},"sidebar":"api","previous":{"title":"MessagePortMain","permalink":"/docs/latest/api/message-port-main"},"next":{"title":"nativeTheme","permalink":"/docs/latest/api/native-theme"}}'),i=n(74848),l=n(28453),s=n(56346),a=n(40329);let r={title:"nativeImage",description:"Create tray, dock, and application icons using PNG or JPG files.",slug:"native-image",hide_title:!1},c="nativeImage",f={},p=[{value:"Supported Formats",id:"supported-formats",level:2},{value:"High Resolution Image",id:"high-resolution-image",level:2},{value:"Template Image <em>macOS</em>",id:"template-image-macos",level:2},{value:"Methods",id:"methods",level:2},{value:"<code>nativeImage.createEmpty()</code>",id:"nativeimagecreateempty",level:3},{value:"<code>nativeImage.createThumbnailFromPath(path, size)</code> <em>macOS</em> <em>Windows</em>",id:"nativeimagecreatethumbnailfrompathpath-size-macos-windows",level:3},{value:"<code>nativeImage.createFromPath(path)</code>",id:"nativeimagecreatefrompathpath",level:3},{value:"<code>nativeImage.createFromBitmap(buffer, options)</code>",id:"nativeimagecreatefrombitmapbuffer-options",level:3},{value:"<code>nativeImage.createFromBuffer(buffer[, options])</code>",id:"nativeimagecreatefrombufferbuffer-options",level:3},{value:"<code>nativeImage.createFromDataURL(dataURL)</code>",id:"nativeimagecreatefromdataurldataurl",level:3},{value:"<code>nativeImage.createFromNamedImage(imageName[, options])</code> <em>macOS</em>",id:"nativeimagecreatefromnamedimageimagename-options-macos",level:3},{value:"<code>nativeImage.createMenuSymbol(imageName)</code> <em>macOS</em>",id:"nativeimagecreatemenusymbolimagename-macos",level:3},{value:"Class: NativeImage",id:"class-nativeimage",level:2},{value:"Instance Methods",id:"instance-methods",level:3},{value:"<code>image.toPNG([options])</code>",id:"imagetopngoptions",level:4},{value:"<code>image.toJPEG(quality)</code>",id:"imagetojpegquality",level:4},{value:"<code>image.toBitmap([options])</code>",id:"imagetobitmapoptions",level:4},{value:"<code>image.toDataURL([options])</code>",id:"imagetodataurloptions",level:4},{value:"<code>image.getBitmap([options])</code> <em>Deprecated</em>",id:"imagegetbitmapoptions-deprecated",level:4},{value:"<code>image.getNativeHandle()</code> <em>macOS</em>",id:"imagegetnativehandle-macos",level:4},{value:"<code>image.isEmpty()</code>",id:"imageisempty",level:4},{value:"<code>image.getSize([scaleFactor])</code>",id:"imagegetsizescalefactor",level:4},{value:"<code>image.setTemplateImage(option)</code>",id:"imagesettemplateimageoption",level:4},{value:"<code>image.isTemplateImage()</code>",id:"imageistemplateimage",level:4},{value:"<code>image.crop(rect)</code>",id:"imagecroprect",level:4},{value:"<code>image.resize(options)</code>",id:"imageresizeoptions",level:4},{value:"<code>image.getAspectRatio([scaleFactor])</code>",id:"imagegetaspectratioscalefactor",level:4},{value:"<code>image.getScaleFactors()</code>",id:"imagegetscalefactors",level:4},{value:"<code>image.addRepresentation(options)</code>",id:"imageaddrepresentationoptions",level:4},{value:"Instance Properties",id:"instance-properties",level:3},{value:"<code>nativeImage.isMacTemplateImage</code> <em>macOS</em>",id:"nativeimageismactemplateimage-macos",level:4}];function m(e){let t={a:"a",admonition:"admonition",blockquote:"blockquote",code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",h4:"h4",header:"header",li:"li",p:"p",pre:"pre",ul:"ul",...(0,l.R)(),...e.components};return(0,i.jsxs)(i.Fragment,{children:[(0,i.jsx)(t.header,{children:(0,i.jsx)(t.h1,{id:"nativeimage",children:"nativeImage"})}),"\n",(0,i.jsxs)(t.blockquote,{children:["\n",(0,i.jsx)(t.p,{children:"Create tray, dock, and application icons using P
1NG or JPG files."}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["Process: ",(0,i.jsx)(t.a,{href:"/docs/latest/glossary#main-process",children:"Main"}),", ",(0,i.jsx)(t.a,{href:"/docs/latest/glossary#renderer-process",children:"Renderer"})]}),"\n",(0,i.jsx)(t.admonition,{type:"info",children:(0,i.jsxs)(t.p,{children:["If you want to call this API from a renderer process with context isolation enabled,\nplace the API call in your preload script and\n",(0,i.jsx)(t.a,{href:"/docs/latest/tutorial/context-isolation#after-context-isolation-enabled",children:"expose"})," it using the\n",(0,i.jsx)(t.a,{href:"/docs/latest/api/context-bridge",children:(0,i.jsx)(t.code,{children:"contextBridge"})})," API."]})}),"\n",(0,i.jsxs)(t.p,{children:["The ",(0,i.jsx)(t.code,{children:"nativeImage"})," module provides a unified interface for manipulating\nsystem images. These can be handy if you want to provide multiple scaled\nversions of the same icon or take advantage of macOS ",(0,i.jsx)(t.a,{href:"https://developer.apple.com/documentation/appkit/nsimage/1520017-template",children:"template images"}),"."]}),"\n",(0,i.jsxs)(t.p,{children:["Electron APIs that take image files accept either file paths or\n",(0,i.jsx)(t.code,{children:"NativeImage"})," instances. An empty and transparent image will be used when ",(0,i.jsx)(t.code,{children:"null"})," is passed."]}),"\n",(0,i.jsxs)(t.p,{children:["For example, when creating a ",(0,i.jsx)(t.a,{href:"/docs/latest/api/tray",children:"Tray"})," or setting a ",(0,i.jsx)(t.a,{href:"/docs/latest/api/browser-window",children:"BrowserWindow"}),"'s\nicon, you can either pass an image file path as a string:"]}),"\n",(0,i.jsx)(t.pre,{children:(0,i.jsx)(t.code,{className:"language-js",metastring:"title='Main Process'",children:"const { BrowserWindow, Tray } = require('electron')\n\nconst tray = new Tray('/Users/somebody/images/icon.png')\nconst win = new BrowserWindow({ icon: '/Users/somebody/images/window.png' })\n"})}),"\n",(0,i.jsxs)(t.p,{children:["or generate a ",(0,i.jsx)(t.code,{children:"NativeImage"})," instance from the same file:"]}),"\n",(0,i.jsx)(t.pre,{children:(0,i.jsx)(t.code,{className:"language-js",metastring:"title='Main Process'",children:"const { BrowserWindow, nativeImage, Tray } = require('electron')\n\nconst trayIcon = nativeImage.createFromPath('/Users/somebody/images/icon.png')\nconst appIcon = nativeImage.createFromPath('/Users/somebody/images/window.png')\nconst tray = new Tray(trayIcon)\nconst win = new BrowserWindow({ icon: appIcon })\n"})}),"\n",(0,i.jsx)(t.h2,{id:"supported-formats",children:"Supported Formats"}),"\n",(0,i.jsxs)(t.p,{children:["Currently, ",(0,i.jsx)(t.code,{children:"PNG"})," and ",(0,i.jsx)(t.code,{children:"JPEG"})," image formats are supported across all platforms.\n",(0,i.jsx)(t.code,{children:"PNG"})," is recommended because of its support for transparency and lossless compression."]}),"\n",(0,i.jsxs)(t.p,{children:["On Windows, you can also load ",(0,i.jsx)(t.code,{children:"ICO"})," icons from file paths. For best visual\nquality, we recommend including at least the following sizes:"]}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:["Small icon","\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsx)(t.li,{children:"16x16 (100% DPI scale)"}),"\n",(0,i.jsx)(t.li,{children:"20x20 (125% DPI scale)"}),"\n",(0,i.jsx)(t.li,{children:"24x24 (150% DPI scale)"}),"\n",(0,i.jsx)(t.li,{children:"32x32 (200% DPI scale)"}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(t.li,{children:["Large icon","\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsx)(t.li,{children:"32x32 (100% DPI scale)"}),"\n",(0,i.jsx)(t.li,{children:"40x40 (125% DPI scale)"}),"\n",(0,i.jsx)(t.li,{children:"48x48 (150% DPI scale)"}),"\n",(0,i.jsx)(t.li,{children:"64x64 (200% DPI scale)"}),"\n",(0,i.jsx)(t.li,{children:"256x256"}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["Check the ",(0,i.jsx)(t.em,{children:"Icon Scaling"})," section in the Windows ",(0,i.jsx)(t.a,{href:"https://learn.microsoft.com/en-us/windows/apps/design/style/iconography/app-icon-construction#icon-scaling",children:"App Icon Construction"})," reference."]}),"\n",(0,i.jsx)(t.admonition,{type:"note",children:(0,i.jsx)(t.p,{children:"EXIF metadata is currently not supported and will not be taken into account during\nimage encoding and decoding."})}),"\n",(0,i.jsx)(t.h2,{id:"high-resolution-image",children:"High Resolution Image"}),"\n",(0,i.jsxs)(t.p,{children:["On platforms that support high pixel density displays (such as Apple Retina),\nyou can append ",(0,i.jsx)(t.code,{children:"@2x"})," after image's base filename to mark it as a 2x scale\nhigh resolution image."]}),"\n",(0,i.jsxs)(t.p,{children:["For example, if ",(0,i.jsx)(t.code,{children:"icon.png"}
1)," is a normal image that has standard resolution, then\n",(0,i.jsx)(t.code,{children:"[email protected]"})," will be treated as a high resolution image that has double\nDots per Inch (DPI) density."]}),"\n",(0,i.jsx)(t.p,{children:"If you want to support displays with different DPI densities at the same time,\nyou can put images with different sizes in the same folder and use the filename\nwithout DPI suffixes within Electron. For example:"}),"\n",(0,i.jsx)(t.pre,{children:(0,i.jsx)(t.code,{className:"language-plaintext",children:"images/\n\u251C\u2500\u2500 icon.png\n\u251C\u2500\u2500 [email protected]\n\u2514\u2500\u2500 [email protected]\n"})}),"\n",(0,i.jsx)(t.pre,{children:(0,i.jsx)(t.code,{className:"language-js",metastring:"title='Main Process'",children:"const { Tray } = require('electron')\n\nconst appTray = new Tray('/Users/somebody/images/icon.png')\n"})}),"\n",(0,i.jsx)(t.p,{children:"The following suffixes for DPI are also supported:"}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsx)(t.li,{children:(0,i.jsx)(t.code,{children:"@1x"})}),"\n",(0,i.jsx)(t.li,{children:(0,i.jsx)(t.code,{children:"@1.25x"})}),"\n",(0,i.jsx)(t.li,{children:(0,i.jsx)(t.code,{children:"@1.33x"})}),"\n",(0,i.jsx)(t.li,{children:(0,i.jsx)(t.code,{children:"@1.4x"})}),"\n",(0,i.jsx)(t.li,{children:(0,i.jsx)(t.code,{children:"@1.5x"})}),"\n",(0,i.jsx)(t.li,{children:(0,i.jsx)(t.code,{children:"@1.8x"})}),"\n",(0,i.jsx)(t.li,{children:(0,i.jsx)(t.code,{children:"@2x"})}),"\n",(0,i.jsx)(t.li,{children:(0,i.jsx)(t.code,{children:"@2.5x"})}),"\n",(0,i.jsx)(t.li,{children:(0,i.jsx)(t.code,{children:"@3x"})}),"\n",(0,i.jsx)(t.li,{children:(0,i.jsx)(t.code,{children:"@4x"})}),"\n",(0,i.jsx)(t.li,{children:(0,i.jsx)(t.code,{children:"@5x"})}),"\n"]}),"\n",(0,i.jsxs)(t.h2,{id:"template-image-macos",children:["Template Image ",(0,i.jsx)(t.em,{className:"badge badge--primary",children:"macOS"})]}),"\n",(0,i.jsxs)(t.p,{children:["On macOS, ",(0,i.jsx)(t.a,{href:"https://developer.apple.com/documentation/appkit/nsimage/1520017-template",children:"template images"})," consist of black and an alpha channel.\nTemplate images are not intended to be used as standalone images and are usually\nmixed with other content to create the desired final appearance."]}),"\n",(0,i.jsx)(t.p,{children:"The most common case is to use template images for a menu bar (Tray) icon, so it can\nadapt to both light and dark menu bars."}),"\n",(0,i.jsxs)(t.p,{children:["To mark an image as a template image, its base filename should end with the word\n",(0,i.jsx)(t.code,{children:"Template"})," (e.g. ",(0,i.jsx)(t.code,{children:"xxxTemplate.png"}),"). You can also specify template images at\ndifferent DPI densities (e.g. ",(0,i.jsx)(t.code,{children:"[email protected]"}),")."]}),"\n",(0,i.jsx)(t.h2,{id:"methods",children:"Methods"}),"\n",(0,i.jsxs)(t.p,{children:["The ",(0,i.jsx)(t.code,{children:"nativeImage"})," module has the following methods, all of which return\nan instance of the ",(0,i.jsx)(t.a,{href:"#class-nativeimage",children:(0,i.jsx)(t.code,{children:"NativeImage"})})," class:"]}),"\n",(0,i.jsx)(t.h3,{id:"nativeimagecreateempty",children:(0,i.jsx)(t.code,{children:"nativeImage.createEmpty()"})}),"\n",(0,i.jsxs)(t.p,{children:["Returns ",(0,i.jsx)(t.code,{children:"NativeImage"})]}),"\n",(0,i.jsxs)(t.p,{children:["Creates an empty ",(0,i.jsx)(t.code,{children:"NativeImage"})," instance."]}),"\n",(0,i.jsxs)(t.h3,{id:"nativeimagecreatethumbnailfrompathpath-size-macos-windows",children:[(0,i.jsx)(t.code,{children:"nativeImage.createThumbnailFromPath(path, size)"})," ",(0,i.jsx)(t.em,{className:"badge badge--primary",children:"macOS"})," ",(0,i.jsx)(t.em,{className:"badge badge--primary",children:"Windows"})]}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"path"})," string - path to a file that we intend to construct a thumbnail out of."]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"size"})," ",(0,i.jsx)(a.A,{url:"/docs/latest/api/structures/size",title:"Size",content:'{"type":"root","children":[{"type":"element","tagName":"h1","properties":{},"children":[{"type":"text","value":"Size Object"}]},{"type":"text","value":"\\n"},{"type":"element","tagName":"ul","properties":{},"children":[{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"width","position":{"start":{"line":10,"column":3,"offset":92},"end":{"line":10,"column":10,"offset":99}}}],"position":{"start":{"line":10,"column":3,"offset":92},"end":{"line":10,"column":10,"offset":99}}},{"type":"text","value":" number","position":{"start":{"line":10,"column":10,"offset":99},"end":{"line":10,"column":17,"offset":106}}}],"position":{"start":{"line":10,"column":1,"offset":90},"end":{"line":10,"column":17,"offset":106}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"height","position":{"start":{"line":11,"column":3,"offset":109},"end":{"line":11,"column":11,"offset":117}}}],"position":{"start":{"line":11,"column":3,"offset":109},"end":{"line":11,"column":11,"offset":117}}},{"type":"text","value":" number","position":{"start":{"line":11,"column":11,"offset":117},"end":{"line":11,"column":18,"offset":124}}}],"position":{"start":{"line":11,"column":1,"offset":107},"end":{"line":11,"column":18,"offset":124}}},{"type":"text","value":"\\n"}],"position":{"start":{"line":10,"column":1,"offset":90},"end":{"line":11,"column":18,"offset":124}}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":12,"column":1,"offset":125}}}'})," - the desired width and height (positive numbers) of the thumbnail."]}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["Returns ",(0,i.jsx)(t.code,{children:"Promise<NativeImage>"})," - fulfilled with the file's thumbnail preview image, which is a ",(0,i.jsx)(t.a,{href:"/docs/latest/api/native-image",children:"NativeImage"}),"."]}),"\n",(0,i.jsx)(t.admonition,{type:"note",children:(0,i.jsxs)(t.p,{children:["Windows implementation will ignore ",(0,i.jsx)(t.code,{children:"size.height"})," and scale the height according to ",(0,i.jsx)(t.code,{children:"size.width"}),"."]})}),"\n",(0,i.jsx)(t.h3,{id:"nativeimagecreatefrompathpath",children:(0,i.jsx)(t.code,{children:"nativeImage.createFromPath(path)"})}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"path"})," string - path to a file that we intend to construct an image out of."]}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["Returns ",(0,i.jsx)(t.code,{children:"NativeImage"})]}),"\n",(0,i.jsxs)(t.p,{children:["Creates a new ",(0,i.jsx)(t.code,{children:"NativeImage"})," instance from an image file (e.g., PNG or JPEG) located at ",(0,i.jsx)(t.code,{children:"path"}),".\nThis method returns an empty image if the ",(0,i.jsx)(t.code,{children:"path"})," does not exist, cannot be read, or is not\na valid image."]}),"\n",(0,i.jsx)(t.pre,{children:(0,i.jsx)(t.code,{className:"language-js",children:"const { nativeImage } = require('electron')\n\nconst image = nativeImage.createFromPath('/Users/somebody/images/icon.png')\nconsole.log(image)\n"})}),"\n",(0,i.jsx)(t.h3,{id:"nativeimagecreatefrombitmapbuffer-options",children:(0,i.jsx)(t.code,{children:"nativeImage.createFromBitmap(buffer, options)"})}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"buffer"})," ",(0,i.jsx)(t.a,{href:"https://nodejs.org/api/buffer.html#buffer_class_buffer",children:"Buffer"})]}),"\n",(0,i.jsxs)(t.li,{className:"electron-api-options-list",children:[(0,i.jsx)(t.code,{children:"options"})," Object","\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"width"})," Integer"]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"height"})," Integer"]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"scaleFactor"})," Number (optional) - Defaults to 1.0."]}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["Returns ",(0,i.jsx)(t.code,{children:"NativeImage"})]}),"\n",(0,i.jsxs)(t.p,{children:["Creates a new ",(0,i.jsx)(t.code,{children:"NativeImage"})," instance from ",(0,i.jsx)(t.code,{children:"buffer"}
1)," that contains the raw bitmap\npixel data returned by ",(0,i.jsx)(t.code,{children:"toBitmap()"}),". The specific format is platform-dependent."]}),"\n",(0,i.jsx)(t.h3,{id:"nativeimagecreatefrombufferbuffer-options",children:(0,i.jsx)(t.code,{children:"nativeImage.createFromBuffer(buffer[, options])"})}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"buffer"})," ",(0,i.jsx)(t.a,{href:"https://nodejs.org/api/buffer.html#buffer_class_buffer",children:"Buffer"})]}),"\n",(0,i.jsxs)(t.li,{className:"electron-api-options-list",children:[(0,i.jsx)(t.code,{children:"options"})," Object (optional)","\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"width"})," Integer (optional) - Required for bitmap buffers."]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"height"})," Integer (optional) - Required for bitmap buffers."]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"scaleFactor"})," Number (optional) - Defaults to 1.0."]}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["Returns ",(0,i.jsx)(t.code,{children:"NativeImage"})]}),"\n",(0,i.jsxs)(t.p,{children:["Creates a new ",(0,i.jsx)(t.code,{children:"NativeImage"})," instance from ",(0,i.jsx)(t.code,{children:"buffer"}),". Tries to decode as PNG or JPEG first."]}),"\n",(0,i.jsx)(t.h3,{id:"nativeimagecreatefromdataurldataurl",children:(0,i.jsx)(t.code,{children:"nativeImage.createFromDataURL(dataURL)"})}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"dataURL"})," string"]}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["Returns ",(0,i.jsx)(t.code,{children:"NativeImage"})]}),"\n",(0,i.jsxs)(t.p,{children:["Creates a new ",(0,i.jsx)(t.code,{children:"NativeImage"})," instance from ",(0,i.jsx)(t.code,{children:"dataUrl"}),", a base 64 encoded ",(0,i.jsx)(t.a,{href:"https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs",children:"Data URL"})," string."]}),"\n",(0,i.jsxs)(t.h3,{id:"nativeimagecreatefromnamedimageimagename-options-macos",children:[(0,i.jsx)(t.code,{children:"nativeImage.createFromNamedImage(imageName[, options])"})," ",(0,i.jsx)(t.em,{className:"badge badge--primary",children:"macOS"})]}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"imageName"})," string"]}),"\n",(0,i.jsxs)(t.li,{className:"electron-api-options-list",children:[(0,i.jsx)(t.code,{children:"options"})," Object | number[] (optional) - If ",(0,i.jsx)(t.code,{children:"options"})," is a number array (",(0,i.jsx)(t.em,{className:"badge badge--danger",children:"Deprecated"}),"), it is interpreted as ",(0,i.jsx)(t.code,{children:"hslShift"}),". If it is an object, the\nfollowing properties can be specified:","\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"hslShift"})," number[] (optional)"]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"pointSize"})," Number (optional) - Defaults to ",(0,i.jsx)(t.code,{children:"30.0"}),"."]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"weight"})," 'ultralight' | 'thin' | 'light' | 'regular' | 'medium' | 'semibold' | 'bold' | 'heavy' | 'black' (optional) - Defaults to ",(0,i.jsx)(t.code,{children:"regular"}),"."]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"scale"})," 'small' | 'medium' | 'large' (optional) - Defaults to ",(0,i.jsx)(t.code,{children:"medium"}),"."]}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["Returns ",(0,i.jsx)(t.code,{children:"NativeImage"})]}),"\n",(0,i.jsxs)(t.p,{children:["Creates a new ",(0,i.jsx)(t.code,{children:"NativeImage"})," instance from the ",(0,i.jsx)(t.code,{children:"NSImage"})," that maps to the\ngiven image name. See Apple's ",(0,i.jsx)(t.a,{href:"https://developer.apple.com/documentation/appkit/nsimagename#2901388",children:(0,i.jsx)(t.code,{children:"NSImageName"})})," documentation and ",(0,i.jsx)(t.a,{href:"https://developer.apple.com/sf-symbols/",children:"SF Symbols"})," for a list of possible values."]}),"\n",(0,i.jsxs)(t.p,{children:["The ",(0,i.jsx)(t.code,{children:"hslShift"})," is applied to the image with the following rules:"]}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"hsl_shift[0]"})," (hue): The absolute hue value for the image - 0 and 1 map\nto 0 and 360 on the hue color wheel (red)."]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"hsl_shift[1]"})," (saturation): A saturation shift for the image, with the\nfollowing key values:\n0 = remove all c
1olor.\n0.5 = leave unchanged.\n1 = fully saturate the image."]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"hsl_shift[2]"})," (lightness): A lightness shift for the image, with the\nfollowing key values:\n0 = remove all lightness (make all pixels black).\n0.5 = leave unchanged.\n1 = full lightness (make all pixels white)."]}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["This means that ",(0,i.jsx)(t.code,{children:"[-1, 0, 1]"})," will make the image completely white and\n",(0,i.jsx)(t.code,{children:"[-1, 1, 0]"})," will make the image completely black."]}),"\n",(0,i.jsxs)(t.p,{children:["In some cases, the ",(0,i.jsx)(t.code,{children:"NSImageName"})," doesn't match its string representation; one example of this is ",(0,i.jsx)(t.code,{children:"NSFolderImageName"}),", whose string representation would actually be ",(0,i.jsx)(t.code,{children:"NSFolder"}),". Therefore, you'll need to determine the correct string representation for your image before passing it in. This can be done with the following:"]}),"\n",(0,i.jsx)(t.pre,{children:(0,i.jsx)(t.code,{className:"language-sh",children:"echo -e '#import <Cocoa/Cocoa.h>\\nint main() { NSLog(@\"%@\", SYSTEM_IMAGE_NAME); }' | clang -otest -x objective-c -framework Cocoa - && ./test\n"})}),"\n",(0,i.jsxs)(t.p,{children:["where ",(0,i.jsx)(t.code,{children:"SYSTEM_IMAGE_NAME"})," should be replaced with any value from ",(0,i.jsx)(t.a,{href:"https://developer.apple.com/documentation/appkit/nsimagename?language=objc",children:"this list"}),"."]}),"\n",(0,i.jsx)(t.p,{children:"For SF Symbols, usage looks as follows:"}),"\n",(0,i.jsx)(t.pre,{children:(0,i.jsx)(t.code,{className:"language-js",children:"const image = nativeImage.createFromNamedImage('square.and.pencil')\n"})}),"\n",(0,i.jsxs)(t.p,{children:["where ",(0,i.jsx)(t.code,{children:"'square.and.pencil'"})," is the symbol name from the\n",(0,i.jsx)(t.a,{href:"https://developer.apple.com/sf-symbols/",children:"SF Symbols app"}),"."]}),"\n",(0,i.jsxs)(t.h3,{id:"nativeimagecreatemenusymbolimagename-macos",children:[(0,i.jsx)(t.code,{children:"nativeImage.createMenuSymbol(imageName)"})," ",(0,i.jsx)(t.em,{className:"badge badge--primary",children:"macOS"})]}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"imageName"})," string"]}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["Returns ",(0,i.jsx)(t.code,{children:"NativeImage"})]}),"\n",(0,i.jsxs)(t.p,{children:["Creates a new ",(0,i.jsx)(t.code,{children:"NativeImage"})," instance from an SF Symbol for use in a native ",(0,i.jsx)(t.a,{href:"/docs/latest/api/menu",children:"Menu"}),". See ",(0,i.jsx)(t.a,{href:"https://developer.apple.com/sf-symbols/",children:"SF Symbols"})," for a list of possible values."]}),"\n",(0,i.jsx)(t.pre,{children:(0,i.jsx)(t.code,{className:"language-js",children:"const { nativeImage, MenuItem } = require('electron')\n\nconst item = new MenuItem({\n icon: nativeImage.createMenuSymbol('folder.badge.plus'),\n label: 'Create Folder'\n})\n"})}),"\n",(0,i.jsx)(t.h2,{id:"class-nativeimage",children:"Class: NativeImage"}),"\n",(0,i.jsxs)(t.blockquote,{children:["\n",(0,i.jsx)(t.p,{children:"Natively wrap images such as tray, dock, and application icons."}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["Process: ",(0,i.jsx)(t.a,{href:"/docs/latest/glossary#main-process",children:"Main"}),", ",(0,i.jsx)(t.a,{href:"/docs/latest/glossary#renderer-process",children:"Renderer"}),(0,i.jsx)("br",{}),"\n",(0,i.jsxs)(t.em,{children:["This class is not exported from the ",(0,i.jsx)(t.code,{children:"'electron'"})," module. It is only available as a return value of other methods in the Electron API."]})]}),"\n",(0,i.jsx)(t.h3,{id:"instance-methods",children:"Instance Methods"}),"\n",(0,i.jsxs)(t.p,{children:["The following methods are available on instances of the ",(0,i.jsx)(t.code,{children:"NativeImage"})," class:"]}),"\n",(0,i.jsx)(t.admonition,{type:"note",children:(0,i.jsxs)(t.p,{children:["The methods that return a ",(0,i.jsx)(t.code,{children:"Buffer"})," throw an error when called from a context without a\nNode.js environment, such as a ",(0,i.jsx)(t.a,{href:"/docs/latest/tutorial/sandbox",children:"sandboxed"})," preload script.\n",(0,i.jsx)(t.code,{children:"image.toDataURL()"})," works in every context."]})}),"\n",(0,i.jsx)(t.h4,{id:"imagetopngoptions",children:(0,i.jsx)(t.code,{children:"image.toPNG([options])"})}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{className:"electron-api-options-list",children:[(0,i.jsx)(t.code,{children:"options"})," Object (optional)","\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"scaleFactor"})," Number (optional) - Defaults to 1.0."]}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["Returns ",(0,i.jsx)(t.code,{children:"Buffer"})," - A ",(0,i.jsx)(t.a,{href:"https://nodejs.org/api/buffer.html#buffer_class_buffer",children:"Buffer"}
1)," that contains the image's ",(0,i.jsx)(t.code,{children:"PNG"})," encoded data."]}),"\n",(0,i.jsx)(t.h4,{id:"imagetojpegquality",children:(0,i.jsx)(t.code,{children:"image.toJPEG(quality)"})}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"quality"})," Integer - Between 0 - 100."]}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["Returns ",(0,i.jsx)(t.code,{children:"Buffer"})," - A ",(0,i.jsx)(t.a,{href:"https://nodejs.org/api/buffer.html#buffer_class_buffer",children:"Buffer"})," that contains the image's ",(0,i.jsx)(t.code,{children:"JPEG"})," encoded data."]}),"\n",(0,i.jsx)(t.h4,{id:"imagetobitmapoptions",children:(0,i.jsx)(t.code,{children:"image.toBitmap([options])"})}),"\n",(0,i.jsx)(s.A,{apiHistoryJson:'{"changes":[{"pr-url":"https://github.com/electron/electron/pull/48178","description":"Normalized `NativeImage.toBitmap()` pixel data to sRGB by default.","breaking-changes-header":"behavior-changed-nativeimagetobitmap-now-normalizes-color-space"}]}',prReleaseVersionsJson:'{"48178":{"release":null,"backports":["43.0.0"]}}'}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{className:"electron-api-options-list",children:[(0,i.jsx)(t.code,{children:"options"})," Object (optional)","\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"scaleFactor"})," Number (optional) - Defaults to 1.0."]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"colorSpace"})," ",(0,i.jsx)(a.A,{url:"/docs/latest/api/structures/color-space",title:"ColorSpace",content:'{"type":"root","children":[{"type":"element","tagName":"h1","properties":{},"children":[{"type":"text","value":"ColorSpace Object"}]},{"type":"text","value":"\\n"},{"type":"element","tagName":"ul","properties":{},"children":[{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"text","value":"\\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"primaries","position":{"start":{"line":10,"column":3,"offset":111},"end":{"line":10,"column":14,"offset":122}}}],"position":{"start":{"line":10,"column":3,"offset":111},"end":{"line":10,"column":14,"offset":122}}},{"type":"text","value":" string - The color primaries of the color space. Can be one of the following values:","position":{"start":{"line":10,"column":14,"offset":122},"end":{"line":10,"column":99,"offset":207}}}],"position":{"start":{"line":10,"column":3,"offset":111},"end":{"line":10,"column":99,"offset":207}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"ul","properties":{},"children":[{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"bt709","position":{"start":{"line":11,"column":5,"offset":212},"end":{"line":11,"column":12,"offset":219}}}],"position":{"start":{"line":11,"column":5,"offset":212},"end":{"line":11,"column":12,"offset":219}}},{"type":"text","value":" - BT709 primaries (also used for sRGB)","position":{"start":{"line":11,"column":12,"offset":219},"end":{"line":11,"column":51,"offset":258}}}],"position":{"start":{"line":11,"column":3,"offset":210},"end":{"line":11,"column":51,"offset":258}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"bt470m","position":{"start":{"line":12,"column":5,"offset":263},"end":{"line":12,"column":13,"offset":271}}}],"position":{"start":{"line":12,"column":5,"offset":263},"end":{"line":12,"column":13,"offset":271}}},{"type":"text","value":" - BT470M primaries","position":{"start":{"line":12,"column":13,"offset":271},"end":{"line":12,"column":32,"offset":290}}}],"position":{"start":{"line":12,"column":3,"offset":261},"end":{"line":12,"column":32,"offset":290}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"bt470bg","position":{"start":{"line":13,"column":5,"offset":295},"end":{"line":13,"column":14,"offset":304}}}],"position":{"start":{"line":13,"column":5,"offset":295},"end":{"line":13,"column":14,"offset":304}}},{"type":"text","value":" - BT470BG primaries","position":{"start":{"line":13,"column":14,"offset":304},"end":{"line":13,"column":34,"offset":324}}}],"position":{"start":{"line":13,"column":3,"offset":293},"end":{"line":13,"column":34,"offset":324}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"smpte170m","position":{"start":{"line":14,"column":5,"offset":329},"end":{"line":14,"column":16,"offset":340}}}],"position":{"start":{"line":14,"column":5,"offset":329},"end":{"line":14,"column":16,"offset":340}}},{"type":"text","value":" - SMPTE170M primaries","position":{"start":{"line":14,"column":16,"offset":340},"end":{"line":14,"column":38,"offset":362}}}],"position":{"start":{"line":14,"column":3,"offset":327},"end":{"line":14,"column":38,"offset":362}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"smpte240m","position":{"start":{"line":15,"column":5,"offset":367},"end":{"line":15,"column":16,"offset":378}}}],"position":{"start":{"line":15,"column":5,"offset":367},"end":{"line":15,"column":16,"offset":378}}},{"type":"text","value":" - SMPTE240M primaries","position":{"start":{"line":15,"column":16,"offset":378},"end":{"line":15,"column":38,"offset":400}}}],"position":{"start":{"line":15,"column":3,"offset":365},"end":{"line":15,"column":38,"offset":400}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"film","position":{"start":{"line":16,"column":5,"offset":405},"end":{"line":16,"column":11,"offset":411}}}],"position":{"start":{"line":16,"column":5,"offset":405},"end":{"line":16,"column":11,"offset":411}}},{"type":"text","value":" - Film primaries","position":{"start":{"line":16,"column":11,"offset":411},"end":{"line":16,"column":28,"offset":428}}}],"position":{"start":{"line":16,"column":3,"offset":403},"end":{"line":16,"column":28,"offset":428}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"bt2020","position":{"start":{"line":17,"column":5,"offset":433},"end":{"line":17,"column":13,"offset":441}}}],"position":{"start":{"line":17,"column":5,"offset":433},"end":{"line":17,"column":13,"offset":441}}},{"type":"text","value":" - BT2020 primaries","position":{"start":{"line":17,"column":13,"offset":441},"end":{"line":17,"column":32,"offset":460}}}],"position":{"start":{"line":17,"column":3,"offset":431},"end":{"line":17,"column":32,"offset":460}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"smptest428-1","position":{"start":{"line":18,"column":5,"offset":465},"end":{"line":18,"column":19,"offset":479}}}],"position":{"start":{"line":18,"column":5,"offset":465},"end":{"line":18,"column":19,"offset":479}}},{"type":"text","value":" - SMPTEST428-1 primaries","position":{"start":{"line":18,"column":19,"offset":479},"end":{"line":18,"column":44,"offset":504}}}],"position":{"start":{"line":18,"column":3,"offset":463},"end":{"line":18,"column":44,"offset":504}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"smptest431-2","position":{"start":{"line":19,"column":5,"offset":509},"end":{"line":19,"column":19,"offset":523}}}],"position":{"start":{"line":19,"column":5,"offset":509},"end":{"line":19,"column":19,"offset":523}}},{"type":"text","value":" - SMPTEST431-2 primaries","position":{"start":{"line":19,"column":19,"offset":523},"end":{"line":19,"column":44,"offset":548}}}],"position":{"start":{"line":19,"column":3,"offset":507},"end":{"line":19,"column":44,"offset":548}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"p3","position":{"start":{"line":20,"column":5,"offset":553},"end":{"line":20,"column":9,"offset":557}}}],"position":{"start":{"line":20,"column":5,"offset":553},"end":{"line":20,"column":9,"offset":557}}},{"type":"text","value":" - P3 primaries","position":{"start":{"line":20,"column":9,"offset":557},"end":{"line":20,"column":24,"offset":572}}}],"position":{"start":{"line":20,"column":3,"offset":551},"end":{"line":20,"column":24,"offset":572}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"xyz-d50","position":{"start":{"line":21,"column":5,"offset":577},"end":{"line":21,"column":14,"offset":586}}}],"position":{"start":{"line":21,"column":5,"offset":577},"end":{"line":21,"column":14,"offset":586}}},{"type":"text","value":" - XYZ D50 primaries","position":{"start":{"line":21,"column":14,"offset":586},"end":{"line":21,"column":34,"offset":606}}}],"position":{"start":{"line":21,"column":3,"offset":575},"end":{"line":21,"column":34,"offset":606}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"adobe-rgb","position":{"start":{"line":22,"column":5,"offset":611},"end":{"line":22,"column":16,"offset":622}}}],"position":{"start":{"line":22,"column":5,"offset":611},"end":{"line":22,"column":16,"offset":622}}},{"type":"text","value":" - Adobe RGB primaries","position":{"start":{"line":22,"column":16,"offset":622},"end":{"line":22,"column":38,"offset":644}}}],"position":{"start":{"line":22,"column":3,"offset":609},"end":{"line":22,"column":38,"offset":644}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"apple-generic-rgb","position":{"start":{"line":23,"column":5,"offset":649},"end":{"line":23,"column":24,"offset":668}}}],"position":{"start":{"line":23,"column":5,"offset":649},"end":{"line":23,"column":24,"offset":668}}},{"type":"text","value":" - Apple Generic RGB primaries","position":{"start":{"line":23,"column":24,"offset":668},"end":{"line":23,"column":54,"offset":698}}}],"position":{"start":{"line":23,"column":3,"offset":647},"end":{"line":23,"column":54,"offset":698}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"wide-gamut-color-spin","position":{"start":{"line":24,"column":5,"offset":703},"end":{"line":24,"column":28,"offset":726}}}],"position":{"start":{"line":24,"column":5,"offset":703},"end":{"line":24,"column":28,"offset":726}}},{"type":"text","value":" - Wide Gamut Color Spin primaries","position":{"start":{"line":24,"column":28,"offset":726},"end":{"line":24,"column":62,"offset":760}}}],"position":{"start":{"line":24,"column":3,"offset":701},"end":{"line":24,"column":62,"offset":760}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"ebu-3213-e","position":{"start":{"line":25,"column":5,"offset":765},"end":{"line":25,"column":17,"offset":777}}}],"position":{"start":{"line":25,"column":5,"offset":765},"end":{"line":25,"column":17,"offset":777}}},{"type":"text","value":" - EBU 3213-E primaries","position":{"start":{"line":25,"column":17,"offset":777},"end":{"line":25,"column":40,"offset":800}}}],"position":{"start":{"line":25,"column":3,"offset":763},"end":{"line":25,"column":40,"offset":800}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"custom","position":{"start":{"line":26,"column":5,"offset":805},"end":{"line":26,"column":13,"offset":813}}}],"position":{"start":{"line":26,"column":5,"offset":805},"end":{"line":26,"column":13,"offset":813}}},{"type":"text","value":" - Custom primaries","position":{"start":{"line":26,"column":13,"offset":813},"end":{"line":26,"column":32,"offset":832}}}],"position":{"start":{"line":26,"column":3,"offset":803},"end":{"line":26,"column":32,"offset":832}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"invalid","position":{"start":{"line":27,"column":5,"offset":837},"end":{"line":27,"column":14,"offset":846}}}],"position":{"start":{"line":27,"column":5,"offset":837},"end":{"line":27,"column":14,"offset":846}}},{"type":"text","value":" - Invalid primaries","position":{"start":{"line":27,"column":14,"offset":846},"end":{"line":27,"column":34,"offset":866}}}],"position":{"start":{"line":27,"column":3,"offset":835},"end":{"line":27,"column":34,"offset":866}}},{"type":"text","value":"\\n"}],"position":{"start":{"line":11,"column":3,"offset":210},"end":{"line":27,"column":34,"offset":866}}},{"type":"text","value":"\\n"}],"position":{"start":{"line":10,"column":1,"offset":109},"end":{"line":27,"column":34,"offset":866}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"text","value":"\\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"transfer","position":{"start":{"line":29,"column":3,"offset":870},"end":{"line":29,"column":13,"offset":880}}}],"position":{"start":{"line":29,"column":3,"offset":870},"end":{"line":29,"column":13,"offset":880}}},{"type":"text","value":" string - The transfer function of the color space. Can be one of the following values:","position":{"start":{"line":29,"column":13,"offset":880},"end":{"line":29,"column":100,"offset":967}}}],"position":{"start":{"line":29,"column":3,"offset":870},"end":{"line":29,"column":100,"offset":967}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"ul","properties":{},"children":[{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"bt709","position":{"start":{"line":30,"column":5,"offset":972},"end":{"line":30,"column":12,"offset":979}}}],"position":{"start":{"line":30,"column":5,"offset":972},"end":{"line":30,"column":12,"offset":979}}},{"type":"text","value":" - BT709 transfer function","position":{"start":{"line":30,"column":12,"offset":979},"end":{"line":30,"column":38,"offset":1005}}}],"position":{"start":{"line":30,"column":3,"offset":970},"end":{"line":30,"column":38,"offset":1005}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"bt709-apple","position":{"start":{"line":31,"column":5,"offset":1010},"end":{"line":31,"column":18,"offset":1023}}}],"position":{"start":{"line":31,"column":5,"offset":1010},"end":{"line":31,"column":18,"offset":1023}}},{"type":"text","value":" - BT709 Apple transfer function","position":{"start":{"line":31,"column":18,"offset":1023},"end":{"line":31,"column":50,"offset":1055}}}],"position":{"start":{"line":31,"column":3,"offset":1008},"end":{"line":31,"column":50,"offset":1055}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"gamma18","position":{"start":{"line":32,"column":5,"offset":1060},"end":{"line":32,"column":14,"offset
1":1069}}}],"position":{"start":{"line":32,"column":5,"offset":1060},"end":{"line":32,"column":14,"offset":1069}}},{"type":"text","value":" - Gamma 1.8 transfer function","position":{"start":{"line":32,"column":14,"offset":1069},"end":{"line":32,"column":44,"offset":1099}}}],"position":{"start":{"line":32,"column":3,"offset":1058},"end":{"line":32,"column":44,"offset":1099}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"gamma22","position":{"start":{"line":33,"column":5,"offset":1104},"end":{"line":33,"column":14,"offset":1113}}}],"position":{"start":{"line":33,"column":5,"offset":1104},"end":{"line":33,"column":14,"offset":1113}}},{"type":"text","value":" - Gamma 2.2 transfer function","position":{"start":{"line":33,"column":14,"offset":1113},"end":{"line":33,"column":44,"offset":1143}}}],"position":{"start":{"line":33,"column":3,"offset":1102},"end":{"line":33,"column":44,"offset":1143}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"gamma24","position":{"start":{"line":34,"column":5,"offset":1148},"end":{"line":34,"column":14,"offset":1157}}}],"position":{"start":{"line":34,"column":5,"offset":1148},"end":{"line":34,"column":14,"offset":1157}}},{"type":"text","value":" - Gamma 2.4 transfer function","position":{"start":{"line":34,"column":14,"offset":1157},"end":{"line":34,"column":44,"offset":1187}}}],"position":{"start":{"line":34,"column":3,"offset":1146},"end":{"line":34,"column":44,"offset":1187}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"gamma28","position":{"start":{"line":35,"column":5,"offset":1192},"end":{"line":35,"column":14,"offset":1201}}}],"position":{"start":{"line":35,"column":5,"offset":1192},"end":{"line":35,"column":14,"offset":1201}}},{"type":"text","value":" - Gamma 2.8 transfer function","position":{"start":{"line":35,"column":14,"offset":1201},"end":{"line":35,"column":44,"offset":1231}}}],"position":{"start":{"line":35,"column":3,"offset":1190},"end":{"line":35,"column":44,"offset":1231}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"smpte170m","position":{"start":{"line":36,"column":5,"offset":1236},"end":{"line":36,"column":16,"offset":1247}}}],"position":{"start":{"line":36,"column":5,"offset":1236},"end":{"line":36,"column":16,"offset":1247}}},{"type":"text","value":" - SMPTE170M transfer function","position":{"start":{"line":36,"column":16,"offset":1247},"end":{"line":36,"column":46,"offset":1277}}}],"position":{"start":{"line":36,"column":3,"offset":1234},"end":{"line":36,"column":46,"offset":1277}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"smpte240m","position":{"start":{"line":37,"column":5,"offset":1282},"end":{"line":37,"column":16,"offset":1293}}}],"position":{"start":{"line":37,"column":5,"offset":1282},"end":{"line":37,"column":16,"offset":1293}}},{"type":"text","value":" - SMPTE240M transfer function","position":{"start":{"line":37,"column":16,"offset":1293},"end":{"line":37,"column":46,"offset":1323}}}],"position":{"start":{"line":37,"column":3,"offset":1280},"end":{"line":37,"column":46,"offset":1323}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"linear","position":{"start":{"line":38,"column":5,"offset":1328},"end":{"line":38,"column":13,"offset":1336}}}],"position":{"start":{"line":38,"column":5,"offset":1328},"end":{"line":38,"column":13,"offset":1336}}},{"type":"text","value":" - Linear transfer function","position":{"start":{"line":38,"column":13,"offset":1336},"end":{"line":38,"column":40,"offset":1363}}}],"position":{"start":{"line":38,"column":3,"offset":1326},"end":{"line":38,"column":40,"offset":1363}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"log","position":{"start":{"line":39,"column":5,"offset":1368},"end":{"line":39,"column":10,"offset":1373}}}],"position":{"start":{"line":39,"column":5,"offset":1368},"end":{"line":39,"column":10,"offset":1373}}},{"type":"text","value":" - Log transfer function","position":{"start":{"line":39,"column":10,"offset":1373},"end":{"line":39,"column":34,"offset":1397}}}],"position":{"start":{"line":39,"column":3,"offset":1366},"end":{"line":39,"column":34,"offset":1397}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"log-sqrt","position":{"start":{"line":40,"column":5,"offset":1402}
1,"end":{"line":40,"column":15,"offset":1412}}}],"position":{"start":{"line":40,"column":5,"offset":1402},"end":{"line":40,"column":15,"offset":1412}}},{"type":"text","value":" - Log Square Root transfer function","position":{"start":{"line":40,"column":15,"offset":1412},"end":{"line":40,"column":51,"offset":1448}}}],"position":{"start":{"line":40,"column":3,"offset":1400},"end":{"line":40,"column":51,"offset":1448}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"iec61966-2-4","position":{"start":{"line":41,"column":5,"offset":1453},"end":{"line":41,"column":19,"offset":1467}}}],"position":{"start":{"line":41,"column":5,"offset":1453},"end":{"line":41,"column":19,"offset":1467}}},{"type":"text","value":" - IEC61966-2-4 transfer function","position":{"start":{"line":41,"column":19,"offset":1467},"end":{"line":41,"column":52,"offset":1500}}}],"position":{"start":{"line":41,"column":3,"offset":1451},"end":{"line":41,"column":52,"offset":1500}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"bt1361-ecg","position":{"start":{"line":42,"column":5,"offset":1505},"end":{"line":42,"column":17,"offset":1517}}}],"position":{"start":{"line":42,"column":5,"offset":1505},"end":{"line":42,"column":17,"offset":1517}}},{"type":"text","value":" - BT1361 ECG transfer function","position":{"start":{"line":42,"column":17,"offset":1517},"end":{"line":42,"column":48,"offset":1548}}}],"position":{"start":{"line":42,"column":3,"offset":1503},"end":{"line":42,"column":48,"offset":1548}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"srgb","position":{"start":{"line":43,"column":5,"offset":1553},"end":{"line":43,"column":11,"offset":1559}}}],"position":{"start":{"line":43,"column":5,"offset":1553},"end":{"line":43,"column":11,"offset":1559}}},{"type":"text","value":" - sRGB transfer function","position":{"start":{"line":43,"column":11,"offset":1559},"end":{"line":43,"column":36,"offset":1584}}}],"position":{"start":{"line":43,"column":3,"offset":1551},"end":{"line":43,"column":36,"offset":1584}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"bt2020-10","position":{"start":{"line":44,"column":5,"offset":1589},"end":{"line":44,"column":16,"offset":1600}}}],"position":{"start":{"line":44,"column":5,"offset":1589},"end":{"line":44,"column":16,"offset":1600}}},{"type":"text","value":" - BT2020-10 transfer function","position":{"start":{"line":44,"column":16,"offset":1600},"end":{"line":44,"column":46,"offset":1630}}}],"position":{"start":{"line":44,"column":3,"offset":1587},"end":{"line":44,"column":46,"offset":1630}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"bt2020-12","position":{"start":{"line":45,"column":5,"offset":1635},"end":{"line":45,"column":16,"offset":1646}}}],"position":{"start":{"line":45,"column":5,"offset":1635},"end":{"line":45,"column":16,"offset":1646}}},{"type":"text","value":" - BT2020-12 transfer function","position":{"start":{"line":45,"column":16,"offset":1646},"end":{"line":45,"column":46,"offset":1676}}}],"position":{"start":{"line":45,"column":3,"offset":1633},"end":{"line":45,"column":46,"offset":1676}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"pq","position":{"start":{"line":46,"column":5,"offset":1681},"end":{"line":46,"column":9,"offset":1685}}}],"position":{"start":{"line":46,"column":5,"offset":1681},"end":{"line":46,"column":9,"offset":1685}}},{"type":"text","value":" - PQ (Perceptual Quantizer) transfer function","position":{"start":{"line":46,"column":9,"offset":1685},"end":{"line":46,"column":55,"offset":1731}}}],"position":{"start":{"line":46,"column":3,"offset":1679},"end":{"line":46,"column":55,"offset":1731}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"smptest428-1","position":{"start":{"line":47,"column":5,"offset":1736},"end":{"line":47,"column":19,"offset":1750}}}],"position":{"start":{"line":47,"column":5,"offset":1736},"end":{"line":47,"column":19,"offset":1750}}},{"type":"text","value":" - SMPTEST428-1 transfer function","position":{"start":{"line":47,"column":19,"offset":1750},"end":{"line":47,"column":52,"offset":1783}}}],"position":{"start":{"line":47,"column":3,"offset":1734},"end":{"line":47,"column":52,"offset":1783}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"hlg","position":{"start":{"line":48,"column":5,"offset":1788},"end":{"line":48,"column":10,"offset":1793}}}],"position":{"start":{"line":48,"column":5,"offset":1788},"end":{"line":48,"column":10,"offset":1793}}},{"type":"text","value":" - HLG (Hybrid Log-Gamma) transfer function","position":{"start":{"line":48,"column":10,"offset":1793},"end":{"line":48,"column":53,"offset":1836}}}],"position":{"start":{"line":48,"column":3,"offset":1786},"end":{"line":48,"column":53,"offset":1836}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"srgb-hdr","position":{"start":{"line":49,"column":5,"offset":1841},"end":{"line":49,"column":15,"offset":1851}}}],"position":{"start":{"line":49,"column":5,"offset":1841},"end":{"line":49,"column":15,"offset":1851}}},{"type":"text","value":" - sRGB HDR transfer function","position":{"start":{"line":49,"column":15,"offset":1851},"end":{"line":49,"column":44,"offset":1880}}}],"position":{"start":{"line":49,"column":3,"offset":1839},"end":{"line":49,"column":44,"offset":1880}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"linear-hdr","position":{"start":{"line":50,"column":5,"offset":1885},"end":{"line":50,"column":17,"offset":1897}}}],"position":{"start":{"line":50,"column":5,"offset":1885},"end":{"line":50,"column":17,"offset":1897}}},{"type":"text","value":" - Linear HDR transfer function","position":{"start":{"line":50,"column":17,"offset":1897},"end":{"line":50,"column":48,"offset":1928}}}],"position":{"start":{"line":50,"column":3,"offset":1883},"end":{"line":50,"column":48,"offset":1928}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"custom","position":{"start":{"line":51,"column":5,"offset":1933},"end":{"line":51,"column":13,"offset":1941}}}],"position":{"start":{"line":51,"column":5,"offset":1933},"end":{"line":51,"column":13,"offset":1941}}},{"type":"text","value":" - Custom transfer function","position":{"start":{"line":51,"column":13,"offset":1941},"end":{"line":51,"column":40,"offset":1968}}}],"position":{"start":{"line":51,"column":3,"offset":1931},"end":{"line":51,"column":40,"offset":1968}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"custom-hdr","position":{"start":{"line":52,"column":5,"offset":1973},"end":{"line":52,"column":17,"offset":1985}}}],"position":{"start":{"line":52,"column":5,"offset":1973},"end":{"line":52,"column":17,"offset":1985}}},{"type":"text","value":" - Custom HDR transfer function","position":{"start":{"line":52,"column":17,"offset":1985},"end":{"line":52,"column":48,"offset":2016}}}],"position":{"start":{"line":52,"column":3,"offset":1971},"end":{"line":52,"column":48,"offset":2016}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"scrgb-linear-80-nits","position":{"start":{"line":53,"column":5,"offset":2021},"end":{"line":53,"column":27,"offset":2043}}}],"position":{"start":{"line":53,"column":5,"offset":2021},"end":{"line":53,"column":27,"offset":2043}}},{"type":"text","value":" - scRGB Linear 80 nits transfer function","position":{"start":{"line":53,"column":27,"offset":2043},"end":{"line":53,"column":68,"offset":2084}}}],"position":{"start":{"line":53,"column":3,"offset":2019},"end":{"line":53,"column":68,"offset":2084}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"invalid","position":{"start":{"line":54,"column":5,"offset":2089},"end":{"line":54,"column":14,"offset":2098}}}],"position":{"start":{"line":54,"column":5,"offset":2089},"end":{"line":54,"column":14,"offset":2098}}},{"type":"text","value":" - Invalid transfer function","position":{"start":{"line":54,"column":14,"offset":2098},"end":{"line":54,"column":42,"offset":2126}}}],"position":{"start":{"line":54,"column":3,"offset":2087},"end":{"line":54,"column":42,"offset":2126}}},{"type":"text","value":"\\n"}],"position":{"start":{"line":30,"column":3,"offset":970},"end":{"line":54,"column":42,"offset":2126}}},{"type":"text","value":"\\n"}],"position":{"start":{"line":29,"column":1,"offset":868},"end":{"line":54,"column":42,"offset":2126}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"text","value":"\\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"matrix","position":{"start":{"line":56,"column":3,"offset":2130},"end":{"line":56,"column":11,"offset":2138}}}],"position":{"start":{"line":56,"column":3,"offset":2130},"end":{"line":56,"column":11,"offset":2138}}},{"type":"text","value":" string - The color matrix of the color space. Can be one of the following values:","position":{"start":{"line":56,"column":11,"offset":2138},"end":{"line":56,"column":93,"offset":2220}}}],"position":{"start":{"line":56,"column":3,"offset":2130},"end":{"line":56,"column":93,"offset":2220}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"ul","properties":{},"children":[{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"rgb","position":{"start":{"line":57,"column":5,"offset":2225},"end":{"line":57,"column":10,"offset":2230}}}],"position":{"start":{"line":57,"column":5,"offset":2225},"end":{"line":57,"column":10,"offset":2230}}},{"type":"text","value":" - RGB matrix","position":{"start":{"line":57,"column":10,"offset":2230},"end":{"line":57,"column":23,"offset":2243}}}],"position":{"start":{"line":57,"column":3,"offset":2223},"end":{"line":57,"column":23,"offset":2243}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"bt709","position":{"start":{"line":58,"column":5,"offset":2248},"end":{"line":58,"column":12,"offset":2255}}}],"position":{"start":{"line":58,"column":5,"offset":2248},"end":{"line":58,"column":12,"offset":2255}}},{"type":"text","value":" - BT709 matrix","position":{"start":{"line":58,"column":12,"offset":2255},"end":{"line":58,"column":27,"offset":2270}}}],"position":{"start":{"line":58,"column":3,"offset":2246},"end":{"line":58,"column":27,"offset":2270}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"fcc","position":{"start":{"line":59,"column":5,"offset":2275},"end":{"line":59,"column":10,"offset":2280}}}],"position":{"start":{"line":59,"column":5,"offset":2275},"end":{"line":59,"column":10,"offset":2280}}},{"type":"text","value":" - FCC matrix","position":{"start":{"line":59,"column":10,"offset":2280},"end":{"line":59,"column":23,"offset":2293}}}],"position":{"start":{"line":59,"column":3,"offset":2273},"end":{"line":59,"column":23,"offset":2293}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"bt470bg","position":{"start":{"line":60,"column":5,"offset":2298},"end":{"line":60,"column":14,"offset":2307}}}],"position":{"start":{"line":60,"column":5,"offset":2298},"end":{"line":60,"column":14,"offset":2307}}},{"type":"text","value":" - BT470BG matrix","position":{"start":{"line":60,"column":14,"offset":2307},"end":{"line":60,"column":31,"offset":2324}}}],"position":{"start":{"line":60,"column":3,"offset":2296},"end":{"line":60,"column":31,"offset":2324}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"smpte170m","position":{"start":{"line":61,"column":5,"offset":2329},"end":{"line":61,"column":16,"offset":2340}}}],"position":{"start":{"line":61,"column":5,"offset":2329},"end":{"line":61,"column":16,"offset":2340}}},{"type":"text","value":" - SMPTE170M matrix","position":{"start":{"line":61,"column":16,"offset":2340},"end":{"line":61,"column":35,"offset":2359}}}],"position":{"start":{"line":61,"column":3,"offset":2327},"end":{"line":61,"column":35,"offset":2359}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"smpte240m","position":{"start":{"line":62,"column":5,"offset":2364},"end":{"line":62,"column":16,"offset":2375}}}],"position":{"start":{"line":62,"column":5,"offset":2364},"end":{"line":62,"column":16,"offset":2375}}},{"type":"text","value":" - SMPTE240M matrix","position":{"start":{"line":62,"column":16,"offset":2375},"end":{"line":62,"column":35,"offset":2394}}}],"position":{"start":{"line":62,"column":3,"offset":2362},"end":{"line":62,"column":35,"offset":2394}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"ycocg","position":{"start":{"line":63,"column":5,"offset":2399},"end":{"line":63,"column":12,"offset":2406}}}],"position":{"start":{"line":63,"column":5,"offset":2399},"end":{"line":63,"column":12,"offset":2406}}},{"type":"text","value":" - YCoCg matrix","position":{"start":{"line":63,"column":12,"offset":2406},"end":{"line":63,"column":27,"offset":2421}}}],"position":{"start":{"line":63,"column":3,"offset":2397},"end":{"line":63,"column":27,"offset":2421}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"bt2020-ncl","position":{"start":{"line":64,"column":5,"offset":2426},"end":{"line":64,"column":17,"offset":2438}}}],"position":{"start":{"line":64,"column":5,"offset":2426},"end":{"line":64,"column":17,"offset":2438}}},{"type":"text","value":" - BT2020 NCL matrix","position":{"start":{"line":64,"column":17,"offset":2438},"end":{"line":64,"column":37,"offset":2458}}}],"position":{"start":{"line":64,"column":3,"offset":2424},"end":{"line":64,"column":37,"offset":2458}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"ydzdx","position":{"start":{"line":65,"column":5,"offset":2463},"end":{"line":65,"column":12,"offset":2470}}}],"position":{"start":{"line":65,"column":5,"offset":2463},"end":{"line":65,"column":12,"offset":24
170}}},{"type":"text","value":" - YDzDx matrix","position":{"start":{"line":65,"column":12,"offset":2470},"end":{"line":65,"column":27,"offset":2485}}}],"position":{"start":{"line":65,"column":3,"offset":2461},"end":{"line":65,"column":27,"offset":2485}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"gbr","position":{"start":{"line":66,"column":5,"offset":2490},"end":{"line":66,"column":10,"offset":2495}}}],"position":{"start":{"line":66,"column":5,"offset":2490},"end":{"line":66,"column":10,"offset":2495}}},{"type":"text","value":" - GBR matrix","position":{"start":{"line":66,"column":10,"offset":2495},"end":{"line":66,"column":23,"offset":2508}}}],"position":{"start":{"line":66,"column":3,"offset":2488},"end":{"line":66,"column":23,"offset":2508}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"invalid","position":{"start":{"line":67,"column":5,"offset":2513},"end":{"line":67,"column":14,"offset":2522}}}],"position":{"start":{"line":67,"column":5,"offset":2513},"end":{"line":67,"column":14,"offset":2522}}},{"type":"text","value":" - Invalid matrix","position":{"start":{"line":67,"column":14,"offset":2522},"end":{"line":67,"column":31,"offset":2539}}}],"position":{"start":{"line":67,"column":3,"offset":2511},"end":{"line":67,"column":31,"offset":2539}}},{"type":"text","value":"\\n"}],"position":{"start":{"line":57,"column":3,"offset":2223},"end":{"line":67,"column":31,"offset":2539}}},{"type":"text","value":"\\n"}],"position":{"start":{"line":56,"column":1,"offset":2128},"end":{"line":67,"column":31,"offset":2539}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"text","value":"\\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"range","position":{"start":{"line":69,"column":3,"offset":2543},"end":{"line":69,"column":10,"offset":2550}}}],"position":{"start":{"line":69,"column":3,"offset":2543},"end":{"line":69,"column":10,"offset":2550}}},{"type":"text","value":" string - The color range of the color space. Can be one of the following values:","position":{"start":{"line":69,"column":10,"offset":2550},"end":{"line":69,"column":91,"offset":2631}}}],"position":{"start":{"line":69,"column":3,"offset":2543},"end":{"line":69,"column":91,"offset":2631}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"ul","properties":{},"children":[{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"limited","position":{"start":{"line":70,"column":5,"offset":2636},"end":{"line":70,"column":14,"offset":2645}}}],"position":{"start":{"line":70,"column":5,"offset":2636},"end":{"line":70,"column":14,"offset":2645}}},{"type":"text","value":" - Limited color range (RGB values ranging from 16 to 235)","position":{"start":{"line":70,"column":14,"offset":2645},"end":{"line":70,"column":72,"offset":2703}}}],"position":{"start":{"line":70,"column":3,"offset":2634},"end":{"line":70,"column":72,"offset":2703}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"full","position":{"start":{"line":71,"column":5,"offset":2708},"end":{"line":71,"column":11,"offset":2714}}}],"position":{"start":{"line":71,"column":5,"offset":2708},"end":{"line":71,"column":11,"offset":2714}}},{"type":"text","value":" - Full color range (RGB values from 0 to 255)","position":{"start":{"line":71,"column":11,"offset":2714},"end":{"line":71,"column":57,"offset":2760}}}],"position":{"start":{"line":71,"column":3,"offset":2706},"end":{"line":71,"column":57,"offset":2760}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"derived","position":{"start":{"line":72,"column":5,"offset":2765},"end":{"line":72,"column":14,"offset":2774}}}],"position":{"start":{"line":72,"column":5,"offset":2765},"end":{"line":72,"column":14,"offset":2774}}},{"type":"text","value":" - Range defined by the transfer function and matrix","position":{"start":{"line":72,"column":14,"offset":2774},"end":{"line":72,"column":66,"offset":2826}}}],"position":{"start":{"line":72,"column":3,"offset":2763},"end":{"line":72,"column":66,"offset":2826}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"invalid","position":{"start":{"line":73,"column":5,"offset":2831},"end":{"line":73,"column":14,"offset":2840}}}],"position":{"start":{"line":73,"column":5,"offset":2831},"end":{"line":73,"column":14,"offset":2840}}},{"type":"text","value":" - Invalid range","position":{"start":{"line":73,"column":14,"offset":2840},"end":{"line":73,"column":30,"offset":2856}}}],"position":{"start":{"line":73,"column":3,"offset":2829},"end":{"line":73,"column":30,"offset":2856}}},{"type":"text","value":"\\n"}],"position":{"start":{"line":70,"column":3,"offset":2634},"end":{"line":73,"column":30,"offset":2856}}},{"type":"text","value":"\\n"}],"position":{"start":{"line":69,"column":1,"offset":2541},"end":{"line":73,"column":30,"offset":2856}}},{"type":"text","value":"\\n"}],"position":{"start":{"line":10,"column":1,"offset":109},"end":{"line":73,"column":30,"offset":2856}}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":203,"column":1,"offset":4743}}}'})," (optional) - The target color space\nfor the output pixel data. Defaults to sRGB. Pass the image's original color space to\npreserve the previous behavior, or another color space to get pixel values in that space."]}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["Returns ",(0,i.jsx)(t.code,{children:"Buffer"})," - A ",(0,i.jsx)(t.a,{href:"https://nodejs.org/api/buffer.html#buffer_class_buffer",children:"Buffer"}
1)," that contains a copy of the image's raw bitmap pixel\ndata."]}),"\n",(0,i.jsx)(t.h4,{id:"imagetodataurloptions",children:(0,i.jsx)(t.code,{children:"image.toDataURL([options])"})}),"\n",(0,i.jsx)(s.A,{apiHistoryJson:'{"changes":[{"pr-url":"https://github.com/electron/electron/pull/41752","description":"`nativeImage.toDataURL` will preserve PNG colorspace","breaking-changes-header":"behavior-changed-nativeimagetodataurl-will-preserve-png-colorspace"}]}',prReleaseVersionsJson:'{"41752":{"release":"32.0.0","backports":[]}}'}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{className:"electron-api-options-list",children:[(0,i.jsx)(t.code,{children:"options"})," Object (optional)","\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"scaleFactor"})," Number (optional) - Defaults to 1.0."]}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["Returns ",(0,i.jsx)(t.code,{children:"string"})," - The ",(0,i.jsx)(t.a,{href:"https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs",children:"Data URL"})," of the image."]}),"\n",(0,i.jsxs)(t.h4,{id:"imagegetbitmapoptions-deprecated",children:[(0,i.jsx)(t.code,{children:"image.getBitmap([options])"})," ",(0,i.jsx)(t.em,{className:"badge badge--danger",children:"Deprecated"})]}),"\n",(0,i.jsx)(s.A,{apiHistoryJson:'{"changes":[{"pr-url":"https://github.com/electron/electron/pull/48178","description":"Normalized `NativeImage.toBitmap()` pixel data to sRGB by default.","breaking-changes-header":"behavior-changed-nativeimagetobitmap-now-normalizes-color-space"}]}',prReleaseVersionsJson:'{"48178":{"release":null,"backports":["43.0.0"]}}'}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{className:"electron-api-options-list",children:[(0,i.jsx)(t.code,{children:"options"})," Object (optional)","\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"scaleFactor"})," Number (optional) - Defaults to 1.0."]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"colorSpace"})," ",(0,i.jsx)(a.A,{url:"/docs/latest/api/structures/color-space",title:"ColorSpace",content:'{"type":"root","children":[{"type":"element","tagName":"h1","properties":{},"children":[{"type":"text","value":"ColorSpace Object"}]},{"type":"text","value":"\\n"},{"type":"element","tagName":"ul","properties":{},"children":[{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"text","value":"\\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"primaries","position":{"start":{"line":10,"column":3,"offset":111},"end":{"line":10,"column":14,"offset":122}}}],"position":{"start":{"line":10,"column":3,"offset":111},"end":{"line":10,"column":14,"offset":122}}},{"type":"text","value":" string - The color primaries of the color space. Can be one of the following values:","position":{"start":{"line":10,"column":14,"offset":122},"end":{"line":10,"column":99,"offset":207}}}],"position":{"start":{"line":10,"column":3,"offset":111},"end":{"line":10,"column":99,"offset":207}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"ul","properties":{},"children":[{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"bt709","position":{"start":{"line":11,"column":5,"offset":212},"end":{"line":11,"column":12,"offset":219}}}],"position":{"start":{"line":11,"column":5,"offset":212},"end":{"line":11,"column":12,"offset":219}}},{"type":"text","value":" - BT709 primaries (also used for sRGB)","position":{"start":{"line":11,"column":12,"offset":219},"end":{"line":11,"column":51,"offset":258}}}],"position":{"start":{"line":11,"column":3,"offset":210},"end":{"line":11,"column":51,"offset":258}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"bt470m","position":{"start":{"line":12,"column":5,"offset":263},"end":{"line":12,"column":13,"offset":271}}}],"position":{"start":{"line":12,"column":5,"offset":263},"end":{"line":12,"column":13,"offset":271}}},{"type":"text","value":" - BT470M primaries","position":{"start":{"line":12,"column":13,"offset":271},"end":{"line":12,"column":32,"offset":290}}}],"position":{"start":{"line":12,"column":3,"offset":261},"end":{"line":12,"column":32,"offset":290}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"bt470bg","position":{"start":{"line":13,"column":5,"offset":295},"end":{"line":13,"column":14,"offset":304}}}],"position":{"start":{"line":13,"column":5,"offset":295},"end":{"line":13,"column":14,"offset":304}}},{"type":"text","value":" - BT470BG primaries","position":{"start":{"line":13,"column":14,"offset":304},"end":{"line":13,"column":34,"offset":324}}}],"position":{"start":{"line":13,"column":3,"offset":293},"end":{"line":13,"column":34,"offset":324}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"smpte170m","position":{"start":{"line":14,"column":5,"offset":329},"end":{"line":14,"column":16,"offset":340}}}],"position":{"start":{"line":14,"column":5,"offset":329},"end":{"line":14,"column":16,"offset":340}}},{"type":"text","value":" - SMPTE170M primaries","position":{"start":{"line":14,"column":16,"offset":340},"end":{"line":14,"column":38,"offset":362}}}],"position":{"start":{"line":14,"column":3,"offset":327},"end":{"line":14,"column":38,"offset":362}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"smpte240m","position":{"start":{"line":15,"column":5,"offset":367},"end":{"line":15,"column":16,"offset":378}}}],"position":{"start":{"line":15,"column":5,"offset":367},"end":{"line":15,"column":16,"offset":378}}},{"type":"text","value":" - SMPTE240M primaries","position":{"start":{"line":15,"column":16,"offset":378},"end":{"line":15,"column":38,"offset":400}}}],"position":{"start":{"line":15,"column":3,"offset":365},"end":{"line":15,"column":38,"offset":400}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"film","position":{"start":{"line":16,"column":5,"offset":405},"end":{"line":16,"column":11,"offset":411}}}],"position":{"start":{"line":16,"column":5,"offset":405},"end":{"line":16,"column":11,"offset":411}}},{"type":"text","value":" - Film primaries","position":{"start":{"line":16,"column":11,"offset":411},"end":{"line":16,"column":28,"offset":428}}}],"position":{"start":{"line":16,"column":3,"offset":403},"end":{"line":16,"column":28,"offset":428}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"bt2020","position":{"start":{"line":17,"column":5,"offset":433},"end":{"line":17,"column":13,"offset":441}}}],"position":{"start":{"line":17,"column":5,"offset":433},"end":{"line":17,"column":13,"offset":441}}},{"type":"text","value":" - BT2020 primaries","position":{"start":{"line":17,"column":13,"offset":441},"end":{"line":17,"column":32,"offset":460}}}],"position":{"start":{"line":17,"column":3,"offset":431},"end":{"line":17,"column":32,"offset":460}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"smptest428-1","position":{"start":{"line":18,"column":5,"offset":465},"end":{"line":18,"column":19,"offset":479}}}],"position":{"start":{"line":18,"column":5,"offset":465},"end":{"line":18,"column":19,"offset":479}}},{"type":"text","value":" - SMPTEST428-1 primaries","position":{"start":{"line":18,"column":19,"offset":479},"end":{"line":18,"column":44,"offset":504}}}],"position":{"start":{"line":18,"column":3,"offset":463},"end":{"line":18,"column":44,"offset":504}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"smptest431-2","position":{"start":{"line":19,"column":5,"offset":509},"end":{"line":19,"column":19,"offset":523}}}],"position":{"start":{"line":19,"column":5,"offset":509},"end":{"line":19,"column":19,"offset":523}}},{"type":"text","value":" - SMPTEST431-2 primaries","position":{"start":{"line":19,"column":19,"offset":523},"end":{"line":19,"column":44,"offset":548}}}],"position":{"start":{"line":19,"column":3,"offset":507},"end":{"line":19,"column":44,"offset":548}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"p3","position":{"start":{"line":20,"column":5,"offset":553},"end":{"line":20,"column":9,"offset":557}}}],"position":{"start":{"line":20,"column":5,"offset":553},"end":{"line":20,"column":9,"offset":557}}},{"type":"text","value":" - P3 primaries","position":{"start":{"line":20,"column":9,"offset":557},"end":{"line":20,"column":24,"offset":572}}}],"position":{"start":{"line":20,"column":3,"offset":551},"end":{"line":20,"column":24,"offset":572}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"xyz-d50","position":{"start":{"line":21,"column":5,"offset":577},"end":{"line":21,"column":14,"offset":586}}}],"position":{"start":{"line":21,"column":5,"offset":577},"end":{"line":21,"column":14,"offset":586}}},{"type":"text","value":" - XYZ D50 primaries","position":{"start":{"line":21,"column":14,"offset":586},"end":{"line":21,"column":34,"offset":606}}}],"position":{"start":{"line":21,"column":3,"offset":575},"end":{"line":21,"column":34,"offset":606}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"adobe-rgb","position":{"start":{"line":22,"column":5,"offset":611},"end":{"line":22,"column":16,"offset":622}}}],"position":{"start":{"line":22,"column":5,"offset":611},"end":{"line":22,"column":16,"offset":622}}},{"type":"text","value":" - Adobe RGB primaries","position":{"start":{"line":22,"column":16,"offset":622},"end":{"line":22,"column":38,"offset":644}}}],"position":{"start":{"line":22,"column":3,"offset":609},"end":{"line":22,"column":38,"offset":644}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"apple-generic-rgb","position":{"start":{"line":23,"column":5,"offset":649},"end":{"line":23,"column":24,"offset":668}}}],"position":{"start":{"line":23,"column":5,"offset":649},"end":{"line":23,"column":24,"offset":668}}},{"type":"text","value":" - Apple Generic RGB primaries","position":{"start":{"line":23,"column":24,"offset":668},"end":{"line":23,"column":54,"offset":698}}}],"position":{"start":{"line":23,"column":3,"offset":647},"end":{"line":23,"column":54,"offset":698}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"wide-gamut-color-spin","position":{"start":{"line":24,"column":5,"offset":703},"end":{"line":24,"column":28,"offset":726}}}],"position":{"start":{"line":24,"column":5,"offset":703},"end":{"line":24,"column":28,"offset":726}}},{"type":"text","value":" - Wide Gamut Color Spin primaries","position":{"start":{"line":24,"column":28,"offset":726},"end":{"line":24,"column":62,"offset":760}}}],"position":{"start":{"line":24,"column":3,"offset":701},"end":{"line":24,"column":62,"offset":760}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"ebu-3213-e","position":{"start":{"line":25,"column":5,"offset":765},"end":{"line":25,"column":17,"offset":777}}}],"position":{"start":{"line":25,"column":5,"offset":765},"end":{"line":25,"column":17,"offset":777}}},{"type":"text","value":" - EBU 3213-E primaries","position":{"start":{"line":25,"column":17,"offset":777},"end":{"line":25,"column":40,"offset":800}}}],"position":{"start":{"line":25,"column":3,"offset":763},"end":{"line":25,"column":40,"offset":800}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"custom","position":{"start":{"line":26,"column":5,"offset":805},"end":{"line":26,"column":13,"offset":813}}}],"position":{"start":{"line":26,"column":5,"offset":805},"end":{"line":26,"column":13,"offset":813}}},{"type":"text","value":" - Custom primaries","position":{"start":{"line":26,"column":13,"offset":813},"end":{"line":26,"column":32,"offset":832}}}],"position":{"start":{"line":26,"column":3,"offset":803},"end":{"line":26,"column":32,"offset":832}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"invalid","position":{"start":{"line":27,"column":5,"offset":837},"end":{"line":27,"column":14,"offset":846}}}],"position":{"start":{"line":27,"column":5,"offset":837},"end":{"line":27,"column":14,"offset":846}}},{"type":"text","value":" - Invalid primaries","position":{"start":{"line":27,"column":14,"offset":846},"end":{"line":27,"column":34,"offset":866}}}],"position":{"start":{"line":27,"column":3,"offset":835},"end":{"line":27,"column":34,"offset":866}}},{"type":"text","value":"\\n"}],"position":{"start":{"line":11,"column":3,"offset":210},"end":{"line":27,"column":34,"offset":866}}},{"type":"text","value":"\\n"}],"position":{"start":{"line":10,"column":1,"offset":109},"end":{"line":27,"column":34,"offset":866}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"text","value":"\\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"transfer","position":{"start":{"line":29,"column":3,"offset":870},"end":{"line":29,"column":13,"offset":880}}}],"position":{"start":{"line":29,"column":3,"offset":870},"end":{"line":29,"column":13,"offset":880}}},{"type":"text","value":" string - The transfer function of the color space. Can be one of the following values:","position":{"start":{"line":29,"column":13,"offset":880},"end":{"line":29,"column":100,"offset":967}}}],"position":{"start":{"line":29,"column":3,"offset":870},"end":{"line":29,"column":100,"offset":967}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"ul","properties":{},"children":[{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"bt709","position":{"start":{"line":30,"column":5,"offset":972},"end":{"line":30,"column":12,"offset":979}}}],"position":{"start":{"line":30,"column":5,"offset":972},"end":{"line":30,"column":12,"offset":979}}},{"type":"text","value":" - BT709 transfer function","position":{"start":{"line":30,"column":12,"offset":979},"end":{"line":30,"column":38,"offset":1005}}}],"position":{"start":{"line":30,"column":3,"offset":970},"end":{"line":30,"column":38,"offset":1005}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"bt709-apple","position":{"start":{"line":31,"column":5,"offset":1010},"end":{"line":31,"column":18,"offset":1023}}}],"position":{"start":{"line":31,"column":5,"offset":1010},"end":{"line"
1:31,"column":18,"offset":1023}}},{"type":"text","value":" - BT709 Apple transfer function","position":{"start":{"line":31,"column":18,"offset":1023},"end":{"line":31,"column":50,"offset":1055}}}],"position":{"start":{"line":31,"column":3,"offset":1008},"end":{"line":31,"column":50,"offset":1055}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"gamma18","position":{"start":{"line":32,"column":5,"offset":1060},"end":{"line":32,"column":14,"offset":1069}}}],"position":{"start":{"line":32,"column":5,"offset":1060},"end":{"line":32,"column":14,"offset":1069}}},{"type":"text","value":" - Gamma 1.8 transfer function","position":{"start":{"line":32,"column":14,"offset":1069},"end":{"line":32,"column":44,"offset":1099}}}],"position":{"start":{"line":32,"column":3,"offset":1058},"end":{"line":32,"column":44,"offset":1099}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"gamma22","position":{"start":{"line":33,"column":5,"offset":1104},"end":{"line":33,"column":14,"offset":1113}}}],"position":{"start":{"line":33,"column":5,"offset":1104},"end":{"line":33,"column":14,"offset":1113}}},{"type":"text","value":" - Gamma 2.2 transfer function","position":{"start":{"line":33,"column":14,"offset":1113},"end":{"line":33,"column":44,"offset":1143}}}],"position":{"start":{"line":33,"column":3,"offset":1102},"end":{"line":33,"column":44,"offset":1143}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"gamma24","position":{"start":{"line":34,"column":5,"offset":1148},"end":{"line":34,"column":14,"offset":1157}}}],"position":{"start":{"line":34,"column":5,"offset":1148},"end":{"line":34,"column":14,"offset":1157}}},{"type":"text","value":" - Gamma 2.4 transfer function","position":{"start":{"line":34,"column":14,"offset":1157},"end":{"line":34,"column":44,"offset":1187}}}],"position":{"start":{"line":34,"column":3,"offset":1146},"end":{"line":34,"column":44,"offset":1187}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"gamma28","position":{"start":{"line":35,"column":5,"offset":1192},"end":{"line":35,"column":14,"offset":1201}}}],"position":{"start":{"line":35,"column":5,"offset":1192},"end":{"line":35,"column":14,"offset":1201}}},{"type":"text","value":" - Gamma 2.8 transfer function","position":{"start":{"line":35,"column":14,"offset":1201},"end":{"line":35,"column":44,"offset":1231}}}],"position":{"start":{"line":35,"column":3,"offset":1190},"end":{"line":35,"column":44,"offset":1231}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"smpte170m","position":{"start":{"line":36,"column":5,"offset":1236},"end":{"line":36,"column":16,"offset":1247}}}],"position":{"start":{"line":36,"column":5,"offset":1236},"end":{"line":36,"column":16,"offset":1247}}},{"type":"text","value":" - SMPTE170M transfer function","position":{"start":{"line":36,"column":16,"offset":1247},"end":{"line":36,"column":46,"offset":1277}}}],"position":{"start":{"line":36,"column":3,"offset":1234},"end":{"line":36,"column":46,"offset":1277}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"smpte240m","position":{"start":{"line":37,"column":5,"offset":1282},"end":{"line":37,"column":16,"offset":1293}}}],"position":{"start":{"line":37,"column":5,"offset":1282},"end":{"line":37,"column":16,"offset":1293}}},{"type":"text","value":" - SMPTE240M transfer function","position":{"start":{"line":37,"column":16,"offset":1293},"end":{"line":37,"column":46,"offset":1323}}}],"position":{"start":{"line":37,"column":3,"offset":1280},"end":{"line":37,"column":46,"offset":1323}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"linear","position":{"start":{"line":38,"column":5,"offset":1328},"end":{"line":38,"column":13,"offset":1336}}}],"position":{"start":{"line":38,"column":5,"offset":1328},"end":{"line":38,"column":13,"offset":1336}}},{"type":"text","value":" - Linear transfer function","position":{"start":{"line":38,"column":13,"offset":1336},"end":{"line":38,"column":40,"offset":1363}}}],"position":{"start":{"line":38,"column":3,"offset":1326},"end":{"line":38,"column":40,"offset":1363}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"log","position":{"start":{"line":39,"column":5,"offset":1368},"end":{"line":39,"column":10,"offset":1373}}}],"position":{"start":{"line":39,"column":5,"offset":1368},"end":{"line":39,"column":10,"offset":1373}}},{"type":"text","value":" - Log transfer function","position":{"start":{"line":39,"column":10,"offset":1373},"end":{"line":39,"column":34,"offset":1397}}}],"position":{"start":{"line":39,"column":3,"offset":1366},"end":{"line":39,"column":34,"offset":1397}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"log-sqrt","position":{"start":{"line":40,"column":5,"offset":1402}
1,"end":{"line":40,"column":15,"offset":1412}}}],"position":{"start":{"line":40,"column":5,"offset":1402},"end":{"line":40,"column":15,"offset":1412}}},{"type":"text","value":" - Log Square Root transfer function","position":{"start":{"line":40,"column":15,"offset":1412},"end":{"line":40,"column":51,"offset":1448}}}],"position":{"start":{"line":40,"column":3,"offset":1400},"end":{"line":40,"column":51,"offset":1448}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"iec61966-2-4","position":{"start":{"line":41,"column":5,"offset":1453},"end":{"line":41,"column":19,"offset":1467}}}],"position":{"start":{"line":41,"column":5,"offset":1453},"end":{"line":41,"column":19,"offset":1467}}},{"type":"text","value":" - IEC61966-2-4 transfer function","position":{"start":{"line":41,"column":19,"offset":1467},"end":{"line":41,"column":52,"offset":1500}}}],"position":{"start":{"line":41,"column":3,"offset":1451},"end":{"line":41,"column":52,"offset":1500}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"bt1361-ecg","position":{"start":{"line":42,"column":5,"offset":1505},"end":{"line":42,"column":17,"offset":1517}}}],"position":{"start":{"line":42,"column":5,"offset":1505},"end":{"line":42,"column":17,"offset":1517}}},{"type":"text","value":" - BT1361 ECG transfer function","position":{"start":{"line":42,"column":17,"offset":1517},"end":{"line":42,"column":48,"offset":1548}}}],"position":{"start":{"line":42,"column":3,"offset":1503},"end":{"line":42,"column":48,"offset":1548}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"srgb","position":{"start":{"line":43,"column":5,"offset":1553},"end":{"line":43,"column":11,"offset":1559}}}],"position":{"start":{"line":43,"column":5,"offset":1553},"end":{"line":43,"column":11,"offset":1559}}},{"type":"text","value":" - sRGB transfer function","position":{"start":{"line":43,"column":11,"offset":1559},"end":{"line":43,"column":36,"offset":1584}}}],"position":{"start":{"line":43,"column":3,"offset":1551},"end":{"line":43,"column":36,"offset":1584}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"bt2020-10","position":{"start":{"line":44,"column":5,"offset":1589},"end":{"line":44,"column":16,"offset":1600}}}],"position":{"start":{"line":44,"column":5,"offset":1589},"end":{"line":44,"column":16,"offset":1600}}},{"type":"text","value":" - BT2020-10 transfer function","position":{"start":{"line":44,"column":16,"offset":1600},"end":{"line":44,"column":46,"offset":1630}}}],"position":{"start":{"line":44,"column":3,"offset":1587},"end":{"line":44,"column":46,"offset":1630}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"bt2020-12","position":{"start":{"line":45,"column":5,"offset":1635},"end":{"line":45,"column":16,"offset":1646}}}],"position":{"start":{"line":45,"column":5,"offset":1635},"end":{"line":45,"column":16,"offset":1646}}},{"type":"text","value":" - BT2020-12 transfer function","position":{"start":{"line":45,"column":16,"offset":1646},"end":{"line":45,"column":46,"offset":1676}}}],"position":{"start":{"line":45,"column":3,"offset":1633},"end":{"line":45,"column":46,"offset":1676}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"pq","position":{"start":{"line":46,"column":5,"offset":1681},"end":{"line":46,"column":9,"offset":1685}}}],"position":{"start":{"line":46,"column":5,"offset":1681},"end":{"line":46,"column":9,"offset":1685}}},{"type":"text","value":" - PQ (Perceptual Quantizer) transfer function","position":{"start":{"line":46,"column":9,"offset":1685},"end":{"line":46,"column":55,"offset":1731}}}],"position":{"start":{"line":46,"column":3,"offset":1679},"end":{"line":46,"column":55,"offset":1731}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"smptest428-1","position":{"start":{"line":47,"column":5,"offset":1736},"end":{"line":47,"column":19,"offset":1750}}}],"position":{"start":{"line":47,"column":5,"offset":1736},"end":{"line":47,"column":19,"offset":1750}}},{"type":"text","value":" - SMPTEST428-1 transfer function","position":{"start":{"line":47,"column":19,"offset":1750},"end":{"line":47,"column":52,"offset":1783}}}],"position":{"start":{"line":47,"column":3,"offset":1734},"end":{"line":47,"column":52,"offset":1783}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"hlg","position":{"start":{"line":48,"column":5,"offset":1788},"end":{"line":48,"column":10,"offset":1793}}}],"position":{"start":{"line":48,"column":5,"offset":1788},"end":{"line":48,"column":10,"offset":1793}}},{"type":"text","value":" - HLG (Hybrid Log-Gamma) transfer function","position":{"start":{"line":48,"column":10,"offset":1793},"end":{"line":48,"column":53,"offset":1836}}}],"position":{"start":{"line":48,"column":3,"offset":1786},"end":{"line":48,"column":53,"offset":1836}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"srgb-hdr","position":{"start":{"line":49,"column":5,"offset":1841},"end":{"line":49,"column":15,"offset":1851}}}],"position":{"start":{"line":49,"column":5,"offset":1841},"end":{"line":49,"column":15,"offset":1851}}},{"type":"text","value":" - sRGB HDR transfer function","position":{"start":{"line":49,"column":15,"offset":1851},"end":{"line":49,"column":44,"offset":1880}}}],"position":{"start":{"line":49,"column":3,"offset":1839},"end":{"line":49,"column":44,"offset":1880}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"linear-hdr","position":{"start":{"line":50,"column":5,"offset":1885},"end":{"line":50,"column":17,"offset":1897}}}],"position":{"start":{"line":50,"column":5,"offset":1885},"end":{"line":50,"column":17,"offset":1897}}},{"type":"text","value":" - Linear HDR transfer function","position":{"start":{"line":50,"column":17,"offset":1897},"end":{"line":50,"column":48,"offset":1928}}}],"position":{"start":{"line":50,"column":3,"offset":1883},"end":{"line":50,"column":48,"offset":1928}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"custom","position":{"start":{"line":51,"column":5,"offset":1933},"end":{"line":51,"column":13,"offset":1941}}}],"position":{"start":{"line":51,"column":5,"offset":1933},"end":{"line":51,"column":13,"offset":1941}}},{"type":"text","value":" - Custom transfer function","position":{"start":{"line":51,"column":13,"offset":1941},"end":{"line":51,"column":40,"offset":1968}}}],"position":{"start":{"line":51,"column":3,"offset":1931},"end":{"line":51,"column":40,"offset":1968}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"custom-hdr","position":{"start":{"line":52,"column":5,"offset":1973},"end":{"line":52,"column":17,"offset":1985}}}],"position":{"start":{"line":52,"column":5,"offset":1973},"end":{"line":52,"column":17,"offset":1985}}},{"type":"text","value":" - Custom HDR transfer function","position":{"start":{"line":52,"column":17,"offset":1985},"end":{"line":52,"column":48,"offset":2016}}}],"position":{"start":{"line":52,"column":3,"offset":1971},"end":{"line":52,"column":48,"offset":2016}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"scrgb-linear-80-nits","position":{"start":{"line":53,"column":5,"offset":2021},"end":{"line":53,"column":27,"offset":2043}}}],"position":{"start":{"line":53,"column":5,"offset":2021},"end":{"line":53,"column":27,"offset":2043}}},{"type":"text","value":" - scRGB Linear 80 nits transfer function","position":{"start":{"line":53,"column":27,"offset":2043},"end":{"line":53,"column":68,"offset":2084}}}],"position":{"start":{"line":53,"column":3,"offset":2019},"end":{"line":53,"column":68,"offset":2084}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"invalid","position":{"start":{"line":54,"column":5,"offset":2089},"end":{"line":54,"column":14,"offset":2098}}}],"position":{"start":{"line":54,"column":5,"offset":2089},"end":{"line":54,"column":14,"offset":2098}}},{"type":"text","value":" - Invalid transfer function","position":{"start":{"line":54,"column":14,"offset":2098},"end":{"line":54,"column":42,"offset":2126}}}],"position":{"start":{"line":54,"column":3,"offset":2087},"end":{"line":54,"column":42,"offset":2126}}},{"type":"text","value":"\\n"}],"position":{"start":{"line":30,"column":3,"offset":970},"end":{"line":54,"column":42,"offset":2126}}},{"type":"text","value":"\\n"}],"position":{"start":{"line":29,"column":1,"offset":868},"end":{"line":54,"column":42,"offset":2126}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"text","value":"\\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"matrix","position":{"start":{"line":56,"column":3,"offset":2130},"end":{"line":56,"column":11,"offset":2138}}}],"position":{"start":{"line":56,"column":3,"offset":2130},"end":{"line":56,"column":11,"offset":2138}}},{"type":"text","value":" string - The color matrix of the color space. Can be one of the following values:","position":{"start":{"line":56,"column":11,"offset":2138},"end":{"line":56,"column":93,"offset":2220}}}],"position":{"start":{"line":56,"column":3,"offset":2130},"end":{"line":56,"column":93,"offset":2220}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"ul","properties":{},"children":[{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"rgb","position":{"start":{"line":57,"column":5,"offset":2225},"end":{"line":57,"column":10,"offset":2230}}}],"position":{"start":{"line":57,"column":5,"offset":2225},"end":{"line":57,"column":10,"offset":2230}}},{"type":"text","value":" - RGB matrix","position":{"start":{"line":57,"column":10,"offset":2230},"end":{"line":57,"column":23,"offset":2243}}}],"position":{"start":{"line":57,"column":3,"offset":2223},"end":{"line":57,"column":23,"offset":2243}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"bt709","position":{"start":{"line":58,"column":5,"offset":2248},"end":{"line":58,"column":12,"offset":2255}}}],"position":{"start":{"line":58,"column":5,"offset":2248},"end":{"line":58,"column":12,"offset":2255}}},{"type":"text","value":" - BT709 matrix","position":{"start":{"line":58,"column":12,"offset":2255},"end":{"line":58,"column":27,"offset":2270}}}],"position":{"start":{"line":58,"column":3,"offset":2246},"end":{"line":58,"column":27,"offset":2270}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"fcc","position":{"start":{"line":59,"column":5,"offset":2275},"end":{"line":59,"column":10,"offset":2280}}}],"position":{"start":{"line":59,"column":5,"offset":2275},"end":{"line":59,"column":10,"offset":2280}}},{"type":"text","value":" - FCC matrix","position":{"start":{"line":59,"column":10,"offset":2280},"end":{"line":59,"column":23,"offset":2293}}}],"position":{"start":{"line":59,"column":3,"offset":2273},"end":{"line":59,"column":23,"offset":2293}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"bt470bg","position":{"start":{"line":60,"column":5,"offset":2298},"end":{"line":60,"column":14,"offset":2307}}}],"position":{"start":{"line":60,"column":5,"offset":2298},"end":{"line":60,"column":14,"offset":2307}}},{"type":"text","value":" - BT470BG matrix","position":{"start":{"line":60,"column":14,"offset":2307},"end":{"line":60,"column":31,"offset":2324}}}],"position":{"start":{"line":60,"column":3,"offset":2296},"end":{"line":60,"column":31,"offset":2324}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"smpte170m","position":{"start":{"line":61,"column":5,"offset":2329},"end":{"line":61,"column":16,"offset":2340}}}],"position":{"start":{"line":61,"column":5,"offset":2329},"end":{"line":61,"column":16,"offset":2340}}},{"type":"text","value":" - SMPTE170M matrix","position":{"start":{"line":61,"column":16,"offset":2340},"end":{"line":61,"column":35,"offset":2359}}}],"position":{"start":{"line":61,"column":3,"offset":2327},"end":{"line":61,"column":35,"offset":2359}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"smpte240m","position":{"start":{"line":62,"column":5,"offset":2364},"end":{"line":62,"column":16,"offset":2375}}}],"position":{"start":{"line":62,"column":5,"offset":2364},"end":{"line":62,"column":16,"offset":2375}}},{"type":"text","value":" - SMPTE240M matrix","position":{"start":{"line":62,"column":16,"offset":2375},"end":{"line":62,"column":35,"offset":2394}}}],"position":{"start":{"line":62,"column":3,"offset":2362},"end":{"line":62,"column":35,"offset":2394}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"ycocg","position":{"start":{"line":63,"column":5,"offset":2399},"end":{"line":63,"column":12,"offset":2406}}}],"position":{"start":{"line":63,"column":5,"offset":2399},"end":{"line":63,"column":12,"offset":2406}}},{"type":"text","value":" - YCoCg matrix","position":{"start":{"line":63,"column":12,"offset":2406},"end":{"line":63,"column":27,"offset":2421}}}],"position":{"start":{"line":63,"column":3,"offset":2397},"end":{"line":63,"column":27,"offset":2421}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"bt2020-ncl","position":{"start":{"line":64,"column":5,"offset":2426},"end":{"line":64,"column":17,"offset":2438}}}],"position":{"start":{"line":64,"column":5,"offset":2426},"end":{"line":64,"column":17,"offset":2438}}},{"type":"text","value":" - BT2020 NCL matrix","position":{"start":{"line":64,"column":17,"offset":2438},"end":{"line":64,"column":37,"offset":2458}}}],"position":{"start":{"line":64,"column":3,"offset":2424},"end":{"line":64,"column":37,"offset":2458}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"ydzdx","position":{"start":{"line":65,"column":5,"offset":2463},"end":{"line":65,"column":12,"offset":2470}}}],"position":{"start":{"line":65,"column":5,"offset":2463},"end":{"line":65,"column":12,"offset":24
170}}},{"type":"text","value":" - YDzDx matrix","position":{"start":{"line":65,"column":12,"offset":2470},"end":{"line":65,"column":27,"offset":2485}}}],"position":{"start":{"line":65,"column":3,"offset":2461},"end":{"line":65,"column":27,"offset":2485}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"gbr","position":{"start":{"line":66,"column":5,"offset":2490},"end":{"line":66,"column":10,"offset":2495}}}],"position":{"start":{"line":66,"column":5,"offset":2490},"end":{"line":66,"column":10,"offset":2495}}},{"type":"text","value":" - GBR matrix","position":{"start":{"line":66,"column":10,"offset":2495},"end":{"line":66,"column":23,"offset":2508}}}],"position":{"start":{"line":66,"column":3,"offset":2488},"end":{"line":66,"column":23,"offset":2508}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"invalid","position":{"start":{"line":67,"column":5,"offset":2513},"end":{"line":67,"column":14,"offset":2522}}}],"position":{"start":{"line":67,"column":5,"offset":2513},"end":{"line":67,"column":14,"offset":2522}}},{"type":"text","value":" - Invalid matrix","position":{"start":{"line":67,"column":14,"offset":2522},"end":{"line":67,"column":31,"offset":2539}}}],"position":{"start":{"line":67,"column":3,"offset":2511},"end":{"line":67,"column":31,"offset":2539}}},{"type":"text","value":"\\n"}],"position":{"start":{"line":57,"column":3,"offset":2223},"end":{"line":67,"column":31,"offset":2539}}},{"type":"text","value":"\\n"}],"position":{"start":{"line":56,"column":1,"offset":2128},"end":{"line":67,"column":31,"offset":2539}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"text","value":"\\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"range","position":{"start":{"line":69,"column":3,"offset":2543},"end":{"line":69,"column":10,"offset":2550}}}],"position":{"start":{"line":69,"column":3,"offset":2543},"end":{"line":69,"column":10,"offset":2550}}},{"type":"text","value":" string - The color range of the color space. Can be one of the following values:","position":{"start":{"line":69,"column":10,"offset":2550},"end":{"line":69,"column":91,"offset":2631}}}],"position":{"start":{"line":69,"column":3,"offset":2543},"end":{"line":69,"column":91,"offset":2631}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"ul","properties":{},"children":[{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"limited","position":{"start":{"line":70,"column":5,"offset":2636},"end":{"line":70,"column":14,"offset":2645}}}],"position":{"start":{"line":70,"column":5,"offset":2636},"end":{"line":70,"column":14,"offset":2645}}},{"type":"text","value":" - Limited color range (RGB values ranging from 16 to 235)","position":{"start":{"line":70,"column":14,"offset":2645},"end":{"line":70,"column":72,"offset":2703}}}],"position":{"start":{"line":70,"column":3,"offset":2634},"end":{"line":70,"column":72,"offset":2703}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"full","position":{"start":{"line":71,"column":5,"offset":2708},"end":{"line":71,"column":11,"offset":2714}}}],"position":{"start":{"line":71,"column":5,"offset":2708},"end":{"line":71,"column":11,"offset":2714}}},{"type":"text","value":" - Full color range (RGB values from 0 to 255)","position":{"start":{"line":71,"column":11,"offset":2714},"end":{"line":71,"column":57,"offset":2760}}}],"position":{"start":{"line":71,"column":3,"offset":2706},"end":{"line":71,"column":57,"offset":2760}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"derived","position":{"start":{"line":72,"column":5,"offset":2765},"end":{"line":72,"column":14,"offset":2774}}}],"position":{"start":{"line":72,"column":5,"offset":2765},"end":{"line":72,"column":14,"offset":2774}}},{"type":"text","value":" - Range defined by the transfer function and matrix","position":{"start":{"line":72,"column":14,"offset":2774},"end":{"line":72,"column":66,"offset":2826}}}],"position":{"start":{"line":72,"column":3,"offset":2763},"end":{"line":72,"column":66,"offset":2826}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"invalid","position":{"start":{"line":73,"column":5,"offset":2831},"end":{"line":73,"column":14,"offset":2840}}}],"position":{"start":{"line":73,"column":5,"offset":2831},"end":{"line":73,"column":14,"offset":2840}}},{"type":"text","value":" - Invalid range","position":{"start":{"line":73,"column":14,"offset":2840},"end":{"line":73,"column":30,"offset":2856}}}],"position":{"start":{"line":73,"column":3,"offset":2829},"end":{"line":73,"column":30,"offset":2856}}},{"type":"text","value":"\\n"}],"position":{"start":{"line":70,"column":3,"offset":2634},"end":{"line":73,"column":30,"offset":2856}}},{"type":"text","value":"\\n"}],"position":{"start":{"line":69,"column":1,"offset":2541},"end":{"line":73,"column":30,"offset":2856}}},{"type":"text","value":"\\n"}],"position":{"start":{"line":10,"column":1,"offset":109},"end":{"line":73,"column":30,"offset":2856}}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":203,"column":1,"offset":4743}}}'})," (optional) - The target color space\nfor the output pixel data. Defaults to sRGB. Pass the image's original color space to\npreserve the previous behavior, or another color space to get pixel values in that space."]}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["Legacy alias for ",(0,i.jsx)(t.code,{children:"image.toBitmap()"}),"."]}),"\n",(0,i.jsxs)(t.h4,{id:"imagegetnativehandle-macos",children:[(0,i.jsx)(t.code,{children:"image.getNativeHandle()"})," ",(0,i.jsx)(t.em,{className:"badge badge--primary",children:"macOS"})]}),"\n",(0,i.jsxs)(t.p,{children:["Returns ",(0,i.jsx)(t.code,{children:"Buffer"})," - A ",(0,i.jsx)(t.a,{href:"https://nodejs.org/api/buffer.html#buffer_class_buffer",children:"Buffer"})," that stores C pointer to underlying native handle of\nthe image. On macOS, a pointer to ",(0,i.jsx)(t.code,{children:"NSImage"})," instance is returned."]}),"\n",(0,i.jsxs)(t.p,{children:["Notice that the returned pointer is a weak pointer to the underlying native\nimage instead of a copy, so you ",(0,i.jsx)(t.em,{children:"must"})," ensure that the associated\n",(0,i.jsx)(t.code,{children:"nativeImage"})," instance is kept around."]}),"\n",(0,i.jsx)(t.h4,{id:"imageisempty",children:(0,i.jsx)(t.code,{children:"image.isEmpty()"})}),"\n",(0,i.jsxs)(t.p,{children:["Returns ",(0,i.jsx)(t.code,{children:"boolean"})," - Whether the image is empty."]}),"\n",(0,i.jsx)(t.h4,{id:"imagegetsizescalefactor",children:(0,i.jsx)(t.code,{children:"image.getSize([scaleFactor])"})}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"scaleFactor"})," Number (optional) - Defaults to 1.0."]}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["Returns ",(0,i.jsx)(a.A,{url:"/docs/latest/api/structures/size",title:"Size",content:'{"type":"root","children":[{"type":"element","tagName":"h1","properties":{},"children":[{"type":"text","value":"Size Object"}]},{"type":"text","value":"\\n"},{"type":"element","tagName":"ul","properties":{},"children":[{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"width","position":{"start":{"line":10,"column":3,"offset":92},"end":{"line":10,"column":10,"offset":99}}}],"position":{"start":{"line":10,"column":3,"offset":92},"end":{"line":10,"column":10,"offset":99}}},{"type":"text","value":" number","position":{"start":{"line":10,"column":10,"offset":99},"end":{"line":10,"column":17,"offset":106}}}],"position":{"start":{"line":10,"column":1,"offset":90},"end":{"line":10,"column":17,"offset":106}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"height","position":{"start":{"line":11,"column":3,"offset":109},"end":{"line":11,"column":11,"offset":117}}}],"position":{"start":{"line":11,"column":3,"offset":109},"end":{"line":11,"column":11,"offset":117}}},{"type":"text","value":" number","position":{"start":{"line":11,"column":11,"offset":117},"end":{"line":11,"column":18,"offset":124}}}],"position":{"start":{"line":11,"column":1,"offset":107},"end":{"line":11,"column":18,"offset":124}}},{"type":"text","value":"\\n"}],"position":{"start":{"line":10,"column":1,"offset":90},"end":{"line":11,"column":18,"offset":124}}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":12,"column":1,"offset":125}}}'}),"."]}),"\n",(0,i.jsxs)(t.p,{children:["If ",(0,i.jsx)(t.code,{children:"scaleFactor"})," is passed, this will return the size corresponding to the image representation most closely matching the passed value."]}),"\n",(0,i.jsx)(t.h4,{id:"imagesettemplateimageoption",children:(0,i.jsx)(t.code,{children:"image.setTemplateImage(option)"})}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"option"})," boolean"]}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["Marks the image as a macOS ",(0,i.jsx)(t.a,{href:"https://developer.apple.com/documentation/appkit/nsimage/1520017-template",children:"template image"}),"."]}),"\n",(0,i.jsx)(t.h4,{id:"imageistemplateimage",children:(0,i.jsx)(t.code,{children:"image.isTemplateImage()"})}),"\n",(0,i.jsxs)(t.p,{children:["Returns ",(0,i.jsx)(t.code,{children:"boolean"})," - Whether the image is a macOS ",(0,i.jsx)(t.a,{href:"https://developer.apple.com/documentation/appkit/nsimage/1520017-template",children:"template image"}),"."]}),"\n",(0,i.jsx)(t.h4,{id:"imagecroprect",children:(0,i.jsx)(t.code,{children:"image.crop(rect)"})}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"rect"})," ",(0,i.jsx)(a.A,{url:"/docs/latest/api/structures/rectangle",title:"Rectangle",content:'{"type":"root","children":[{"type":"element","tagName":"h1","properties":{},"children":[{"type":"text","value":"Rectangle Object"}]},{"type":"text","value":"\\n"},{"type":"element","tagName":"ul","properties":{},"children":[{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"x","position":{"start":{"line":10,"column":3,"offset":107},"end":{"line":10,"column":6,"offset":110}}}],"position":{"start":{"line":10,"column":3,"offset":107},"end":{"line":10,"column":6,"offset":110}}},{"type":"text","value":" number - The x coordinate of the origin of the rectangle (must be an integer).","position":{"start":{"line":10,"column":6,"offset":110},"end":{"line":10,"column":85,"offset":189}}}],"position":{"start":{"line":10,"column":1,"offset":105},"end":{"line":10,"column":85,"offset":189}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"y","position":{"start":{"line":11,"column":3,"offset":192},"end":{"line":11,"column":6,"offset":195}}}],"position":{"start":{"line":11,"column":3,"offset":192},"end":{"line":11,"column":6,"offset":195}}},{"type":"text","value":" number - The y coordinate of the origin of the rectangle (must be an integer).","position":{"start":{"line":11,"column":6,"offset":195},"end":{"line":11,"column":85,"offset":274}}}],"position":{"start":{"line":11,"column":1,"offset":190},"end":{"line":11,"column":85,"offset":274}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"width","position":{"start":{"line":12,"column":3,"offset":277},"end":{"line":12,"column":10,"offset":284}}}],"position":{"start":{"line":12,"column":3,"offset":277},"end":{"line":12,"column":10,"offset":284}}},{"type":"text","value":" number - The width of the rectangle (must be an integer).","position":{"start":{"line":12,"column":10,"offset":284},"end":{"line":12,"column":68,"offset":342}}}],"position":{"start":{"line":12,"column":1,"offset":275},"end":{"line":12,"column":68,"offset":342}}},{"type":"text","value":"\\n"},{"type":"element","tagName":"li","properties":{},"children":[{"type":"element","tagName":"code","properties":{},"children":[{"type":"text","value":"height","position":{"start":{"line":13,"column":3,"offset":345},"end":{"line":13,"column":11,"offset":353}}}],"position":{"start":{"line":13,"column":3,"offset":345},"end":{"line":13,"column":11,"offset":353}}},{"type":"text","value":" number - The height of the rectangle (must be an integer).","position":{"start":{"line":13,"column":11,"offset":353},"end":{"line":13,"column":70,"offset":412}}}],"position":{"start":{"line":13,"column":1,"offset":343},"end":{"line":13,"column":70,"offset":412}}},{"type":"text","value":"\\n"}],"position":{"start":{"line":10,"column":1,"offset":105},"end":{"line":13,"column":70,"offset":412}}}],"position":{"start":{"line":1,"column":1,"offset":0},"end":{"line":14,"column":1,"offset":413}}}'})," - The area of the image to crop."]}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["Returns ",(0,i.jsx)(t.code,{children:"NativeImage"})," - The cropped image."]}),"\n",(0,i.jsx)(t.h4,{id:"imageresizeoptions",children:(0,i.jsx)(t.code,{children:"image.resize(options)"})}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{className:"electron-api-options-list",children:[(0,i.jsx)(t.code,{children:"options"})," Object","\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"width"})," Integer (optional) - Defaults to the image's width."]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"height"})," Integer (optional) - Defaults to the image's height."]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"quality"})," string (optional) - The desired quality of the resize image.\nPossible values include ",(0,i.jsx)(t.code,{children:"good"}),", ",(0,i.jsx)(t.code,{children:"better"}),", or ",(0,i.jsx)(t.code,{children:"best"}),". The default is ",(0,i.jsx)(t.code,{children:"best"}),".\nThese values express a desired quality/speed tradeoff. They are translated\ninto an algorithm-specific method that depends on the capabilities\n(CPU, GPU) of the underlying platform. It is possible for all three methods\nto be mapped to the same algorithm on a given platform."]}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["Returns ",(0,i.jsx)(t.code,{children:"NativeImage"})," - The resized image."]}),"\n",(0,i.jsxs)(t.p,{children:["If only the ",(0,i.jsx)(t.code,{children:"height"})," or the ",(0,i.jsx)(t.code,{children:"width"})," are specified then the current aspect ratio\nwill be preserved in the resized image."]}),"\n",(0,i.jsx)(t.h4,{id:"imagegetaspectratioscalefactor",children:(0,i.jsx)(t.code,{children:"image.getAspectRatio([scaleFactor])"})}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"scaleFactor"})," Number (optional) - Defaults to 1.0."]}),"\n"]}),"\n",(0,i.jsxs)(t.p,{children:["Returns ",(0,i.jsx)(t.code,{children:"Number"})," - The image's aspect ratio (width divided by height)."]}),"\n",(0,i.jsxs)(t.p,{children:["If ",(0,i.jsx)(t.code,{children:"scaleFactor"})," is passed, this will return the aspect ratio corresponding to the image representation most closely matching the passed value."]}),"\n",(0,i.jsx)(t.h4,{id:"imagegetscalefactors",children:(0,i.jsx)(t.code,{children:"image.getScaleFactors()"})}),"\n",(0,i.jsxs)(t.p,{children:["Returns ",(0,i.jsx)(t.code,{children:"Number[]"}),"
1 - An array of all scale factors corresponding to representations for a given ",(0,i.jsx)(t.code,{children:"NativeImage"}),"."]}),"\n",(0,i.jsx)(t.h4,{id:"imageaddrepresentationoptions",children:(0,i.jsx)(t.code,{children:"image.addRepresentation(options)"})}),"\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{className:"electron-api-options-list",children:[(0,i.jsx)(t.code,{children:"options"})," Object","\n",(0,i.jsxs)(t.ul,{children:["\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"scaleFactor"})," Number (optional) - The scale factor to add the image representation for."]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"width"})," Integer (optional) - Defaults to 0. Required if a bitmap buffer\nis specified as ",(0,i.jsx)(t.code,{children:"buffer"}),"."]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"height"})," Integer (optional) - Defaults to 0. Required if a bitmap buffer\nis specified as ",(0,i.jsx)(t.code,{children:"buffer"}),"."]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"buffer"})," Buffer (optional) - The buffer containing the raw image data."]}),"\n",(0,i.jsxs)(t.li,{children:[(0,i.jsx)(t.code,{children:"dataURL"})," string (optional) - The data URL containing either a base 64\nencoded PNG or JPEG image."]}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,i.jsx)(t.p,{children:"Add an image representation for a specific scale factor. This can be used\nto programmatically add different scale factor representations to an image. This\ncan be called on empty images."}),"\n",(0,i.jsx)(t.h3,{id:"instance-properties",children:"Instance Properties"}),"\n",(0,i.jsxs)(t.h4,{id:"nativeimageismactemplateimage-macos",children:[(0,i.jsx)(t.code,{children:"nativeImage.isMacTemplateImage"})," ",(0,i.jsx)(t.em,{className:"badge badge--primary",children:"macOS"})]}),"\n",(0,i.jsxs)(t.p,{children:["A ",(0,i.jsx)(t.code,{children:"boolean"})," property that determines whether the image is considered a ",(0,i.jsx)(t.a,{href:"https://developer.apple.com/documentation/appkit/nsimage/1520017-template",children:"template image"}),"."]}),"\n",(0,i.jsx)(t.p,{children:"Please note that this property only has an effect on macOS."})]})}function d(e={}){let{wrapper:t}={...(0,l.R)(),...e.components};return t?(0,i.jsx)(t,{...e,children:(0,i.jsx)(m,{...e})}):m(e)}},40329(e,t,n){n.d(t,{A:()=>f});var o=n(74848),i=n(20053),l=n(96540),s=n(75392),a=n.n(s),r=n(83561);let c=e=>(0,o.jsx)("article",{ref:e.innerRef,id:"structures-tooltip",role:"tooltip",className:(0,i.A)("alert","alert--info","shadow--md","card_ZoSr"),style:e.position,children:(0,o.jsx)("div",{className:"card__body",dangerouslySetInnerHTML:{__html:(0,r.V)(JSON.parse(e.content))}})}),f=function(e){let{Portal:t}=a()(),n=(0,l.useRef)(null),i=(0,l.useRef)(null),[s,r]=(0,l.useState)(!1),[f,p]=(0,l.useState)(void 0);(0,l.useEffect)(()=>{if(s){let e={x:0,y:0},t=n.current.getBoundingClientRect(),o=window.innerHeight/2<t.y,l=window.innerWidth/2<t.x;o?e.y=i.current.clientHeight+-2:e.y=-t.height- -2,l?e.x=i.current.clientWidth:e.x=0,p({top:n.current.offsetTop-e.y,left:n.current.offsetLeft-e.x})}},[s]);let m=(0,l.useCallback)(()=>{r(!0)},[]),d=(0,l.useCallback)(()=>{r(!1)},[]);return(0,o.jsxs)("a",{"aria-describedby":"structures-tooltip",href:e.url,ref:n,className:"link_nCrB",onMouseEnter:m,onMouseLeave:d,children:[e.title,!!s&&(0,o.jsx)(t,{children:(0,o.jsx)(c,{innerRef:i,position:f,...e})})]})}},56346(e,t,n){n.d(t,{A:()=>r});var o=n(74848),i=n(52918);n(96540);var l=n(35778),s=n(99589);let a={"api-history":"api-history_li9V","api-added":"api-added_XqIp","api-deprecated":"api-deprecated_PIol"},r=e=>{let{apiHistoryJson:t,prReleaseVersionsJson:n}=e,r=JSON.parse(t),c=JSON.parse(n),f=(e,t)=>(t??[]).map(t=>{var n;let i,r,f,p,m;return n=c[Number(t["pr-url"].split("/").at(-1))],r=t["pr-url"]+"-"+e,f=s.rsort(n?.backports??[]).map(e=>(e.endsWith(".0.0")?">=":"^")+e),(p=n?.release)&&!f.find(e=>e.startsWith(">="))&&f.unshift(`>=${p}`),m=f.map(e=>(0,o.jsx)("a",{href:t["pr-url"],target:"_blank",rel:"noopener noreferrer",children:(0,o.jsx)("pre",{children:e})},e)),i="description"in t?(0,o.jsx)(l.o,{allowedElements:["a","code","em","p","pre","strong"],children:t.description}):(0,o.jsx)("pre",{className:a[e.toLowerCase().split(" ").join("-")],children:e},r),"breaking-changes-header"in t&&(i=(0,o.jsx)("a",{href:"/docs/latest/breaking-changes#"+t["breaking-changes-header"],target:"_blank",rel:"noopener noreferrer",children:i})),(0,o.jsxs)("tr",{children:[(0,o.jsx)("td",{children:0!==m.length?m:(0,o.jsx)("pre",{children:"None"})}),(0,o.jsx)("td",{children:i})]},r)}),p=[...f("API DEPRECATED",r.deprecated),...f("API CHANGED",r.changes),...f("API ADDED",r.added)];return(0,o.jsx)(i.B,{className:a["api-history"],summary:(0,o.jsx)("summary",{children:"History"}),children:(0,o.jsxs)("table",{children:[(0,o.jsx)("thead",{children:(0,o.jsxs)("tr",{children:[(0,o.jsx)("th",{children:"Version(s)"}),(0,o.jsx)("th",{children:"Changes"})]})}),(0,o.jsx)("tbody",{children:p})]})})}}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.