src/thirdparty/particles/ParticleDLL/other_api.cpp File Reference

#include "papi.h"
#include "ParticleState.h"
#include <iostream>

Include dependency graph for other_api.cpp:

Go to the source code of this file.

Functions
PARTICLEDLL_API void	pColor (float red, float green, float blue, float alpha)
PARTICLEDLL_API void	pColorD (const pDomain &cdom)
PARTICLEDLL_API void	pColorD (const pDomain &cdom, const pDomain &adom)
PARTICLEDLL_API void	pUpVec (const pVec &up)
PARTICLEDLL_API void	pUpVecD (const pDomain &dom)
PARTICLEDLL_API void	pVelocity (const pVec &v)
PARTICLEDLL_API void	pVelocityD (const pDomain &dom)
PARTICLEDLL_API void	pRotVelocity (const pVec &v)
PARTICLEDLL_API void	pRotVelocityD (const pDomain &dom)
PARTICLEDLL_API void	pVertexB (const pVec &v)
PARTICLEDLL_API void	pVertexBD (const pDomain &dom)
PARTICLEDLL_API void	pVertexBTracks (bool trackVertex)
PARTICLEDLL_API void	pSize (const pVec &size)
PARTICLEDLL_API void	pSizeD (const pDomain &dom)
PARTICLEDLL_API void	pMass (float mass)
PARTICLEDLL_API void	pStartingAge (float age, float sigma)
PARTICLEDLL_API void	pTimeStep (float newDT)
PARTICLEDLL_API int	pGenActionLists (int action_list_count)
PARTICLEDLL_API void	pNewActionList (int action_list_num)
PARTICLEDLL_API void	pEndActionList ()
PARTICLEDLL_API void	pDeleteActionLists (int action_list_num, int action_list_count)
PARTICLEDLL_API void	pCallActionList (int action_list_num)
PARTICLEDLL_API int	pGenParticleGroups (int p_group_count, size_t max_particles)
PARTICLEDLL_API void	pDeleteParticleGroups (int p_group_num, int p_group_count)
PARTICLEDLL_API void	pCurrentGroup (int p_group_num)
PARTICLEDLL_API size_t	pSetMaxParticles (size_t max_count)
PARTICLEDLL_API void	pCopyGroup (int p_src_group_num, size_t index, size_t copy_count)
PARTICLEDLL_API size_t	pGetParticles (size_t index, size_t count, float *verts, float *color, float *vel, float *size, float *age)
PARTICLEDLL_API size_t	pGetParticlePointer (float *&ptr, size_t &stride, size_t &pos3Ofs, size_t &posB3Ofs, size_t &size3Ofs, size_t &vel3Ofs, size_t &velB3Ofs, size_t &color3Ofs, size_t &alpha1Ofs, size_t &age1Ofs)
PARTICLEDLL_API size_t	pGetGroupCount ()
PARTICLEDLL_API size_t	pGetMaxParticles ()
PARTICLEDLL_API void	pBirthCallback (P_PARTICLE_CALLBACK callback, void *data)
PARTICLEDLL_API void	pDeathCallback (P_PARTICLE_CALLBACK callback, void *data)
PARTICLEDLL_API void	pReset ()
PARTICLEDLL_API void	pSeed (unsigned int seed)

---

Function Documentation

PARTICLEDLL_API void pBirthCallback	(	P_PARTICLE_CALLBACK	callback,
		void *	data
	)

Definition at line 546 of file other_api.cpp.

References _GetPState(), ParticleState::GetPGroup(), ParticleState::in_new_list, ParticleState::pgroup_id, and ParticleGroup::SetBirthCallback().

{
    ParticleState &PS = _GetPState();
    if(PS.in_new_list)
        return; // ERROR

    PS.GetPGroup(PS.pgroup_id).SetBirthCallback(callback, data);
}

Here is the call graph for this function:

PARTICLEDLL_API void pCallActionList

(

int

action_list_num

)

Definition at line 249 of file other_api.cpp.

References _GetPState(), _PLock(), _PUnLock(), PACallActionList::action_list_num, ParticleState::ALists, ParticleState::ExecuteActionList(), ParticleState::in_new_list, and ParticleState::SendAction().

