mirror of
https://github.com/netsurf-browser/netsurf
synced 2024-12-17 01:33:16 +03:00
f37e52c394
The generic bitmap handlers provided by each frontend are called back from the core and therefore should be in an operation table. This was one of the very few remaining interfaces stopping the core code from being split into a library.
125 lines
2.8 KiB
C
125 lines
2.8 KiB
C
/*
|
|
* Copyright 2004 James Bursa <bursa@users.sourceforge.net>
|
|
*
|
|
* This file is part of NetSurf, http://www.netsurf-browser.org/
|
|
*
|
|
* NetSurf is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; version 2 of the License.
|
|
*
|
|
* NetSurf is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
/** \file
|
|
* Generic bitmap handling (interface).
|
|
*
|
|
* This interface wraps the native platform-specific image format, so that
|
|
* portable image convertors can be written.
|
|
*
|
|
* Bitmaps are required to be 32bpp with components in the order RR GG BB AA.
|
|
*
|
|
* For example, an opaque 1x1 pixel image would yield the following bitmap
|
|
* data:
|
|
*
|
|
* Red : 0xff 0x00 0x00 0x00
|
|
* Green: 0x00 0xff 0x00 0x00
|
|
* Blue : 0x00 0x00 0xff 0x00
|
|
*
|
|
* Any attempt to read pixels by casting bitmap data to uint32_t or similar
|
|
* will need to cater for the order of bytes in a word being different on
|
|
* big and little endian systems. To avoid confusion, it is recommended
|
|
* that pixel data is loaded as follows:
|
|
*
|
|
* uint32_t read_pixel(const uint8_t *bmp)
|
|
* {
|
|
* // red green blue alpha
|
|
* return bmp[0] | (bmp[1] << 8) | (bmp[2] << 16) | (bmp[3] << 24);
|
|
* }
|
|
*
|
|
* and *not* as follows:
|
|
*
|
|
* uint32_t read_pixel(const uint8_t *bmp)
|
|
* {
|
|
* return *((uint32_t *) bmp);
|
|
* }
|
|
*/
|
|
|
|
#ifndef _NETSURF_IMAGE_BITMAP_H_
|
|
#define _NETSURF_IMAGE_BITMAP_H_
|
|
|
|
#define BITMAP_NEW 0
|
|
#define BITMAP_OPAQUE (1 << 0) /** image is opaque */
|
|
#define BITMAP_MODIFIED (1 << 1) /** buffer has been modified */
|
|
#define BITMAP_CLEAR_MEMORY (1 << 2) /** memory should be wiped */
|
|
|
|
struct content;
|
|
struct bitmap;
|
|
|
|
/**
|
|
* Bitmap operations.
|
|
*/
|
|
struct gui_bitmap_table {
|
|
/* Mandantory entries */
|
|
|
|
/**
|
|
* Create a new bitmap
|
|
*/
|
|
void *(*create)(int width, int height, unsigned int state);
|
|
|
|
/**
|
|
* Destroy a bitmap
|
|
*/
|
|
void (*destroy)(void *bitmap);
|
|
|
|
/**
|
|
* Set the opacity of a bitmap
|
|
*/
|
|
void (*set_opaque)(void *bitmap, bool opaque);
|
|
|
|
/**
|
|
* Get the opacity of a bitmap
|
|
*/
|
|
bool (*get_opaque)(void *bitmap);
|
|
|
|
/**
|
|
*/
|
|
bool (*test_opaque)(void *bitmap);
|
|
|
|
/**
|
|
*/
|
|
unsigned char *(*get_buffer)(void *bitmap);
|
|
|
|
/**
|
|
*/
|
|
size_t (*get_rowstride)(void *bitmap);
|
|
|
|
/**
|
|
*/
|
|
int (*get_width)(void *bitmap);
|
|
|
|
/**
|
|
*/
|
|
int (*get_height)(void *bitmap);
|
|
|
|
/**
|
|
*/
|
|
size_t (*get_bpp)(void *bitmap);
|
|
|
|
/**
|
|
*/
|
|
bool (*save)(void *bitmap, const char *path, unsigned flags);
|
|
|
|
/**
|
|
* Marks a bitmap as modified.
|
|
*/
|
|
void (*modified)(void *bitmap);
|
|
};
|
|
|
|
#endif
|