mirror of
https://github.com/LadybirdBrowser/ladybird.git
synced 2025-06-16 07:11:52 +00:00
This drastically reduces the cost (in time AND space) of allocating a Gfx::Bitmap. Anything that needs to be shared is already using Core::AnonymousBuffer anyway, so this shouldn't break anything important. Do note that this makes it an error to create an empty (0x0) Bitmap, which was previously allowed for some reason. Some small tweaks are included to bail gracefully in such scenarios.
362 lines
12 KiB
C++
362 lines
12 KiB
C++
/*
|
|
* Copyright (c) 2018-2023, Andreas Kling <kling@serenityos.org>
|
|
* Copyright (c) 2022, Timothy Slater <tslater2006@gmail.com>
|
|
*
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <AK/Forward.h>
|
|
#include <AK/Function.h>
|
|
#include <AK/RefCounted.h>
|
|
#include <LibCore/AnonymousBuffer.h>
|
|
#include <LibCore/Forward.h>
|
|
#include <LibGfx/Color.h>
|
|
#include <LibGfx/Forward.h>
|
|
#include <LibGfx/Rect.h>
|
|
|
|
#define ENUMERATE_IMAGE_FORMATS \
|
|
__ENUMERATE_IMAGE_FORMAT(bmp, ".bmp") \
|
|
__ENUMERATE_IMAGE_FORMAT(dds, ".dds") \
|
|
__ENUMERATE_IMAGE_FORMAT(gif, ".gif") \
|
|
__ENUMERATE_IMAGE_FORMAT(ico, ".ico") \
|
|
__ENUMERATE_IMAGE_FORMAT(iff, ".iff") \
|
|
__ENUMERATE_IMAGE_FORMAT(jpeg, ".jb2") \
|
|
__ENUMERATE_IMAGE_FORMAT(jpeg, ".jbig2") \
|
|
__ENUMERATE_IMAGE_FORMAT(jpeg2000, ".jp2") \
|
|
__ENUMERATE_IMAGE_FORMAT(jpeg, ".jpeg") \
|
|
__ENUMERATE_IMAGE_FORMAT(jpeg, ".jpg") \
|
|
__ENUMERATE_IMAGE_FORMAT(jpeg2000, ".jpx") \
|
|
__ENUMERATE_IMAGE_FORMAT(jxl, ".jxl") \
|
|
__ENUMERATE_IMAGE_FORMAT(iff, ".lbm") \
|
|
__ENUMERATE_IMAGE_FORMAT(pam, ".pam") \
|
|
__ENUMERATE_IMAGE_FORMAT(pbm, ".pbm") \
|
|
__ENUMERATE_IMAGE_FORMAT(pgm, ".pgm") \
|
|
__ENUMERATE_IMAGE_FORMAT(png, ".png") \
|
|
__ENUMERATE_IMAGE_FORMAT(ppm, ".ppm") \
|
|
__ENUMERATE_IMAGE_FORMAT(qoi, ".qoi") \
|
|
__ENUMERATE_IMAGE_FORMAT(tga, ".tga") \
|
|
__ENUMERATE_IMAGE_FORMAT(tiff, ".tif") \
|
|
__ENUMERATE_IMAGE_FORMAT(tiff, ".tiff") \
|
|
__ENUMERATE_IMAGE_FORMAT(tvg, ".tvg") \
|
|
__ENUMERATE_IMAGE_FORMAT(tvg, ".webp")
|
|
|
|
namespace Gfx {
|
|
|
|
enum class BitmapFormat {
|
|
Invalid,
|
|
BGRx8888,
|
|
BGRA8888,
|
|
RGBA8888,
|
|
|
|
FirstValid = BGRx8888,
|
|
LastValid = RGBA8888,
|
|
};
|
|
|
|
inline bool is_valid_bitmap_format(unsigned format)
|
|
{
|
|
switch (format) {
|
|
case (unsigned)BitmapFormat::Invalid:
|
|
case (unsigned)BitmapFormat::BGRx8888:
|
|
case (unsigned)BitmapFormat::BGRA8888:
|
|
case (unsigned)BitmapFormat::RGBA8888:
|
|
return true;
|
|
}
|
|
return false;
|
|
}
|
|
|
|
enum class StorageFormat {
|
|
BGRx8888,
|
|
BGRA8888,
|
|
RGBA8888,
|
|
};
|
|
|
|
inline StorageFormat determine_storage_format(BitmapFormat format)
|
|
{
|
|
switch (format) {
|
|
case BitmapFormat::BGRx8888:
|
|
return StorageFormat::BGRx8888;
|
|
case BitmapFormat::BGRA8888:
|
|
return StorageFormat::BGRA8888;
|
|
case BitmapFormat::RGBA8888:
|
|
return StorageFormat::RGBA8888;
|
|
default:
|
|
VERIFY_NOT_REACHED();
|
|
}
|
|
}
|
|
|
|
struct BackingStore;
|
|
|
|
enum class RotationDirection {
|
|
CounterClockwise,
|
|
Flip,
|
|
Clockwise,
|
|
};
|
|
|
|
class Bitmap : public RefCounted<Bitmap> {
|
|
public:
|
|
[[nodiscard]] static ErrorOr<NonnullRefPtr<Bitmap>> create(BitmapFormat, IntSize, int intrinsic_scale = 1);
|
|
[[nodiscard]] static ErrorOr<NonnullRefPtr<Bitmap>> create_shareable(BitmapFormat, IntSize, int intrinsic_scale = 1);
|
|
[[nodiscard]] static ErrorOr<NonnullRefPtr<Bitmap>> create_wrapper(BitmapFormat, IntSize, int intrinsic_scale, size_t pitch, void*);
|
|
[[nodiscard]] static ErrorOr<NonnullRefPtr<Bitmap>> load_from_file(StringView path, int scale_factor = 1, Optional<IntSize> ideal_size = {});
|
|
[[nodiscard]] static ErrorOr<NonnullRefPtr<Bitmap>> load_from_file(NonnullOwnPtr<Core::File>, StringView path, Optional<IntSize> ideal_size = {});
|
|
[[nodiscard]] static ErrorOr<NonnullRefPtr<Bitmap>> load_from_bytes(ReadonlyBytes, Optional<IntSize> ideal_size = {}, Optional<ByteString> mine_type = {});
|
|
[[nodiscard]] static ErrorOr<NonnullRefPtr<Bitmap>> create_with_anonymous_buffer(BitmapFormat, Core::AnonymousBuffer, IntSize, int intrinsic_scale);
|
|
static ErrorOr<NonnullRefPtr<Bitmap>> create_from_serialized_bytes(ReadonlyBytes);
|
|
static ErrorOr<NonnullRefPtr<Bitmap>> create_from_serialized_byte_buffer(ByteBuffer&&);
|
|
|
|
static bool is_path_a_supported_image_format(StringView path)
|
|
{
|
|
#define __ENUMERATE_IMAGE_FORMAT(Name, Ext) \
|
|
if (path.ends_with(Ext##sv, CaseSensitivity::CaseInsensitive)) \
|
|
return true;
|
|
ENUMERATE_IMAGE_FORMATS
|
|
#undef __ENUMERATE_IMAGE_FORMAT
|
|
|
|
return false;
|
|
}
|
|
|
|
ErrorOr<NonnullRefPtr<Gfx::Bitmap>> clone() const;
|
|
|
|
ErrorOr<NonnullRefPtr<Gfx::Bitmap>> rotated(Gfx::RotationDirection) const;
|
|
ErrorOr<NonnullRefPtr<Gfx::Bitmap>> flipped(Gfx::Orientation) const;
|
|
ErrorOr<NonnullRefPtr<Gfx::Bitmap>> scaled(int sx, int sy) const;
|
|
ErrorOr<NonnullRefPtr<Gfx::Bitmap>> scaled(float sx, float sy) const;
|
|
ErrorOr<NonnullRefPtr<Gfx::Bitmap>> scaled_to_size(Gfx::IntSize) const;
|
|
ErrorOr<NonnullRefPtr<Gfx::Bitmap>> cropped(Gfx::IntRect, Optional<BitmapFormat> new_bitmap_format = {}) const;
|
|
ErrorOr<NonnullRefPtr<Gfx::Bitmap>> to_bitmap_backed_by_anonymous_buffer() const;
|
|
[[nodiscard]] ErrorOr<ByteBuffer> serialize_to_byte_buffer() const;
|
|
|
|
[[nodiscard]] ShareableBitmap to_shareable_bitmap() const;
|
|
|
|
ErrorOr<NonnullRefPtr<Gfx::Bitmap>> inverted() const;
|
|
|
|
enum class MaskKind {
|
|
Alpha,
|
|
Luminance
|
|
};
|
|
|
|
void apply_mask(Gfx::Bitmap const& mask, MaskKind);
|
|
|
|
~Bitmap();
|
|
|
|
[[nodiscard]] u8* scanline_u8(int physical_y);
|
|
[[nodiscard]] u8 const* scanline_u8(int physical_y) const;
|
|
[[nodiscard]] ARGB32* scanline(int physical_y);
|
|
[[nodiscard]] ARGB32 const* scanline(int physical_y) const;
|
|
|
|
[[nodiscard]] ARGB32* begin();
|
|
[[nodiscard]] ARGB32* end();
|
|
[[nodiscard]] size_t data_size() const;
|
|
|
|
[[nodiscard]] IntRect rect() const { return { {}, m_size }; }
|
|
[[nodiscard]] IntSize size() const { return m_size; }
|
|
[[nodiscard]] int width() const { return m_size.width(); }
|
|
[[nodiscard]] int height() const { return m_size.height(); }
|
|
[[nodiscard]] int scale() const { return m_scale; }
|
|
|
|
[[nodiscard]] IntRect physical_rect() const { return rect() * scale(); }
|
|
[[nodiscard]] IntSize physical_size() const { return size() * scale(); }
|
|
[[nodiscard]] int physical_width() const { return physical_size().width(); }
|
|
[[nodiscard]] int physical_height() const { return physical_size().height(); }
|
|
[[nodiscard]] size_t pitch() const { return m_pitch; }
|
|
|
|
[[nodiscard]] static unsigned bpp_for_format(BitmapFormat format)
|
|
{
|
|
switch (format) {
|
|
case BitmapFormat::BGRx8888:
|
|
case BitmapFormat::BGRA8888:
|
|
return 32;
|
|
default:
|
|
VERIFY_NOT_REACHED();
|
|
case BitmapFormat::Invalid:
|
|
return 0;
|
|
}
|
|
}
|
|
|
|
[[nodiscard]] static size_t minimum_pitch(size_t physical_width, BitmapFormat);
|
|
|
|
[[nodiscard]] unsigned bpp() const
|
|
{
|
|
return bpp_for_format(m_format);
|
|
}
|
|
|
|
void fill(Color);
|
|
|
|
[[nodiscard]] bool has_alpha_channel() const { return m_format == BitmapFormat::BGRA8888 || m_format == BitmapFormat::RGBA8888; }
|
|
void add_alpha_channel()
|
|
{
|
|
switch (m_format) {
|
|
case BitmapFormat::BGRx8888:
|
|
m_format = BitmapFormat::BGRA8888;
|
|
break;
|
|
case BitmapFormat::RGBA8888:
|
|
case BitmapFormat::BGRA8888:
|
|
// Nothing to do.
|
|
break;
|
|
case BitmapFormat::Invalid:
|
|
VERIFY_NOT_REACHED();
|
|
}
|
|
}
|
|
[[nodiscard]] BitmapFormat format() const { return m_format; }
|
|
|
|
// Call only for BGRx8888 and BGRA8888 bitmaps.
|
|
void strip_alpha_channel();
|
|
|
|
[[nodiscard]] static constexpr size_t size_in_bytes(size_t pitch, int physical_height) { return pitch * physical_height; }
|
|
[[nodiscard]] size_t size_in_bytes() const { return size_in_bytes(m_pitch, physical_height()); }
|
|
|
|
template<StorageFormat>
|
|
[[nodiscard]] Color get_pixel(int physical_x, int physical_y) const;
|
|
[[nodiscard]] Color get_pixel(int physical_x, int physical_y) const;
|
|
[[nodiscard]] Color get_pixel(IntPoint physical_position) const
|
|
{
|
|
return get_pixel(physical_position.x(), physical_position.y());
|
|
}
|
|
|
|
template<StorageFormat>
|
|
void set_pixel(int physical_x, int physical_y, Color);
|
|
void set_pixel(int physical_x, int physical_y, Color);
|
|
void set_pixel(IntPoint physical_position, Color color)
|
|
{
|
|
set_pixel(physical_position.x(), physical_position.y(), color);
|
|
}
|
|
|
|
[[nodiscard]] Core::AnonymousBuffer& anonymous_buffer() { return m_buffer; }
|
|
[[nodiscard]] Core::AnonymousBuffer const& anonymous_buffer() const { return m_buffer; }
|
|
|
|
[[nodiscard]] bool visually_equals(Bitmap const&) const;
|
|
|
|
[[nodiscard]] Optional<Color> solid_color(u8 alpha_threshold = 0) const;
|
|
|
|
void flood_visit_from_point(Gfx::IntPoint start_point, int threshold, Function<void(Gfx::IntPoint location)> pixel_reached);
|
|
|
|
private:
|
|
Bitmap(BitmapFormat, IntSize, int, BackingStore const&);
|
|
Bitmap(BitmapFormat, IntSize, int, size_t pitch, void*);
|
|
Bitmap(BitmapFormat, Core::AnonymousBuffer, IntSize, int);
|
|
|
|
static ErrorOr<BackingStore> allocate_backing_store(BitmapFormat format, IntSize size, int scale_factor);
|
|
|
|
IntSize m_size;
|
|
int m_scale;
|
|
void* m_data { nullptr };
|
|
size_t m_pitch { 0 };
|
|
BitmapFormat m_format { BitmapFormat::Invalid };
|
|
bool m_data_is_malloced { false };
|
|
Core::AnonymousBuffer m_buffer;
|
|
};
|
|
|
|
ALWAYS_INLINE u8* Bitmap::scanline_u8(int y)
|
|
{
|
|
VERIFY(y >= 0);
|
|
VERIFY(y < physical_height());
|
|
return reinterpret_cast<u8*>(m_data) + (y * m_pitch);
|
|
}
|
|
|
|
ALWAYS_INLINE u8 const* Bitmap::scanline_u8(int y) const
|
|
{
|
|
VERIFY(y >= 0);
|
|
VERIFY(y < physical_height());
|
|
return reinterpret_cast<u8 const*>(m_data) + (y * m_pitch);
|
|
}
|
|
|
|
ALWAYS_INLINE ARGB32* Bitmap::scanline(int y)
|
|
{
|
|
return reinterpret_cast<ARGB32*>(scanline_u8(y));
|
|
}
|
|
|
|
ALWAYS_INLINE ARGB32 const* Bitmap::scanline(int y) const
|
|
{
|
|
return reinterpret_cast<ARGB32 const*>(scanline_u8(y));
|
|
}
|
|
|
|
ALWAYS_INLINE ARGB32* Bitmap::begin()
|
|
{
|
|
return scanline(0);
|
|
}
|
|
|
|
ALWAYS_INLINE ARGB32* Bitmap::end()
|
|
{
|
|
return reinterpret_cast<ARGB32*>(reinterpret_cast<u8*>(m_data) + data_size());
|
|
}
|
|
|
|
ALWAYS_INLINE size_t Bitmap::data_size() const
|
|
{
|
|
return m_size.height() * m_pitch;
|
|
}
|
|
|
|
template<>
|
|
ALWAYS_INLINE Color Bitmap::get_pixel<StorageFormat::BGRx8888>(int x, int y) const
|
|
{
|
|
VERIFY(x >= 0);
|
|
VERIFY(x < physical_width());
|
|
return Color::from_rgb(scanline(y)[x]);
|
|
}
|
|
|
|
template<>
|
|
ALWAYS_INLINE Color Bitmap::get_pixel<StorageFormat::BGRA8888>(int x, int y) const
|
|
{
|
|
VERIFY(x >= 0);
|
|
VERIFY(x < physical_width());
|
|
return Color::from_argb(scanline(y)[x]);
|
|
}
|
|
|
|
ALWAYS_INLINE Color Bitmap::get_pixel(int x, int y) const
|
|
{
|
|
switch (determine_storage_format(m_format)) {
|
|
case StorageFormat::BGRx8888:
|
|
return get_pixel<StorageFormat::BGRx8888>(x, y);
|
|
case StorageFormat::BGRA8888:
|
|
return get_pixel<StorageFormat::BGRA8888>(x, y);
|
|
default:
|
|
VERIFY_NOT_REACHED();
|
|
}
|
|
}
|
|
|
|
template<>
|
|
ALWAYS_INLINE void Bitmap::set_pixel<StorageFormat::BGRx8888>(int x, int y, Color color)
|
|
{
|
|
VERIFY(x >= 0);
|
|
VERIFY(x < physical_width());
|
|
scanline(y)[x] = color.value();
|
|
}
|
|
|
|
template<>
|
|
ALWAYS_INLINE void Bitmap::set_pixel<StorageFormat::BGRA8888>(int x, int y, Color color)
|
|
{
|
|
VERIFY(x >= 0);
|
|
VERIFY(x < physical_width());
|
|
scanline(y)[x] = color.value(); // drop alpha
|
|
}
|
|
|
|
template<>
|
|
ALWAYS_INLINE void Bitmap::set_pixel<StorageFormat::RGBA8888>(int x, int y, Color color)
|
|
{
|
|
VERIFY(x >= 0);
|
|
VERIFY(x < physical_width());
|
|
// FIXME: There's a lot of inaccurately named functions in the Color class right now (RGBA vs BGRA),
|
|
// clear those up and then make this more convenient.
|
|
auto rgba = (color.alpha() << 24) | (color.blue() << 16) | (color.green() << 8) | color.red();
|
|
scanline(y)[x] = rgba;
|
|
}
|
|
|
|
ALWAYS_INLINE void Bitmap::set_pixel(int x, int y, Color color)
|
|
{
|
|
switch (determine_storage_format(m_format)) {
|
|
case StorageFormat::BGRx8888:
|
|
set_pixel<StorageFormat::BGRx8888>(x, y, color);
|
|
break;
|
|
case StorageFormat::BGRA8888:
|
|
set_pixel<StorageFormat::BGRA8888>(x, y, color);
|
|
break;
|
|
case StorageFormat::RGBA8888:
|
|
set_pixel<StorageFormat::RGBA8888>(x, y, color);
|
|
break;
|
|
default:
|
|
VERIFY_NOT_REACHED();
|
|
}
|
|
}
|
|
|
|
}
|