This article's documentation is for anything that uses the Source engine. Click here for more information.

Mat texture list: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
No edit summary
m (Changed parameters of {{this is a}} to comply with the updated version. This action was performed by a bot.)
 
(7 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{cleanup}}
{{this is a|console variable|name=mat_texture_list}} It lists every texture currently used.
This console variable lists every texture currently loaded.
{{bug|This menu has a possibly memory-related issue that causes rare to very frequent crashing. Doing <code>mat_texture_list_all 1</code> and setting <code>host_timescale</code> to a low decimal before loading the menu will help with this a lot.}}
{{bug|In Portal 2, this menu has an undetermined issue that causes frequent crashing. Doing <code>mat_texture_list_all 1</code> and setting <code>host_timescale</code> to a low decimal seem to help with this a lot.}}


==Interface==
[[File:Texture browser.jpg|400px|thumbnail|right]]
==Main Interface==
*'''F (Frame)''': Amount of texture memory used every frame.
*'''F (Frame)''': Amount of texture memory used every frame.
*'''T (Total)''': Amount of memory the engine currently has cached.
*'''T (Total)''': Amount of texture memory the engine currently has cached.
*'''S (Shown)''': Amount of memory used by the textures shown in the list.
*'''S (Shown)''': Amount of memory used by the textures shown in the list.
*'''View textures thumbnails''': Show the textures and their details with a thumbnail, similar to the Hammer material browser, or without, similar to a file browser.
*'''View textures thumbnails''': Show the textures and their details with a thumbnail, similar to the Hammer material browser, or without, similar to a file browser.
*'''Alpha''': Show the alpha channels of textures separately in the same thumbnail square. This option disappears if '''View textures thumbnails''' is off.
*'''Alpha''': Show the alpha channels of textures separately in the same thumbnail square. This option disappears if '''View textures thumbnails''' is off.
*'''Show ALL textures''': Show all textures in the map and some from the game menu as opposed to just ones currently in the player view. <code>mat_texture_list_all 1</code> is the same thing.
*'''Show ALL textures''': Show all textures in the map and some from the game menu as opposed to just ones currently in the player view.
*'''Hide [[Mipmap|Mipped]]''': Hide textures that use mipping. Does not include anything that can be mipped.
*'''Hide [[Mipmap|Mipped]]''': Hide textures that use mipping. Does not include anything that can be mipped.
*'''Filter''': Optional substring filtering for texture filepaths. ('''eap''' would display all w'''eap'''on textures.)
*'''Filter''': Optional substring filtering for texture filepaths. ('''eap''' would display all w'''eap'''on textures.)
*'''Reload All Materials''': Reloads every texture. Comes in handy with some of the options below.
*'''Reload All Materials''': Reloads every texture. Comes in handy with some of the options below.
*'''Commit Changes''': Saves all changes to material content files.
*'''Commit Changes''': Saves all changes to material content files. Broken since the [[SteamPipe]] updates.


Click the small square in the top left corner to toggle between the expanded and collapsed menus. The expanded menu has some more options and values, in addition to the ones above:
Click the small square in the top left corner to toggle between the expanded and collapsed menus. The expanded menu has some more options and values, in addition to the ones above:
Line 21: Line 21:
*'''Resolve Full Texture Path''': When viewing textures with thumbnails off, this displays the full filepath of the [[vtf]] in the '''Path''' column.
*'''Resolve Full Texture Path''': When viewing textures with thumbnails off, this displays the full filepath of the [[vtf]] in the '''Path''' column.


