Image

public Reckfell.Collections.Dictionary Data { get; set; }

Содержит все данные о цвете изображения в заданном формате. См. константы Image.Format.

public void AdjustBcs(float brightness, float contrast, float saturation);

Настраивает brightness, contrast и saturation этого изображения на заданные значения. Не работает, если изображение сжато (см. Image.IsCompressed).

public void BlendRect(Image src, Rect2I srcRect, Vector2I dst);

Альфа-бленды src_rect от src изображение к этому снимку в координатах dst, вырезаны соответственно в обе границы изображения. src изображение должен иметь тот же формат. src_rect с непозитивным размером считается пустым. Примечание: Одновременное чтение и запись с одной и той же ссылкой на изображение может привести к неожиданным результатам.

public void BlendRectMask(Image src, Image mask, Rect2I srcRect, Vector2I dst);

Альфа-смешивания src_rect из изображения src с этим изображением, используя изображение mask в координатах dst, обрезанное соответственно по обеим границам изображения. Альфа-каналы требуются как для src, так и для mask. Пиксели dst и пиксели src будут смешиваться, если значение альфа соответствующего пикселя маски не равно 0. Это изображение и изображение src должны иметь одинаковый формат. Изображение src и изображение mask должны иметь одинаковый размер (ширину и высоту), но они могут иметь разные форматы. src_rect с неположительным размером рассматривается как пустой.

public void BlitRect(Image src, Rect2I srcRect, Vector2I dst);

Копирует src_rect из изображения src в это изображение с координатами dst, обрезанное соответственно границам обоих изображений. Это изображение и изображение src должны иметь одинаковый формат. src_rect с неположительным размером рассматривается как пустой. Примечание: Данные альфа-канала в src перезапишут соответствующие данные в этом изображении в целевой позиции. Чтобы смешать альфа-каналы, используйте вместо этого Image.BlendRect.

public void BlitRectMask(Image src, Image mask, Rect2I srcRect, Vector2I dst);

Переносит область src_rect из изображения src в это изображение по координатам, заданным dst, обрезанным соответственно по обеим границам изображения. Пиксель src копируется в dst, если соответствующее значение альфа-канала пикселя mask не равно 0. Это изображение и изображение src должны иметь одинаковый формат. Изображение src и изображение mask должны иметь одинаковый размер (ширину и высоту), но они могут иметь разные форматы. src_rect с неположительным размером рассматривается как пустой.

public void BumpMapToNormalMap(float bumpScale = 1f);

Преобразует карту рельефа (Карта bupp) в карту нормалей. Карта рельефа обеспечивает смещение высоты на пиксель, тогда как карта нормалей обеспечивает направление нормали на пиксель.

public void ClearMipmaps();

Удаляет MIP-текстуры изображения.

public Error Compress(Image.CompressMode mode, Image.CompressSource source, Image.AstcFormat astcFormat);

Сжимает изображение с помощью формата VRAM, чтобы использовать меньше памяти. Не может напрямую получить доступ к данным пикселя, пока изображение сжато. Вернуть ошибку, если выбранный режим сжатия отсутствует. :: source параметр помогает выбрать лучший метод сжатия для форматов DXT и ETC2. Он игнорируется для компрессии ASTC. :: profile , позволяет пользователю выбрать, должно ли сжатие иметь приоритетное значение для качества или меньшего размера. Примечание: Image.Compress при осуществлении экспортируемого проекта, этот метод всегда возвращает ERR_UNAVAILABLE.

public Error Compress(Image.CompressMode mode, Image.CompressSource source = Image.CompressSource.Generic, Image.CompressProfile profile = Image.CompressProfile.Automatic);

Сжимает изображение с помощью формата VRAM, чтобы использовать меньше памяти. Не может напрямую получить доступ к данным пикселя, пока изображение сжато. Вернуть ошибку, если выбранный режим сжатия отсутствует. :: source параметр помогает выбрать лучший метод сжатия для форматов DXT и ETC2. Он игнорируется для компрессии ASTC. :: profile , позволяет пользователю выбрать, должно ли сжатие иметь приоритетное значение для качества или меньшего размера. Примечание: Image.Compress при осуществлении экспортируемого проекта, этот метод всегда возвращает ERR_UNAVAILABLE.

