alchemy-docs/sol__sanctum__eruption_8c_source.html

/// @file

/// Sol Sanctum collapsing as the volcano erupts: Saturos and his group take

/// Jenna and Kraden away, and the Wise One rescues Isaac and Garet.


#include "script.h"

#include "game_state.h"

#include "unit/scene/sol_sanctum_eruption.h"

#include "unit/scene/common/effect_psynergy.h"

#include "unit/scene/common/sol_sanctum_elemental_star_ring_setup.h"

#include "unit/object/object.h"

#include "unit/object/psynergy_effects.h"

#include "unit/field/field.h"

#include "unit/runtime/runtime.h"

#include "battle.h"

#include "debug.h"

#include "field.h"

#include "game.h"

#include "graphics.h"

#include "menu.h"

#include "minigame.h"

#include "sound.h"

#include "system.h"

#include "resource.h"

#include "b5_context.h"

#include "sol_sanctum_eruption.h"

#include "types.h"

#include "animspr.h"

#include "field_event.h"

#include "field_service.h"

#include "iwram_call.h"

#include "field_effect.h"

#include "text/msg_ids.h"

#include "field_scene.h"

#include "objcmd.h"

#include "field_obj.h"

#include "global_cells.h"

#include "vram_tab.h"

#include "fixed_math.h"

#include "palbuf.h"

#include "macros.h"

#include "flags.h"

#include "songs.h"

#include "item_ids.h"

#include "fx_scene.h"


static void SolSanctumEruption_RaiseAndShrinkActor(s32 actorId);

static void SolSanctumEruption_ThrowEruptionRing(void);

static void SolSanctumEruption_ResetEmberEmission(void);

static void SolSanctumEruption_StepEmbers(void);

static void SolSanctumEruption_UpdateEmberFrequency(void);

static void SolSanctumEruption_PlayWiseOneRescue(void);

static void SolSanctumEruption_PlaceBeforeStar(s32 actor);

static void SolSanctumEruption_DrawFirstCollapseTiles(s32 alternate);

static void SolSanctumEruption_DrawSecondCollapseTiles(s32 alternate);

static void SolSanctumEruption_FlickerFirstCollapseTiles(void);

static void SolSanctumEruption_FlickerSecondCollapseTiles(void);

static void SolSanctumEruption_RaiseElementalArcs(u32 mode);

static void SolSanctumEruption_UpdateElementalArcs(void);

static void SolSanctumEruption_FadeCameraTo(s32 x, s32 z);

static void SolSanctumEruption_RestoreCornerCellAttributes(void);

static void SolSanctumEruption_SetMaterializationTint(s32 enabled, s32 frames,

                                                      s32 waitFrames);

static void

SolSanctumEruption_FlashMaterializingActor(struct FieldActor *actor);

static void SolSanctumEruption_SpawnEffectPair(struct FieldActor *parent);

static void SolSanctumEruption_UpdateWiseOnePalette(void);


// Scene flags, cleared on every ordinary entrance:

// - FLAG_SCENE_TEMP_46: set as Saturos's group starts to leave; from then on

//   the embers fall without their sound (SE_246).


enum { ACTOR_WISE_ONE = 15, ACTOR_FIRST_ROCK = 16, ROCK_COUNT = 16 };


enum { OBJECT_ELEMENTAL_STAR = 22 };


#define ELEMENTAL_ARC_SCALE_X_DECREASE 7372

#define EMBER_EMISSION_DISABLED 999

#define ARC_SCAN_STILL_ACTIVE 888


const struct SceneEntrance *SolSanctumEruption_GetEntrances(void) {

  return gSolSanctumEruption_Entrances;

}


const struct SceneRegion *SolSanctumEruption_GetRegions(void) { return NULL; }


const u32 *SolSanctumEruption_GetExits(void) {

  return gSolSanctumEruption_Exits;

}


/// Returns Garet and Jenna, then the departure glow (actor 8), Kraden,

/// Saturos, Menardi, Felix masked and unmasked, Alex, the Wise One (15) and

/// sixteen rocks (16 to 31), all placed off the map until the cutscene moves

/// them.

const struct ScenePlacement *SolSanctumEruption_GetPlacements(void) {

  return gSolSanctumEruption_Placements;

}


/// Returns the empty event table: the scene is one cutscene.

const struct SceneEvent *SolSanctumEruption_GetEvents(void) {

  return gSolSanctumEruption_Events;

}


/// Stages Saturos, Menardi, Alex and Felix around Jenna and Kraden.

static inline void SolSanctumEruption_PlaceHostageGroup(void) {

  Actor_SetPosition(JENNA, PIXELS(475), PIXELS(332));

  Actor_SetPosition(ACTOR_KRADEN, PIXELS(491), PIXELS(332));

  Actor_SetPosition(ACTOR_MENARDI, PIXELS(459), PIXELS(348));

  Actor_SetPosition(ACTOR_SATUROS, PIXELS(507), PIXELS(348));

  Actor_SetPosition(ACTOR_FELIX, PIXELS(471), PIXELS(306));

  Actor_SetPosition(ACTOR_ALEX, PIXELS(479), PIXELS(362));

}


/// Saturos's group argues over the Mars Star and leaves with Jenna and Kraden

/// as hostages, before the Wise One rescues Isaac and Garet. Called by

/// SolSanctumEruption_Initialize at entrance 10, the arrival from the

/// Elemental Star room. Sets FLAG_SCENE_TEMP_46, plays

/// SolSanctumEruption_PlayWiseOneRescue and then removes Jenna from the party.

