Cesarus85--ringfall-mjolnir-vr/docs/common_constants.md

Common constants and representation reference

Verified against canonical on 2026-09-08. Start here before guessing literals.

This is a lookup guide, not a new constants owner. Most rows record high-use names that already have canonical owners; the supplied-source crosswalk is explicitly separate. Future reconstructions should include the owning header and use the existing symbol or macro; they should not duplicate these declarations in a translation unit merely to obtain a desired code shape.

Confirmed below means the value and spelling are present in the named canonical owner. Float bits show the rounded binary32 representation; tag immediates use the pinned MSVC convention. January corroboration is called out explicitly below. A recognizable bit pattern is a lookup clue, not proof of which source expression produced it. Context-specific means a value belongs to the stated enum, storage type, or algorithm, not an unrelated global owner.

Core values and representations (confirmed)

Purpose	Canonical symbol / type	Value or representation	Owning source	Important boundary
Boolean true/false	TRUE, FALSE	1, 0	source/cseries/cseries.h	Use these for the project's one-byte boolean APIs. A boolean i386 return may define only AL; a void return promises no value. Do not require unrelated upper EAX bits.
Invalid signed index/handle	NONE	-1 (0xFFFFFFFF as a 32-bit long)	source/cseries/cseries.h	This is not NULL. Confirm the destination width: a byte or word sentinel has the narrowed all-ones representation, and some APIs use zero as a distinct valid or invalid value.
Simulation rate	TICKS_PER_SECOND, ACTUAL_TICKS_PER_SECOND	30, 30	source/cseries/cseries.h	Express seconds-to-ticks as seconds * TICKS_PER_SECOND; express per-tick scale as 1.0f / TICKS_PER_SECOND. Do not invent a SECONDS_PER_TICK owner. The latter folds to float bits 0x3D088889.
Wall-clock unit	MILLISECONDS_PER_SECOND	1000	source/cseries/cseries.h	Do not mix millisecond tag fields with 30 Hz game ticks. Existing code explicitly converts when needed.
Display cadence	VBLANKS_PER_SECOND	60	source/cseries/cseries.h	Vblanks are not simulation ticks even though both are integer rates.
Integer widths	LONG_BITS, SHORT_BITS, CHAR_BITS	32, 16, 8	source/cseries/cseries.h	These describe the January/Win32 ABI. Preserve signedness as well as width.
Integer extrema	LONG_MAX, LONG_MIN, UNSIGNED_LONG_MAX, SHORT_MAX, SHORT_MIN, UNSIGNED_SHORT_MAX	2147483647, -2147483648, 0xFFFFFFFF, 32767, -32768, 0xFFFF	source/cseries/cseries.h	Prefer the named bound. UNSIGNED_LONG_MAX is also the canonical all-object mask, but that does not make it a universal sentinel.
Scalar real	real	typedef float real (4-byte IEEE-754 binary32 in target ABI)	source/cseries/cseries.h	Use f suffixes for ordinary real constants. Use double only where the genuine API or default vararg promotion requires it.
Engine boolean	boolean	typedef byte boolean; byte is unsigned char	source/cseries/cseries.h	It is one byte, not C/C++ bool and not a four-byte long. This affects fields, parameters, stack snapshots, and return checks.
Tag word	tag	typedef unsigned long tag (32 bits in target ABI)	source/cseries/cseries.h	Preserve the four-character group token and the unsigned 32-bit type.
Coordinate axes	_x, _y, _z	0, 1, 2	source/cseries/cseries.h	Use these only as component/projection indices. They are not vector values or bit masks.
Geometric tolerance	_real_epsilon	0.0001f, binary32 bits 0x38D1B717	source/math/real_math.h	This is not a universal replacement for exact-zero tests. January functions use both epsilon and exact 0.0f; preserve the observed predicate and NaN behavior.
Pi	_pi	(real)M_PI, binary32 bits 0x40490FDB	source/math/real_math.h	Use the project cast rather than a hand-rounded decimal when the source works in real.
Angle conversion	DEGREES_TO_RADIANS, RADIANS_TO_DEGREES	((real)angle) * _pi / 180.f or ((real)angle) * 180.f / _pi	source/math/real_math.h	Angles stored in tags are not uniformly degrees or radians. First authenticate the field's unit; then use the owner macro. Expression order can affect exact float bytes.
Finite real envelope	REAL_MIN, REAL_MAX	-3.4028235e38f, 3.4028235e38f	source/math/real_math.h	REAL_MIN here is the most-negative finite bound, not the C-library meaning “smallest positive normal.”