{
    ParticleState &PS = _GetPState();

    if(PS.in_new_list) {
        // Add this call as an action to the current list.
        PACallActionList *S = new PACallActionList;
        S->action_list_num = action_list_num;

        PS.SendAction(S);
    } else {
        // Execute the specified action list.
        _PLock();

        if(action_list_num < 0 || action_list_num >= (int)PS.ALists.size())
            return; // ERROR

        ActionList &AList = PS.ALists[action_list_num];

        // Not sure it's safe to unlock here since AList can be accessed by another thread while
        // we're executing it, but we can't stay locked while doing all the actions or it's not parallel.
        _PUnLock();

        PS.ExecuteActionList(AList);
    }
}

Here is the call graph for this function:

PARTICLEDLL_API void pColor	(	float	red,
		float	green,
		float	blue,
		float	alpha
	)

Definition at line 36 of file other_api.cpp.

References _GetPState(), ParticleState::Alpha, and ParticleState::Color.

{
    ParticleState &PS = _GetPState();

    delete PS.Color;
    delete PS.Alpha;
    PS.Color = new PDPoint(pVec(red, green, blue));
    PS.Alpha = new PDPoint(pVec(alpha));
}

Here is the call graph for this function:

PARTICLEDLL_API void pColorD	(	const pDomain &	cdom,
		const pDomain &	adom
	)

Definition at line 55 of file other_api.cpp.

References _GetPState(), ParticleState::Alpha, ParticleState::Color, and pDomain::copy().

{
    ParticleState &PS = _GetPState();

    delete PS.Color;
    delete PS.Alpha;
    PS.Color = cdom.copy();
    PS.Alpha = adom.copy();
}

Here is the call graph for this function:

PARTICLEDLL_API void pColorD

(

const pDomain &

cdom

)

Definition at line 46 of file other_api.cpp.

References _GetPState(), ParticleState::Alpha, ParticleState::Color, and pDomain::copy().

Referenced by gSpark::Timestep().

{
    ParticleState &PS = _GetPState();
    delete PS.Color;
    delete PS.Alpha;
    PS.Color = cdom.copy();
    PS.Alpha = new PDPoint(pVec(1));
}

Here is the call graph for this function:

Here is the caller graph for this function:

PARTICLEDLL_API void pCopyGroup	(	int	p_src_group_num,
		size_t	index,
		size_t	copy_count
	)

Definition at line 357 of file other_api.cpp.

References _GetPState(), _PLock(), _PUnLock(), ParticleGroup::Add(), ParticleGroup::GetList(), ParticleGroup::GetMaxParticles(), ParticleState::GetPGroup(), ParticleState::in_new_list, ParticleState::pgroup_id, ParticleState::PGroups, and ParticleGroup::size().

{
    ParticleState &PS = _GetPState();

    if(PS.in_new_list)
        return; // ERROR

    _PLock();

    if(p_src_group_num < 0 || p_src_group_num >= (int)PS.PGroups.size())
        return; // ERROR

    ParticleGroup &srcgrp = PS.GetPGroup(p_src_group_num);

    ParticleGroup &destgrp = PS.GetPGroup(PS.pgroup_id);

    // Find out exactly how many to copy.
    size_t ccount = copy_count;
    if(ccount > srcgrp.size() - index)
        ccount = srcgrp.size() - index;
    if(ccount > destgrp.GetMaxParticles() - destgrp.size())
        ccount = destgrp.GetMaxParticles() - destgrp.size();

    // useless test, can never be negative
    // if(ccount<0)
    //     ccount = 0;

    // Directly copy the particles to the current list.
    for(size_t i=0; i<ccount; i++) {
        // Is it bad to call a birth callback while locked?
        destgrp.Add(srcgrp.GetList()[index+i]);
    }

    _PUnLock();
}

Here is the call graph for this function:

PARTICLEDLL_API void pCurrentGroup

(

int

p_group_num

)

Definition at line 321 of file other_api.cpp.

References _GetPState(), _PLock(), _PUnLock(), ParticleState::in_new_list, ParticleState::pgroup_id, and ParticleState::PGroups.

Referenced by gSpark::gSpark(), gSpark::Render(), and gSpark::Timestep().

