ChamplainTile

ChamplainTile — An object that represent map tiles

Properties

ClutterActor * content Read / Write
gchar * etag Read / Write
gboolean fade-in Read / Write
guint size Read / Write
ChamplainState state Read / Write
guint x Read / Write
guint y Read / Write
guint zoom-level Read / Write

Signals

Types and Values

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── ClutterActor
            ╰── ChamplainTile

Implemented Interfaces

ChamplainTile implements ClutterContainer, ClutterScriptable, ClutterAnimatable, AtkImplementorIface and ChamplainExportable.

Description

This object represents map tiles. Tiles are loaded by ChamplainMapSource.

Functions

champlain_tile_new ()

ChamplainTile *
champlain_tile_new (void);

Creates an instance of ChamplainTile.

Returns

a new ChamplainTile

Since: 0.4


champlain_tile_new_full ()

ChamplainTile *
champlain_tile_new_full (guint x,
                         guint y,
                         guint size,
                         guint zoom_level);

Creates an instance of ChamplainTile.

Parameters

x

the x position

 

y

the y position

 

size

the size in pixels

 

zoom_level

the zoom level

 

Returns

a ChamplainTile

Since: 0.4


champlain_tile_get_x ()

guint
champlain_tile_get_x (ChamplainTile *self);

Gets the tile's x position.

Parameters

self

the ChamplainTile

 

Returns

the tile's x position

Since: 0.4


champlain_tile_get_y ()

guint
champlain_tile_get_y (ChamplainTile *self);

Gets the tile's y position.

Parameters

self

the ChamplainTile

 

Returns

the tile's y position

Since: 0.4


champlain_tile_get_zoom_level ()

guint
champlain_tile_get_zoom_level (ChamplainTile *self);

Gets the tile's zoom level.

Parameters

self

the ChamplainTile

 

Returns

the tile's zoom level

Since: 0.4


champlain_tile_get_size ()

guint
champlain_tile_get_size (ChamplainTile *self);

Gets the tile's size.

Parameters

self

the ChamplainTile

 

Returns

the tile's size in pixels

Since: 0.4


champlain_tile_get_state ()

ChamplainState
champlain_tile_get_state (ChamplainTile *self);

Gets the current state of tile loading.

Parameters

self

the ChamplainTile

 

Returns

the tile's ChamplainState

Since: 0.4


champlain_tile_get_fade_in ()

gboolean
champlain_tile_get_fade_in (ChamplainTile *self);

Checks whether the tile should fade in.

Parameters

self

the ChamplainTile

 

Returns

the return value determines whether the tile should fade in when loading.

Since: 0.6


champlain_tile_set_x ()

void
champlain_tile_set_x (ChamplainTile *self,
                      guint x);

Sets the tile's x position

Parameters

self

the ChamplainTile

 

x

the position

 

Since: 0.4


champlain_tile_set_y ()

void
champlain_tile_set_y (ChamplainTile *self,
                      guint y);

Sets the tile's y position

Parameters

self

the ChamplainTile

 

y

the position

 

Since: 0.4


champlain_tile_set_zoom_level ()

void
champlain_tile_set_zoom_level (ChamplainTile *self,
                               guint zoom_level);

Sets the tile's zoom level

Parameters

self

the ChamplainTile

 

zoom_level

the zoom level

 

Since: 0.4


champlain_tile_set_size ()

void
champlain_tile_set_size (ChamplainTile *self,
                         guint size);

Sets the tile's size

Parameters

self

the ChamplainTile

 

size

the size in pixels

 

Since: 0.4


champlain_tile_set_state ()

void
champlain_tile_set_state (ChamplainTile *self,
                          ChamplainState state);

Sets the tile's ChamplainState

Parameters

self

the ChamplainTile

 

state

a ChamplainState

 

Since: 0.4


champlain_tile_set_fade_in ()

void
champlain_tile_set_fade_in (ChamplainTile *self,
                            gboolean fade_in);

Sets the flag determining whether the tile should fade in when loading

Parameters

self

the ChamplainTile

 

fade_in

determines whether the tile should fade in when loading

 

Since: 0.6


champlain_tile_get_content ()

ClutterActor *
champlain_tile_get_content (ChamplainTile *self);

