NAME

Gtk2::Hexgrid::Tile - a hexagonal tile from a Hexgrid

SYNOPSIS

 my @tiles = $hexgrid->get_all_tiles;
 my $tile = $hexgrid->get_tile(3,5);
 my $column = $tile->col;
 my ($col, $row) = $tile->colrow;
 my ($r, $g, $b) = $tile->rgb;
 $tile->set_color(.1, .65, .35);
 $tile->set_text('Clowndog', 13);
 $tile->destroy_text;
 $tile2 = $tile->southwest;

DESCRIPTION

CONSTRUCTOR

new

 my $tile = new Gtk2::Hexgrid::Tile ($hexgrid, $col, $row, $r, $g, $b)

There's probably no reason to learn the constructor: Tiles are automatically generated with your hexgrid. $hexgrid, $col, $row are there so it knows. $r, $g, $b are it's default color, and it may be changed later.

METHODS

accessors

rgb

col

row

colrow

hexgrid

background

sprites

get_adjacent

See Gtk2::Hexgrid::get_adjacent_tiles

get_center

See Gtk2::Hexgrid::get_tile_center

relative locating

Methods are provided to find whatever tile is adjacent in a specific direction. These return the adjacent tile if it exists, else undef.

 $tile->north
 $tile->n
 $tile->northeast
 $tile->ne
 etc...

north

n

northeast

ne

southeast

se

south

s

southwest

sw

northwest

nw

next_by_direction

set_background

 $tile->set_background("data/onion.png");

Loads a png file, scales it to tile size, and has $tile draw it first whenever it needs drawn.

Backgrounds are cached, so dont worry about loading the same file more than once Backgrounds are given a low (-21.21) priority so that they are drawn first.

Not redrawn automatically.

set_color

 $tile->set_color($r, $g, $b);

Cairo colors (range is 0 to 1). Not redrawn automatically

set_text

 my $size = 14
 $tile->set_text('uoewriu', $size) = @_;

Text is given a priority of 21.21. If you want to paint over it, give something a higher prioriry. Not redrawn automatically.

add_sprite

 $tile->add_sprite($sprite);

Attaches $sprite to $tile.

remove_sprite

 $tile->remove_sprite($sprite);

Removes $sprite from $tile.

has_sprite

 $tile->has_sprite($sprite);

Returns true if $sprite is attached to $tile, else false.

destroy_background

 $tile->destroy_background;

Removes background sprites from tile. Actually, it believes that all sprites with a -21.21 priority are background.

destroy_text

 $tile->destroy_text;

Removes all text sprites from tile. Actually, it believes that all sprites with a 21.21 priority are text sprites.

draw

 $tile->draw();
 $tile->draw($r, $g, $b);

Draws tile using tile's color unless another color is given. Associated with $hexgrid->draw_tile and $hexgrid->draw_tile_ref.

cpanm Gtk2::Hexgrid

perl -MCPAN -e shell
install Gtk2::Hexgrid