{
    ParticleState &PS = _GetPState();

    if(PS.in_new_list)
        return; // ERROR

    _PLock();

    if(p_group_num < 0 || p_group_num >= (int)PS.PGroups.size())
        return; // ERROR

    _PUnLock();

    PS.pgroup_id = p_group_num;
}

Here is the call graph for this function:

Here is the caller graph for this function:

PARTICLEDLL_API void pDeathCallback	(	P_PARTICLE_CALLBACK	callback,
		void *	data
	)

Definition at line 555 of file other_api.cpp.

References _GetPState(), ParticleState::GetPGroup(), ParticleState::in_new_list, ParticleState::pgroup_id, and ParticleGroup::SetDeathCallback().

{
    ParticleState &PS = _GetPState();
    if(PS.in_new_list)
        return; // ERROR

    PS.GetPGroup(PS.pgroup_id).SetDeathCallback(callback, data);
}

Here is the call graph for this function:

PARTICLEDLL_API void pDeleteActionLists	(	int	action_list_num,
		int	action_list_count
	)

Definition at line 226 of file other_api.cpp.

References _GetPState(), _PLock(), _PUnLock(), ParticleState::ALists, and ParticleState::in_new_list.

{
    ParticleState &PS = _GetPState();

    if(PS.in_new_list)
        return; // ERROR

    if(action_list_num < 0)
        return; // ERROR

    _PLock();

    if(action_list_num + action_list_count > (int)PS.ALists.size())
        return; // ERROR

    for(int i = action_list_num; i < action_list_num + action_list_count; i++) {
        PS.ALists[i].resize(0);
        // XXX Does that delete the actions?
    }

    _PUnLock();
}

Here is the call graph for this function:

PARTICLEDLL_API void pDeleteParticleGroups	(	int	p_group_num,
		int	p_group_count
	)

Definition at line 300 of file other_api.cpp.

References _GetPState(), _PLock(), _PUnLock(), ParticleState::ALists, and ParticleState::PGroups.

Referenced by gSpark::Timestep().

{
    ParticleState &PS = _GetPState();

    if(p_group_num < 0)
        return; // ERROR

    _PLock();

    if(p_group_num + p_group_count > (int)PS.ALists.size())
        return; // ERROR

    for(int i = p_group_num; i < p_group_num + p_group_count; i++) {
        PS.PGroups[i].SetMaxParticles(0);
        PS.PGroups[i].GetList().resize(0);
    }

    _PUnLock();
}

Here is the call graph for this function:

Here is the caller graph for this function:

PARTICLEDLL_API void pEndActionList

(

)

Definition at line 214 of file other_api.cpp.

References _GetPState(), ParticleState::alist_id, and ParticleState::in_new_list.

{
    ParticleState &PS = _GetPState();

    if(!PS.in_new_list)
        return; // ERROR

    PS.in_new_list = false;

    PS.alist_id = -1;
}

Here is the call graph for this function:

PARTICLEDLL_API int pGenActionLists

(

int

action_list_count

)

Definition at line 178 of file other_api.cpp.

References _GetPState(), _PLock(), _PUnLock(), ParticleState::GenerateALists(), and ParticleState::in_new_list.

{
    ParticleState &PS = _GetPState();

    if(PS.in_new_list)
        return -1; // ERROR

    _PLock();

    int ind = PS.GenerateALists(action_list_count);

    _PUnLock();

    return ind;
}

Here is the call graph for this function:

PARTICLEDLL_API int pGenParticleGroups	(	int	p_group_count,
		size_t	max_particles
	)

Definition at line 280 of file other_api.cpp.

References _GetPState(), _PLock(), _PUnLock(), ParticleState::GeneratePGroups(), ParticleState::in_new_list, and ParticleState::PGroups.

Referenced by gSpark::gSpark().

{
    ParticleState &PS = _GetPState();

    if(PS.in_new_list)
        return -1; // ERROR

    _PLock();

    int ind = PS.GeneratePGroups(p_group_count);

    for(int i = ind; i < ind + p_group_count; i++) {
        PS.PGroups[i].SetMaxParticles(max_particles);
    }

    _PUnLock();

    return ind;
}

Here is the call graph for this function:

Here is the caller graph for this function:

PARTICLEDLL_API size_t pGetGroupCount

(

)

Definition at line 507 of file other_api.cpp.