static void SolSanctumEruption_PlayHostageScene(void) {

  void Actor_ShowEmote();

  void ColorBuffer_ApplyTarget();

  void Event_PlayCue();


  struct FieldActor *actor;

  struct GroundParticleWork *sparkles;

#ifndef UBFIX

  struct GroundParticleWork **particleWorkSlot;

  struct EventWork **eventWorkSlot;

#endif


#ifdef UBFIX

  sparkles = gParticleWork;

#else

  particleWorkSlot = &gParticleWork;

  sparkles = *particleWorkSlot;

#endif

  Engine_EventBegin();

  sparkles->stopped = 0;

  // Reopen the chamber during the first quake and stage the two groups.

  Event_PlayCue(SE_141);

  Map_SetShake(PIXELS(1), PIXELS(1), Q16_ONE);

  Actor_SetPosition(ACTOR_PARTY_LEADER, PIXELS(232), PIXELS(156));

  Actor_SetPosition(GARET, PIXELS(218), PIXELS(172));

  Actor_FaceDirection(ACTOR_PARTY_LEADER, FACING_NORTHWEST + FACING_STEP, 0);

  Actor_FaceDirection(GARET, FACING_NORTH + FACING_STEP, 0);

  SolSanctumEruption_PlaceHostageGroup();

  Engine_ActorSetSpritePriority(ACTOR_WISE_ONE, 1);

#ifndef UBFIX

  // UB: these are separate work-pointer globals. The native sequence reaches

  // the event slot through the particle slot; named globals add four bytes

  // and change this scene's register allocation in tbs-en.

  eventWorkSlot = (struct EventWork **)((u8 *)particleWorkSlot - 8);

#endif

  Camera_MoveTo(PIXELS(232), -1, PIXELS(156), 0);

  Engine_MapRedraw();

#ifdef UBFIX

  gEventWork->transitionFrames = 8;

#else

  (*eventWorkSlot)->transitionFrames = 8;

#endif

  Engine_EventOpenScreen();

  Engine_EventWaitForScreen();

  ColorBuffer_ApplyTarget(0x7fff, 0);

  Engine_ColorBufferInterpolate(4);

  Engine_EventWait(4);

  ColorBuffer_ApplyTarget(PALETTE_TRANSFORM_PLAIN, 0);

  Engine_ColorBufferInterpolate(4);

  Engine_EventWait(4);

  SolSanctumEruption_ThrowEruptionRing();

  ColorBuffer_ApplyTarget(0x7fff, 0);

  Engine_ColorBufferInterpolate(4);

  Engine_EventWait(16);

  Event_PlayCue(SE_144);

  ColorBuffer_ApplyTarget(PALETTE_TRANSFORM_PLAIN, 0);

  Engine_ColorBufferInterpolate(4);

  Engine_EventWait(4);

  ColorBuffer_ApplyTarget(0x7fff, 0);

  Engine_ColorBufferInterpolate(4);

  Engine_EventWait(4);

  Event_PlayCue(SE_144);

  ColorBuffer_ApplyTarget(PALETTE_TRANSFORM_PLAIN, 0);

  Engine_ColorBufferInterpolate(48);

  Engine_EventWait(48);

  Engine_ActorJump(ACTOR_PARTY_LEADER, 6, 0);

  Engine_ActorJump(GARET, 6, 20);

  // Off screen, Menardi: "What happened?" Saturos: "Not again!" Jenna: the

  // water's gone. Alex: without the Elemental Stars the chamber is

  // collapsing. Kraden: is this the "terrible retribution"?

  SolSanctumEruption_SetMaterializationTint(1, 20, 20);

  SolSanctumEruption_SetMaterializationTint(0, 20, 40);

  Engine_EventSetMessage(MsgSolSanctumJennaWhatHappened);

  Engine_EventShowMessageAndWait(ACTOR_MENARDI, 0, 20);

  Engine_EventShowMessage(ACTOR_SATUROS, 0);

  SolSanctumEruption_SetMaterializationTint(1, 20, 0);

  Event_ShowMessageAndWait(JENNA, 0, 20);

  SolSanctumEruption_SetMaterializationTint(0, 20, 0);

  Event_ShowMessageAndWait(ACTOR_ALEX, 0, 20);

  Event_ShowMessageAndWait(ACTOR_KRADEN, 0, 20);

  Engine_ActorFaceEachOther(ACTOR_PARTY_LEADER, GARET, 0);

  Engine_EventWait(40);

  Engine_ActorStartRepeatedMotion(ACTOR_PARTY_LEADER, 2);

  Engine_ActorRunRepeatedMotion(GARET, 2);

  Engine_EventWait(20);

  Actor_FaceDirection(ACTOR_PARTY_LEADER, FACING_NORTHWEST + FACING_STEP, 0);

  Actor_FaceDirection(GARET, FACING_NORTH + FACING_STEP, 30);

  SolSanctumEruption_SetMaterializationTint(1, 20, 0);

  Engine_ActorStartRepeatedMotion(ACTOR_PARTY_LEADER, 2);

  Engine_ActorRunRepeatedMotion(GARET, 2);

  Engine_EventWait(20);

  SolSanctumEruption_SetMaterializationTint(0, 20, 20);

  // The Wise One, a floating rock, appears over the chamber and the quake

  // stops.

  actor = Object_GetById(ACTOR_WISE_ONE);

  Engine_ActorSetSpriteFlags(actor, 0);

  Actor_SetPosition(ACTOR_WISE_ONE, PIXELS(325), PIXELS(302));

  actor = Object_GetById(ACTOR_WISE_ONE);

  actor->motionFlags = 5;

  sparkles->stopped = 1;

  Event_PlayCue(SE_289);

  Map_SetShake(-1, -1, 9 * Q16_ONE / 10);

  Engine_MapRenderWaitForValues();

  Engine_EventWait(150);

  // Menardi: "It's over... But what was it?" Jenna: "What is that?!?"

  // Saturos: "No!" The camera pans to the Wise One.

  Event_ShowMessageAndWait(ACTOR_MENARDI, 0, 20);

  Event_ShowMessage(JENNA, 0);

  Event_ShowMessageAndWait(ACTOR_SATUROS, 0, 10);

  Engine_ActorFaceEachOther(ACTOR_PARTY_LEADER, GARET, 20);

  Actor_FaceDirection(ACTOR_PARTY_LEADER, FACING_SOUTHEAST + FACING_STEP, 0);

  Actor_FaceDirection(GARET, FACING_SOUTHEAST + FACING_STEP, 10);

  SolSanctumEruption_PlaceHostageGroup();

  Camera_SetSpeed(PIXELS(32) / 5, PIXELS(4) / 5);

  Camera_MoveTo(PIXELS(328), -1, PIXELS(299), 1);

  Engine_CameraWaitForMove();

  Event_PlayCue(SE_SCENE_TRANSITION);

  ColorBuffer_ApplyTarget(0x205294, 2);

  Engine_ColorBufferInterpolate(20);

  Engine_TaskWait(20);

  ColorBuffer_ApplyTarget(PALETTE_TRANSFORM_PLAIN, 2);

  Engine_ColorBufferInterpolate(20);

  Engine_EventWait(200);

  // Garet: "That rock... It's floating... Do you know what it is?" Yes:

  // "Yeah, I know it's a rock, stupid!" No: someone is lifting it with

  // Psynergy. Kraden: "Could that be... the Wise One?!?"

  Event_OpenMessage(SPEAKER_PORTRAIT_LEFT | GARET, 0);

  if (Engine_EventChooseYesNo(0, 0) == 0) {

    Engine_EventSetMessage(MsgSolSanctumIKnowItsARock);

  } else {

    Engine_EventSetMessage(MsgSolSanctumSomeoneIsLiftingIt);

  }

  Event_ShowMessageAndWait(SPEAKER_PORTRAIT_LEFT | GARET, 0, 80);

  Engine_EventSetMessage(MsgSolSanctumKradenCouldThatBeThe);

  Event_ShowMessageAndWait(ACTOR_KRADEN, 0, 20);

  SolSanctumEruption_SetMaterializationTint(1, 20, 0);

  sparkles->stopped = 0;

  Event_PlayCue(SE_141);

  Map_SetShake(PIXELS(1), PIXELS(2), Q16_ONE);

  Engine_EventWait(80);

  sparkles->stopped = 1;

  Event_PlayCue(SE_289);

  Map_SetShake(-1, -1, 9 * Q16_ONE / 10);

  Engine_MapRenderWaitForValues();

  SolSanctumEruption_SetMaterializationTint(0, 20, 60);

  // Alex: "Such power... Incredible!" Garet: "!!!" Jenna: "Wow..."

  Event_ShowMessageAndWait(ACTOR_ALEX, 0, 30);

  Actor_FaceDirection(ACTOR_WISE_ONE, FACING_NORTHWEST, 40);

  SolSanctumEruption_SetMaterializationTint(1, 20, 20);

  SolSanctumEruption_SetMaterializationTint(0, 20, 20);

  Event_ShowMessageAndWait(SPEAKER_PORTRAIT_LEFT | GARET, 0, 30);

  Actor_FaceDirection(ACTOR_WISE_ONE, FACING_EAST + FACING_STEP, 40);

  SolSanctumEruption_SetMaterializationTint(1, 20, 20);

  SolSanctumEruption_SetMaterializationTint(0, 20, 20);

  Event_ShowMessageAndWait(JENNA, 0, 30);

  // Embers start to rain from the Wise One.

  SolSanctumEruption_ResetEmberEmission();

  Task_AddCallback(SolSanctumEruption_StepEmbers, 0xc80);

  Task_AddCallback(SolSanctumEruption_UpdateEmberFrequency, 0xc80);

  Engine_EventWait(240);

  // Saturos: "It must be the guardian of the Elemental Stars!" The camera

  // moves to his group, all facing west.

  Event_ShowMessageAndWait(ACTOR_SATUROS, 0, 30);

  SolSanctumEruption_PlaceHostageGroup();

  Actor_FaceDirection(JENNA, FACING_WEST, 0);

  Actor_FaceDirection(ACTOR_KRADEN, FACING_WEST, 0);

  Actor_FaceDirection(ACTOR_MENARDI, FACING_WEST, 0);

  Actor_FaceDirection(ACTOR_SATUROS, FACING_WEST, 0);

  Actor_FaceDirection(ACTOR_FELIX, FACING_WEST, 0);

  Actor_FaceDirection(ACTOR_ALEX, FACING_WEST, 0);

  actor = Object_GetById(JENNA);

  Camera_MoveTo(actor->x.part.pixel * PIXELS(1), -1,

                actor->z.part.pixel * PIXELS(1), 1);

  Engine_CameraWaitForMove();

  Engine_EventWait(40);

  Engine_ActorRunRepeatedMotion(ACTOR_FELIX, 2);

  Engine_EventWait(20);

  // Felix: they should escape while they can. Menardi: not without the Mars

  // Star. Alex sides with Felix, and Saturos agrees to leave it.

  Event_ShowMessage(ACTOR_FELIX, 0);

  Engine_ActorRunRepeatedMotion(ACTOR_MENARDI, 2);

  Event_ShowMessageAndWait(ACTOR_MENARDI, 0, 10);

  Engine_ActorSetAnimation(ACTOR_ALEX, 4);

  Event_ShowMessageAndWait(ACTOR_ALEX, 0, 20);

  Engine_ActorFaceEachOther(ACTOR_SATUROS, ACTOR_MENARDI, 40);

  Engine_ActorSetAnimation(ACTOR_SATUROS, 4);

  Event_ShowMessageAndWait(ACTOR_SATUROS, 0, 10);

  // Jenna: "What about Isaac and Garet? You can't just leave them here!"

  Actor_ShowEmote(JENNA, EMOTE_IN_FRONT, 0);

  Actor_FaceDirection(JENNA, FACING_SOUTHEAST + FACING_STEP, 40);

  Event_ShowMessageAndWait(SPEAKER_WINDOW_ABOVE | JENNA, 0, 10);

  Actor_FaceDirection(ACTOR_SATUROS, FACING_NORTHWEST + FACING_STEP, 0);

  Actor_FaceDirection(ACTOR_MENARDI, FACING_NORTH + FACING_STEP, 40);

  Engine_ActorFaceEachOther(ACTOR_SATUROS, ACTOR_MENARDI, 40);

  Actor_ShowEmote(ACTOR_SATUROS, EMOTE_IN_FRONT | 5, 40);

  Actor_FaceDirection(ACTOR_SATUROS, FACING_NORTHWEST + FACING_STEP, 10);

  // Saturos: "Forget about them." Menardi: they might survive. Saturos: "So

  // what do you suggest we do?" Alex: take Jenna, and they will bring the

  // Star to get her back.

  Event_ShowMessageAndWait(ACTOR_SATUROS, 0, 10);

  Actor_FaceDirection(ACTOR_SATUROS, FACING_WEST, 10);

  Engine_ActorRunRepeatedMotion(ACTOR_MENARDI, 2);

  Event_ShowMessageAndWait(ACTOR_MENARDI, 0, 10);

  Engine_ActorSetAnimation(ACTOR_SATUROS, 3);

  Event_ShowMessageAndWait(ACTOR_SATUROS, 0, 40);

  Actor_FaceDirection(ACTOR_ALEX, FACING_NORTHWEST + FACING_STEP, 60);

  Engine_ActorSetAnimationAndWait(ACTOR_ALEX, 3);

  Event_ShowMessageAndWait(ACTOR_ALEX, 0, 10);

  Actor_FaceDirection(ACTOR_FELIX, FACING_SOUTHEAST + FACING_STEP, 0);

  Actor_FaceDirection(JENNA, FACING_SOUTHEAST + FACING_STEP, 0);

  Actor_FaceDirection(ACTOR_KRADEN, FACING_SOUTH + FACING_STEP, 0);

  Actor_FaceDirection(ACTOR_MENARDI, FACING_SOUTHEAST + FACING_STEP, 0);

  Actor_FaceDirection(ACTOR_SATUROS, FACING_SOUTH + FACING_STEP, 20);

  Actor_FaceDirection(ACTOR_ALEX, FACING_NORTH + FACING_STEP, 20);

  // Alex: "Regardless, Kraden must come with us."

  Engine_ActorSetAnimationAndWait(ACTOR_ALEX, 4);

  Event_ShowMessageAndWait(ACTOR_ALEX, 0, 10);

  Actor_ShowEmote(ACTOR_FELIX, EMOTE_IN_FRONT | 3, 0);

  // Felix steps forward: Alex is breaking their promise. Alex: conditions

  // have changed. Felix will not let them hurt Jenna; Kraden offers himself

  // in her place.

  Actor_SetSpeed(ACTOR_FELIX, PIXELS(1), PIXELS(1) / 2);

  Actor_WalkToAndWait(ACTOR_FELIX, 471, 314);

  Engine_ActorStartRepeatedMotion(ACTOR_FELIX, 3);

  Event_ShowMessageAndWait(ACTOR_FELIX, 0, 10);

  Actor_FaceDirection(ACTOR_ALEX, FACING_NORTHWEST + FACING_STEP, 10);

  Engine_ActorSetAnimation(ACTOR_ALEX, 4);

  Event_ShowMessageAndWait(ACTOR_ALEX, 0, 10);

  Engine_ActorStartRepeatedMotion(ACTOR_FELIX, 3);

  Event_ShowMessageAndWait(ACTOR_FELIX, 0, 10);

  Engine_ActorRunRepeatedMotion(ACTOR_KRADEN, 2);

  Event_ShowMessageAndWait(SPEAKER_WINDOW_ABOVE | ACTOR_KRADEN, 0, 10);

  Actor_FaceDirection(ACTOR_SATUROS, FACING_NORTHWEST + FACING_STEP, 20);

  // Saturos: "you cannot help Jenna now." Menardi: if they leave her, she

  // will die; is that what Felix wants?

  Event_ShowMessageAndWait(ACTOR_SATUROS, 0, 30);

  Actor_FaceDirection(ACTOR_MENARDI, FACING_EAST, 20);

  Engine_ActorRunRepeatedMotion(ACTOR_MENARDI, 2);

  Engine_EventWait(30);

  Engine_ActorSetAnimationAndWait(ACTOR_MENARDI, 3);

  Engine_EventWait(30);

  Actor_FaceDirection(ACTOR_MENARDI, FACING_NORTH + FACING_STEP, 30);

  Engine_ActorSetAnimationAndWait(ACTOR_MENARDI, 4);

  Engine_EventWait(10);

  Event_ShowMessageAndWait(ACTOR_MENARDI, 0, 10);

  Actor_FaceDirection(ACTOR_FELIX, FACING_SOUTH + FACING_STEP, 20);

  Engine_ActorRunRepeatedMotion(ACTOR_FELIX, 2);

  Engine_EventWait(20);

  Engine_ActorFaceEachOther(ACTOR_SATUROS, ACTOR_MENARDI, 0);

  Engine_EventWait(30);

  Engine_ActorSetAnimation(ACTOR_SATUROS, 3);

  Engine_ActorSetAnimationAndWait(ACTOR_MENARDI, 3);

  Actor_FaceDirection(ACTOR_MENARDI, FACING_NORTH + FACING_STEP, 0);

  Actor_FaceDirection(ACTOR_SATUROS, FACING_NORTHWEST + FACING_STEP, 0);

  Engine_EventWait(40);

  Engine_ActorRunRepeatedMotion(ACTOR_FELIX, 1);

  Engine_EventWait(30);

  Actor_FaceDirection(ACTOR_FELIX, FACING_WEST, 0);

  Engine_EventWait(40);

  Actor_ShowEmote(ACTOR_FELIX, EMOTE_IN_FRONT | 2, 0);

  Engine_EventWait(60);

  Actor_FaceDirection(ACTOR_ALEX, FACING_NORTHWEST + FACING_STEP, 0);

  Engine_EventWait(30);

  // Alex: "Perhaps we ought to continue this elsewhere, Felix." Jenna:

  // "Felix..." Alex: "Please...can we go now?"

  Engine_ActorSetAnimationAndWait(ACTOR_ALEX, 4);

  Event_ShowMessageAndWait(SPEAKER_PORTRAIT_RIGHT | ACTOR_ALEX, 0, 30);

  Actor_FaceDirection(ACTOR_KRADEN, FACING_NORTHWEST + FACING_STEP, 0);

  Actor_FaceDirection(JENNA, FACING_NORTHWEST + FACING_STEP, 0);

  Actor_FaceDirection(ACTOR_FELIX, FACING_SOUTHEAST + FACING_STEP, 20);

  Actor_ShowEmote(JENNA, EMOTE_IN_FRONT | 2, 40);

  Event_ShowMessageAndWait(SPEAKER_PORTRAIT_RIGHT | JENNA, 0, 40);

  Actor_ShowEmote(ACTOR_FELIX, EMOTE_IN_FRONT | 5, 60);

  Engine_ActorSetAnimationAndWait(ACTOR_FELIX, 3);

  Actor_ShowEmote(ACTOR_SATUROS, EMOTE_IN_FRONT | 1, 0);

  Actor_ShowEmote(ACTOR_MENARDI, EMOTE_IN_FRONT | 1, 60);

  Engine_ActorRunRepeatedMotion(ACTOR_ALEX, 2);

  Event_ShowMessageAndWait(ACTOR_ALEX, 0, 60);

  Engine_ActorSetAnimationAndWait(ACTOR_FELIX, 3);

  Engine_EventWait(40);

  Actor_ShowEmote(JENNA, EMOTE_IN_FRONT | 2, 0);

  Actor_ShowEmote(ACTOR_KRADEN, EMOTE_IN_FRONT | 2, 40);

  Engine_ActorFaceEachOther(ACTOR_SATUROS, ACTOR_MENARDI, 20);

  Engine_ActorSetAnimation(ACTOR_SATUROS, 3);

  Engine_ActorSetAnimationAndWait(ACTOR_MENARDI, 3);

  Engine_EventWait(20);

  Actor_SetSpeed(ACTOR_SATUROS, PIXELS(3) / 5, PIXELS(3) / 10);

  Actor_SetSpeed(ACTOR_MENARDI, PIXELS(3) / 5, PIXELS(3) / 10);

  Actor_WalkTo(ACTOR_MENARDI, 475, 348);

  Actor_WalkTo(ACTOR_SATUROS, 491, 348);

  Engine_ActorWaitForMove(ACTOR_MENARDI);

  Engine_ActorWaitForMove(ACTOR_SATUROS);

  Engine_ActorSetAnimation(ACTOR_MENARDI, 1);

  Engine_ActorSetAnimation(ACTOR_SATUROS, 1);

  Actor_FaceDirection(ACTOR_MENARDI, FACING_NORTH + FACING_STEP, 0);

  Actor_FaceDirection(ACTOR_SATUROS, FACING_NORTHWEST + FACING_STEP, 0);

  Actor_FaceDirection(ACTOR_FELIX, FACING_SOUTHEAST + FACING_STEP, 10);

  // Menardi: "Let's make haste!" She shoves Jenna, who stumbles away.

  Actor_ShowEmote(ACTOR_MENARDI, EMOTE_IN_FRONT | 3, 0);

  Engine_ActorRunRepeatedMotion(ACTOR_MENARDI, 2);

  Event_ShowMessage(SPEAKER_PORTRAIT_RIGHT | ACTOR_MENARDI, 0);

  Actor_SetSpeed(ACTOR_MENARDI, PIXELS(8) / 5, PIXELS(4) / 5);

  Actor_SetSpeed(JENNA, PIXELS(6) / 5, PIXELS(3) / 5);

  Actor_WalkToAndWait(ACTOR_MENARDI, 475, 338);

  actor = Object_GetById(ACTOR_MENARDI);

  actor->steeringFlags = 254 & actor->steeringFlags;

  Actor_WalkToAndWait(ACTOR_MENARDI, 475, 348);

  Engine_ActorRunRepeatedMotion(JENNA, 1);

  Engine_ActorJump(JENNA, 4, 0);

  Actor_WalkToAndWait(JENNA, 459, 316);

  Actor_SetSpeed(JENNA, PIXELS(1) / 2, PIXELS(1) / 4);

  // Felix: "Hey, don't push my sister!" Menardi: "You owe us your life!"

  // Saturos: "Menardi!"

  Actor_ShowEmote(ACTOR_FELIX, EMOTE_IN_FRONT | 3, 0);

  Engine_ActorStartRepeatedMotion(ACTOR_FELIX, 3);

  Event_ShowMessageAndWait(ACTOR_FELIX, 0, 30);

  Engine_ActorRunRepeatedMotion(ACTOR_MENARDI, 1);

  Engine_EventWait(20);

  actor->steeringFlags |= 1;

  Actor_SetSpeed(ACTOR_MENARDI, PIXELS(1), PIXELS(1) / 2);

  Actor_WalkToAndWait(ACTOR_MENARDI, 475, 332);

  Actor_FaceDirection(ACTOR_MENARDI, FACING_NORTHWEST + FACING_STEP, 20);

  Event_ShowMessage(SPEAKER_PORTRAIT_RIGHT | ACTOR_MENARDI, 0);

  Actor_FaceDirection(ACTOR_SATUROS, FACING_NORTHWEST + FACING_STEP, 0);

  Engine_ActorStartRepeatedMotion(ACTOR_SATUROS, 2);

  Event_ShowMessageAndWait(ACTOR_SATUROS, 0, 20);

  Actor_ShowEmote(ACTOR_MENARDI, EMOTE_IN_FRONT | 2, 20);

  Actor_FaceDirection(JENNA, FACING_SOUTHEAST + FACING_STEP, 0);

  Actor_FaceDirection(ACTOR_MENARDI, FACING_SOUTHEAST + FACING_STEP, 20);

  Engine_ActorSetAnimationAndWait(ACTOR_SATUROS, 4);

  Engine_ActorSetAnimationAndWait(ACTOR_MENARDI, 3);

  Actor_FaceDirection(ACTOR_MENARDI, FACING_NORTHWEST + FACING_STEP, 20);

  Engine_ActorSetAnimationAndWait(ACTOR_MENARDI, 3);

  Engine_ActorSetAnimationAndWait(ACTOR_FELIX, 3);

  Engine_EventWait(20);

  Actor_WalkTo(JENNA, 432, 316);

  Actor_WalkToAndWait(ACTOR_FELIX, 422, 311);

  Engine_ActorSetAnimation(JENNA, 1);

  Actor_FaceDirection(JENNA, FACING_SOUTHEAST + FACING_STEP, 0);

  Actor_FaceDirection(ACTOR_FELIX, FACING_SOUTHEAST + FACING_STEP, 20);

  // Felix leads Jenna aside. Saturos: "Master Kraden, you will be joining us,

  // of course!" All gather under the departure point.

  Engine_ActorRunRepeatedMotion(ACTOR_SATUROS, 2);

  Actor_FaceDirection(ACTOR_SATUROS, FACING_NORTH + FACING_STEP, 20);

  Event_ShowMessageAndWait(SPEAKER_PORTRAIT_LEFT | ACTOR_SATUROS, 0, 40);

  Engine_ActorRunRepeatedMotion(ACTOR_KRADEN, 2);

  Engine_EventWait(20);

  Actor_FaceDirection(ACTOR_KRADEN, FACING_NORTHWEST + FACING_STEP, 30);

  Actor_SetSpeed(ACTOR_KRADEN, PIXELS(1) / 2, PIXELS(1) / 4);

  Actor_WalkToAndWait(ACTOR_KRADEN, 491, 296);

  Actor_FaceDirection(ACTOR_KRADEN, FACING_SOUTH + FACING_STEP, 40);

  Actor_SetSpeed(ACTOR_SATUROS, PIXELS(1), PIXELS(1) / 2);

  Actor_SetSpeed(ACTOR_MENARDI, PIXELS(1), PIXELS(1) / 2);

  Actor_SetSpeed(ACTOR_FELIX, PIXELS(1), PIXELS(1) / 2);

  Actor_SetSpeed(ACTOR_ALEX, PIXELS(1), PIXELS(1) / 2);

  Actor_WalkToAndWait(ACTOR_SATUROS, 471, 308);

  Actor_FaceDirection(ACTOR_SATUROS, FACING_SOUTH + FACING_STEP, 0);

  Actor_WalkToAndWait(ACTOR_MENARDI, 455, 308);

  Actor_FaceDirection(ACTOR_MENARDI, FACING_SOUTHEAST + FACING_STEP, 0);

  Actor_WalkToAndWait(ACTOR_ALEX, 487, 308);

  Actor_FaceDirection(ACTOR_SATUROS, FACING_NORTH, 0);

  Actor_FaceDirection(ACTOR_MENARDI, FACING_NORTH + FACING_STEP, 0);

  Actor_FaceDirection(ACTOR_ALEX, FACING_NORTHWEST + FACING_STEP, 0);

  Actor_FaceDirection(JENNA, FACING_NORTH + FACING_STEP, 0);

  Actor_FaceDirection(ACTOR_FELIX, FACING_NORTH + FACING_STEP, 0);

  Camera_SetSpeed(PIXELS(1) / 2, PIXELS(1) / 16);

  Camera_MoveTo(PIXELS(472), -1, PIXELS(300), 1);

  Engine_CameraWaitForMove();

  Engine_EventWait(40);

  GameFlag_Set(FLAG_SCENE_TEMP_46);

  // One by one they rise out of the chamber: Saturos, Kraden, Menardi, then

  // Jenna ("Isaac, Garet! Don't die!") and Felix, and last Alex, who regrets

  // leaving the Mars Star.

  Actor_SetSpeed(ACTOR_SATUROS, PIXELS(1) / 2, PIXELS(1) / 4);

  Actor_SetSpeed(ACTOR_MENARDI, PIXELS(1) / 2, PIXELS(1) / 4);

  Actor_SetSpeed(ACTOR_ALEX, PIXELS(1) / 2, PIXELS(1) / 4);

  Engine_ActorSetAnimationAndWait(ACTOR_SATUROS, 3);

  SolSanctumEruption_RaiseAndShrinkActor(ACTOR_SATUROS);

  Engine_ActorRunRepeatedMotion(ACTOR_KRADEN, 2);

  SolSanctumEruption_RaiseAndShrinkActor(ACTOR_KRADEN);

  Engine_ActorSetAnimationAndWait(ACTOR_MENARDI, 3);

  SolSanctumEruption_RaiseAndShrinkActor(ACTOR_MENARDI);

  Actor_FaceDirection(JENNA, FACING_WEST + FACING_STEP, 40);

  Engine_ActorStartRepeatedMotion(JENNA, 2);

  Event_ShowMessageAndWait(SPEAKER_PORTRAIT_RIGHT | JENNA, 0, 40);

  Actor_FaceDirection(ACTOR_FELIX, FACING_SOUTHEAST + FACING_STEP, 0);

  Actor_FaceDirection(JENNA, FACING_NORTHWEST + FACING_STEP, 30);

  Actor_FaceDirection(ACTOR_FELIX, FACING_NORTHEAST, 0);

  SolSanctumEruption_RaiseAndShrinkActor(JENNA);

  SolSanctumEruption_RaiseAndShrinkActor(ACTOR_FELIX);

  Actor_FaceDirection(ACTOR_ALEX, FACING_SOUTHWEST + FACING_STEP, 40);

  Event_ShowMessageAndWait(ACTOR_ALEX, 0, 30);

  Engine_ActorSetAnimationAndWait(ACTOR_ALEX, 4);

  Engine_EventWait(20);

  Event_ShowMessageAndWait(ACTOR_ALEX, 0, 30);

  SolSanctumEruption_RaiseAndShrinkActor(ACTOR_ALEX);

  SolSanctumEruption_PlayWiseOneRescue();

  Party_RemoveOwnerRestored(JENNA);

}


/// Lifts one departing actor and shrinks it together with the paired effect.

