Mat texture list: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
No edit summary
(hit save too early last time, whoops!)
Line 1: Line 1:
{{cleanup}}
This console variable 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 memory the engine currently has cached.
Line 9: Line 9:
*'''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. Won't work, relies on things only Valve employees have access to.


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''': Won't work, relies on things only Valve employees have access to.
*'''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''': Won't work, relies on things only Valve employees have access to.
*'''--''': 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>
*'''Render Targets and Special Textures'''
:Show a list of use textures per frame.
:''When Checked, this will list all of the Render Targets and Special Textures.''
<code>+mat_texture_list</code>, <code>-mat_texture_list</code>, <code>mat_texture_list_on</code>, <code>mat_texture_list_off</code>
*'''Show Memory Useage on HUD'''
:Dedicated commands for quick toggling of the list panel. None of them work.
:''Shows how much memory is being used If Checked.''
<code>mat_texture_list_all</code>
*'''Show ALL textures'''
:The '''Show ALL textures''' button works by simply setting this ConVar to <code>1</code>.
:''Shows all of the textures loaded by the game or mod If Checked.''
<code>mat_texture_list_view</code>
*'''View textures thumbnails'''
:The '''View textures thumbnails''' button works by simply setting this ConVar to <code>1</code>.
:''Shows all thumbnail previews of the textures If Checked (checked by default).''
<code>mat_show_texture_memory_usage</code>
:*'''Alpha'''
: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.
::''Shows all alpha texures embeded If Checked (checked by default).''
<code>mat_texture_list_txlod</code>
:*'''Warns'''
:Adjust the mip of the last viewed texture. <code>+1</code> increases resolution and <code>-1</code> decreases.
::{{confirm|''Shows warning messages on HUD If Checked''}}
<code>mat_texture_limit</code>
*'''Filter'''
: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.
:Shows all textures with the custom set name to search from If Checked (checked by default).
<code>mat_picmip</code>
*'''Resolve Full Texture Path'''
:Adjusts mip maps for all textures.
:''?''
 
 
== 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 ==
== See Also ==

Revision as of 01:59, 25 May 2018

This console variable 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 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. Won't work, relies on things only Valve employees have access to.

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: Won't work, relies on things only Valve employees have access to.
  • 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: Won't work, relies on things only Valve employees have access to.
  • --: 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. None of them work.

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