public Error CompressFromChannels(Image.CompressMode mode, Image.UsedChannels channels, Image.AstcFormat astcFormat);

Сжимает изображение с помощью формата VRAM, чтобы использовать меньше памяти. Не может напрямую получить доступ к данным пикселя, пока изображение сжато. Вернуть ошибку, если выбранный режим сжатия отсутствует. Это альтернатива Image.Compress что позволяет пользователю поставлять каналы, используемые для компрессора, чтобы выбрать лучшие форматы DXT, ETC2 и ASTC. Для других форматов (не DXT, ETC2, или ASTC) этот аргумент не принимается во внимание. :: profile , позволяет пользователю выбрать, должно ли сжатие иметь приоритетное значение для качества или меньшего размера. Примечание: Image.CompressFromChannels при осуществлении экспортируемого проекта, этот метод всегда возвращает ERR_UNAVAILABLE.

public Error CompressFromChannels(Image.CompressMode mode, Image.UsedChannels channels, Image.CompressProfile profile = Image.CompressProfile.Automatic);

Сжимает изображение с помощью формата VRAM, чтобы использовать меньше памяти. Не может напрямую получить доступ к данным пикселя, пока изображение сжато. Вернуть ошибку, если выбранный режим сжатия отсутствует. Это альтернатива Image.Compress что позволяет пользователю поставлять каналы, используемые для компрессора, чтобы выбрать лучшие форматы DXT, ETC2 и ASTC. Для других форматов (не DXT, ETC2, или ASTC) этот аргумент не принимается во внимание. :: profile , позволяет пользователю выбрать, должно ли сжатие иметь приоритетное значение для качества или меньшего размера. Примечание: Image.CompressFromChannels при осуществлении экспортируемого проекта, этот метод всегда возвращает ERR_UNAVAILABLE.

public Reckfell.Collections.Dictionary ComputeImageMetrics(Image comparedImage, bool useLuma);

Вычисляет метрики изображения для текущего изображения и сравниваемого изображения. Это можно использовать для расчета сходства между двумя изображениями. Словарь содержит max, mean, mean_squared, root_mean_squared и peak_snr.

public void Convert(Image.Format format);

Преобразовать этот формат изображения в указанный format.

public void CopyFrom(Image src);

Копирует изображение src в это изображение.

public static Image Create(int width, int height, bool useMipmaps, Image.Format format);

Создает пустое изображение заданного размера и формата. Если use_mipmaps равно true, генерирует мипмапы для этого изображения (см. Image.GenerateMipmaps).

public static Image CreateEmpty(int width, int height, bool useMipmaps, Image.Format format);

Создает пустое изображение заданного размера и формата. Если use_mipmaps равно true, генерирует мипмапы для этого изображения (см. Image.GenerateMipmaps).

public static Image CreateFromData(int width, int height, bool useMipmaps, Image.Format format, byte[] data);

Создает новое изображение указанного размера и формата. Заполняет изображение указанными необработанными данными. Если use_mipmaps равен true, загружает mip-карты для этого изображения из Image.Data. См. Image.GenerateMipmaps.

public static Image CreateFromData(int width, int height, bool useMipmaps, Image.Format format, ReadOnlySpan<byte> data);

Создает новое изображение указанного размера и формата. Заполняет изображение указанными необработанными данными. Если use_mipmaps равен true, загружает mip-карты для этого изображения из Image.Data. См. Image.GenerateMipmaps.

public void Crop(int width, int height);

Обрезает изображение до указанных width и height. Если указанный размер больше текущего размера, дополнительная область заполняется черными пикселями.

public Error Decompress();

Распаковывает изображение, если оно сжато в видеопамяти в поддерживаемом формате. Это увеличивает использование памяти, но позволяет изменять изображение. Возвращает OK, если формат поддерживается, в противном случае ERR_UNAVAILABLE. Все форматы, сжатые в видеопамяти и поддерживаемые Reckfell, могут быть распакованы этим методом, за исключением Image.Format.Etc2R11S, Image.Format.Etc2Rg11S и Image.Format.Etc2Rgb8A1.

