Texture Folder Structure: Difference between revisions

From The DarkMod Wiki
Jump to navigationJump to search
No edit summary
No edit summary
 
(18 intermediate revisions by 4 users not shown)
Line 1: Line 1:
This is the new folder structure for textures.
This is the new folder structure for textures as of June 07.


Formatting is wip.
Most textures are in a virtual "shader subfolder" for textures that tile in only one direction '''(tiling_1d)''' and textures that do not tile at all '''(nontiling).''' This only affects the way the textures are sorted in DarkRadiant's MediaBrowser and is intended to give additional sorting information about the tiling behaviour.
 
'''Important:''' Due to an annoying limitation, DDS textures cannot be saved in folders that are more than 5 levels deep. An example for the maximum DDS path depth is this: '''dds/textures/darkmod/stone/flat/'''. Any textures that are saved deeper than that, cannot be opened by Doom 3.


== textures/darkmod/carpet ==
== textures/darkmod/carpet ==
carpet (regular tiling carpets go under main folder)
Regular tiling carpets go under main folder.
*'''carpet/rugs''' (are not expected to tile)
*'''carpet/runners''' (are expected to tile in only one direction--include end pieces)


carpet/rugs (are not expected to tile)
== textures/darkmod/decals ==
 
* '''decals/blood'''  (bloodstains, blood smears, bloody footprints, etc)
carpet/runners (are expected to tile in only one direction)
* '''decals/dirt''' (for dirt, grime, mud, stains)
 
* '''decals/symbols''' (magical symbols, signs, graffiti, arrows)
== textures/darkmod/stone ==
* '''decals/vegetation''' (leaves, scattered straw, ivy, weeds)
 
stone/blocks (for rough, uneven block textures)
 
stone/brick (for regular bricks of any size)
 
stone/natural (rock walls, caves, gravel)
 
stone/flat (cement, marble, anything basically smooth)
 
all of the above would also have a "nontiling" and "tiling_2d" subfolder
 
== textures/darkmod/wood ==
 
wood/boards (anything made of planks)
 
wood/panels (anything made of panels or seamless wood pieces)
 
wood/paint_paper (for wallpapered or painted walls, perhaps not a great name?)
 
wood/beams (for wooden beams, or textures that mix beams and something else)
 
all of the above would also have a "nontiling" and "tiling_2d" subfolder
 
== textures/darkmod/nature ==
 
nature/foliage (leaves, ivy, distant trees, etc)
 
nature/grass (grass and straw)
 
nature/dirt (dirt, mud, topsoil, etc)
 
nature/water


all of the above would also have a "nontiling" and "tiling_2d" subfolder
== textures/darkmod/door ==
 
* '''door/metal'''  (any doors that are primarily metal). Gate textures with bars get the prefix '''bars_'''.
nature/skybox (?)
* '''door/wood''' (regular board or panel doors). Rich, mansion-type doors get the prefix '''ornate_'''.


== textures/darkmod/map_specific ==
== textures/darkmod/map_specific ==
For textures that are needed for specific maps that aren't appropriate for the regular folder structure, like cubemap reflections or LOD shots.  Each map should have its own subfolder.


map_specific (for textures that are needed for specific maps that aren't appropriate for the regular folder structure--perhaps cubemap reflections? Can't think of much else)
* '''map_specific/gathers'''
 
* '''map_specific/blackheart_manor'''
map_specific/bonehoard
 
map_specific/mansion_alpha
 
etc.
etc.


== textures/darkmod/metal ==
== textures/darkmod/metal ==
* '''metal/flat''' (for relatively flat, non-detailed metal)
* '''metal/detail''' (for textures with obvious pipes, gears, patterns, or other 3d features)
* '''metal/grate''' (for grating, bars)


metal/flat (for relatively smooth, non-detailed metal)
== textures/darkmod/nature ==
* '''nature/dirt''' (dirt, mud, topsoil, etc)
* '''nature/foliage''' (leaves, ivy, distant trees, etc)
* '''nature/grass''' (grass and straw)
* '''nature/skybox''' (for premade skyboxes)
* '''nature/water'''


metal/detail (for textures with obvious pipes, gears, rivets)
== textures/darkmod/paint_paper ==
For painted wood or wallpaper textures.


metal/grate (for semi-transparent grating, bars)
== textures/darkmod/plaster ==
Surfaces that are plaster or mixes of plaster and wood--most city wall textures go here.


all of the above would also have a "nontiling" and "tiling_2d" subfolder
== textures/darkmod/roof ==
For textures that are obviously for a roof, like shingles.


== textures/darkmod/windows ==
== textures/darkmod/sfx ==
For lightbeam textures, alpha blends, detail textures, etc.


window (regular windows and transparent glass texture goes under main folder)
== textures/darkmod/stone ==
* '''stone/cobblestones''' (for rough, uneven blocks or flagstone textures)
* '''stone/brick''' (for regular, rectangular bricks of any size)
* '''stone/natural''' (rock walls, cave surfaces, gravel)
* '''stone/flat''' (cement, marble, ceramic tiles, anything basically flat). Polished surfaces get the prefix '''smooth_'''.
* '''stone/sculpted'''  (for tiles or surfaces that have been intentionally sculpted or carved)


window/ornate (stained glass or otherwise decorative)
== textures/darkmod/window ==
Regular windows.  (designations for indoor vs outdoor, and lit vs unlit, should be included in the name)
* '''window/ornate''' (stained glass or otherwise decorative)
* '''window/transparent_glass''' (for windows using see-through textures)


window/transparent_glass (for windows using see-through textures)
== textures/darkmod/wood ==
 
* '''wood/boards''' (anything made of boards or planks)
(designations for indoor vs outdoor, and lit vs unlit, should be included in the name)
* '''wood/panels''' (anything made of panels or seamless wood pieces)
 
== textures/darkmod/doors ==
 
door/wood (regular old doors)
 
door/wood/ornate (rich, mansion-type doors)
 
door/metal
 
door/metal/bars (for door or gate textures with bars)
 
 
== textures/darkmod/roof ==
(for textures that are obviously for a roof, like shingles)
 
== textures/darkmod/decals ==
 
decals/dirt (for dirt, grime, mud, stains)
 
decals/symbols (magical symbols, signs, graffiti)


decals/vegetation (leaves, scattered straw, ivy)
== See also ==
* [[Material File Naming Convention]]
* [[Model Folder Structure]]


decals/blood
{{textures}} [[Category:Folderstructure]]

Latest revision as of 19:28, 22 August 2008

This is the new folder structure for textures as of June 07.

Most textures are in a virtual "shader subfolder" for textures that tile in only one direction (tiling_1d) and textures that do not tile at all (nontiling). This only affects the way the textures are sorted in DarkRadiant's MediaBrowser and is intended to give additional sorting information about the tiling behaviour.

Important: Due to an annoying limitation, DDS textures cannot be saved in folders that are more than 5 levels deep. An example for the maximum DDS path depth is this: dds/textures/darkmod/stone/flat/. Any textures that are saved deeper than that, cannot be opened by Doom 3.

textures/darkmod/carpet

Regular tiling carpets go under main folder.

  • carpet/rugs (are not expected to tile)
  • carpet/runners (are expected to tile in only one direction--include end pieces)

textures/darkmod/decals

  • decals/blood (bloodstains, blood smears, bloody footprints, etc)
  • decals/dirt (for dirt, grime, mud, stains)
  • decals/symbols (magical symbols, signs, graffiti, arrows)
  • decals/vegetation (leaves, scattered straw, ivy, weeds)

textures/darkmod/door

  • door/metal (any doors that are primarily metal). Gate textures with bars get the prefix bars_.
  • door/wood (regular board or panel doors). Rich, mansion-type doors get the prefix ornate_.

textures/darkmod/map_specific

For textures that are needed for specific maps that aren't appropriate for the regular folder structure, like cubemap reflections or LOD shots. Each map should have its own subfolder.

  • map_specific/gathers
  • map_specific/blackheart_manor

etc.

textures/darkmod/metal

  • metal/flat (for relatively flat, non-detailed metal)
  • metal/detail (for textures with obvious pipes, gears, patterns, or other 3d features)
  • metal/grate (for grating, bars)

textures/darkmod/nature

  • nature/dirt (dirt, mud, topsoil, etc)
  • nature/foliage (leaves, ivy, distant trees, etc)
  • nature/grass (grass and straw)
  • nature/skybox (for premade skyboxes)
  • nature/water

textures/darkmod/paint_paper

For painted wood or wallpaper textures.

textures/darkmod/plaster

Surfaces that are plaster or mixes of plaster and wood--most city wall textures go here.

textures/darkmod/roof

For textures that are obviously for a roof, like shingles.

textures/darkmod/sfx

For lightbeam textures, alpha blends, detail textures, etc.

textures/darkmod/stone

  • stone/cobblestones (for rough, uneven blocks or flagstone textures)
  • stone/brick (for regular, rectangular bricks of any size)
  • stone/natural (rock walls, cave surfaces, gravel)
  • stone/flat (cement, marble, ceramic tiles, anything basically flat). Polished surfaces get the prefix smooth_.
  • stone/sculpted (for tiles or surfaces that have been intentionally sculpted or carved)

textures/darkmod/window

Regular windows. (designations for indoor vs outdoor, and lit vs unlit, should be included in the name)

  • window/ornate (stained glass or otherwise decorative)
  • window/transparent_glass (for windows using see-through textures)

textures/darkmod/wood

  • wood/boards (anything made of boards or planks)
  • wood/panels (anything made of panels or seamless wood pieces)

See also