January examples that corroborate the float rows are the __real@38d1b717, __real@41f00000, and __real@3d088889 relocations in build/split/source/objects/damage.obj. They represent _real_epsilon, (real)TICKS_PER_SECOND, and 1.0f / TICKS_PER_SECOND; they do not justify replacing the source-level owners with hexadecimal literals.

Canonical macros whose semantics matter

Macro	Definition owner	Correct use	Pitfall
MIN(a,b), MAX(a,b)	source/cseries/cseries.h	Ordinary project min/max spelling when January establishes the same comparison and argument order.	Each expression can be evaluated more than once. Argument order controls signed-zero and NaN outcomes: do not normalize or swap operands merely because finite results look equivalent.
FLOOR, CEILING, PIN	source/cseries/cseries.h	Named lower/upper/clamp operations.	PIN is a macro composition, not an IEEE fminf/fmaxf substitute. It may evaluate the value repeatedly and lets a NaN value pass through under its current ordering.
FLAG(bit)	source/cseries/cseries.h	Convert an enum bit index to a mask.	Most _..._bit enum members are indices, not masks. Do not apply FLAG again to an existing _..._mask_* value. Preserve the owning integer width, especially near bit 31.
TEST_FLAG, SET_FLAG	source/cseries/cseries.h	Test or mutate a named bit in the authenticated field.	Do not replace an enum bit with a raw hex mask. Avoid side-effecting lvalues/expressions because these are macros.
VALID_FLAGS(flags,bits)	source/cseries/cseries.h	Validate that no bit at or above the declared count is set.	bits is a count, not a mask; signedness and shift width matter.
BIT_VECTOR_SIZE_IN_LONGS, BIT_VECTOR_TEST_FLAG, BIT_VECTOR_SET_FLAG	source/cseries/cseries.h	Long-word-packed bit vectors, 32 flags per long.	The macros index a long array. Do not silently cast an original byte * API to this representation. A byte-buffer use needs independent owner/caller evidence, as documented for the collision BSP boundary in docs/object_matching_logs/collision_bsp_obj_sphere_cluster_20260904.md.
NUMBEROF(array)	source/cseries/cseries.h	Compile-time count of an actual array in the same scope.	On a pointer it returns a pointer-size ratio, not the pointee count.
VALID_INDEX(index,count)	source/cseries/cseries.h	Signed lower-bound and upper-bound check.	Preserve the signed type. Replacing it with an unsigned comparison can alter code shape and invalid-negative behavior.
DATUM_INDEX_NEW, DATUM_INDEX_TO_ABSOLUTE_INDEX, DATUM_INDEX_TO_IDENTIFIER	source/cseries/cseries.h	Construct or split the 16-bit absolute index / 16-bit identifier handle representation.	A datum handle is not a plain array index. Mask before indexing; do not discard the identifier except at a proven boundary.
TAG_BLOCK_GET_ELEMENT	source/tag_files/tag_groups.h	Typed access through tag_block_get_element_with_size(..., sizeof(type)).	The type and element size are part of the runtime contract. Avoid a raw address + index*stride replacement.

Tag strings and common group IDs (confirmed)

TAG_STRING_LENGTH is 31 (source/tag_files/tag_files.h). A canonical fixed tag string buffer that includes its terminator is therefore usually char name[TAG_STRING_LENGTH + 1], or 32 bytes. The constant is a payload limit, not permission to omit the final NUL.

MSVC packs the following four-character constants into the shown immediate value. Always write the named owner; the hex form is provided only to read disassembly and relocations. On little-endian x86 the bytes in memory appear least-significant byte first.

Domain	Symbol	Source token / i386 immediate	Owner
Game globals	GAME_GLOBALS_TAG	'matg' / 0x6D617467	source/game/game_globals.h
Scenario	SCENARIO_TAG	'scnr' / 0x73636E72	source/scenario/scenario_definitions.h
Structure BSP	STRUCTURE_BSP_TAG	'sbsp' / 0x73627370	source/structures/structure_bsp_definitions.h
Base object definition	OBJECT_DEFINITION_TAG	'obje' / 0x6F626A65	source/objects/object_definitions.h
Damage effect	DAMAGE_EFFECT_DEFINITION_TAG	'jpt!' / 0x6A707421	source/objects/damage_effect_definitions.h
Bitmap	BITMAP_GROUP_TAG	'bitm' / 0x6269746D	source/bitmaps/bitmap_group.h
Sound	SOUND_DEFINITION_TAG	'snd!' / 0x736E6421	source/sound/sound_definitions.h

