Skip to content

tweak(gui): Decouple GUI transition and world animation timing from render update #2056

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
bobtista wants to merge 7 commits into
base: main
Choose a base branch
from
Open

tweak(gui): Decouple GUI transition and world animation timing from render update #2056

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
95357c3
Decouple GUI transition and world animation timing from render update
bobtista Jan 4, 2026
cff9563
Replicate to generals
bobtista Jan 4, 2026
e6cd525
Use getBaseOverUpdateFpsRatio() for frame-rate independent timing in …
bobtista Feb 3, 2026
901bd6c
style: Use explicit float assignments for m_currentFrame
bobtista Mar 24, 2026
5e51f64
fix(gui): Use logic time scale for world animation Z-rise
bobtista Apr 18, 2026
e5c8d45
fix(gui): Replicate to Generals
bobtista Apr 18, 2026
c714914
fix(gui): Step every integer transition frame to prevent stuck menu
bobtista May 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion Core/GameEngine/Include/GameClient/GameWindowTransitions.h
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -647,7 +647,7 @@ class TransitionGroup
typedef std::list<TransitionWindow *> TransitionWindowList;
TransitionWindowList m_transitionWindowList;
Int m_directionMultiplier;
Int m_currentFrame; ///< maintain how long we've spent on this transition;
Real m_currentFrame; ///< maintain how long we've spent on this transition (in 30fps-equivalent frames);
Comment thread
Caball009 marked this conversation as resolved.
AsciiString m_name;
};

Expand Down
40 changes: 31 additions & 9 deletions Core/GameEngine/Source/GameClient/GUI/GameWindowTransitions.cpp
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -55,6 +55,7 @@
#include "GameClient/GameWindowTransitions.h"
#include "GameClient/GameWindow.h"
#include "GameClient/GameWindowManager.h"
#include "Common/FramePacer.h"
//-----------------------------------------------------------------------------
// DEFINES ////////////////////////////////////////////////////////////////////
//-----------------------------------------------------------------------------
Expand Down Expand Up @@ -239,7 +240,7 @@ Int TransitionWindow::getTotalFrames( void )
//-----------------------------------------------------------------------------
TransitionGroup::TransitionGroup( void )
{
m_currentFrame = 0;
m_currentFrame = 0.0f;
m_fireOnce = FALSE;
}

Expand All @@ -256,7 +257,7 @@ TransitionGroup::~TransitionGroup( void )

void TransitionGroup::init( void )
{
m_currentFrame = 0;
m_currentFrame = 0.0f;
m_directionMultiplier = 1;
TransitionWindowList::iterator it = m_transitionWindowList.begin();
while (it != m_transitionWindowList.end())
Expand All @@ -270,13 +271,34 @@ void TransitionGroup::init( void )

void TransitionGroup::update( void )
{
m_currentFrame += m_directionMultiplier; // we go forward or backwards depending.
TransitionWindowList::iterator it = m_transitionWindowList.begin();
while (it != m_transitionWindowList.end())
// TheSuperHackers @tweak bobtista GUI transition timing is now decoupled from the render update.
// Step every integer frame between the old and new accumulator value so discrete-state-machine
// transitions cannot skip a state when the render frame rate dips below the base rate.
const Real timeScale = TheFramePacer->getBaseOverUpdateFpsRatio();
const Int prevFrame = (Int)m_currentFrame;
m_currentFrame += m_directionMultiplier * timeScale;
const Int newFrame = (Int)m_currentFrame;

if( newFrame == prevFrame )
{
TransitionWindow *tWin = *it;
tWin->update(m_currentFrame);
it++;
return;
}

const Int step = (newFrame > prevFrame) ? 1 : -1;
for( Int frame = prevFrame + step; frame != newFrame + step; frame += step )
{
TransitionWindowList::iterator it = m_transitionWindowList.begin();
while (it != m_transitionWindowList.end())
{
TransitionWindow *tWin = *it;
tWin->update(frame);
it++;
}

if( isFinished() )
Copy link
Copy Markdown

@xezon xezon May 5, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This goes through the list a second time. This can probably be optimized by returning finished result in update function above and then use that to determine finished status.

Copy link
Copy Markdown

@xezon xezon May 5, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Or just check isFinished for each transition group after each update.

{
break;
}
}
}

Expand Down Expand Up @@ -315,7 +337,7 @@ void TransitionGroup::reverse( void )
tWin->reverse(totalFrames);
it++;
}
m_currentFrame = totalFrames;
m_currentFrame = (Real)totalFrames;
// m_currentFrame ++;
}

Expand Down
7 changes: 6 additions & 1 deletion Generals/Code/GameEngine/Source/GameClient/InGameUI.cpp
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5504,6 +5504,9 @@ static const UnsignedInt FRAMES_BEFORE_EXPIRE_TO_FADE = LOGICFRAMES_PER_SECOND *
// ------------------------------------------------------------------------------------------------
void InGameUI::updateAndDrawWorldAnimations( void )
{
// TheSuperHackers @tweak bobtista World animation Z-rise is now decoupled from the render update.
const Real zRiseTimeScale = TheFramePacer->getActualLogicTimeScaleOverFpsRatio();

// go through all animations
for( WorldAnimationListIterator it = m_worldAnimationList.begin();
it != m_worldAnimationList.end(); /*empty*/ )
Expand Down Expand Up @@ -5535,7 +5538,9 @@ void InGameUI::updateAndDrawWorldAnimations( void )

// update the Z value
if( wad->m_zRisePerSecond )
wad->m_worldPos.z += wad->m_zRisePerSecond / LOGICFRAMES_PER_SECOND;
{
wad->m_worldPos.z += wad->m_zRisePerSecond / LOGICFRAMES_PER_SECOND * zRiseTimeScale;
}

}

Expand Down
7 changes: 6 additions & 1 deletion GeneralsMD/Code/GameEngine/Source/GameClient/InGameUI.cpp
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5677,6 +5677,9 @@ static const UnsignedInt FRAMES_BEFORE_EXPIRE_TO_FADE = LOGICFRAMES_PER_SECOND *
// ------------------------------------------------------------------------------------------------
void InGameUI::updateAndDrawWorldAnimations( void )
{
// TheSuperHackers @tweak bobtista World animation Z-rise is now decoupled from the render update.
const Real zRiseTimeScale = TheFramePacer->getActualLogicTimeScaleOverFpsRatio();

// go through all animations
for( WorldAnimationListIterator it = m_worldAnimationList.begin();
it != m_worldAnimationList.end(); /*empty*/ )
Expand Down Expand Up @@ -5708,7 +5711,9 @@ void InGameUI::updateAndDrawWorldAnimations( void )

// update the Z value
if( wad->m_zRisePerSecond )
wad->m_worldPos.z += wad->m_zRisePerSecond / LOGICFRAMES_PER_SECOND;
{
wad->m_worldPos.z += wad->m_zRisePerSecond / LOGICFRAMES_PER_SECOND * zRiseTimeScale;
}

}

Expand Down
Loading