# Custom brush

<figure><img src="/files/RjWukuFg83X5rTySZP4i" alt="" width="232"><figcaption></figcaption></figure>

Unlock your imagination and capability with the custom brush system. If the basic round and square brush cannot do the job, we can use the custom shapes with the custom brush stroke type.

### Create custom brush

<figure><img src="/files/KNvBPYR0o11YlnuaX05R" alt="" width="246"><figcaption></figcaption></figure>

To create a custom brush, we first need to make a [selection](/tools/selection.md#what-is-selection), then tap the + button in the custom brush panel to add a custom brush to the current collection.

{% hint style="info" %}
The alpha values of the selection will be used to determine the shape of the brush.
{% endhint %}

### How to use

#### Regular brush

When used with the [regular brush](/tools/brush.md#regular-brush), we have 2 types of alignments: &#x20;

* Aligned: each instance of the custom brush will be placed next to each other in a grid
* Continuous: Same as the regular square and round brush, but with the custom shape.

#### Spray and spray with opacity

Spray the custom shapes instead of the basic round and square shapes.

### Brush collection

<figure><img src="/files/NrYc1u9Uu8KLRHTyFZKp" alt="" width="228"><figcaption></figcaption></figure>

Custom brushes are saved into collections. The "default" collection is added automatically. To create a new collection, select "Create". When adding a new custom brush from the selection, it will be saved to the current selected collection.

### Import/export

Pixquare's custom brushes are saved as ".pxbr" files. We can share these files with other users.

We can find these files in collection folders in Files apps at "On my iPad (or iPhone) > Pixquare > custom\_brushes"

To import brushes, we simply copy the collections to this location.&#x20;

{% hint style="info" %}
.pxbr files at the top-level folder "custom\_brushes" folder without being in a collection will not be shown in Pixquare.
{% endhint %}


---

# 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://docs.pixquare.art/tools/brush/custom-brush.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.