Four-character C constants are implementation-defined outside this compiler context. Do not byte-swap them manually or replace a typed getter such as object_definition_get with a raw tag_get call only to expose the numeric immediate.

Common engine enums and limits (confirmed, domain-specific)

Domain	Symbol(s)	Value	Owner and boundary
Local rendering/input players	MAXIMUM_LOCAL_PLAYERS	4	source/game/players.h. This is not the network/player-datum capacity.
Network join token	NETWORK_JOIN_GAME_TOKEN_SIZE	16	source/networking/network_messages.h. Protocol byte count, corroborated by the supplied source and January's generator/callers; restored in the canonical protocol owner, not a claim about the absent original header.
Network header direction	_byte_order_host, _byte_order_network	0, 1	source/bungie_net/common/message_header.h. January inbound reads pass 0; outbound connection/key/rejection writes pass 1. The former inferred host/network labels were reversed; the corrected names preserve every caller's immediate and emitted code.
Connection creation flags	_connection_create_server_bit, _connection_create_clientside_client_bit, _connection_create_serverside_client_bit	Bit indices 0, 1, 2; masks 1, 2, 4	source/networking/network_connection.h. Use FLAG at creation calls; these are not the separate closed/stale state bits.
Network game ports	NETWORK_GAME_SERVER_PORT, NETWORK_GAME_CLIENT_PORT	0x141E, 0x141F / 5150, 5151	source/networking/network_game_protocol.h. Shared only by actual protocol consumers; values are not transport-type ordinals.
Server rejection reasons	_rejection_code_version_too_old through _rejection_code_blacklisted_machine; NUMBER_OF_SERVER_REJECTION_CODES	Reasons 0..6, count 7; game full 4	source/networking/network_game_protocol.h. Serialized rejection field is a word; count is an exclusive bound, not a valid reason.
Connection timeout disabled	_connection_dont_timeout	0	source/networking/network_connection.h. The idle API tests a nonzero timeout before enforcing it. This literal is not the separate global_connection_dont_timeout debug boolean. Name from supplied source, value from January, header placement reconstructed.
Public-endpoint datagram capacity	DATAGRAM_MAXIMUM_SIZE	400 / 0x190 bytes	source/networking/network_connection.h. Shared connection/provider limit, distinct from the reliable-message receive capacity below. network_connection_read takes a word * size; a DWORD stack-slot initialization does not make this a 32-bit API.
IPv4 loopback address	IPV4_LOOPBACK_ADDRESS	0x7F000001	source/bungie_net/network/transport_address_constants.h. Source-attested spelling and January compare immediate. Use in the transport address's host-order IPv4 field, not as four already serialized network bytes. This narrow shared header is included by the actual client/server consumers.
Client/server receive buffer	MAXIMUM_NETWORK_MESSAGE_SIZE	0x800 / 2048 bytes	Local manager enums in server and client. January proves the buffer and word-sized capacity reset. This is not MAXIMUM_MESSAGE_SIZE=0xFFF in the separate Bungie-net message header. A word-aligned array preserves the receiving handler's genuine word-pointer contract.
Difficulty	_game_difficulty_level_easy, _game_difficulty_level_normal, _game_difficulty_level_hard, _game_difficulty_level_impossible	0, 1, 2, 3	source/game/game.h. Use the enum; a raw ordinal is ambiguous at a call site.
Campaign team	_game_team_default, _game_team_player, _game_team_human, _game_team_covenant, _game_team_flood, _game_team_sentinel	0 through 5	source/game/game.h. Multiplayer _team_red=0, _team_blue=1 intentionally overlaps numerically; the field/API determines the namespace.
Object types	_object_type_biped through _object_type_sound_scenery	0 through 11; NUMBER_OF_OBJECT_TYPES=12	source/objects/object_types.h. Values are ordinals used by object headers and switch statements.
Object masks	_object_mask_unit, _object_mask_item, _object_mask_device, _object_mask_all	0x3, 0x1C, 0x380, 0xFFFFFFFF	source/objects/object_types.h. These are already masks; test them against an object type with the established TEST_FLAG(mask, type) convention.
Object capacity	MAXIMUM_OBJECTS_PER_MAP	2048	source/objects/objects.h. Capacity is not the current datum count.
Rendered-object capacity	MAXIMUM_RENDERED_OBJECTS	256	source/objects/objects.h. Do not use it to size the master object datum array.
UI deletion input-inhibit mask	WIDGET_DELETED_PLAYER_CONTROL_INHIBIT_FLAGS	0x0FFF	TU-local owner in source/interface/ui_widget.c. Passed as a word to player_control_inhibit_buttons when a root widget with a non-NONE local-player index is deleted. It fences the evidenced low twelve discrete action buttons until each held button is released; it does not cover analog movement/look, and it is not UNSIGNED_SHORT_MAX, a universal all-buttons mask, or a bit index for FLAG.
Markers/regions/attachments	MAXIMUM_MARKERS_PER_OBJECT, MAXIMUM_REGIONS_PER_OBJECT, MAXIMUM_NUMBER_OF_ATTACHMENTS_PER_OBJECT	64, 8, 8	source/objects/objects.h and source/objects/object_definitions.h. These belong to different arrays despite sharing an object definition.
Damage material modifier capacity	MAXIMUM_NUMBER_OF_MATERIAL_TYPES	40	source/game/game_globals.h; used by damage_definition.material_modifiers at source/objects/damage_effect_definitions.h. It is storage capacity, not the current named-material count.

