Collision mass identification, collision view/editing tool, and collision data bin dumps

Makefile

@@ -72,7 +72,7 @@ FIX       := tools/gbafix/gbafix$(EXE)
 SHA1 := $(shell { command -v sha1sum || command -v shasum; } 2>/dev/null) -c
 
 TOOLS_DIR = tools
-TOOLDIRS = $(filter-out $(TOOLS_DIR)/agbcc $(TOOLS_DIR)/m2ctx.py $(TOOLS_DIR)/scripts,$(wildcard $(TOOLS_DIR)/*))
+TOOLDIRS = $(filter-out $(TOOLS_DIR)/agbcc $(TOOLS_DIR)/m2ctx.py $(TOOLS_DIR)/scripts $(TOOLS_DIR)/collision_viewer,$(wildcard $(TOOLS_DIR)/*))
 
 infoshell = $(foreach line, $(shell $1 | sed "s/ /__SPACE__/g"), $(info $(subst __SPACE__, ,$(line))))
 

data/board_data/dusclops_board.inc

@@ -8,13 +8,13 @@ gDusclopsBoardBG0Tilemap:: @ 0x082EE4C0
 	.incbin "baserom.gba", 0x2EE4C0, 0x800
 
 gDusclopsBoardCollisionTileDataAllLayers:: @ 0x082EECC0
-    .incbin "baserom.gba", 0x2EECC0, 0x2000
+.incbin "data/board_data/collision/dusclops/board_tiledata.bin"
 
 gDusclopsBoardCollisionAngleDataAllLayers:: @ 0x082F0CC0
-    .incbin "baserom.gba", 0x2F0CC0, 0xB180
+.incbin "data/board_data/collision/dusclops/board_angledata.bin"
 
 gDusclopsBoardCollisionTypeDataAllLayers:: @ 0x082FBE40
-    .incbin "baserom.gba", 0x2FBE40, 0x58C0
+.incbin "data/board_data/collision/dusclops/board_typedata.bin"
 
 gDusclopsBoardBG1Tilemap:: @ 0x08301700
 	.incbin "baserom.gba", 0x301700, 0x800
@@ -29,4 +29,4 @@ gDusclopsBoardCompressedBGTiles:: @ 0x08303928
 	.incbin "baserom.gba", 0x303928, 0x38AC
 
 gDusclopsBodyCollisionMap:: @ 0x083071D4
-	.incbin "baserom.gba", 0x3071D4, 0x5A00
+.incbin "data/board_data/collision/dusclops/dusclops_entity_collision_96x120.bin"

data/board_data/groudon_board.inc

@@ -14,7 +14,8 @@ gGroudonBoardCompressedBGTiles:: @ 0x08353DD8
 	.incbin "baserom.gba", 0x353DD8, 0x3BF0
 
 gGroudonBodyCollisionMap:: @ 0x083579C8
-	.incbin "baserom.gba", 0x3579C8, 0x7000
+.incbin "data/board_data/collision/groudon/groudon_entity_collision_112x128.bin"
 
 gGroudonProjectileCollisionMap:: @ 0x0835E9C8
-	.incbin "baserom.gba", 0x35E9C8, 0x5500
+.incbin "data/board_data/collision/groudon/groudon_projectile_collision_80x80.bin"
+.incbin "data/board_data/collision/groudon/groudon_projectile_collision2_80x56.bin"

data/board_data/kecleon_board.inc

@@ -5,13 +5,13 @@ gKecleonBoardBG1Tilemap:: @ 0x0830CDD4
 	.incbin "baserom.gba", 0x30CDD4, 0x800
 
 gKecleonBoardCollisionTileDataAllLayers:: @ 0x0830D5D4
-    .incbin "baserom.gba", 0x30D5D4, 0x2000
+.incbin "data/board_data/collision/kecleon/board_tiledata.bin"
 
 gKecleonBoardCollisionAngleDataAllLayers:: @ 0x0830F5D4
-    .incbin "baserom.gba", 0x30F5D4, 0x10280
+.incbin "data/board_data/collision/kecleon/board_angledata.bin"
 
 gKecleonBoardCollisionTypeDataAllLayers:: @ 0x0831F854
-    .incbin "baserom.gba", 0x31F854, 0x8140
+.incbin "data/board_data/collision/kecleon/board_typedata.bin"
 
 gKecleonBerryOverlayTilemap:: @ 0x08327994
 	.incbin "baserom.gba", 0x327994, 0x800
@@ -31,8 +31,8 @@ gKecleonBoardBG0Tilemap:: @ 0x08329994
 gKecleonBoardCompressedBGTiles:: @ 0x0832A194
 	.incbin "baserom.gba", 0x32A194, 0x3470
 
-gKecleonTongueCollisionMap:: @ 0x0832D604
-	.incbin "baserom.gba", 0x32D604, 0x2C00
+gKecleonUprightCollisionMap:: @ 0x0832D604
+.incbin "data/board_data/collision/kecleon/kecleon_entity_upright_collision_64x88.bin"
 
-gKecleonBodyCollisionMap:: @ 0x08330204
-	.incbin "baserom.gba", 0x330204, 0x2C00
+gKecleonKnockedDownCollisionMap:: @ 0x08330204
+.incbin "data/board_data/collision/kecleon/kecleon_entity_knocked_down_collision_88x64.bin"

data/board_data/kyogre_board.inc

@@ -9,13 +9,13 @@ gKyogreWaterBackgroundTilemap:: @ 0x08333004
 	.incbin "baserom.gba", 0x333004, 0x800
 
 gKyrGrouBoardCollisionTileDataAllLayers:: @ 0x08333804
-    .incbin "baserom.gba", 0x333804, 0x2000
+.incbin "data/board_data/collision/kyogre/board_tiledata.bin"
 
 gKyrGrouBoardCollisionAngleDataAllLayers:: @ 0x08335804
-    .incbin "baserom.gba", 0x335804, 0x5580
+.incbin "data/board_data/collision/kyogre/board_angledata.bin"
 
 gKyrGrouBoardCollisionTypeDataAllLayers:: @ 0x0833AD84
-    .incbin "baserom.gba", 0x33AD84, 0x2AC0
+.incbin "data/board_data/collision/kyogre/board_typedata.bin"
 
 gKyogreBoardBG1Tilemap:: @ 0x0833D844
 	.incbin "baserom.gba", 0x33D844, 0x800
@@ -42,13 +42,13 @@ gKyogreFadeInPaletteStep0:: @ 0x08340958
     .incbin "baserom.gba", 0x340958, 0x200
 
 gKyogreForm1CollisionMap:: @ 0x08340B58
-	.incbin "baserom.gba", 0x340B58, 0x8E80
+	.incbin "data/board_data/collision/kyogre/kyogre_entity_form_1_collision_120x152.bin"
 
 gKyogreForm2CollisionMap:: @ 0x083499D8
-	.incbin "baserom.gba", 0x3499D8, 0x4200
+	.incbin "data/board_data/collision/kyogre/kyogre_entity_form_2_collision_96x88.bin"
 
 gKyogreForm3CollisionMap:: @ 0x0834DBD8
-	.incbin "baserom.gba", 0x34DBD8, 0x4E00
+	.incbin "data/board_data/collision/kyogre/kyogre_entity_form_3_collision_96x104.bin"
 
 gKyogreIntroIcePalette:: @ 0x083529D8
 	.incbin "baserom.gba", 0x3529D8, 0x200

data/board_data/rayquaza_board.inc

@@ -6,13 +6,13 @@ gRayquazaBoardBG0Tilemap:: @ 0x083640C8
 	.incbin "baserom.gba", 0x3640C8, 0x1000
 
 gRayquazaBoardCollisionTileDataAllLayers:: @ 0x083650C8
-    .incbin "baserom.gba", 0x3650C8, 0x2000
+.incbin "data/board_data/collision/rayquaza/board_tiledata.bin"
 
 gRayquazaBoardCollisionAngleDataAllLayers:: @ 0x083670C8
-    .incbin "baserom.gba", 0x3670C8, 0x4F80
+.incbin "data/board_data/collision/rayquaza/board_angledata.bin"
 
 gRayquazaBoardCollisionTypeDataAllLayers:: @ 0x0836C048
-    .incbin "baserom.gba", 0x36C048, 0x27C0
+.incbin "data/board_data/collision/rayquaza/board_typedata.bin"
 
 gRayquazaBoardBGScrollTilemap:: @ 0x0836E808
 	.incbin "baserom.gba", 0x36E808, 0x1000
@@ -24,4 +24,4 @@ gRayquazaBoardCompressedBGTiles:: @ 0x08370808
 	.incbin "baserom.gba", 0x370808, 0x1AE0
 
 gRayquazaBodyCollisionMap:: @ 0x083722E8
-	.incbin "baserom.gba", 0x3722E8, 0x8000
+	.incbin "data/board_data/collision/rayquaza/rayquaza_entity_collision_128x128.bin"

data/board_data/ruby_board.inc

@@ -5,43 +5,43 @@ gRubyBoardBG0Tilemap:: @ 0x081C08E4
 	.incbin "baserom.gba", 0x1C08E4, 0x1000
 
 gRubyBoardCollisionTileDataLayer0:: @ 0x081C18E4
-    .incbin "baserom.gba", 0x1C18E4, 0x2000
+.incbin "data/board_data/collision/ruby/boardtop_launch_tiledata.bin"
 
 gRubyBoardCollisionAngleDataLayer0:: @ 0x081C38E4
-    .incbin "baserom.gba", 0x1C38E4, 0x18780
+.incbin "data/board_data/collision/ruby/boardtop_launch_angledata.bin"
 
 gRubyBoardCollisionTypeDataLayer0:: @ 0x081DC064
-    .incbin "baserom.gba", 0x1DC064, 0xC3C0
+.incbin "data/board_data/collision/ruby/boardtop_launch_typedata.bin"
 
 gRubyBoardCollisionTileDataLayer0Alt:: @ 0x081E8424
-    .incbin "baserom.gba", 0x1E8424, 0x2000
+.incbin "data/board_data/collision/ruby/boardtop_normal_tiledata.bin"
 
 gRubyBoardCollisionAngleDataLayer0Alt:: @ 0x081EA424
-    .incbin "baserom.gba", 0x1EA424, 0x18380
+.incbin "data/board_data/collision/ruby/boardtop_normal_angledata.bin"
 
 gRubyBoardCollisionTypeDataLayer0Alt:: @ 0x082027A4
-    .incbin "baserom.gba", 0x2027A4, 0xC1C0
+.incbin "data/board_data/collision/ruby/boardtop_normal_typedata.bin"
 
 gRubyBoardCollisionTileDataLayer1:: @ 0x0820E964
-    .incbin "baserom.gba", 0x20E964, 0x2000
+.incbin "data/board_data/collision/ruby/boardbottom_tiledata.bin"
 
 gRubyBoardCollisionAngleDataLayer1:: @ 0x08210964
-    .incbin "baserom.gba", 0x210964, 0x13C80
+.incbin "data/board_data/collision/ruby/boardbottom_angledata.bin"
 
 gRubyBoardCollisionTypeDataLayer1:: @ 0x082245E4
-    .incbin "baserom.gba", 0x2245E4, 0x9E40
+.incbin "data/board_data/collision/ruby/boardbottom_typedata.bin"
 
 gRubyBoardBG1Tilemap:: @ 0x0822E424
 	.incbin "baserom.gba", 0x22E424, 0x1000
 
 gRubyBoardCollisionTileDataLayer2:: @ 0x0822F424
-    .incbin "baserom.gba", 0x22F424, 0x2000
+.incbin "data/board_data/collision/ruby/topramps_tiledata.bin"
 
 gRubyBoardCollisionAngleDataLayer2:: @ 0x08231424
-    .incbin "baserom.gba", 0x231424, 0x11E80
+.incbin "data/board_data/collision/ruby/topramps_angledata.bin"
 
 gRubyBoardCollisionTypeDataLayer2:: @ 0x082432A4
-    .incbin "baserom.gba", 0x2432A4, 0x8F40
+.incbin "data/board_data/collision/ruby/topramps_typedata.bin"
 
 gRubyBoardCompressedTiles1:: @ 0x0824C1E4
 	.incbin "baserom.gba", 0x24C1E4, 0x1B7C
@@ -53,16 +53,16 @@ gRubyBoardCompressedBGTileBuffer:: @ 0x08250934
 	.incbin "baserom.gba", 0x250934, 0x21DC
 
 gSharedBumperCollisionMap:: @ 0x08252B10
-	.incbin "baserom.gba", 0x252B10, 0x2000
+	.incbin "data/board_data/collision/ruby/shared_bumper_entity_collision_64x64.bin"
 
-gRubyAltEntity0CollisionMap:: @ 0x08254B10
-	.incbin "baserom.gba", 0x254B10, 0x2880
+gRubyLinooneLeftCollisionMap:: @ 0x08254B10
+    .incbin "data/board_data/collision/ruby/linoone_left_collision_map_72x72.bin"
 
-gRubyAltEntity1CollisionMap:: @ 0x08257390
-	.incbin "baserom.gba", 0x257390, 0x2880
+gRubyLinooneRightCollisionMap:: @ 0x08257390
+    .incbin "data/board_data/collision/ruby/linoone_right_collision_map_72x72.bin"
 
 gWhiscashCollisionMap:: @ 0x08259C10
-	.incbin "baserom.gba", 0x259C10, 0x3700
+	.incbin "data/board_data/collision/ruby/whiscash_entity_collision_80x88.bin"
 
 
 @ Evo Arrows. Named this way for comprehension in folder.

data/board_data/sapphire_board.inc

@@ -7,43 +7,43 @@ gSapphireBoardBG0Tilemap:: @ 0x0826EE10
 	.incbin "baserom.gba", 0x26EE10, 0x1000
 
 gSapphireBoardCollisionTileDataLayer0:: @ 0x0826FE10
-    .incbin "baserom.gba", 0x26FE10, 0x2000
+.incbin "data/board_data/collision/sapphire/boardtop_tiledata.bin"
 
 gSapphireBoardCollisionAngleDataLayer0:: @ 0x08271E10
-    .incbin "baserom.gba", 0x271E10, 0x14C00
+.incbin "data/board_data/collision/sapphire/boardtop_angledata.bin"
 
 gSapphireBoardCollisionTypeDataLayer0:: @ 0x08286A10
-    .incbin "baserom.gba", 0x286A10, 0xA600
+.incbin "data/board_data/collision/sapphire/boardtop_typedata.bin"
 
 gSapphireBoardCollisionTileDataLayer1:: @ 0x08291010
-    .incbin "baserom.gba", 0x291010, 0x2000
+.incbin "data/board_data/collision/sapphire/boardbottom_tiledata.bin"
 
 gSapphireBoardCollisionAngleDataLayer1:: @ 0x08293010
-    .incbin "baserom.gba", 0x293010, 0x12480
+.incbin "data/board_data/collision/sapphire/boardbottom_angledata.bin"
 
 gSapphireBoardCollisionTypeDataLayer1:: @ 0x082A5490
-    .incbin "baserom.gba", 0x2A5490, 0x9240
+.incbin "data/board_data/collision/sapphire/boardbottom_typedata.bin"
 
 gSapphireBoardBG1Tilemap:: @ 0x082AE6D0
 	.incbin "baserom.gba", 0x2AE6D0, 0x1000
 
 gSapphireBoardCollisionTileDataLayer2:: @ 0x082AF6D0
-    .incbin "baserom.gba", 0x2AF6D0, 0x2000
+.incbin "data/board_data/collision/sapphire/topramp_tiledata.bin"
 
 gSapphireBoardCollisionAngleDataLayer2:: @ 0x082B16D0
-    .incbin "baserom.gba", 0x2B16D0, 0xD100
+.incbin "data/board_data/collision/sapphire/topramp_angledata.bin"
 
 gSapphireBoardCollisionTypeDataLayer2:: @ 0x082BE7D0
-    .incbin "baserom.gba", 0x2BE7D0, 0x6880
+.incbin "data/board_data/collision/sapphire/topramp_typedata.bin"
 
 gSapphireBoardCollisionTileDataLayer3:: @ 0x082C5050
-    .incbin "baserom.gba", 0x2C5050, 0x2000
+.incbin "data/board_data/collision/sapphire/hatchexitramp_tiledata.bin"
 
 gSapphireBoardCollisionAngleDataLayer3:: @ 0x082C7050
-    .incbin "baserom.gba", 0x2C7050, 0x8300
+.incbin "data/board_data/collision/sapphire/hatchexitramp_angledata.bin"
 
 gSapphireBoardCollisionTypeDataLayer3:: @ 0x082CF350
-    .incbin "baserom.gba", 0x2CF350, 0x4180
+.incbin "data/board_data/collision/sapphire/hatchexitramp_typedata.bin"
 
 gSapphireBoardCompressedTiles1:: @ 0x082D34D0
 	.incbin "baserom.gba", 0x2D34D0, 0x1D6C

data/board_data/spheal_board.inc

@@ -6,13 +6,13 @@ gSphealWaterBackgroundTilemap:: @ 0x0837A4E8
 	.incbin "baserom.gba", 0x37A4E8, 0x800
 
 gSphealBoardCollisionTileDataAllLayers:: @ 0x0837ACE8
-    .incbin "baserom.gba", 0x37ACE8, 0x2000
+.incbin "data/board_data/collision/spheal/board_tiledata.bin"
 
 gSphealBoardCollisionAngleDataAllLayers:: @ 0x0837CCE8
-    .incbin "baserom.gba", 0x37CCE8, 0xB780
+.incbin "data/board_data/collision/spheal/board_angledata.bin"
 
 gSphealBoardCollisionTypeDataAllLayers:: @ 0x08388468
-    .incbin "baserom.gba", 0x388468, 0x5BC0
+.incbin "data/board_data/collision/spheal/board_typedata.bin"
 
 gSphealBoardBG1Tilemap:: @ 0x0838E028
 	.incbin "baserom.gba", 0x38E028, 0x800
@@ -21,7 +21,7 @@ gSphealBoardCompressedBGTiles:: @ 0x0838E828
 	.incbin "baserom.gba", 0x38E828, 0x3224
 
 gSphealRampCollisionMap:: @ 0x08391A4C
-	.incbin "baserom.gba", 0x391A4C, 0x2000
+	.incbin "data/board_data/collision/spheal/spheal_ramp_entity_collision_64x64.bin"
 
 gSphealFrozenIceCollisionMap:: @ 0x08393A4C
-	.incbin "baserom.gba", 0x393A4C, 0x2000
+	.incbin "data/board_data/collision/spheal/spheal_ice_water_entity_collision_64x64.bin"

include/constants/board/kecleon_states.h

@@ -35,4 +35,12 @@ enum KecleonCollisionMode{
     KECLEON_COLLISION_MODE_KNOCKED_OVER = 2,
 };
 
+enum KecleonCollisionTrigger{
+    KECLEON_TRIGGER_FLOWERS = 8,
+    KECLEON_TRIGGER_BUSH_GROUP_0 = 9,
+    KECLEON_TRIGGER_WATER = 10,
+    KECLEON_TRIGGER_BUSH_GROUP_1 = 11,
+    KECLEON_TRIGGER_BUSH_GROUP_2 = 12,
+};
+
 #endif //GUARD_CONSTANTS_KECLEON_STATES_H

include/constants/board/ruby_states.h

@@ -42,4 +42,40 @@ enum WhiscashFramesetIx{
     WHISCASH_FRAME_GONE_AFTER_HIT = 45,
 };
 
+enum RubyCollisionTrigger{
+    RUBY_TRIGGER_MODE_START_BALL_LOCK = 1,
+    RUBY_TRIGGER_CHANGE_LAYER_UP = 2,
+    RUBY_TRIGGER_CHANGE_LAYER_DOWN = 3,
+    RUBY_TRIGGER_TARGET_SWITCH = 4,
+    RUBY_TRIGGER_BALL_LAUNCH_POSITION = 5,
+    RUBY_TRIGGER_CLOSE_LAUNCH_LANE = 6,
+    RUBY_TRIGGER_NUZLEAF = 7,
+    RUBY_TRIGGER_UPPER_LANE_ROLLOVER = 8,
+    RUBY_TRIGGER_LOWER_LANE_ROLLOVER = 9,
+    RUBY_TRIGGER_HOLE_ROLLOVER = 10,
+    RUBY_TRIGGER_CONDITIONAL_ACTIVATION = 11,
+    RUBY_TRIGGER_PIKA_CHARGE_SPINNER = 12,
+    RUBY_TRIGGER_CYNDAQUIL_LOW_POSITION = 13,
+    RUBY_TRIGGER_CYNDAQUIL_MID_POSITION = 14,
+    RUBY_TRIGGER_CYNDAQUIL_HIGH_POSITION = 15,
+};
+
+enum RubyCollisionZone{
+    RUBY_ZONE_LAUNCH_CHUTE = 0,
+    RUBY_ZONE_COIN_LANE_TOP = 1,
+    RUBY_ZONE_EVO_LANE_TOP = 2,
+    RUBY_ZONE_LEFT_BALL_UPGRADE_LANE = 3,
+    RUBY_ZONE_CENTER_BALL_UPGRADE_LANE = 4,
+    RUBY_ZONE_RIGHT_BALL_UPGRADE_LANE = 5,
+    RUBY_ZONE_GET_LANE_TOP = 6,
+    RUBY_ZONE_COIN_LANE_BOTTOM = 7,
+    RUBY_ZONE_EVO_LANE_BOTTOM = 8,
+    RUBY_ZONE_GET_LANE_BOTTOM = 9,
+    RUBY_ZONE_H_OUTLANE = 10,
+    RUBY_ZONE_O_INLANE = 11,
+    RUBY_ZONE_L_INLANE = 12,
+    RUBY_ZONE_E_OUTLANE = 13,
+    RUBY_ZONE_NUZLEAF_RAMP = 14,
+};
+
 #endif // GUARD_CONSTANTS_RUBY_STATES_H

include/constants/board/sapphire_states.h

@@ -2,4 +2,42 @@
 #define GUARD_CONSTANTS_SAPPHIRE_STATES_H
 #include "main_board.h"
 
+enum SapphireCollisionTrigger{
+    SAPPHIRE_TRIGGER_MODE_START_BALL_LOCK = 1,
+    SAPPHIRE_TRIGGER_CHANGE_LAYER_UP = 2,
+    SAPPHIRE_TRIGGER_CHANGE_LAYER_DOWN = 3,
+    SAPPHIRE_TRIGGER_TARGET_SWITCH = 4,
+    SAPPHIRE_TRIGGER_BALL_LAUNCH_POSITION = 5,
+    SAPPHIRE_TRIGGER_6 = 6,
+    SAPPHIRE_TRIGGER_SHOCK_WALL = 7,
+    SAPPHIRE_TRIGGER_UPPER_LANE_ROLLOVER = 8,
+    SAPPHIRE_TRIGGER_LOWER_LANE_ROLLOVER = 9,
+    SAPPHIRE_TRIGGER_HOLE_ROLLOVER = 10,
+    SAPPHIRE_TRIGGER_PIKA_KICKBACK_ROLLOVER_TRIGGER = 11,
+    SAPPHIRE_TRIGGER_PIKA_CHARGE_SPINNER = 12,
+    SAPPHIRE_TRIGGER_HATCH_MACHINE_ALTERNATING_TRIGGER_TYPE_A = 13,
+    SAPPHIRE_TRIGGER_HATCH_MACHINE_ALTERNATING_TRIGGER_TYPE_B = 14,
+    SAPPHIRE_TRIGGER_PELIPPER_ENTITY_TRIGGER = 15,
+};
+
+enum SapphireCollisionZone{
+    SAPPHIRE_ZONE_LAUNCH_CHUTE = 0,
+    SAPPHIRE_ZONE_COIN_LANE_TOP = 1,
+    SAPPHIRE_ZONE_EVO_LANE_TOP = 2,
+    SAPPHIRE_ZONE_LEFT_BALL_UPGRADE_LANE = 3,
+    SAPPHIRE_ZONE_CENTER_BALL_UPGRADE_LANE = 4,
+    SAPPHIRE_ZONE_RIGHT_BALL_UPGRADE_LANE = 5,
+    SAPPHIRE_ZONE_GET_LANE_TOP = 6,
+    SAPPHIRE_ZONE_COIN_LANE_BOTTOM = 7,
+    SAPPHIRE_ZONE_EVO_LANE_BOTTOM = 8,
+    SAPPHIRE_ZONE_GET_LANE_BOTTOM = 9,
+    SAPPHIRE_ZONE_H_OUTLANE = 10,
+    SAPPHIRE_ZONE_O_INLANE = 11,
+    SAPPHIRE_ZONE_L_INLANE = 12,
+    SAPPHIRE_ZONE_E_OUTLANE = 13,
+    SAPPHIRE_ZONE_HATCH_ALTERNATER_A = 14,
+    SAPPHIRE_ZONE_HATCH_ALTERNATER_B = 15,
+};
+
+
 #endif //GUARD_CONSTANTS_SAPPHIRE_STATES_H