GFX.glTF

Name	Mandatory	Description	Default	Type
⬅️ Input		This shard can take 2 different types of input. It can take a 4x4 transformation for the glTF model to adopt. Or, it can accept a table which contain the transformation matrix and additional information to modify the materials of the glTF model.		[Float4](4){transform: [Float4](4) none: Any}
Output ➡️		Outputs the drawable object.		GFX.Drawable
Path	No	The path to load the model from	none	NoneStringVar(String)
Bytes	No	The bytes to load the model from	none	NoneBytesVar(Bytes)
Copy	No	Reference to another glTF model to copy	none	NoneVar(GFX.Drawable)
Params	No	Shader parameters for this drawable	none	None{GFX.Texture2D GFX.TextureCube Var(GFX.Buffer) [Float4](4) Float4 Float3 Float2 Float Int Int2 Int3 Int4 Var(GFX.Texture2D GFX.TextureCube Var(GFX.Buffer) [Float4](4) Float4 Float3 Float2 Float Int Int2 Int3 Int4)}Var({GFX.Texture2D GFX.TextureCube Var(GFX.Buffer) [Float4](4) Float4 Float3 Float2 Float Int Int2 Int3 Int4 Var(GFX.Texture2D GFX.TextureCube Var(GFX.Buffer) [Float4](4) Float4 Float3 Float2 Float Int Int2 Int3 Int4)})
Features	No	Features to attach to this drawable	none	None[GFX.Feature]Var([GFX.Feature])
AnimationController	No	The animation controller	none	Shard[Shard]None
WrapRootNode	No	Wrap the root node so animations applied to it still work	none	NoneBool

This shard takes the glTF model (specified either in the Path, Bytes or Copy parameter) and outputs a drawable object which can be subsequently added to the drawables queue for the render pipline.

Details

This shard can take a table as input that contains the following keys with the following values: - "transform": The 4x4 transformation matrix that contains the translation, rotation and scale for the glTF model to adopt. - "materials": A sub-table that contains information to modify the materials of the glTF model. - ["bone1" "bone2" "bone3"]: A node can be modified by passing the bones path as a sequence of strings as the key and a sub-table containing the parameters to modify. Eg.

{
  ["rootNode" "spine" "upperBody"]: {
    scale: @f3(2.0)
  }
} GFX.glTF(Bytes: asset/my-model)

The sub-table that can be provided in the materials key of the input table will take the following format: "key" : value where the key will be the name of the material to modify and the value can either be: - a material object to replace the current material of the glTF model with, or - another sub-table which contains information that can modify the current material.

The sub-table that can be used to modify the material can take the following format: - "params": a table containing keys representing parameters specific to the material and values with their respective types. Providing the a value to a key here will modify the value of the parameter in the final glTF model.

The input table can include keys representing nodes to modify. The keys can be a sequence of strings representing the nodes to modify. There can also be multiple keys with different sequences of nodes. The values for these node keys can be a table with the following keys: - "transform": A 4x4 transformation matrix (overrides individual components) - "translation": A float3 value for node translation - "rotation": A float4 quaternion for node rotation - "scale": A float3 value for node scaling - "params": A table of node-specific parameters (if applicable)

In Formabble, the 3D asset is given to the Copy parameter for the shard to create the drawable object for that asset.

---