Xbox shader encodings (confirmed SDK owners, context-specific)

The existing Xbox D3D8 types header owns the register-combiner macros and enums. Prefer them to packed hexadecimal shader words; this documents the actual inputs and outputs without creating new engine constants. They are hardware encodings, not Bungie identifier recovery.

Encoding	Existing owner / interpretation	Example
Four combiner inputs	PS_COMBINERINPUTS(a,b,c,d) packs four input bytes	PS_COMBINERINPUTS(PS_REGISTER_T0, PS_REGISTER_T0, PS_REGISTER_ZERO, PS_REGISTER_ZERO) is 0x08080000.
Input register/mapping/channel	PS_REGISTER_*, PS_INPUTMAPPING_*, PS_CHANNEL_*	PS_REGISTER_V0 | PS_INPUTMAPPING_UNSIGNED_INVERT is 0x24; PS_REGISTER_V1 | PS_CHANNEL_ALPHA is 0x15. These are already encoded masks, not bit indices for FLAG.
Constant one input	PS_REGISTER_ONE	0x20, zero register with unsigned-invert mapping; not a literal register number 32.
Combiner destinations	PS_COMBINEROUTPUTS(ab,cd,mux_sum,flags)	R0/discard/discard/identity is 0xC0; R1/discard/discard/identity is 0xD0.
Stage count	PS_COMBINERCOUNT(count,flags)	Counts 1 and 3 with zero flags encode as 1 and 3. Flags zero select the SDK defaults; count is not a bit index.
Texture addressing modes	PS_TEXTUREMODES(t0,t1,t2,t3) with PS_TEXTUREMODES_*	PROJECT2D/NONE/NONE/NONE encodes as 1.

The Widgets reconciliation replaces these packed words using the existing macros; all generated code and non-debug sections remain unchanged. Do not assign a fixed-function D3DVSDE_* semantic name to an arbitrary custom vertex shader register just because its number agrees: Widgets sends color through register 9 and texture coordinates through register 4. The custom shader's input contract, not the fixed-function spelling, determines their meaning.

Damage flags relevant to the current caller/helper packet

These are confirmed but context-specific. The enum values are bit indices; use TEST_FLAG/SET_FLAG rather than the numeric masks shown for audit convenience.

