# XGen PTEX Tool

<div align="left"><figure><img src="/files/sOPbT6VrXmdu8RUjjgC6" alt=""><figcaption></figcaption></figure></div>

## Overview

The Xgen Ptex Tool allows you to assign any Ptex maps that’s assigned to your current description to Xgen primitives, guides or the growth mesh.

{% embed url="<https://youtu.be/q4IxC8XLH3o>" %}

***

## Viewing Maps

To view a Ptex map, pick a map from the “Ptex Map” drop down menu.

* The drop down menu will only display the '**default**' XGen structured maps. (ie, Region, Clumping1, Clumping2, and all map folders in the paintmaps folder)
* If you wish to preview a custom Ptex map, click on the **'Manually Select Map'**, and browse to it instead.​

<div align="left"><figure><img src="/files/LFNDUfRe3oXIXu4vqFwa" alt=""><figcaption></figcaption></figure></div>

Then click one of the three buttons (XGen Hair, XGen Guides, Growth Mesh). You can click on all three!

<div align="left"><figure><img src="/files/ZTB9auC4lRZ7qzZtMWUC" alt=""><figcaption></figcaption></figure></div>

**XGen Hair:** Ptex will be assigned to the current XGen description primitives. This creates an expression in the Primitive Color. Click on the “Reset Button” to go back to the default XGen Primitive color.

<div align="left"><figure><img src="/files/M4zxtLxKixPUhnT34qV2" alt=""><figcaption></figcaption></figure></div>

**XGen Guides:** Ptex will be assigned to the current XGen description Guides. This creates an expression in the Guide Color expression. Click on the “Reset Button” to go back to the default XGen Guide color.

<div align="left"><figure><img src="/files/hbr3hswYWUwDMmq2Ncby" alt=""><figcaption></figcaption></figure></div>

**Growth Mesh:** This will assign the chosen Ptex map to the current XGen description’s growth mesh. It will also hide the hair to allow ‘color picking’ for the “isolator” function. Click on the “Reset Button” to assign a default Lambert material on the growth mesh.

<figure><img src="/files/IOBDZXzqsQg9D3dVIREX" alt=""><figcaption></figcaption></figure>

You can also click on the “Reset All” button at the very bottom to reset everything.

<div align="left"><figure><img src="/files/4I6s6nHNds28XoGpdgAP" alt=""><figcaption></figcaption></figure></div>

***

## **Isolator**

Allows users to ‘isolate’ groups of hair based on the coloring of the Ptex map assigned.

{% hint style="info" %}
​The default number of colors you can pick from is set to 6.&#x20;

\***NOTE** sliding this will ‘**reset**’ the selected colors. It is advised to crank this up if you think you need more colors first\
\
**IMPORTANT NOTE:**\
Maya viewport is set to use ‘default lighting’ by default, which does not work when we are sourcing color for XGen's Ptex maps. In order for this to work correctly, please ensure that ‘**Light On**’ is clicked. Click on the ‘Light On’ button will ensure that the viewport is displaying in the correct color space that works with the isolator.\
\
When you are done viewing or isolating hairs, simply press 5 or 6 on your keyboard to go back to shaded mode.
{% endhint %}

<div align="left"><figure><img src="/files/srhFAMR0GuLBD2Xxt3sO" alt=""><figcaption></figcaption></figure></div>

Next, simply click on any of the color swatches, and select color pick.

<div align="left"><figure><img src="/files/AZK1l6HvqKReDUKf1mck" alt=""><figcaption></figcaption></figure></div>

You can add more colors to the isolator

<div align="left"><figure><img src="/files/RiriXS5GYRrnocaTaB79" alt=""><figcaption></figcaption></figure></div>

You can also assign the same Ptex map to the primitives, to see the coloring.

<div align="left"><figure><img src="/files/EiJfA7sih2nr3uJnq9zI" alt=""><figcaption></figcaption></figure></div>

You can also toggle between the full hair and isolated hair.

<div align="left"><figure><img src="/files/WwBPNaIMluym52VedRF7" alt=""><figcaption></figcaption></figure></div>

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://nobraintools.gitbook.io/maya-groomers-tool/xgen-tools/xgen-ptex-tool.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
