# tantien

**Repository Path**: sxp82/tantien

## Basic Information

- **Project Name**: tantien
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: B-littleworld
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-12-05
- **Last Updated**: 2024-12-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# tantien

Data-driven game engine.

## Features

### Visual programming

Nodes for everything: shader, render pipeline, material, vfx, gui, ai, geometric edit, postprocessing, physical modeling, image processing, trigger event, scene modeling...

### Declarative programming

Constraint-based, rule-based and functional programming.

### Procedural generation

Procedural content generation.

## Editors

### blueprint
Based for each editors

#### Features
* custom node 
* subgraph
* ...

#### Nodes
* math : Boolean, Integer, Number, Number2, Number3, Number4, Matrix, Add, Subtract, Multiply, Divide, Radians, Sin, Cos, Clamp, Reciprocal, Negate, Abs, Length, Rect, Floor, Ceil,
* logic : AND, OR, NOT,
* camera : Camera2d, Camera3d, OrbitCamera, Lookat, Orthographic, Perspective,
* transform : Scale, Rotate, Translate,
* constant : Time, Viewport,
* data : Array, Combine, Fetch, Merge, Split, ListClear, ListAdd, ListAddF, ListRemove, ListShift, ListPopBack, ListBack, IsEmpty,
* control : flow
Block, Loop, LoopF, ForEach, Branch, BranchF, SwitchF, Compare, Finish, Group,
* tools : Commentary, Custom, Print, Proxy, Expand, Store, Load, Variable, Swap, Assignment, Debug, IsNull, Cache, ClearCache,
* subgraph : Input, Output, Property, Subgraph,

### rendergraph

![](./doc/rendergraph/screenshots/terrain.jpg)
    <em>Terrain</em>

![](./doc/rendergraph/screenshots/cel_shading.jpg)
    <em>Cel Shading</em>

![](./doc/rendergraph/screenshots/ssss.jpg)
    <em>Sample from Jorge Jimenez's separable-sss <a href="https://github.com/iryoku/separable-sss">SSSS</a></em>

![](./doc/rendergraph/screenshots/ssao.jpg)
    <em>Sample from learnopengl <a href="https://learnopengl.com/Advanced-Lighting/SSAO">SSAO</a></em>

#### Features
* auto gen shader uniforms
* operable nodes
<img src="./doc/rendergraph/screenshots/camera3d.gif">
* ...

#### Nodes
* vertex : Model, Gltf, PrimitiveShape, VertexArray,
* resource : Shader, Texture, Cubemap, RenderTarget, RenderBuffer, 
* operate : Clear, Compute, Draw,
* control : Pass,
* tools : ShaderCode,

### terraingraph

![](./doc/terraingraph/screenshots/erosion.jpg)
    <em>Noise and erosion</em>

![](./doc/terraingraph/screenshots/brush.gif)
    <em>Brush</em>

![](./doc/terraingraph/screenshots/noise_brush.gif)
    <em>Noise brush</em>

#### Features
* multiple brushes

#### Nodes
* generator : Gradient, Worley,
* combiner : Combiner,
* filter : Gaussian, Incline, ScaleBias, Step, Transform,
* natural : Erosion, ThermalWeathering,
* selector : SelectHeight, SelectSlope,
* edit : Brush,

### shadergraph

#### Features
* use spir-v AST instead of combine shader strings

#### Nodes
* input-geometry : Normal, TexCoord, WorldPos, 
* utility-shader : FragColor, Uniform,
* math : Cross, Dot, Normalize, Max, Min, Mix, Reflect, RotateX, RotateY, RotateZ, Pow, Sqrt,
* control : Kill, Return,
* tools : Parameter, SampleTexture, TBN, ShaderGen, 

### sdfgraph

![](./doc/sdfgraph/screenshots/combine.gif)

![](./doc/sdfgraph/screenshots/combine.jpg)
    <em>Sample from Jamie Wong's tutorial <a href="http://jamie-wong.com/2016/07/15/ray-marching-signed-distance-functions/">Ray Marching and Signed Distance Functions</a></em>

#### Nodes
* primitive : Sphere, Box, RoundBox, BoxFrame, Torus, CappedTorus, Link, InfiniteCylinder, Cone, InfiniteCone, Plane, HexagonalPrism, TriangularPrism, Capsule, VerticalCapsule, VertCappedCylinder, CappedCylinder, RoundedCylinder, VertCappedCone, CappedCone, SolidAngle, VertRoundCone, RoundCone, Ellipsoid, Rhombus, Octahedron, Pyramid, Triangle, Quad,
* operation-alterations : Elongate, Rounding, Onion,
* operation-combinations : Union, Subtraction, Intersection, SmoothUnion, SmoothSubtraction, SmoothIntersection,
* operation-positioning : Translate, Scale, Rotate, Symmetry, InfiniteRepetition, FiniteRepetition,
* operation-deformations and distortions : Displace, Twist, Bend,

### noisegraph

![](./doc/noisegraph/screenshots/ridged_turbulence.jpg)

![](./doc/noisegraph/screenshots/terrain.jpg)

