AddEnergy()

float ComponentEnergyManager::AddEnergy ( float added_energy )

inlineprotected

Energy manager: Adds energy to this device and clamps it within its min/max storage limits. Returns the amount of energy that was clamped. Negative value is supported, but you should still use ConsumeEnergy(...) for propper substraction of energy.

См. определение в файле ComponentEnergyManager.c строка 1252

    {
        if (added_energy != 0)
        {
            //Print("AddEnergy ---------> " + added_energy + " " + this + " " +m_ThisEntityAI.ClassName());
            #ifdef DIAG_DEVELOPER
            if (FeatureTimeAccel.GetFeatureTimeAccelEnabled(ETimeAccelCategories.ENERGY_CONSUMPTION) && added_energy < 0)
            {
                float timeAccel = FeatureTimeAccel.GetFeatureTimeAccelValue();
                added_energy *= timeAccel;
            }
            #endif
            
            bool energy_was_added = (added_energy > 0);
            
            float energy_to_clamp = GetEnergy() + added_energy;
            float clamped_energy = Math.Clamp( energy_to_clamp, 0, GetEnergyMax() );
            SetEnergy(clamped_energy);
            StartUpdates();
            
            if (energy_was_added)
                OnEnergyAdded();
            else
                OnEnergyConsumed();
            
            return energy_to_clamp - clamped_energy;
        }
        
        return 0;
    }

Перекрестные ссылки Math::Clamp(), GetEnergy(), GetEnergyMax(), OnEnergyAdded(), OnEnergyConsumed(), SetEnergy() и StartUpdates().

Используется в FindAndConsumeEnergy() и ItemBase::OnIgnitedTarget().