Gets the tile's content actor.

Parameters

self

the ChamplainTile

 

Returns

the tile's content, this actor will change each time the tile's content changes. You should not unref this content, it is owned by the tile.

[transfer none]

Since: 0.4


champlain_tile_get_etag ()

const gchar *
champlain_tile_get_etag (ChamplainTile *self);

Gets the tile's ETag.

Parameters

self

the ChamplainTile

 

Returns

the tile's ETag

Since: 0.4


champlain_tile_get_modified_time ()

const GTimeVal *
champlain_tile_get_modified_time (ChamplainTile *self);

Gets the tile's last modified time.

Parameters

self

the ChamplainTile

 

Returns

the tile's last modified time

Since: 0.4


champlain_tile_set_content ()

void
champlain_tile_set_content (ChamplainTile *self,
                            ClutterActor *actor);

Sets the tile's content. To also disppay the tile, you have to call champlain_tile_display_content() in addition.

Parameters

self

the ChamplainTile

 

actor

the new content

 

Since: 0.4


champlain_tile_set_etag ()

void
champlain_tile_set_etag (ChamplainTile *self,
                         const gchar *etag);

Sets the tile's ETag

Parameters

self

the ChamplainTile

 

etag

the tile's ETag as sent by the server

 

Since: 0.4


champlain_tile_set_modified_time ()

void
champlain_tile_set_modified_time (ChamplainTile *self,
                                  const GTimeVal *time);

Sets the tile's modified time

Parameters

self

the ChamplainTile

 

time

a GTimeVal, the value will be copied

 

Since: 0.4


champlain_tile_display_content ()

void
champlain_tile_display_content (ChamplainTile *self);

Displays the tile's content.

Parameters

self

the ChamplainTile

 

Since: 0.8

Types and Values

enum ChamplainState

Tile loading state.

Members

CHAMPLAIN_STATE_NONE

Initial or undefined state

 

CHAMPLAIN_STATE_LOADING

Tile is loading

 

CHAMPLAIN_STATE_LOADED

Tile is loaded but not yet displayed

 

CHAMPLAIN_STATE_DONE

Tile loading finished. Also used to inform map sources that tile loading has been cancelled.

 

struct ChamplainTile

struct ChamplainTile;

The ChamplainTile structure contains only private data and should be accessed using the provided API

Since: 0.4

Property Details

The “content” property

  “content”                  ClutterActor *

The ClutterActor with the specific image content. When changing this property, the new actor will be faded in.

Flags: Read / Write

Since: 0.4


The “etag” property

  “etag”                     gchar *

The tile's ETag. This information is sent by some web servers as a mean to identify if a tile has changed. This information is saved in the cache and sent in GET queries.

Flags: Read / Write

Default value: NULL

Since: 0.4


The “fade-in” property

  “fade-in”                  gboolean

Specifies whether the tile should fade in when loading

Flags: Read / Write

Default value: FALSE

Since: 0.6


The “size” property

  “size”                     guint

The size of the tile in pixels

Flags: Read / Write

Allowed values: <= G_MAXINT

Default value: 256

Since: 0.4


The “state” property

  “state”                    ChamplainState

The state of the tile

Flags: Read / Write

Default value: CHAMPLAIN_STATE_NONE

Since: 0.4


The “x” property

  “x”                        guint

The x position of the tile

Flags: Read / Write

Allowed values: <= G_MAXINT

Default value: 0

Since: 0.4


The “y” property

  “y”                        guint

The y position of the tile

Flags: Read / Write

Allowed values: <= G_MAXINT

Default value: 0

Since: 0.4


The “zoom-level” property

  “zoom-level”               guint

The zoom level of the tile

Flags: Read / Write

Allowed values: <= G_MAXINT

Default value: 0

Since: 0.4

Signal Details

The “render-complete” signal

void
user_function (ChamplainTile *self,
               gpointer       data,
               guint          size,
               gboolean       error,
               gpointer       user_data)

The “render-complete” signal is emitted when rendering of the tile is completed by the renderer.

Parameters

self

a ChamplainTile

 

data

the result of the rendering

 

size

size of data

 

error

TRUE if there was an error during rendering

 

user_data

user data set when the signal handler was connected.

 

Flags: Run Last

Since: 0.10