[[File:Texture browser expanded.jpg|left|framed]]
==Texture Interface==
[[File:Texture browser selectedtexture.jpg|400px|thumbnail|right]]
Click on a texture thumbnail to bring up another panel with values and options specific to the texture.
*'''Rebuild VTF''': Broken since the [[SteamPipe]] updates.
*'''Reload''': Runs <code>mat_reloadmaterial</code> on the texture.
*'''Open''': Opens the texture in your system's file browser. If the texture is inside a [[GCF]], [[VPK]], or [[BSP]], this will not work correctly.
*'''ToggleNoMip''': Broken since the [[SteamPipe]] updates.
*'''--''': Manually set the texture to a lower mip.
*'''+''': Manually set the texture to a higher mip.
*'''Flash in Game''': Makes the texture slowly blink by using missing.vtf. Only one texture can be flashing at a time.
*'''Copy Text''': Copies the texture filepath, size, resolution, and format (e.g. DXT1) to the computer clipboard.
*'''Copy Image''': Copies the panel to the computer clipboard as an image. It will look like the image on the right.


Select one of the desired options.
==Related Commands and ConVars==
<code>mat_texture_list</code>
:Show a list of use textures per frame.
<code>+mat_texture_list</code>, <code>-mat_texture_list</code>, <code>mat_texture_list_on</code>, <code>mat_texture_list_off</code>
:Dedicated commands for quick toggling of the list panel. Only {{code|+/-mat_texture_list}} works.
<code>mat_texture_list_all</code>
:The '''Show ALL textures''' button works by simply setting this ConVar to <code>1</code>.
<code>mat_texture_list_view</code>
:The '''View textures thumbnails''' button works by simply setting this ConVar to <code>1</code>.
<code>mat_show_texture_memory_usage</code>
:The '''Show Memory Usage on HUD''' button works by simply setting this ConVar to <code>1</code>. Not integrated with the list panel at all, so it works without any <code>mat_texture_</code> ConVars.
<code>mat_texture_list_txlod</code>
:Adjust the mip of the last viewed texture. <code>+1</code> increases resolution and <code>-1</code> decreases.
<code>mat_texture_limit</code>
:Adjusts the amount of texture memory per frame. Any texture deemed over the limit will render black. Use with caution as it will affect your screen itself, too.
<code>mat_picmip</code>
:Adjusts mip maps for all textures.


*'''Render Targets and Special Textures'''
== See also ==
:''When Checked, this will list all of the Render Targets and Special Textures.''
*'''Show Memory Useage on HUD'''
:''Shows how much memory is being used If Checked.''
*'''Show ALL textures'''
:''Shows all of the textures loaded by the game or mod If Checked.''
*'''View textures thumbnails'''
:''Shows all thumbnail previews of the textures If Checked (checked by default).''
:*'''Alpha'''
::''Shows all alpha texures embeded If Checked (checked by default).''
:*'''Warns'''
::{{confirm|''Shows warning messages on HUD If Checked''}}
*'''Filter'''
:Shows all textures with the custom set name to search from If Checked (checked by default).
*'''Resolve Full Texture Path'''
:''?''
 
 
== Texture Properties ==
 
By selecting a texture from the list, the selected texture's properties will show
[[File:Texture browser selectedtexture.jpg]]
 
*[[File:Texturebrowser Reloadbtn.jpg]]
:''Reloads the texture''
*[[File:Texturebrowser Openbtn.jpg]]
:''Opens the folder window (in Window Exporer) where the selected texture is located''
::{{Note|If the vtf texture is located in a [[GCF]], a [[VPK]] or is a special texture (A texture that is dynamicly generated in game), it will not open the correct folder}}
 
*[[File:Texturebrowser Minusbtn.jpg]]
:''Decrease mip detail''
*[[File:Texturebrowser Plusbtn.jpg]]
:''Increase mip detail''
 
*[[File:Texturebrowser Gamebtn.jpg]]
:''Flashes texture (either on the surface or model) in the currently loaded map and closes the texture list''
*[[File:Texturebrowser CopyTextbtn.jpg]]
:''Copies the file path and texture properties in text form into the clipboard''
*[[File:Texturebrowser CopyImagebtn.jpg]]
:''Takes a screenshot of the window of the selected texture into the clipboard''
 
 
 
== Commands ==
 
 
 
'''mat_texture_list 0''' 
:Texture browser off
 
'''mat_texture_list 1'''
:Texture browser on
 
'''mat_texture_list_all 0'''
:list currently loaded textures
 
