john/McRogueFace
1
0
Fork 0
Code Issues 41 Pull requests Projects 1 Releases Wiki Activity

[Proc Gen] HeightMap - Core class with scalar operations #193

New issue
Closed
opened 2026-01-12 00:07:42 +00:00 by john · 0 comments
john commented 2026-01-12 00:07:42 +00:00
Owner
Copy link

Parent Issue: #192

Overview

Implement the foundational HeightMap class - a 2D grid of float values that serves as the universal canvas for procedural generation.

Specification

Constructor

HeightMap(size: tuple[int, int], fill: float = 0.0)

Properties

Property Type Description
size (int, int) Read-only. Width and height of the heightmap.

Scalar Operations

All operations mutate in place and return self for chaining.

def fill(self, value: float) -> HeightMap
def clear(self) -> HeightMap  # Equivalent to fill(0.0)
def add_constant(self, value: float) -> HeightMap
def scale(self, factor: float) -> HeightMap
def clamp(self, min: float = 0.0, max: float = 1.0) -> HeightMap
def normalize(self, min: float = 0.0, max: float = 1.0) -> HeightMap

Implementation Notes

  • Wrap TCODHeightMap internally
  • Store as contiguous float array (4 bytes per cell)
  • Size is immutable after construction
  • normalize() maps to TCOD_heightmap_normalize

Acceptance Criteria

  • HeightMap can be constructed with size tuple
  • size property returns correct dimensions
  • All scalar operations work and return self
  • Chaining works: hmap.fill(0.5).scale(2.0).clamp(0.0, 1.0)
  • Unit tests in tests/unit/test_heightmap_basic.py
**Parent Issue:** #192 ## Overview Implement the foundational `HeightMap` class - a 2D grid of float values that serves as the universal canvas for procedural generation. ## Specification ### Constructor ```python HeightMap(size: tuple[int, int], fill: float = 0.0) ``` ### Properties | Property | Type | Description | |----------|------|-------------| | `size` | `(int, int)` | Read-only. Width and height of the heightmap. | ### Scalar Operations All operations mutate in place and return `self` for chaining. ```python def fill(self, value: float) -> HeightMap def clear(self) -> HeightMap # Equivalent to fill(0.0) def add_constant(self, value: float) -> HeightMap def scale(self, factor: float) -> HeightMap def clamp(self, min: float = 0.0, max: float = 1.0) -> HeightMap def normalize(self, min: float = 0.0, max: float = 1.0) -> HeightMap ``` ## Implementation Notes - Wrap `TCODHeightMap` internally - Store as contiguous float array (4 bytes per cell) - Size is immutable after construction - `normalize()` maps to `TCOD_heightmap_normalize` ## Acceptance Criteria - [ ] `HeightMap` can be constructed with size tuple - [ ] `size` property returns correct dimensions - [ ] All scalar operations work and return self - [ ] Chaining works: `hmap.fill(0.5).scale(2.0).clamp(0.0, 1.0)` - [ ] Unit tests in `tests/unit/test_heightmap_basic.py`
john closed this issue 2026-01-12 01:28:38 +00:00
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
master
rogueliketutorial25
alpha_presentable
alpha_streamline_2
alpha_streamline_1
interpreter_mode
grid_entity_integration
reprs_and_member_names
break_up_ui_h
standardize_font_handling
standardize_vector_handling
standardize_color_handling
standardize_texture_handling
raii_pyobjects
rebase-for-7DRL_Feb-2024
engjam_uicollection
engjam_ui_overhaul
No results found.
Labels
Clear labels   
Alpha Release Requirement

This issue is a blocker to 0.1 Alpha release of McRogueFace.

  
Bugfix

   
Demo Target

Functionality to demonstrate; Depends on new features, but this issue isn't for writing them.

  
Documentation

   
Major Feature

Significant time and effort required.

  
Minor Feature

Some effort required to create or overhaul functionality.

  
priority:tier1-active

Current development focus - critical path to v1.0

  
priority:tier2-foundation

Important foundation work - not blocking v1.0

  
priority:tier3-future

Future features - deferred until after v1.0

  
priority:tier4-deferred

   
Refactoring & Cleanup

no new functionality, just improving the codebase.

  
system:animation

Animation and property interpolation

  
system:documentation

Documentation infrastructure

  
system:grid

Grid system and spatial containers

  
system:input

Input handling and events

  
system:performance

Performance optimization and profiling

  
system:procgen

Procedural Generation (Noise, BSP, Heightmap)

  
system:python-binding

Python/C++ binding layer

  
system:rendering

Rendering pipeline and visuals

  
system:ui-hierarchy

UI component hierarchy and composition

  
Tiny Feature

quick and easy - a few lines or with little interconnection around the codebase

  
workflow:blocked

Blocked by other work - waiting on dependencies

  
workflow:needs-benchmark

Needs performance testing and benchmarks

  
workflow:needs-documentation

Needs documentation before or after implementation

No labels
Alpha Release Requirement
Bugfix
Demo Target
Documentation
Major Feature
Minor Feature
priority:tier1-active
priority:tier2-foundation
priority:tier3-future
priority:tier4-deferred
Refactoring & Cleanup
system:animation
system:documentation
system:grid
system:input
system:performance
system:procgen
system:python-binding
system:rendering
system:ui-hierarchy
Tiny Feature
workflow:blocked
workflow:needs-benchmark
workflow:needs-documentation
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Procedural Generation for 7DRL 2026
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Blocks
#194 [Proc Gen] HeightMap - Combination operations
john/McRogueFace
#195 [Proc Gen] HeightMap - Terrain generation methods
john/McRogueFace
#196 [Proc Gen] HeightMap - Query methods
john/McRogueFace
#197 [Proc Gen] HeightMap - Threshold operations
john/McRogueFace
#198 [Proc Gen] HeightMap - kernel_transform
john/McRogueFace
#199 [Proc Gen] Grid - apply_threshold and apply_ranges for walkable/transparent
john/McRogueFace
#200 [Proc Gen] TileLayer - apply_threshold and apply_ranges for tile indices
john/McRogueFace
#201 [Proc Gen] ColorLayer - apply_threshold, apply_gradient, apply_ranges
john/McRogueFace
#206 [Proc Gen] BSP.to_heightmap and BSPMap class
john/McRogueFace
#208 [Proc Gen] NoiseSource.sample and NoiseSample class
john/McRogueFace
#209 [Proc Gen] HeightMap - Direct source sampling (add_noise, add_bsp)
john/McRogueFace
Reference
john/McRogueFace#193
No description provided.