Skip to content

Latest commit

 

History

History
156 lines (137 loc) · 8.07 KB

FileFormats.md

File metadata and controls

156 lines (137 loc) · 8.07 KB

File Formats

Table of contents

Fonts

.font

  • File mode: binary
  • File extension: font or FONT
  • Use: storing sprite fonts
  • Magic: MAGEfont
  • Syntax: see SpriteFont format

Materials

.mtl

  • File mode: ANSI
  • File extension: mtl or MTL
  • Use: storing materials
  • (Line) comment characters:
    • #
  • Delimiters:
    • _ (space character)
    • \t (tab character)
    • \n (EOL: end of line character)
    • \r(CR: carriage return character)
  • Syntax: see MTL format
Definitions Syntax Arguments
base color base_color <F32> R=G=B channel (A=1) [0,1]
base color base_color <F32> <F32> <F32> R, G, B channels (A=1) [0,1]3
base color base_color <F32> <F32> <F32> <F32> R, G, B, A channels [0,1]4
base color texture texture_base_color <string> relative file name
metalness metalness <F32> metalness value [0,1]
material texture material_base_color <string> relative file name
new material newmtl <string> material name
normal texture normal_base_color <string> relative file name
opaque opaque opaque base color (= default)
radiance radiance <F32> radiance value
roughness roughness <F32> roughness value [0,1]
transparent transparent transparent base color (= default)
<string> <ANSI string without delimiters and EOFs>

Meshes

.msh

  • File mode: binary
  • File extension: msh or MSH
  • Use: storing one vertex buffer and its associated index buffer. VertexT and IndexT are not included in the file.
  • Magic: MAGEmesh
  • Syntax:
Definitions Syntax
MAGEmesh <nb-vertices> <nb-indices> <vertices> <indices>
<nb-vertices> <U32>
<nb-indices> <U32>
<vertices> <VertexT>...<VertexT> (<nb-vertices> times)
<indices> <IndexT>...<IndexT> (<nb-indices> times)

.obj

  • File mode: ANSI
  • File extension: obj or OBJ
  • Use: storing meshes/models
  • (Line) comment characters:
    • #
  • Delimiters:
    • _ (space character)
    • \t (tab character)
    • \n (EOL: end of line character)
    • \r(CR: carriage return character)
  • Syntax: see OBJ format
    • only a subset is supported
    • UVW vertex texture coordinates will be converted to UV vertex texture coordinates

Models

.mdl

  • File mode: ANSI
  • File extension: mdl or MDL
  • Use: storing models
  • (Line) comment characters:
    • #
  • Delimiters:
    • _ (space character)
    • \t (tab character)
    • \n (EOL: end of line character)
    • \r(CR: carriage return character)
  • Syntax:
Definitions Syntax
material library mtllib <string>.mtl
model part s <child-name> <parent-name> <translation> <rotation> <scale> <material-name> <start-index> <nb-indices>
<child-name> <string>
<parent-name> <string>
<translation> <F32> <F32> <F32>
<rotation> <F32> <F32> <F32>
<scale> <F32> <F32> <F32>
<material-name> <string>
<start-index> <U32>
<nb-indices> <U32>
<string> <ANSI string without delimiters and EOFs>

Textures

.dds

  • File mode: binary
  • File extension: dds or DDS
  • Use: storing textures
  • Magic: DDS
  • Syntax: see DDS format.

Variable Scripts

.var

  • File mode: ANSI
  • File extension: var or VAR
  • Use: storing simple properties
  • (Line) comment characters:
    • #
  • Delimiters:
    • _ (space character)
    • \t (tab character)
    • \n (EOL: end of line character)
    • \r(CR: carriage return character)
  • Syntax:
Definitions Syntax
property bool <property-name> true
property bool <property-name> false
property F32 <property-name> <F32>
property F32x2 <property-name> <F32> <F32>
property F32x3 <property-name> <F32> <F32> <F32>
property F32x4 <property-name> <F32> <F32> <F32> <F32>
property S32 <property-name> <S32>
property S32x2 <property-name> <S32> <S32>
property S32x3 <property-name> <S32> <S32> <S32>
property S32x4 <property-name> <S32> <S32> <S32> <S32>
property U32 <property-name> <U32>
property U32x2 <property-name> <U32> <U32>
property U32x3 <property-name> <U32> <U32> <U32>
property U32x4 <property-name> <U32> <U32> <U32> <U32>
property string <property-name> <string>
<property-name> <string>
<string> <ANSI string without delimiters and EOFs>

Copyright © 2016-2025 Matthias Moulin. All Rights Reserved.