#### Nodes
* noise : PerlinNoise, BillowedNoise, RidgedNoise,
* turbulence : Turbulence, IqTurbulence, SwissTurbulence, JordanTurbulence, Erosion1Turbulence, Erosion2Turbulence, DistortTurbulence,
* deriv : PerlinNoisePseudoDeriv, PerlinNoiseDeriv, NoiseDeriv,
* tools : Dither,

### pbrgraph

![](./doc/pbrgraph/screenshots/ibl.gif)

![](./doc/pbrgraph/screenshots/ibl.jpg)
    <em>IBL</em>

![](./doc/pbrgraph/screenshots/sheen.jpg)
    <em>Sheen</em>

![](./doc/pbrgraph/screenshots/clearcoat.jpg)
    <em>Clearcoat</em>

![](./doc/pbrgraph/screenshots/car.jpg)
    <em>Transmission</em>

#### Nodes
* Specular BRDF distribution : D_GGX, D_GGX_Anisotropic, D_Charlie,
* Specular BRDF visibility : V_Kelemen, V_Neubelt, V_Sheen, V_Smith, V_SmithGGXCorrelated, V_SmithGGXCorrelated_Anisotropic,
* Specular BRDF fresnel : F_Schlick, 
* Specular BRDF : Fr_CookTorrance,
* Diffuse BRDF : Fd_Burley, Fd_Lambert, Fd_Wrap,
* Tools : EnergyConservation, Shadergraph, SrgbToLinear, GammaCorrection, IorToRoughness, MirrorLight, IorToF0,

### pixelgraph

![](./doc/pixelgraph/screenshots/twirl.jpg)

#### Nodes
* artistic-adjustment : ChannelMixer, Contrast, Hue, InvertColors, ReplaceColor, Saturation, WhiteBalance,
* uv : Flipbook, PolarCoordinates, RadialShear, Rotate, Spherize, TilingAndOffset, Twirl,
* procedural-shapes : Checkerboard, Ellipse, Polygon, Rectangle, RoundedPolygon, RoundedRectangle,

### aigraph

#### Nodes
* behavior tree : Sequence, Selector, Parallel, Condition, Repeat,  
* tools : BehaviorTree,

### editorgraph

![](./doc/editorgraph/screenshots/multi_circles_edit.jpg)

![](./doc/editorgraph/screenshots/polyline.gif)

#### Nodes
* event : MouseLeftDown, MouseLeftUp, MouseRightDown, MouseRightUp, MouseLeftDrag, MouseMove, KeyPressed, KeyReleased, BlueprintChanged, LeaveRuntimeMode, EnterRuntimeMode,
* tools : Trigger, CoordTrans, IsKeyPressed, Ticker, Dirty,

### geograph

![](./doc/geograph/screenshots/breakout.gif)
    <em>Primitive shapes</em>

![](./doc/geograph/screenshots/bucket_arch.gif)
    <em>Parametric mesh generation</em>

![](./doc/geograph/screenshots/bucket_arch.jpg)

#### Nodes
* shapes : Line, Rect, Circle, Polyline, Polygon,
* constraints : Distance,
* operations : CopyAndTranslate, 
* actions : Translate,
* test : IsContain, IsIntersect,
* tools : DrawGeometry, ConstraintSolver, AABB, Resample,

### physicsgraph

![](./doc/physicsgraph/screenshots/pyramid.gif)

![](./doc/physicsgraph/screenshots/clock.gif)

#### Nodes
* objects : World, Body, Fixture, BodyInfo, Chain,
* joints : RevoluteJoint, PrismaticJoint, DistanceJoint, MouseJoint, WheelJoint,
* force : ApplyForce, ApplyTorque, ApplyLinearImpulse, ApplyAngularImpulse,
* setter : SetLinearVelocity, SetTransform, SetMotorSpeed,
* operate : Simulation, UpdateWorld, RemoveBody,
* events : BeginContact, EndContact, PreSolve, PostSolve,
* tools : BodySelector,

### ppgraph

![](./doc/ppgraph/screenshots/splitscreen.jpg)

#### Nodes
* SweetFX : Ascii, Border, CAS, CRT, Cartoon, ChromaticAberration, Cineon, ColorMatrix, Curves, FakeHDR, FilmGrain, LUT, Levels, LiftGammaGain, LumaSharpen, Monochrome, Nostalgia, Splitscreen, Technicolor, Technicolor2, Tint, Tonemap, Vibrance, Vignette,
* prod80 : ColorGamut, ColorSpaceCurves, CurvedLevels, ShadowsMidtonesHighlights, BlackAndWhite, ColorBalance, ColorIsolation, ColorTemperature, SaturationLimiter, SelectiveColor, SelectiveColor2, Technicolor3, LumaSharpen2,
* components : GaussianHori, GaussianVert,

### scenegraph

![](./doc/scenegraph/screenshots/combine.jpg)

#### Nodes
* dataset : Sprite, Combine,
* operations : Transform,
* tools : DrawSprite,

## Building
First clone the project & submodules:
```
git clone git@github.com:TanTien-Engine/tantien.git
cd tantien
git submodule update --init --recursive
```

### Windows
open platform/windows/tantien.sln
copy dlls (from platform/windows/lib)

Run: editor.exe rendergraph