> For the complete documentation index, see [llms.txt](https://docs.gta.clothing/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gta.clothing/basics/good-to-know/texture-studio.md).

# Texture Studio

Add pictures, text, patches, paint, embroidery and badge finishes to cloth textures inside Durty Cloth Tool, with the layers kept editable in your project

## Introduction

**Texture Studio** is Durty Cloth Tool's built-in layer editor for cloth textures. Place a logo, write a name on a name tape, generate a shoulder patch or rank insignia, pick a ready-made badge, tape or club patch from the [patch library](#patches-and-the-patch-library), or change colours, and watch the result on the ped in the [3D Preview](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md) while you edit. Give a patch a **finish** such as embroidery, a woven label, an enamel pin or a metal badge, and it gets real relief and shine on the cloth. A [fabric base](#fabric-bases) covers the whole cloth with knit, denim, leather or another fabric in one step.

Your layers stay editable. Texture Studio keeps them with the drawable in your project, so you can open it again next week and change the text, move a patch or swap a logo.

Texture Studio also edits the picture of a tattoo design or a facial or body overlay, such as makeup, blusher, eyebrows or chest hair. See [#tattoo-designs-and-overlays](#tattoo-designs-and-overlays "mention").

Texture Studio can also paint: a brush, an eraser and two fills on paint layers, on the canvas or straight onto the cloth on the ped, kept inside a selection when you make one. See [#paint](#paint "mention"). It is not a full image editor, though. To paint with your own image editor's brushes and tools, use a [Creator Link plugin](https://docs.gta.clothing/plugins/creator-link.md), or [Live texture editing](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md#live-texture-editing-preview) in the 3D Preview.

{% hint style="info" %}
You can open Texture Studio, edit layers, place patches from the patch library, insert materials from your [material shelf](#the-material-shelf) and see the result on the ped without a license. Finishes, saving to the cloth, saving layers to the material shelf and the exports **Export PNG**, **Export height map** and **Export layered PSD** are part of **Durty Cloth Tool Ultimate**. **Export UV template** is free. See [License Activation](https://docs.gta.clothing/getting-started/license-activation.md).
{% endhint %}

## Open Texture Studio

* Right-click a drawable or one of its texture variations and choose **Edit and organize > Open in Texture Studio** (or press **Ctrl+K** and paste `>Open in Texture Studio`). From a texture variation, Texture Studio starts with that variation.
* In the 3D Preview, open **View > Live texture editing** and choose **Open in Texture Studio** for the cloth the preview shows.
* Right-click a tattoo design or an overlay and choose **Edit and organize > Open in Texture Studio**, or choose **Texture Studio** on its row in the 3D Preview's **Outfit** tab while it is worn. See [#tattoo-designs-and-overlays](#tattoo-designs-and-overlays "mention").
* Choose **View > Texture Studio** to show or hide its tab (or press **Ctrl+K** and paste `>Texture Studio` to open it). With nothing open, it says **No texture open** and offers **Open the selected drawable**, which opens the drawable selected in Appearance Items.

Texture Studio opens as a tab next to **Item Details** in the workspace. The tab reads **Texture Studio:** followed by the drawable's name, with a `*` while there are unsaved changes. Drag the tab out to use it in its own window, and drag it back to dock it again. On a small screen (smaller than 1600 by 900 after Windows scaling), or when the middle of the editor has too little room, Texture Studio opens in its own window that fills the screen when you open a drawable in it. Once you dock it back or drag it out yourself, it opens where you put it from then on. **View > Reset Workspace Layout** (or press **Ctrl+K** and paste `>Reset Workspace`) puts it back in its place.

Texture Studio shows one drawable at a time. Selecting other items in Appearance Items does not change what it shows. Opening another drawable, closing the tab, switching the project or closing Durty Cloth Tool with unsaved changes asks whether to save, discard or cancel. If Durty Cloth Tool closes without asking, for example after a crash, your unsaved layers can usually be recovered, see [#recover-unsaved-work](#recover-unsaved-work "mention").

Pick the texture variation you want to edit under **Variation**. Variations marked **in the document** already have layers or a saved result.

## The editor

When the tab is wide, the canvas fills the left side and one column on the right holds the selected layer's properties above the layer list. When it is narrow, the canvas keeps the room and one side panel switches between **Layers** and **Properties**. It starts on **Layers** and turns to **Properties** when you add a layer.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-a2c2b1efd44d052e044016c6b6906a19832f1910%2Ftexture-studio-layers.png?alt=media" alt="Texture Studio docked between the item list and the 3D Preview on a black hoodie, with a FORGE text layer selected on the back panel of the canvas with its handles, the Placement stage with Place on ped turned on, and the 3D Preview showing FORGE across the back of the ped."><figcaption><p>Texture Studio on a hoodie: a text layer placed on the back, and the result on the ped.</p></figcaption></figure>

* **Canvas**: drag a layer to move it and use the handles to scale and rotate it, see [#canvas-controls](#canvas-controls "mention"). **View** switches the canvas between the **Diffuse**, **Normal** and **Specular** maps, and **UV guide** shows where the islands of the model lie on the texture.
* **Layers**: each row has a visibility and a lock toggle. Reorder layers by dragging them or with the row's menu, which also offers rename, duplicate and delete.
* **Properties**: three stages for the selected layer. **Layer** sets what the layer draws and how it blends, **Finish** sets its finish, and **Placement** sets its position, size, rotation, mirroring and mask, or places it by clicking the ped (see [#place-a-layer-on-the-ped](#place-a-layer-on-the-ped "mention")).

Every change can be undone and redone, and every action can be given a shortcut in **Options > Keybindings** (or press **Ctrl+K** and paste `@Change a shortcut`). See [Shortcuts](https://docs.gta.clothing/basics/useful-to-know/shortcuts.md).

### Canvas controls

The canvas moves like in common image editors:

| To                      | Do this                                                                                                                                                                                      |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Move a layer            | Drag it. Hold **Shift** to keep it on a straight line. The arrow keys nudge the selected layer by one pixel, or ten with **Shift**.                                                          |
| Scale a layer           | Drag a handle. The opposite side stays in place, also on a rotated layer; hold **Alt** to scale from the centre. Corner handles keep the layer's proportions; hold **Shift** to change them. |
| Rotate a layer          | Drag the round handle above the layer. Hold **Shift** to turn in 15 degree steps.                                                                                                            |
| Scroll                  | The mouse wheel scrolls up and down. **Shift** and the wheel, or a touchpad's sideways scroll, scroll left and right.                                                                        |
| Zoom                    | **Ctrl** or **Alt** and the wheel zoom in and out around the mouse pointer, and pinching on a touchpad zooms too. **Ctrl+Plus** and **Ctrl+Minus** zoom around the middle of the view.       |
| Pan                     | Hold **Space** and drag with the left mouse button, or drag with the middle mouse button. Panning never moves or selects a layer.                                                            |
| Fit or show actual size | **Ctrl+0** fits the whole texture into view and **Ctrl+1** shows it at its actual size (1:1). **Fit** and **1:1** under the canvas do the same, and the zoom level shows beside them.        |

{% hint style="info" %}
Click the canvas first so it takes these keys. [Shortcuts](https://docs.gta.clothing/basics/useful-to-know/shortcuts.md#texture-studio-shortcuts) lists every Texture Studio key, such as **Ctrl+S** for **Save to cloth**.
{% endhint %}

On the **Placement** stage, **Size (pixels)** under **Scale (%)** shows the layer's width and height in texture pixels; type a size and the percent follows, or the other way round. Two buttons there, also on the layer's menu, place a picture, text, shape or patch layer in one step:

* **Fill the canvas** (**Ctrl+Shift+F**) makes the layer cover the whole texture, keeping its proportions and rotation, as far as the layer's size limit allows. When it cannot cover all of it, Texture Studio says so.
* **Reset size and position** (**Ctrl+Shift+R**) puts the layer back at its own size, unrotated, in the centre.

Each is one undo step. Like dragging on the canvas and **Place on ped**, they leave a locked layer where it is; the **Placement** fields still edit it.

### Layers

Use **Add layer**, or drop picture files onto the canvas or the layer list. A picture dropped on the canvas lands where you drop it, at any zoom, and one dropped beside the texture stays partly on it. Other new pictures start in the centre.

| Layer             | What it adds                                                                                                                                                                                                                |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Image**         | A picture, logo or decal from a PNG, JPEG, WebP, BMP or GIF file, or pasted from the clipboard with **Ctrl+V**. The picture is stored in your project, so the original file is not needed later.                            |
| **Text**          | Lettering in any font installed on your computer, with weight, italic, alignment, colour, outline, shadow, letter spacing and an optional arc around a badge.                                                               |
| **Patch**         | A generated patch or insignia, such as a shoulder patch, name tape, rocker or star badge. See [#patches-and-the-patch-library](#patches-and-the-patch-library "mention"). **Add patch from library** adds a ready-made one. |
| **Shape**         | A rectangle, rounded rectangle, ellipse, shield, chevron, stripes, star, cross or Star of Life.                                                                                                                             |
| **Fill**          | A plain colour over the texture.                                                                                                                                                                                            |
| **Paint**         | An empty layer to paint on with the brush, the eraser and the fills (**Add paint layer**). See [#paint](#paint "mention").                                                                                                  |
| **Adjustment**    | A colour change for the layers below it, including the texture itself: hue and saturation, levels, tint, brightness and contrast, or desaturate.                                                                            |
| **Wear and dirt** | Worn edges and dirt in folds, shaded and low areas, read from the shape of the cloth's model (**Add wear and dirt from shape**). See [#wear-and-dirt-from-shape](#wear-and-dirt-from-shape "mention").                      |

Every layer also has **Opacity**, a blend mode such as Normal, Multiply, Screen or Overlay, and an optional **Mask**: a shape, the transparency of another layer, a **UV island** (the island under the layer, or all islands) or a **Saved selection** (see [#selections](#selections "mention")). A UV island mask keeps a print inside the sleeve or pocket it sits on.

{% hint style="info" %}
Turn on **UV guide** to see which part of the texture covers which part of the cloth.
{% endhint %}

### Every variation or this variation

Each layer belongs to one of two groups, chosen under **New layers go to** and changed later under **Applies to**:

* **Every variation**: the layer appears on all texture variations of the drawable. Use it for logos, lettering and patches that must look the same on every colour.
* **This variation**: the layer changes only the colour of the selected variation.

For example, put a police badge and the name tape on **Every variation**, and a different fabric tint on each colour variation.

## Patches and the patch library

A patch layer is a piece of cloth that Texture Studio draws for you. Its lettering, colours, border, fabric and wear stay settings, so you can change them at any time.

### The patch library

Click **Patch library** in the toolbar under the canvas, or choose **Add layer > Add patch from library**, to pick a ready-made patch. Type in **Search patches** to filter, and click a tile to add it. The library is grouped:

| Group               | Patches                                                                                                                                                                                                                                                                |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Law enforcement** | **Star badge (gold)**, **Star badge (silver)**, **Sheriff star**, **Police shield**, **SWAT shield**, **PD round patch**, **SO round patch**                                                                                                                           |
| **Fire and EMS**    | **FD round patch**, **Medic cross (green)**, **Medic cross (white)**, **Star of Life (blue)**                                                                                                                                                                          |
| **Ranks**           | **Chevron (corporal)**, **Chevrons (sergeant)**, **Chevrons (lieutenant)**                                                                                                                                                                                             |
| **Biker and club**  | **Top rocker**, **Bottom rocker**, **Centre patch**, **1% diamond**, **MC side tab**, **Horseshoe arch**, **Lettering ring**, **Club back set**, the rank tabs (**PRESIDENT**, **SGT AT ARMS**, **ROAD CAPTAIN**, **PROSPECT**), **Memorial tab** and **Vertical tab** |
| **Tapes and tabs**  | **POLICE**, **SHERIFF**, **EMS**, **FIRE**, **SECURITY** and **K-9** tapes, and a blank **Name tape**                                                                                                                                                                  |
| **Materials**       | Examples of fabrics, borders and wear: **Weathered denim rocker**, **Canvas with sewing line**, **Frayed raw-edge denim**, **Worn canvas, double border** and **Scalloped emblem**                                                                                     |

A library patch is added as ordinary patch layers (the **Club back set** adds five: top rocker, centre patch, bottom rocker, 1% diamond and MC side tab), centred on the canvas at about a third of its size, in the group **New layers go to** names. Undo removes it in one step. Change the lettering and colours to make it your own. The star badges also get a metal finish when they go to **Every variation** and your license includes finishes. The library holds generic designs only, no real agency's seal or logo.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-f2ba7bef6572902098480726abd98b2b6e032b73%2Ftexture-studio-patch-library.png?alt=media" alt="The Patch library open over Texture Studio on a hoodie, with rocker typed in the search box: a club name and a chapter rocker under Biker and club and a denim rocker under Materials."><figcaption><p>The Patch library: search for a patch and click a tile to add it as a layer.</p></figcaption></figure>

### Patch settings

Select a patch layer to edit it on the **Layer** stage. Only the settings the chosen **Patch** kind uses are shown:

* **Patch**: the kind, such as **Shoulder patch**, **Name tape**, **Chest lettering**, **Back lettering**, **Rank insignia**, **Star badge**, **Flag stripes**, **Merrowed border**, **Arc text**, **Round patch**, **Rocker, arch or ring**, **Memorial tab**, **Medic cross** or **Star of Life**.
* **Shape**: the **Outline** (**Rounded**, **Shield**, **Circle**, **Rectangle**, **Diamond**, or **From a picture**, which cuts the patch to the opaque parts of a picture) and the parts of the kind, for example a **Bar under the lettering**, the chevrons, the points and ring of a star badge, or the **Curve (degrees)** of a rocker: up to about 90 makes a rocker, about 230 a horseshoe, 330 a ring with a gap and 360 a full ring. A rocker or round patch can carry a picture instead of lettering. A name tape can **Stack the letters (vertical tab)**, and a memorial tab takes one name per line with a date below each, up to four tabs.
* **Reshape outline**: scale, stretch, move or turn the cloth's outline, or give it a **Hand-cut wobble**. The lettering stays where it is.
* **Lettering**: the text, its colour, size, position and an outline around the letters.
* **Border and stitching**: the **Border style** (**Band**, **Raised satin**, **Double roll**, **Multi-band**, **Zigzag satin**, **Scalloped satin** or **Raw frayed edge**) with its width and colour, and a **Sewing line** (**Running stitch** or **Hand-sewn**) with its colour, stitch length, thread width and **Distance from edge**.
* **Fabric**: **Plain colour**, **Twill**, **Fine weave**, **Canvas**, **Denim** or **From a picture** (your own fabric picture), with its colour, a tint and the size of the weave. Denim follows the colour you pick, from mid blue to faded or black.
* **Wear and ageing**: **Ripped holes**, **Worn through**, **Torn edge** (with the **Torn thread colour** that shows beneath), **Dirt and stains**, **Sun fading**, **Frayed edge**, **Distressed holes** and **Scratches and scuffs**. **New wear pattern** picks another arrangement; the same pattern always gives the same result.

The **Finish** stage adds embroidery, a woven look, metal and the other finishes on top, see [#finishes](#finishes "mention"). With a finish, the wear also shapes the relief and the shine.

{% hint style="info" %}
A patch with fabric, a stitched border, a sewing line or wear can be at most 4096 by 4096 pixels. Texture Studio leaves a larger one out and says so; make it smaller, or use plain colour fabric, the **Band** border and no wear.
{% endhint %}

## Finishes

A layer on **Every variation** can have a finish. Besides its colour, the finish gives the layer relief and shine, which Texture Studio writes into the cloth's normal and specular maps when you save. That is how a patch catches the light on the ped in the 3D Preview and in game. All texture variations share those maps, so a layer on a single variation stays colour only and offers **Use on every variation** instead.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-25b26a9c0037a4db86faa74c9319ec8844ebc30f%2Ftexture-studio-finish.png?alt=media" alt="The Finish stage of a Shoulder patch layer in Texture Studio with Embroidery selected among None, Screen print, Vinyl, Woven patch, Merrowed border, Rubber, Metal badge, 3D puff, Chenille, Bullion, Enamel pin and Leather. Beside it, the 3D Preview shows the two UNIT shoulder patches close up on the chest of a black hoodie."><figcaption><p>The Finish stage of a shoulder patch set to Embroidery, beside the patches on the ped.</p></figcaption></figure>

Pick a finish in the **Finish** stage:

| Finish                         | The look                                                                                 |
| ------------------------------ | ---------------------------------------------------------------------------------------- |
| **Embroidery**                 | Raised rows of stitches that catch the light along the thread.                           |
| **3D puff**                    | Tall, rounded stitches over a foam core, like a 3D cap logo.                             |
| **Chenille**                   | Thick, fuzzy looped yarn with a matte surface, like a varsity letter.                    |
| **Bullion**                    | Coiled metal wire in rows on a cloth ground, like a hand-made blazer badge.              |
| **Woven patch**                | A low, tight weave like a woven label, with a matte surface.                             |
| **Merrowed border**            | A thick rolled stitch border around the shape, like the edge of a sewn-on patch.         |
| **Enamel pin**                 | Raised metal lines around smooth enamel colours, with an optional glossy dome.           |
| **Metal badge**                | A raised metal badge with a bevelled edge and bright highlights.                         |
| **Rubber**                     | A thick, soft raised print with rounded edges, like a PVC patch.                         |
| **Leather**                    | A leather patch with grain, a rounded edge and the dark parts of the artwork pressed in. |
| **Screen print** and **Vinyl** | Flat ink or a thin glossy film.                                                          |
| **None**                       | Colour only.                                                                             |

**Preset** (**Start from a preset**) replaces the layer's finish settings with a ready-made look, such as **Embroidery**, **Woven and outlined**, **Merrow patch**, **Laser-cut patch**, **Hard enamel pin**, **Soft enamel pin**, **PVC rubber**, **Leather patch**, **Woven label**, **Torn** or **Metal badge**. Undo brings the previous settings back.

The settings below the picker appear only for the finishes that use them:

* **Stitches**: **Stitch size** **Fine**, **Regular**, **Bold** or **Extra bold**, or an exact stitch spacing; **Stitch type** **Automatic**, **Satin** or **Fill** (**Automatic** picks the stitch type for each area); a stitch direction that follows each shape or a fixed **Stitch angle**; the satin width; **Underlay**, which lets the embroidery stand a little higher; **Pull**, how unevenly stitches end at the edges; and **Thread sheen**.
* **Thread colour**: use the artwork's own colours, or pick one thread colour from the palette, your **Recently used** colours or any custom colour. **Number of colours** reduces the artwork to that many thread colours, automatically or 2 to 16.
* **Thread colour settings** (embroidery finishes): **Add the artwork's thread colours** lists the artwork's thread colours, and each one can get its own density, stitch length, height, edge and smoothness, for example a denser, taller outline around flatter lettering. Colours without settings use the finish's own values; **Remove these settings** removes a colour's row.
* **Outline**: a **Running stitch**, **Bean stitch**, **Satin border** or **Merrowed edge** around the artwork, with its width and colour.
* **Fabric**: the **Weave** for woven patches, backings, bullion grounds and [fabric bases](#fabric-bases) (**Twill**, **Plain**, **Basket**, **Knit**, **Canvas**, **Leather grain**, **Heavy twill**, **Mesh**, **Damask label**, **Denim**, **Nylon ripstop**, **Cotton** or **Camouflage twill**) and its size. On a **Woven patch**, **Camouflage twill** adds **Patch colours**: three colours for its patches, drawn over the layer's own colour, and starting in woodland colours.
* **Metal**: the **Plating** (**Artwork colours**, **Gold**, **Silver**, **Black nickel**, **Copper** or **Antique brass**), and for an enamel pin **Hard** or **Soft** enamel and a glossy **Dome**.
* **Edge**: **Laser-cut edge**, **Fray**, **Holes** and **Wear** for torn and worn patches. **Random pattern** picks another arrangement; the same number gives the same result.
* **Backing and shadow**: a fabric **Backing** cut around the artwork, its colour, and a soft **Shadow** under the patch.
* **Relief and shine**: how strong the relief is and how much the finish shines.

{% hint style="info" %}
Pixel sizes are measured at the layer's full size, so scaling the layer scales its stitches and edges with it, as with a real patch.
{% endhint %}

If the drawable's model has no normal or specular map, a finish cannot add relief or shine; Texture Studio says so and still saves the layer's colour.

### Split colours

**Split colours** in a layer's own menu puts each thread colour of the layer on its own picture layer, named after its colour, so every colour can get its own finish. It asks how many colours to keep. The original layer stays in the list, hidden, and Undo puts everything back.

## Fabric bases

A **fabric base** gives the whole cloth a fabric in one step: its colour and weave, with relief and shine on the ped. Start a design with one, then put your prints and patches on top.

Click **Fabric base** in the toolbar under the canvas, or choose **Add layer > Add fabric base**, then click a fabric: **Knit**, **Twill**, **Canvas**, **Leather**, **Mesh**, **Denim**, **Nylon**, **Camouflage** or **Cotton**. Each tile shows a swatch of the fabric. **Add fabric base** is also in the command palette (**Ctrl+K**) while Texture Studio is open. Undo removes the fabric base in one step.

* It goes on **Every variation**, whatever **New layers go to** says, and under your other layers. A newer fabric base goes above the older ones, so it shows over them and still under every print and patch.
* It follows the model's UV islands and reaches a little into the gaps between them, so the edges of each piece of cloth show the fabric too. Without the model's UV layout it covers the whole texture.
* The layer list names it after its fabric, for example **Denim**.

A fabric base is an ordinary layer, so you can change it at any time:

* On the **Layer** stage, **Colour** recolours the fabric. It covers the cloth's own colours until you lower its **Opacity**.
* On the **Finish** stage, **Fabric** sets the **Weave** and its **Weave size (pixels)**. **Relief and shine** sets how strong the relief is, how much it shines, and with **Fabric show-through (%)** how much of the texture's own fine detail shows through.
* For **Camouflage**, **Patch colours** under **Fabric** sets the colours of the largest, middle and smallest patches. They start in woodland colours.

{% hint style="info" %}
Fabric bases are finishes, so they are part of **Durty Cloth Tool Ultimate**. Without it, the checkout opens first, and the fabric base is added once your license includes finishes. Like any finish, a fabric base writes relief and shine only where the model has normal and specular maps. Tattoo designs and overlays are not cloth and have no fabric bases.
{% endhint %}

A fabric base changes the texture. The **Fabric look** buttons in the 3D Preview's [Material simulation](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md#material-simulation) are something else: they only change how the preview shows the cloth and change no texture.

On a 4096 or 8192 texture, drawing a fabric base for the first time can take a few seconds.

## Wear and dirt from shape

A **wear and dirt** layer ages a cloth where real clothing wears: worn edges at hems, seams and corners, and dirt in folds and creases, where the cloth shades itself and on its lowest parts. Texture Studio finds these places in the shape of the cloth's model, so the wear follows the cloth across UV seams.

Choose **Add layer > Add wear and dirt from shape**; it is also in the command palette (**Ctrl+K**) while Texture Studio is open. Texture Studio reads the cloth's shape once, which can take a few seconds on a detailed model, and **Cancel** stops it without adding anything. The layer is then added on top, and Undo removes it in one step.

On the **Layer** stage, every change shows at once on the canvas and on the ped, without reading the model again:

* **Worn edges**: **Amount (%)**, **Width (cm)** and **Look** with its **Colour**. **Lighten the cloth** lightens the edges towards the colour and keeps the cloth's own hue; **Take the colour** gives them the colour.
* **Dirt**: **In folds and creases** with its **Spread (cm)**, **In shaded areas**, and **On low parts** with how high the **Low parts reach**, all in one **Colour**.
* **Breakup**: **Amount (%)** and **Patch size (cm)** break the wear and dirt into patches. **New wear pattern** picks another **Random pattern**.

Widths and sizes are centimetres on the cloth, so the wear keeps its size on every part of the texture. Like any layer, a wear and dirt layer has **Opacity**, a blend mode and a **Mask**: use the mask on the **Placement** stage to keep the wear to some parts of the cloth. It can go on **Every variation** or on **This variation**, and on the [material shelf](#the-material-shelf).

**Cloth shape** says where the layer's shape comes from:

* **Read from this cloth's model**: the wear follows this cloth.
* Read from another model, or from this one before it changed, for example for a layer from the material shelf or after you replaced the model. Choose **Read the shape again** so the wear follows this cloth.
* This cloth's model cannot be read here, for example because its file is missing. The layer keeps the shape it read last.

**Read the shape again** reads this cloth's model for the selected layer, as one undo step. Texture Studio never reads the model again by itself.

{% hint style="info" %}
Adding and tuning the layer is free, like all editing in Texture Studio. **Save to cloth**, **Save as new variation**, the exports other than **Export UV template** and saving to the material shelf need **Durty Cloth Tool Ultimate**.
{% endhint %}

{% hint style="warning" %}

* Wear and dirt change the colour only. They add no relief or shine.
* Only the cloth's main model is read, as it is modelled, not in an animation pose. Edges and folds come from the model itself, so a flat part with only a painted seam has no edge to wear.
* Tattoo designs and overlays have no model, so they have no wear and dirt layer. A material from the shelf inserted into a tattoo design or overlay leaves its wear and dirt layers out. A model with more than 400,000 triangles, or with no part on the texture, cannot be read, and Texture Studio says so.
  {% endhint %}

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-12053e4eadc5c46deee7f92aba4e7907657a3faa%2Ftexture-studio-wear.png?alt=media" alt="Texture Studio on a black hoodie with a Wear and dirt layer selected: the Layer stage shows Worn edges with Amount 60 %, Width 0.60 cm and Look Lighten the cloth, and Dirt with In folds and creases 50 %, Spread 1.50 cm, In shaded areas 50 % and On low parts 0 %. The canvas shows lighter edges along the hems, cuffs and pocket, and the 3D Preview beside it shows the worn hem, cuffs and pocket on the ped."><figcaption><p>A wear and dirt layer read from the hoodie's shape: worn edges along the hems, cuffs and pocket.</p></figcaption></figure>

## Paint

Paint by hand with a brush, an eraser and two fills, on the canvas or straight onto the cloth on the ped. What you paint goes on a **paint layer**, so it stays editable and the texture underneath never changes.

### Paint layers

Choose **Add layer > Add paint layer** for an empty one; it picks the brush unless a paint tool is already chosen. Or just start: with another layer selected, your first stroke or fill adds a paint layer and paints on it. Like any layer, a paint layer has **Opacity**, a blend mode and a **Mask**, and you can hide, lock, reorder or delete it. A paint layer cannot be placed on the ped, wrapped across seams, given a finish or split by colour.

### Tools and options

Choose a tool in the toolbar under the canvas, or press its key while Texture Studio has the keyboard focus:

| Tool                       | Key     | What it does                                                                                                   |
| -------------------------- | ------- | -------------------------------------------------------------------------------------------------------------- |
| **Select and move layers** | V       | Stops painting: a click on the canvas selects a layer and a drag moves it.                                     |
| **Brush**                  | B       | Paints the colour where you drag.                                                                              |
| **Eraser**                 | E       | Removes paint from the paint layer. The texture underneath stays as it is.                                     |
| **Fill UV island**         | G       | Fills the piece of cloth (UV island) under the click, a little past its edge so no line shows at the seam.     |
| **Fill by colour**         | Shift+G | Fills the connected area around the click whose colour is close to the colour clicked, as the canvas shows it. |
| **Eyedropper**             | I       | Takes the colour under the click as the paint colour. See [Pick a colour](#pick-a-colour).                     |

While a paint tool is chosen, its options appear above the canvas, with a line that says what the tool does:

* **Colour** for the brush and the fills. Hold **Alt** and click to pick it from the canvas or the ped, see [Pick a colour](#pick-a-colour).
* **Size (px)**: the brush diameter in texture pixels, from 1 to 2048. **\[** and **]** make the brush smaller and larger.
* **Hardness (%)**: how sharp the brush edge is, from 0 (fades out from the centre) to 100 (crisp).
* **Flow (%)**: how much each dab adds. A low flow builds the colour up while you keep painting over the same spot.
* **Opacity (%)**: the most one stroke covers, however often you pass over the same spot. Fills are laid at this opacity.
* **Tolerance (%)** for **Fill by colour**: how different a colour may be and still be filled. 0 fills only exactly the colour clicked.

The canvas shows the brush outline at the pointer, and **Esc** gives up the stroke you are drawing. When a stroke, a fill or a selection command does nothing, the reason shows in a line above the canvas, whichever tool is chosen, for example that the paint layer is locked or hidden.

### Pick a colour

Hold **Alt** while the brush or a fill is chosen and click the canvas to take the colour there as the paint colour, or choose the **Eyedropper** (**I**) and click. Nothing is painted and nothing is added to the undo history. With **Paint on the ped** on, a click with **Alt** or the Eyedropper on the cloth in the 3D Preview takes the texture's colour at that spot, not the light and shade the preview adds.

* **Use all layers** (shown while the Eyedropper is chosen, and also used for **Alt** clicks) takes the colour the canvas shows. Turn it off to take the colour of the selected layer alone, for example a paint layer under a picture.
* The colour is taken at full strength from a see-through pixel too; **Opacity** decides how strongly it is painted. A colour you pick paints back exactly the same.
* Where nothing is drawn, or the selected layer has no pixels, there is no colour to take, and the line above the canvas says so.
* Add **Shift** to the click to keep the colour in **Swatches** under the paint options. A click on a swatch paints with that colour again. The last 16 colours you kept stay with you in every project. If you use several keyboard layouts, Windows may switch the layout on **Alt+Shift**: choose the **Eyedropper** and **Shift**-click instead.

### Mirror while you paint

Three toggles next to the options paint every stroke a second time:

* **Mirror across the canvas**: mirrored left to right across the middle of the texture.
* **Mirror within the UV island**: mirrored across the middle of the UV island the stroke starts on, for a front or back panel laid out on its own.
* **Mirror to the other side of the ped**: at the matching place on the other side of the ped, wherever that place lies on the texture. It needs the cloth on the ped in the 3D Preview; when the preview does not show it, Texture Studio asks you to use **Show on ped** and paint again.

The fills use the mirrors too. **Fill UV island** and **Mirror within the UV island** need a UV layout Texture Studio can read from the model; without one they are greyed out.

### Paint on the ped

Turn on **Paint on the ped** to paint straight onto the cloth in the [3D Preview](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md) with the chosen tool, or with the brush when no paint tool is chosen. Texture Studio shows the cloth on the ped, and the animation pauses while you paint.

* A drag that starts on the cloth paints. A drag anywhere else, also on another item in front of the cloth, turns the camera as usual. The camera stands still during a stroke.
* With a fill chosen, a click on the cloth fills from the spot you clicked.
* The brush covers as many texture pixels on the cloth as it does on the canvas.
* A stroke carries on across UV seams onto the next piece of cloth. Surfaces facing away or hidden behind the front stay clean, such as the inside of a hood or a collar.
* **Esc** gives up the stroke you are painting. Between strokes, it ends painting on the ped, as clicking **Paint on the ped** again or choosing **Select and move layers** does.
* **Ctrl+Z**, **Ctrl+Y** and the tool keys (**V**, **B**, **E**, **G**, **Shift+G**, **I**, **\[** and **]**) also work while the 3D Preview has the keyboard, so **Ctrl+Z** undoes a stroke on the ped without a click back into Texture Studio. So do the keys you gave the mirror options, **Paint on the ped** or **Place on ped** in **Options > Keybindings**. Other keys, such as the 3D preview movement keys, stay with the preview.

{% hint style="info" %}
Paint on the ped needs your GTA V installation and works for clothing, not for props, tattoo designs or overlays. Only one tool uses the 3D Preview's pointer at a time: turning on **Paint on the ped** ends **Place on ped**, and the other way round. When another tool, such as the tattoo placement editor, takes over the preview, painting on the ped ends and Texture Studio says so.
{% endhint %}

### Selections

Select part of the canvas to keep your painting inside it. Choose a selection tool in the toolbar under the canvas, or press its key while Texture Studio has the keyboard focus:

| Tool                  | Key | What it does                                                                                                                                                                                                                            |
| --------------------- | --- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Marquee selection** | M   | Drag a **Rectangle** or an **Ellipse**. Press M again to switch between the two.                                                                                                                                                        |
| **Lasso selection**   | L   | **Freehand**: drag round the area, and the end joins the start. **Polygon**: click the corners, then double-click, press **Enter** or click the first corner to close it; **Esc** gives it up. Press L again to switch between the two. |
| **Magic wand**        | W   | Click a colour on the canvas to select the pixels close to it.                                                                                                                                                                          |

While a selection tool is chosen, the selection options appear above the canvas:

* **New selection**, **Add to selection**, **Subtract from selection** and **Intersect with selection** choose how a new shape combines with the selection. Hold **Shift** when you start a shape to add it, **Alt** to take it away, or both to keep only the overlap, just for that shape.
* For the magic wand, **Tolerance (%)** sets how different a colour may be and still be selected (0 selects only exactly that colour). **Only connected pixels** keeps to the area of that colour around the click; turn it off to select the colour anywhere on the canvas. **Use all layers** compares the picture the canvas shows; turn it off to compare only the selected layer's own pixels. With it on, while the canvas has not finished drawing the texture, the magic wand selects nothing and says so; wait until the texture shows and click again.

A moving dashed line shows the edge of the selection. With **New selection**, a click of the marquee or the lasso without dragging removes the selection. Choosing a selection tool ends **Paint on the ped**.

While there is a selection, the brush, the eraser and both fills stay inside it, on the canvas and on the ped, and the paint options say **Painting stays inside the selection.** A stroke that lies entirely outside it paints nothing, and Texture Studio says so.

| Command                          | Key             | What it does                                                                                                 |
| -------------------------------- | --------------- | ------------------------------------------------------------------------------------------------------------ |
| **Select all**                   | Ctrl+A          | Selects the whole canvas.                                                                                    |
| **Deselect**                     | Ctrl+Shift+A    | Removes the selection, so painting reaches the whole canvas again.                                           |
| **Invert selection**             | Ctrl+Shift+I    | Selects what is not selected and leaves out what is.                                                         |
| **Clear selected area**          | Backspace       | Erases the paint inside the selection on the selected paint layer.                                           |
| **Fill selection**               | Shift+Backspace | Fills the selection with the paint colour at the paint opacity, on the selected paint layer or on a new one. |
| **Save selection as layer mask** | Ctrl+Shift+M    | Keeps the selection as the mask of the selected layer, any kind of layer, so the layer shows only inside it. |

Each command is also a button in the selection options. While there is a selection and a visible, unlocked paint layer is selected, **Delete** clears the selected area too; otherwise it deletes the selected layer as before. **Select all**, **Deselect** and **Invert selection** also work while the 3D Preview has the keyboard during **Paint on the ped**.

A selection you keep as a mask is listed as **Saved selection** under the layer's **Mask** on the **Placement** stage; choosing it there also keeps the current selection, or asks you to make one first. To change it, make a new selection on the canvas and save it as the mask again. **Mirror to the other side** leaves such a mask off the copy, because it only covers the original's side, and Texture Studio says so.

* Every change of the selection is one undo step, and so is saving it as a mask. Undoing a stroke keeps the selection it was painted in. A selection is not saved with the document and does not count as an unsaved change; opening another document starts without one.
* Selections are free, like painting.
* You cannot soften the edge of a selection, grow, move or transform it, load a saved mask back as a selection, or select on the ped in the 3D Preview. A selection kept as a mask makes the document larger; when the document would become too large to save, or hold too many pictures, Texture Studio refuses it and nothing changes.

### Undo, license and limits

* Every stroke and every fill is one undo step. When it added a paint layer, the same undo removes that layer too.
* Painting is free, like all editing in Texture Studio. **Save to cloth**, **Save as new variation** and the exports other than **Export UV template** need **Durty Cloth Tool Ultimate**, as for any other layer.
* A stroke that would make the document too large to save is taken back, and Texture Studio says so. Delete paint layers you no longer need, or paint a smaller area.
* Paint layers can go on the [material shelf](#the-material-shelf) like any other layer.
* There is no pen pressure, and there are no brush textures or smudging. The 3D Preview shows the paint as you lay it, but no brush outline.

## See it on the ped

While you edit, Texture Studio shows the result on the ped in the [3D Preview](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md), finishes included. **Show on ped** selects the cloth and opens the preview with it. With Texture Studio docked next to the 3D Preview, or in a window of its own, you can still orbit and zoom the preview: click it and it keeps the keyboard until you click back into Texture Studio. So that skin poking through a tight cloth does not look like holes in your texture, the preview reduces body clipping under this cloth while Texture Studio shows it, as [Reduce body clipping in preview](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md#reduce-body-clipping-in-preview) does, without changing that option.

{% hint style="info" %}
The 3D Preview needs your GTA V installation; without it you can still edit on the canvas. See [App & Project Settings](https://docs.gta.clothing/basics/good-to-know/app-and-project-settings.md).
{% endhint %}

One editor can work on a map of a cloth at a time. If a [connected app](https://docs.gta.clothing/plugins/creator-link.md) or **Live texture editing** is already editing this cloth, Texture Studio tells you so; close that edit first.

### Place a layer on the ped

Instead of moving a layer on the canvas, you can put it right where you want it on the cloth:

1. Select a picture, text, shape or patch layer and open the **Placement** stage.
2. Under **On the ped**, click **Place on ped**. If the 3D Preview does not show the cloth yet, Texture Studio puts it on the ped. The animation pauses while you place.
3. Click the cloth in the 3D Preview. The centre of the layer moves to that spot. Click again to move it somewhere else; you can undo each click on its own, with **Ctrl+Z** and **Ctrl+Y** working while the 3D Preview has the keyboard too. Dragging still turns the camera.
4. Click **Place on ped** again or press **Esc** to stop. Switching to another stage, or to **Layers** when the tab is narrow, also stops placing.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fgit-blob-770b7dbac3030b722d26e9cd4da9ce65b614a0f5%2Ftexture-studio-place-on-ped-poster.webp?alt=media" alt="Place on ped puts a shoulder patch on the chest of a hoodie, Width (cm) 8 makes it smaller and Mirror to the other side adds the matching patch; then a patch from the Patch library and text with an Embroidery finish."><figcaption><p>Place on ped puts a shoulder patch on the chest of a hoodie, Width (cm) 8 makes it smaller and Mirror to the other side adds the matching patch; then a patch from the Patch library and text with an Embroidery finish.</p></figcaption></figure>

{% embed url="<https://gta.clothing/assets/media/v4/texture-studio-place-on-ped-mobile.mp4?v=93b6ea0ffa4f>" %}
Place on ped puts a shoulder patch on the upper chest of a hoodie, Width (cm) 8 makes it smaller and Mirror to the other side adds the matching patch. Then a patch from the Patch library and text with the Embroidery finish go onto another hoodie.
{% endembed %}

If a click does not land on the cloth you are editing, for example on another item in front of it or on a part of the cloth that does not use this texture, the layer stays where it was and Texture Studio tells you why.

Once a layer is placed on the ped:

* **Width (cm)** shows how wide the layer is on the cloth and sets a new width, for example 8 cm for a shoulder patch. The layer keeps its proportions on the cloth.
* **Mirror to the other side** adds a copy of the layer at the matching place on the other side of the ped, for example on the other shoulder. The copy is tilted the mirrored way, while text and logos stay readable. If the layer uses another layer's transparency as its mask, the copy comes without that mask, and Texture Studio tells you so.
* **Wrap across seams** projects the layer onto the cloth from the front, so a logo over a seam continues onto the next part of the texture instead of being cut off at the edge of its UV island. It works for pictures, text and patches without a finish. A wrapped layer stays wrapped when you click it onto another spot, set its **Width (cm)**, turn or resize it, change its text or mirror it to the other side, also after you reopen the document or undo. Moving it on the canvas or giving it a finish lays it flat again. It keeps working when the 3D Preview is closed, and also wraps a logo whose parts lie far apart on a large texture. You can give **Wrap across seams** a shortcut in **Options > Keybindings** and find it in the command palette (**Ctrl+K**) while Texture Studio is open.

Both work from the spot you clicked. A wrapped layer keeps that spot when you reopen the document or undo. After you move the layer on the canvas, click it onto the ped again to use them.

{% hint style="info" %}
The layer goes to the spot on the texture under your click. Where a print reaches past the edge of a UV island, that part can show up somewhere else on the cloth or not at all, unless you turn on **Wrap across seams**. Turn on **UV guide** to check, and use a **UV island** mask to keep the print inside its island. Placing by clicking the ped works for clothing, not for props.
{% endhint %}

## Save and export

* **Save to cloth** writes the result into the project: every variation the change concerns, and the normal and specular maps when finishes changed. The whole save is one entry in the cloth's **History**. Saving shows its progress, for example **Saving variation 3 of 26...**, then **Saving the relief and shine maps...**.
* **Save as new variation** adds the selected variation's result as a new texture variation. When the drawable has no free variation slot, a copy of the drawable holds it, as with **Recolour texture**. To undo it, remove the new variation. The exports sit in the **Export** menu beside **Save**, each with its shortcut and, where it needs a license, its badge.
* **Export PNG** writes the map the canvas shows (Diffuse, Normal or Specular) to a PNG file, without changing the project.
* **Export height map** writes the relief of the finishes as a 16-bit greyscale PNG for other tools. It asks whether to use the full range or keep the actual heights, so several maps compare. It appears once layers on **Every variation** carry a finish.
* **Export layered PSD** writes the selected variation as a PSD file with one layer per Texture Studio layer, with its name, opacity, blend mode and visibility, so you can go on in Photoshop, GIMP, Photopea or another image editor. The bottom layer, **Base texture**, holds the variation's own texture. Text, patches, shapes and finishes arrive as pixel layers. Adjustment and wear layers arrive as the picture they make of the layers below them, so changing those layers in the other editor does not change them. Relief and shine are not part of the file: **Export PNG** of the Normal or Specular view and **Export height map** write those.
* **Export UV template** writes the UV layout of the drawable at the size of the canvas, to paint over in another image editor. See [UV template](https://docs.gta.clothing/basics/good-to-know/thumbnails-and-exports.md#uv-template).

A layered export shows its progress and **Cancel** stops it. When the computer does not have enough free memory for it, or the layers together are too large for a PSD file, nothing is written and Texture Studio says why. A file that was already there stays as it was.

While a save such as **Save to cloth** or **Save as new variation** runs, **Cancel** under its progress stops it before anything is changed. Texture Studio then says **Saving was cancelled. Nothing was changed.**, and what was saved before stays as it was. **Cancel saving** can be given a key in **Options > Keybindings** (or press **Ctrl+K** and paste `@Change a shortcut`).

{% hint style="info" %}
Undoing a Texture Studio save from the **History** tab of one variation undoes the whole save for that drawable: every variation it changed, the normal and specular maps and the layers. See [Project History](https://docs.gta.clothing/basics/useful-to-know/project-history.md).
{% endhint %}

If something in the project changed while Texture Studio was open, for example the drawable was replaced, nothing is saved. Texture Studio says what changed and offers **Reload**, which reads the project files again and keeps your layers. If a layer cannot be drawn, for example because it is too large for its finish, nothing is saved and Texture Studio names the layer, so a saved texture does not silently lack a layer you see.

### Recover unsaved work

While you edit, Texture Studio keeps your unsaved layers as a draft on this PC, for clothing, tattoo designs and overlays alike. If Durty Cloth Tool closes before you save, for example after a crash (its error dialog then says that unsaved studio work was kept), open the same item in Texture Studio again. **Unsaved work found** asks what to do with it:

* **Recover** continues where you left off. The layers stay unsaved until you save them, and until then the item keeps what was saved.
* **Discard changes** deletes the draft and opens what was saved.
* **Cancel** keeps the draft and does not open Texture Studio.

The draft is updated a short while after you pause, so the last changes before Durty Cloth Tool closed can be missing. While Texture Studio edits a [Model Studio](https://docs.gta.clothing/basics/good-to-know/model-studio.md) draft, your texture changes are kept only once you apply them to that draft, as part of Model Studio's own draft. If a draft cannot be written, for example because the disk is full, the status line says so; your work is still in the editor, so save it.

A draft is offered only while the item's files are exactly as they were when it was made. If the item was saved, synced or edited elsewhere since, recovering it would undo that change, so Texture Studio explains this and offers **Discard draft** or **Keep draft**. Keep it if you are going to restore the earlier version, for example from **History**. A draft that is damaged or was made by another version of Durty Cloth Tool cannot be recovered either.

Drafts stay on this PC: project sync and project exports leave them out. A draft is removed when you save, or when you close Texture Studio and discard your changes. Drafts of items you removed from the project are deleted when the project opens.

## The material shelf

The **material shelf** keeps layers you made once, such as a logo with its lettering, a set of club patches or a fabric base, so you can insert them into any texture in any project.

### Save layers as material

1. Right-click a layer and choose **Save layers as material**, or click the **Save layers as material** button under the layer list. It is also in the command palette (press **Ctrl+K** and paste `>Save layers`).
2. Type a **Name** and check the **Layers** to keep. The selected layer starts checked, or every layer when none is selected.
3. Click **Save to shelf**.

The material keeps the checked layers with the pictures, finishes and paint they use, and your document does not change. What only fits the cloth the layers came from is left out: **Wrap across seams**, and a mask made from the transparency of a layer you did not check. Saving to the shelf is saving, so it needs **Durty Cloth Tool Ultimate**, like **Save to cloth**. The shelf holds up to 500 materials.

### Insert a material

Click **Insert material** in the toolbar under the canvas, or choose **Add layer > Insert material**; it is also in the command palette. The **Material shelf** lists your materials newest first, each with a preview, its name and the date you saved it. Select one and click **Insert**.

* The layers go on top of the group **New layers go to** names, at the same place and size relative to the texture as when you saved them. They move as one group, so lettering stays on its badge, also on a texture of another size or shape. Text, shapes and patches are drawn again at the new size so they stay sharp, and paint layers are drawn again at the right place on a texture of another size. Text in a font this PC does not have keeps the look it was saved with.
* Undo removes the whole material in one step.
* Inserting is free. A material's finishes go in only when your license includes finishes, and only on **Every variation**. Otherwise the layers go in without them, and the status line says why.
* A **UV island** mask still follows the cloth the material was saved from. On another cloth, choose the mask again on the **Placement** stage; the status line reminds you.
* If a material does not fit this texture, for example because one of its layers is larger than a texture of this size allows, nothing is inserted and Texture Studio says why.

### Rename and delete materials

Select a material, type a new **Name** under the list and click **Rename**. **Delete** removes a material after asking; this cannot be undone.

The shelf belongs to your Windows user on this PC and is the same in every project you open. A portable Durty Cloth Tool keeps a shelf of its own. A material this build cannot open, for example one made with another build of Durty Cloth Tool or a damaged file, stays in the list with the reason and **Delete**. One made with a newer version asks you to update Durty Cloth Tool.

## Your layers stay in the project

Texture Studio keeps one document of layers per drawable, stored in the project's data folder. Open Texture Studio again to continue where you left off.

* **Duplicate** gives the copy its own layers. Exporting a drawable as a DCT package includes them, and adding that package to another project brings them along.
* The textures hold the finished result. If the layer document is missing or cannot be read, building, exporting and History keep working; only re-editing the layers is lost, and Durty Cloth Tool tells you which item is affected.
* If you open a project on a computer without a font a text layer uses, Texture Studio tells you the font is missing. Install the font to edit that text; until then it keeps its last saved look.

### When the texture changed since your last save

If another tool changed a variation after your last Texture Studio save, for example **Replace**, **Recolour texture**, **Live texture editing**, a connected app or an optimizer, Texture Studio asks what to do when you open it:

* **Build on the current texture**, so your layers go on top of the new pixels; or
* **Keep the document's base**, the texture as it was at your last Texture Studio save. Your next save then replaces the other change.

If the model's normal or specular map was replaced, Texture Studio builds relief and shine on the new maps and tells you so.

### Project format

{% hint style="warning" %}
Projects and item packages saved by the current Durty Cloth Tool 4 build use a newer format, even when you did not use Texture Studio. Older Durty Cloth Tool builds cannot open them, so keep a copy before you share a project with someone on an older build. See [Durty Cloth Projects](https://docs.gta.clothing/basics/useful-to-know/durty-cloth-projects.md#project-format).
{% endhint %}

A layer document saved by a newer Durty Cloth Tool version cannot be opened by an older one. Texture Studio then offers **Start a new document**; your textures are not affected. Keep teammates on the same version when you share layers.

## Tattoo designs and overlays

Texture Studio edits the picture of a tattoo design and of a facial or body overlay (makeup, blusher, eyebrows, chest hair and the others) the same way as a cloth texture: add pictures, text, shapes, patches and paint on layers and keep them editable.

* Open it with a right-click on the item and **Edit and organize > Open in Texture Studio** (or press **Ctrl+K** and paste `>Open in Texture Studio`), or with **Texture Studio** on the item's row in the 3D Preview's **Outfit** tab while it is worn.
* The item has one picture, so there is no **Variation** to pick, no **Save as new variation**, no **On the ped** placement and no **Paint on the ped**. Where a tattoo sits is set in its own placement editor, see [Tattoos & Overlays](https://docs.gta.clothing/tattoos-makeup-and-overlays/addon-tattoos.md#place-a-tattoo-in-3d).
* **Save to image** writes the result into the item's picture. A picture stays a picture, and a texture dictionary stays a texture dictionary with its other maps kept. The save is one entry in **History**.
* While the item is worn, the 3D Preview shows your changes on the ped as you edit. A tattoo shows its design, so every tattoo that uses the same design changes too.
* For an overlay, **UV guide** shows where the head (facial overlays) or the upper body (body overlays) lies on the picture, once your GTA V files are loaded. A tattoo design has no UV guide.

{% hint style="info" %}
Some overlays are coloured by the game, and Texture Studio shows a hint that says how: for a palette-coloured overlay, such as hair or makeup, red and green choose the colour from the game's palette and transparency sets how much shows. For an overlay the game blends over the skin, transparency is ignored: light areas lighten the skin, dark areas darken it, and mid grey changes nothing. The 3D Preview shows the result in game colours.
{% endhint %}

The layers stay with the item in your project. Exporting a tattoo design or overlay as a DCT package carries its picture, but not its layers. Locked items and items that only exist for GTA V Enhanced cannot be edited; convert an Enhanced texture dictionary to Legacy first.

To edit the picture in your own image editor instead, see [Edit a tattoo or overlay picture](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md#edit-a-tattoo-or-overlay-picture).

## Limits

* **Hair** that takes its colour from the hair colour picked in game cannot be edited in Texture Studio, because its texture only holds the shading. Texture Studio tells you so.
* On clothing whose transparency has a special meaning in game, such as palette colours or cut-out edges, layers change the colour only. The transparency stays exactly as it was, so a layer can neither punch a hole nor fill one.
* [Placeholders (dummy items)](https://docs.gta.clothing/basics/good-to-know/placeholders-dummy-ids.md), locked items, [escrow-protected items](https://docs.gta.clothing/how-to-guides/use-asset-escrow-clothing.md) and items that only exist for GTA V Enhanced cannot be saved from Texture Studio.
* A document can hold a limited number of layers and pictures, and a finish works up to a maximum layer size. Texture Studio tells you when you reach a limit.

## Which tool should I use?

| You want to                                                                                    | Use                                                                                                                                                                                                   |
| ---------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Change the colour of a whole variation                                                         | **Recolour texture**, see [Recolour a texture variation](https://docs.gta.clothing/basics/essential-knowledge/user-interface.md#recolour-a-texture-variation)                                         |
| Add missing normal and specular maps to plain clothing                                         | [Normal & Specular Maps](https://docs.gta.clothing/basics/good-to-know/normal-and-specular-maps.md)                                                                                                   |
| Add logos, lettering, patches, embroidery or badges and keep them editable                     | **Texture Studio**                                                                                                                                                                                    |
| Give the whole cloth a fabric such as denim, knit or leather, with relief and shine            | A [fabric base](#fabric-bases) in **Texture Studio**                                                                                                                                                  |
| Make a cloth look worn and dirty where real clothing wears                                     | [Wear and dirt from shape](#wear-and-dirt-from-shape) in **Texture Studio**                                                                                                                           |
| Reuse a logo, a patch set or a fabric base in other projects                                   | The [material shelf](#the-material-shelf) in **Texture Studio**                                                                                                                                       |
| Paint colours, marks or touch-ups by hand, on the canvas or straight onto the cloth on the ped | [Painting](#paint) in **Texture Studio**                                                                                                                                                              |
| Paint freely in your own image editor with live 3D feedback                                    | [Creator Link plugins](https://docs.gta.clothing/plugins/creator-link.md) or **Live texture editing** in the [3D Preview](https://docs.gta.clothing/basics/essential-knowledge/3d-preview-clothes.md) |
| Make new clothing                                                                              | The [Blender](https://docs.gta.clothing/plugins/creator-link/blender.md) or [Marvelous Designer](https://docs.gta.clothing/plugins/creator-link/marvelous.md) plugin                                  |

## Editing alongside Model Studio

When Texture Studio opens for the cloth in [Model Studio](https://docs.gta.clothing/basics/good-to-know/model-studio.md), **Apply to Model Studio draft** adds your texture changes to the shared model draft. Use Model Studio's **Save to cloth** to save the combined result. Adding a new variation is unavailable in this mode. See [Edit textures in the same draft](https://docs.gta.clothing/basics/good-to-know/model-studio.md#edit-textures-in-the-same-draft).
