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;