References _GetPState(), _PLock(), _PUnLock(), ParticleState::GetPGroup(), ParticleState::in_new_list, ParticleState::pgroup_id, and ParticleState::PGroups.

Referenced by gSpark::Render(), and gSpark::Timestep().

{
    ParticleState &PS = _GetPState();

    if(PS.in_new_list)
        return 0; // ERROR

    PS.GetPGroup(PS.pgroup_id);
    _PLock();

    if(PS.pgroup_id < 0 || PS.pgroup_id >= (int)PS.PGroups.size())
        return static_cast< size_t >( -2 ); // ERROR

    _PUnLock();

    return PS.PGroups[PS.pgroup_id].size();
}

Here is the call graph for this function:

Here is the caller graph for this function:

PARTICLEDLL_API size_t pGetMaxParticles

(

)

Definition at line 526 of file other_api.cpp.

References _GetPState(), _PLock(), _PUnLock(), ParticleState::in_new_list, ParticleState::pgroup_id, and ParticleState::PGroups.

{
    ParticleState &PS = _GetPState();

    if(PS.in_new_list)
        return 0; // ERROR

    _PLock();

    if(PS.pgroup_id < 0 || PS.pgroup_id >= (int)PS.PGroups.size())
        return static_cast< size_t >( -2 ); // ERROR

    _PUnLock();

    return PS.PGroups[PS.pgroup_id].GetMaxParticles();
}

Here is the call graph for this function:

PARTICLEDLL_API size_t pGetParticlePointer	(	float *&	ptr,
		size_t &	stride,
		size_t &	pos3Ofs,
		size_t &	posB3Ofs,
		size_t &	size3Ofs,
		size_t &	vel3Ofs,
		size_t &	velB3Ofs,
		size_t &	color3Ofs,
		size_t &	alpha1Ofs,
		size_t &	age1Ofs
	)

Definition at line 470 of file other_api.cpp.

References _GetPState(), Particle::age, Particle::alpha, ParticleGroup::begin(), Particle::color, ParticleState::in_new_list, ParticleState::pgroup_id, ParticleState::PGroups, Particle::pos, Particle::posB, Particle::size, ParticleGroup::size(), Particle::vel, Particle::velB, and pVec::x().

Referenced by gSpark::Render().

{
    ParticleState &PS = _GetPState();

    if(PS.in_new_list)
        return static_cast< size_t >( -1 ); // ERROR

    ParticleGroup &pg = PS.PGroups[PS.pgroup_id];

    if(pg.size() < 1) {
        return static_cast< size_t >( -4 ); // ERROR index out of bounds.
    }

    ParticleList::iterator it = pg.begin();
    Particle *p0 = &(*it);
    ++it;
    Particle *p1 = &(*it);
    float *fp0 = (float *)p0;
    float *fp1 = (float *)p1;

    ptr = (float *)p0;
    stride = fp1 - fp0;
    pos3Ofs = (float *)&(p0->pos.x()) - fp0;
    posB3Ofs = (float *)&(p0->posB.x()) - fp0;
    size3Ofs = (float *)&(p0->size.x()) - fp0;
    vel3Ofs = (float *)&(p0->vel.x()) - fp0;
    velB3Ofs = (float *)&(p0->velB.x()) - fp0;
    color3Ofs = (float *)&(p0->color.x()) - fp0;
    alpha1Ofs = (float *)&(p0->alpha) - fp0;
    age1Ofs = (float *)&(p0->age) - fp0;

    return pg.size();
}

Here is the call graph for this function:

Here is the caller graph for this function:

PARTICLEDLL_API size_t pGetParticles	(	size_t	index,
		size_t	count,
		float *	verts,
		float *	color,
		float *	vel,
		float *	size,
		float *	age
	)

Definition at line 394 of file other_api.cpp.

References _GetPState(), _PLock(), _PUnLock(), Particle::age, ai, Particle::alpha, Particle::color, ParticleGroup::GetList(), ParticleState::in_new_list, ParticleState::pgroup_id, ParticleState::PGroups, Particle::pos, si, Particle::size, ParticleGroup::size(), Particle::vel, pVec::x(), pVec::y(), and pVec::z().

{
    ParticleState &PS = _GetPState();

    // XXX I should think about whether color means color3, color4, or what.
    // For now, it means color4.

    if(PS.in_new_list)
        return static_cast< size_t >( -1 ); // ERROR

    _PLock();

    if(PS.pgroup_id < 0 || PS.pgroup_id >= (int)PS.PGroups.size())
        return static_cast< size_t >( -2 ); // ERROR

    // useless test, both are never negative
    // if(index < 0 || count < 0)
    //    return static_cast< size_t >( -3 ); // ERROR

    ParticleGroup &pg = PS.PGroups[PS.pgroup_id];

    _PUnLock();

    if(index + count > pg.size()) {
        count = pg.size() - index;
        if(count <= 0)
            return static_cast< size_t >( -4 ); // ERROR index out of bounds.
    }

    int vi = 0, ci = 0, li = 0, si = 0, ai = 0;

    // This should be optimized.
    for(size_t i=index; i<index+count; i++) {
        const Particle &m = pg.GetList()[i];

        if(verts) {
            verts[vi++] = m.pos.x();
            verts[vi++] = m.pos.y();
            verts[vi++] = m.pos.z();
        }

        if(color) {
            color[ci++] = m.color.x();
            color[ci++] = m.color.y();
            color[ci++] = m.color.z();
            color[ci++] = m.alpha;
        }

        if(vel) {
            vel[li++] = m.vel.x();
            vel[li++] = m.vel.y();
            vel[li++] = m.vel.z();
        }

        if(size) {
            size[si++] = m.size.x();
            size[si++] = m.size.y();
            size[si++] = m.size.z();
        }

        if(age) {
            age[ai++] = m.age;
        }
    }

    return count;
}

Here is the call graph for this function:

PARTICLEDLL_API void pMass

(

float

mass

)

Definition at line 153 of file other_api.cpp.

References _GetPState(), and ParticleState::Mass.

{
    ParticleState &PS = _GetPState();

    PS.Mass = mass;
}

Here is the call graph for this function:

PARTICLEDLL_API void pNewActionList

(

int

action_list_num

)

Definition at line 194 of file other_api.cpp.

References _GetPState(), _PLock(), _PUnLock(), ParticleState::alist_id, ParticleState::ALists, and ParticleState::in_new_list.

{
    ParticleState &PS = _GetPState();

    if(PS.in_new_list)
        return; // ERROR

    _PLock();

    PS.alist_id = action_list_num;
    if(PS.alist_id < 0 || PS.alist_id >= (int)PS.ALists.size())
        return; // ERROR

    PS.in_new_list = true;
    PS.ALists[PS.alist_id].resize(0); // Remove any old actions
    // XXX Does that delete the actions?

    _PUnLock();
}

Here is the call graph for this function:

PARTICLEDLL_API void pReset

(

)

Definition at line 564 of file other_api.cpp.

References _GetPState(), ParticleGroup::GetList(), ParticleState::GetPGroup(), ParticleState::in_new_list, and ParticleState::pgroup_id.

{
    ParticleState &PS = _GetPState();
    if(PS.in_new_list)
        return; // ERROR

    PS.GetPGroup(PS.pgroup_id).GetList().clear();
}

Here is the call graph for this function:

PARTICLEDLL_API void pRotVelocity

(

const pVec &

v

)

Definition at line 97 of file other_api.cpp.

References _GetPState(), and ParticleState::RotVel.

{
    ParticleState &PS = _GetPState();

    delete PS.RotVel;
    PS.RotVel = new PDPoint(v);
}

Here is the call graph for this function:

PARTICLEDLL_API void pRotVelocityD

(

const pDomain &

dom

)

Definition at line 105 of file other_api.cpp.

References _GetPState(), pDomain::copy(), and ParticleState::RotVel.

{
    ParticleState &PS = _GetPState();

    delete PS.RotVel;
    PS.RotVel = dom.copy();
}

Here is the call graph for this function:

PARTICLEDLL_API void pSeed

(

unsigned int

seed

)

Definition at line 573 of file other_api.cpp.

References pSRandf.

{
    pSRandf(seed);
}

PARTICLEDLL_API size_t pSetMaxParticles

(

size_t

max_count

)

Definition at line 339 of file other_api.cpp.

References _GetPState(), ParticleState::GetPGroup(), ParticleState::in_new_list, ParticleState::pgroup_id, and ParticleGroup::SetMaxParticles().

