mapgen.h File Reference

#include <glib.h>
#include <gdk-pixbuf/gdk-pixbuf.h>
#include "mape/material.h"
#include "mape/texture.h"

Include dependency graph for mapgen.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Typedefs
typedef G_BEGIN_DECLS enum _MapeMapgenError	MapeMapgenError
typedef enum _MapeMapgenType	MapeMapgenType

Enumerations
enum	_MapeMapgenError { MAPE_MAPGEN_ERROR_COMPILE, MAPE_MAPGEN_ERROR_MEMORY }
enum	_MapeMapgenType { MAPE_MAPGEN_NONE, MAPE_MAPGEN_LANDSCAPE_TXT, MAPE_MAPGEN_MAP_C }

Functions
gboolean	mape_mapgen_init (GError **error)
void	mape_mapgen_deinit ()
void	mape_mapgen_set_root_group (MapeGroup *group)
GdkPixbuf *	mape_mapgen_render (const gchar *filename, const gchar *source, MapeMapgenType type, const gchar *script_path, MapeMaterialMap *material_map, MapeTextureMap *texture_map, guint width, guint height, GError **error)

Typedef Documentation

MapeMapgenError

typedef G_BEGIN_DECLS enum _MapeMapgenError MapeMapgenError

MapeMapgenError: : An error occured while compiling the Landscape.txt source code. : Insufficient memory was available to render the map.

These errors are from the MAPE_MAPGEN_ERROR error domain. They can occur when rendering a map from a Landscape.txt file.

MapeMapgenType

typedef enum _MapeMapgenType MapeMapgenType

MapeMapgenType: : Does not represent a map description. : Represents a Landscape.txt script. : Represents a Map.c script.

Specifies the different types of maps that can be rendered.

Enumeration Type Documentation

_MapeMapgenError

enum _MapeMapgenError

MapeMapgenError: : An error occured while compiling the Landscape.txt source code. : Insufficient memory was available to render the map.

These errors are from the MAPE_MAPGEN_ERROR error domain. They can occur when rendering a map from a Landscape.txt file.

Enumerator
MAPE_MAPGEN_ERROR_COMPILE
MAPE_MAPGEN_ERROR_MEMORY

Definition at line 37 of file mapgen.h.

                              {
  MAPE_MAPGEN_ERROR_COMPILE,
  MAPE_MAPGEN_ERROR_MEMORY
} MapeMapgenError;

_MapeMapgenType

enum _MapeMapgenType

MapeMapgenType: : Does not represent a map description. : Represents a Landscape.txt script. : Represents a Map.c script.

Specifies the different types of maps that can be rendered.

Enumerator
MAPE_MAPGEN_NONE
MAPE_MAPGEN_LANDSCAPE_TXT
MAPE_MAPGEN_MAP_C

Definition at line 50 of file mapgen.h.

                             {
  MAPE_MAPGEN_NONE,
  MAPE_MAPGEN_LANDSCAPE_TXT,
  MAPE_MAPGEN_MAP_C
} MapeMapgenType;

Function Documentation

mape_mapgen_deinit()

void mape_mapgen_deinit

(

)

mape_mapgen_deinit():

Deinitializes the map generator.

Definition at line 156 of file mapgen.c.

References c4_mapgen_handle_deinit_script_engine().

{
  c4_mapgen_handle_deinit_script_engine();
}

Here is the call graph for this function:

mape_mapgen_init()

gboolean mape_mapgen_init

(

GError **

error

)

mape_mapgen_init: : Location to store error information, if any.

Initializes the map generator.

Returns: TRUE on success or FALSE on error.

Definition at line 144 of file mapgen.c.

References c4_mapgen_handle_init_script_engine().

{
  c4_mapgen_handle_init_script_engine();
  return TRUE;
}

Here is the call graph for this function:

mape_mapgen_render()

GdkPixbuf* mape_mapgen_render	(	const gchar *	filename,
		const gchar *	source,
		MapeMapgenType	type,
		const gchar *	script_path,
		MapeMaterialMap *	material_map,
		MapeTextureMap *	texture_map,
		guint	width,
		guint	height,
		GError **	error
	)

mape_mapgen_render:

: The filename of the file that is being parsed. This is only used for display purposes. : The map generator source code for the map to generate. : Specifies how the text in should be interpreted. Must not be MAPE_MAPGEN_NONE. : Path to the script source for algo=script overlays, or NULL. : The material map containing the materials to be used during map generation. : The texture map containing the textures to be used during map generation. : The width of the map to generate. : The height of the map to generate. : Location to store error information, if any, or NULL.

Renders the map described by with the C4MapCreatorS2 into a pixbuf. The pixel color depends on the texture at the corresponding position and is determined by the average color of that texture.

If the source contains one or more algo=script overlays and is NULL, an error is generated. Otherwise, the file at is opened and used to look up the relevant script functions.

