forked from bartvdbraak/blender
0a63b3c0ca
- Added part of Austin's msvc8 fixes (vector::erase function was "misused"), hopefully compiles better now. - Ctrl-b now also bakes a selected fluidsim domain similar to the softbodies. - Added surface smoothing option for domains: default is 1, higher values result in a smoother surface (and probably slightly higher comupation times), while 0 means the surface is not modified at all. - Added BLENDER_ELBEEMBOBJABORT environment variable in readBobj, if >0 quits blender when a not yet existing fluidsim frame should be loaded. Useful for rendering simulations as far as possible from the command line. - Surface normals pointer is now set to NULL in readfile.c - Fixed win32 error string handling, now uses a function to return the string from the solver. - Fixed fluidsim particle halo scaling problem. - Solver update
192 lines
5.1 KiB
C
192 lines
5.1 KiB
C
/******************************************************************************
|
|
*
|
|
* El'Beem - Free Surface Fluid Simulation with the Lattice Boltzmann Method
|
|
* All code distributed as part of El'Beem is covered by the version 2 of the
|
|
* GNU General Public License. See the file COPYING for details.
|
|
* Copyright 2003-2005 Nils Thuerey
|
|
*
|
|
* API header
|
|
*/
|
|
#ifndef ELBEEM_API_H
|
|
#define ELBEEM_API_H
|
|
|
|
|
|
/*! blender types for mesh->type */
|
|
//#define OB_FLUIDSIM_DOMAIN 2
|
|
#define OB_FLUIDSIM_FLUID 4
|
|
#define OB_FLUIDSIM_OBSTACLE 8
|
|
#define OB_FLUIDSIM_INFLOW 16
|
|
#define OB_FLUIDSIM_OUTFLOW 32
|
|
|
|
#define FLUIDSIM_OBSTACLE_NOSLIP 1
|
|
#define FLUIDSIM_OBSTACLE_PARTSLIP 2
|
|
#define FLUIDSIM_OBSTACLE_FREESLIP 3
|
|
|
|
|
|
// global settings for the simulation
|
|
typedef struct elbeemSimulationSettings {
|
|
/* version number */
|
|
short version;
|
|
|
|
/* geometrical extent */
|
|
float geoStart[3], geoSize[3];
|
|
|
|
/* resolutions */
|
|
short resolutionxyz;
|
|
short previewresxyz;
|
|
/* size of the domain in real units (meters along largest resolution x,y,z extent) */
|
|
float realsize;
|
|
|
|
/* fluid properties */
|
|
double viscosity;
|
|
/* gravity strength */
|
|
float gravity[3];
|
|
/* anim start end time */
|
|
float animStart, aniFrameTime;
|
|
/* no. of frames to simulate & output */
|
|
short noOfFrames;
|
|
/* g star param (LBM compressibility) */
|
|
float gstar;
|
|
/* activate refinement? */
|
|
short maxRefine;
|
|
/* amount of particles to generate (0=off) */
|
|
float generateParticles;
|
|
|
|
/* store output path, and file prefix for baked fluid surface */
|
|
char outputPath[160+80];
|
|
|
|
/* channel for frame time, visc & gravity animations */
|
|
int channelSizeFrameTime;
|
|
float *channelFrameTime;
|
|
int channelSizeViscosity;
|
|
float *channelViscosity;
|
|
int channelSizeGravity;
|
|
float *channelGravity; // vector
|
|
|
|
/* boundary types and settings for domain walls */
|
|
short obstacleType;
|
|
float obstaclePartslip;
|
|
/* generate speed vectors for vertices (e.g. for image based motion blur)*/
|
|
short generateVertexVectors;
|
|
/* strength of surface smoothing */
|
|
float surfaceSmoothing;
|
|
|
|
/* global transformation to apply to fluidsim mesh */
|
|
float surfaceTrafo[4*4];
|
|
|
|
/* development variables, testing for upcoming releases...*/
|
|
float farFieldSize;
|
|
|
|
} elbeemSimulationSettings;
|
|
|
|
|
|
// a single mesh object
|
|
typedef struct elbeemMesh {
|
|
/* obstacle,fluid or inflow... */
|
|
short type;
|
|
|
|
/* vertices */
|
|
int numVertices;
|
|
float *vertices; // = float[][3];
|
|
|
|
/* triangles */
|
|
int numTriangles;
|
|
int *triangles; // = int[][3];
|
|
|
|
/* animation channels */
|
|
int channelSizeTranslation;
|
|
float *channelTranslation;
|
|
int channelSizeRotation;
|
|
float *channelRotation;
|
|
int channelSizeScale;
|
|
float *channelScale;
|
|
|
|
/* active channel */
|
|
int channelSizeActive;
|
|
float *channelActive;
|
|
/* initial velocity channel (e.g. for inflow) */
|
|
int channelSizeInitialVel;
|
|
float *channelInitialVel; // vector
|
|
/* use initial velocity in object coordinates? (e.g. for rotation) */
|
|
short localInivelCoords;
|
|
/* boundary types and settings */
|
|
short obstacleType;
|
|
float obstaclePartslip;
|
|
|
|
/* name of the mesh, mostly for debugging */
|
|
char *name;
|
|
} elbeemMesh;
|
|
|
|
// API functions
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif // __cplusplus
|
|
|
|
// reset elbeemSimulationSettings struct with defaults
|
|
void elbeemResetSettings(struct elbeemSimulationSettings*);
|
|
|
|
// start fluidsim init (returns !=0 upon failure)
|
|
int elbeemInit(struct elbeemSimulationSettings*);
|
|
// get failure message during simulation or init
|
|
// if an error occured (the string is copied into buffer,
|
|
// max. length = 256 chars )
|
|
void elbeemGetErrorString(char *buffer);
|
|
|
|
// reset elbeemMesh struct with zeroes
|
|
void elbeemResetMesh(struct elbeemMesh*);
|
|
|
|
// add mesh as fluidsim object
|
|
int elbeemAddMesh(struct elbeemMesh*);
|
|
|
|
// do the actual simulation
|
|
int elbeemSimulate(void);
|
|
|
|
|
|
// helper functions
|
|
|
|
// simplify animation channels
|
|
// returns if the channel and its size changed
|
|
int elbeemSimplifyChannelFloat(float *channel, int *size);
|
|
int elbeemSimplifyChannelVec3(float *channel, int *size);
|
|
|
|
// helper functions implemented in utilities.cpp
|
|
|
|
/* set elbeem debug output level (0=off to 10=full on) */
|
|
void elbeemSetDebugLevel(int level);
|
|
/* elbeem debug output function, prints if debug level >0 */
|
|
void elbeemDebugOut(char *msg);
|
|
|
|
/* estimate how much memory a given setup will require */
|
|
double elbeemEstimateMemreq(int res,
|
|
float sx, float sy, float sz,
|
|
int refine, char *retstr);
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif // __cplusplus
|
|
|
|
|
|
|
|
/******************************************************************************/
|
|
// internal defines, do not use for initializing elbeemMesh
|
|
// structs, for these use OB_xxx defines above
|
|
|
|
/*! fluid geometry init types */
|
|
#define FGI_FLAGSTART 16
|
|
#define FGI_FLUID (1<<(FGI_FLAGSTART+ 0))
|
|
#define FGI_NO_FLUID (1<<(FGI_FLAGSTART+ 1))
|
|
#define FGI_BNDNO (1<<(FGI_FLAGSTART+ 2))
|
|
#define FGI_BNDFREE (1<<(FGI_FLAGSTART+ 3))
|
|
#define FGI_BNDPART (1<<(FGI_FLAGSTART+ 4))
|
|
#define FGI_NO_BND (1<<(FGI_FLAGSTART+ 5))
|
|
#define FGI_MBNDINFLOW (1<<(FGI_FLAGSTART+ 6))
|
|
#define FGI_MBNDOUTFLOW (1<<(FGI_FLAGSTART+ 7))
|
|
|
|
#define FGI_ALLBOUNDS ( FGI_BNDNO | FGI_BNDFREE | FGI_BNDPART | FGI_MBNDINFLOW | FGI_MBNDOUTFLOW )
|
|
|
|
|
|
#endif // ELBEEM_API_H
|