john/deighton-ar
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Adding ViroKit. Needs AWSCore :(

Browse Source
This commit is contained in:
John Lyon-Smith
2018-03-27 17:46:15 -07:00
parent 2ab15e7dc1
commit 02e06dface
844 changed files with 86921 additions and 21 deletions
Download Patch File Download Diff File Expand all files Collapse all files

470
mobile/ios/ViroKit.framework/Headers/VROParticleEmitter.h Normal file
View File

@@ -0,0 +1,470 @@
//
// VROParticleEmitter.h
// ViroRenderer
//
// Copyright © 2017 Viro Media. All rights reserved.
//
#ifndef VROParticleEmitter_h
#define VROParticleEmitter_h
#include "VRODriver.h"
#include "VROParticleModifier.h"
// Assumed mass of a single particle, used for all physics calculations.
static float kAssumedParticleMass = 1;
class VROSurface;
class VROParticleUBO;
class VROParticle;
class VROTexture;
/*
Volume describing the area around which particles spawn within / around.
*/
struct VROParticleSpawnVolume{
enum class Shape{
Box,
Sphere,
Point
};
static VROParticleSpawnVolume::Shape getModifierFactorForString(std::string strType) {
if (VROStringUtil::strcmpinsensitive(strType, "Box")) {
return VROParticleSpawnVolume::Shape::Box;
} else if (VROStringUtil::strcmpinsensitive(strType, "Sphere")) {
return VROParticleSpawnVolume::Shape::Sphere;
} else {
return VROParticleSpawnVolume::Shape::Point;
}
}
Shape shape;
// Vec of params to be provided for configuring the specified shape.
std::vector<float> shapeParams;
// True if particles should be spawned on this shape's surface
// instead of within it. Applicable for Box and Sphere shapes only.
bool spawnOnSurface;
};
/*
VROParticleEmitter handles the behavior of quad particles emitted in the scene in terms of
its life cycle, physical motion, and visual characteristics like color and alpha.
*/
class VROParticleEmitter {
public:
VROParticleEmitter(std::shared_ptr<VRODriver> driver,
std::shared_ptr<VROSurface> particleGeometry);
/*
Constructor that creates an uninitialized emitter. To initialize this emitter before
it can be configured / modified, call VROParticleEmitter::initEmitter();
*/
VROParticleEmitter();
virtual ~VROParticleEmitter();
/*
Called per frame to update particle states, lifetime and behavior. The computedTransform
is the final transform of this emitter's parent node.
*/
virtual void update(const VRORenderContext &context, const VROMatrix4f &computedTransform);
/*
Allows for setting of the particleSurface if initEmitter has already been called.
*/
virtual void setParticleSurface(std::shared_ptr<VROSurface> particleSurface);
std::shared_ptr<VROGeometry> getParticleSurface() const;
void setRun(bool emit) {
_requestRun = emit;
}
void setDuration(double duration) {
_duration = duration;
}
void setDelay(double delay) {
_emitterDelayDuration = delay;
}
void setLoop(bool loop) {
_loop = loop;
}
void setFixedToEmitter(bool isFixed) {
_fixToEmitter = isFixed;
}
virtual void setMaxParticles(int maxParticles) {
_maxParticles = maxParticles;
}
void setParticleLifeTime(std::pair <int, int> lifeTime) {
_particleLifeTime = lifeTime;
}
void setEmissionRatePerSecond(std::pair <int, int> rate) {
_particlesEmittedPerSecond = rate;
}
void setEmissionRatePerDistance(std::pair <int, int> rate) {
_particlesEmittedPerMeter = rate;
}
void setBlendMode(VROBlendMode mode);
void setBloomThreshold(float threshold);
/*
True if we are no longer emitting particles and have completed the emission cycle.
*/
bool finishedEmissionCycle();
/*
Reset back to the beginning of the emission cycle for this emitter.
*/
void resetEmissionCycle(bool resetParticles);
/*
Used for constructing the behavior of how bursts of particles spawn.
*/
struct VROParticleBurst {
// Reference factor against which to compare when deciding how to burst-spawn particles.
VROParticleModifier::VROModifierFactor referenceFactor;
// Min, Max range of number of particles to spawn.
std::pair<int, int> numberOfParticles;
// Starting Reference Value at which to begin the burst.
double referenceValueStart;
// Cool down period in milliseconds or distance in meters after each burst.
double referenceValueInterval;
// Number of times to repeat this burst.
int cycles;
};
/*
Sets on this emitter a list of VROParticleBurst to emit.
*/
void setParticleBursts(std::vector<VROParticleBurst> bursts) {
_bursts = bursts;
_scheduledBurst = bursts;
}
/*
Overrides the current specified VROParticleSpawnVolume.
*/
void setParticleSpawnVolume(VROParticleSpawnVolume volume) {
_currentVolume = volume;
}
/*
Parameters for configuring an initial explosive force at a given explosionPoint local
to the emitter with a magnitude of impulseExplosion.
*/
void setInitialExplosion(VROVector3f explosionPoint, float impulseExplosion, float decelleration = -1) {
_explosionCenter = explosionPoint;
_impulseExplosionMagnitude = impulseExplosion;
_impulseDeaccelerationExplosionPeriod = decelleration;
}
/*
Below are specific particle modifiers that can be set by the bridge, that defines the
behavior and appearance of emitted particles.
*/
void setAlphaModifier(std::shared_ptr<VROParticleModifier> mod) {
_alphaModifier = mod;
}
void setColorModifier(std::shared_ptr<VROParticleModifier> mod) {
_colorModifier = mod;
}
void setScaleModifier(std::shared_ptr<VROParticleModifier> mod) {
_scaleModifier = mod;
}
void setRotationModifier(std::shared_ptr<VROParticleModifier> mod) {
_rotationModifier = mod;
}
void setVelocityModifier(std::shared_ptr<VROParticleModifier> mod) {
_velocityModifier = mod;
}
void setAccelerationmodifier(std::shared_ptr<VROParticleModifier> mod) {
_accelerationModifier = mod;
}
/*
Initialize the emitter with default configurations and states.
*/
void initEmitter(std::shared_ptr<VRODriver> driver,
std::shared_ptr<VROSurface> particleGeometry);
void setDefaultValues();
protected:
/*
The last transform computed for this emitter's parent node. Used when resetting
particles.
*/
VROMatrix4f _lastComputedTransform;
/*
The geometry used to represent particles in this emitter.
*/
std::shared_ptr<VROSurface> _particleGeometry;
/*
List of all particles in the scene for this emitter. This includes active particles (particles
that have just been spawned and are animating in the scene) and also zombie particles
(particles that are just killed and become a zombie temporarily before being de-allocated
and removed from this list to encourage the recycling of particle objects).
*/
std::vector<VROParticle> _particles;
/*
Vector containing all particles that have died so that they can be reused. Particles
in a zombie start after a certain time will be de-allocated.
*/
std::vector<VROParticle> _zombieParticles;
/*
The maximum number of active particles (not including zombie ones) that this emitter
can have at any given moment.
*/
int _maxParticles;
private:
#pragma mark - Particle Emission Behaviors
/*
Flag for setting the _run state on a render pass. This is required because emitter states that
are updated as a result of changes to the _run flag are dependent on certain scene->compute
render passes to occur first before we compute this Particle emitter (like transforms).
*/
bool _requestRun;
/*
True to continue emitting particles from when the emitter had last stopped.
*/
bool _run;
/*
The length of time in milliseconds this emitter is emitting particles.
*/
double _duration;
/*
If true, the emission cycle will repeat after the duration.
*/
bool _loop;
/*
If false, already emitted particles will not be affected by transformation changes made
to this emitter's node, else, they would be "locked" to the emitter.
*/
bool _fixToEmitter;
/*
Below are specific particle modifiers that can be set by the bridge, that defines the
behavior and appearance of emitted particles.
*/
std::shared_ptr<VROParticleModifier> _alphaModifier;
std::shared_ptr<VROParticleModifier> _colorModifier;
std::shared_ptr<VROParticleModifier> _scaleModifier;
std::shared_ptr<VROParticleModifier> _rotationModifier;
std::shared_ptr<VROParticleModifier> _velocityModifier;
std::shared_ptr<VROParticleModifier> _accelerationModifier;
/*
Emission of extra particles at specific times or distances during the entire _duration
this emitter is emitting.
*/
std::vector<VROParticleBurst> _bursts;
/*
Copied from _burst at the beginning of every emitter emission cycle to schedule and
maintain the state of all incoming burst events.
*/
std::vector<VROParticleBurst> _scheduledBurst;
/*
The min max lifetime of emitted particles, in milliseconds.
*/
std::pair <int, int> _particleLifeTime;
#pragma mark - Emitter Attributes
/*
Length of time in milliseconds this emitter delays before emitting particles.
Note that this will not be include in _duration.
*/
double _emitterDelayDuration = -1;
/*
Time at which we have started the delay, used for tracking the delay status by
checking against: _emitterDelayStartTime + _emitterDelayTimePassedSoFar > currentTime.
*/
double _emitterDelayStartTime = -1;
/*
Length of delay time left before emitting particles. This is reset to _emitterDelayDuration
but is manipulated / subtracted to track remaining delay time as the emitter is paused/resumed.
*/
double _emitterDelayTimePassedSoFar = 0;
/*
Total time that has passed since the beginning of this emitter's emission cycle.
*/
double _emitterTotalPassedTime = 0;
/*
Time that has passed since this emitter has last started. It is redefined as the emitter
is paused / resumed.
*/
double _emitterPassedTimeSoFar = 0;
/*
Time at which this emitter has been started at in milliseconds.
*/
double _emitterStartTimeMs = 0;
/*
Total travelled distance of the emitter since the beginning of this emitter's emission cycle.
*/
double _emitterTotalPassedDistance = 0;
/*
Distance travelled since this emitter has last started. It is redefined as the emitter
is paused / resumed.
*/
double _emitterPassedDistanceSoFar = 0;
/*
Location at which this emitter has started at. It is redefined as the emitter
is paused / resumed.
*/
VROVector3f _emitterStartLocation;
/*
Set for determining how many particles should be emitted per distance travelled of this
emitter, if any. The pair defines a uniform distribution (min, max).
*/
std::pair <int, int> _particlesEmittedPerMeter;
/*
Position at which we had last emitted particles that were distance spawned.
*/
VROVector3f _distanceSpawnedLastEmitPosition;
/*
Position where we first started distance spawning particles from.
*/
VROVector3f _distanceSpawnedInitPosition;
/*
Rate at which particles are distance spawned, per meter.
*/
double _distanceSpawnedEmissionRate = 0;
/*
Set for determining how many particles should be emitted per second of _duration of this
emitter, if any. The pair defines a uniform distribution (min, max).
*/
std::pair <int, int> _particlesEmittedPerSecond;
/*
Time at which we had last emitted particles that were time spawned.
*/
double _intervalSpawnedLastEmitTime = 0;
/*
Time when we had first started time-spawning particles from.
*/
double _intervalSpawnedInitTime = 0;
double _particlesSpawnIntervalMs = 100;
double _intervalSpawnedEmissionRate = 0;
/*
Updates any time / distance state that the emitter needs to determine particle behavior.
*/
void updateEmitter(double currentTime, const VROMatrix4f &computedTransform);
/*
Processes any delay period left on this particle emitter's current emit cycle.
Returns true if any delay was processed, false otherwise.
*/
bool processDelay(double currentTime);
#pragma mark - Particle Attributes
/*
Below are specific update functions that define the behavior and appearance
of the particle.
*/
void updateParticles(double currentTime, const VRORenderContext &context,
const VROMatrix4f &computedTransform, bool isCurrentlyDelayed);
void updateParticlePhysics(double currentTime);
void updateParticleAppearance(double currentTime);
void updateParticlesToBeKilled(double currentTime);
void updateParticleSpawn(double currentTime, VROVector3f currentPos);
void updateZombieParticles(double currentTime);
/*
Called when we wish to spawn new particles, given the numberOfParticles. To do so,
we firstly attempt to recycle zombie particles and create new ones if we do ever run out.
*/
void spawnParticle(int numberOfParticles, double currentTime);
/*
Returns the number of particles to spawn at the given currentTime with the set
_particlesEmittedPerSecond on this emitter.
*/
int getSpawnParticlesPerSecond(double currentTime);
/*
Returns the number of particles to spawn at the given position with the set
_particlesEmittedPerMeter on this emitter.
*/
int getSpawnParticlesPerMeter(VROVector3f currentPos);
/*
Returns the number of particles to spawn based on _scheduledBurst.
*/
int getSpawnParticleBursts();
/*
Resets the particle to a set of known defaults, so that it can be re-used / re-emitted.
*/
void resetParticle(VROParticle &particle, double currentTime);
/*
Volume defining the location of where particles would spawn.
*/
VROParticleSpawnVolume _currentVolume;
/*
Location local to this Particle Emitter from which to calculate an explosive force
to determine initial velocity.
*/
VROVector3f _explosionCenter;
/*
The magnitude of an explosion's impulse.
*/
float _impulseExplosionMagnitude = -1;
double _impulseDeaccelerationExplosionPeriod = -1;
/*
Grabs a random point from the currently configured _currentVolume.
*/
VROVector3f getPointInSpawnVolume();
/*
Extrapolate the initial velocity for this particle if explosion parameters have been set.
*/
VROVector3f getExplosionInitialVel(VROVector3f particlePosition);
VROVector3f getExplosionAccel(VROVector3f particlePosition);
};
#endif /* VROParticleEmitter_h */