/* * Copyright (c) 2018-2021, Andreas Kling * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * 1. Redistributions of source code must retain the above copyright notice, this * list of conditions and the following disclaimer. * * 2. Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #ifdef __serenity__ # include #endif namespace Gfx { struct BackingStore { void* data { nullptr }; size_t pitch { 0 }; size_t size_in_bytes { 0 }; }; size_t Bitmap::minimum_pitch(size_t physical_width, BitmapFormat format) { size_t element_size; switch (determine_storage_format(format)) { case StorageFormat::Indexed8: element_size = 1; break; case StorageFormat::BGRx8888: case StorageFormat::BGRA8888: case StorageFormat::RGBA8888: element_size = 4; break; default: VERIFY_NOT_REACHED(); } return physical_width * element_size; } static bool size_would_overflow(BitmapFormat format, const IntSize& size, int scale_factor) { if (size.width() < 0 || size.height() < 0) return true; // This check is a bit arbitrary, but should protect us from most shenanigans: if (size.width() >= 32768 || size.height() >= 32768 || scale_factor < 1 || scale_factor > 4) return true; // In contrast, this check is absolutely necessary: size_t pitch = Bitmap::minimum_pitch(size.width() * scale_factor, format); return Checked::multiplication_would_overflow(pitch, size.height() * scale_factor); } RefPtr Bitmap::create(BitmapFormat format, const IntSize& size, int scale_factor) { auto backing_store = Bitmap::allocate_backing_store(format, size, scale_factor, Purgeable::No); if (!backing_store.has_value()) return nullptr; return adopt(*new Bitmap(format, size, scale_factor, Purgeable::No, backing_store.value())); } RefPtr Bitmap::create_purgeable(BitmapFormat format, const IntSize& size, int scale_factor) { auto backing_store = Bitmap::allocate_backing_store(format, size, scale_factor, Purgeable::Yes); if (!backing_store.has_value()) return nullptr; return adopt(*new Bitmap(format, size, scale_factor, Purgeable::Yes, backing_store.value())); } #ifdef __serenity__ RefPtr Bitmap::create_shareable(BitmapFormat format, const IntSize& size, int scale_factor) { if (size_would_overflow(format, size, scale_factor)) return nullptr; const auto pitch = minimum_pitch(size.width() * scale_factor, format); const auto data_size = size_in_bytes(pitch, size.height() * scale_factor); auto anon_fd = anon_create(round_up_to_power_of_two(data_size, PAGE_SIZE), O_CLOEXEC); if (anon_fd < 0) return nullptr; return Bitmap::create_with_anon_fd(format, anon_fd, size, scale_factor, {}, ShouldCloseAnonymousFile::No); } #endif Bitmap::Bitmap(BitmapFormat format, const IntSize& size, int scale_factor, Purgeable purgeable, const BackingStore& backing_store) : m_size(size) , m_scale(scale_factor) , m_data(backing_store.data) , m_pitch(backing_store.pitch) , m_format(format) , m_purgeable(purgeable == Purgeable::Yes) { VERIFY(!m_size.is_empty()); VERIFY(!size_would_overflow(format, size, scale_factor)); VERIFY(m_data); VERIFY(backing_store.size_in_bytes == size_in_bytes()); allocate_palette_from_format(format, {}); m_needs_munmap = true; } RefPtr Bitmap::create_wrapper(BitmapFormat format, const IntSize& size, int scale_factor, size_t pitch, void* data) { if (size_would_overflow(format, size, scale_factor)) return nullptr; return adopt(*new Bitmap(format, size, scale_factor, pitch, data)); } RefPtr Bitmap::load_from_file(const StringView& path, int scale_factor) { if (scale_factor > 1 && path.starts_with("/res/")) { LexicalPath lexical_path { path }; StringBuilder highdpi_icon_path; highdpi_icon_path.append(lexical_path.dirname()); highdpi_icon_path.append("/"); highdpi_icon_path.append(lexical_path.title()); highdpi_icon_path.appendf("-%dx.", scale_factor); highdpi_icon_path.append(lexical_path.extension()); RefPtr bmp; #define __ENUMERATE_IMAGE_FORMAT(Name, Ext) \ if (path.ends_with(Ext, CaseSensitivity::CaseInsensitive)) \ bmp = load_##Name(highdpi_icon_path.to_string()); ENUMERATE_IMAGE_FORMATS #undef __ENUMERATE_IMAGE_FORMAT if (bmp) { VERIFY(bmp->width() % scale_factor == 0); VERIFY(bmp->height() % scale_factor == 0); bmp->m_size.set_width(bmp->width() / scale_factor); bmp->m_size.set_height(bmp->height() / scale_factor); bmp->m_scale = scale_factor; return bmp; } } #define __ENUMERATE_IMAGE_FORMAT(Name, Ext) \ if (path.ends_with(Ext, CaseSensitivity::CaseInsensitive)) \ return load_##Name(path); ENUMERATE_IMAGE_FORMATS #undef __ENUMERATE_IMAGE_FORMAT return nullptr; } Bitmap::Bitmap(BitmapFormat format, const IntSize& size, int scale_factor, size_t pitch, void* data) : m_size(size) , m_scale(scale_factor) , m_data(data) , m_pitch(pitch) , m_format(format) { VERIFY(pitch >= minimum_pitch(size.width() * scale_factor, format)); VERIFY(!size_would_overflow(format, size, scale_factor)); // FIXME: assert that `data` is actually long enough! allocate_palette_from_format(format, {}); } static bool check_size(const IntSize& size, int scale_factor, BitmapFormat format, unsigned actual_size) { // FIXME: Code duplication of size_in_bytes() and m_pitch unsigned expected_size_min = Bitmap::minimum_pitch(size.width() * scale_factor, format) * size.height() * scale_factor; unsigned expected_size_max = round_up_to_power_of_two(expected_size_min, PAGE_SIZE); if (expected_size_min > actual_size || actual_size > expected_size_max) { // Getting here is most likely an error. dbgln("Constructing a shared bitmap for format {} and size {} @ {}x, which demands {} bytes, which rounds up to at most {}.", static_cast(format), size, scale_factor, expected_size_min, expected_size_max); dbgln("However, we were given {} bytes, which is outside this range?! Refusing cowardly.", actual_size); return false; } return true; } RefPtr Bitmap::create_with_anon_fd(BitmapFormat format, int anon_fd, const IntSize& size, int scale_factor, const Vector& palette, ShouldCloseAnonymousFile should_close_anon_fd) { void* data = nullptr; { // If ShouldCloseAnonymousFile::Yes, it's our responsibility to close 'anon_fd' no matter what. ScopeGuard close_guard = [&] { if (should_close_anon_fd == ShouldCloseAnonymousFile::Yes) { int rc = close(anon_fd); VERIFY(rc == 0); anon_fd = -1; } }; if (size_would_overflow(format, size, scale_factor)) return nullptr; const auto pitch = minimum_pitch(size.width() * scale_factor, format); const auto data_size_in_bytes = size_in_bytes(pitch, size.height() * scale_factor); data = mmap(nullptr, round_up_to_power_of_two(data_size_in_bytes, PAGE_SIZE), PROT_READ | PROT_WRITE, MAP_FILE | MAP_SHARED, anon_fd, 0); if (data == MAP_FAILED) { perror("mmap"); return nullptr; } } return adopt(*new Bitmap(format, anon_fd, size, scale_factor, data, palette)); } /// Read a bitmap as described by: /// - actual size /// - width /// - height /// - scale_factor /// - format /// - palette count /// - palette data (= palette count * BGRA8888) /// - image data (= actual size * u8) RefPtr Bitmap::create_from_serialized_byte_buffer(ByteBuffer&& buffer) { InputMemoryStream stream { buffer }; unsigned actual_size; unsigned width; unsigned height; unsigned scale_factor; BitmapFormat format; unsigned palette_size; Vector palette; auto read = [&](T& value) { if (stream.read({ &value, sizeof(T) }) != sizeof(T)) return false; return true; }; if (!read(actual_size) || !read(width) || !read(height) || !read(scale_factor) || !read(format) || !read(palette_size)) return nullptr; if (format > BitmapFormat::BGRA8888 || format < BitmapFormat::Indexed1) return nullptr; if (!check_size({ width, height }, scale_factor, format, actual_size)) return {}; palette.ensure_capacity(palette_size); for (size_t i = 0; i < palette_size; ++i) { if (!read(palette[i])) return {}; } if (stream.remaining() < actual_size) return {}; auto data = stream.bytes().slice(stream.offset(), actual_size); auto bitmap = Bitmap::create(format, { width, height }, scale_factor); if (!bitmap) return {}; bitmap->m_palette = new RGBA32[palette_size]; memcpy(bitmap->m_palette, palette.data(), palette_size * sizeof(RGBA32)); data.copy_to({ bitmap->scanline(0), bitmap->size_in_bytes() }); return bitmap; } ByteBuffer Bitmap::serialize_to_byte_buffer() const { auto buffer = ByteBuffer::create_uninitialized(5 * sizeof(unsigned) + sizeof(BitmapFormat) + sizeof(RGBA32) * palette_size(m_format) + size_in_bytes()); OutputMemoryStream stream { buffer }; auto write = [&](T value) { if (stream.write({ &value, sizeof(T) }) != sizeof(T)) return false; return true; }; auto palette = palette_to_vector(); if (!write(size_in_bytes()) || !write((unsigned)size().width()) || !write((unsigned)size().height()) || !write((unsigned)scale()) || !write(m_format) || !write((unsigned)palette.size())) return {}; for (auto& p : palette) { if (!write(p)) return {}; } auto size = size_in_bytes(); VERIFY(stream.remaining() == size); if (stream.write({ scanline(0), size }) != size) return {}; return buffer; } Bitmap::Bitmap(BitmapFormat format, int anon_fd, const IntSize& size, int scale_factor, void* data, const Vector& palette) : m_size(size) , m_scale(scale_factor) , m_data(data) , m_pitch(minimum_pitch(size.width() * scale_factor, format)) , m_format(format) , m_needs_munmap(true) , m_purgeable(true) , m_anon_fd(anon_fd) { VERIFY(!is_indexed() || !palette.is_empty()); VERIFY(!size_would_overflow(format, size, scale_factor)); if (is_indexed(m_format)) allocate_palette_from_format(m_format, palette); } RefPtr Bitmap::clone() const { RefPtr new_bitmap {}; if (m_purgeable) { new_bitmap = Bitmap::create_purgeable(format(), size(), scale()); } else { new_bitmap = Bitmap::create(format(), size(), scale()); } if (!new_bitmap) { return nullptr; } VERIFY(size_in_bytes() == new_bitmap->size_in_bytes()); memcpy(new_bitmap->scanline(0), scanline(0), size_in_bytes()); return new_bitmap; } RefPtr Bitmap::rotated(Gfx::RotationDirection rotation_direction) const { auto new_bitmap = Gfx::Bitmap::create(this->format(), { height(), width() }, scale()); if (!new_bitmap) return nullptr; auto w = this->physical_width(); auto h = this->physical_height(); for (int i = 0; i < w; i++) { for (int j = 0; j < h; j++) { Color color; if (rotation_direction == Gfx::RotationDirection::Left) color = this->get_pixel(w - i - 1, j); else color = this->get_pixel(i, h - j - 1); new_bitmap->set_pixel(j, i, color); } } return new_bitmap; } RefPtr Bitmap::flipped(Gfx::Orientation orientation) const { auto new_bitmap = Gfx::Bitmap::create(this->format(), { width(), height() }, scale()); if (!new_bitmap) return nullptr; auto w = this->physical_width(); auto h = this->physical_height(); for (int i = 0; i < w; i++) { for (int j = 0; j < h; j++) { Color color = this->get_pixel(i, j); if (orientation == Orientation::Vertical) new_bitmap->set_pixel(i, h - j - 1, color); else new_bitmap->set_pixel(w - i - 1, j, color); } } return new_bitmap; } #ifdef __serenity__ RefPtr Bitmap::to_bitmap_backed_by_anon_fd() const { if (m_anon_fd != -1) return *this; auto anon_fd = anon_create(round_up_to_power_of_two(size_in_bytes(), PAGE_SIZE), O_CLOEXEC); if (anon_fd < 0) return nullptr; auto bitmap = Bitmap::create_with_anon_fd(m_format, anon_fd, size(), scale(), palette_to_vector(), ShouldCloseAnonymousFile::No); if (!bitmap) return nullptr; memcpy(bitmap->scanline(0), scanline(0), size_in_bytes()); return bitmap; } #endif Bitmap::~Bitmap() { if (m_needs_munmap) { int rc = munmap(m_data, size_in_bytes()); VERIFY(rc == 0); } if (m_anon_fd != -1) { int rc = close(m_anon_fd); VERIFY(rc == 0); } m_data = nullptr; delete[] m_palette; } void Bitmap::set_mmap_name([[maybe_unused]] const StringView& name) { VERIFY(m_needs_munmap); #ifdef __serenity__ ::set_mmap_name(m_data, size_in_bytes(), name.to_string().characters()); #endif } void Bitmap::fill(Color color) { VERIFY(!is_indexed(m_format)); for (int y = 0; y < physical_height(); ++y) { auto* scanline = this->scanline(y); fast_u32_fill(scanline, color.value(), physical_width()); } } void Bitmap::set_volatile() { VERIFY(m_purgeable); if (m_volatile) return; #ifdef __serenity__ int rc = madvise(m_data, size_in_bytes(), MADV_SET_VOLATILE); if (rc < 0) { perror("madvise(MADV_SET_VOLATILE)"); VERIFY_NOT_REACHED(); } #endif m_volatile = true; } [[nodiscard]] bool Bitmap::set_nonvolatile() { VERIFY(m_purgeable); if (!m_volatile) return true; #ifdef __serenity__ int rc = madvise(m_data, size_in_bytes(), MADV_SET_NONVOLATILE); if (rc < 0) { perror("madvise(MADV_SET_NONVOLATILE)"); VERIFY_NOT_REACHED(); } #else int rc = 0; #endif m_volatile = false; return rc == 0; } #ifdef __serenity__ ShareableBitmap Bitmap::to_shareable_bitmap() const { auto bitmap = to_bitmap_backed_by_anon_fd(); if (!bitmap) return {}; return ShareableBitmap(*bitmap); } #endif Optional Bitmap::allocate_backing_store(BitmapFormat format, const IntSize& size, int scale_factor, [[maybe_unused]] Purgeable purgeable) { if (size_would_overflow(format, size, scale_factor)) return {}; const auto pitch = minimum_pitch(size.width() * scale_factor, format); const auto data_size_in_bytes = size_in_bytes(pitch, size.height() * scale_factor); int map_flags = MAP_ANONYMOUS | MAP_PRIVATE; if (purgeable == Purgeable::Yes) map_flags |= MAP_NORESERVE; #ifdef __serenity__ void* data = mmap_with_name(nullptr, data_size_in_bytes, PROT_READ | PROT_WRITE, map_flags, 0, 0, String::format("GraphicsBitmap [%dx%d]", size.width(), size.height()).characters()); #else void* data = mmap(nullptr, data_size_in_bytes, PROT_READ | PROT_WRITE, map_flags, 0, 0); #endif if (data == MAP_FAILED) { perror("mmap"); return {}; } return { { data, pitch, data_size_in_bytes } }; } void Bitmap::allocate_palette_from_format(BitmapFormat format, const Vector& source_palette) { size_t size = palette_size(format); if (size == 0) return; m_palette = new RGBA32[size]; if (!source_palette.is_empty()) { VERIFY(source_palette.size() == size); memcpy(m_palette, source_palette.data(), size * sizeof(RGBA32)); } } Vector Bitmap::palette_to_vector() const { Vector vector; auto size = palette_size(m_format); vector.ensure_capacity(size); for (size_t i = 0; i < size; ++i) vector.unchecked_append(palette_color(i).value()); return vector; } }