public Image.AlphaMode DetectAlpha();

Возвращает Image.AlphaMode.Blend, если изображение имеет данные для альфа-значений. Возвращает Image.AlphaMode.Bit, если все альфа-значения хранятся в одном бите. Возвращает Image.AlphaMode.None, если данные для альфа-значений не найдены.

public Image.UsedChannels DetectUsedChannels(Image.CompressSource source = Image.CompressSource.Generic);

Возвращает цветовые каналы, используемые этим изображением. Если изображение сжато, необходимо указать исходный source.

public void Fill(Color color);

Заполняет изображение color.

public void FillRect(Rect2I rect, Color color);

Заполняет rect color.

public void FixAlphaEdges();

Смешивает пиксели с низким альфа-каналом с соседними пикселями.

public void FlipX();

Переворачивает изображение по горизонтали.

public void FlipY();

Переворачивает изображение по вертикали.

public Error GenerateMipmaps(bool renormalize);

Создаёт мипкарты для изображения. Мипкарты представляют собой копии изображения с низким разрешением, которые автоматически используются, если изображение необходимо сократить при его передаче. Они помогают улучшить качество и эффективность изображения при отображении. Этот метод возвращает ошибку, если изображение сжато, в заказном формате или если ширина/высота изображения 0:: создание благоприятных условий renormalize при создании микрокарт для обычных текстовых карт все результирующие значения векторов будут нормализованы. Можно проверить, есть ли у изображения микрокарты, позвонив Image.HasMipmaps или Image.GetMipmapCount. Вызывающие Image.GenerateMipmaps На картинке, у которой уже есть микрокарты, заменить существующие микрокарты на имидже. Если preserve_alpha_test_coverage это true Это особенно полезно для волос, листьев или других альфа-испытательных материалов, так как оно предотвращает упадок или сбрасывание артефактов на различных уровнях микрокарт (ЛОД). Этот параметр предназначен для цветных текстуров и зажимов альфа-канала в диапазоне 0,0-1.0. :: alpha_test_threshold параметр - это порог альфа, используемый при сохранении альфа-испытательного охвата на всех уровнях mipmaps. Охват измеряется на мипкарте 0 с использованием настройки и нижние мипкарты корректируются с учетом этого охвата. Более высокие значения сохраняют более подробную информацию, более низкие значения создают мягкие края. Alpha Scissor Threshold Они должны быть установлены на материале и, возможно, понадобятся для получения оптимальных результатов.

public Error GenerateMipmaps(bool renormalize = false, bool preserveAlphaTestCoverage = false, float alphaTestThreshold = 0.5f);

Создаёт мипкарты для изображения. Мипкарты представляют собой копии изображения с низким разрешением, которые автоматически используются, если изображение необходимо сократить при его передаче. Они помогают улучшить качество и эффективность изображения при отображении. Этот метод возвращает ошибку, если изображение сжато, в заказном формате или если ширина/высота изображения 0:: создание благоприятных условий renormalize при создании микрокарт для обычных текстовых карт все результирующие значения векторов будут нормализованы. Можно проверить, есть ли у изображения микрокарты, позвонив Image.HasMipmaps или Image.GetMipmapCount. Вызывающие Image.GenerateMipmaps На картинке, у которой уже есть микрокарты, заменить существующие микрокарты на имидже. Если preserve_alpha_test_coverage это true Это особенно полезно для волос, листьев или других альфа-испытательных материалов, так как оно предотвращает упадок или сбрасывание артефактов на различных уровнях микрокарт (ЛОД). Этот параметр предназначен для цветных текстуров и зажимов альфа-канала в диапазоне 0,0-1.0. :: alpha_test_threshold параметр - это порог альфа, используемый при сохранении альфа-испытательного охвата на всех уровнях mipmaps. Охват измеряется на мипкарте 0 с использованием настройки и нижние мипкарты корректируются с учетом этого охвата. Более высокие значения сохраняют более подробную информацию, более низкие значения создают мягкие края. Alpha Scissor Threshold Они должны быть установлены на материале и, возможно, понадобятся для получения оптимальных результатов.

