gimptile: GIMP Library Reference Manual

+ + +

gimptile

gimptile — Functions for working with tiles.

Functions

++++ + + + + + + + + + + + + + + + + + + + + + + + + + + +

+void +	+gimp_tile_ref () +
+void +	+gimp_tile_ref_zero () +
+void +	+gimp_tile_unref () +
+void +	+gimp_tile_flush () +
+void +	+gimp_tile_cache_size () +
+void +	+gimp_tile_cache_ntiles () +

Types and Values

++++ + + + + +

GimpTile

Description

Functions for working with tiles.

Functions

gimp_tile_ref ()

void
+gimp_tile_ref (GimpTile *tile);

gimp_tile_ref is deprecated and should not be used in newly-written code.

gimp_tile_ref_zero ()

void
+gimp_tile_ref_zero (GimpTile *tile);

gimp_tile_ref_zero is deprecated and should not be used in newly-written code.

gimp_tile_unref ()

void
+gimp_tile_unref (GimpTile *tile,
+                 gboolean dirty);

gimp_tile_unref is deprecated and should not be used in newly-written code.

gimp_tile_flush ()

void
+gimp_tile_flush (GimpTile *tile);

gimp_tile_flush is deprecated and should not be used in newly-written code.

gimp_tile_cache_size ()

void
+gimp_tile_cache_size (gulong kilobytes);

gimp_tile_cache_size is deprecated and should not be used in newly-written code.

Sets the size of the tile cache on the plug-in side. The tile cache +is used to reduce the number of tiles exchanged between the GIMP core +and the plug-in. See also gimp_tile_cache_ntiles().

Parameters

+++++ + + + + + +

kilobytes

new cache size in kilobytes

gimp_tile_cache_ntiles ()

void
+gimp_tile_cache_ntiles (gulong ntiles);

gimp_tile_cache_ntiles is deprecated and should not be used in newly-written code.

Sets the size of the tile cache on the plug-in side. This function +is similar to gimp_tile_cache_size() but supports specifying the +number of tiles directly.

If your plug-in access pixels tile-by-tile, it doesn't need a tile +cache at all. If however the plug-in accesses drawable pixel data +row-by-row, it should set the tile cache large enough to hold the +number of tiles per row. Double this size if your plug-in uses +shadow tiles.

Parameters

+++++ + + + + + +

ntiles

number of tiles that should fit into the cache

Types and Values

GimpTile

typedef struct {
+  guint         ewidth;     /* the effective width of the tile */
+  guint         eheight;    /* the effective height of the tile */
+  guint         bpp;        /* the bytes per pixel (1, 2, 3 or 4 ) */
+  guint         tile_num;   /* the number of this tile within the drawable */
+  guint16       ref_count;  /* reference count for the tile */
+  guint         dirty : 1;  /* is the tile dirty? has it been modified? */
+  guint         shadow: 1;  /* is this a shadow tile */
+  guchar       *data;       /* the pixel data for the tile */
+  GimpDrawable *drawable;   /* the drawable this tile came from */
+} GimpTile;
+