static void SolSanctumEruption_RaiseAndShrinkActor(s32 actorId) {

  struct FieldActor *actor;

  struct FieldActor *departureEffect;

  struct FieldActor *spriteOwner;

  u8 frame;


  departureEffect = Object_GetById(ACTOR_TELEPORT_GLOW);

  departureEffect->scaleX = Q16_ONE;

  departureEffect->scaleY = Q16_ONE;

  Engine_ActorWalkToAndWait(actorId, 471, 290);

  Actor_FaceDirection(actorId, FACING_NORTH, 0);

  Engine_EventWait(10);

  Actor_SetPosition(ACTOR_TELEPORT_GLOW, PIXELS(471), PIXELS(290));

  actor = Object_GetById(actorId);

  spriteOwner = Object_GetById(actorId);

  Engine_ActorSetSpriteFlags(spriteOwner, 0);

  Actor_SetChildValue(actorId, 0x100);

  actor->motionFlags = 0;

  Event_PlayCue(SE_201);

  // Rise at full size, then shrink the actor and its departure effect together.

  frame = 0;

  do {

    actor->y.fixed += PIXELS(1) / 2;

    Engine_EventWait(1);

    frame++;

  } while (frame != 60);

  Event_PlayCue(SE_190);

  frame = 0;

  do {

    actor->y.fixed += PIXELS(1) / 10;

    actor->scaleX -= Q16_ONE / 100;

    actor->scaleY -= Q16_ONE / 100;

    departureEffect->scaleX -= Q16_ONE / 100;

    departureEffect->scaleY -= Q16_ONE / 100;

    Engine_EventWait(1);

    frame++;

  } while (frame != 90);

  Actor_SetPosition(actorId, 0, 0);

  Actor_SetPosition(ACTOR_TELEPORT_GLOW, 0, 0);

}


UNUSED static void SolSanctumEruption_UnusedCallbackA(void) {}


UNUSED static void SolSanctumEruption_UnusedCallbackB(void) {}


/// Plays the eruption at entrance 10, the arrival from the Elemental Star

/// room. Called by Field_RunScene once the actors exist.

s32 SolSanctumEruption_Initialize(void) {

  if (gGameState.entrance == 10) {

    FieldEffect_InitSparkles();

    SolSanctumEruption_PlayHostageScene();

  }

  return 0;

}


/// Keeps a flying ember sprite rotated a quarter-turn from its facing. Run by

/// each ember's object script, gEruption_EmberScript.

static s32

SolSanctumEruption_AlignEmberToHeading(struct ScriptInterpreter *interpreter) {

  struct FieldActor *actor = (struct FieldActor *)interpreter;

  actor->sprite->rotation = actor->facing + 0x4000;

  return 1;

}


/// Launches sixteen rocks outward, then resets their actors for ember emission.

static void SolSanctumEruption_ThrowEruptionRing(void) {

  struct FieldActor *actor;

  struct FieldActor *spun;

  u32 rockIndex;

  s32 angle;

  struct AnimationObject *sprite;

  s32 offsetX;

  s32 offsetZ;


  for (rockIndex = 16; rockIndex <= 31; rockIndex++) {

    actor = Object_GetById(rockIndex);

    Engine_ActorStop(rockIndex);

    Engine_ActorSetSpriteFlags(actor, 0);

    Object_SetMode(actor, 2);

    actor->sprite->image.priority = 0;

    actor->motionFlags = 0;

    actor->speed = PIXELS(8);

    actor->acceleration = PIXELS(3) / 4;

    actor->scaleX = 9 * Q16_ONE / 5;

    actor->scaleY = 9 * Q16_ONE / 5;

    actor->x.fixed = PIXELS(232);

    actor->y.fixed = PIXELS(20);

    actor->z.fixed = PIXELS(132);

  }

  Engine_AudioPlayCue(SE_145);

  for (rockIndex = 0; rockIndex <= 15; rockIndex++) {

    spun = Object_GetById(rockIndex + 16);

    sprite = spun->sprite;

    angle = rockIndex << 12;

    sprite->rotation = angle - 0x4000;

    offsetX = Iwram_MulQ16(Engine_MathCos(angle), PIXELS(256));

    offsetZ = Iwram_MulQ16(Engine_MathSin(angle), PIXELS(256));

    Engine_ObjectSetPosition(spun, spun->x.fixed + offsetX, spun->y.fixed,

                             spun->z.fixed + offsetZ);

  }

  Engine_EventWait(20);

  Engine_ActorWaitForMove(ACTOR_FIRST_ROCK);

  for (rockIndex = 16; rockIndex <= 31; rockIndex++) {

    actor = Object_GetById(rockIndex);

    Engine_ActorStop(rockIndex);

    actor->scaleX = Q16_ONE;

    actor->scaleY = Q16_ONE;

    actor->x.fixed = 0;

    actor->y.fixed = 0;

    actor->z.fixed = 0;

    SET_VELOCITY(actor, 0, 0, 0);

    actor->targetX = ACTOR_NO_TARGET;

    actor->targetY = ACTOR_NO_TARGET;

    actor->targetZ = ACTOR_NO_TARGET;

  }

}


/// Resets the sixteen ember slots and their emission timers.

static void SolSanctumEruption_ResetEmberEmission(void) {

  s32 *stateSlot;

  u32 emberIndex;


  gEmberMask = 63;

  gEmberTimer = 0;

  gEmberLevel = 0;

  gEmberLevelTimer = 120;

  stateSlot = gEmberState;

  for (emberIndex = 0; emberIndex < 16; emberIndex++) {

    *stateSlot++ = 0;

  }

}


/// Retires landed embers and launches the next free one at the current

/// frequency, shaking the map after each. Run each frame as a callback that

/// SolSanctumEruption_PlayHostageScene adds and

/// SolSanctumEruption_PlayWiseOneRescue removes.

static void SolSanctumEruption_StepEmbers(void) {

  struct GroundParticleWork *sparkles;

  s32 shakePixels;

  s32 shakeTimer;

  u8 emberIndex;

  struct FieldActor *landedEmber;

  struct FieldActor *ember;

  s16 angle;

  s32 x;

  s32 z;


  sparkles = gParticleWork;

  shakePixels = (u32)gEmberTimer / 10;

  if (shakePixels != 0) {

    sparkles->stopped = 0;

    Map_SetShake(shakePixels * PIXELS(1), shakePixels * PIXELS(1), Q16_ONE);

  } else {

    sparkles->stopped = 1;

    Map_SetShake(-1, -1, 9 * Q16_ONE / 10);

  }

  shakeTimer = gEmberTimer;

  if (shakeTimer != 0)

    gEmberTimer = shakeTimer - 3;


  for (emberIndex = 0; emberIndex < 16; emberIndex++) {

    if (gEmberState[emberIndex] != 0) {

      landedEmber = Object_GetById(emberIndex + 16);

      if (landedEmber->targetX == ACTOR_NO_TARGET &&

          landedEmber->targetZ == ACTOR_NO_TARGET) {

        gEmberState[emberIndex]++;

        if (gEmberState[emberIndex] == 2)

          Object_SetMode(landedEmber, 3);

        if (gEmberState[emberIndex] == 19) {

          landedEmber->x.fixed = 0;

          landedEmber->y.fixed = 0;

          landedEmber->z.fixed = 0;

          SET_VELOCITY(landedEmber, 0, 0, 0);

          landedEmber->targetX = ACTOR_NO_TARGET;

          landedEmber->targetY = ACTOR_NO_TARGET;

          landedEmber->targetZ = ACTOR_NO_TARGET;

          ObjectGroup_SetChildValue(landedEmber, 15);

        } else if (gEmberState[emberIndex] == 20) {

          gEmberState[emberIndex] = 0;

        }

      }

    }

  }


  if (gEmberMask == EMBER_EMISSION_DISABLED)

    return;

  if (gEmberMask & gFrameCount)

    return;

  for (emberIndex = 0; emberIndex < 16; emberIndex++) {

    angle = Math_RemainderUnsigned(Engine_RandomNext(), 0xffff);

    ember = Object_GetById(emberIndex + 16);

    if (gEmberState[emberIndex] == 0) {

      if (Engine_GameFlagIsSet(FLAG_SCENE_TEMP_46) == 0)

        Engine_AudioPlayCue(SE_246);

      gEmberState[emberIndex] = 1;

      ember->motionFlags = 0;

      ember->speed = PIXELS(8);

      ember->acceleration = PIXELS(1);

      Engine_ActorSetSpriteFlags(ember, 0);

      ember->sprite->image.priority = 1;

      Object_SetMode(ember, 2);

      Engine_ObjectSetScript(ember, gEruption_EmberScript);

      ember->x.fixed =

          Iwram_MulQ16(Engine_MathCos((u16)angle),

                       (((u32)(Engine_RandomNext() << 8) >> 16) << 16) +

                           PIXELS(256)) +

          PIXELS(325);

      ember->y.fixed = 0;

      ember->z.fixed =

          Iwram_MulQ16(Engine_MathSin((u16)angle),

                       (((u32)(Engine_RandomNext() << 8) >> 16) << 16) +

                           PIXELS(256)) +

          PIXELS(302);

      x = Iwram_MulQ16(Engine_MathCos((u16)angle),

                       ((Engine_RandomNext() & 63) << 16) + PIXELS(8));

      z = Iwram_MulQ16(Engine_MathSin((u16)angle),

                       ((Engine_RandomNext() & 63) << 16) + PIXELS(8));

      Engine_ObjectSetPosition(ember, x + PIXELS(325), 0, z + PIXELS(286));

      ObjectGroup_SetChildValue(ember, 0);

      gEmberTimer = 30;

      return;

    }

  }

}


/// Varies the ember emission interval and its duration. Run each frame as a

/// callback beside SolSanctumEruption_StepEmbers.

static void SolSanctumEruption_UpdateEmberFrequency(void) {

  u32 emissionLevel;


  if (gEmberLevelTimer != 0) {

    gEmberLevelTimer--;

    return;

  }

  if (gEmberLevel != 0) {

    gEmberLevel--;

  } else {

    gEmberLevel = (u32)(Engine_RandomNext() << 2) >> 16;

  }

  emissionLevel = gEmberLevel;

  switch (emissionLevel) {

  case 3:

    gEmberMask = emissionLevel;

    gEmberLevelTimer = ((u32)(Engine_RandomNext() * 20) >> 16) + 40;

    break;

  case 2:

    gEmberMask = 15;

    gEmberLevelTimer = ((u32)(Engine_RandomNext() * 40) >> 16) + 80;

    break;

  case 1:

    gEmberMask = 63;

    gEmberLevelTimer = ((u32)(Engine_RandomNext() * 80) >> 16) + 160;

    break;

  default:

    gEmberMask = 127;

    gEmberLevelTimer = ((u32)(Engine_RandomNext() * 160) >> 16) + 320;

    break;

  }

}


/// Ends the Wise One's palette animation and clears its attached effect.

static inline void SolSanctumEruption_FinishMaterialization(void) {

  Engine_ActorSetAnimationAndWait(ACTOR_WISE_ONE, 3);

  Engine_TaskRemoveCallback(SolSanctumEruption_UpdateWiseOnePalette);

  Engine_TaskWait(1);

  Actor_SetChildValue(ACTOR_WISE_ONE, 0);

}


/// Left behind, Isaac and Garet face the Wise One, who makes the Mars Star

/// glow, warns them of Alchemy's threat and sends them out as the volcano

/// erupts. Isaac keeps the Star. Called by SolSanctumEruption_PlayHostageScene.

/// Sets FLAG_SOL_SANCTUM_ERUPTED and FLAG_SOL_SANCTUM_STAR_ROOM_COLLAPSED and

/// takes exit 5, to the Luna and Sol rooms (scene 11, entrance 8).