public byte[] GetData();

Возвращает копию необработанных (raw) данных изображения.

public long GetDataSize();

Возвращает размер (в байтах) необработанных данных изображения.

public Image.Format GetFormat();

Возвращает формат этого изображения.

public int GetHeight();

Возвращает высоту изображения.

public int GetMipmapCount();

Возвращает число уменьшенных уровней, не считая основного. Для проверенного изображения 32×16 полная цепочка содержит пять таких уровней.

public long GetMipmapOffset(int mipmap);

Возвращает смещение, где хранится MIP-карта изображения с индексом mipmap в словаре Image.Data.

public Color GetPixel(int x, int y);

Читает пиксель основного уровня Image на процессоре. Передавайте координаты внутри размеров изображения; для сжатого формата сначала получите пригодное для чтения представление. Это не выборка шейдера с фильтрацией или преобразованием source_color.

public Color GetPixelv(Vector2I point);

Возвращает цвет пикселя в point. Это то же самое, что и Image.GetPixel, но с аргументом Vector2I вместо двух целочисленных аргументов.

public Image GetRegion(Rect2I region);

Возвращает новое Image, являющееся копией области данного Image, указанной с помощью region.

public Vector2I GetSize();

Возвращает размер изображения (ширину и высоту).

public Rect2I GetUsedRect();

Возвращает Rect2I, охватывающий видимую часть изображения, считая каждый пиксель с ненулевым альфа-каналом видимым.

public int GetWidth();

Возвращает ширину изображения.

public bool HasMipmaps();

Сообщает, содержит ли Image уменьшенные mip-уровни помимо основного изображения. Не выбирает фильтр материала и не включает использование уровней в шейдере.

public bool IsCompressed();

Возвращает true, если изображение сжато.

public bool IsEmpty();

Возвращает true, если изображение не содержит данных.

public bool IsInvisible();

Возвращает true, если все пиксели изображения имеют альфа-значение 0. Возвращает false, если хотя бы один пиксель имеет альфа-значение больше 0.

public void LinearToSrgb();

Преобразование всего изображения из линейного кодирования в нелинейное кодирование sRGB. Работает только с изображениями. Image.Format.Rgb8, Image.Format.Rgba8, Image.Format.Rgbhили Image.Format.Rgbah формат.

public Error Load(string path);

Загружает изображение из файла path. См. Поддерживаемые форматы изображений для списка поддерживаемых форматов изображений и ограничений. Предупреждение: Этот метод следует использовать только в редакторе или в случаях, когда вам нужно загрузить внешние изображения во время выполнения, например изображения, расположенные в каталоге user://, и он может не работать в экспортированных проектах. См. также описание ImageTexture для примеров использования.

public Error LoadBmpFromBuffer(byte[] buffer);

Загружает изображение из двоичного содержимого файла BMP. Примечание: Модуль БМП " Reckfell " не поддерживает изображения с глубиной цвета 16 бит на пиксель. Поддерживаются только изображения с глубиной цвета 1 бит, 4 бит, 8 бит, 24 бит и 32 бита на пиксель. Примечание: Этот метод доступен только в сборках движка с включенным модулем BMP. По умолчанию модуль BMP включен, но его можно отключить во время сборки с помощью параметра module_bmp_enabled=no в SCons.

public Error LoadBmpFromBuffer(ReadOnlySpan<byte> buffer);

Загружает изображение из двоичного содержимого файла BMP. Примечание: Модуль БМП " Reckfell " не поддерживает изображения с глубиной цвета 16 бит на пиксель. Поддерживаются только изображения с глубиной цвета 1 бит, 4 бит, 8 бит, 24 бит и 32 бита на пиксель. Примечание: Этот метод доступен только в сборках движка с включенным модулем BMP. По умолчанию модуль BMP включен, но его можно отключить во время сборки с помощью параметра module_bmp_enabled=no в SCons.

public Error LoadDdsFromBuffer(byte[] buffer);

Загружает изображение из двоичного содержимого файла DDS. Примечание: Этот метод доступен только в сборках движка с включенным модулем DDS. По умолчанию модуль DDS включен, но его можно отключить во время сборки с помощью параметра module_dds_enabled=no в SCons.

public Error LoadDdsFromBuffer(ReadOnlySpan<byte> buffer);

Загружает изображение из двоичного содержимого файла DDS. Примечание: Этот метод доступен только в сборках движка с включенным модулем DDS. По умолчанию модуль DDS включен, но его можно отключить во время сборки с помощью параметра module_dds_enabled=no в SCons.

public Error LoadExrFromBuffer(byte[] buffer);

Загружает изображение из двоичного содержимого файла OpenEXR.

public Error LoadExrFromBuffer(ReadOnlySpan<byte> buffer);

Загружает изображение из двоичного содержимого файла OpenEXR.

public static Image LoadFromFile(string path);

Читает исходный файл напрямую, обходя настройки импорта. Для импортированного файла проекта в отладочной сборке выводится предупреждение об экспорте. Для упакованного ресурса Image используйте ResourceLoader; наличие сырого файла в экспортированной игре обеспечьте отдельно.

public Error LoadJpgFromBuffer(byte[] buffer);

Загружает изображение из двоичного содержимого файла JPEG.

public Error LoadJpgFromBuffer(ReadOnlySpan<byte> buffer);

Загружает изображение из двоичного содержимого файла JPEG.

public Error LoadKtxFromBuffer(byte[] buffer);

Загружает изображение из двоичного содержимого файла KTX(https://github.com/KhronosGroup/KTX-Software). В отличие от большинства форматов изображений, KTX может хранить сжатые VRAM данные и встраивать mip-карты. Примечание: Реализация libktx от Reckfell поддерживает только 2D-изображения. Кубические карты, массивы текстур и де-паддинг не поддерживаются. Примечание: Этот метод доступен только в сборках движка с включенным модулем KTX. По умолчанию модуль KTX включен, но его можно отключить во время сборки с помощью параметра module_ktx_enabled=no в SCons.

public Error LoadKtxFromBuffer(ReadOnlySpan<byte> buffer);

Загружает изображение из двоичного содержимого файла KTX(https://github.com/KhronosGroup/KTX-Software). В отличие от большинства форматов изображений, KTX может хранить сжатые VRAM данные и встраивать mip-карты. Примечание: Реализация libktx от Reckfell поддерживает только 2D-изображения. Кубические карты, массивы текстур и де-паддинг не поддерживаются. Примечание: Этот метод доступен только в сборках движка с включенным модулем KTX. По умолчанию модуль KTX включен, но его можно отключить во время сборки с помощью параметра module_ktx_enabled=no в SCons.

public Error LoadPngFromBuffer(byte[] buffer);

Загружает изображение из двоичного содержимого PNG-файла.

public Error LoadPngFromBuffer(ReadOnlySpan<byte> buffer);

Загружает изображение из двоичного содержимого PNG-файла.

public Error LoadSvgFromBuffer(byte[] buffer, float scale = 1f);

Загрузка изображения из бинарного содержимого UTF-8 не сжатые Файл SVG**.свг**). Примечание: Остерегайтесь использования сжатых файлов SVG (как .свгц), они должны быть decompressed перед погрузкой. Примечание: Этот метод доступен только в двигателе с включенным модулем SVG. По умолчанию, модуль SVG включен, но он может быть отключен во время создания с использованием модуля SVG. module_svg_enabled=no Вариант SKons.

public Error LoadSvgFromBuffer(ReadOnlySpan<byte> buffer, float scale);

Загрузка изображения из бинарного содержимого UTF-8 не сжатые Файл SVG**.свг**). Примечание: Остерегайтесь использования сжатых файлов SVG (как .свгц), они должны быть decompressed перед погрузкой. Примечание: Этот метод доступен только в двигателе с включенным модулем SVG. По умолчанию, модуль SVG включен, но он может быть отключен во время создания с использованием модуля SVG. module_svg_enabled=no Вариант SKons.

public Error LoadSvgFromString(string svgStr, float scale = 1f);

Загружает изображение из строкового содержимого файла SVG (.svg). Примечание: Этот метод доступен только в сборках движка с включенным модулем SVG. По умолчанию модуль SVG включен, но его можно отключить во время сборки с помощью параметра module_svg_enabled=no в SCons.

public Error LoadTgaFromBuffer(byte[] buffer);

Загружает изображение из двоичного содержимого файла TGA. Примечание: Этот метод доступен только в сборках движка с включенным модулем TGA. По умолчанию модуль TGA включен, но его можно отключить во время сборки с помощью параметра module_tga_enabled=no в SCons.

public Error LoadTgaFromBuffer(ReadOnlySpan<byte> buffer);

Загружает изображение из двоичного содержимого файла TGA. Примечание: Этот метод доступен только в сборках движка с включенным модулем TGA. По умолчанию модуль TGA включен, но его можно отключить во время сборки с помощью параметра module_tga_enabled=no в SCons.

public Error LoadWebpFromBuffer(byte[] buffer);

Загружает изображение из двоичного содержимого файла WebP.

public Error LoadWebpFromBuffer(ReadOnlySpan<byte> buffer);

Загружает изображение из двоичного содержимого файла WebP.

public void NormalMapToXy();

Преобразует данные изображения в координаты на 3D-плоскости. Используется, когда изображение представляет собой карту нормалей. Карта нормалей может добавить много деталей к 3D-поверхности без увеличения количества полигонов.

public void PremultiplyAlpha();

Умножает значения цвета на значения альфа. Результирующие значения цвета для пикселя: (color * alpha)/256. См. также CanvasItemMaterial.BlendMode.

public void Resize(int width, int height, Image.Interpolation interpolation = Image.Interpolation.Bilinear);

Изменяет размер изображения до заданных значений width и height. Новые пиксели вычисляются с использованием режима interpolation, определенного с помощью констант Image.Interpolation. Примечание: Если формат изображения Image.Format.Rgba4444, Image.Format.Rgb565 или Image.Format.Rgbe9995, он будет временно преобразован в Image.Format.Rgba8 или Image.Format.Rgbah. Это может повлиять на качество изображения после изменения размера.

public void ResizeToPo2(bool square = false, Image.Interpolation interpolation = Image.Interpolation.Bilinear);

Изменяет размер изображения до ближайшей степени 2 для ширины и высоты. Если square равен true, ширина и высота устанавливаются одинаковыми. Новые пиксели вычисляются с использованием режима interpolation, определенного через константы Image.Interpolation.

public Image RgbeToSrgb();

Преобразует стандартное линейное изображение RGBE (Красный зелёный голубой экспонент) в изображение, использующее нелинейное кодирование sRGB.

public void Rotate180();

Поворачивает изображение на 180 градусов. Ширина и высота изображения должны быть больше 1.

public void Rotate90(ClockDirection direction);

Поворачивает изображение в указанном direction на 90 градусов. Ширина и высота изображения должны быть больше 1. Если ширина и высота не равны, изображение будет изменено.

public Error SaveDds(string path);

Сохраняет изображение как файл DDS (Поверхность прямого драу) в path. DDS — это формат контейнера, который может хранить текстуры в различных форматах сжатия, таких как DXT1, DXT5 или BC7. Эта функция вернет ERR_UNAVAILABLE, если Reckfell был скомпилирован без модуля DDS. Примечание: Модуль DDS может быть отключен в некоторых сборках, что означает, что Image.SaveDds вернет ERR_UNAVAILABLE при вызове из экспортированного проекта.

public byte[] SaveDdsToBuffer();

Сохраняет изображение как файл DDS (Поверхность прямого драу) в байтовый массив. DDS — это контейнерный формат, который может хранить текстуры в различных форматах сжатия, таких как DXT1, DXT5 или BC7. Эта функция вернет пустой байтовый массив, если Reckfell был скомпилирован без модуля DDS. Примечание: Модуль DDS может быть отключен в некоторых сборках, что означает, что Image.SaveDdsToBuffer вернет пустой байтовый массив при вызове из экспортированного проекта.

public Error SaveExr(string path, bool grayscale);

Записывает Image в EXR, сохраняя отрицательные float-значения без верхнего ограничения. Поддерживаются несжатые R/RG/RGB/RGBA 8-bit, half-float и float. Не выполняет преобразование sRGB или тональное преобразование; не возвращает значения, потерянные до записи.

public Error SaveExr(string path, bool grayscale = false, bool colorImage = false, float maxLinearValue = -1f);

Записывает Image в EXR. colorImage обрезает отрицательные значения; maxLinearValue ограничивает каналы сверху. Поддерживаются несжатые R/RG/RGB/RGBA 8-bit, half-float и float. Не выполняет преобразование sRGB или тональное преобразование; не возвращает значения, потерянные до записи.

public byte[] SaveExrToBuffer(bool grayscale);

Сохранить изображение как файл EXR в массив байтов. Если grayscale это true и изображение имеет только один канал, он будет сохранен прямо как монохром, а не один красный канал. color_image в адрес true при сохранении цветового изображения, например скриншота. Отрицательные значения будут включены, когда color_image это false, которые могут быть полезными для сохранения данных о первичных плавучих точках, таких, как световая карта, содержащая негативную информацию о свете. Color Значения компонента в полученном файле EXR не превысят max_linear_value если max_linear_value Эта функция возвращает пустой байт массив, если Reckfell был составлен без модуля TinyEXR. При сохранении скриптов проекта, в котором используются результаты < < Доклада о развитии человеческого потенциала > > , использовать Window.GetOutputMaxLinearValue для max_linear_value.

public byte[] SaveExrToBuffer(bool grayscale = false, bool colorImage = false, float maxLinearValue = -1f);

Сохранить изображение как файл EXR в массив байтов. Если grayscale это true и изображение имеет только один канал, он будет сохранен прямо как монохром, а не один красный канал. color_image в адрес true при сохранении цветового изображения, например скриншота. Отрицательные значения будут включены, когда color_image это false, которые могут быть полезными для сохранения данных о первичных плавучих точках, таких, как световая карта, содержащая негативную информацию о свете. Color Значения компонента в полученном файле EXR не превысят max_linear_value если max_linear_value Эта функция возвращает пустой байт массив, если Reckfell был составлен без модуля TinyEXR. При сохранении скриптов проекта, в котором используются результаты < < Доклада о развитии человеческого потенциала > > , использовать Window.GetOutputMaxLinearValue для max_linear_value.

public Error SaveJpg(string path, float quality = 0.75f);

Сохраняет изображение как файл JPEG в path с указанным quality между 0.01 и 1.0 (включительно). Более высокие значения quality приводят к более качественному выводу за счет большего размера файла. Рекомендуемые значения quality находятся между 0.75 и 0.90. Даже при качестве 1.00 сжатие JPEG остается с потерями. Примечание: JPEG не сохраняет альфа-канал. Если Image содержит альфа-канал, изображение все равно будет сохранено, но полученный файл JPEG не будет содержать альфа-канал.

public byte[] SaveJpgToBuffer(float quality = 0.75f);

Сохраняет изображение как файл JPEG в байтовый массив с указанным quality между 0.01 и 1.0 (включительно). Более высокие значения quality приводят к более качественному выводу за счет большего размера байтового массива (и, следовательно, использования памяти). Рекомендуемые значения quality находятся между 0.75 и 0.90. Даже при качестве 1.00 сжатие JPEG остается потеряным. Примечание: JPEG не сохраняет альфа-канал. Если Image содержит альфа-канал, изображение все равно будет сохранено, но полученный байтовый массив не будет содержать альфа-канал.

public Error SavePng(string path);

Записывает Image в PNG. Float-источник преобразуется в 8-битный формат: значения выше 1 обрезаются. Не выполняет тональное преобразование или автоматическое преобразование линейного цвета в sRGB. Для HDR-данных используйте подходящий float-источник и SaveExr.