Storage	Symbol	Bit / mask	Owner
being_damaged_flags	_object_being_damaged_body_depleted_bit	0 / 0x01	source/objects/damage.h
being_damaged_flags	_object_being_damaged_shield_depleted_bit	3 / 0x08	source/objects/damage.h
being_damaged_flags	_object_being_damaged_by_friendly_bit	4 / 0x10	source/objects/damage.h
being_damaged_flags	_object_being_damaged_multiplied_by_difficulty_bit	5 / 0x20	source/objects/damage.h
damage_data.flags	_damage_no_statistics_bit	7 / 0x80	source/objects/damage.h
object.damage_flags	_object_passed_shield_damage_threshold_bit	1 / 0x0002	source/objects/objects.h
object.damage_flags	_object_shield_depleted_bit	3 / 0x0008	source/objects/objects.h
object.damage_flags	_object_shield_over_charging_bit	4 / 0x0010	source/objects/objects.h
object.damage_flags	_object_cannot_take_damage_bit	11 / 0x0800	source/objects/objects.h

Do not merge the two “shield depleted” names: one is an event/result bit in a 32-bit accumulator and the other is persistent object state in a 16-bit field. Their current numeric bit happens to be the same.

January-specific category, side-effect, material-response, and private-helper values should remain in the owning Damage enum unless a genuine shared owner is found. A comparison against 1, 2, or 3 in disassembly is not enough to infer which enum namespace it belongs to. Likewise, the Damage aftermath upward bias and similar algorithm coefficients are not general math constants; retain a semantic local expression and document its function-level provenance instead of exporting a global name.

Assertions and object-access macros

See the shared assertion API and Units example. Assertions test an invariant that must be true; a diagnostic error condition usually needs negating. _object_connected_to_map_bit is bit 11 in object.flags, whereas _object_header_connected_to_map_bit is bit 5 in a separate header flags byte. Do not substitute one for the other.

Use typed accessors such as unit_get, weapon_get, object_definition_get, bitmap_group_get, and sound_definition_get from their existing subsystem headers. Keep raw tag_get and object-access casts encapsulated there rather than repeating casts at each call site.

Supplied-source crosswalk (evidence, not yet canonical declarations)

The user supplied three CE source files on 2026-09-06. Their hashes, local locations, target fingerprints, and integration caveats are recorded in the source reconstruction map. The following names occur there; do not assume they are already available from canonical headers or export TU-private coefficients globally.

Supplied name / expression	Value	Canonical correspondence and scope
RANDOM_A	1664525L / 0x0019660D	Literal in source/math/random_math.c; LCG multiplier, not a general math constant.
RANDOM_C	1013904223L / 0x3C6EF35F	Same owner; LCG increment. Seed arithmetic is unsigned 32-bit modulo arithmetic.
RANDOM(seed)	Update seed, then take its upper 16 bits	Source macro uses a 16-bit right shift; do not substitute low bits or mutate the seed twice.
REAL_RANDOM(seed)	(1.f / (real)0xffff) * RANDOM(seed)	Divisor is 65535, not 65536; the source real result can reach both 0 and 1. Integer range scaling instead uses a right shift by 16 and is upper-exclusive for its valid range. Preserve expression order and promotions.
RANDOM_DIRECTION_TABLE_GEOSPHERE_SEGMENT_COUNT	16	RandomMath's geosphere construction argument, not a player capacity or direction-table length.
COUNTDOWN_TIMER_CANNOT_ACCLERATE_AMOUNT	MILLISECONDS_PER_SECOND - 1 = 999	Source spelling includes ACCLERATE; canonical server calls it NETWORK_GAME_MINIMUM_COUNTDOWN_TIME.
CLIENT_COUNTDOWN_TIMER_MODIFICATION_AMOUNT	5 * MILLISECONDS_PER_SECOND = 5000	Canonical server NETWORK_GAME_COUNTDOWN_ADJUSTMENT.
LAN_INITIAL_SERVER_GAME_COUNTDOWN	31 * MILLISECONDS_PER_SECOND - 1 = 30999	Canonical server NETWORK_GAME_COUNTDOWN_TIME.
LOCAL_INITIAL_SERVER_GAME_COUNTDOWN	11 * MILLISECONDS_PER_SECOND - 1 = 10999	Canonical server NETWORK_GAME_SPLITSCREEN_COUNTDOWN_TIME.
MAXIMUM_SERVER_GAME_COUNTDOWN	31 * MILLISECONDS_PER_SECOND - 1 = 30999	Separate semantic role from the LAN initial time, despite equal values.
NETWORK_GAME_CLIENT_CONNECTION_PROCESS_TIMEOUT_MILLISECONDS	Debug 120000; release 15000	Supplied client enum selects 120 or 15 times MILLISECONDS_PER_SECOND under DEBUG; do not use one build's timeout in the other.
NETWORK_GAME_CLIENT_GAME_SEARCH_INTERVAL_MILLISECONDS	2000	Supplied client search cadence, 2 * MILLISECONDS_PER_SECOND.
NETWORK_GAME_CLIENT_GAME_ADVERTISED_GAME_TIMEOUT	6000	Supplied client: twice the search interval plus 2 * MILLISECONDS_PER_SECOND; not the connection timeout.
NETWORK_GAME_CLIENT_GAME_PING_INTERVAL_MILLISECONDS	1000	Supplied client ping cadence, 1 * MILLISECONDS_PER_SECOND.
NETWORK_GAME_CLIENT_INITIAL_PACKET_SEQUENCE_NUMBER	1	Supplied client protocol sequence origin; not a universal first array index.

