libtcodpy - Old API Functions¶
This is all the functions included since the start of the Python port. This collection is often called libtcodpy, the name of the original Python port. These functions are reproduced by python-tcod in their entirely.
A large majority of these functions are deprecated and will be removed in the future. In general this entire section should be avoided whenever possible. See Getting Started for how to make a new python-tcod project with its modern API.
bsp¶
-
tcod.
bsp_new_with_size
(x: int, y: int, w: int, h: int) → tcod.bsp.BSP[source]¶ Create a new BSP instance with the given rectangle.
Parameters: Returns: A new BSP instance.
Return type: Deprecated since version 2.0: Call the
BSP
class instead.
-
tcod.
bsp_split_once
(node: tcod.bsp.BSP, horizontal: bool, position: int) → None[source]¶ Deprecated since version 2.0: Use
BSP.split_once
instead.
-
tcod.
bsp_split_recursive
(node: tcod.bsp.BSP, randomizer: Optional[tcod.random.Random], nb: int, minHSize: int, minVSize: int, maxHRatio: int, maxVRatio: int) → None[source]¶ Deprecated since version 2.0: Use
BSP.split_recursive
instead.
-
tcod.
bsp_resize
(node: tcod.bsp.BSP, x: int, y: int, w: int, h: int) → None[source]¶ Deprecated since version 2.0: Assign directly to
BSP
attributes instead.
-
tcod.
bsp_left
(node: tcod.bsp.BSP) → Optional[tcod.bsp.BSP][source]¶ Deprecated since version 2.0: Use
BSP.children
instead.
-
tcod.
bsp_right
(node: tcod.bsp.BSP) → Optional[tcod.bsp.BSP][source]¶ Deprecated since version 2.0: Use
BSP.children
instead.
-
tcod.
bsp_father
(node: tcod.bsp.BSP) → Optional[tcod.bsp.BSP][source]¶ Deprecated since version 2.0: Use
BSP.parent
instead.
-
tcod.
bsp_is_leaf
(node: tcod.bsp.BSP) → bool[source]¶ Deprecated since version 2.0: Use
BSP.children
instead.
-
tcod.
bsp_contains
(node: tcod.bsp.BSP, cx: int, cy: int) → bool[source]¶ Deprecated since version 2.0: Use
BSP.contains
instead.
-
tcod.
bsp_find_node
(node: tcod.bsp.BSP, cx: int, cy: int) → Optional[tcod.bsp.BSP][source]¶ Deprecated since version 2.0: Use
BSP.find_node
instead.
-
tcod.
bsp_traverse_pre_order
(node: tcod.bsp.BSP, callback: Callable[[tcod.bsp.BSP, Any], None], userData: Any = 0) → None[source]¶ Traverse this nodes hierarchy with a callback.
Deprecated since version 2.0: Use
BSP.pre_order
instead.
-
tcod.
bsp_traverse_in_order
(node: tcod.bsp.BSP, callback: Callable[[tcod.bsp.BSP, Any], None], userData: Any = 0) → None[source]¶ Traverse this nodes hierarchy with a callback.
Deprecated since version 2.0: Use
BSP.in_order
instead.
-
tcod.
bsp_traverse_post_order
(node: tcod.bsp.BSP, callback: Callable[[tcod.bsp.BSP, Any], None], userData: Any = 0) → None[source]¶ Traverse this nodes hierarchy with a callback.
Deprecated since version 2.0: Use
BSP.post_order
instead.
-
tcod.
bsp_traverse_level_order
(node: tcod.bsp.BSP, callback: Callable[[tcod.bsp.BSP, Any], None], userData: Any = 0) → None[source]¶ Traverse this nodes hierarchy with a callback.
Deprecated since version 2.0: Use
BSP.level_order
instead.
-
tcod.
bsp_traverse_inverted_level_order
(node: tcod.bsp.BSP, callback: Callable[[tcod.bsp.BSP, Any], None], userData: Any = 0) → None[source]¶ Traverse this nodes hierarchy with a callback.
Deprecated since version 2.0: Use
BSP.inverted_level_order
instead.
-
tcod.
bsp_remove_sons
(node: tcod.bsp.BSP) → None[source]¶ Delete all children of a given node. Not recommended.
Note
This function will add unnecessary complexity to your code. Don’t use it.
Deprecated since version 2.0: BSP deletion is automatic.
-
tcod.
bsp_delete
(node: tcod.bsp.BSP) → None[source]¶ Exists for backward compatibility. Does nothing.
BSP’s created by this library are automatically garbage collected once there are no references to the tree. This function exists for backwards compatibility.
Deprecated since version 2.0: BSP deletion is automatic.
color¶
-
class
tcod.
Color
(r: int = 0, g: int = 0, b: int = 0)[source]¶ Parameters: -
r
¶ Red value, always normalised to 0-255.
Deprecated since version 9.2: Color attributes will not be mutable in the future.
Type: int
-
g
¶ Green value, always normalised to 0-255.
Deprecated since version 9.2: Color attributes will not be mutable in the future.
Type: int
-
b
¶ Blue value, always normalised to 0-255.
Deprecated since version 9.2: Color attributes will not be mutable in the future.
Type: int
-
__getitem__
(index: Any) → Any[source]¶ Deprecated since version 9.2: Accessing colors via a letter index is deprecated.
-
-
tcod.
color_lerp
(c1: Tuple[int, int, int], c2: Tuple[int, int, int], a: float) → tcod.color.Color[source]¶ Return the linear interpolation between two colors.
a
is the interpolation value, with 0 returingc1
, 1 returningc2
, and 0.5 returing a color halfway between both.Parameters: Returns: The interpolated Color.
Return type:
-
tcod.
color_set_hsv
(c: tcod.color.Color, h: float, s: float, v: float) → None[source]¶ Set a color using: hue, saturation, and value parameters.
Does not return a new Color.
c
is modified inplace.Parameters:
-
tcod.
color_get_hsv
(c: Tuple[int, int, int]) → Tuple[float, float, float][source]¶ Return the (hue, saturation, value) of a color.
Parameters: c (Union[Tuple[int, int, int], Sequence[int]]) – An (r, g, b) sequence or Color instance. Returns: A tuple with (hue, saturation, value) values, from 0 to 1. Return type: Tuple[float, float, float]
-
tcod.
color_scale_HSV
(c: tcod.color.Color, scoef: float, vcoef: float) → None[source]¶ Scale a color’s saturation and value.
Does not return a new Color.
c
is modified inplace.Parameters:
-
tcod.
color_gen_map
(colors: Iterable[Tuple[int, int, int]], indexes: Iterable[int]) → List[tcod.color.Color][source]¶ Return a smoothly defined scale of colors.
If
indexes
is [0, 3, 9] for example, the first color fromcolors
will be returned at 0, the 2nd will be at 3, and the 3rd will be at 9. All in-betweens will be filled with a gradient.Parameters: Returns: A list of Color instances.
Return type: List[Color]
Example
>>> tcod.color_gen_map([(0, 0, 0), (255, 128, 0)], [0, 5]) [Color(0, 0, 0), Color(51, 25, 0), Color(102, 51, 0), Color(153, 76, 0), Color(204, 102, 0), Color(255, 128, 0)]
console¶
-
tcod.
console_set_custom_font
(fontFile: AnyStr, flags: int = 1, nb_char_horiz: int = 0, nb_char_vertic: int = 0) → None[source]¶ Load the custom font file at fontFile.
Call this before function before calling
tcod.console_init_root
.Flags can be a mix of the following:
- tcod.FONT_LAYOUT_ASCII_INCOL: Decode tileset raw in column-major order.
- tcod.FONT_LAYOUT_ASCII_INROW: Decode tileset raw in row-major order.
- tcod.FONT_TYPE_GREYSCALE: Force tileset to be read as greyscale.
- tcod.FONT_TYPE_GRAYSCALE
- tcod.FONT_LAYOUT_TCOD: Unique layout used by libtcod.
- tcod.FONT_LAYOUT_CP437: Decode a row-major Code Page 437 tileset into Unicode.
nb_char_horiz and nb_char_vertic are the columns and rows of the font file respectfully.
Deprecated since version 11.13: Load fonts using
tcod.tileset.load_tileheet
instead. See Getting Started for more info.
-
tcod.
console_init_root
(w: int, h: int, title: Optional[str] = None, fullscreen: bool = False, renderer: Optional[int] = None, order: Union[typing_extensions.Literal['C'][C], typing_extensions.Literal['F'][F]] = 'C', vsync: Optional[bool] = None) → tcod.console.Console[source]¶ Set up the primary display and return the root console.
w and h are the columns and rows of the new window (in tiles.)
title is an optional string to display on the windows title bar.
fullscreen determines if the window will start in fullscreen. Fullscreen mode is unreliable unless the renderer is set to tcod.RENDERER_SDL2 or tcod.RENDERER_OPENGL2.
renderer is the rendering back-end that libtcod will use. If you don’t know which to pick, then use tcod.RENDERER_SDL2. Options are:
- tcod.RENDERER_SDL: Forces the SDL2 renderer into software mode.
- tcod.RENDERER_OPENGL: An OpenGL 1 implementation.
- tcod.RENDERER_GLSL: A deprecated SDL2/OpenGL2 renderer.
- tcod.RENDERER_SDL2: The recommended SDL2 renderer. Rendering is decided by SDL2 and can be changed by using an SDL2 hint.
- tcod.RENDERER_OPENGL2: An SDL2/OPENGL2 renderer. Usually faster than regular SDL2. Requires OpenGL 2.0 Core.
order will affect how the array attributes of the returned root console are indexed. order=’C’ is the default, but order=’F’ is recommended.
If vsync is True then the frame-rate will be synchronized to the monitors vertical refresh rate. This prevents screen tearing and avoids wasting computing power on overdraw. If vsync is False then the frame-rate will be uncapped. The default is False but will change to True in the future. This option only works with the SDL2 or OPENGL2 renderers, any other renderer will always have vsync disabled.
The returned object is the root console. You don’t need to use this object but you should at least close it when you’re done with the libtcod window. You can do this by calling
Console.close
or by using this function in a context, like in the following example:with tcod.console_init_root(80, 50, vsync=True) as root_console: ... # Put your game loop here. ... # Window closes at the end of the above block.
Changed in version 4.3: Added order parameter. title parameter is now optional.
Changed in version 8.0: The default renderer is now automatic instead of always being RENDERER_SDL.
Changed in version 10.1: Added the vsync parameter.
Deprecated since version 11.13: Use
tcod.context
for window management. See Getting Started for more info.
-
tcod.
console_flush
(console: Optional[tcod.console.Console] = None, *, keep_aspect: bool = False, integer_scaling: bool = False, snap_to_integer: Optional[bool] = None, clear_color: Union[Tuple[int, int, int], Tuple[int, int, int, int]] = (0, 0, 0), align: Tuple[float, float] = (0.5, 0.5)) → None[source]¶ Update the display to represent the root consoles current state.
console is the console you want to present. If not given the root console will be used.
If keep_aspect is True then the console aspect will be preserved with a letterbox. Otherwise the console will be stretched to fill the screen.
If integer_scaling is True then the console will be scaled in integer increments. This will have no effect if the console must be shrunk. You can use
tcod.console.recommended_size
to create a console which will fit the window without needing to be scaled.clear_color is an RGB or RGBA tuple used to clear the screen before the console is presented, this will normally affect the border/letterbox color.
align determines where the console will be placed when letter-boxing exists. Values of 0 will put the console at the upper-left corner. Values of 0.5 will center the console.
snap_to_integer is deprecated and setting it will have no effect. It will be removed in a later version.
Changed in version 11.8: The parameters console, keep_aspect, integer_scaling, snap_to_integer, clear_color, and align were added.
Changed in version 11.11: clear_color can now be an RGB tuple.
Deprecated since version 11.13: This function is not supported by contexts.
-
tcod.
console_blit
(src: tcod.console.Console, x: int, y: int, w: int, h: int, dst: tcod.console.Console, xdst: int, ydst: int, ffade: float = 1.0, bfade: float = 1.0) → None[source]¶ Blit the console src from x,y,w,h to console dst at xdst,ydst.
Deprecated since version 8.5: Call the
Console.blit
method instead.
-
tcod.
console_check_for_keypress
(flags: int = 2) → tcod.libtcodpy.Key[source]¶ Deprecated since version 9.3: Use the
tcod.event.get
function to check for events.
-
tcod.
console_clear
(con: tcod.console.Console) → None[source]¶ Reset a console to its default colors and the space character.
Parameters: con (Console) – Any Console instance. Deprecated since version 8.5: Call the
Console.clear
method instead.
-
tcod.
console_delete
(con: tcod.console.Console) → None[source]¶ Closes the window if con is the root console.
libtcod objects are automatically garbage collected once they go out of scope.
This function exists for backwards compatibility.
Deprecated since version 9.3: This function is not needed for normal
tcod.console.Console
’s. The root console should be used in a with statement instead to ensure that it closes.
-
tcod.
console_fill_background
(con: tcod.console.Console, r: Sequence[int], g: Sequence[int], b: Sequence[int]) → None[source]¶ Fill the backgound of a console with r,g,b.
Parameters: Deprecated since version 8.4: You should assign to
tcod.console.Console.bg
instead.
-
tcod.
console_fill_char
(con: tcod.console.Console, arr: Sequence[int]) → None[source]¶ Fill the character tiles of a console with an array.
arr is an array of integers with a length of the consoles width and height.
Deprecated since version 8.4: You should assign to
tcod.console.Console.ch
instead.
-
tcod.
console_fill_foreground
(con: tcod.console.Console, r: Sequence[int], g: Sequence[int], b: Sequence[int]) → None[source]¶ Fill the foregound of a console with r,g,b.
Parameters: Deprecated since version 8.4: You should assign to
tcod.console.Console.fg
instead.
-
tcod.
console_from_file
(filename: str) → tcod.console.Console[source]¶ Return a new console object from a filename.
The file format is automactially determined. This can load REXPaint .xp, ASCII Paint .apf, or Non-delimited ASCII .asc files.
Parameters: filename (Text) – The path to the file, as a string. Returns: A new :any`Console` instance.
-
tcod.
console_from_xp
(filename: str) → tcod.console.Console[source]¶ Return a single console from a REXPaint .xp file.
-
tcod.
console_get_alignment
(con: tcod.console.Console) → int[source]¶ Return this consoles current alignment mode.
Parameters: con (Console) – Any Console instance. Deprecated since version 8.5: Check
Console.default_alignment
instead.
-
tcod.
console_get_background_flag
(con: tcod.console.Console) → int[source]¶ Return this consoles current blend mode.
Parameters: con (Console) – Any Console instance. Deprecated since version 8.5: Check
Console.default_bg_blend
instead.
-
tcod.
console_get_char
(con: tcod.console.Console, x: int, y: int) → int[source]¶ Return the character at the x,y of this console.
Deprecated since version 8.4: Array access performs significantly faster than using this function. See
Console.ch
.
-
tcod.
console_get_char_background
(con: tcod.console.Console, x: int, y: int) → tcod.color.Color[source]¶ Return the background color at the x,y of this console.
Deprecated since version 8.4: Array access performs significantly faster than using this function. See
Console.bg
.
-
tcod.
console_get_char_foreground
(con: tcod.console.Console, x: int, y: int) → tcod.color.Color[source]¶ Return the foreground color at the x,y of this console.
Deprecated since version 8.4: Array access performs significantly faster than using this function. See
Console.fg
.
-
tcod.
console_get_default_background
(con: tcod.console.Console) → tcod.color.Color[source]¶ Return this consoles default background color.
Deprecated since version 8.5: Use
Console.default_bg
instead.
-
tcod.
console_get_default_foreground
(con: tcod.console.Console) → tcod.color.Color[source]¶ Return this consoles default foreground color.
Deprecated since version 8.5: Use
Console.default_fg
instead.
-
tcod.
console_get_fade
() → int[source]¶ Deprecated since version 11.13: This function is not supported by contexts.
-
tcod.
console_get_fading_color
() → tcod.color.Color[source]¶ Deprecated since version 11.13: This function is not supported by contexts.
-
tcod.
console_get_height
(con: tcod.console.Console) → int[source]¶ Return the height of a console.
Parameters: con (Console) – Any Console instance. Returns: The height of a Console. Return type: int Deprecated since version 2.0: Use Console.height instead.
-
tcod.
console_get_height_rect
(con: tcod.console.Console, x: int, y: int, w: int, h: int, fmt: str) → int[source]¶ Return the height of this text once word-wrapped into this rectangle.
Returns: The number of lines of text once word-wrapped. Return type: int Deprecated since version 8.5: Use
Console.get_height_rect
instead.
-
tcod.
console_get_width
(con: tcod.console.Console) → int[source]¶ Return the width of a console.
Parameters: con (Console) – Any Console instance. Returns: The width of a Console. Return type: int Deprecated since version 2.0: Use Console.width instead.
-
tcod.
console_hline
(con: tcod.console.Console, x: int, y: int, l: int, flag: int = 13) → None[source]¶ Draw a horizontal line on the console.
This always uses the character 196, the horizontal line character.
Deprecated since version 8.5: Use
Console.hline
instead.
-
tcod.
console_is_fullscreen
() → bool[source]¶ Returns True if the display is fullscreen.
Returns: True if the display is fullscreen, otherwise False. Return type: bool Deprecated since version 11.13: This function is not supported by contexts.
-
tcod.
console_is_window_closed
() → bool[source]¶ Returns True if the window has received and exit event.
Deprecated since version 9.3: Use the
tcod.event
module to check for “QUIT” type events.
-
tcod.
console_load_apf
(con: tcod.console.Console, filename: str) → bool[source]¶ Update a console from an ASCII Paint .apf file.
-
tcod.
console_load_asc
(con: tcod.console.Console, filename: str) → bool[source]¶ Update a console from a non-delimited ASCII .asc file.
-
tcod.
console_load_xp
(con: tcod.console.Console, filename: str) → bool[source]¶ Update a console from a REXPaint .xp file.
Deprecated since version 11.18: Functions modifying console objects in-place are deprecated. Use
tcod.console_from_xp
to load a Console from a file.
-
tcod.
console_list_load_xp
(filename: str) → Optional[List[tcod.console.Console]][source]¶ Return a list of consoles from a REXPaint .xp file.
-
tcod.
console_list_save_xp
(console_list: Sequence[tcod.console.Console], filename: str, compress_level: int = 9) → bool[source]¶ Save a list of consoles to a REXPaint .xp file.
-
tcod.
console_map_ascii_code_to_font
(asciiCode: int, fontCharX: int, fontCharY: int) → None[source]¶ Set a character code to new coordinates on the tile-set.
asciiCode should be any Unicode codepoint.
Parameters: Deprecated since version 11.13: Setup fonts using the
tcod.tileset
module.Tileset.remap
replaces this function.
-
tcod.
console_map_ascii_codes_to_font
(firstAsciiCode: int, nbCodes: int, fontCharX: int, fontCharY: int) → None[source]¶ Remap a contiguous set of codes to a contiguous set of tiles.
Both the tile-set and character codes must be contiguous to use this function. If this is not the case you may want to use
console_map_ascii_code_to_font
.Parameters: Deprecated since version 11.13: Setup fonts using the
tcod.tileset
module.Tileset.remap
replaces this function.
-
tcod.
console_map_string_to_font
(s: str, fontCharX: int, fontCharY: int) → None[source]¶ Remap a string of codes to a contiguous set of tiles.
Parameters: - s (AnyStr) – A string of character codes to map to new values. The null character ‘x00’ will prematurely end this function.
- fontCharX (int) – The starting X tile coordinate on the loaded tileset. 0 is the leftmost tile.
- fontCharY (int) – The starting Y tile coordinate on the loaded tileset. 0 is the topmost tile.
Deprecated since version 11.13: Setup fonts using the
tcod.tileset
module.Tileset.remap
replaces this function.
-
tcod.
console_new
(w: int, h: int) → tcod.console.Console[source]¶ Return an offscreen console of size: w,h.
Deprecated since version 8.5: Create new consoles using
tcod.console.Console
instead of this function.
-
tcod.
console_print
(con: tcod.console.Console, x: int, y: int, fmt: str) → None[source]¶ Print a color formatted string on a console.
Parameters: Deprecated since version 8.5: Use
Console.print_
instead.
-
tcod.
console_print_ex
(con: tcod.console.Console, x: int, y: int, flag: int, alignment: int, fmt: str) → None[source]¶ Print a string on a console using a blend mode and alignment mode.
Parameters: Deprecated since version 8.5: Use
Console.print_
instead.
-
tcod.
console_print_frame
(con: tcod.console.Console, x: int, y: int, w: int, h: int, clear: bool = True, flag: int = 13, fmt: str = '') → None[source]¶ Draw a framed rectangle with optinal text.
This uses the default background color and blend mode to fill the rectangle and the default foreground to draw the outline.
fmt will be printed on the inside of the rectangle, word-wrapped. If fmt is empty then no title will be drawn.
Changed in version 8.2: Now supports Unicode strings.
Deprecated since version 8.5: Use
Console.print_frame
instead.
-
tcod.
console_print_rect
(con: tcod.console.Console, x: int, y: int, w: int, h: int, fmt: str) → int[source]¶ Print a string constrained to a rectangle.
If h > 0 and the bottom of the rectangle is reached, the string is truncated. If h = 0, the string is only truncated if it reaches the bottom of the console.
Returns: The number of lines of text once word-wrapped. Return type: int Deprecated since version 8.5: Use
Console.print_rect
instead.
-
tcod.
console_print_rect_ex
(con: tcod.console.Console, x: int, y: int, w: int, h: int, flag: int, alignment: int, fmt: str) → int[source]¶ Print a string constrained to a rectangle with blend and alignment.
Returns: The number of lines of text once word-wrapped. Return type: int Deprecated since version 8.5: Use
Console.print_rect
instead.
-
tcod.
console_put_char
(con: tcod.console.Console, x: int, y: int, c: Union[int, str], flag: int = 13) → None[source]¶ Draw the character c at x,y using the default colors and a blend mode.
Parameters:
-
tcod.
console_put_char_ex
(con: tcod.console.Console, x: int, y: int, c: Union[int, str], fore: Tuple[int, int, int], back: Tuple[int, int, int]) → None[source]¶ Draw the character c at x,y using the colors fore and back.
Parameters: - con (Console) – Any Console instance.
- x (int) – Character x position from the left.
- y (int) – Character y position from the top.
- c (Union[int, AnyStr]) – Character to draw, can be an integer or string.
- fore (Union[Tuple[int, int, int], Sequence[int]]) – An (r, g, b) sequence or Color instance.
- back (Union[Tuple[int, int, int], Sequence[int]]) – An (r, g, b) sequence or Color instance.
-
tcod.
console_rect
(con: tcod.console.Console, x: int, y: int, w: int, h: int, clr: bool, flag: int = 13) → None[source]¶ Draw a the background color on a rect optionally clearing the text.
If clr is True the affected tiles are changed to space character.
Deprecated since version 8.5: Use
Console.rect
instead.
-
tcod.
console_save_apf
(con: tcod.console.Console, filename: str) → bool[source]¶ Save a console to an ASCII Paint .apf file.
-
tcod.
console_save_asc
(con: tcod.console.Console, filename: str) → bool[source]¶ Save a console to a non-delimited ASCII .asc file.
-
tcod.
console_save_xp
(con: tcod.console.Console, filename: str, compress_level: int = 9) → bool[source]¶ Save a console to a REXPaint .xp file.
-
tcod.
console_set_alignment
(con: tcod.console.Console, alignment: int) → None[source]¶ Change this consoles current alignment mode.
- tcod.LEFT
- tcod.CENTER
- tcod.RIGHT
Parameters: Deprecated since version 8.5: Set
Console.default_alignment
instead.
-
tcod.
console_set_background_flag
(con: tcod.console.Console, flag: int) → None[source]¶ Change the default blend mode for this console.
Parameters: Deprecated since version 8.5: Set
Console.default_bg_blend
instead.
-
tcod.
console_set_char
(con: tcod.console.Console, x: int, y: int, c: Union[int, str]) → None[source]¶ Change the character at x,y to c, keeping the current colors.
Parameters: Deprecated since version 8.4: Array access performs significantly faster than using this function. See
Console.ch
.
-
tcod.
console_set_char_background
(con: tcod.console.Console, x: int, y: int, col: Tuple[int, int, int], flag: int = 1) → None[source]¶ Change the background color of x,y to col using a blend mode.
Parameters:
-
tcod.
console_set_char_foreground
(con: tcod.console.Console, x: int, y: int, col: Tuple[int, int, int]) → None[source]¶ Change the foreground color of x,y to col.
Parameters: Deprecated since version 8.4: Array access performs significantly faster than using this function. See
Console.fg
.
-
tcod.
console_set_color_control
(con: int, fore: Tuple[int, int, int], back: Tuple[int, int, int]) → None[source]¶ Configure
color controls
.Parameters:
-
tcod.
console_set_default_background
(con: tcod.console.Console, col: Tuple[int, int, int]) → None[source]¶ Change the default background color for a console.
Parameters: Deprecated since version 8.5: Use
Console.default_bg
instead.
-
tcod.
console_set_default_foreground
(con: tcod.console.Console, col: Tuple[int, int, int]) → None[source]¶ Change the default foreground color for a console.
Parameters: Deprecated since version 8.5: Use
Console.default_fg
instead.
-
tcod.
console_set_fade
(fade: int, fadingColor: Tuple[int, int, int]) → None[source]¶ Deprecated since version 11.13: This function is not supported by contexts.
-
tcod.
console_set_fullscreen
(fullscreen: bool) → None[source]¶ Change the display to be fullscreen or windowed.
Parameters: fullscreen (bool) – Use True to change to fullscreen. Use False to change to windowed. Deprecated since version 11.13: This function is not supported by contexts.
-
tcod.
console_set_key_color
(con: tcod.console.Console, col: Tuple[int, int, int]) → None[source]¶ Set a consoles blit transparent color.
Deprecated since version 8.5: Pass the key color to
tcod.console.Console.blit
instead of calling this function.
-
tcod.
console_set_window_title
(title: str) → None[source]¶ Change the current title bar string.
Parameters: title (AnyStr) – A string to change the title bar to. Deprecated since version 11.13: This function is not supported by contexts.
-
tcod.
console_vline
(con: tcod.console.Console, x: int, y: int, l: int, flag: int = 13) → None[source]¶ Draw a vertical line on the console.
This always uses the character 179, the vertical line character.
Deprecated since version 8.5: Use
Console.vline
instead.
-
tcod.
console_wait_for_keypress
(flush: bool) → tcod.libtcodpy.Key[source]¶ Block until the user presses a key, then returns a new Key.
Parameters: bool (flush) – If True then the event queue is cleared before waiting for the next event. Returns: A new Key instance. Return type: Key Deprecated since version 9.3: Use the
tcod.event.wait
function to wait for events.
Event¶
-
class
tcod.
Key
[source]¶ Key Event instance
-
text
¶ text[TCOD_KEY_TEXT_SIZE]; text if vk == TCODK_TEXT else text[0] == ‘’
Type: Text
Deprecated since version 9.3: Use events from the
tcod.event
module instead.-
-
class
tcod.
Mouse
[source]¶ Mouse event instance
Left button status.
Type: bool
Right button status.
Type: bool
Middle button status.
Type: bool
Left button pressed event.
Type: bool
Right button pressed event.
Type: bool
Middle button pressed event.
Type: bool
Deprecated since version 9.3: Use events from the
tcod.event
module instead.
Event Types¶
-
tcod.
EVENT_NONE
¶
-
tcod.
EVENT_KEY_PRESS
¶
-
tcod.
EVENT_KEY_RELEASE
¶
-
tcod.
EVENT_KEY
¶ Same as
tcod.EVENT_KEY_PRESS | tcod.EVENT_KEY_RELEASE
-
tcod.
EVENT_MOUSE_MOVE
¶
-
tcod.
EVENT_MOUSE_PRESS
¶
-
tcod.
EVENT_MOUSE_RELEASE
¶
-
tcod.
EVENT_MOUSE
¶ Same as
tcod.EVENT_MOUSE_MOVE | tcod.EVENT_MOUSE_PRESS | tcod.EVENT_MOUSE_RELEASE
-
tcod.
EVENT_FINGER_MOVE
¶
-
tcod.
EVENT_FINGER_PRESS
¶
-
tcod.
EVENT_FINGER_RELEASE
¶
-
tcod.
EVENT_FINGER
¶ Same as
tcod.EVENT_FINGER_MOVE | tcod.EVENT_FINGER_PRESS | tcod.EVENT_FINGER_RELEASE
-
tcod.
EVENT_ANY
¶ Same as
tcod.EVENT_KEY | tcod.EVENT_MOUSE | tcod.EVENT_FINGER
sys¶
-
tcod.
sys_set_fps
(fps: int) → None[source]¶ Set the maximum frame rate.
You can disable the frame limit again by setting fps to 0.
Parameters: fps (int) – A frame rate limit (i.e. 60) Deprecated since version 11.13: This function is not supported by contexts.
-
tcod.
sys_get_fps
() → int[source]¶ Return the current frames per second.
This the actual frame rate, not the frame limit set by
tcod.sys_set_fps
.This number is updated every second.
Returns: The currently measured frame rate. Return type: int Deprecated since version 11.13: This function is not supported by contexts.
-
tcod.
sys_get_last_frame_length
() → float[source]¶ Return the delta time of the last rendered frame in seconds.
Returns: The delta time of the last rendered frame. Return type: float Deprecated since version 11.13: This function is not supported by contexts.
-
tcod.
sys_sleep_milli
(val: int) → None[source]¶ Sleep for ‘val’ milliseconds.
Parameters: val (int) – Time to sleep for in milliseconds. Deprecated since version 2.0: Use
time.sleep
instead.
-
tcod.
sys_elapsed_milli
() → int[source]¶ Get number of milliseconds since the start of the program.
Returns: Time since the progeam has started in milliseconds. Return type: int Deprecated since version 2.0: Use
time.clock
instead.
-
tcod.
sys_elapsed_seconds
() → float[source]¶ Get number of seconds since the start of the program.
Returns: Time since the progeam has started in seconds. Return type: float Deprecated since version 2.0: Use
time.clock
instead.
-
tcod.
sys_set_renderer
(renderer: int) → None[source]¶ Change the current rendering mode to renderer.
Deprecated since version 11.13: This function is not supported by contexts.
-
tcod.
sys_get_renderer
() → int[source]¶ Return the current rendering mode.
Deprecated since version 11.13: This function is not supported by contexts. Check
Context.renderer_type
instead.
-
tcod.
sys_save_screenshot
(name: Optional[str] = None) → None[source]¶ Save a screenshot to a file.
By default this will automatically save screenshots in the working directory.
The automatic names are formatted as screenshotNNN.png. For example: screenshot000.png, screenshot001.png, etc. Whichever is available first.
Parameters: Optional[AnyStr] (file) – File path to save screenshot. Deprecated since version 11.13: This function is not supported by contexts. Use
Context.save_screenshot
instead.
-
tcod.
sys_force_fullscreen_resolution
(width: int, height: int) → None[source]¶ Force a specific resolution in fullscreen.
Will use the smallest available resolution so that:
- resolution width >= width and resolution width >= root console width * font char width
- resolution height >= height and resolution height >= root console height * font char height
Parameters: Deprecated since version 11.13: This function is not supported by contexts.
-
tcod.
sys_get_current_resolution
() → Tuple[int, int][source]¶ Return a monitors pixel resolution as (width, height).
Deprecated since version 11.13: This function is deprecated, which monitor is detected is ambiguous.
-
tcod.
sys_get_char_size
() → Tuple[int, int][source]¶ Return the current fonts character size as (width, height)
Returns: The current font glyph size in (width, height) Return type: Tuple[int,int] Deprecated since version 11.13: This function is not supported by contexts.
-
tcod.
sys_update_char
(asciiCode: int, fontx: int, fonty: int, img: tcod.image.Image, x: int, y: int) → None[source]¶ Dynamically update the current font with img.
All cells using this asciiCode will be updated at the next call to
tcod.console_flush
.Parameters: - asciiCode (int) – Ascii code corresponding to the character to update.
- fontx (int) – Left coordinate of the character in the bitmap font (in tiles)
- fonty (int) – Top coordinate of the character in the bitmap font (in tiles)
- img (Image) – An image containing the new character bitmap.
- x (int) – Left pixel of the character in the image.
- y (int) – Top pixel of the character in the image.
Deprecated since version 11.13: This function is not supported by contexts. Use
Tileset.set_tile
instead to update tiles.
-
tcod.
sys_register_SDL_renderer
(callback: Callable[[Any], None]) → None[source]¶ Register a custom randering function with libtcod.
Note
This callback will only be called by the SDL renderer.
The callack will receive a
CData
void* to an SDL_Surface* struct.The callback is called on every call to
tcod.console_flush
.Parameters: Callable[[CData], None] (callback) – A function which takes a single argument. Deprecated since version 11.13: This function is not supported by contexts.
-
tcod.
sys_check_for_event
(mask: int, k: Optional[tcod.libtcodpy.Key], m: Optional[tcod.libtcodpy.Mouse]) → int[source]¶ Check for and return an event.
Parameters: - mask (int) – Event Types to wait for.
- k (Optional[Key]) – A tcod.Key instance which might be updated with an event. Can be None.
- m (Optional[Mouse]) – A tcod.Mouse instance which might be updated with an event. Can be None.
Deprecated since version 9.3: Use the
tcod.event.get
function to check for events.
-
tcod.
sys_wait_for_event
(mask: int, k: Optional[tcod.libtcodpy.Key], m: Optional[tcod.libtcodpy.Mouse], flush: bool) → int[source]¶ Wait for an event then return.
If flush is True then the buffer will be cleared before waiting. Otherwise each available event will be returned in the order they’re recieved.
Parameters: - mask (int) – Event Types to wait for.
- k (Optional[Key]) – A tcod.Key instance which might be updated with an event. Can be None.
- m (Optional[Mouse]) – A tcod.Mouse instance which might be updated with an event. Can be None.
- flush (bool) – Clear the event buffer before waiting.
Deprecated since version 9.3: Use the
tcod.event.wait
function to wait for events.
pathfinding¶
-
tcod.
dijkstra_delete
(p: tcod.path.Dijkstra) → None[source]¶ Does nothing. libtcod objects are managed by Python’s garbage collector.
This function exists for backwards compatibility with libtcodpy.
-
tcod.
dijkstra_new_using_function
(w: int, h: int, func: Callable[[int, int, int, int, Any], float], userData: Any = 0, dcost: float = 1.41) → tcod.path.Dijkstra[source]¶
-
tcod.
path_compute
(p: tcod.path.AStar, ox: int, oy: int, dx: int, dy: int) → bool[source]¶ Find a path from (ox, oy) to (dx, dy). Return True if path is found.
Parameters: Returns: True if a valid path was found. Otherwise False.
Return type:
-
tcod.
path_delete
(p: tcod.path.AStar) → None[source]¶ Does nothing. libtcod objects are managed by Python’s garbage collector.
This function exists for backwards compatibility with libtcodpy.
-
tcod.
path_get
(p: tcod.path.AStar, idx: int) → Tuple[int, int][source]¶ Get a point on a path.
Parameters:
-
tcod.
path_get_destination
(p: tcod.path.AStar) → Tuple[int, int][source]¶ Get the current destination position.
Parameters: p (AStar) – An AStar instance. Returns: An (x, y) point. Return type: Tuple[int, int]
-
tcod.
path_get_origin
(p: tcod.path.AStar) → Tuple[int, int][source]¶ Get the current origin position.
This point moves when
path_walk
returns the next x,y step.Parameters: p (AStar) – An AStar instance. Returns: An (x, y) point. Return type: Tuple[int, int]
-
tcod.
path_is_empty
(p: tcod.path.AStar) → bool[source]¶ Return True if a path is empty.
Parameters: p (AStar) – An AStar instance. Returns: True if a path is empty. Otherwise False. Return type: bool
-
tcod.
path_new_using_function
(w: int, h: int, func: Callable[[int, int, int, int, Any], float], userData: Any = 0, dcost: float = 1.41) → tcod.path.AStar[source]¶ Return a new AStar using the given callable function.
Parameters: Returns: A new AStar instance.
Return type:
-
tcod.
path_new_using_map
(m: tcod.map.Map, dcost: float = 1.41) → tcod.path.AStar[source]¶ Return a new AStar using the given Map.
Parameters: Returns: A new AStar instance.
Return type:
-
tcod.
path_reverse
(p: tcod.path.AStar) → None[source]¶ Reverse the direction of a path.
This effectively swaps the origin and destination points.
Parameters: p (AStar) – An AStar instance.
-
tcod.
path_size
(p: tcod.path.AStar) → int[source]¶ Return the current length of the computed path.
Parameters: p (AStar) – An AStar instance. Returns: Length of the path. Return type: int
-
tcod.
path_walk
(p: tcod.path.AStar, recompute: bool) → Union[Tuple[int, int], Tuple[None, None]][source]¶ Return the next (x, y) point in a path, or (None, None) if it’s empty.
When
recompute
is True and a previously valid path reaches a point where it is now blocked, a new path will automatically be found.Parameters: Returns: A single (x, y) point, or (None, None)
Return type:
heightmap¶
-
tcod.
heightmap_add
(hm: numpy.ndarray, value: float) → None[source]¶ Add value to all values on this heightmap.
Parameters: - hm (numpy.ndarray) – A numpy.ndarray formatted for heightmap functions.
- value (float) – A number to add to this heightmap.
Deprecated since version 2.0: Do
hm[:] += value
instead.
-
tcod.
heightmap_add_fbm
(hm: numpy.ndarray, noise: tcod.noise.Noise, mulx: float, muly: float, addx: float, addy: float, octaves: float, delta: float, scale: float) → None[source]¶ Add FBM noise to the heightmap.
The noise coordinate for each map cell is ((x + addx) * mulx / width, (y + addy) * muly / height).
The value added to the heightmap is delta + noise * scale.
Parameters: - hm (numpy.ndarray) – A numpy.ndarray formatted for heightmap functions.
- noise (Noise) – A Noise instance.
- mulx (float) – Scaling of each x coordinate.
- muly (float) – Scaling of each y coordinate.
- addx (float) – Translation of each x coordinate.
- addy (float) – Translation of each y coordinate.
- octaves (float) – Number of octaves in the FBM sum.
- delta (float) – The value added to all heightmap cells.
- scale (float) – The noise value is scaled with this parameter.
Deprecated since version 8.1: An equivalent array of noise samples can be taken using a method such as
Noise.sample_ogrid
.
-
tcod.
heightmap_add_hill
(hm: numpy.ndarray, x: float, y: float, radius: float, height: float) → None[source]¶ Add a hill (a half spheroid) at given position.
If height == radius or -radius, the hill is a half-sphere.
Parameters: - hm (numpy.ndarray) – A numpy.ndarray formatted for heightmap functions.
- x (float) – The x position at the center of the new hill.
- y (float) – The y position at the center of the new hill.
- radius (float) – The size of the new hill.
- height (float) – The height or depth of the new hill.
-
tcod.
heightmap_add_hm
(hm1: numpy.ndarray, hm2: numpy.ndarray, hm3: numpy.ndarray) → None[source]¶ Add two heightmaps together and stores the result in
hm3
.Parameters: - hm1 (numpy.ndarray) – The first heightmap.
- hm2 (numpy.ndarray) – The second heightmap to add to the first.
- hm3 (numpy.ndarray) – A destination heightmap to store the result.
Deprecated since version 2.0: Do
hm3[:] = hm1[:] + hm2[:]
instead.
-
tcod.
heightmap_add_voronoi
(hm: numpy.ndarray, nbPoints: Any, nbCoef: int, coef: Sequence[float], rnd: Optional[tcod.random.Random] = None) → None[source]¶ Add values from a Voronoi diagram to the heightmap.
Parameters: - hm (numpy.ndarray) – A numpy.ndarray formatted for heightmap functions.
- nbPoints (Any) – Number of Voronoi sites.
- nbCoef (int) – The diagram value is calculated from the nbCoef closest sites.
- coef (Sequence[float]) – The distance to each site is scaled by the corresponding coef. Closest site : coef[0], second closest site : coef[1], …
- rnd (Optional[Random]) – A Random instance, or None.
-
tcod.
heightmap_clamp
(hm: numpy.ndarray, mi: float, ma: float) → None[source]¶ Clamp all values on this heightmap between
mi
andma
Parameters: - hm (numpy.ndarray) – A numpy.ndarray formatted for heightmap functions.
- mi (float) – The lower bound to clamp to.
- ma (float) – The upper bound to clamp to.
Deprecated since version 2.0: Do
hm.clip(mi, ma)
instead.
-
tcod.
heightmap_clear
(hm: numpy.ndarray) → None[source]¶ Add value to all values on this heightmap.
Parameters: hm (numpy.ndarray) – A numpy.ndarray formatted for heightmap functions. Deprecated since version 2.0: Do
hm.array[:] = 0
instead.
-
tcod.
heightmap_copy
(hm1: numpy.ndarray, hm2: numpy.ndarray) → None[source]¶ Copy the heightmap
hm1
tohm2
.Parameters: - hm1 (numpy.ndarray) – The source heightmap.
- hm2 (numpy.ndarray) – The destination heightmap.
Deprecated since version 2.0: Do
hm2[:] = hm1[:]
instead.
-
tcod.
heightmap_count_cells
(hm: numpy.ndarray, mi: float, ma: float) → int[source]¶ Return the number of map cells which value is between
mi
andma
.Parameters: - hm (numpy.ndarray) – A numpy.ndarray formatted for heightmap functions.
- mi (float) – The lower bound.
- ma (float) – The upper bound.
Returns: The count of values which fall between
mi
andma
.Return type: Deprecated since version 8.1: Can be replaced by an equivalent NumPy function such as:
numpy.count_nonzero((mi <= hm) & (hm < ma))
-
tcod.
heightmap_delete
(hm: Any) → None[source]¶ Does nothing. libtcod objects are managed by Python’s garbage collector.
This function exists for backwards compatibility with libtcodpy.
Deprecated since version 2.0: libtcod-cffi deletes heightmaps automatically.
-
tcod.
heightmap_dig_bezier
(hm: numpy.ndarray, px: Tuple[int, int, int, int], py: Tuple[int, int, int, int], startRadius: float, startDepth: float, endRadius: float, endDepth: float) → None[source]¶ Carve a path along a cubic Bezier curve.
Both radius and depth can vary linearly along the path.
Parameters: - hm (numpy.ndarray) – A numpy.ndarray formatted for heightmap functions.
- px (Sequence[int]) – The 4 x coordinates of the Bezier curve.
- py (Sequence[int]) – The 4 y coordinates of the Bezier curve.
- startRadius (float) – The starting radius size.
- startDepth (float) – The starting depth.
- endRadius (float) – The ending radius size.
- endDepth (float) – The ending depth.
-
tcod.
heightmap_dig_hill
(hm: numpy.ndarray, x: float, y: float, radius: float, height: float) → None[source]¶ This function takes the highest value (if height > 0) or the lowest (if height < 0) between the map and the hill.
It’s main goal is to carve things in maps (like rivers) by digging hills along a curve.
Parameters: - hm (numpy.ndarray) – A numpy.ndarray formatted for heightmap functions.
- x (float) – The x position at the center of the new carving.
- y (float) – The y position at the center of the new carving.
- radius (float) – The size of the carving.
- height (float) – The height or depth of the hill to dig out.
-
tcod.
heightmap_get_interpolated_value
(hm: numpy.ndarray, x: float, y: float) → float[source]¶ Return the interpolated height at non integer coordinates.
Parameters: - hm (numpy.ndarray) – A numpy.ndarray formatted for heightmap functions.
- x (float) – A floating point x coordinate.
- y (float) – A floating point y coordinate.
Returns: The value at
x
,y
.Return type:
-
tcod.
heightmap_get_minmax
(hm: numpy.ndarray) → Tuple[float, float][source]¶ Return the min and max values of this heightmap.
Parameters: hm (numpy.ndarray) – A numpy.ndarray formatted for heightmap functions. Returns: The (min, max) values. Return type: Tuple[float, float] Deprecated since version 2.0: Use
hm.min()
orhm.max()
instead.
-
tcod.
heightmap_get_normal
(hm: numpy.ndarray, x: float, y: float, waterLevel: float) → Tuple[float, float, float][source]¶ Return the map normal at given coordinates.
Parameters: - hm (numpy.ndarray) – A numpy.ndarray formatted for heightmap functions.
- x (float) – The x coordinate.
- y (float) – The y coordinate.
- waterLevel (float) – The heightmap is considered flat below this value.
Returns: An (x, y, z) vector normal.
Return type:
-
tcod.
heightmap_get_slope
(hm: numpy.ndarray, x: int, y: int) → float[source]¶ Return the slope between 0 and (pi / 2) at given coordinates.
Parameters: - hm (numpy.ndarray) – A numpy.ndarray formatted for heightmap functions.
- x (int) – The x coordinate.
- y (int) – The y coordinate.
Returns: The steepness at
x
,y
. From 0 to (pi / 2)Return type:
-
tcod.
heightmap_get_value
(hm: numpy.ndarray, x: int, y: int) → float[source]¶ Return the value at
x
,y
in a heightmap.Deprecated since version 2.0: Access hm as a NumPy array instead.
-
tcod.
heightmap_has_land_on_border
(hm: numpy.ndarray, waterlevel: float) → bool[source]¶ Returns True if the map edges are below
waterlevel
, otherwise False.Parameters: - hm (numpy.ndarray) – A numpy.ndarray formatted for heightmap functions.
- waterLevel (float) – The water level to use.
Returns: True if the map edges are below
waterlevel
, otherwise False.Return type:
-
tcod.
heightmap_kernel_transform
(hm: numpy.ndarray, kernelsize: int, dx: Sequence[int], dy: Sequence[int], weight: Sequence[float], minLevel: float, maxLevel: float) → None[source]¶ Apply a generic transformation on the map, so that each resulting cell value is the weighted sum of several neighbour cells.
This can be used to smooth/sharpen the map.
Parameters: - hm (numpy.ndarray) – A numpy.ndarray formatted for heightmap functions.
- kernelsize (int) –
- Should be set to the length of the parameters::
- dx, dy, and weight.
- dx (Sequence[int]) – A sequence of x coorinates.
- dy (Sequence[int]) – A sequence of y coorinates.
- weight (Sequence[float]) – A sequence of kernelSize cells weight. The value of each neighbour cell is scaled by its corresponding weight
- minLevel (float) – No transformation will apply to cells below this value.
- maxLevel (float) – No transformation will apply to cells above this value.
See examples below for a simple horizontal smoothing kernel : replace value(x,y) with 0.33*value(x-1,y) + 0.33*value(x,y) + 0.33*value(x+1,y). To do this, you need a kernel of size 3 (the sum involves 3 surrounding cells). The dx,dy array will contain:
- dx=-1, dy=0 for cell (x-1, y)
- dx=1, dy=0 for cell (x+1, y)
- dx=0, dy=0 for cell (x, y)
- The weight array will contain 0.33 for each cell.
Example
>>> import numpy as np >>> heightmap = np.zeros((3, 3), dtype=np.float32) >>> heightmap[:,1] = 1 >>> dx = [-1, 1, 0] >>> dy = [0, 0, 0] >>> weight = [0.33, 0.33, 0.33] >>> tcod.heightmap_kernel_transform(heightmap, 3, dx, dy, weight, ... 0.0, 1.0)
-
tcod.
heightmap_lerp_hm
(hm1: numpy.ndarray, hm2: numpy.ndarray, hm3: numpy.ndarray, coef: float) → None[source]¶ Perform linear interpolation between two heightmaps storing the result in
hm3
.This is the same as doing
hm3[:] = hm1[:] + (hm2[:] - hm1[:]) * coef
Parameters: - hm1 (numpy.ndarray) – The first heightmap.
- hm2 (numpy.ndarray) – The second heightmap to add to the first.
- hm3 (numpy.ndarray) – A destination heightmap to store the result.
- coef (float) – The linear interpolation coefficient.
-
tcod.
heightmap_multiply_hm
(hm1: numpy.ndarray, hm2: numpy.ndarray, hm3: numpy.ndarray) → None[source]¶ Multiplies two heightmap’s together and stores the result in
hm3
.Parameters: - hm1 (numpy.ndarray) – The first heightmap.
- hm2 (numpy.ndarray) – The second heightmap to multiply with the first.
- hm3 (numpy.ndarray) – A destination heightmap to store the result.
Deprecated since version 2.0: Do
hm3[:] = hm1[:] * hm2[:]
instead. Alternatively you can doHeightMap(hm1.array[:] * hm2.array[:])
.
-
tcod.
heightmap_new
(w: int, h: int, order: str = 'C') → numpy.ndarray[source]¶ Return a new numpy.ndarray formatted for use with heightmap functions.
w and h are the width and height of the array.
order is given to the new NumPy array, it can be ‘C’ or ‘F’.
You can pass a NumPy array to any heightmap function as long as all the following are true:: * The array is 2 dimensional. * The array has the C_CONTIGUOUS or F_CONTIGUOUS flag. * The array’s dtype is
dtype.float32
.The returned NumPy array will fit all these conditions.
Changed in version 8.1: Added the order parameter.
-
tcod.
heightmap_normalize
(hm: numpy.ndarray, mi: float = 0.0, ma: float = 1.0) → None[source]¶ Normalize heightmap values between
mi
andma
.Parameters:
-
tcod.
heightmap_rain_erosion
(hm: numpy.ndarray, nbDrops: int, erosionCoef: float, sedimentationCoef: float, rnd: Optional[tcod.random.Random] = None) → None[source]¶ Simulate the effect of rain drops on the terrain, resulting in erosion.
nbDrops
should be at least hm.size.Parameters: - hm (numpy.ndarray) – A numpy.ndarray formatted for heightmap functions.
- nbDrops (int) – Number of rain drops to simulate.
- erosionCoef (float) – Amount of ground eroded on the drop’s path.
- sedimentationCoef (float) – Amount of ground deposited when the drops stops to flow.
- rnd (Optional[Random]) – A tcod.Random instance, or None.
-
tcod.
heightmap_scale
(hm: numpy.ndarray, value: float) → None[source]¶ Multiply all items on this heightmap by value.
Parameters: - hm (numpy.ndarray) – A numpy.ndarray formatted for heightmap functions.
- value (float) – A number to scale this heightmap by.
Deprecated since version 2.0: Do
hm[:] *= value
instead.
-
tcod.
heightmap_scale_fbm
(hm: numpy.ndarray, noise: tcod.noise.Noise, mulx: float, muly: float, addx: float, addy: float, octaves: float, delta: float, scale: float) → None[source]¶ Multiply the heighmap values with FBM noise.
Parameters: - hm (numpy.ndarray) – A numpy.ndarray formatted for heightmap functions.
- noise (Noise) – A Noise instance.
- mulx (float) – Scaling of each x coordinate.
- muly (float) – Scaling of each y coordinate.
- addx (float) – Translation of each x coordinate.
- addy (float) – Translation of each y coordinate.
- octaves (float) – Number of octaves in the FBM sum.
- delta (float) – The value added to all heightmap cells.
- scale (float) – The noise value is scaled with this parameter.
Deprecated since version 8.1: An equivalent array of noise samples can be taken using a method such as
Noise.sample_ogrid
.
image¶
-
tcod.
image_load
(filename: str) → tcod.image.Image[source]¶ Load an image file into an Image instance and return it.
Parameters: filename (AnyStr) – Path to a .bmp or .png image file.
-
tcod.
image_from_console
(console: tcod.console.Console) → tcod.image.Image[source]¶ Return an Image with a Consoles pixel data.
This effectively takes a screen-shot of the Console.
Parameters: console (Console) – Any Console instance.
-
tcod.
image_blit
(image: tcod.image.Image, console: tcod.console.Console, x: float, y: float, bkgnd_flag: int, scalex: float, scaley: float, angle: float) → None[source]¶
-
tcod.
image_blit_2x
(image: tcod.image.Image, console: tcod.console.Console, dx: int, dy: int, sx: int = 0, sy: int = 0, w: int = -1, h: int = -1) → None[source]¶
-
tcod.
image_blit_rect
(image: tcod.image.Image, console: tcod.console.Console, x: int, y: int, w: int, h: int, bkgnd_flag: int) → None[source]¶
-
tcod.
image_delete
(image: tcod.image.Image) → None[source]¶ Does nothing. libtcod objects are managed by Python’s garbage collector.
This function exists for backwards compatibility with libtcodpy.
-
tcod.
image_get_mipmap_pixel
(image: tcod.image.Image, x0: float, y0: float, x1: float, y1: float) → Tuple[int, int, int][source]¶
line¶
-
tcod.
line_init
(xo: int, yo: int, xd: int, yd: int) → None[source]¶ Initilize a line whose points will be returned by line_step.
This function does not return anything on its own.
Does not include the origin point.
Parameters: Deprecated since version 2.0: Use line_iter instead.
-
tcod.
line_step
() → Union[Tuple[int, int], Tuple[None, None]][source]¶ After calling line_init returns (x, y) points of the line.
Once all points are exhausted this function will return (None, None)
Returns: The next (x, y) point of the line setup by line_init, or (None, None) if there are no more points. Return type: Union[Tuple[int, int], Tuple[None, None]] Deprecated since version 2.0: Use line_iter instead.
-
tcod.
line
(xo: int, yo: int, xd: int, yd: int, py_callback: Callable[[int, int], bool]) → bool[source]¶ Iterate over a line using a callback function.
Your callback function will take x and y parameters and return True to continue iteration or False to stop iteration and return.
This function includes both the start and end points.
Parameters: Returns: - False if the callback cancels the line interation by
returning False or None, otherwise True.
Return type: Deprecated since version 2.0: Use line_iter instead.
-
tcod.
line_iter
(xo: int, yo: int, xd: int, yd: int) → Iterator[Tuple[int, int]][source]¶ returns an Iterable
This Iterable does not include the origin point.
Parameters: Returns: An Iterable of (x,y) points.
Return type: Deprecated since version 11.14: This function was replaced by
tcod.los.bresenham
.
-
tcod.
line_where
(x1: int, y1: int, x2: int, y2: int, inclusive: bool = True) → Tuple[numpy.ndarray, numpy.ndarray][source]¶ Return a NumPy index array following a Bresenham line.
If inclusive is true then the start point is included in the result.
Example
>>> where = tcod.line_where(1, 0, 3, 4) >>> where (array([1, 1, 2, 2, 3]...), array([0, 1, 2, 3, 4]...)) >>> array = np.zeros((5, 5), dtype=np.int32) >>> array[where] = np.arange(len(where[0])) + 1 >>> array array([[0, 0, 0, 0, 0], [1, 2, 0, 0, 0], [0, 0, 3, 4, 0], [0, 0, 0, 0, 5], [0, 0, 0, 0, 0]]...)
New in version 4.6.
Deprecated since version 11.14: This function was replaced by
tcod.los.bresenham
.
map¶
-
tcod.
map_clear
(m: tcod.map.Map, transparent: bool = False, walkable: bool = False) → None[source]¶ Change all map cells to a specific value.
Deprecated since version 4.5: Use
tcod.map.Map.transparent
andtcod.map.Map.walkable
arrays to set these properties.
-
tcod.
map_compute_fov
(m: tcod.map.Map, x: int, y: int, radius: int = 0, light_walls: bool = True, algo: int = 12) → None[source]¶ Compute the field-of-view for a map instance.
Deprecated since version 4.5: Use
tcod.map.Map.compute_fov
instead.
-
tcod.
map_copy
(source: tcod.map.Map, dest: tcod.map.Map) → None[source]¶ Copy map data from source to dest.
Deprecated since version 4.5: Use Python’s copy module, or see
tcod.map.Map
and assign between array attributes manually.
-
tcod.
map_delete
(m: tcod.map.Map) → None[source]¶ Does nothing. libtcod objects are managed by Python’s garbage collector.
This function exists for backwards compatibility with libtcodpy.
-
tcod.
map_get_height
(map: tcod.map.Map) → int[source]¶ Return the height of a map.
Deprecated since version 4.5: Check the
tcod.map.Map.height
attribute instead.
-
tcod.
map_get_width
(map: tcod.map.Map) → int[source]¶ Return the width of a map.
Deprecated since version 4.5: Check the
tcod.map.Map.width
attribute instead.
-
tcod.
map_is_in_fov
(m: tcod.map.Map, x: int, y: int) → bool[source]¶ Return True if the cell at x,y is lit by the last field-of-view algorithm.
Note
This function is slow.
Deprecated since version 4.5: Use
tcod.map.Map.fov
to check this property.
-
tcod.
map_is_transparent
(m: tcod.map.Map, x: int, y: int) → bool[source]¶ Note
This function is slow.
Deprecated since version 4.5: Use
tcod.map.Map.transparent
to check this property.
-
tcod.
map_is_walkable
(m: tcod.map.Map, x: int, y: int) → bool[source]¶ Note
This function is slow.
Deprecated since version 4.5: Use
tcod.map.Map.walkable
to check this property.
-
tcod.
map_new
(w: int, h: int) → tcod.map.Map[source]¶ Return a
tcod.map.Map
with a width and height.
-
tcod.
map_set_properties
(m: tcod.map.Map, x: int, y: int, isTrans: bool, isWalk: bool) → None[source]¶ Set the properties of a single cell.
Note
This function is slow.
Deprecated since version 4.5: Use
tcod.map.Map.transparent
andtcod.map.Map.walkable
arrays to set these properties.
mouse¶
namegen¶
noise¶
-
tcod.
noise_delete
(n: tcod.noise.Noise) → None[source]¶ Does nothing. libtcod objects are managed by Python’s garbage collector.
This function exists for backwards compatibility with libtcodpy.
-
tcod.
noise_get
(n: tcod.noise.Noise, f: Sequence[float], typ: int = 0) → float[source]¶ Return the noise value sampled from the
f
coordinate.f
should be a tuple or list with a length matchingNoise.dimensions
. Iff
is shoerter thanNoise.dimensions
the missing coordinates will be filled with zeros.Parameters: Returns: The sampled noise value.
Return type:
-
tcod.
noise_get_fbm
(n: tcod.noise.Noise, f: Sequence[float], oc: float, typ: int = 0) → float[source]¶ Return the fractal Brownian motion sampled from the
f
coordinate.Parameters: Returns: The sampled noise value.
Return type:
-
tcod.
noise_get_turbulence
(n: tcod.noise.Noise, f: Sequence[float], oc: float, typ: int = 0) → float[source]¶ Return the turbulence noise sampled from the
f
coordinate.Parameters: Returns: The sampled noise value.
Return type:
parser¶
random¶
-
tcod.
random_delete
(rnd: tcod.random.Random) → None[source]¶ Does nothing. libtcod objects are managed by Python’s garbage collector.
This function exists for backwards compatibility with libtcodpy.
-
tcod.
random_get_double
(rnd: Optional[tcod.random.Random], mi: float, ma: float) → float[source]¶ Return a random float in the range:
mi
<= n <=ma
.Deprecated since version 2.0: Use
random_get_float
instead. Both funtions return a double precision float.
-
tcod.
random_get_double_mean
(rnd: Optional[tcod.random.Random], mi: float, ma: float, mean: float) → float[source]¶ Return a random weighted float in the range:
mi
<= n <=ma
.Deprecated since version 2.0: Use
random_get_float_mean
instead. Both funtions return a double precision float.
-
tcod.
random_get_float
(rnd: Optional[tcod.random.Random], mi: float, ma: float) → float[source]¶ Return a random float in the range:
mi
<= n <=ma
.The result is affected by calls to
random_set_distribution
.Parameters: Returns: - A random double precision float
in the range
mi
<= n <=ma
.
Return type:
-
tcod.
random_get_float_mean
(rnd: Optional[tcod.random.Random], mi: float, ma: float, mean: float) → float[source]¶ Return a random weighted float in the range:
mi
<= n <=ma
.The result is affacted by calls to
random_set_distribution
.Parameters: Returns: - A random weighted double precision float
in the range
mi
<= n <=ma
.
Return type:
-
tcod.
random_get_instance
() → tcod.random.Random[source]¶ Return the default Random instance.
Returns: A Random instance using the default random number generator. Return type: Random
-
tcod.
random_get_int
(rnd: Optional[tcod.random.Random], mi: int, ma: int) → int[source]¶ Return a random integer in the range:
mi
<= n <=ma
.The result is affected by calls to
random_set_distribution
.Parameters: Returns: A random integer in the range
mi
<= n <=ma
.Return type:
-
tcod.
random_get_int_mean
(rnd: Optional[tcod.random.Random], mi: int, ma: int, mean: int) → int[source]¶ Return a random weighted integer in the range:
mi
<= n <=ma
.The result is affacted by calls to
random_set_distribution
.Parameters: Returns: A random weighted integer in the range
mi
<= n <=ma
.Return type:
-
tcod.
random_new
(algo: int = 1) → tcod.random.Random[source]¶ Return a new Random instance. Using
algo
.Parameters: algo (int) – The random number algorithm to use. Returns: A new Random instance using the given algorithm. Return type: Random
-
tcod.
random_new_from_seed
(seed: Hashable, algo: int = 1) → tcod.random.Random[source]¶ Return a new Random instance. Using the given
seed
andalgo
.Parameters: - seed (Hashable) – The RNG seed. Should be a 32-bit integer, but any hashable object is accepted.
- algo (int) – The random number algorithm to use.
Returns: A new Random instance using the given algorithm.
Return type:
-
tcod.
random_restore
(rnd: Optional[tcod.random.Random], backup: tcod.random.Random) → None[source]¶ Restore a random number generator from a backed up copy.
Parameters: Deprecated since version 8.4: You can use the standard library copy and pickle modules to save a random state.
-
tcod.
random_save
(rnd: Optional[tcod.random.Random]) → tcod.random.Random[source]¶ Return a copy of a random number generator.
Deprecated since version 8.4: You can use the standard library copy and pickle modules to save a random state.
struct¶
other¶
-
class
tcod.
ConsoleBuffer
(width: int, height: int, back_r: int = 0, back_g: int = 0, back_b: int = 0, fore_r: int = 0, fore_g: int = 0, fore_b: int = 0, char: str = ' ')[source]¶ Simple console that allows direct (fast) access to cells. simplifies use of the “fill” functions.
Deprecated since version 6.0: Console array attributes perform better than this class.
Parameters: - width (int) – Width of the new ConsoleBuffer.
- height (int) – Height of the new ConsoleBuffer.
- back_r (int) – Red background color, from 0 to 255.
- back_g (int) – Green background color, from 0 to 255.
- back_b (int) – Blue background color, from 0 to 255.
- fore_r (int) – Red foreground color, from 0 to 255.
- fore_g (int) – Green foreground color, from 0 to 255.
- fore_b (int) – Blue foreground color, from 0 to 255.
- char (AnyStr) – A single character str or bytes object.
-
blit
(dest: tcod.console.Console, fill_fore: bool = True, fill_back: bool = True) → None[source]¶ Use libtcod’s “fill” functions to write the buffer to a console.
Parameters:
-
clear
(back_r: int = 0, back_g: int = 0, back_b: int = 0, fore_r: int = 0, fore_g: int = 0, fore_b: int = 0, char: str = ' ') → None[source]¶ Clears the console. Values to fill it with are optional, defaults to black with no characters.
Parameters: - back_r (int) – Red background color, from 0 to 255.
- back_g (int) – Green background color, from 0 to 255.
- back_b (int) – Blue background color, from 0 to 255.
- fore_r (int) – Red foreground color, from 0 to 255.
- fore_g (int) – Green foreground color, from 0 to 255.
- fore_b (int) – Blue foreground color, from 0 to 255.
- char (AnyStr) – A single character str or bytes object.
-
copy
() → tcod.libtcodpy.ConsoleBuffer[source]¶ Returns a copy of this ConsoleBuffer.
Returns: A new ConsoleBuffer copy. Return type: ConsoleBuffer
-
set
(x: int, y: int, back_r: int, back_g: int, back_b: int, fore_r: int, fore_g: int, fore_b: int, char: str) → None[source]¶ Set the background color, foreground color and character of one cell.
Parameters: - x (int) – X position to change.
- y (int) – Y position to change.
- back_r (int) – Red background color, from 0 to 255.
- back_g (int) – Green background color, from 0 to 255.
- back_b (int) – Blue background color, from 0 to 255.
- fore_r (int) – Red foreground color, from 0 to 255.
- fore_g (int) – Green foreground color, from 0 to 255.
- fore_b (int) – Blue foreground color, from 0 to 255.
- char (AnyStr) – A single character str or bytes object.
-
set_back
(x: int, y: int, r: int, g: int, b: int) → None[source]¶ Set the background color of one cell.
Parameters: