Contents

Texture Browser

RED+ adds a RED+ box to RED's Texture Browser, with filters, the file details of the current texture and three buttons. It also adds file details when you hover a tile, tags on the tiles, more sort orders, larger tiles, mouse-wheel scrolling and renaming.

Opening the browser

In Texture mode (Shift+T), click Browse on the Texture Mode panel.

The RED+ box

The RED+ box sits under Show Tiled. From top to bottom it holds:

Type: and Show:, which narrow the list.
Search all folders.
A reminder of how the Name box works.
The file details of the texture in the Current Texture box.
Favourite and Select faces.
Check level textures.

The browser remembers Type, Show and Search all folders, also after RED+ restarts.

Finding textures

Type

Choice	Lists
All types	Every texture.
TGA	`.tga` files.
VBM	`.vbm` files.
VBM - animated	`.vbm` files with more than one frame.
VBM - still	`.vbm` files with one frame.
DDS	`.dds` files.
PNG / JPG	`.png`, `.jpg` and `.jpeg` files.
ATX	`.atx` files.

Show

Choice	Lists
Everything	Every texture.
With alpha	Textures whose file has alpha.
Animated	`.vbm` files with more than one frame, and `.atx` files.
Small (up to 64 px)	Textures whose longer side is 64 pixels or less.
Medium (65 to 256 px)	Textures whose longer side is 65 to 256 pixels.
Large (over 256 px)	Textures whose longer side is over 256 pixels.
Not power of two	Textures whose width or height is not a power of two.
Favourites	Your favourites, from every folder.

Show reads each file's header:

With alpha counts a .vbm in 1555 or 4444 format, a 32-bit .tga, a 16-bit .tga with alpha bits, a .dds in DXT2 to DXT5 or uncompressed with alpha, and a .png with an alpha channel. A DXT1 .dds, a .jpg and an .atx do not count.
A texture whose size cannot be read is in none of the three size choices.
While RED+ reads many headers, the window title shows Texture Browser - reading texture headers with a count.

Search all folders

With Search all folders ticked, the list comes from every folder: the game's own textures and every custom folder, whichever folder the browser is showing. This happens when the Name box has text or Show is not Everything. Otherwise the browser lists the chosen folder as usual.

Show > Favourites always lists from every folder.

The Name box

The Name box takes several words. A texture is listed when its name contains every word, in any order and in either case. A word that starts with - leaves out the names that contain the rest of that word.

brick red lists the names that contain both brick and red.
brick -tf_ lists the names that contain brick but not tf_.

The count in the title

While Type, Show or Search all folders narrows the list, the window title says how many textures are listed and where, for example Texture Browser - 12 DDS textures (With alpha) in this folder.

What the browser shows

File details

The RED+ box shows the file of the texture in the Current Texture box:

Its type, its size in pixels and its format: for a .vbm, 4444, 565 or 1555, and for an animated one its frames and frame rate; for a .tga, its bit depth and whether it has alpha; for a .dds, its compression; for a .png, whether it has alpha.
The file size.
Where it is: a loose file, with its folder, or inside a named .vpp.
How many faces of the level's brushes use it, or Not used in this level.

When the file cannot be found, the details say Not found by the game's file system.

Hover details

Hovering a tile shows the texture's full name, the same file details and, if the level uses it, on how many faces. A favourite also says Favourite.

Tags on the tiles

Tiles carry small tags, read from the file:

Top left: the file type (VBM, DDS, PNG, JPG or ATX; a .tga has none). An animated .vbm also shows its frame count, such as 8f.
Top right: A when the file has alpha, as With alpha counts it.
Bottom left: NPOT when the width or height is not a power of two.

A tile smaller than 48 pixels on screen, such as at 32 x 32, has no tags.

Checkerboard behind alpha

Textures with alpha are drawn over a grey checkerboard, not over black, in the tiles, the recent-texture row and the Current Texture box.

Animated textures

An animated .vbm plays in the Current Texture box.

Sorting

Sort by has three choices besides RED's own:

Size: the largest image first, by pixel count, then by width, then by name. Textures whose size cannot be read come last. The first size sort reads the size of every texture in the list, and the window title shows Texture Browser - reading texture sizes with a count.
Type: by file extension, in alphabetical order, then by name.
Most used: by how many faces of the level's brushes use the texture, the most first, then by name.

Favourites

Click a texture, so it shows in the Current Texture box.
Click Favourite. The button stays pressed while the texture is a favourite. Click it again to remove the texture from your favourites.

Show > Favourites lists every favourite, from every folder.

Replacing a texture everywhere

Select faces selects every face of the visible brushes that uses the texture in the Current Texture box. It works in Texture mode only.

In Texture mode, open the browser and click the texture to replace.
Click Select faces. RED+ clears the face selection, selects the faces and says how many. Click OK.
Click the new texture.
Click OK to close the browser.
Click Apply on the Texture Mode panel.

Ctrl+Z undoes the change.

Faces on hidden brushes are left out, and the message says how many.
Select faces in the browser is not the Select Faces button on the Texture Mode panel.

Checking the level's textures

Check level textures lists the textures on the level's brush faces that other players may not have. See Check Level Textures.

Larger tiles

Display Size has two more choices: 256 x 256 and 512 x 512. In a narrow window, a 512 or 256 tile is halved until it fits, but not below 128.

Scrolling

The mouse wheel scrolls the tiles.

Renaming a texture file

Click the texture.
Press F2. The browser shows this as a hint: Select a texture, then hit F2 to rename it.
Type the new name in New name: in the Rename Texture window.
Click OK.

Rules:

It renames the file on disk. Faces that use the old name keep the old name.
Keep the extension. Renaming does not convert a texture to another format. If you leave the extension out, RED+ keeps the old one.
The name can have at most 31 characters, including the extension, and no characters Windows does not allow in file names.
A loose file with the new name must not exist already in user_maps\textures or one of its folders.
Only a loose file in user_maps\textures or one of its folders can be renamed. A texture inside a .vpp cannot.

Files RED+ keeps

RED+ keeps these files in the RED+ folder:

File	What it holds
`texture_favourites.txt`	Your favourites, one texture name per line.
`texture_info.cache`	What Type, Show and the tags read from each file, so each file is read once. RED+ writes it when the browser closes.
`texture_sizes.cache`	The image sizes for Sort by > Size.

RED+ reads a loose file again when its size or date changes. A texture inside a .vpp is read once. You can delete either cache: RED+ then reads the files again.

Turning the additions off

Tools, Preferences..., category RED+, has Texture Browser additions: RED+ box, tooltips, tile tags, checkerboard. It is on by default. A change takes effect the next time the browser opens.

With it off, the browser has no RED+ box, no hover details, no tags, no checkerboard, no animated preview and no Type or Most used sort, and the Name box matches its text as one piece, as in RED. The larger tiles, Sort by > Size, wheel scrolling and renaming stay.

Good to know

Filtering by material works as in RED: the material list shows the textures whose names start with one of that material's prefixes.
Once the browser holds many tile textures, RED+ frees those of tiles you have scrolled past, so a long browse does not exhaust the editor's memory. Closing the browser frees all of them.
For which file the browser draws for a name, see Which texture file RED+ uses.