Countdown correspondences are in source/networking/network_server_manager.c. The supplied server's client-machine flag indices are connected 0, validated 1, level-loaded 2, and precached 3. Canonical currently uses joined/loaded names for indices 1/2; numeric agreement alone does not authorize a global semantic rename. These flags are not object-datum flags.

The supplied RandomMath also references _full_circle, _half_circle, and _quarter_circle, but their defining header was not supplied and they are not present in the current canonical math headers. Do not invent a declaration or infer exact expression ordering solely from those names.

The supplied client names its two flag indices _network_game_client_connected_to_server_bit = 0 and _network_game_client_sent_join_request_to_server_bit = 1. Canonical uses shorter inferred names and literal timing values; restore names only with ordinary strict-object and consumer checks, not by unreviewed bulk replacement.

AI profile meter layout

January's shared AI profiling state is declared in source/ai/ai_profile.h. Include that owner when incrementing a meter; do not declare an opaque extern byte ai_profile[], a partial local structure, or a consumer-specific view of the same global.

• ai_profile.meters begins at offset 0x0C.
• There are 28 meter records, each 0x88 bytes.
• accumulator is at record offset 0; current_value is at offset 2.
• A meter accumulator is therefore at 0x0C + index * 0x88.

Frequently used indices and accumulator offsets:

meter enum	index	offset
_ai_meter_encounters_updated	1	0x094
_ai_meter_actors_updated	3	0x1A4
_ai_meter_actors_active	4	0x22C
_ai_meter_units_updated	6	0x33C
_ai_meter_units_active	7	0x3C4
_ai_meter_dead_props_acknowledged	9	0x4D4
_ai_meter_dead_props_orphaned	10	0x55C
_ai_meter_dead_props_unacknowledged	11	0x5E4
_ai_meter_enemy_props_acknowledged	12	0x66C
_ai_meter_enemy_props_orphaned	13	0x6F4
_ai_meter_enemy_props_unacknowledged	14	0x77C
_ai_meter_friendly_props_acknowledged	15	0x804
_ai_meter_friendly_props_orphaned	16	0x88C
_ai_meter_friendly_props_unacknowledged	17	0x914
_ai_meter_collisions	21	0xB34
_ai_meter_line_of_sight	22	0xBBC
_ai_meter_line_of_fire	23	0xC44
_ai_meter_action_change	26	0xDDC

The leading booleans are independently exposed through the Halo Script global table, which authenticates their names and offsets: disabled at 0x00, move_actors_randomly at 0x01, show through show_sound_distance at 0x04 through 0x0B. The complete global is 0xEEC bytes.

Reconstruction checklist

1. Search for an existing owner before adding a constant, enum, macro, or typedef. Include that owner instead of redeclaring it locally when header placement is safe.
2. Establish the storage type and namespace before interpreting -1, 0, or a bit number. NONE, NULL, a tag index, and a byte terminator are not interchangeable merely because some bytes match.
3. Compare exact float bytes and x87 predicates before replacing a literal with _real_epsilon, MIN, MAX, or PIN. Finite agreement does not prove NaN, infinity, tangent, or signed-zero agreement.
4. Treat enum _..._bit members as bit positions and _..._mask... members as masks. Keep the owning field width; do not widen a byte/word flag field to long * for macro convenience.
5. Treat every maximum as a capacity for its named owner, not a current count or a substitute capacity for a nearby array.
6. Preserve public type widths at ABI boundaries. In particular, real is float and boolean is byte even when i386 register or stack mechanics make a mismatched declaration appear to work.