static void SolSanctumEruption_PlayWiseOneRescue(void) {

  struct GroundParticleWork *sparkles;

  struct FieldActor *wiseOne;

  struct FieldActor *center;

  struct FieldActor *leader;

  struct FieldActor *starOrigin;

  struct FieldActor *garet;

  struct AnimationObject *leaderSprite;

  struct AnimationObject *garetSprite;

  struct FieldActor *star;

  struct AnimationObject *starSprite;

  u8 *iconPixels;

  u8 rockIndex;

  u32 frame;

  s32 flickerDelay;


  sparkles = gParticleWork;

  wiseOne = Actor_Get(ACTOR_WISE_ONE);

  // Clear the ember actors and bring Isaac and Garet back into view.

  Engine_TaskRemoveCallback(SolSanctumEruption_UpdateEmberFrequency);

  gEmberMask = 3;

  Engine_EventWait(80);

  Event_PlayCue(MUS_017);

  ColorBuffer_ApplyTarget(0x7fff, 0);

  Engine_ColorBufferInterpolate(40);

  Engine_EventWait(40);

  Engine_TaskRemoveCallback(SolSanctumEruption_StepEmbers);

  for (rockIndex = 0; rockIndex < ROCK_COUNT; rockIndex++) {

    Actor_SetPosition(ACTOR_FIRST_ROCK + rockIndex, 0, 0);

  }

  Engine_TaskWait(1);

  Actor_SetPosition(ACTOR_WISE_ONE, 0, 0);

  SolSanctumEruption_PlaceBeforeStar(ACTOR_PARTY_LEADER);

  SolSanctumEruption_PlaceBeforeStar(GARET);

  sparkles->stopped = 0;

  Map_SetShake(PIXELS(1), PIXELS(1), Q16_ONE);

  Engine_EventWait(80);

  SolSanctumEruption_RestoreCornerCellAttributes();

  center = Engine_EventGetViewCenter();

  center->motionFlags = 0;

  center->x.fixed = PIXELS(231);

  center->z.fixed = PIXELS(144);

  center->targetX = ACTOR_NO_TARGET;

  center->targetY = ACTOR_NO_TARGET;

  center->targetZ = ACTOR_NO_TARGET;

  center->y.fixed = 0;

  center->velocityX = 0;

  center->velocityZ = 0;

  Engine_TaskWait(4);

  Engine_MapRedraw();

  Engine_TaskWait(4);

  Engine_ActorSetSpritePriority(ACTOR_PARTY_LEADER, 3);

  Engine_ActorSetSpritePriority(GARET, 3);

  ColorBuffer_ApplyTarget(PALETTE_TRANSFORM_PLAIN, 0);

  Engine_ColorBufferInterpolate(40);

  Engine_EventWait(40);


  leader = Actor_Get(ACTOR_PARTY_LEADER);

  garet = Actor_Get(GARET);

  leaderSprite = leader->sprite;

  garetSprite = garet->sprite;

  for (frame = 0; frame < 20; frame++) {

    leaderSprite->rotation += 0x100;

    garetSprite->rotation -= 0x100;

    leader->x.fixed += PIXELS(3) / 8;

    garet->x.fixed -= PIXELS(3) / 8;

    Engine_TaskWait(1);

  }

  Engine_EventWait(40);

  Actor_SetSpeed(ACTOR_PARTY_LEADER, PIXELS(2), PIXELS(1));

  Actor_SetSpeed(GARET, PIXELS(2), PIXELS(1));

  Actor_Get(ACTOR_PARTY_LEADER)->sprite->rotation = 0;

  Actor_Get(GARET)->sprite->rotation = 0;

  Engine_ActorJump(ACTOR_PARTY_LEADER, 6, 0);

  Engine_ActorJump(GARET, 6, 0);

  Actor_SetDestination(ACTOR_PARTY_LEADER, 246, 150);

  Engine_ObjectMotionSetPositionAndCommit(GARET, 220, 150);

  Engine_ActorSetSpritePriority(ACTOR_PARTY_LEADER, 2);

  Engine_ActorSetSpritePriority(GARET, 2);

  Actor_Get(ACTOR_PARTY_LEADER)->priorityFlags |= ACTOR_PRIORITY_AUTOMATIC;

  Actor_Get(GARET)->priorityFlags |= ACTOR_PRIORITY_AUTOMATIC;

  Engine_ActorStop(ACTOR_PARTY_LEADER);

  Engine_ActorStop(GARET);

  Actor_FaceDirection(ACTOR_PARTY_LEADER, FACING_SOUTHEAST, 0);

  Engine_EventWait(20);

  Actor_FaceDirection(GARET, FACING_NORTHEAST, 0);

  Engine_EventWait(40);

  Actor_FaceDirection(ACTOR_PARTY_LEADER, FACING_WEST + FACING_STEP, 0);

  Engine_EventWait(40);

  Actor_FaceDirection(GARET, FACING_SOUTH + FACING_STEP, 0);

  Engine_EventWait(80);

  Actor_FaceDirection(ACTOR_PARTY_LEADER, FACING_WEST, 0);

  Engine_EventWait(10);

  Actor_FaceDirection(GARET, FACING_EAST + FACING_STEP, 0);

  Engine_EventWait(60);


  // Garet: "Well, this turned out badly, wouldn't you say?" Yes: "It's a

  // miracle we survived." No: "How can you be so calm?"

  Engine_ActorRunRepeatedMotion(GARET, 2);

  Engine_EventSetMessage(MsgSolSanctumWellTurnedBadly);

  Event_OpenMessage(GARET, 0);

  if (Engine_EventChooseYesNo(0, 0) == 0) {

    Engine_ActorSetAnimationAndWait(GARET, ANIM_NOD);

    Engine_EventSetMessage(MsgSolSanctumWellTurnedBadly + 1);

  } else {

    Engine_ActorRunRepeatedMotion(GARET, 1);

    Engine_EventSetMessage(MsgSolSanctumWellTurnedBadly + 2);

  }

  Event_ShowMessageAndWait(GARET, 0, 60);

  Actor_FaceDirection(GARET, FACING_SOUTHEAST + FACING_STEP, 0);

  Engine_EventWait(40);

  Engine_ActorJump(GARET, 2, 0);

  Actor_ShowEmote(GARET, EMOTE_IN_FRONT | 2, 0);

  Engine_EventWait(40);

  // Garet: "Jenna and Kraden are gone!"

  Engine_EventSetMessage(MsgSolSanctumFriendsGone);

  Event_ShowMessageAndWait(GARET, 0, 10);

  Engine_ActorJump(ACTOR_PARTY_LEADER, 2, 0);

  Engine_EventWait(10);

  Actor_FaceDirection(ACTOR_PARTY_LEADER, FACING_SOUTHEAST, 0);

  Engine_EventWait(60);

  Actor_ShowEmote(ACTOR_PARTY_LEADER, EMOTE_IN_FRONT | 2, 0);

  Engine_EventWait(80);

  Actor_FaceDirection(GARET, FACING_EAST + FACING_STEP, 0);

  Engine_EventWait(10);

  Engine_ActorRunRepeatedMotion(GARET, 2);

  // Garet: "You don't think they'll hurt Jenna and Kraden, do you?" Either

  // way, he trusts Felix to look after them.

  Event_OpenMessage(GARET, 0);

  if (Engine_EventChooseYesNo(0, 0) == 0) {

    Engine_EventWait(10);

    Engine_ActorRunRepeatedMotion(GARET, 2);

    Engine_EventWait(10);

    Actor_FaceDirection(GARET, FACING_SOUTHEAST + FACING_STEP, 0);

    Engine_EventWait(60);

    Actor_FaceDirection(GARET, FACING_EAST + FACING_STEP, 0);

    Engine_EventWait(10);

    Engine_ActorSetAnimation(GARET, ANIM_SHAKE_HEAD);

    Engine_EventSetMessage(MsgSolSanctumThanksALot);

  } else {

    Engine_EventWait(10);

    Engine_ActorRunRepeatedMotion(GARET, 2);

    Engine_EventWait(10);

    Actor_FaceDirection(GARET, FACING_SOUTHEAST + FACING_STEP, 0);

    Engine_EventWait(60);

    Actor_FaceDirection(GARET, FACING_EAST + FACING_STEP, 0);

    Engine_EventWait(10);

    Engine_ActorSetAnimation(GARET, ANIM_SHAKE_HEAD);

    Engine_EventSetMessage(MsgSolSanctumTheyllBeSafe);

  }

  Event_ShowMessageAndWait(GARET, 0, 40);

  Engine_ActorSetAnimation(ACTOR_PARTY_LEADER, ANIM_NOD);

  Engine_ActorSetAnimationAndWait(GARET, ANIM_NOD);

  Engine_EventWait(40);


  Actor_FaceDirection(ACTOR_PARTY_LEADER, FACING_WEST, 0);

  Actor_FaceDirection(GARET, FACING_SOUTHWEST + FACING_STEP, 0);

  // Pan around the chamber before another tremor interrupts the conversation.

  Camera_SetSpeed(PIXELS(2), PIXELS(1) / 4);

  Camera_MoveTo(PIXELS(284), -1, PIXELS(92), 1);

  Engine_CameraWaitForMove();

  Engine_EventWait(20);

  Actor_FaceDirection(ACTOR_PARTY_LEADER, FACING_SOUTHWEST, 0);

  Actor_FaceDirection(GARET, FACING_SOUTH + FACING_STEP, 0);

  Camera_SetSpeed(PIXELS(3) / 2, PIXELS(3) / 16);

  Camera_MoveTo(PIXELS(127), -1, PIXELS(162), 1);

  Engine_CameraWaitForMove();

  Engine_EventWait(40);

  Actor_FaceDirection(ACTOR_PARTY_LEADER, FACING_SOUTHEAST, 0);

  Actor_FaceDirection(GARET, FACING_SOUTHEAST + FACING_STEP, 0);

  Camera_SetSpeed(PIXELS(4), PIXELS(1) / 2);

  Camera_MoveTo(PIXELS(304), -1, PIXELS(294), 1);

  Engine_CameraWaitForMove();

  Engine_EventWait(20);

  Actor_FaceDirection(ACTOR_PARTY_LEADER, FACING_EAST, 0);

  Actor_FaceDirection(GARET, FACING_EAST + FACING_STEP, 0);

  Camera_SetSpeed(PIXELS(1), PIXELS(1) / 8);

  Camera_MoveTo(PIXELS(400), -1, PIXELS(215), 1);

  Engine_CameraWaitForMove();

  Engine_EventWait(60);

  Camera_SetSpeed(PIXELS(4), PIXELS(1) / 2);

  Camera_MoveTo(PIXELS(273), -1, PIXELS(145), 1);

  Engine_CameraWaitForMove();

  Engine_EventWait(20);

  // Garet: "This really is terrible..." and they have a long way to go.

  Engine_ActorRunRepeatedMotion(GARET, 2);

  Engine_EventSetMessage(MsgSolSanctumThisIsTerrible);

  Event_ShowMessageAndWait(GARET, 0, 20);

  Actor_FaceDirection(GARET, FACING_SOUTHEAST + FACING_STEP, 0);

  Engine_EventWait(40);

  Actor_FaceDirection(GARET, FACING_NORTH + FACING_STEP, 0);

  Engine_EventWait(20);

  Actor_FaceDirection(GARET, FACING_NORTHEAST + FACING_STEP, 0);

  Engine_EventWait(60);

  Actor_FaceDirection(GARET, FACING_SOUTHEAST + FACING_STEP, 0);

  Engine_EventWait(40);

  Actor_FaceDirection(GARET, FACING_NORTHEAST + FACING_STEP, 0);

  Engine_EventWait(10);

  Event_ShowMessageAndWait(GARET, 0, 10);

  Engine_ActorSetAnimationAndWait(ACTOR_PARTY_LEADER, ANIM_NOD);

  Engine_EventWait(10);


  // A violent tremor throws them aside.

  Event_PlayCue(MUS_023);

  SolSanctumEruption_SetMaterializationTint(1, 4, 0);

  sparkles->stopped = 0;

  Map_SetShake(PIXELS(5), PIXELS(5), Q16_ONE);

  Engine_EventWait(10);

  SolSanctumEruption_SetMaterializationTint(0, 40, 0);

  Actor_SetSpeed(ACTOR_PARTY_LEADER, PIXELS(2), PIXELS(1));

  Actor_SetSpeed(GARET, PIXELS(2), PIXELS(1));

  Engine_ActorJump(ACTOR_PARTY_LEADER, 6, 0);

  Engine_ActorJump(GARET, 6, 0);

  Actor_SetDestination(ACTOR_PARTY_LEADER, 243, 144);

  Actor_SetDestination(GARET, 202, 144);

  Engine_ActorWaitForMove(ACTOR_PARTY_LEADER);

  Engine_EventWait(20);

  sparkles->stopped = 1;

  Map_SetShake(PIXELS(1), PIXELS(1), Q16_ONE);

  Engine_EventWait(60);

  Actor_ShowEmote(ACTOR_PARTY_LEADER, EMOTE_IN_FRONT | 2, 0);

  Actor_ShowEmote(GARET, EMOTE_IN_FRONT | 2, 0);

  Engine_EventWait(80);

  Actor_SetSpeed(ACTOR_PARTY_LEADER, PIXELS(2) / 5, PIXELS(1) / 5);

  Actor_SetSpeed(GARET, PIXELS(2) / 5, PIXELS(1) / 5);

  Actor_WalkTo(GARET, 220, 150);

  Engine_ActorWalkToAndWait(ACTOR_PARTY_LEADER, 246, 150);

  Engine_ActorSetAnimation(GARET, ANIM_STAND);

  Actor_FaceDirection(ACTOR_PARTY_LEADER, FACING_WEST, 0);

  Actor_FaceDirection(GARET, FACING_SOUTHWEST + FACING_STEP, 0);

  Engine_EventWait(60);

  Engine_ActorRunRepeatedMotion(GARET, 2);

  Engine_EventWait(10);

  Actor_FaceDirection(GARET, FACING_SOUTHEAST + FACING_STEP, 0);

  Engine_EventWait(40);

  // Garet: "We're in big trouble..." Yes: "Let's get out of here..." No:

  // "Quit acting so tough!"

  Event_OpenMessage(GARET, 0);

  if (Engine_EventChooseYesNo(0, 0) == 0) {

    Actor_FaceDirection(GARET, FACING_EAST + FACING_STEP, 0);

    Engine_EventWait(10);

    Engine_ActorSetAnimationAndWait(GARET, ANIM_NOD);

  } else {

    Actor_FaceDirection(GARET, FACING_EAST + FACING_STEP, 0);

    Engine_EventWait(10);

    Engine_ActorSetAnimation(GARET, ANIM_SHAKE_HEAD);

    Engine_EventSetMessage(MsgSolSanctumQuitActingTough);

  }

  Engine_EventWait(20);

  Event_ShowMessage(GARET, 0);


  // The Wise One drifts in from the west, unseen by Isaac; Garet walks off

  // and calls him: "I'm over here. Come on, we've gotta go."

  Actor_SetPosition(ACTOR_WISE_ONE, PIXELS(110), PIXELS(152));

  Engine_TaskWait(1);

  Actor_SetSpeed(ACTOR_WISE_ONE, PIXELS(6) / 5, PIXELS(3) / 5);

  Actor_SetDestination(ACTOR_WISE_ONE, 171, 152);

  Actor_FaceDirection(ACTOR_WISE_ONE, FACING_EAST, 0);

  Engine_ActorSetSpriteFlags(Actor_Get(ACTOR_WISE_ONE), 1);

  Actor_SetSpeed(GARET, PIXELS(1), PIXELS(1) / 2);

  Actor_WalkTo(GARET, 217, 182);

  Actor_FaceDirection(ACTOR_PARTY_LEADER, FACING_SOUTHWEST + FACING_STEP, 0);

  Engine_EventWait(10);

  Camera_SetSpeed(PIXELS(2), PIXELS(1) / 4);

  Camera_MoveTo(PIXELS(217), -1, PIXELS(176), 1);

  Engine_CameraWaitForMove();

  Engine_EventWait(20);

  Actor_SetAttachedEffect(ACTOR_PARTY_LEADER, EMOTE_IN_FRONT | 2);

  Engine_EventWait(20);

  Engine_ActorJump(ACTOR_PARTY_LEADER, 2, 0);

  Engine_EventWait(10);

  Engine_ActorJump(ACTOR_PARTY_LEADER, 4, 0);

  Engine_EventWait(30);

  Actor_ShowEmote(GARET, EMOTE_IN_FRONT, 0);

  Engine_ActorSetAnimation(GARET, ANIM_STAND);

  Engine_EventWait(40);

  Actor_FaceDirection(GARET, FACING_SOUTHEAST, 0);

  Engine_EventWait(4);

  Engine_ActorWalkToAndWait(GARET, 231, 175);

  Actor_FaceDirection(GARET, FACING_NORTHEAST, 0);

  Engine_EventSetMessage(MsgSolSanctumOverHere);

  Event_ShowMessage(GARET, 0);

  Engine_EventWait(40);

  Actor_ShowEmote(GARET, EMOTE_IN_FRONT | 1, 0);

  Engine_EventWait(40);

  Actor_FaceDirection(GARET, FACING_NORTHWEST, 0);

  Engine_EventWait(60);

  Engine_ActorStartRepeatedMotion(GARET, 1);

  Actor_SetAttachedEffect(GARET, EMOTE_IN_FRONT | 2);

  Engine_EventWait(40);


  SolSanctumEruption_SetMaterializationTint(1, 20, 0);

  sparkles->stopped = 0;

  Map_SetShake(PIXELS(1), PIXELS(1), Q16_ONE);

  Engine_EventWait(40);

  Engine_ActorStartRepeatedMotion(ACTOR_PARTY_LEADER, 2);

  Engine_ActorStartRepeatedMotion(GARET, 2);

  Event_PlayCue(SE_289);

  ColorBuffer_ApplyTarget(PALETTE_TRANSFORM_PLAIN, 1);

  Engine_ColorBufferInterpolate(40);

  sparkles->stopped = 1;

  Map_SetShake(-1, -1, 9 * Q16_ONE / 10);

  Engine_EventWait(120);

  // The Wise One: "Why are you standing there?" and "This place has become

  // dangerous..." A jolt; Garet: "You're the dangerous one!"

  Event_ShowMessage(ACTOR_WISE_ONE, 0);

  Engine_EventWait(20);

  Actor_ShowEmote(ACTOR_PARTY_LEADER, EMOTE_IN_FRONT | 2, 0);

  Actor_ShowEmote(GARET, EMOTE_IN_FRONT | 2, 0);

  Engine_EventWait(100);

  Event_ShowMessage(ACTOR_WISE_ONE, 0);

  Engine_EventWait(20);

  SolSanctumEruption_SetMaterializationTint(1, 10, 0);

  sparkles->stopped = 0;

  Map_SetShake(PIXELS(2), PIXELS(2), Q16_ONE);

  Engine_EventWait(20);

  Actor_SetSpeed(ACTOR_PARTY_LEADER, PIXELS(2), PIXELS(1));

  Actor_SetSpeed(GARET, PIXELS(2), PIXELS(1));

  Actor_Get(ACTOR_PARTY_LEADER)->steeringFlags &= ~ACTOR_FACES_MOTION;

  Actor_Get(GARET)->steeringFlags &= ~ACTOR_FACES_MOTION;

  Engine_ActorJump(ACTOR_PARTY_LEADER, 4, 0);

  Engine_ActorJump(GARET, 4, 0);

  Actor_SetDestination(ACTOR_PARTY_LEADER, 256, 150);

  Actor_SetDestination(GARET, 231, 180);

  Engine_ActorWaitForMove(GARET);

  SolSanctumEruption_SetMaterializationTint(0, 40, 0);

  Engine_EventWait(20);

  Actor_Get(ACTOR_PARTY_LEADER)->steeringFlags |= ACTOR_FACES_MOTION;

  Actor_Get(GARET)->steeringFlags |= ACTOR_FACES_MOTION;

  Engine_ActorStartRepeatedMotion(ACTOR_PARTY_LEADER, 2);

  Engine_ActorRunRepeatedMotion(GARET, 2);

  Engine_EventWait(40);

  Actor_ShowEmote(GARET, EMOTE_IN_FRONT | 3, 0);

  Engine_EventWait(40);

  Event_ShowMessage(GARET, 0);

  Engine_EventWait(20);

  Actor_ShowEmote(ACTOR_WISE_ONE, EMOTE_IN_FRONT | 1, 0);

  Engine_EventWait(60);

  Actor_FaceDirection(ACTOR_PARTY_LEADER, FACING_SOUTH + FACING_STEP, 0);

  Actor_FaceDirection(GARET, FACING_NORTH + FACING_STEP, 0);

  Engine_EventWait(20);

  Actor_FaceDirection(ACTOR_PARTY_LEADER, FACING_WEST, 0);

  Actor_FaceDirection(GARET, FACING_NORTHWEST + FACING_STEP, 0);

  Engine_EventWait(10);


  // The floor by the Wise One starts to break up; the Wise One glows and

  // holds it together with Psynergy.

  Event_PlayCue(SE_107);

  FieldScheduler_AddCallback(SolSanctumEruption_FlickerFirstCollapseTiles,

                             TASK_PRIORITY_SCENE);

  Engine_EventWait(10);

  Actor_ShowEmote(ACTOR_WISE_ONE, EMOTE_IN_FRONT, 0);

  Engine_EventWait(40);

  Camera_SetSpeed(PIXELS(1), PIXELS(1) / 8);

  Camera_MoveTo(PIXELS(186), -1, PIXELS(166), 1);

  Actor_SetDestination(ACTOR_WISE_ONE, 130, 113);

  Engine_ActorWaitForMove(ACTOR_WISE_ONE);

  Actor_FaceDirection(ACTOR_WISE_ONE, FACING_SOUTHEAST + FACING_STEP, 0);

  Engine_EventWait(20);

  sparkles->stopped = 0;

  Map_SetShake(PIXELS(2), PIXELS(2), Q16_ONE);

  ColorBuffer_ApplyTarget(0x20119e, 1);

  Engine_ColorBufferInterpolate(20);

  Engine_EventWait(20);

  Scene_BeginCutscenePsynergy();

  Engine_ActorSetAnimationAndWait(ACTOR_WISE_ONE, 2);

  for (frame = 0; frame < 40; frame++) {

    SolSanctumEruption_FlashMaterializingActor(wiseOne);

    Engine_TaskWait(1);

  }

  FieldScheduler_AddCallback(SolSanctumEruption_UpdateWiseOnePalette,

                             TASK_PRIORITY_SCENE);

  ColorBuffer_ApplyTarget(PALETTE_TRANSFORM_PLAIN, 1);

  Engine_ColorBufferInterpolate(60);

  Engine_EventWait(30);

  Event_PlayCue(SE_289);

  Engine_TaskRemoveCallback(SolSanctumEruption_FlickerFirstCollapseTiles);

  Map_SetShake(PIXELS(1), PIXELS(1), Q16_ONE);

  flickerDelay = 16;

  while (flickerDelay--) {

    SolSanctumEruption_DrawFirstCollapseTiles(0);

    Engine_TaskWait(flickerDelay);

    SolSanctumEruption_DrawFirstCollapseTiles(1);

    Engine_TaskWait(flickerDelay);

  }

  SolSanctumEruption_DrawFirstCollapseTiles(0);

  sparkles->stopped = 1;

  Map_SetShake(-1, -1, 9 * Q16_ONE / 10);

  Engine_MapRenderWaitForValues();

  SolSanctumEruption_FinishMaterialization();

  Engine_EventWait(60);

  // The Wise One: "The volcano will soon erupt... I cannot hold it long."

  // and, after drifting closer, "You must leave this place."

  Event_ShowMessage(ACTOR_WISE_ONE, 0);

  Engine_EventWait(40);

  Actor_ShowEmote(ACTOR_PARTY_LEADER, EMOTE_IN_FRONT | 2, 0);

  Actor_ShowEmote(GARET, EMOTE_IN_FRONT | 2, 0);

  Engine_EventWait(60);

  Camera_SetSpeed(PIXELS(1), PIXELS(1) / 8);

  Camera_MoveTo(PIXELS(218), -1, PIXELS(181), 1);

  Actor_SetSpeed(ACTOR_WISE_ONE, PIXELS(1), PIXELS(1) / 2);

  Actor_SetDestination(ACTOR_WISE_ONE, 169, 151);

  Engine_ActorWaitForMove(ACTOR_WISE_ONE);

  Engine_EventWait(10);

  Actor_FaceDirection(ACTOR_WISE_ONE, FACING_EAST + FACING_STEP, 0);

  Engine_EventWait(40);

  Event_ShowMessage(ACTOR_WISE_ONE, 0);

  Engine_EventWait(20);

  Actor_FaceDirection(ACTOR_PARTY_LEADER, FACING_SOUTH + FACING_STEP, 0);

  Actor_FaceDirection(GARET, FACING_NORTH + FACING_STEP, 0);

  Engine_EventWait(40);

  Actor_FaceDirection(ACTOR_WISE_ONE, FACING_NORTHEAST + FACING_STEP, 0);

  Engine_EventWait(10);

  Actor_FaceDirection(ACTOR_PARTY_LEADER, FACING_SOUTHWEST + FACING_STEP, 0);

  Actor_FaceDirection(GARET, FACING_NORTHWEST + FACING_STEP, 0);

  Camera_MoveTo(PIXELS(224), -1, PIXELS(158), 1);

  Engine_CameraWaitForMove();

  // Lights rise at the chamber's first corner. The Wise One: the Elemental

  // Djinn have returned; "Take out the Elemental Star..." Refusing, "Isaac

  // cannot resist."

  SolSanctumEruption_RaiseElementalArcs(0);

  Engine_ActorRunRepeatedMotion(ACTOR_WISE_ONE, 2);

  Engine_EventWait(20);

  Event_ShowMessage(ACTOR_WISE_ONE, 0);

  Engine_EventWait(40);

  Event_OpenMessage(ACTOR_WISE_ONE, 0);

  if (Engine_EventChooseYesNo(0, 0) == 0) {

    Engine_EventWait(40);

  } else {

    Engine_MessageShowCentered(MsgSolSanctumCannotResist, 1);

    Engine_EventWait(40);

  }


  starOrigin = Actor_Get(ACTOR_PARTY_LEADER);

  // Lift the Mars Star icon and pulse its scale during the Wise One's effect.

  star = Object_Create(OBJECT_ELEMENTAL_STAR, starOrigin->x.fixed,

                       starOrigin->y.fixed + PIXELS(36), starOrigin->z.fixed);

  if (star != NULL) {

    iconPixels = Engine_HeapAllocate(17, 0x608);

    starSprite = star->sprite;

    starSprite->flags = 0;

    starSprite->count = 0;

    starSprite->image.fullColor = 0;

    starSprite->image.palette = 0;

    starSprite->image.priority = 1;

    Engine_ItemLoadIcon(ITEM_MARS_STAR);

    Engine_VramLoad(starSprite->slot, 128, iconPixels + 0x400);

    Engine_HeapRelease(17);

    Engine_ActorSetAnimation(ACTOR_PARTY_LEADER, 28);

    Engine_RunRisingObjectSequence(star, 3);

    Engine_ActorSetAnimation(ACTOR_PARTY_LEADER, 28);

  }

  SolSanctumEruption_SetMaterializationTint(1, 20, 0);

  for (frame = 0; frame < 24; frame++) {

    SolSanctumEruption_FlashMaterializingActor(wiseOne);

    Engine_TaskWait(1);

    SolSanctumEruption_FlashMaterializingActor(wiseOne);

    Engine_TaskWait(1);

    star->scaleX = 2 * Q16_ONE / 5;

    star->scaleY = 2 * Q16_ONE / 5;

    SolSanctumEruption_FlashMaterializingActor(wiseOne);

    Engine_TaskWait(1);

    SolSanctumEruption_FlashMaterializingActor(wiseOne);

    Engine_TaskWait(1);

    star->scaleX = Q16_ONE;

    star->scaleY = Q16_ONE;

  }

  Actor_SetChildValue(ACTOR_WISE_ONE, 0);

  SolSanctumEruption_SetMaterializationTint(0, 20, 0);

  // The Wise One: "Return it to its bag." and the Elemental Stars are moving

  // away from here.

  Engine_EventSetMessage(MsgSolSanctumReturnStarToBag);

  Event_ShowMessageAndWait(ACTOR_WISE_ONE, 0, 20);

  if (star != NULL) {

    Engine_ObjectDispatchRelease(star);

  }

  Engine_ActorSetAnimation(ACTOR_PARTY_LEADER, ANIM_STAND);

  Engine_EventWait(20);

  Actor_FaceDirection(ACTOR_PARTY_LEADER, FACING_WEST, 0);

  Actor_FaceDirection(GARET, FACING_NORTHWEST, 60);

  Event_ShowMessage(ACTOR_WISE_ONE, 0);

  Engine_EventWait(40);


  // The camera visits the other three corners as lights rise there. The Wise

  // One: the magma flows freely, there will be no chamber for the Stars to

  // return to, and the world is exposed to Alchemy. Garet: "Alchemy? A

  // threat?"

  Actor_FaceDirection(ACTOR_WISE_ONE, FACING_SOUTH, 0);

  Camera_SetSpeed(PIXELS(4), PIXELS(1) / 2);

  SolSanctumEruption_FadeCameraTo(232, 464);

  SolSanctumEruption_RaiseElementalArcs(1);

  Event_ShowMessage(ACTOR_WISE_ONE, 0);

  SolSanctumEruption_FadeCameraTo(711, 144);

  SolSanctumEruption_RaiseElementalArcs(2);

  Event_ShowMessage(ACTOR_WISE_ONE, 0);

  SolSanctumEruption_FadeCameraTo(711, 464);

  SolSanctumEruption_RaiseElementalArcs(3);

  Event_ShowMessage(ACTOR_WISE_ONE, 0);

  Actor_FaceDirection(ACTOR_WISE_ONE, FACING_EAST + FACING_STEP, 0);

  Actor_SetPosition(GARET, PIXELS(582), PIXELS(345));

  Engine_EventWait(20);

  Event_ShowMessage(GARET, 0);

  Actor_SetPosition(GARET, PIXELS(231), PIXELS(180));

  Actor_FaceDirection(GARET, FACING_NORTHWEST + FACING_STEP, 0);

  Engine_TaskWait(20);

  // Back with the party, the Wise One: misused, Alchemy is dangerous; its

  // power is released if the Stars light the four lighthouses.

  SolSanctumEruption_FadeCameraTo(219, 171);

  Event_ShowMessage(ACTOR_WISE_ONE, 0);

  Engine_EventWait(10);

  Engine_ActorStartRepeatedMotion(ACTOR_PARTY_LEADER, 2);

  Engine_ActorRunRepeatedMotion(GARET, 2);

  Event_ShowMessage(ACTOR_WISE_ONE, 0);

  Engine_EventWait(20);

  Event_ShowMessage(ACTOR_WISE_ONE, 0);

  Engine_EventWait(40);


  sparkles->stopped = 0;

  Map_SetShake(PIXELS(4), PIXELS(4), Q16_ONE);

  ColorBuffer_ApplyTarget(0x20119e, 1);

  Engine_ColorBufferInterpolate(20);

  Engine_EventWait(20);

  // The floor breaks up again in two places; the Wise One floats to each and

  // holds it together.

  Event_PlayCue(SE_107);

  FieldScheduler_AddCallback(SolSanctumEruption_FlickerSecondCollapseTiles,

                             TASK_PRIORITY_SCENE);

  Engine_EventWait(20);

  Camera_SetSpeed(PIXELS(1), PIXELS(1) / 8);

  Camera_MoveTo(PIXELS(184), -1, PIXELS(132), 1);

  Engine_ActorJump(ACTOR_PARTY_LEADER, 6, 0);

  Engine_ActorJump(GARET, 6, 0);

  Actor_Get(ACTOR_PARTY_LEADER)->steeringFlags &= ~ACTOR_FACES_MOTION;

  Actor_Get(GARET)->steeringFlags &= ~ACTOR_FACES_MOTION;

  Actor_SetDestination(ACTOR_PARTY_LEADER, 245, 145);

  Actor_SetDestination(GARET, 215, 168);

  Engine_ActorWaitForMove(GARET);

  Engine_EventWait(80);

  Actor_Get(ACTOR_PARTY_LEADER)->steeringFlags |= ACTOR_FACES_MOTION;

  Actor_Get(GARET)->steeringFlags |= ACTOR_FACES_MOTION;

  Actor_SetDestination(ACTOR_WISE_ONE, 184, 87);

  Engine_ActorWaitForMove(ACTOR_WISE_ONE);

  Actor_FaceDirection(ACTOR_WISE_ONE, FACING_SOUTH, 0);

  Engine_EventWait(20);

  Engine_ActorSetAnimationAndWait(ACTOR_WISE_ONE, 2);

  for (frame = 0; frame < 40; frame++) {

    SolSanctumEruption_FlashMaterializingActor(wiseOne);

    Engine_TaskWait(1);

  }

  FieldScheduler_AddCallback(SolSanctumEruption_UpdateWiseOnePalette,

                             TASK_PRIORITY_SCENE);

  ColorBuffer_ApplyTarget(PALETTE_TRANSFORM_PLAIN, 1);

  Engine_ColorBufferInterpolate(60);

  Engine_EventWait(30);

  Event_PlayCue(SE_289);

  Engine_TaskRemoveCallback(SolSanctumEruption_FlickerSecondCollapseTiles);

  Map_SetShake(PIXELS(2), PIXELS(2), Q16_ONE);

  flickerDelay = 8;

  while (flickerDelay--) {

    SolSanctumEruption_DrawSecondCollapseTiles(0);

    Engine_TaskWait(flickerDelay);

    SolSanctumEruption_DrawSecondCollapseTiles(1);

    Engine_TaskWait(flickerDelay);

  }

  SolSanctumEruption_DrawSecondCollapseTiles(0);

  Map_SetShake(PIXELS(1), PIXELS(1), Q16_ONE);

  SolSanctumEruption_FinishMaterialization();

  Engine_EventWait(60);


  Map_SetShake(PIXELS(4), PIXELS(4), Q16_ONE);

  ColorBuffer_ApplyTarget(0x20119e, 1);

  Engine_ColorBufferInterpolate(20);

  Engine_EventWait(20);

  Event_PlayCue(SE_107);

  FieldScheduler_AddCallback(SolSanctumEruption_FlickerFirstCollapseTiles,

                             TASK_PRIORITY_SCENE);

  Engine_EventWait(40);

  Engine_ObjectMotionSetPositionAndCommit(ACTOR_WISE_ONE, 127, 110);

  Actor_FaceDirection(ACTOR_WISE_ONE, FACING_SOUTH, 0);

  Engine_EventWait(20);

  Engine_ActorSetAnimationAndWait(ACTOR_WISE_ONE, 2);

  for (frame = 0; frame < 40; frame++) {

    SolSanctumEruption_FlashMaterializingActor(wiseOne);

    Engine_TaskWait(1);

  }

  FieldScheduler_AddCallback(SolSanctumEruption_UpdateWiseOnePalette,

                             TASK_PRIORITY_SCENE);

  ColorBuffer_ApplyTarget(PALETTE_TRANSFORM_PLAIN, 1);

  Engine_ColorBufferInterpolate(60);

  Event_PlayCue(SE_289);

  Engine_EventWait(30);

  Engine_TaskRemoveCallback(SolSanctumEruption_FlickerFirstCollapseTiles);

  Map_SetShake(PIXELS(2), PIXELS(2), Q16_ONE);

  flickerDelay = 8;

  while (flickerDelay--) {

    SolSanctumEruption_DrawFirstCollapseTiles(0);

    Engine_TaskWait(flickerDelay);

    SolSanctumEruption_DrawFirstCollapseTiles(1);

    Engine_TaskWait(flickerDelay);

  }

  SolSanctumEruption_DrawFirstCollapseTiles(0);

  Map_SetShake(PIXELS(1), PIXELS(1), Q16_ONE);

  Event_PlayCue(SE_107);

  Event_PlayCue(MUS_063);

  Map_SetShake(PIXELS(4), PIXELS(4), Q16_ONE);

  ColorBuffer_ApplyTarget(0x20119e, 1);

  Engine_ColorBufferInterpolate(20);

  Engine_EventWait(20);

  Event_PlayCue(SE_107);

  FieldScheduler_AddCallback(SolSanctumEruption_FlickerSecondCollapseTiles,

                             TASK_PRIORITY_SCENE);

  SolSanctumEruption_FinishMaterialization();

  Engine_EventWait(60);

  Engine_ObjectMotionSetPositionAndCommit(ACTOR_WISE_ONE, 184, 87);

  Actor_FaceDirection(ACTOR_WISE_ONE, FACING_SOUTH, 0);

  Engine_EventWait(10);

  SolSanctumEruption_FinishMaterialization();

  Event_PlayCue(SE_141);

  Engine_EventWait(100);

  Actor_ShowEmote(ACTOR_PARTY_LEADER, EMOTE_IN_FRONT | 2, 0);

  Actor_ShowEmote(GARET, EMOTE_IN_FRONT | 2, 0);

  Engine_EventWait(60);

  // The Wise One: "It's erupting... Flee, now!" Garet: "But how..." The Wise

  // One: "I will help you..." It glows and the chamber fades to white.

  Event_ShowMessage(ACTOR_WISE_ONE, 0);

  Engine_ActorRunRepeatedMotion(GARET, 3);

  Event_ShowMessage(GARET, 0);

  Engine_EventWait(20);

  Event_PlayCue(SE_289);

  Actor_FaceDirection(ACTOR_WISE_ONE, FACING_SOUTHEAST + FACING_STEP, 0);

  Engine_EventWait(20);

  Event_ShowMessage(ACTOR_WISE_ONE, 0);

  Engine_EventWait(20);

  for (frame = 0; frame < 40; frame++) {

    SolSanctumEruption_FlashMaterializingActor(wiseOne);

    Engine_TaskWait(1);

  }

  FieldScheduler_AddCallback(SolSanctumEruption_UpdateWiseOnePalette,

                             TASK_PRIORITY_SCENE);

  Engine_EventWait(20);

  ColorBuffer_ApplyTarget(0x7fff, 2);

  // Fade the chamber away, stop its effects and leave through the rescue exit.

  Engine_ColorBufferInterpolate(60);

  Engine_TaskWait(100);

  ColorBuffer_ApplyTarget(0x7fff, 1);

  Engine_ColorBufferInterpolate(60);

  Engine_TaskWait(60);

  Engine_TaskRemoveCallback(SolSanctumEruption_UpdateWiseOnePalette);

  sparkles->stopped = 1;

  Map_SetShake(-1, -1, 9 * Q16_ONE / 10);

  Engine_MapRenderWaitForValues();

  Scene_EndCutscenePsynergy();

  GameFlag_Set(FLAG_SOL_SANCTUM_ERUPTED);

  GameFlag_Set(FLAG_SOL_SANCTUM_STAR_ROOM_COLLAPSED);

  Engine_EventRequestExit(5);

  // XXX: flag 0x100 is set nowhere else, and nothing in the repository reads

  // it by number; a read of its byte or range would say what it marks.

  GameFlag_Set(0x100);

}