'''mat_texture_list_all 1'''
:list all textures
 
== See Also ==
*[[MIP Mapping]]
*[[MIP Mapping]]
*[[Valve Texture Format]]
*[[Valve Texture Format]]
[[Category:Console Variables]]

Latest revision as of 18:31, 17 May 2024

mat_texture_list is a console variable available in all Source Source games. It lists every texture currently used.

Icon-Bug.pngBug:This menu has a possibly memory-related issue that causes rare to very frequent crashing. Doing mat_texture_list_all 1 and setting host_timescale to a low decimal before loading the menu will help with this a lot.  [todo tested in ?]
Texture browser.jpg

Main Interface

  • F (Frame): Amount of texture memory used every frame.
  • T (Total): Amount of texture memory the engine currently has cached.
  • S (Shown): Amount of memory used by the textures shown in the list.
  • View textures thumbnails: Show the textures and their details with a thumbnail, similar to the Hammer material browser, or without, similar to a file browser.
  • Alpha: Show the alpha channels of textures separately in the same thumbnail square. This option disappears if View textures thumbnails is off.
  • Show ALL textures: Show all textures in the map and some from the game menu as opposed to just ones currently in the player view.
  • Hide Mipped: Hide textures that use mipping. Does not include anything that can be mipped.
  • Filter: Optional substring filtering for texture filepaths. (eap would display all weapon textures.)
  • Reload All Materials: Reloads every texture. Comes in handy with some of the options below.
  • Commit Changes: Saves all changes to material content files. Broken since the SteamPipe updates.

Click the small square in the top left corner to toggle between the expanded and collapsed menus. The expanded menu has some more options and values, in addition to the ones above:

  • Render Targets and Special Textures: Shows some more game-critical textures, like the screen and water reflections. This also shows render targets, like the camera screens from Nova Prospekt.
  • Show Memory Usage on HUD: Shows the F (Frame) and T (Total) values on the main screen, so that the user can see how much memory is used at once without having to constantly check back on the list panel.
  • Warns: Show warnings on texture thumbnails. Like Alpha, this option disappears when View textures thumbnails is off.
  • Resolve Full Texture Path: When viewing textures with thumbnails off, this displays the full filepath of the vtf in the Path column.

Texture Interface

Texture browser selectedtexture.jpg

Click on a texture thumbnail to bring up another panel with values and options specific to the texture.

  • Rebuild VTF: Broken since the SteamPipe updates.
  • Reload: Runs mat_reloadmaterial on the texture.
  • Open: Opens the texture in your system's file browser. If the texture is inside a GCF, VPK, or BSP, this will not work correctly.
  • ToggleNoMip: Broken since the SteamPipe updates.
  • --: Manually set the texture to a lower mip.
  • +: Manually set the texture to a higher mip.
  • Flash in Game: Makes the texture slowly blink by using missing.vtf. Only one texture can be flashing at a time.
  • Copy Text: Copies the texture filepath, size, resolution, and format (e.g. DXT1) to the computer clipboard.
  • Copy Image: Copies the panel to the computer clipboard as an image. It will look like the image on the right.

Related Commands and ConVars

mat_texture_list

Show a list of use textures per frame.

+mat_texture_list, -mat_texture_list, mat_texture_list_on, mat_texture_list_off

Dedicated commands for quick toggling of the list panel. Only +/-mat_texture_list works.

mat_texture_list_all

The Show ALL textures button works by simply setting this ConVar to 1.

mat_texture_list_view

The View textures thumbnails button works by simply setting this ConVar to 1.

mat_show_texture_memory_usage

The Show Memory Usage on HUD button works by simply setting this ConVar to 1. Not integrated with the list panel at all, so it works without any mat_texture_ ConVars.

mat_texture_list_txlod

Adjust the mip of the last viewed texture. +1 increases resolution and -1 decreases.

mat_texture_limit

Adjusts the amount of texture memory per frame. Any texture deemed over the limit will render black. Use with caution as it will affect your screen itself, too.

mat_picmip

Adjusts mip maps for all textures.

See also