mirror of
https://gitlab.gnome.org/GNOME/gimp
synced 2024-10-20 19:43:01 +00:00
928dd48af7
Sun May 9 16:23:47 BST 1999 Adam D. Moss <adam@gimp.org> * app/tile.c * app/tile.h * app/tile_manager.c * app/tile_pvt.h * app/paint_funcs.c: Added Tile Row Hinting to the GIMP tile structure. Tiles now have cheap per-row hints indicating whether each row is all-transparent, all-opaque, a mixture, or other properties. These hints are automatically invalidated when the tile is checked in as dirty, and are re-evaluated on demand. Currently only the layer compositing routines take advantage of these hints, though there is opportunity to use them to advantage in numerous other places. The whole layer compositing process is typically 2x-4x faster now, especially on subsequent renders of data which has already had its hints calculated. See tile.h for the explicit TileRowHint query/set interface. The procedure to re-evaluate tile hints currently resides in paint_funcs.c but may be exposed to other parts of the core if necessary. This is experimental. Please report mis-rendering problems.
86 lines
2 KiB
C
86 lines
2 KiB
C
#ifndef __TILE_H__
|
|
#define __TILE_H__
|
|
|
|
|
|
#define TILE_WIDTH 64
|
|
#define TILE_HEIGHT 64
|
|
|
|
/* Uncomment for verbose debugging on copy-on-write logic
|
|
#define TILE_DEBUG
|
|
*/
|
|
|
|
/* sanity checking on new tile hinting code */
|
|
/* #define HINTS_SANITY */
|
|
|
|
#include <sys/types.h>
|
|
#include <glib.h>
|
|
|
|
#include "config.h"
|
|
|
|
typedef struct _Tile Tile;
|
|
|
|
typedef enum
|
|
{
|
|
TILEROWHINT_BROKEN = 0,
|
|
TILEROWHINT_OPAQUE,
|
|
TILEROWHINT_TRANSPARENT,
|
|
TILEROWHINT_MIXED,
|
|
TILEROWHINT_OUTOFRANGE,
|
|
TILEROWHINT_UNDEFINED,
|
|
TILEROWHINT_UNKNOWN
|
|
} TileRowHint;
|
|
|
|
|
|
/* Initializes the fields of a tile to "good" values.
|
|
*/
|
|
void tile_init (Tile *tile,
|
|
int bpp);
|
|
|
|
|
|
/*
|
|
* tile_lock locks a tile into memory. This does what tile_ref used
|
|
* to do. It is the responsibility of the tile manager to take care
|
|
* of the copy-on-write semantics. Locks stack; a tile remains locked
|
|
* in memory as long as it's been locked more times than it has been
|
|
* released. tile_release needs to know whether the release was for
|
|
* write access. (This is a hack, and should be handled better.)
|
|
*/
|
|
|
|
void tile_lock (Tile *);
|
|
void tile_release (Tile *, int);
|
|
|
|
/* Allocate the data for the tile.
|
|
*/
|
|
void tile_alloc (Tile *tile);
|
|
|
|
/* Return the size in bytes of the tiles data.
|
|
*/
|
|
int tile_size (Tile *tile);
|
|
|
|
int tile_ewidth (Tile *tile);
|
|
int tile_eheight (Tile *tile);
|
|
int tile_bpp (Tile *tile);
|
|
|
|
int tile_is_valid (Tile *tile);
|
|
|
|
void tile_mark_valid (Tile *tile);
|
|
|
|
/* DOCUMENT ME -- adm */
|
|
TileRowHint tile_get_rowhint (Tile *tile, int yoff);
|
|
void tile_set_rowhint (Tile *tile, int yoff, TileRowHint rowhint);
|
|
|
|
void *tile_data_pointer (Tile *tile, int xoff, int yoff);
|
|
|
|
/* tile_attach attaches a tile to a tile manager: this function
|
|
* increments the tile's share count and inserts a tilelink into the
|
|
* tile's link list. tile_detach reverses the process.
|
|
* If a tile's share count is zero after a tile_detach, the tile is
|
|
* discarded.
|
|
*/
|
|
|
|
void tile_attach (Tile *tile, void *tm, int tile_num);
|
|
void tile_detach (Tile *tile, void *tm, int tile_num);
|
|
|
|
|
|
#endif /* __TILE_H__ */
|