/// Places an actor before the star, facing south, and draws it above the

/// chamber floor.

static void SolSanctumEruption_PlaceBeforeStar(s32 actor) {

  struct FieldActor *object;


  object = Object_GetById(actor);

  Engine_ActorSetPosition(actor, PIXELS(232), PIXELS(125));

  object->facing = FACING_SOUTH;

  Engine_ActorSetSpritePriority(actor, 3);

}


/// Selects the first collapsing tile patch and redraws the map.

static void SolSanctumEruption_DrawFirstCollapseTiles(s32 alternate) {

  if (alternate != 0) {

    s32 cellSize;

    cellSize = 1;

    Map_CopyCellsTo(8, 47, 64, 7, cellSize, cellSize);

    Map_CopyCellsTo(7, 48, 63, 8, 2, cellSize);

    Map_CopyCellsTo(7, 49, 63, 9, 2, cellSize);

  } else {

    s32 cellSize;

    cellSize = 1;

    Map_CopyCellsTo(56, 0, 64, 7, cellSize, cellSize);

    Map_CopyCellsTo(56, 0, 63, 8, cellSize, cellSize);

    Map_CopyCellsTo(56, 0, 63, 9, 2, cellSize);

    Map_CopyCellsTo(58, 25, 64, 8, cellSize, cellSize);

  }

  Engine_MapRedraw();

}


/// Selects the second collapsing tile patch and redraws the map.

static void SolSanctumEruption_DrawSecondCollapseTiles(s32 alternate) {

  if (alternate != 0) {

    s32 patchSize;

    patchSize = 2;

    Map_CopyCellsTo(9, 45, 65, 5, patchSize, patchSize);

    Map_CopyCellsTo(11, 46, 67, 6, 1, patchSize);

  } else {

    s32 patchSize;

    patchSize = 2;

    Map_CopyCellsTo(89, 2, 65, 5, patchSize, patchSize);

    Map_CopyCellsTo(102, 32, 67, 6, 1, patchSize);

  }

  Engine_MapRedraw();

}


/// Randomly alternates the first tile patch on even frames. Run each frame as

/// a callback while the floor breaks up, until the Wise One holds it.

static void SolSanctumEruption_FlickerFirstCollapseTiles(void) {

  if ((gFrameCount & 1) == 0) {

    if ((u32)Math_RemainderUnsigned(Engine_RandomNext(), 100) > 50) {

      SolSanctumEruption_DrawFirstCollapseTiles(1);

    } else {

      SolSanctumEruption_DrawFirstCollapseTiles(0);

    }

  }

}


/// Randomly alternates the second tile patch on even frames, as the first.

