John McCardle
7621ae35bb
This commit enables McRogueFace to compile without SFML dependencies when built with -DMCRF_HEADLESS, a prerequisite for Emscripten/WebAssembly support. Changes: - Add src/platform/HeadlessTypes.h (~900 lines of SFML type stubs) - Consolidate all SFML includes through src/Common.h (15 files fixed) - Wrap ImGui-SFML with #ifndef MCRF_HEADLESS guards - Disable debug console/explorer in headless builds - Add comprehensive research document: docs/EMSCRIPTEN_RESEARCH.md The headless build compiles successfully but uses stub implementations that return failure/no-op. This proves the abstraction boundary is clean and enables future work on alternative backends (VRSFML, Emscripten). What still works in headless mode: - Python interpreter and script execution - libtcod integrations (pathfinding, FOV, noise, BSP, heightmaps) - Timer system and scene management - All game logic and data structures Build commands: Normal: make Headless: cmake .. -DCMAKE_CXX_FLAGS="-DMCRF_HEADLESS" && make Addresses #158 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
43 lines
1.7 KiB
C++
43 lines
1.7 KiB
C++
#pragma once
|
|
#include "Common.h"
|
|
#include "Python.h"
|
|
|
|
// Module-level Key enum class (created at runtime using Python's IntEnum)
|
|
// Stored as a module attribute: mcrfpy.Key
|
|
//
|
|
// Values map to sf::Keyboard::Key enum values.
|
|
// The enum compares equal to both its name ("ESCAPE") and legacy string ("Escape")
|
|
//
|
|
// Naming convention:
|
|
// - Letters: A, B, C, ... Z
|
|
// - Numbers: NUM_0, NUM_1, ... NUM_9 (top row)
|
|
// - Numpad: NUMPAD_0, NUMPAD_1, ... NUMPAD_9
|
|
// - Function keys: F1, F2, ... F15
|
|
// - Modifiers: LEFT_SHIFT, RIGHT_SHIFT, LEFT_CONTROL, RIGHT_CONTROL, etc.
|
|
// - Navigation: LEFT, RIGHT, UP, DOWN, HOME, END, PAGE_UP, PAGE_DOWN
|
|
// - Special: ESCAPE, ENTER, SPACE, TAB, BACKSPACE, DELETE, INSERT, PAUSE
|
|
|
|
class PyKey {
|
|
public:
|
|
// Create the Key enum class and add to module
|
|
// Returns the enum class (new reference), or NULL on error
|
|
static PyObject* create_enum_class(PyObject* module);
|
|
|
|
// Helper to extract key from Python arg
|
|
// Accepts Key enum, string (for backwards compatibility), int, or None
|
|
// Returns 1 on success, 0 on error (with exception set)
|
|
static int from_arg(PyObject* arg, sf::Keyboard::Key* out_key);
|
|
|
|
// Convert sf::Keyboard::Key to legacy string name (for passing to callbacks)
|
|
static const char* to_legacy_string(sf::Keyboard::Key key);
|
|
|
|
// Convert legacy string to sf::Keyboard::Key
|
|
// Returns sf::Keyboard::Unknown if not found
|
|
static sf::Keyboard::Key from_legacy_string(const char* name);
|
|
|
|
// Cached reference to the Key enum class for fast type checking
|
|
static PyObject* key_enum_class;
|
|
|
|
// Number of keys (matches sf::Keyboard::KeyCount)
|
|
static const int NUM_KEYS = sf::Keyboard::KeyCount;
|
|
};
|