> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alpacaml.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Using References to Guide Composition

> Guide your image composition with References

<img src="https://mintcdn.com/alpacaml/NXSO2NCVHCdG0mVD/images/classic/depth-reference_2.webp?fit=max&auto=format&n=NXSO2NCVHCdG0mVD&q=85&s=8051d40ed8dd73fa3243a66cebfd26e5" alt="Reference Example" width="1024" height="627" data-path="images/classic/depth-reference_2.webp" />

The <b>References</b> feature lets you guide the composition of new images, by leveraging existing images as a
compositional template. You can use references with the <b>Imagine</b> tool to create brand new images with your desired composition,
or with the <b>Transfer</b> tool to maintain your composition at higher transfer strengths.

## Getting Started

***

1. <b>Select Your Reference Image:</b> Begin by choosing an image that contains the
   compositional elements you want to use in your new generation. Add this image
   to your document in Adobe Photoshop.

2. <b>Enable References:</b> Navigate to either the Imagine or the Transfer tool
   within Alpaca. Look for the 'Reference' toggle and enable it.

   <img width="300" src="https://mintcdn.com/alpacaml/NXSO2NCVHCdG0mVD/images/classic/ref1.webp?fit=max&auto=format&n=NXSO2NCVHCdG0mVD&q=85&s=f405c811998da402541ac3099f2f8ad3" data-path="images/classic/ref1.webp" />

3. <b>Choose Your Reference Type:</b> Based on the compositional elements you want
   to use from your reference image, select the appropriate reference type. Your
   options are 'Depth', 'Pose', 'Hard Edges', and 'Soft Edges'. See below for more
   details on the different types.

   <img width="300" src="https://mintcdn.com/alpacaml/NXSO2NCVHCdG0mVD/images/classic/ref2.webp?fit=max&auto=format&n=NXSO2NCVHCdG0mVD&q=85&s=3bd2033361944aa7d2ea5419f42e7ec2" data-path="images/classic/ref2.webp" />

4. <b>Include the Reference in Your Selection:</b> Ensure that your reference image
   is included in your active selection. The plugin uses this selection to understand
   which content to use as the reference. You may also choose a specific layer to
   take the reference content from, see the Advanced Settings section below for more
   details.

5. <b>Enter Your Prompt and Generate:</b> Once your reference is set, input your
   desired text prompt as normal and click the 'Generate' button to start the image
   generation process.

## Reference Types

***

### Depth

The <b>Depth</b> reference type is a good choice for when your reference image displays a sense of space and depth, like a serene landscape stretching out to distant mountains, a quiet
street vanishing into a horizon, or a bustling room filled with objects near and far. Use this reference type when you want your new image to match the depth in your reference image,
reflecting the sense of three-dimensionality and perspective.

```txt Foggy Dark Fantasy City theme={null}
temple city, city of fogs, middle ages, fantasy rpg style, dark fantasy, 8k illustrations
```

<img src="https://mintcdn.com/alpacaml/NXSO2NCVHCdG0mVD/images/classic/depth-reference.webp?fit=max&auto=format&n=NXSO2NCVHCdG0mVD&q=85&s=465b08f702fe42ca2351049e834d507c" alt="Depth Reference Example" width="1430" height="960" data-path="images/classic/depth-reference.webp" />

Reference image by [Nati Melnychuk](https://unsplash.com/@natinati?utm_source=unsplash\&utm_medium=referral\&utm_content=creditCopyText)

### Pose

The <b>Pose</b> type is for when your reference image includes characters or figures. It focuses on their positioning, serving as a guide for the creation of character-based imagery in your own work.
If you're aiming to generate images of a character in a specific stance or action, this is the ideal reference to use.

```txt Sketch of a Woman in Tokyo theme={null}
a sketch illustration of young woman, in Tokyo city, with a oversized hoodie, long hair, full body, character design, light pencil and soft ink, colors neon, brushstrokes, illustrations concept art book-style
```

<img src="https://mintcdn.com/alpacaml/NXSO2NCVHCdG0mVD/images/classic/pose-reference.webp?fit=max&auto=format&n=NXSO2NCVHCdG0mVD&q=85&s=cf1c9694ccac2476d62ef5ce1ccc990f" alt="Pose Reference Example" width="1430" height="960" data-path="images/classic/pose-reference.webp" />

Reference image by [Ravi Sharma](https://unsplash.com/@ravinepz?utm_source=unsplash\&utm_medium=referral\&utm_content=creditCopyText)

### Hard Edges

The <b>Hard Edges</b> reference type is your go-to for extracting strong, clear lines and distinct shapes from your reference image. This type is perfect for images featuring bold, detailed structures,
such as city skylines or intricate geometric designs. Use this reference when you want your generated image to reflect the detailed composition of your reference.

```txt Sunset Anime High Rise theme={null}
an illustration of a high rise building, 90s anime, manga, sunset colors, golden lighting, calm, serene
```

<img src="https://mintcdn.com/alpacaml/NXSO2NCVHCdG0mVD/images/classic/hard-edges-reference.webp?fit=max&auto=format&n=NXSO2NCVHCdG0mVD&q=85&s=d592a6b48834b6ec2690e56ae2054aee" alt="Hero Edges Reference Example" width="1430" height="960" data-path="images/classic/hard-edges-reference.webp" />

Reference image by [Joel Filipe](https://unsplash.com/@joelfilip?utm_source=unsplash\&utm_medium=referral\&utm_content=creditCopyText)

### Soft Edges

The <b>Soft Edges</b> reference type is for when your inspiration comes from an image with a more fluid, gentle composition. It's excellent for instances where the elements in your reference image
gracefully meld into one another, like an image capturing the motion of fabric in the wind, the delicate play of hair, the lively nature of a puppy, or the diffuse boundaries in a watercolor painting.
Use this reference when you wish your new creation to embody the broad strokes of your reference's composition, without being confined by rigid lines or precise forms.

```txt Space Meerkat theme={null}
meerkat looking off into the distance, nighttime, stars in the sky behind him, photorealistic, bokeh
```

<img src="https://mintcdn.com/alpacaml/NXSO2NCVHCdG0mVD/images/classic/soft-edges-reference.webp?fit=max&auto=format&n=NXSO2NCVHCdG0mVD&q=85&s=b912931ca6f15a09e7f20e0ec3461539" alt="Soft Edges Reference Example" width="1430" height="960" data-path="images/classic/soft-edges-reference.webp" />

Reference image by [Janis Ringli](https://unsplash.com/@janisringli?utm_source=unsplash\&utm_medium=referral\&utm_content=creditCopyText)

## Advanced Settings

***

{" "}

<img width="300" src="https://mintcdn.com/alpacaml/NXSO2NCVHCdG0mVD/images/classic/ref3.webp?fit=max&auto=format&n=NXSO2NCVHCdG0mVD&q=85&s=c086cdcad81f133bf283444fb1e58fb3" data-path="images/classic/ref3.webp" />

### Reference Strength

This settings controls the influence your reference image has on the final artwork. A lower value (down to 0.1) means your reference will have less impact, while a higher value (up to 2.0)
gives your reference image significant influence on the composition. The default setting is balanced at 1.0.

### Extract Reference

This advanced setting lets experienced users provide their own prepared reference type, skipping the extraction process from the chosen reference image. For instance, you could input a depth map
generated by a separate 3D modeling tool and use it as a reference. By default, this setting is set to 'Yes', extracting the reference type from the given image. Selecting 'No' bypasses this extraction,
using the provided image content directly instead.

### Reference Layer

This setting determines the source of your reference content within Adobe Photoshop. When set to 'Active', the reference is derived from the currently selected content within the active layer. If set to
'Visible', it uses all visible content within the selected area, spanning across layers.