static void SolSanctumEruption_FlickerSecondCollapseTiles(void) {

  if ((gFrameCount & 1) == 0) {

    if ((u32)Math_RemainderUnsigned(Engine_RandomNext(), 100) > 50) {

      SolSanctumEruption_DrawSecondCollapseTiles(1);

    } else {

      SolSanctumEruption_DrawSecondCollapseTiles(0);

    }

  }

}


/// Stages and raises ten arc effects at one of the four chamber positions.

static void SolSanctumEruption_RaiseElementalArcs(u32 mode) {

  void Actor_ShowEmote(s32, s32, s32);

  void ColorBuffer_ApplyTarget(s32, s32);

  void Event_PlayCue(s32);


  u32 arcIndex, clear;

  s32 x, y, z;

  s32 *origin;

  struct FieldActor *actor;

  struct AnimationObject *sprite;


  for (arcIndex = 0; arcIndex <= 15; arcIndex++)

    Engine_ActorDestroy(arcIndex + 16);

  switch (mode) {

  case 0:

    ColorBuffer_ApplyTarget(0x4039d2, 1);

    break;

  case 1:

    ColorBuffer_ApplyTarget(0x4049d2, 1);

    break;

  case 2:

    ColorBuffer_ApplyTarget(0x404a4e, 1);

    break;

  case 3:

    ColorBuffer_ApplyTarget(0x403a52, 1);

    break;

  }

  Engine_ColorBufferInterpolate(60);

  Event_PlayCue(SE_214);

  arcIndex = 0;

  clear = arcIndex;

  for (origin = &gEruption_ArcOrigins[0]; arcIndex <= 9;

       arcIndex++, origin += 2) {

    x = origin[0];

    y = origin[1];

    z = 0;

    switch (mode) {

    case 0:

      x += PIXELS(232);

      z = PIXELS(144);

      break;

    case 1:

      x += PIXELS(232);

      z = PIXELS(464);

      break;

    case 2:

      x += PIXELS(711);

      z = PIXELS(144);

      break;

    case 3:

      x += PIXELS(711);

      z = PIXELS(464);

      break;

    }

    gArcEffectTimers[arcIndex] = clear;

    actor = Engine_ObjectCreate(284, x, y, z);

    gArcEffects[arcIndex] = actor;

    actor->motionFlags = clear;

    sprite = actor->sprite;

    sprite->flags = clear;

    sprite->image.priority = 1;

    Object_SetMode(actor, 6);

    Engine_TaskWait(6);

  }

  if (mode == 0) {

    Actor_ShowEmote(ACTOR_PARTY_LEADER, EMOTE_IN_FRONT, 0);

    Actor_ShowEmote(GARET, EMOTE_IN_FRONT, 0);

  }

  Engine_TaskWait(20);

  FieldScheduler_AddCallback(SolSanctumEruption_UpdateElementalArcs, 3200);

  Event_PlayCue(SE_246);

  gArcEffectTimers[0] = 1;

  Engine_TaskWait(6);

  gArcEffectTimers[1] = 1;

  Engine_TaskWait(6);

  gArcEffectTimers[2] = 1;

  Engine_TaskWait(6);

  gArcEffectTimers[3] = 1;

  Engine_TaskWait(6);

  gArcEffectTimers[4] = 1;

  Engine_TaskWait(6);

  gArcEffectTimers[5] = 1;

  Engine_TaskWait(6);

  gArcEffectTimers[6] = 1;

  Engine_TaskWait(6);

  gArcEffectTimers[7] = 1;

  Engine_TaskWait(6);

  gArcEffectTimers[8] = 1;

  Engine_TaskWait(6);

  gArcEffectTimers[9] = 1;

  Engine_TaskWait(6);

  for (;;) {

    for (arcIndex = 0; arcIndex <= 9; arcIndex++) {

      if (gArcEffectTimers[arcIndex] != 0) {

        arcIndex = ARC_SCAN_STILL_ACTIVE;

        break;

      }

    }

    if (arcIndex != ARC_SCAN_STILL_ACTIVE)

      break;

    Engine_TaskWait(1);

  }

  Engine_TaskWait(40);

  Engine_TaskRemoveCallback(SolSanctumEruption_UpdateElementalArcs);

  ColorBuffer_ApplyTarget(PALETTE_TRANSFORM_PLAIN, 1);

  Engine_ColorBufferInterpolate(40);

}


/// Stretches each active arc for eight frames, then lifts it out of view. Run

/// each frame as a callback while SolSanctumEruption_RaiseElementalArcs runs.

static void SolSanctumEruption_UpdateElementalArcs(void) {


  u32 arcIndex;

  s32 age;

  struct FieldActor *actor;


  for (arcIndex = 0; arcIndex <= 9; arcIndex++) {

    age = gArcEffectTimers[arcIndex];

    if (age != 0) {

      actor = gArcEffects[arcIndex];

      if ((u32)age <= 8) {

        actor->scaleX += -ELEMENTAL_ARC_SCALE_X_DECREASE;

        actor->scaleY += Q16_ONE / 2;

        actor->y.fixed += PIXELS(3) / 10;

        actor->targetY += PIXELS(3) / 10;

      } else {

        actor->y.fixed += PIXELS(20);

        actor->targetY += PIXELS(20);

      }

      age = gArcEffectTimers[arcIndex] + 1;

      gArcEffectTimers[arcIndex] = age;

      if ((u32)age > 14) {

        gArcEffectTimers[arcIndex] = 0;

      }

    }

  }

}


/// Fades out, moves the camera and its focus actor, then fades back in.

static void SolSanctumEruption_FadeCameraTo(s32 x, s32 z) {

  struct FieldActor *center;


  center = Engine_EventGetViewCenter();

  z *= PIXELS(1);

  x *= PIXELS(1);

  Engine_CameraMoveTo(x, -1, z, 1);

  Engine_ColorBufferApplyTarget(0, 0);

  Engine_ColorBufferInterpolate(20);

  Engine_TaskWait(40);

  center->x.fixed = x;

  center->z.fixed = z;

  center->targetX = ACTOR_NO_TARGET;

  center->targetZ = ACTOR_NO_TARGET;

  center->velocityX = 0;

  center->velocityZ = 0;

  Engine_TaskWait(5);

  Engine_MapRedraw();

  Engine_TaskWait(5);

  Engine_ColorBufferApplyTarget(PALETTE_TRANSFORM_PLAIN, 0);

  Engine_ColorBufferInterpolate(20);

  Engine_TaskWait(30);

}


/// Restores eight corner-cell attributes from the chamber templates.

static void SolSanctumEruption_RestoreCornerCellAttributes(void) {


  Map_CopyCellAttributes(14, 8, 1, 1, 10, 0);

  Map_CopyCellAttributes(14, 28, 1, 1, 11, 0);

  Map_CopyCellAttributes(44, 8, 1, 1, 12, 0);

  Map_CopyCellAttributes(44, 28, 1, 1, 13, 0);

  Map_CopyCellAttributes(13, 8, 1, 1, 14, 8);

  Map_CopyCellAttributes(13, 28, 1, 1, 14, 28);

  Map_CopyCellAttributes(43, 8, 1, 1, 44, 8);

  Map_CopyCellAttributes(43, 28, 1, 1, 44, 28);

}


/// Fades the object palette into or out of the materialization tint.

static void SolSanctumEruption_SetMaterializationTint(s32 enabled, s32 frames,

                                                      s32 waitFrames) {

  if (enabled == 1) {

    Engine_AudioPlayCue(SE_308);

    Engine_ColorBufferApplyTarget(0x203a52, 1);

  } else {

    Engine_AudioPlayCue(SE_289);

    Engine_ColorBufferApplyTarget(PALETTE_TRANSFORM_PLAIN, 1);

  }

  Engine_ColorBufferInterpolate(frames);

  if (waitFrames != 0) {

    Engine_EventWait(waitFrames);

  }

}


/// Flashes the palette and spawns paired vertical effects every sixteen frames.

static void

SolSanctumEruption_FlashMaterializingActor(struct FieldActor *actor) {

  if ((gFrameCount & 2) != 0) {

    Engine_ObjectSetPartPalettes(actor, 7);

  } else {

    Engine_ObjectSetPartPalettes(actor, 0);

  }

  if ((gFrameCount & 15) == 0) {

    SolSanctumEruption_SpawnEffectPair(actor);

  }

}


/// Cycles six palettes while spawning the actor's vertical effects.

static void SolSanctumEruption_CycleActorPalette(struct FieldActor *actor) {

  if (gFrameCount & 1) {

    Engine_ObjectSetPartPalettes(actor,

                                 Math_RemainderUnsigned(gFrameCount >> 1, 6));

  }

  if ((gFrameCount & 15) == 0) {

    SolSanctumEruption_SpawnEffectPair(actor);

  }

}


#include "common/effect_vertical.h"


/// Creates two vertical effects sharing the parent position and cached tiles.

static void SolSanctumEruption_SpawnEffectPair(struct FieldActor *parent) {

  struct FieldActor *pair[2];

  struct FieldActor *child;

  struct AnimationObject *sprite;

  struct BattleFxScene *work = gEffectWork;

  s32 effectIndex;


  Engine_AudioPlayCue(SE_292);

  for (effectIndex = 0; effectIndex < 2; ++effectIndex) {

    child = Engine_ObjectCreate(26, parent->x.fixed, parent->y.fixed,

                                parent->z.fixed);

    pair[effectIndex] = child;

    if (child != NULL) {

      child->terrainHeight = parent->terrainHeight;

      sprite = child->sprite;

      child->motionFlags = 0;

      child->timer = 0;

      child->linkedObject = parent;

      if (sprite != NULL) {

        AnimationObjects_SelectAnimation(sprite, 0);

        sprite->flags = 0;

        Resource_ResetEntry(sprite->slot);

        sprite->slot = work->tileSlot;

        sprite->retainCacheEntry = 1;

        sprite->image.tile =

            (gVramBlockCache[sprite->slot].offset >> 5) & 0x3ff;

        sprite->image.fullColor = 0;

        sprite->image.shape = 1;

        sprite->image.size = 2;

        sprite->entries[0]->frame = 0;

      }

    }

  }

  pair[0]->update = Effect_AnimateVerticalNegative;

  pair[0]->sprite->image.priority =

      Object_GetById(ACTOR_WISE_ONE)->sprite->image.priority;

  {

    struct FieldActor *wiseOne = Object_GetById(ACTOR_WISE_ONE);

    struct FieldActor *risingEffect = pair[1];


    risingEffect->sprite->image.priority = wiseOne->sprite->image.priority;

    risingEffect->update = Effect_AnimateVerticalPositive;

    risingEffect->priorityFlags = 2;

  }

}


#include "common/effect_psynergy.h"


/// Cycles the Wise One's palette while it glows. Run each frame as a callback

/// that SolSanctumEruption_PlayWiseOneRescue adds and

/// SolSanctumEruption_FinishMaterialization removes.

static void SolSanctumEruption_UpdateWiseOnePalette(void) {

  SolSanctumEruption_CycleActorPalette(Object_GetById(ACTOR_WISE_ONE));

}


#include "common/sol_sanctum_elemental_star_ring_setup.h"


s32 gEruption_ArcOriginsHead[] = {

    SC_SET(SW_VELOCITY_Y, PIXELS(6)),

    SC_LABEL(1),

    SC_ADD(SW_SCALE_X, 2621),

    SC_ADD(SW_SCALE_Y, 2621),

    SC_WAIT(1),

    SC_LOOP(18, SC_TO(1)),

    SC_SET(SW_SCALE_X, Q16_ONE),

    SC_SET(SW_SCALE_Y, Q16_ONE),

    SC_END,

};


// clang-format off

s32 gEruption_ArcOrigins[] = {

    -PIXELS(6), 0,

    PIXELS(10), PIXELS(10),

    PIXELS(8), PIXELS(25),

    PIXELS(4), PIXELS(30),

    -PIXELS(5), PIXELS(20),

    PIXELS(2), PIXELS(5),

    -PIXELS(6), PIXELS(35),

    -PIXELS(8), PIXELS(15),

    PIXELS(2), PIXELS(40),

    -PIXELS(2), PIXELS(15),

};


struct SceneEntrance gSolSanctumEruption_Entrances[] = {

    { 0, CONDITION_ALWAYS, 472, 0, 322, FACING_SOUTH, 0, -1, -1, -1, -1, 0 },

    { SCENE_TABLE_END },

};


u32 gSolSanctumEruption_Exits[] = {

    SCENE_EXITS(18),

    SCENE_EXIT(5, 11, 8),

    SCENE_EXITS_END,

};


struct ScenePlacement gSolSanctumEruption_Placements[] = {

    { GARET, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_SOUTH, TALK_FACE_PARTY, 0 },

    { JENNA, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_SOUTH, TALK_FACE_PARTY, 0 },

    { 0x16, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_EAST, TALK_FACE_PARTY, 0 },

    { 0x1e, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_SOUTH, TALK_FACE_PARTY, 0 },

    { 0x20, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_SOUTH, TALK_FACE_PARTY, 0 },

    { 0x21, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_SOUTH, TALK_FACE_PARTY, 0 },

    { 0x22, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_SOUTH, TALK_FACE_PARTY, 0 },

    { 0x23, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_SOUTH, TALK_FACE_PARTY, 0 },

    { 0x2b, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_SOUTH, TALK_FACE_PARTY, 0 },

    { 0xfc, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_SOUTH, TALK_FACE_PARTY, 0 },

    { 0xd8, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_EAST, TALK_FACE_PARTY, 0 },

    { 0xd8, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_EAST, TALK_FACE_PARTY, 0 },

    { 0xd8, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_EAST, TALK_FACE_PARTY, 0 },

    { 0xd8, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_EAST, TALK_FACE_PARTY, 0 },

    { 0xd8, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_EAST, TALK_FACE_PARTY, 0 },

    { 0xd8, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_EAST, TALK_FACE_PARTY, 0 },

    { 0xd8, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_EAST, TALK_FACE_PARTY, 0 },

    { 0xd8, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_EAST, TALK_FACE_PARTY, 0 },

    { 0xd8, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_EAST, TALK_FACE_PARTY, 0 },

    { 0xd8, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_EAST, TALK_FACE_PARTY, 0 },

    { 0xd8, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_EAST, TALK_FACE_PARTY, 0 },

    { 0xd8, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_EAST, TALK_FACE_PARTY, 0 },

    { 0xd8, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_EAST, TALK_FACE_PARTY, 0 },

    { 0xd8, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_EAST, TALK_FACE_PARTY, 0 },

    { 0xd8, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_EAST, TALK_FACE_PARTY, 0 },

    { 0xd8, CONDITION_ALWAYS, ACTOR_STAND,

        0, 0, 0, FACING_EAST, TALK_FACE_PARTY, 0 },

    { SCENE_TABLE_END },

};


struct SceneEvent gSolSanctumEruption_Events[] = {

    { SCENE_EVENTS_END },

};


u16 gSolSanctumEruption_StarCells[] = {

    MAP_CELL_STEP(59, 40, 3, 4, 6), MAP_CELL_STEP(62, 40, 3, 4, 6), MAP_CELL_STEP(65, 40, 3, 4, 6), MAP_CELL_STEP(68, 40, 3, 4, 6), MAP_CELL_STEP(71, 40, 3, 4, 6), MAP_CELL_STEP(74, 40, 3, 4, 6), MAP_CELL_STEP(77, 40, 3, 4, 6), MAP_CELL_STEP(80, 40, 3, 4, 6), MAP_CELL_STEP(83, 40, 3, 4, 0), MAP_CELL_STEPS_END,

};


s32 gEruption_EmberScript[] = {

    SC_CALL(SolSanctumEruption_AlignEmberToHeading),

    SC_END,

};


u8 gSolSanctum_RingDrift[][3] = {

    { 4, 4, 4 },

    { 4, 0, 3 },

    { 4, 0, 4 },

    { 4, 0, 4 },

    { 3, 0, 4 },

    { 4, 6, 4 },

    { 6, 0, 4 },

    { 4, 0, 3 },

    { 2, 0, 1 },

    { 2, 0, 2 },

};


u8 gSolSanctum_RingSwing[][3] = {

    { 1, 1, 2 },

    { 1, 0, 2 },

    { 1, 0, 2 },

    { 1, 0, 1 },

    { 1, 0, 2 },

    { 1, 1, 2 },

    { 1, 0, 2 },

    { 1, 0, 2 },

    { 1, 0, 2 },

    { 1, 0, 2 },

};


s8 gSolSanctum_RingDirection[][3] = {

    { 1, 1, 1 },

    { 1, 0, 1 },

    { 1, 0, 1 },

    { -1, 0, 1 },

    { -1, 0, -1 },

    { 1, 1, 1 },

    { -1, 0, -1 },

    { -1, 0, -1 },

    { -1, 0, -1 },

    { -1, 0, -1 },

};


s32 gSolSanctumRing_MaxScales[] = {

    3 * Q16_ONE / 5, 4 * Q16_ONE / 5, 7 * Q16_ONE / 10, 3 * Q16_ONE / 5, 4 * Q16_ONE / 5, 3 * Q16_ONE / 5, 7 * Q16_ONE / 10, 3 * Q16_ONE / 5,

    3 * Q16_ONE / 5, 7 * Q16_ONE / 10,

};


s32 gSolSanctumRing_ScaleSteps[] = {

    655, 458, 655, 458, 655, 458, 655, 655,

    524, 655,

};

// clang-format on

ObjectGroup_SetChildValue
void ObjectGroup_SetChildValue(struct FieldActor *actor, s32 param)
Sets the param byte of every animated part of an actor's sprite.
Definition actor_commands.c:775

Object_GetById
struct FieldActor * Object_GetById(s32 actor)
Returns an actor, or NULL if it does not exist.
Definition actor_commands.c:10