In case an error occurs, for example when the map generator source code is not valid, is set and the function returns NULL.

Return Value: A #GdkPixbuf with the generated map, or NULL. Free with g_object_unref().

Definition at line 227 of file mapgen.c.

References _mape_material_map_get_handle(), _mape_texture_map_get_handle(), c4_mapgen_handle_get_error(), c4_mapgen_handle_new(), c4_mapgen_handle_new_script(), _C4MapgenHandle::error_message, MAPE_MAPGEN_LANDSCAPE_TXT, and MAPE_MAPGEN_MAP_C.

{
  C4MapgenHandle* handle;
  const char* error_message;
  unsigned int out_width;
  unsigned int out_height;
  GdkPixbuf* pixbuf;
  guint8* out_p;
  const unsigned char* in_p;
  guint out_rowstride;
  unsigned int in_rowstride;
  guint datawidth;
  guint8 matclrs[256 * 4];
  unsigned int x, y;
  unsigned int matnum;

  switch(type)
  {
  case MAPE_MAPGEN_LANDSCAPE_TXT:
    handle = c4_mapgen_handle_new(
      filename,
      source,
      script_path,
      _mape_material_map_get_handle(material_map),
      _mape_texture_map_get_handle(texture_map),
      width,
      height
    );

    break;
  case MAPE_MAPGEN_MAP_C:
    handle = c4_mapgen_handle_new_script(
      filename,
      source,
      _mape_material_map_get_handle(material_map),
      _mape_texture_map_get_handle(texture_map),
      width,
      height
    );

    break;
  default:
    handle = NULL;
    g_assert_not_reached();
    break;
  }

  error_message = c4_mapgen_handle_get_error(handle);
  if(error_message)
  {
    g_set_error(
      error,
      mape_mapgen_error_quark(),
      MAPE_MAPGEN_ERROR_COMPILE,
      "%s",
      error_message
    );

    c4_mapgen_handle_free(handle);
    return NULL;
  }

  out_width = c4_mapgen_handle_get_width(handle);
  out_height = c4_mapgen_handle_get_height(handle);

  pixbuf = gdk_pixbuf_new(
    GDK_COLORSPACE_RGB,
    FALSE,
    8,
    out_width,
    out_height
  );

  if(pixbuf == NULL)
  {
    g_set_error(
      error,
      mape_mapgen_error_quark(),
      MAPE_MAPGEN_ERROR_MEMORY,
      "Insufficient memory is available"
    );

    c4_mapgen_handle_free(handle);
    return NULL;
  }

  out_p = gdk_pixbuf_get_pixels(pixbuf);
  in_p = c4_mapgen_handle_get_map(handle);
  out_rowstride = gdk_pixbuf_get_rowstride(pixbuf);
  in_rowstride = c4_mapgen_handle_get_rowstride(handle);
  datawidth = gdk_pixbuf_get_width(pixbuf) * 3;
  memset(matclrs, 0, sizeof(matclrs) );

  for(y = 0; y < out_height; ++y)
  {
    for(x = 0; x < out_width; ++x)
    {
      matnum = *in_p;

      if(matclrs[matnum * 4] == 0)
      {
        mape_mapgen_read_color(
          matclrs,
          material_map,
          texture_map,
          matnum
        );

        /* Color has been loaded */
        matclrs[matnum * 4] = 1;
      }

      out_p[0] = matclrs[matnum * 4 + 1];
      out_p[1] = matclrs[matnum * 4 + 2];
      out_p[2] = matclrs[matnum * 4 + 3];
      ++in_p;
      out_p += 3;
    }

    in_p += in_rowstride - out_width;
    out_p += out_rowstride - datawidth;
  }

  c4_mapgen_handle_free(handle);
  return pixbuf;
}

Here is the call graph for this function:

mape_mapgen_set_root_group()

void mape_mapgen_set_root_group

(

MapeGroup *

group

)

mape_mapgen_set_root_group: : The root group.

Sets the root group for the map generator. This group is used to lookup the Library_Map definition.

Definition at line 169 of file mapgen.c.

References _mape_group_get_handle(), c4_mapgen_handle_set_map_library(), and mape_group_open_child().

{
  MapeGroup* objects;
  MapeGroup* libraries;
  MapeGroup* map;
  GError* error;

  error = NULL;
  if(!error)
    objects = mape_group_open_child(group, "Objects.ocd", &error);
  if(!error)
    libraries = mape_group_open_child(objects, "Libraries.ocd", &error);
  if(!error)
    map = mape_group_open_child(libraries, "Map.ocd", &error);

  /* TODO: Error reporting? */
  if(error == NULL)
    c4_mapgen_handle_set_map_library(_mape_group_get_handle(map));

  if(error != NULL)
  {
    fprintf(stderr, "Failed to load Objects.ocd/Libraries.ocd/Map.ocd/Script.c: %s\n", error->message);
    g_error_free(error);
  }
}

Here is the call graph for this function: