Skip to content

(EN) Scene File format description.

Sylvain Doremus edited this page Mar 17, 2017 · 5 revisions

CSCN files are easily editable text files (since the syntax is understood).

Data types

The data types used in scene files are these ones :

  • int : a simple integer.
  • real : a floating point number, using dot ( . ) as the decimals separator.
  • 2, 3, 4 ints : 2, 3 or 4 integers, separated by commas ( , ) or spaces ( ).
  • 2, 3, 4 reals : 2, 3 or 4 floating point numbers, separated by commas ( , ) or spaces ( ).
  • size : 2 integers greater than or equal to 0.
  • 2x2, 3x3, 4x4 reals matrix : 2, 3 or 4 groups separated by semi colons ( ; ) of 2, 3 or 4 floating point numbers separated by commas ( , ) or spaces ( ).
  • colour : the four (RGBA) components of colour, expressed in floating point numbers between 0.0 et 1.0.
  • value : a string corresponding to a predefined value.
  • name : a string, wrapped into double quotes ( " ).
  • file : a string, wrapped into double quotes ( " ), containing a file name and path.
  • folder : a string, wrapped into double quotes ( " ), containing a folder path.

Sections

Description

The file is split into sections, defined as follows :

[section_type : _value_] [section_name : _name_]
{
	// section description
}

Example:

light "Light0"
{
	type directional
	colour 1.0 1.0 1.0
	intensity 0.0 0.8 1.0
}

Some sections can have child subsections :

material "Bronze"
{
	pass
	{
		ambient 0.2125 0.1275 0.054 1.0
		diffuse 0.714 0.4284 0.12144 1.0
		emissive 0.0 0.0 0.0 1.0
		specular 0.393548 0.271906 0.166721 1.0
		shininess 25.6
	}
}

Sections list

  1. 'sampler'

    Defines a texture sampler object.

  2. 'material'

    Defines a material.

  3. 'font'

    Defines a font used in text overlays.

  4. 'window'

    Defines a render window.

  5. 'panel_overlay'

    Defines a simple panel overlay.

  6. 'border_panel_overlay'

    Defines a panel overlay with a border.

  7. 'text_overlay'

    Defines a panel overlay with a text.

  8. 'scene'

    Defines a whole scene.

A - 'sampler' section

  1. 'min_filter' : value

    Value used into minification function.

  2. 'mag_filter' : value

    Value used into magnification function.

  3. 'min_lod' : real

    Defines minimum level of detail value.

  4. 'max_lod' : real

    Defines maximum level of detail value.

  5. 'lod_bias' : real

    Defines the MIP-Level.

  6. 'u_wrap_mode' : value

    Defines the wrapping mode of the texture, for the U component. The possible values are :

    • repeat : The texture is repeated.
    • mirrored_repeat : The texture is repeated, each instance of 2 being the mirror of the other one.
    • clamp_to_border : The texture is stretched, the object edge colour is defined as the texture edge colour.
    • clamp_to_edge : The texture is stretched, the object edge colour is defined as the average of the texture edge colour and the border colour.
  7. 'v_wrap_mode' : value

    Defines the wrapping mode of the texture, for the V component. The possible values are :

    • repeat : The texture is repeated.
    • mirrored_repeat : The texture is repeated, each instance of 2 being the mirror of the other one.
    • clamp_to_border : The texture is stretched, the object edge colour is defined as the texture edge colour.
    • clamp_to_edge : The texture is stretched, the object edge colour is defined as the average of the texture edge colour and the border colour.
  8. 'w_wrap_mode' : value

    Defines the wrapping mode of the texture, for the W component. The possible values are :

    • repeat : The texture is repeated.
    • mirrored_repeat : The texture is repeated, each instance of 2 being the mirror of the other one.
    • clamp_to_border : The texture is stretched, the object edge colour is defined as the texture edge colour.
    • clamp_to_edge : The texture is stretched, the object edge colour is defined as the average of the texture edge colour and the border colour.
  9. 'border_colour' : colour

    Defines the non textured border colour.

  10. 'max_anisotropy' : real

    Defines the maximum degree of anisotropy.

B - Section 'material'

Materials can be multi-pass, so you can declare more than one pass subsection.

  1. 'pass' : new section

    Defines a new section describing a texture.

C - 'pass' section

  1. 'ambient' : colour

    Defines ambient colour of the pass.

  2. 'diffuse' : colour

    Defines diffuse colour of the pass.

  3. 'emissive' : colour

    Defines emissive colour of the pass.

  4. 'specular' : colour

    Defines specular colour of the pass.

  5. 'shininess' : 1 real

    Defines the the specular exponent of the pass.

  6. 'alpha' : 1 real

    Defines the global alpha value for the pass.

  7. 'two_sided' : boolean

    Tells the pass is two sided (true) or not (false).

  8. 'blend_func' : src : value, dst : value

    The two functions (source and destination) used during alpha blending :

    • zero : The target (src or dst) won't be used during alpha blending.
    • one : The target (src or dst) will be the only one used.
    • src_colour : The target colour will be the source colour (dst only).
    • inv_src_colour : The target colour will be one minus the source colour (dst only).
    • dst_colour : The target colour will be the destination colour (src only).
    • inv_dst_colour : The target colour will be one minus the destination colour (src only).
    • src_alpha : The target alpha will be the source alpha (dst only).
    • inv_src_alpha : The target alpha will be one minus the source alpha (dst only).
    • dst_alpha : The target alpha will be the destination alpha (src only).
    • inv_dst_alpha : The target alpha will be one minus the destination alpha (src only).
    • src_alpha_sat : Sets source alpha to 1.
  9. 'texture_unit' : new section

    Defines a new section describing a texture unit.

  10. 'gl_shader_program' : new section

    Defines a new section describing a GLSL shader program.

  11. 'alpha_blend_mode' : value

    Alpha blending mode name, can be one of:

    • none : No alpha blending.
    • additive : Source and destination alpha values are added.
    • multiplicative : Source and destination alpha values are multiplied.
  12. 'colour_blend_mode' : value

    Colour blending mode name, can be one of:

    • none : No colour blending.
    • additive : Source and destination colour values are added.
    • multiplicative : Source and destination colour values are multiplied.

D - 'texture_unit' section

  1. 'image' : file

    Defines the image file name.

  2. 'render_target' : new section

    Defines a new section describing a render target.

  3. 'colour' : colour

    Defines the base blending colour.

  4. 'map_type' : value

    Defines the way the texture is mapped to the object :

    • none : No effect.
    • reflection : reflection mapping.
    • sphere : sphere mapping.
  5. 'alpha_func' : func : value ref-val: real

    Defines the way alpha rejection is applied to the texture. The second parameter is the reference value used in alpha rejection function. The first parameter values can be :

    • always : The sample colour is always applied.
    • less : The sample colour is applied if its alpha component is less than the second parameter.
    • less_or_equal : The sample colour is applied if its alpha component is less than or equal to the second parameter.
    • equal : The sample colour is applied if its alpha component is equal to the second parameter.
    • not_equal : The sample colour is applied if its alpha component is different from the second parameter.
    • greater_or_equal : The sample colour is applied if its alpha component is greater than or equal to the second parameter.
    • greater : The sample colour is applied if its alpha component is greater than the second parameter.
    • never : The sample colour is never applied.
  6. 'rgb_blend' : func : value Arg0 : value Arg1 : value

    Defines the texture behaviour during colour blending. The first parameter is the blending function, the two other ones are the operands (Arg0 and Arg1) of this function. The firs parameter can take one of the following values :

    • none : None of the two operands is used.
    • first_arg : Returns Arg0.
    • add : Returns Arg0 + Arg1.
    • add_signed : Returns Arg0 + Arg1 - 0.5.
    • modulate : Returns Arg0 x Arg1.
    • subtract : Returns Arg0 - Arg1.
    • dot3_rgb : Returns 4 x [((Arg0r - 0.5) x (Arg1r - 0.5)) + ((Arg0g - 0.5) x (Arg1g - 0.5)) + ((Arg0b - 0.5) x (Arg1b - 0.5))].
    • dot3_rgba : Returns 4 x [((Arg0r - 0.5) x (Arg1r - 0.5)) + ((Arg0g - 0.5) x (Arg1g - 0.5)) + ((Arg0b - 0.5) x (Arg1b - 0.5))].

    The two operands can be one of the following values :

    • texture : The current texture colour
    • texture0 : The first texture colour
    • texture1 : The second texture colour
    • texture2 : The third texture colour
    • texture3 : The fourth texture colour
    • constant :
    • diffuse :
    • previous :
  7. 'alpha_blend' : func : value Arg0 : value Arg1 : value

    Defines the texture behaviour during alpha blending. The first parameter is the blending function, the two other ones are the operands (Arg0 and Arg1) of this function. The first parameter can take one of the following values :

    • none : None of the two operands is used.
    • first_arg : Returns Arg0.
    • add : Returns Arg0 + Arg1.
    • add_signed : Returns Arg0 + Arg1 - 0.5.
    • modulate : Returns Arg0 x Arg1.
    • subtract : Returns Arg0 - Arg1.

    The two operands can be one of the following values :

    • texture : The current texture colour
    • texture0 : The first texture colour
    • texture1 : The second texture colour
    • texture2 : The third texture colour
    • texture3 : The fourth texture colour
    • constant :
    • diffuse :
    • previous :
  8. 'channel' : value

    The channel at which the texture is bound. Can be one of the following :

    • colour : Base colour.
    • ambient : Ambient lighting colour.
    • diffuse : Diffuse lighting colour.
    • normal : Normals.
    • specular : Specular lighting colour.
    • opacity : Opacity.
    • gloss : Specular exponent.
  9. 'sampler' : name

    Defines the sampler object used by the texture.

E - 'gl_shader_program' section

  1. 'vertex_program' : new section

    Defines a new section describing the vertex program.

  2. 'pixel_program' : new section

    Defines a new section describing the pixel program.

  3. 'geometry_program' : new section

    Defines a new section describing the geometry program.

  4. 'hull_program' : new section

    Defines a new section describing the hull (tessellation control) program.

  5. 'domain_program' : new section

    Defines a new section describing the domain (tessellation evaluation) program.

  6. 'constants_buffer' : new section

    Defines a new section dexcribing a constants buffer (uniform buffer).

F - 'vertex/pixel/geometry/hull/domain_program' section

  1. 'file' : file

    Shader file name

  2. 'sampler' : name

    Creates a new variable of sample (1D, 2D, ...) type, for the pixel shader.

  3. 'input_type' : value

    Defines the input faces data type, for geometry shader. Can be one of the following :

    • points : Points.
    • lines : Disjoint lines.
    • line_loop : Joint lines loop.
    • line_strip : Joint lines.
    • triangles : Disjoint triangles.
    • triangle_strip : Joint triangles.
    • triangle_fan : Triangles joint using the first point.
    • quads : Disjoint quads.
    • quad_strip : Joint quads.
    • polygon : Polygons.
  4. 'output_type' : value

    Defines the geometry chader output data type. Can be one of the following :

    • points : Points.
    • line_strip : Joint lines.
    • triangle_strip : Joint triangles.
    • quad_strip : Joint quads.
  5. 'output_vtx_count' : int

    Defines the geometry shader output vertices.

  6. 'variable' : new section

    Defines a new section describing a uniform variable.

G - 'constants_buffer' section

  1. 'shaders' : bitwise ORed values

    Shader types to which this buffer applies, can be one of:

    • vertex
    • hull
    • domain
    • geometry
    • pixel
    • compute
  2. 'variable' : name, new section

    Defines a new section describing a variable for this buffer.

H - 'variable' section

  1. 'type' : value

    Variable type name, can be :

    • int : 1 signed integer.
    • uint : 1 unsigned integer.
    • float : 1 simple precision floating point number.
    • double : 1 double precision floating point number.
    • vec2i : 2 signed integers.
    • vec3i : 3 signed integers.
    • vec4i : 4 signed integers.
    • vec2f : 2 simple precision floating point numbers.
    • vec3f : 3 simple precision floating point numbers.
    • vec4f : 4 simple precision floating point numbers.
    • vec2d : 2 double precision floating point numbers.
    • vec3d : 3 double precision floating point numbers.
    • vec4d : 4 double precision floating point numbers.
    • mat2x2i : 2x2 signed integers matrix.
    • mat2x3i : 2x3 signed integers matrix.
    • mat2x4i : 2x4 signed integers matrix.
    • mat3x2i : 3x2 signed integers matrix.
    • mat3x3i : 3x3 signed integers matrix.
    • mat3x4i : 3x4 signed integers matrix.
    • mat4x2i : 4x2 signed integers matrix.
    • mat4x3i : 4x3 signed integers matrix.
    • mat4x4i : 4x4 signed integers matrix.
    • mat2x2f : 2x2 simple precision floating point numbers matrix.
    • mat2x3f : 2x3 simple precision floating point numbers matrix.
    • mat2x4f : 2x4 simple precision floating point numbers matrix.
    • mat3x2f : 3x2 simple precision floating point numbers matrix.
    • mat3x3f : 3x3 simple precision floating point numbers matrix.
    • mat3x4f : 3x4 simple precision floating point numbers matrix.
    • mat4x2f : 4x2 simple precision floating point numbers matrix.
    • mat4x3f : 4x3 simple precision floating point numbers matrix.
    • mat4x4f : 4x4 simple precision floating point numbers matrix.
    • mat2x2d : 2x2 double precision floating point numbers matrix.
    • mat2x3d : 2x3 double precision floating point numbers matrix.
    • mat2x4d : 2x4 double precision floating point numbers matrix.
    • mat3x2d : 3x2 double precision floating point numbers matrix.
    • mat3x3d : 3x3 double precision floating point numbers matrix.
    • mat3x4d : 3x4 double precision floating point numbers matrix.
    • mat4x2d : 4x2 double precision floating point numbers matrix.
    • mat4x3d : 4x3 double precision floating point numbers matrix.
    • mat4x4d : 4x4 double precision floating point numbers matrix.
  2. 'count' : int

    Variable occurences count (array size).

  3. 'value' :

    Variable value, depends on the chosen type.

I - 'font' section

  1. 'file' : file

    Defines the file holding the font.

  2. 'height' : int

    Defines the height (precision) of the font.

J - 'scene' section

  1. 'ambient_light' : colour

    Defines ambient lighting colour.

  2. 'background_colour' : colour

    Defines background colour.

  3. 'background_image' : file

    Defines background image.

  4. 'import' : file

    Allows scene import from a CSCN file or another file format supported by Castor3D importer plug-ins.

  5. 'scene_node' : new section

    Defines new section describing a scene node for objects, lights or billboards.

  6. 'camera_node' : new section

    Defines new section describing a scene node for cameras.

  7. 'light' : new section

    Defines new section describing a light source.

  8. 'object' : new section

    Defines new section describing an object.

  9. 'billboard' : new section

    Defines new section describing a billboards list.

  10. 'camera' : new section

    Defines new section describing a camera.

  11. 'panel_overlay' : new section

    Defines new section describing a simple panel overlay.

  12. 'border_panel_overlay' : new section

    Defines new section describing a simple panel overlay with a border.

  13. 'text_overlay' : new section

    Defines new section describing a simple panel overlay with text.

  14. 'animated_object_group' : new section

    Defines new section describing an animated object group, with common animations.

K - 'scene_node' and 'camera_node' sections

  1. 'parent' : name

    Defines this node's parent. The default parent node is the root node.

  2. 'position' : 3 reals

    Node position relative to its parent.

  3. 'orientation' : 4 reals

    A quaternion holding node orientation relative to its parent.

  4. 'scale' : 3 reals

    Node scale relative to its parent.

L - 'light' section

  1. 'type' : value

    Three light source types exist in Castor3D :

    • directional : directional light (like the sun).
    • point_light : a positioned source which emits in all directions.
    • spot_light : a positioned source which emits in an oriented cone.
  2. 'colour' : 3 reals

    Defines the colour RGB components for this source.

  3. 'intensity' : 3 reals

    Defines the ambient, diffuse, and specular intensities for this source.

  4. 'attenuation' : 3 reals

    Defines the three attenuation components : constant, linear and quadratic. This attenuation is computed from the distance to the light source. Only for spot_light and point_light.

  5. 'cut_off' : real

    Defines the angle of the emission cone. Only for spot_light.

  6. 'exponent' : real

    Defines the attenuation computed with the distance from the emission cone centre. Only for spot_light.

  7. 'parent' : name

    Defines the node which this light source is attached to.

M - 'object' section

  1. 'parent' : name

    Defines the node which this object is attached to.

  2. 'mesh' : name new section

    Defines a new section describing a mesh with the given name.

  3. 'material' : name

    Name of a material, defined in a .cmtl file or in this file. Applies this material too all the submeshes.

  4. 'materials' : new section

    New section used to specify each submesh's material.

N - 'materials' section

  1. 'material' : int, name

    Submesh index, and material name for this submesh.

O - 'mesh' section

  1. 'type' : name

    Mesh type name, one of :

    • custom : manually defined mesh or imported mesh.
    • cube : a cube, user must then define its three dimensions.
    • cone : a cone, user must then define its radius and height.
    • cylinder : a cylinder, user must then define its radius and height.
    • sphere : a sphere with quad faces, user must then define the subdivisions count and the radius.
    • icosahedron : a sphere with triangular faces, user must then define the subdivisions count and the radius.
    • torus : a torus, user must then define the internal and external subdivisions count and the internal and external radius.
    • plane : a plane, user must then define the width and depth subdivisions count and the width and depth.
  2. 'submesh' : new section

    Defines a new section describing a submesh. Only if the mesh type is custom.

  3. 'import' : file <options>

    Allows import of mesh data from a file, in CMSH file format or any format supported by Castor3D import plug-ins. Only if the mesh type is custom. This directive can accept few optional parameters :

    • smooth_normals : Computes normals per vertex during import.
    • flat_normals : Computes normals per face during the import.
    • tangent_space : Computes tangent space informations (tangent and bi-tangent) during import.
  4. 'division' : name int

    Allows the mesh subdivision, using a supported Castor3D divider plug-in algorithm. The second parameter is the application count of the algorithm (its applied recursively).

P - 'submesh' section

  1. 'material' : name

    Defines the material used by this submesh.

  2. 'vertex' : 3 reals

    Defines a vertex position.

  3. 'uv' : 2 reals

    Defines the UV texture coordinates for the previously declared vertex.

  4. 'uvw' : 3 reals

    Defines the UVW texture coordinates for the previously declared vertex.

  5. 'normal' : 3 reals

    Defines the normal coordinates for the previously declared vertex.

  6. 'tangent' : 3 reals

    Defines the tangent coordinates for the previously declared vertex.

  7. ' face' : 3 or 4 integers

    Defines a face using the three or four vertices whose indices are given. If more than three indices are given, creates the appropriate count of triangular faces.

  8. 'face_uv' : as much uv as the face indices

    Defines the UV coordinates for each vertex of the previously declared face.

  9. 'face_uvw' : as much uvw as the face indices

    Defines the UVW coordinates for each vertex of the previously declared face.

  10. 'face_normals' : as much 3 reals groups as the face indices

    Defines the normals coordinates for each vertex of the previously declared face.

  11. 'face_tangents' : as much 3 reals groups as the face indices

    Defines the tangents coordinates for each vertex of the previously declared face.

Q - 'billboard' section

Allows the definition of billboards that share the same material and dimensions.

  1. 'parent' : name

    Defines the parent scene node.

  2. 'positions' : new section

    Defines a new section describing each billboard position.

  3. 'material' : name

    Defines the material used by every billboard of this list.

  4. 'dimensions' : size

    Defines billboards dimensions.

R - 'positions' section

  1. 'pos' : 3 reals Defines the relative position of a billboard.

S - 'camera' section

  1. 'parent' : name

    Defines the parent CameraNode.

  2. 'primitive' : value

    Defines the display type. Can be one of :

    • points : Points.
    • lines : Disjointed lines.
    • line_loop : Jointed lines loop.
    • line_strip : Joined lines.
    • triangles : Disjointed triangles.
    • triangle_strip : Jointed triangles.
    • triangle_fan : Triangles jointed using the first point.
    • quads : Disjointed quads.
    • quad_strip : Jointed quads.
    • polygon : Polygons.
  3. 'viewport' : new section

    Defines the camera view port.

T - 'viewport' section

  1. 'type' : value

    Window display type, 2d or 3d.

  2. 'left' : real

    Defines the minimum displayed X coordinate.

  3. 'right' : real

    Defines the maximum displayed X coordinate.

  4. 'top' : real

    Defines the minimum displayed Y coordinate.

  5. 'bottom' : real

    Defines the maximum displayed Y coordinate.

  6. 'near' : real

    Defines the minimum displayed Z coordinate.

  7. 'far' : real

    Defines the maximum displayed Z coordinate.

  8. 'size' : size

    Defines the window display size (in pixels).

  9. 'fov_y' : real

    Defines the vertical field of view angle, in radians.

  10. 'aspect_ratio' : real

    Defines the global window aspect ratio (1.33333 for 4/3, 1.77777 for 16/9 ... ).

U - 'animated_object_group' section

  1. 'animated_object' : name

    Adds the object with the given name to the group.

  2. 'animation' : name

    Adds the animation with the given name to the group's common animations list.

V - 'panel_overlay' section

  1. 'material' : name

    Defines the material used by the panel.

  2. 'position' : 2 reals

    Defines the overlay position, relative to its parent (or to screen, if no parent).

  3. 'size' : 2 reals

    Defines the overlay size, relative to its parent (or to screen, if no parent).

  4. 'pxl_position' : 2 ints

    Defines the absolute position for the overlay, in pixels.

  5. 'pxl_size' : 2 ints

    Defines the absolute size for the overlay, in pixels.

  6. 'uv' : 4 reals

    Defines the UV for the overlay (left, top, right, bottom).

  7. 'panel_overlay' : name new section

    Defines a new section describing a simple panel children overlay.

  8. 'border_panel_overlay' : name new section

    Defines a new section describing a border panel children overlay.

  9. 'text_overlay' : name new section

    Defines a new section describing a text panel children overlay.

W - 'border_panel_overlay' section

  1. 'material' : name

    Defines the material used by the panel.

  2. 'position' : 2 reals

    Defines the overlay position, relative to its parent (or to screen, if no parent).

  3. 'size' : 2 reals

    Defines the overlay size, relative to its parent (or to screen, if no parent).

  4. 'pxl_position' : 2 ints

    Defines the absolute position for the overlay, in pixels.

  5. 'pxl_size' : 2 ints

    Defines the absolute size for the overlay, in pixels.

  6. 'center_uv' : 4 reals

    Defines the UV for the center of the overlay (left, top, right, bottom).

  7. 'border_material' : name

    Defines the material used for the panel's border.

  8. 'border_position' : value

    Defines the border's position, can be one of:

    • internal : The border is inside the overlay.
    • middle : The border is half inside, half outside the overlay.
    • external : The border is outside the overlay.
  9. 'border_size' : 4 reals

    Defines the borders sizes (left right, top, bottom).

  10. 'pxl_border_size' : 2 ints

    Defines the absolute border size, in pixels.

  11. 'border_inner_uv' : 4 reals

    Defines the UV for the border of the overlay, inner side (left, top, right, bottom).

  12. 'border_outer_uv' : 4 reals

    Defines the UV for the border of the overlay, outer side (left, top, right, bottom).

  13. 'panel_overlay' : name new section

    Defines a new section describing a simple panel children overlay.

  14. 'border_panel_overlay' : name new section

    Defines a new section describing a border panel children overlay.

  15. 'text_overlay' : name new section

    Defines a new section describing a text panel children overlay.

X - 'text_overlay' section

  1. 'material' : name

    Defines the material used by the panel.

  2. 'position' : 2 reals

    Defines the overlay position, relative to its parent (or to screen, if no parent).

  3. 'size' : 2 reals

    Defines the overlay size, relative to its parent (or to screen, if no parent).

  4. 'pxl_position' : 2 ints

    Defines the absolute position for the overlay, in pixels.

  5. 'pxl_size' : 2 ints

    Defines the absolute size for the overlay, in pixels.

  6. 'font' : name

    Defines the font used to display the text.

  7. 'text' : texte

    Defines the displayed text.

  8. 'text_wrapping' : value

    Defines the way the text is cut when a line overflows the overlay dimensions. Can be one of:

    • none : The text is not cut (the part that overflows won't be displayed, though).
    • break : The text is cut at the letter (the words will be cut).
    • break_words : The text is cut at the word (the words remain uncut).
  9. 'vertical_align' : value

    Defines the text vertical alignment:

    • top : Align on top.
    • center : Vertically center.
    • bottom : Align on bottom.
  10. 'horizontal_align' : value

    Defines the text horizontal alignment:

    • left : Align on left.
    • center : Horizontally center.
    • right : Align on right.
  11. 'panel_overlay' : name new section

    Defines a new section describing a simple panel children overlay.

  12. 'border_panel_overlay' : name new section

    Defines a new section describing a border panel children overlay.

  13. 'text_overlay' : name new section

    Defines a new section describing a text panel children overlay.

Y - Section 'window'

  1. 'render_target' : nouvelle section

    Defines a new section describing the render target.

  2. 'vsync' : boolean

    Defines the activation or deactivation of vertical synchronisation.

  3. 'fullscreen' : boolean

    Defines the activation or deactivation of full-screen display.

Z - Section 'render_target'

  1. 'scene' : nom

    Defines the scene rendered in this target.

  2. 'camera' : nom

    Defines the camera used to render the scene.

  3. 'size' : size

    Defines the internal buffer dimensions.

  4. 'format' : value

    Defines the colour buffer pixel format. Can be one of :

    • l8 : Luminance 8 bits, one 8 bits integral number.
    • l16f : Luminance 16 bits, one 16 bits floating point number (half float).
    • l32f : Luminance 32 bits, one 32 bits floating point number(float).
    • al16 : Alpha + Luminance, two 8 bits integral number.
    • al16f : Alpha + Luminance, two 16 bits floating point number (half float).
    • al32f : Alpha + Luminance, two 32 bits floating point number (float).
    • argb1555 : ARGB 16 bits, 1 bit for alpha and each other component on a 5 bits integer.
    • rgb565 : RGB 16 bits, R and B on a 5 bits integer, G on a 6 bits integer.
    • argb16 : ARGB 16 bits, each component on a 4 bits integer.
    • rgb24 : RGB 24 bits, each component on a 8 bits integer.
    • argb32 : ARGB 32 bits, each component on a 8 bits integer.
    • argb16f : ARGB 64 bits, each component on a 16 bits floating point number (half float).
    • rgb32f : RGB 96 bits, each component on a 32 bits floating point number (half float).
    • argb32f : ARGB 128 bits, each component on a 32 bits floating point number (half float).
  5. 'depth' : value

    Defines the depth/stencil buffer pixel format. Can be one of :

    • depth16 : Depth on a 16 bits integer.
    • depth24 : Depth on a 24 bits integer.
    • depth24s8 : Depth on a 24 bits integer, Stencil on a 8 bits integer.
    • depth32fs8 : Depth on a 32 bits floating point, Stencil on a 8 bits integer.
    • depth32 : Depth on a 32 bits integer.
    • depth32f : Depth on a 32 bits floating point.
    • stencil1 : Stencil on 1 bit.
    • stencil8 : Stencil on a 8 bits integer.
  6. 'technique' : name optional parameters

    Defines the render technique to use. The parameters depend on the chosen technique.

  7. 'postfx' : value

    Defines a post render effect to use. The parameters depend on the chosen effect.

  8. 'stereo' : boolean

    Tells if we use stereoscopic display mode.

Clone this wiki locally