ACTOR_FIRST_ROCK
@ ACTOR_FIRST_ROCK
Definition altmiller_cave.c:84

AnimationObjects_SelectAnimation
s32 AnimationObjects_SelectAnimation(struct AnimationObject *sprite, s32 animation)
Starts animation flags & 0x7f on every layer of a sprite (bit 7 keeps each layer's place and timer),...
Definition animation.c:317

animspr.h
Animated sprites: their layers, frames and colour modes, and the resource slots they draw from.

b5_context.h
B5Context, the object context a battle routine reads; most of its fields are still unnamed.

GARET
#define GARET
Jerald.
Definition character_ids.h:8

JENNA
#define JENNA
Jasmine.
Definition character_ids.h:12

Engine_ActorSetSpriteFlags
void Engine_ActorSetSpriteFlags(struct FieldActor *, s32)

Engine_ObjectCreate
struct FieldActor * Engine_ObjectCreate(s32, s32, s32, s32)

debug.h
The engine calls the debug menus import, and their palette swatch tiles.

effect_vertical.h

FieldScheduler_AddCallback
static s32 FieldScheduler_AddCallback(SchedulerCallback callback, s32 priority)
Registers a main-image scheduler callback.
Definition engine_call.h:36

field_effect.h
Field effects, their scripts and the flags that spawn them.

field_event.h
The scene script layer: the engine services a scene's events call, declared once (Engine_EventBegin,...

Engine_ObjectSetPosition
void Engine_ObjectSetPosition(struct FieldActor *object, s32 fixed_x, s32 fixed_y, s32 fixed_z)

ANIM_STAND
@ ANIM_STAND
Definition field_event.h:43

ANIM_NOD
@ ANIM_NOD
Definition field_event.h:45

ANIM_SHAKE_HEAD
@ ANIM_SHAKE_HEAD
Definition field_event.h:46

SPEAKER_PORTRAIT_LEFT
#define SPEAKER_PORTRAIT_LEFT
Definition field_event.h:54

Math_RemainderUnsigned
u32 Math_RemainderUnsigned(u32 dividend, u32 divisor)

Event_OpenMessage
static s32 Event_OpenMessage(s32 speaker, s32 flags)
Definition field_event.h:217

Actor_SetDestination
static void Actor_SetDestination(s32 actor, s32 x, s32 z)
Definition field_event.h:237

Actor_FaceDirection
static void Actor_FaceDirection(s32 actor, s32 facing, s32 frames)
Definition field_event.h:255

Engine_ActorSetAnimationAndWait
void Engine_ActorSetAnimationAndWait(s32 actor, s32 animation)

Object_SetMode
void Object_SetMode(struct FieldActor *object, s32 animation)

SPEAKER_WINDOW_ABOVE
#define SPEAKER_WINDOW_ABOVE
Definition field_event.h:56

Engine_ActorSetSpritePriority
void Engine_ActorSetSpritePriority(s32 actor, s32 priority)

Event_ShowMessageAndWait
static void Event_ShowMessageAndWait(s32 speaker, s32 flags, s32 frames)
Definition field_event.h:350

Engine_EventChooseYesNo
s32 Engine_EventChooseYesNo(s32 actor, s32 flags)

Engine_MessageShowCentered
void Engine_MessageShowCentered(s32 message, s32 flags)

Engine_ObjectSetPartPalettes
void Engine_ObjectSetPartPalettes(struct FieldActor *object, s32 palette)

Engine_EventShowMessageAndWait
void Engine_EventShowMessageAndWait(s32 speaker, s32 flags, s32 frames)

SPEAKER_PORTRAIT_RIGHT
#define SPEAKER_PORTRAIT_RIGHT
Definition field_event.h:55

Actor_WalkToAndWait
static void Actor_WalkToAndWait(s32 actor, s32 x, s32 z)
Definition field_event.h:383

Camera_SetSpeed
static void Camera_SetSpeed(s32 speed, s32 acceleration)
Definition field_event.h:271

Engine_CameraMoveTo
void Engine_CameraMoveTo(s32 fixed_x, s32 fixed_y, s32 fixed_z, s32 pan)

Engine_TaskRemoveCallback
s32 Engine_TaskRemoveCallback(void(*callback)(void))

Engine_ActorJump
void Engine_ActorJump(s32 actor, s32 height, s32 frames)

Engine_ItemLoadIcon
void Engine_ItemLoadIcon(s32 item)

EMOTE_IN_FRONT
#define EMOTE_IN_FRONT
Definition field_event.h:49

Engine_MathSin
s32 Engine_MathSin(s32 angle)

MAP_CELL_STEP
#define MAP_CELL_STEP(srcX, srcY, width, height, frames)
Definition field_event.h:59

Engine_ObjectDispatchRelease
void Engine_ObjectDispatchRelease(struct FieldActor *object)

Map_CopyCellsTo
static void Map_CopyCellsTo(s32 srcX, s32 srcY, s32 destX, s32 destY, s32 width, s32 height)
Definition field_event.h:361

Engine_ActorWalkToAndWait
void Engine_ActorWalkToAndWait(s32 actor, s32 x, s32 z)

Engine_HeapRelease
void Engine_HeapRelease(s32 slot)

ColorBuffer_ApplyTarget
static void ColorBuffer_ApplyTarget(s32 value, s32 mode)
Definition field_event.h:375

Engine_VramLoad
s32 Engine_VramLoad(s32 block, s32 size, const void *data)

Actor_WalkTo
static void Actor_WalkTo(s32 actor, s32 x, s32 z)
Definition field_event.h:247

Engine_EventWaitForScreen
void Engine_EventWaitForScreen(void)

GameFlag_Set
#define GameFlag_Set
Definition field_event.h:297

Engine_ActorDestroy
void Engine_ActorDestroy(s32 actor)

Actor_ShowEmote
static void Actor_ShowEmote(s32 actor, s32 emote, s32 frames)
Definition field_event.h:263

Engine_ObjectSetScript
void Engine_ObjectSetScript(struct FieldActor *object, const s32 *script)

Engine_EventOpenScreen
void Engine_EventOpenScreen(void)

Engine_MapRenderWaitForValues
void Engine_MapRenderWaitForValues(void)

Engine_CameraWaitForMove
void Engine_CameraWaitForMove(void)

Engine_ActorWaitForMove
void Engine_ActorWaitForMove(s32 actor)

Engine_HeapAllocate
void * Engine_HeapAllocate(s32 slot, s32 size)

Map_CopyCellAttributes
static void Map_CopyCellAttributes(s32 srcX, s32 srcY, s32 width, s32 height, s32 destX, s32 destY)
Definition field_event.h:285

Engine_ActorStop
void Engine_ActorStop(s32 actor)

Engine_ActorRunRepeatedMotion
void Engine_ActorRunRepeatedMotion(s32 actor, s32 repeats)

Event_ShowMessage
static void Event_ShowMessage(s32 speaker, s32 flags)
Definition field_event.h:213

Engine_RandomNext
s32 Engine_RandomNext()

Event_PlayCue
static void Event_PlayCue(s32 cue)
Definition field_event.h:313

Map_SetShake
static void Map_SetShake(s32 horizontal, s32 vertical, s32 decay)
Sets shake amplitudes in fixed-point pixels and the per-frame decay factor.
Definition field_event.h:292

MAP_CELL_STEPS_END
#define MAP_CELL_STEPS_END
Definition field_event.h:61

Actor_SetChildValue
static void Actor_SetChildValue(s32 actor, s32 value)
Definition field_event.h:355

Engine_GameFlagIsSet
s32 Engine_GameFlagIsSet(s32 flag)

Engine_ActorStartRepeatedMotion
void Engine_ActorStartRepeatedMotion(s32 actor, s32 repeats)

Engine_RunRisingObjectSequence
void Engine_RunRisingObjectSequence(struct FieldActor *object, s32 mode)

Object_Create
static struct FieldActor * Object_Create(s32 type, s32 fixed_x, s32 fixed_y, s32 fixed_z)
Definition field_event.h:322

Engine_EventGetViewCenter
struct FieldActor * Engine_EventGetViewCenter(void)

Engine_MathCos
s32 Engine_MathCos(s32 angle)

Actor_SetSpeed
static void Actor_SetSpeed(s32 actor, s32 speed, s32 acceleration)
Definition field_event.h:233

Engine_ObjectMotionSetPositionAndCommit
void Engine_ObjectMotionSetPositionAndCommit(s32 actor, s32 x, s32 z)

TASK_PRIORITY_SCENE
@ TASK_PRIORITY_SCENE
Definition field_event.h:40

Engine_MapRedraw
void Engine_MapRedraw(void)

Engine_ColorBufferInterpolate
void Engine_ColorBufferInterpolate(s32 frames)

Camera_MoveTo
static void Camera_MoveTo(s32 fixed_x, s32 fixed_y, s32 fixed_z, s32 pan)
Definition field_event.h:275

Actor_SetPosition
static void Actor_SetPosition(s32 actor, s32 fixed_x, s32 fixed_z)
Definition field_event.h:229

Engine_ActorFaceEachOther
void Engine_ActorFaceEachOther(s32 actor, s32 other, s32 frames)

Engine_EventWait
void Engine_EventWait(s32 frames)

Actor_SetAttachedEffect
static void Actor_SetAttachedEffect(s32 actor, s32 effect)
Definition field_event.h:267

Engine_ColorBufferApplyTarget
void Engine_ColorBufferApplyTarget(s32 value, s32 mode)

Actor_Get
static struct FieldActor * Actor_Get(s32 actor)
Definition field_event.h:225

field_obj.h
Field objects and actors, and the scene transition styles.

ACTOR_PRIORITY_AUTOMATIC
@ ACTOR_PRIORITY_AUTOMATIC
The sprite takes its priority from the map cell under it.
Definition field_obj.h:153

ACTOR_NO_TARGET
#define ACTOR_NO_TARGET
A target coordinate that is not set: the object has no target.
Definition field_obj.h:145

ACTOR_FACES_MOTION
@ ACTOR_FACES_MOTION
turns toward its velocity, 1/16 turn a frame
Definition field_obj.h:166

field_scene.h
The scene table formats: entrances, exits, placements and events, and the macros that write them.

SCENE_EVENTS_END
#define SCENE_EVENTS_END
Definition field_scene.h:217

FACING_STEP
@ FACING_STEP
Definition field_scene.h:36

SCENE_EXITS
#define SCENE_EXITS(scene)
Definition field_scene.h:72

SCENE_EXIT
#define SCENE_EXIT(exit, scene, entrance)
Definition field_scene.h:73

ACTOR_PARTY_LEADER
@ ACTOR_PARTY_LEADER
Definition field_scene.h:112

SCENE_TABLE_END
@ SCENE_TABLE_END
Definition field_scene.h:43

CONDITION_ALWAYS
@ CONDITION_ALWAYS
Definition field_scene.h:44

TALK_FACE_PARTY
@ TALK_FACE_PARTY
Definition field_scene.h:105

ACTOR_STAND
@ ACTOR_STAND
Definition field_scene.h:102

SCENE_EXITS_END
#define SCENE_EXITS_END
Definition field_scene.h:77

FACING_NORTHEAST
@ FACING_NORTHEAST
Definition field_scene.h:33

FACING_EAST
@ FACING_EAST
Definition field_scene.h:26

FACING_SOUTHEAST
@ FACING_SOUTHEAST
Definition field_scene.h:27

FACING_NORTH
@ FACING_NORTH
Definition field_scene.h:32

FACING_SOUTHWEST
@ FACING_SOUTHWEST
Definition field_scene.h:29

FACING_NORTHWEST
@ FACING_NORTHWEST
Definition field_scene.h:31

FACING_SOUTH
@ FACING_SOUTH
Definition field_scene.h:28

FACING_WEST
@ FACING_WEST
Definition field_scene.h:30

PIXELS
#define PIXELS(value)
Definition field_scene.h:114

field_service.h
The scene service layer: one typed inline for each engine service a scene calls by its own name,...

Task_AddCallback
static s32 Task_AddCallback(void(*callback)(void), s32 priority)
Calls the main-image scheduler through engine_call.h.
Definition field_service.h:126

fixed_math.h
16.16 fixed-point constants, sine and cosine, and the library division.

Q16_ONE
#define Q16_ONE
One in the engine's signed 16.16 fixed-point format.
Definition fixed_math.h:10

flags.h
Game flags, named where their meaning is shown.

FLAG_SOL_SANCTUM_ERUPTED
#define FLAG_SOL_SANCTUM_ERUPTED
The volcano has erupted and the sanctum's rooms rumble and shake.
Definition flags.h:660

FLAG_SOL_SANCTUM_STAR_ROOM_COLLAPSED
#define FLAG_SOL_SANCTUM_STAR_ROOM_COLLAPSED
Definition flags.h:682

FLAG_SCENE_TEMP_46
#define FLAG_SCENE_TEMP_46
Definition flags.h:783

gFrameCount
volatile u32 gFrameCount
Frames WaitFrames has finished.

fx_scene.h
BattleFxScene, the work of a battle or field Psynergy effect scene, and its arc objects.

game_state.h
GameState, the game's state: play time, coins, the scene and the leader's position,...

gGameState
struct GameState gGameState

global_cells.h
The work slots of gWorkSlot, read through their own names.

gEffectWork
void * gEffectWork
Slot 56: points to a scene-specific structure.

graphics.h
The screen blend's globals and the graphics routines.

effect_psynergy.h

sol_sanctum_elemental_star_ring_setup.h

sol_sanctum_eruption.h

item_ids.h
Item numbers, named from the English release.

ITEM_MARS_STAR
@ ITEM_MARS_STAR
Definition item_ids.h:64

iwram_call.h
The IWRAM call layer: the routines the game keeps resident in IWRAM, each at its fixed address,...

Iwram_MulQ16
#define Iwram_MulQ16(left, right)
Definition iwram_call.h:127

macros.h
Small statement macros both games use for positions, velocities and bounds.

SET_VELOCITY
#define SET_VELOCITY(p, vx, vy, vz)
Definition macros.h:18

ACTOR_FELIX
@ ACTOR_FELIX
Definition mercury_lighthouse_aerie.c:54

ACTOR_SATUROS
@ ACTOR_SATUROS
Definition mercury_lighthouse_aerie.c:55

ACTOR_MENARDI
@ ACTOR_MENARDI
Definition mercury_lighthouse_aerie.c:56

ACTOR_KRADEN
@ ACTOR_KRADEN
Definition mercury_lighthouse_aerie.c:53

ACTOR_ALEX
@ ACTOR_ALEX
Definition mercury_lighthouse_aerie.c:57

minigame.h
The reel game's title lettering.

objcmd.h
Field object scripts: one s32 command word, then its operands, as gScriptObject_CommandTable runs the...

SC_LABEL
#define SC_LABEL(n)
Branch destination.
Definition objcmd.h:11

SC_SET
#define SC_SET(w, v)
Write a work value.
Definition objcmd.h:37

SC_LOOP
#define SC_LOOP(n, to)
Repeat up to n times.
Definition objcmd.h:28

SC_TO
#define SC_TO(n)
Definition objcmd.h:12

SC_ADD
#define SC_ADD(w, v)
Definition objcmd.h:38

SC_WAIT
#define SC_WAIT(n)
Wait n frames.
Definition objcmd.h:16

SC_END
#define SC_END
Return to the main script.
Definition objcmd.h:32

SW_SCALE_Y
@ SW_SCALE_Y
Definition objcmd.h:63

SW_SCALE_X
@ SW_SCALE_X
Definition objcmd.h:62

SW_VELOCITY_Y
@ SW_VELOCITY_Y
Definition objcmd.h:65

SC_CALL
#define SC_CALL(fn)
Definition objcmd.h:50

Party_RemoveOwnerRestored
void Party_RemoveOwnerRestored(s32 unit)
Takes unit out of the party, fully restoring its HP and PP and curing its poison.
Definition events.c:214

gParticleWork
struct GroundParticleWork * gParticleWork

palbuf.h
Palette fades, the battle effect palette buffers and the colour channel curves.

PALETTE_TRANSFORM_PLAIN
@ PALETTE_TRANSFORM_PLAIN
each colour unchanged
Definition palbuf.h:72

psynergy_effects.h

ACTOR_WISE_ONE
@ ACTOR_WISE_ONE
Definition sanctum.c:59

script.h
The field object script interpreter and the operands its commands read.

gSolSanctum_RingDirection
s8 gSolSanctum_RingDirection[][3]
Definition sol_sanctum_elemental_star_room.c:2316

gSolSanctumRing_ScaleSteps
s32 gSolSanctumRing_ScaleSteps[]
Definition sol_sanctum_elemental_star_room.c:2334

gSolSanctumRing_MaxScales
s32 gSolSanctumRing_MaxScales[]
Definition sol_sanctum_elemental_star_room.c:2329

gSolSanctum_RingSwing
u8 gSolSanctum_RingSwing[][3]
Definition sol_sanctum_elemental_star_room.c:2303

ACTOR_TELEPORT_GLOW
@ ACTOR_TELEPORT_GLOW
Definition sol_sanctum_elemental_star_room.c:63

gSolSanctum_RingDrift
u8 gSolSanctum_RingDrift[][3]
Definition sol_sanctum_elemental_star_room.c:2290

SolSanctumEruption_DrawFirstCollapseTiles
static void SolSanctumEruption_DrawFirstCollapseTiles(s32 alternate)
Selects the first collapsing tile patch and redraws the map.
Definition sol_sanctum_eruption.c:1464

gSolSanctumEruption_Events
struct SceneEvent gSolSanctumEruption_Events[]
Definition sol_sanctum_eruption.c:1891

SolSanctumEruption_GetPlacements
const struct ScenePlacement * SolSanctumEruption_GetPlacements(void)
Returns Garet and Jenna, then the departure glow (actor 8), Kraden, Saturos, Menardi,...
Definition sol_sanctum_eruption.c:94

SolSanctumEruption_SpawnEffectPair
static void SolSanctumEruption_SpawnEffectPair(struct FieldActor *parent)
Creates two vertical effects sharing the parent position and cached tiles.
Definition sol_sanctum_eruption.c:1741

SolSanctumEruption_UnusedCallbackA
static UNUSED void SolSanctumEruption_UnusedCallbackA(void)
Definition sol_sanctum_eruption.c:560

ARC_SCAN_STILL_ACTIVE
#define ARC_SCAN_STILL_ACTIVE
Definition sol_sanctum_eruption.c:78

gEruption_EmberScript
s32 gEruption_EmberScript[]
Definition sol_sanctum_eruption.c:1899

SolSanctumEruption_GetEntrances
const struct SceneEntrance * SolSanctumEruption_GetEntrances(void)
Definition sol_sanctum_eruption.c:80

SolSanctumEruption_GetRegions
const struct SceneRegion * SolSanctumEruption_GetRegions(void)
Definition sol_sanctum_eruption.c:84

SolSanctumEruption_FadeCameraTo
static void SolSanctumEruption_FadeCameraTo(s32 x, s32 z)
Fades out, moves the camera and its focus actor, then fades back in.
Definition sol_sanctum_eruption.c:1661

SolSanctumEruption_ThrowEruptionRing
static void SolSanctumEruption_ThrowEruptionRing(void)
Launches sixteen rocks outward, then resets their actors for ember emission.
Definition sol_sanctum_eruption.c:584

SolSanctumEruption_PlayWiseOneRescue
static void SolSanctumEruption_PlayWiseOneRescue(void)
Left behind, Isaac and Garet face the Wise One, who makes the Mars Star glow, warns them of Alchemy's...
Definition sol_sanctum_eruption.c:792

SolSanctumEruption_PlaceHostageGroup
static void SolSanctumEruption_PlaceHostageGroup(void)
Stages Saturos, Menardi, Alex and Felix around Jenna and Kraden.
Definition sol_sanctum_eruption.c:104

SolSanctumEruption_SetMaterializationTint
static void SolSanctumEruption_SetMaterializationTint(s32 enabled, s32 frames, s32 waitFrames)
Fades the object palette into or out of the materialization tint.
Definition sol_sanctum_eruption.c:1699

SolSanctumEruption_RaiseElementalArcs
static void SolSanctumEruption_RaiseElementalArcs(u32 mode)
Stages and raises ten arc effects at one of the four chamber positions.
Definition sol_sanctum_eruption.c:1522

EMBER_EMISSION_DISABLED
#define EMBER_EMISSION_DISABLED
Definition sol_sanctum_eruption.c:77

gSolSanctumEruption_StarCells
u16 gSolSanctumEruption_StarCells[]
Definition sol_sanctum_eruption.c:1895

SolSanctumEruption_Initialize
s32 SolSanctumEruption_Initialize(void)
Plays the eruption at entrance 10, the arrival from the Elemental Star room.
Definition sol_sanctum_eruption.c:566

SolSanctumEruption_UpdateElementalArcs
static void SolSanctumEruption_UpdateElementalArcs(void)
Stretches each active arc for eight frames, then lifts it out of view.
Definition sol_sanctum_eruption.c:1632

SolSanctumEruption_GetExits
const u32 * SolSanctumEruption_GetExits(void)
Definition sol_sanctum_eruption.c:86

SolSanctumEruption_ResetEmberEmission
static void SolSanctumEruption_ResetEmberEmission(void)
Resets the sixteen ember slots and their emission timers.
Definition sol_sanctum_eruption.c:637

SolSanctumEruption_UnusedCallbackB
static UNUSED void SolSanctumEruption_UnusedCallbackB(void)
Definition sol_sanctum_eruption.c:562

SolSanctumEruption_UpdateWiseOnePalette
static void SolSanctumEruption_UpdateWiseOnePalette(void)
Cycles the Wise One's palette while it glows.
Definition sol_sanctum_eruption.c:1792

SolSanctumEruption_CycleActorPalette
static void SolSanctumEruption_CycleActorPalette(struct FieldActor *actor)
Cycles six palettes while spawning the actor's vertical effects.
Definition sol_sanctum_eruption.c:1728

SolSanctumEruption_FlickerSecondCollapseTiles
static void SolSanctumEruption_FlickerSecondCollapseTiles(void)
Randomly alternates the second tile patch on even frames, as the first.
Definition sol_sanctum_eruption.c:1511

ROCK_COUNT
@ ROCK_COUNT
Definition sol_sanctum_eruption.c:72

SolSanctumEruption_GetEvents
const struct SceneEvent * SolSanctumEruption_GetEvents(void)
Returns the empty event table: the scene is one cutscene.
Definition sol_sanctum_eruption.c:99

gEruption_ArcOriginsHead
s32 gEruption_ArcOriginsHead[]
Definition sol_sanctum_eruption.c:1798

SolSanctumEruption_FlashMaterializingActor
static void SolSanctumEruption_FlashMaterializingActor(struct FieldActor *actor)
Flashes the palette and spawns paired vertical effects every sixteen frames.
Definition sol_sanctum_eruption.c:1716

gEruption_ArcOrigins
s32 gEruption_ArcOrigins[]
Definition sol_sanctum_eruption.c:1811

gSolSanctumEruption_Entrances
struct SceneEntrance gSolSanctumEruption_Entrances[]
Definition sol_sanctum_eruption.c:1824

gSolSanctumEruption_Placements
struct ScenePlacement gSolSanctumEruption_Placements[]
Definition sol_sanctum_eruption.c:1835

SolSanctumEruption_DrawSecondCollapseTiles
static void SolSanctumEruption_DrawSecondCollapseTiles(s32 alternate)
Selects the second collapsing tile patch and redraws the map.
Definition sol_sanctum_eruption.c:1483

SolSanctumEruption_StepEmbers
static void SolSanctumEruption_StepEmbers(void)
Retires landed embers and launches the next free one at the current frequency, shaking the map after ...
Definition sol_sanctum_eruption.c:655

SolSanctumEruption_FlickerFirstCollapseTiles
static void SolSanctumEruption_FlickerFirstCollapseTiles(void)
Randomly alternates the first tile patch on even frames.
Definition sol_sanctum_eruption.c:1500

SolSanctumEruption_AlignEmberToHeading
static s32 SolSanctumEruption_AlignEmberToHeading(struct ScriptInterpreter *interpreter)
Keeps a flying ember sprite rotated a quarter-turn from its facing.
Definition sol_sanctum_eruption.c:577

SolSanctumEruption_FinishMaterialization
static void SolSanctumEruption_FinishMaterialization(void)
Ends the Wise One's palette animation and clears its attached effect.
Definition sol_sanctum_eruption.c:780

gSolSanctumEruption_Exits
u32 gSolSanctumEruption_Exits[]
Definition sol_sanctum_eruption.c:1829

SolSanctumEruption_PlaceBeforeStar
static void SolSanctumEruption_PlaceBeforeStar(s32 actor)
Places an actor before the star, facing south, and draws it above the chamber floor.
Definition sol_sanctum_eruption.c:1454

SolSanctumEruption_RestoreCornerCellAttributes
static void SolSanctumEruption_RestoreCornerCellAttributes(void)
Restores eight corner-cell attributes from the chamber templates.
Definition sol_sanctum_eruption.c:1686

SolSanctumEruption_UpdateEmberFrequency
static void SolSanctumEruption_UpdateEmberFrequency(void)
Varies the ember emission interval and its duration.
Definition sol_sanctum_eruption.c:746

SolSanctumEruption_PlayHostageScene
static void SolSanctumEruption_PlayHostageScene(void)
Saturos's group argues over the Mars Star and leaves with Jenna and Kraden as hostages,...
Definition sol_sanctum_eruption.c:118

OBJECT_ELEMENTAL_STAR
@ OBJECT_ELEMENTAL_STAR
Definition sol_sanctum_eruption.c:74

ELEMENTAL_ARC_SCALE_X_DECREASE
#define ELEMENTAL_ARC_SCALE_X_DECREASE
Definition sol_sanctum_eruption.c:76

SolSanctumEruption_RaiseAndShrinkActor
static void SolSanctumEruption_RaiseAndShrinkActor(s32 actorId)
Lifts one departing actor and shrinks it together with the paired effect.
Definition sol_sanctum_eruption.c:519

songs.h
Song and sound effect ids, indices into gSound_SongTable.

SE_144
#define SE_144
Definition songs.h:137

SE_308
#define SE_308
Definition songs.h:296

SE_201
#define SE_201
Definition songs.h:196

SE_SCENE_TRANSITION
#define SE_SCENE_TRANSITION
Definition songs.h:162

SE_107
#define SE_107
Definition songs.h:100

MUS_063
#define MUS_063
Definition songs.h:67

MUS_023
#define MUS_023
Definition songs.h:33

MUS_017
#define MUS_017
Definition songs.h:27

SE_292
#define SE_292
Definition songs.h:285

SE_190
#define SE_190
Definition songs.h:185

SE_141
#define SE_141
Definition songs.h:134

SE_145
#define SE_145
Definition songs.h:138

SE_246
#define SE_246
Definition songs.h:241

SE_289
#define SE_289
Definition songs.h:282

SE_214
#define SE_214
Definition songs.h:209

Engine_ActorSetAnimation
void Engine_ActorSetAnimation()

gEventWork
struct EventWork * gEventWork

Engine_EventRequestExit
void Engine_EventRequestExit()

Engine_ActorSetPosition
void Engine_ActorSetPosition(u32 actor, s32 x, s32 z)

Engine_AudioPlayCue
void Engine_AudioPlayCue()

Engine_EventBegin
void Engine_EventBegin(void)

Engine_TaskWait
void Engine_TaskWait()

Engine_EventSetMessage
void Engine_EventSetMessage()

Engine_EventShowMessage
void Engine_EventShowMessage()

NULL
#define NULL
Definition bilibin.h:6

effect_psynergy.h
Vale, its home, storm and Babi scenes, Sol Sanctum's eruption and Venus Lighthouse's aerie: Psynergy ...

Scene_EndCutscenePsynergy
void Scene_EndCutscenePsynergy(void)
Ends the cutscene's Psynergy and releases its effect work.
Definition effect_psynergy.h:16

Scene_BeginCutscenePsynergy
void Scene_BeginCutscenePsynergy(void)
Prepares the effect work and spark tiles of Move (ability 140) for the cutscene's Psynergy.
Definition effect_psynergy.h:11

sol_sanctum_elemental_star_ring_setup.h

sol_sanctum_eruption.h

gEmberLevel
s32 gEmberLevel

gArcEffects
struct FieldActor * gArcEffects[]

gEmberTimer
s32 gEmberTimer

gEmberLevelTimer
s32 gEmberLevelTimer

gEmberState
s32 gEmberState[16]

gArcEffectTimers
s32 gArcEffectTimers[10]

gEmberMask
s32 gEmberMask

AnimationEntry::frame
u8 frame
frame shown, frameBase plus the facing offset; 255 none
Definition animspr.h:53

AnimationObject
An animated sprite: its image and shadow, scale, rotation, size and up to four animation layers.
Definition animspr.h:108

AnimationObject::offsetX
s8 offsetX
pixels
Definition animspr.h:121

AnimationObject::image
struct AnimationSpritePart image
Definition animspr.h:109

AnimationObject::rotation
u16 rotation
1/65536 turns
Definition animspr.h:118

AnimationObject::flags
u8 flags
bits: 1 outlined in ObjectSystemWork's edge and fill colours | 0 shadow drawn (set when created)
Definition animspr.h:128

AnimationObject::slot
u8 slot
VRAM cache entry holding its tiles.
Definition animspr.h:112

AnimationObject::entries
struct AnimationEntry * entries[4]
its layers; empty ones null
Definition animspr.h:130

AnimationObject::count
u8 count
layers in use, up to the last one present
Definition animspr.h:129

AnimationObject::retainCacheEntry
u8 retainCacheEntry
Keeps the VRAM cache entry when it is released or off screen.
Definition animspr.h:114

AnimationSpritePart::fullColor
u16 fullColor
256 colours; set for both parts when created
Definition animspr.h:94

AnimationSpritePart::size
u16 size
Definition animspr.h:98

AnimationSpritePart::palette
u16 palette
Definition animspr.h:101

AnimationSpritePart::tile
u16 tile
first sprite tile in VRAM
Definition animspr.h:99

AnimationSpritePart::shape
u16 shape
Definition animspr.h:95

AnimationSpritePart::priority
u16 priority
2 when created
Definition animspr.h:100

BattleFxScene
The work of a Psynergy effect scene: its caster and target, where it takes place, the map state it re...
Definition fx_scene.h:31

BattleFxScene::tileSlot
u16 tileSlot
resource entry holding the spark tiles
Definition fx_scene.h:64

BattleFxScene::child
void * child
the target's object, or NULL
Definition fx_scene.h:37

EventWork
The running scene's event work: its placement and event tables, its actors, the triggers and exit it ...
Definition event_work.h:20

EventWork::transitionFrames
s32 transitionFrames
frames
Definition event_work.h:45

FieldActor
A field actor: a person or thing on the field with a position, motion toward a target,...
Definition field_obj.h:30

FieldActor::speed
s32 speed
speed limit, 16.16 fixed-point pixels per frame
Definition field_obj.h:55

FieldActor::targetX
s32 targetX
16.16 fixed-point pixels; ACTOR_NO_TARGET when unset
Definition field_obj.h:59

FieldActor::steeringFlags
u8 steeringFlags
ActorSteeringFlag bits.
Definition field_obj.h:92

FieldActor::motionFlags
u8 motionFlags
ActorMotionFlag bits; zero is free flight in 3D, and 3 is set on creation.
Definition field_obj.h:83

FieldActor::x
union FieldCoordinate x
16.16 fixed-point pixels
Definition field_obj.h:35

FieldActor::targetZ
s32 targetZ
16.16 fixed-point pixels; ACTOR_NO_TARGET when unset
Definition field_obj.h:61

FieldActor::velocityX
s32 velocityX
16.16 fixed-point pixels per frame
Definition field_obj.h:52

FieldActor::y
union FieldCoordinate y
16.16 fixed-point pixels
Definition field_obj.h:36

FieldActor::priorityFlags
u8 priorityFlags
ActorPriorityFlag bits, read by the scrolling camera.
Definition field_obj.h:51

FieldActor::terrainHeight
s32 terrainHeight
16.16 fixed-point pixels
Definition field_obj.h:38

FieldActor::z
union FieldCoordinate z
16.16 fixed-point pixels
Definition field_obj.h:37

FieldActor::facing
u16 facing
1/65536 turns
Definition field_obj.h:34

FieldActor::acceleration
s32 acceleration
Added toward the target each frame, or taken off the speed when there is none, in 16....
Definition field_obj.h:58

FieldActor::targetY
s32 targetY
16.16 fixed-point pixels; ACTOR_NO_TARGET when unset
Definition field_obj.h:60

FieldActor::scaleX
s32 scaleX
16.16 fixed point, 0x10000 full size
Definition field_obj.h:39

FieldActor::scaleY
s32 scaleY
16.16 fixed point, 0x10000 full size
Definition field_obj.h:40

FieldActor::update
void(*) update(union FieldObject *object)
Called each frame before the object's script, while the object is live.
Definition field_obj.h:116

FieldActor::velocityZ
s32 velocityZ
16.16 fixed-point pixels per frame
Definition field_obj.h:54

GameState::entrance
s16 entrance
Definition game_state.h:37

GroundParticleWork
Work slot 29 while ground particles, motes or sparkles run.
Definition object_effect.h:59

GroundParticleWork::stopped
s32 stopped
Prevent new sparkle bursts while set.
Definition object_effect.h:64

SceneEntrance
A scene entrance: where and facing which way the party arrives, and the camera's bounds there (-1 for...
Definition field_scene.h:54

SceneEvent
A scene event: its kind and detail, the trigger it answers, its condition and its value (a message or...
Definition field_scene.h:118

ScenePlacement
An actor a scene places: its sprite, the condition for placing it, how it behaves,...
Definition field_scene.h:81

SceneRegion
A scene's exit region: the box that, while its condition holds, takes the party leader out through it...
Definition field_runtime.h:30

ScriptInterpreter
The prefix that command handlers read from a field object's 0x70-byte slot.
Definition script.h:16

VramBlockCacheEntry::offset
u16 offset
bytes from the start of OBJ VRAM
Definition vram_tab.h:25

system.h
The system's routines and globals: interrupts, BIOS sound bias, random numbers and sleep.

types.h
The integer types, TRUE, UNUSED and the fixed-address macros.

s32
signed int s32
Definition types.h:14

u32
unsigned int u32
Definition types.h:15

s8
signed char s8
Definition types.h:10

s16
signed short s16
Definition types.h:12

u16
unsigned short u16
Definition types.h:13

UNUSED
#define UNUSED
Definition types.h:22

u8
unsigned char u8
Definition types.h:11

FieldCoordinate::part
struct FieldCoordinate::@024321007066302143002254325121164243234242211074 part

FieldCoordinate::fixed
s32 fixed
16.16 fixed-point pixels
Definition field_coordinate.h:12

field.h

object.h

runtime.h

Resource_ResetEntry
s32 Resource_ResetEntry(u32 no)
Frees cache entry no: its blocks go back and the entry is marked free (offset 0xffff).
Definition vram_cache.c:106

vram_tab.h
The sprite VRAM block cache and its owners.

gVramBlockCache
struct VramBlockCacheEntry gVramBlockCache[]

FieldEffect_InitSparkles
void FieldEffect_InitSparkles(void)
Starts the sparkles (FieldEffect_UpdateSparkles): loads their tiles and clears the 32 sparkles.
Definition weather.c:374