netsurf/frontends/amiga/bitmap.h

193 lines
5.2 KiB
C
Raw Normal View History

/*
* Copyright 2008,2009 Chris Young <chris@unsatisfactorysoftware.co.uk>
*
* 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/>.
*/
#ifndef AMIGA_BITMAP_H
#define AMIGA_BITMAP_H
2015-09-05 01:59:22 +03:00
#include <stdbool.h>
#include <exec/types.h>
#include <proto/graphics.h>
#include <intuition/classusr.h>
#include <libraries/Picasso96.h>
#define AMI_BITMAP_FORMAT RGBFB_R8G8B8A8
#define AMI_BITMAP_SCALE_ICON 0xFF
extern struct gui_bitmap_table *amiga_bitmap_table;
2016-03-22 22:26:36 +03:00
struct bitmap;
struct nsurl;
struct gui_globals;
struct BitMap *ami_bitmap_get_native(struct bitmap *bitmap,
int width, int height, bool palette_mapped, struct BitMap *friendbm);
2012-08-11 20:19:54 +04:00
PLANEPTR ami_bitmap_get_mask(struct bitmap *bitmap, int width,
int height, struct BitMap *n_bm);
Object *ami_datatype_object_from_bitmap(struct bitmap *bitmap);
struct bitmap *ami_bitmap_from_datatype(char *filename);
2013-03-09 19:29:30 +04:00
2016-03-22 22:39:33 +03:00
/**
* Set bitmap URL
*
2016-09-13 11:16:31 +03:00
* \param bm a bitmap, as returned by bitmap_create()
* \param url the url for the bitmap
2016-03-22 22:39:33 +03:00
*
* A reference will be kept by the bitmap object.
* The URL can only ever be set once for a bitmap.
2016-03-22 22:39:33 +03:00
*/
2016-03-22 22:26:36 +03:00
void ami_bitmap_set_url(struct bitmap *bm, struct nsurl *url);
2016-03-22 22:39:33 +03:00
/**
* Set bitmap title
*
* \param bm a bitmap, as returned by bitmap_create()
* \param title a pointer to a title string
*
* This is copied by the bitmap object.
* The title can only ever be set once for a bitmap.
2016-03-22 22:39:33 +03:00
*/
2016-03-22 22:26:36 +03:00
void ami_bitmap_set_title(struct bitmap *bm, const char *title);
2016-03-22 22:39:33 +03:00
/**
* Set an icondata pointer
2016-03-22 22:39:33 +03:00
*
* \param bm a bitmap, as returned by bitmap_create()
* \param icondata a pointer to memory
2016-03-22 22:39:33 +03:00
*
* This function probably shouldn't be here!
*/
void ami_bitmap_set_icondata(struct bitmap *bm, ULONG *icondata);
2016-03-22 22:39:33 +03:00
/**
* Free an icondata pointer
2016-03-22 22:39:33 +03:00
*
* \param bm a bitmap, as returned by bitmap_create()
2016-03-22 22:39:33 +03:00
*
* This function probably shouldn't be here!
*/
void ami_bitmap_free_icondata(struct bitmap *bm);
2016-03-22 22:39:33 +03:00
/**
* Test if a BitMap is owned by a bitmap.
*
* \param bm a bitmap, as returned by bitmap_create()
* \param nbm a BitMap, as created by AllocBitMap()
* \return true if the BitMap is owned by the bitmap
*/
bool ami_bitmap_is_nativebm(struct bitmap *bm, struct BitMap *nbm);
2016-03-22 22:26:36 +03:00
/**
* Cleanup bitmap allocations
*/
void ami_bitmap_fini(void);
/**
* Create a bitmap.
*
* \param width width of image in pixels
* \param height width of image in pixels
* \param state a flag word indicating the initial state
* \return an opaque struct bitmap, or NULL on memory exhaustion
*/
void *amiga_bitmap_create(int width, int height, unsigned int state);
/**
* Return a pointer to the pixel data in a bitmap.
*
* \param bitmap a bitmap, as returned by bitmap_create()
* \return pointer to the pixel buffer
*
* The pixel data is packed as BITMAP_FORMAT, possibly with padding at the end
* of rows. The width of a row in bytes is given by bitmap_get_rowstride().
*/
unsigned char *amiga_bitmap_get_buffer(void *bitmap);
/**
* Find the width of a pixel row in bytes.
*
* \param bitmap a bitmap, as returned by bitmap_create()
* \return width of a pixel row in the bitmap
*/
size_t amiga_bitmap_get_rowstride(void *bitmap);
2016-03-22 22:39:33 +03:00
/**
* Return the width of a bitmap.
*
* \param bitmap a bitmap, as returned by bitmap_create()
* \return width in pixels
*/
int bitmap_get_width(void *bitmap);
/**
* Return the height of a bitmap.
*
* \param bitmap a bitmap, as returned by bitmap_create()
* \return height in pixels
*/
int bitmap_get_height(void *bitmap);
/**
* Free a bitmap.
*
* \param bitmap a bitmap, as returned by bitmap_create()
*/
void amiga_bitmap_destroy(void *bitmap);
/**
* Save a bitmap in the platform's native format.
*
* \param bitmap a bitmap, as returned by bitmap_create()
* \param path pathname for file
* \param flags flags controlling how the bitmap is saved.
* \return true on success, false on error and error reported
*/
bool amiga_bitmap_save(void *bitmap, const char *path, unsigned flags);
/**
* The bitmap image has changed, so flush any persistant cache.
*
* \param bitmap a bitmap, as returned by bitmap_create()
*/
void amiga_bitmap_modified(void *bitmap);
/**
* Sets whether a bitmap should be plotted opaque
*
* \param bitmap a bitmap, as returned by bitmap_create()
* \param opaque whether the bitmap should be plotted opaque
*/
void amiga_bitmap_set_opaque(void *bitmap, bool opaque);
/**
* Tests whether a bitmap has an opaque alpha channel
*
* \param bitmap a bitmap, as returned by bitmap_create()
* \return whether the bitmap is opaque
*/
bool amiga_bitmap_test_opaque(void *bitmap);
/**
* Gets whether a bitmap should be plotted opaque
*
* \param bitmap a bitmap, as returned by bitmap_create()
*/
bool amiga_bitmap_get_opaque(void *bitmap);
#endif