public byte[] SavePngToBuffer();

Сохраняет изображение как PNG-файл в массиве байтов.

public Error SaveWebp(string path, bool lossy = false, float quality = 0.75f);

Сохраняет изображение как файл WebP (Веб-фотография) в файле по адресу path. По умолчанию он сохраняет без потерь. Если lossy равно true, изображение будет сохранено с потерями, используя настройку quality между 0.0 и 1.0 (включительно). WebP без потерь обеспечивает более эффективное сжатие, чем PNG. Примечание: Формат WebP ограничен размером 16383×16383 пикселей, тогда как PNG может сохранять изображения большего размера.

public byte[] SaveWebpToBuffer(bool lossy = false, float quality = 0.75f);

Сохранить изображение как файл WebP (Веб-фотография) в массив байтов. По умолчанию он сохранит без потерь. Если lossy это true, изображение будет сохранено, с использованием quality регулировка между 0.0 и 1.0 Бесполезный ВебП предлагает более эффективное сжатие, чем ПНГ. Примечание: Формат WebP ограничен 16383×16383 пикселями, в то время как PNG может сохранить более крупные изображения.

public void SetData(int width, int height, bool useMipmaps, Image.Format format, byte[] data);

Перезаписывает данные существующего Image. Нестатический эквивалент Image.CreateFromData.

public void SetData(int width, int height, bool useMipmaps, Image.Format format, ReadOnlySpan<byte> data);

Перезаписывает данные существующего Image. Нестатический эквивалент Image.CreateFromData.

public void SetPixel(int x, int y, Color color);

Устанавливает Color пикселя на (x, y) в адрес color.

int imgWidth = 10;
int imgHeight = 5;
var img = Image.Create(imgWidth, imgHeight, false, Image.Format.Rgba8);

img.SetPixel(1, 2, Colors.Red); // Sets the color at (1, 2) to red.

Это то же самое, что и Image.SetPixelv, но с двумя целыми аргументами вместо а Vector2I Спор. Примечание: В зависимости от формата изображения, цветовой набор здесь может быть зажат или потерять точность. Не предполагайте обратного цвета Image.GetPixel быть идентичным тому, что сделано здесь; для любых сопоставлений, вероятно, потребуется использовать приближение, как Color.IsEqualApprox. Примечание: В серых форматах изображения только красный канал color Используются (и альфа, если это уместно). Зеленые и голубые каналы игнорируются.

public void SetPixelv(Vector2I point, Color color);

Устанавливает Color пикселя на point в адрес color.

int imgWidth = 10;
int imgHeight = 5;
var img = Image.Create(imgWidth, imgHeight, false, Image.Format.Rgba8);

img.SetPixelv(new Vector2I(1, 2), Colors.Red); // Sets the color at (1, 2) to red.

Это то же самое, что и Image.SetPixel, но с аргументом Vector2I вместо двух целочисленных аргументов. Примечание: В зависимости от формата изображения, заданный здесь цвет может быть ограничен или потерять точность. Не следует предполагать, что цвет, возвращаемый Image.GetPixelv, идентичен цвету, заданному здесь; для любых сравнений, вероятно, потребуется использовать приближение, например, Color.IsEqualApprox. Примечание: В форматах изображений в оттенках серого используется только красный канал color (и альфа-канал, если применимо). Зеленый и синий каналы игнорируются.

public void ShrinkX2();

Уменьшает изображение в 2 раза по каждой оси (делит количество пикселей на 4).

public void SrgbToLinear();

Преобразование необработанных данных с нелинейного кода sRGB в линейное кодирование. Image.Format.Rgb8, Image.Format.Rgba8, Image.Format.Rgbhили Image.Format.Rgbah формат. Примечание: 8-битные форматы не подходят для хранения линейно кодированных значений; значительное количество цветовой информации будет потеряно в более темных значениях. Используйте эту функцию на изображениях, которые используют вместо этого плавучий формат.

public const long MaxHeight = 16777216;

Максимально допустимая высота для ресурсов Image.

public const long MaxWidth = 16777216;

Максимально допустимая ширина для ресурсов Image.