Leaf Map construction constants (context-specific)

These values are authenticated by January's Leaf Map strings, data, control flow, and the reconciled private caller graph. They belong to source/structures/leaf_map.c; they are not general geometry constants.

Role	Source spelling / value	Boundary
BSP traversal stack capacity	MAXIMUM_NODE_STACK_COUNT = 256	Assertion text names the constant and aggregate field. Stack entries are signed node designators whose sign bit records the child side.
Initial face polygon capacity	MAXIMUM_LEAF_FACE_VERTICES = 64	Bounds the local clipped polygon and the correctly owned Geometry clip call.
Portal intersection capacity	MAXIMUM_PORTAL_VERTICES = 64	Bounds the temporary intersection polygon; it is not a generic tag-block capacity.
Initial projected world square	coordinates +/-1536.f	The four-point polygon is clipped by every ancestor BSP plane; do not export 1536 as a world-wide coordinate bound.
Leaf-face clip epsilon	0.000244140625f (1/4096)	Algorithm-specific clip tolerance, distinct from _real_epsilon.
Portal intersection epsilon	0.00048828125f (1/2048)	Algorithm-specific intersection tolerance.
Portal closure thresholds	area < 0.0025f or sqrt(area)/perimeter < 0.01f	Preserve expression order and the perimeter call; these are not generic degenerate-polygon rules.

See the Leaf Map reconciliation ledger for symbol provenance, strict-credit boundaries, and the remaining data/BSS gap.

Rasterizer shared-state lookup

Use source/rasterizer/rasterizer_frame_statistics.h for the complete January 0x170-byte frame-statistics record and its external declaration. Do not introduce another consumer-specific prefix. Dynamic buffer counts are not maximum capacities; model skinning/lighting accumulators count uploaded constant bytes, not objects. See the shared counter owner ledger for the current writer-backed fields and intentionally unreviewed interiors.

Use source/rasterizer/rasterizer_debug_options.h for the genuine January debug-options record; do not add another TU-local prefix. The size is 0x8C (not later HCEA's 0x90). Active Camouflage flags are at 0x41/0x42; January zbias at 0x54 is long, not real; pad3_scale is at 0x6C and the six debug reals start at 0x70. The pixel-counter active/enabled pair is 0x88/0x89. Unknown bytes must not inherit later-build names merely by offset.

The complete 0xF0 Xbox pixel_shader_definition is in source/rasterizer/xbox/rasterizer_xbox_pixel_shader.h. Use this associated header when a complete type is needed; the broad Xbox header retains its forward declaration to avoid colliding with legacy local definitions. See the shared-owner/cache admission for provenance, the typed initializer and pinned-compiler layout tests.

PlayerProfile and S3TC constants

January; 2026-09-07 owner reconciliation:

• source/saved games/player_profile.h owns the 48-byte profile: name is 12 wchar_t at +0, color short at +24, flags word at +26, ten byte map flags at +28, last level short at +38 and eight-byte controller settings at +40. These are not the larger later-PC/PDB profile layout.
• SAVED_GAME_FILE_BLOCK_SIZE is 512 in saved_game_files.h. PlayerProfile's typed file block has 48 profile bytes, a 20-byte XDK signature and 444 bytes of zeroed padding. Do not serialize uninitialized padding for matching.
• S3TC_BLOCK_PIXELS is 16 (4 by 4); single-pixel coordinates are 0..3. RGB565 is blue/green/red 5/6/5 in the project's byte-channel order. S3TC's weights are 0.082f, 0.6094f, 0.3086f in that order; maps are RGB4 {0,2,3,1}, RGB3 {0,2,1,3}. These are codec operations, not flag bits.
• See the coherent batch ledger for evidence limits, safe repairs, retained fuzzy work and exact debits.

Useful corroborating ledgers:

• docs/object_matching_logs/damage_obj_object_damage_update_20260904.md documents project real, enum, flag, tick, and clamp use in a verified Damage owner.
• docs/object_matching_logs/bipeds_obj_jonas_disconnect_bsp_20260827.md records the January all-bits-set NONE representation in real object fields.
• docs/object_matching_logs/collision_bsp_obj_sphere_cluster_20260904.md records a specifically authenticated byte-buffer/bit-vector boundary; it is an exception requiring evidence, not a blanket license for representation casts.