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: @MAPE_MAPGEN_ERROR_COMPILE: An error occured while compiling the Landscape.txt source code. @MAPE_GROUP_ERROR_MEMORY: 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: @MAPE_MAPGEN_NONE: Does not represent a map description. @MAPE_MAPGEN_LANDSCAPE_TXT: Represents a Landscape.txt script. @MAPE_MAPGEN_MAP_C: Represents a Map.c script.

Specifies the different types of maps that can be rendered.

Enumeration Type Documentation

_MapeMapgenError

enum _MapeMapgenError

MapeMapgenError: @MAPE_MAPGEN_ERROR_COMPILE: An error occured while compiling the Landscape.txt source code. @MAPE_GROUP_ERROR_MEMORY: 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: @MAPE_MAPGEN_NONE: Does not represent a map description. @MAPE_MAPGEN_LANDSCAPE_TXT: Represents a Landscape.txt script. @MAPE_MAPGEN_MAP_C: 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.

{
  c4_mapgen_handle_deinit_script_engine();
}

References 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: @error: 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.

{
  c4_mapgen_handle_init_script_engine();
  return TRUE;
}

References c4_mapgen_handle_init_script_engine().

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:

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

Renders the map described by @source 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 @script_path is NULL, an error is generated. Otherwise, the file at @script_path 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, @error 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.

{
  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;
}

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(), MAPE_MAPGEN_LANDSCAPE_TXT, and MAPE_MAPGEN_MAP_C.

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: @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.

{
  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);
  }
}

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

Here is the call graph for this function: