Texture Folder Structure: Difference between revisions

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


Most folders have a subfolder for textures that tile in only one direction '''(tiling_1d)''' and textures that do not tile at all '''(nontiling).'''
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 ==
Regular tiling carpets go under main folder.
Regular tiling carpets go under main folder.
 
*'''carpet/rugs''' (are not expected to tile)
'''carpet/rugs''' (are not expected to tile)
*'''carpet/runners''' (are expected to tile in only one direction--include end pieces)
 
'''carpet/runners''' (are expected to tile in only one direction--include end pieces)


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


== textures/darkmod/door ==
== textures/darkmod/door ==
 
* '''door/metal'''  (any doors that are primarily metal). Gate textures with bars get the prefix '''bars_'''.
'''door/metal'''  (any doors that are primarily metal)
* '''door/wood''' (regular board or panel doors). Rich, mansion-type doors get the prefix '''ornate_'''.
 
'''door/metal/bars''' (for door or gate textures with bars)
 
'''door/wood''' (regular board or panel doors)
 
'''door/wood/ornate''' (rich, mansion-type doors)


== 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.  
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/bonehoard'''
* '''map_specific/gathers'''
 
* '''map_specific/blackheart_manor'''
'''map_specific/mansion_alpha'''
 
etc.
etc.


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


== textures/darkmod/nature ==
== textures/darkmod/nature ==
 
* '''nature/dirt''' (dirt, mud, topsoil, etc)
'''nature/dirt''' (dirt, mud, topsoil, etc)
* '''nature/foliage''' (leaves, ivy, distant trees, etc)
 
* '''nature/grass''' (grass and straw)
'''nature/foliage''' (leaves, ivy, distant trees, etc)
* '''nature/skybox''' (for premade skyboxes)
 
* '''nature/water'''
'''nature/grass''' (grass and straw)
 
'''nature/skybox''' (for premade skyboxes)
 
'''nature/water'''


== textures/darkmod/paint_paper ==
== textures/darkmod/paint_paper ==
For painted wood or wallpaper textures.


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 ==
== textures/darkmod/roof ==
For textures that are obviously for a roof, like shingles.
For textures that are obviously for a roof, like shingles.


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


== textures/darkmod/stone ==
== 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)


'''stone/cobblestones''' (for rough, uneven blocks or flagstone textures)
== textures/darkmod/window ==
 
Regular windows.  (designations for indoor vs outdoor, and lit vs unlit, should be included in the name)
'''stone/brick''' (for regular, rectangular bricks of any size)
* '''window/ornate''' (stained glass or otherwise decorative)
 
* '''window/transparent_glass''' (for windows using see-through textures)
'''stone/natural''' (rock walls, cave surfaces, gravel)
 
'''stone/flat''' (cement, marble, ceramic tiles, anything basically flat)
 
'''stone/flat/smooth''' (polished smooth marble or ceramic surfaces)
 
'''stone/sculpted''' (for tiles or surfaces that have been intentionally sculpted or carved)
 


== textures/darkmod/wood ==
== textures/darkmod/wood ==
* '''wood/boards''' (anything made of boards or planks)
* '''wood/panels''' (anything made of panels or seamless wood pieces)


'''wood/boards''' (anything made of boards or planks)
== See also ==
 
* [[Material File Naming Convention]]
'''wood/panels''' (anything made of panels or seamless wood pieces)
* [[Model Folder Structure]]
 
'''wood/plaster'''  (walls that are plaster or mixes of plaster and wood--most city wall textures go here)
 
== textures/darkmod/windows ==
 
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}} [[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