{
    ParticleState &PS = _GetPState();

    if(PS.in_new_list)
        return 0; // ERROR

    // useless test, can never be negative
    // if(max_count < 0)
    //    return 0; // ERROR

    // This can kill them and call their death callback.
    PS.GetPGroup(PS.pgroup_id).SetMaxParticles(max_count);

    return max_count;
}

Here is the call graph for this function:

PARTICLEDLL_API void pSize

(

const pVec &

size

)

Definition at line 137 of file other_api.cpp.

References _GetPState(), and ParticleState::Size.

Referenced by gSpark::Timestep().

{
    ParticleState &PS = _GetPState();

    delete PS.Size;
    PS.Size = new PDPoint(size);
}

Here is the call graph for this function:

Here is the caller graph for this function:

PARTICLEDLL_API void pSizeD

(

const pDomain &

dom

)

Definition at line 145 of file other_api.cpp.

References _GetPState(), pDomain::copy(), and ParticleState::Size.

{
    ParticleState &PS = _GetPState();

    delete PS.Size;
    PS.Size = dom.copy();
}

Here is the call graph for this function:

PARTICLEDLL_API void pStartingAge	(	float	age,
		float	sigma
	)

Definition at line 160 of file other_api.cpp.

References _GetPState(), ParticleState::Age, and ParticleState::AgeSigma.

{
    ParticleState &PS = _GetPState();

    PS.Age = age;
    PS.AgeSigma = sigma;
}

Here is the call graph for this function:

PARTICLEDLL_API void pTimeStep

(

float

newDT

)

Definition at line 168 of file other_api.cpp.

References _GetPState(), and ParticleState::dt.

{
    ParticleState &PS = _GetPState();

    PS.dt = newDT;
}

Here is the call graph for this function:

PARTICLEDLL_API void pUpVec

(

const pVec &

up

)

Definition at line 65 of file other_api.cpp.

References _GetPState(), and ParticleState::Up.

{
    ParticleState &PS = _GetPState();

    delete PS.Up;
    PS.Up = new PDPoint(up);
}

Here is the call graph for this function:

PARTICLEDLL_API void pUpVecD

(

const pDomain &

dom

)

Definition at line 73 of file other_api.cpp.

References _GetPState(), pDomain::copy(), and ParticleState::Up.

{
    ParticleState &PS = _GetPState();

    delete PS.Up;
    PS.Up = dom.copy();
}

Here is the call graph for this function:

PARTICLEDLL_API void pVelocity

(

const pVec &

v

)

Definition at line 81 of file other_api.cpp.

References _GetPState(), and ParticleState::Vel.

{
    ParticleState &PS = _GetPState();

    delete PS.Vel;
    PS.Vel = new PDPoint(v);
}

Here is the call graph for this function:

PARTICLEDLL_API void pVelocityD

(

const pDomain &

dom

)

Definition at line 89 of file other_api.cpp.

References _GetPState(), pDomain::copy(), and ParticleState::Vel.

Referenced by gSpark::Timestep().

{
    ParticleState &PS = _GetPState();

    delete PS.Vel;
    PS.Vel = dom.copy();
}

Here is the call graph for this function:

Here is the caller graph for this function:

PARTICLEDLL_API void pVertexB

(

const pVec &

v

)

Definition at line 113 of file other_api.cpp.

References _GetPState(), and ParticleState::VertexB.

{
    ParticleState &PS = _GetPState();

    delete PS.VertexB;
    PS.VertexB = new PDPoint(v);
}

Here is the call graph for this function:

PARTICLEDLL_API void pVertexBD

(

const pDomain &

dom

)

Definition at line 121 of file other_api.cpp.

References _GetPState(), pDomain::copy(), and ParticleState::VertexB.

{
    ParticleState &PS = _GetPState();

    delete PS.VertexB;
    PS.VertexB = dom.copy();
}

Here is the call graph for this function:

PARTICLEDLL_API void pVertexBTracks

(

bool

trackVertex

)

Definition at line 130 of file other_api.cpp.

References _GetPState(), and ParticleState::vertexB_tracks.

{
    ParticleState &PS = _GetPState();

    PS.vertexB_tracks = trackVertex;
}

Here is the call graph for this function:

---