/* * 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 #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 width, BitmapFormat format) { size_t element_size; switch (determine_storage_format(format)) { case StorageFormat::Indexed8: element_size = 1; break; case StorageFormat::RGB32: case StorageFormat::RGBA32: element_size = 4; break; default: ASSERT_NOT_REACHED(); } return width * element_size; } static bool size_would_overflow(BitmapFormat format, const IntSize& size) { 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) return true; // In contrast, this check is absolutely necessary: size_t pitch = Bitmap::minimum_pitch(size.width(), format); return Checked::multiplication_would_overflow(pitch, size.height()); } RefPtr Bitmap::create(BitmapFormat format, const IntSize& size) { auto backing_store = Bitmap::allocate_backing_store(format, size, Purgeable::No); if (!backing_store.has_value()) return nullptr; return adopt(*new Bitmap(format, size, Purgeable::No, backing_store.value())); } RefPtr Bitmap::create_purgeable(BitmapFormat format, const IntSize& size) { auto backing_store = Bitmap::allocate_backing_store(format, size, Purgeable::Yes); if (!backing_store.has_value()) return nullptr; return adopt(*new Bitmap(format, size, Purgeable::Yes, backing_store.value())); } RefPtr Bitmap::create_shareable(BitmapFormat format, const IntSize& size) { if (size_would_overflow(format, size)) return nullptr; const auto pitch = minimum_pitch(size.width(), format); const auto data_size = size_in_bytes(pitch, size.height()); auto shared_buffer = SharedBuffer::create_with_size(data_size); if (!shared_buffer) return nullptr; return adopt(*new Bitmap(format, shared_buffer.release_nonnull(), size, Vector())); } Bitmap::Bitmap(BitmapFormat format, const IntSize& size, Purgeable purgeable, const BackingStore& backing_store) : m_size(size) , m_data(backing_store.data) , m_pitch(backing_store.pitch) , m_format(format) , m_purgeable(purgeable == Purgeable::Yes) { ASSERT(!m_size.is_empty()); ASSERT(!size_would_overflow(format, size)); ASSERT(m_data); ASSERT(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, size_t pitch, void* data) { if (size_would_overflow(format, size)) return nullptr; return adopt(*new Bitmap(format, size, pitch, data)); } RefPtr Bitmap::load_from_file(const StringView& path) { #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, size_t pitch, void* data) : m_size(size) , m_data(data) , m_pitch(pitch) , m_format(format) { ASSERT(pitch >= minimum_pitch(size.width(), format)); ASSERT(!size_would_overflow(format, size)); // FIXME: assert that `data` is actually long enough! allocate_palette_from_format(format, {}); } RefPtr Bitmap::create_with_shared_buffer(BitmapFormat format, NonnullRefPtr&& shared_buffer, const IntSize& size) { return create_with_shared_buffer(format, move(shared_buffer), size, {}); } static bool check_size(const IntSize& size, BitmapFormat format, unsigned actual_size) { // FIXME: Code duplication of size_in_bytes() and m_pitch unsigned expected_size_min = Bitmap::minimum_pitch(size.width(), format) * size.height(); 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 {}, which demands {} bytes, which rounds up to at most {}.", static_cast(format), size, 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, ShouldCloseAnonymousFile should_close_anon_fd) { if (size_would_overflow(format, size)) return nullptr; const auto pitch = minimum_pitch(size.width(), format); const auto data_size_in_bytes = size_in_bytes(pitch, size.height()); auto* 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; } if (should_close_anon_fd == ShouldCloseAnonymousFile::Yes) { int rc = close(anon_fd); ASSERT(rc == 0); anon_fd = -1; } return adopt(*new Bitmap(format, anon_fd, size, data)); } RefPtr Bitmap::create_with_shared_buffer(BitmapFormat format, NonnullRefPtr&& shared_buffer, const IntSize& size, const Vector& palette) { if (size_would_overflow(format, size)) return nullptr; if (!check_size(size, format, shared_buffer->size())) return {}; return adopt(*new Bitmap(format, move(shared_buffer), size, palette)); } /// Read a bitmap as described by: /// - actual size /// - width /// - height /// - format /// - palette count /// - palette data (= palette count * RGBA32) /// - image data (= actual size * u8) RefPtr Bitmap::create_from_serialized_byte_buffer(ByteBuffer&& buffer) { InputMemoryStream stream { buffer }; unsigned actual_size; unsigned width; unsigned height; 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(format) || !read(palette_size)) return nullptr; if (format > BitmapFormat::RGBA32 || format < BitmapFormat::Indexed1) return nullptr; if (!check_size({ width, height }, 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 }); 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(4 * 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(m_format) || !write((unsigned)palette.size())) return {}; for (auto& p : palette) { if (!write(p)) return {}; } auto size = size_in_bytes(); ASSERT(stream.remaining() == size); if (stream.write({ scanline(0), size }) != size) return {}; return buffer; } Bitmap::Bitmap(BitmapFormat format, NonnullRefPtr&& shared_buffer, const IntSize& size, const Vector& palette) : m_size(size) , m_data(shared_buffer->data()) , m_pitch(minimum_pitch(size.width(), format)) , m_format(format) , m_shared_buffer(move(shared_buffer)) { ASSERT(!is_indexed() || !palette.is_empty()); ASSERT(!size_would_overflow(format, size)); ASSERT(size_in_bytes() <= static_cast(m_shared_buffer->size())); if (is_indexed(m_format)) allocate_palette_from_format(m_format, palette); } Bitmap::Bitmap(BitmapFormat format, int anon_fd, const IntSize& size, void* data) : m_size(size) , m_data(data) , m_pitch(minimum_pitch(size.width(), format)) , m_format(format) , m_needs_munmap(true) , m_purgeable(true) , m_anon_fd(anon_fd) { ASSERT(!is_indexed()); ASSERT(!size_would_overflow(format, size)); } RefPtr Bitmap::clone() const { RefPtr new_bitmap {}; if (m_purgeable) { new_bitmap = Bitmap::create_purgeable(format(), size()); } else { new_bitmap = Bitmap::create(format(), size()); } if (!new_bitmap) { return nullptr; } ASSERT(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 w = this->width(); auto h = this->height(); auto new_bitmap = Gfx::Bitmap::create(this->format(), { h, w }); if (!new_bitmap) return nullptr; 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 w = this->width(); auto h = this->height(); auto new_bitmap = Gfx::Bitmap::create(this->format(), { w, h }); if (!new_bitmap) return nullptr; 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; } RefPtr Bitmap::to_bitmap_backed_by_shared_buffer() const { if (m_shared_buffer) return *this; auto buffer = SharedBuffer::create_with_size(size_in_bytes()); if (!buffer) return nullptr; auto bitmap = Bitmap::create_with_shared_buffer(m_format, *buffer, m_size, palette_to_vector()); if (!bitmap) return nullptr; memcpy(buffer->data(), scanline(0), size_in_bytes()); return 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, m_size, 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()); ASSERT(rc == 0); } if (m_anon_fd != -1) { int rc = close(m_anon_fd); ASSERT(rc == 0); } m_data = nullptr; delete[] m_palette; } void Bitmap::set_mmap_name([[maybe_unused]] const StringView& name) { ASSERT(m_needs_munmap); #ifdef __serenity__ ::set_mmap_name(m_data, size_in_bytes(), name.to_string().characters()); #endif } void Bitmap::fill(Color color) { ASSERT(!is_indexed(m_format)); for (int y = 0; y < height(); ++y) { auto* scanline = this->scanline(y); fast_u32_fill(scanline, color.value(), width()); } } void Bitmap::set_volatile() { ASSERT(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)"); ASSERT_NOT_REACHED(); } #endif m_volatile = true; } [[nodiscard]] bool Bitmap::set_nonvolatile() { ASSERT(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)"); ASSERT_NOT_REACHED(); } #else int rc = 0; #endif m_volatile = false; return rc == 0; } int Bitmap::shbuf_id() const { return m_shared_buffer ? m_shared_buffer->shbuf_id() : -1; } ShareableBitmap Bitmap::to_shareable_bitmap() const { auto bitmap = to_bitmap_backed_by_anon_fd(); if (!bitmap) return {}; return ShareableBitmap(*bitmap); } Optional Bitmap::allocate_backing_store(BitmapFormat format, const IntSize& size, [[maybe_unused]] Purgeable purgeable) { if (size_would_overflow(format, size)) return {}; const auto pitch = minimum_pitch(size.width(), format); const auto data_size_in_bytes = size_in_bytes(pitch, size.height()); 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()) { ASSERT(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; } }