# Create

> Create a new Sprite object.

## Definition

* **Type:** Method
* **Namespace:** [UnityEngine](/engine/6000.0/script-reference/unityengine.md)
* **Assembly:** UnityEngine.CoreModule

## Create(Texture2D, Rect, Vector2, float, uint, SpriteMeshType, Vector4, bool)

Create a new Sprite object.

```csharp
public static Sprite Create(Texture2D texture, Rect rect, Vector2 pivot, float pixelsPerUnit, uint extrude, SpriteMeshType meshType, Vector4 border, bool generateFallbackPhysicsShape)
```

### Parameters

**** (\[Texture2D]\(/engine/6000.0/script-reference/unityengine/texture2d)): The Texture to obtain the Sprite graphic from.**** (\[Rect]\(/engine/6000.0/script-reference/unityengine/rect)): The rectangular section of the Texture to use for the Sprite.**** (\[Vector2]\(/engine/6000.0/script-reference/unityengine/vector2)): The Sprite's pivot point relative to its graphic rectangle.**** (\[float]\(https\://learn.microsoft.com/dotnet/api/system.single)): The number of pixels in the Sprite that correspond to one unit in world space.**** (\[uint]\(https\://learn.microsoft.com/dotnet/api/system.uint32)): The amount by which the Sprite mesh should be expanded outwards.**** (\[SpriteMeshType]\(/engine/6000.0/script-reference/unityengine/spritemeshtype)): The type of mesh that is generated for the Sprite.**** (\[Vector4]\(/engine/6000.0/script-reference/unityengine/vector4)): The border sizes of the Sprite (X=left, Y=bottom, Z=right, W=top).**** (\[bool]\(https\://learn.microsoft.com/dotnet/api/system.boolean)): Whether to generate a default physics shape for the Sprite.

### Returns

| Type                                                            | Description |
| --------------------------------------------------------------- | ----------- |
| [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) |             |

### Remarks

[Sprite.Create](/engine/6000.0/script-reference/unityengine/sprite/create.md) creates a new [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) which can be used in game applications. A Texture needs to be loaded and assigned to [Sprite.Create](/engine/6000.0/script-reference/unityengine/sprite/create.md) in order to control how the new [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) will look. In the script example below a new Sprite is displayed when the button is pressed.  The new Sprite is created in Start.

The second argument rect defines the sub-texture used. The rect argument is defined in pixels of the Texture.  A Rect(50.0f, 10.0f, 200.0f, 140.0f) would create a left to right range from 50.0f to 50.0f + 200.0f = 250.0f.  The bottom to top range would be 10.0f to 10.0f + 140.0f = 150.0f. The third argument pivot determines what becomes the center of the [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md).  This is a Vector2 relative to the rect where Vector2(0.0f, 0.0f) is the bottom left and Vector2(1.0f, 1.0f) is the top right.  The [Sprite.pixelsPerUnit](/engine/6000.0/script-reference/unityengine/sprite/pixelsperunit.md) value controls the size of the Sprite.  Reducing this below 100 pixels per world increases the size of the Sprite.  The extrude value defines the number of pixels which surround the Sprite. This is useful if the [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) is included in an atlas. meshType selects whether FullRect or Tight is used. Finally border determines the slicing of the Sprite and is usually used to define Sprite tiling behaviour. The values are in pixel units.

Additional Resources: [SpriteRenderer](/engine/6000.0/script-reference/unityengine/spriterenderer.md) class.

```csharp
// Create a Sprite at startup.
// Assign a Texture to the Sprite when the button is pressed.

using UnityEngine;

public class SpriteCreate : MonoBehaviour
{
    public Texture2D tex;
    private Sprite mySprite;
    private SpriteRenderer sr;

    void Awake()
    {
        sr = gameObject.AddComponent<SpriteRenderer>() as SpriteRenderer;
        sr.color = new Color(0.9f, 0.9f, 0.9f, 1.0f);

        transform.position = new Vector3(1.5f, 1.5f, 0.0f);
    }

    void Start()
    {
        mySprite = Sprite.Create(tex, new Rect(0.0f, 0.0f, tex.width, tex.height), new Vector2(0.5f, 0.5f), 100.0f);
    }

    void OnGUI()
    {
        if (GUI.Button(new Rect(10, 10, 100, 30), "Add sprite"))
        {
            sr.sprite = mySprite;
        }
    }
}
```

The following code example shows how to create a Sprite at startup with Secondary Texture properties.

```csharp
using UnityEngine;

// Create a Sprite at startup with Secondary Textures properties

public class ExampleClass : MonoBehaviour
{
    void Start()
    {
        var texture = new Texture2D(64, 64);
        var secondaryTexture1 = new Texture2D(64, 64);
        var secondaryTexture2 = new Texture2D(64, 64);
        var secondaryTexture3 = new Texture2D(64, 64);
        var secondarySpriteTexture = new[]
        {
            new SecondarySpriteTexture()
            {
                name = "_SecondaryTexture1",
                texture = secondaryTexture1
            },
            new SecondarySpriteTexture()
            {
                name = "_SecondaryTexture2",
                texture = secondaryTexture2
            },
            new SecondarySpriteTexture()
            {
                name = "_SecondaryTexture3",
                texture = secondaryTexture3
            }
        };

        var sprite = Sprite.Create(texture, new Rect(0, 0, texture.width, texture.height), Vector2.zero, 100, 0, SpriteMeshType.FullRect, Vector4.zero, false, secondarySpriteTexture);
        int spriteSecondaryTextureCount = sprite.GetSecondaryTextureCount();
    }
}
```

## Create(Texture2D, Rect, Vector2, float, uint, SpriteMeshType, Vector4, bool, SecondarySpriteTexture\[])

Create a new Sprite object.

```csharp
public static Sprite Create(Texture2D texture, Rect rect, Vector2 pivot, float pixelsPerUnit, uint extrude, SpriteMeshType meshType, Vector4 border, bool generateFallbackPhysicsShape, SecondarySpriteTexture[] secondaryTextures)
```

### Parameters

**** (\[Texture2D]\(/engine/6000.0/script-reference/unityengine/texture2d)): The Texture to obtain the Sprite graphic from.**** (\[Rect]\(/engine/6000.0/script-reference/unityengine/rect)): The rectangular section of the Texture to use for the Sprite.**** (\[Vector2]\(/engine/6000.0/script-reference/unityengine/vector2)): The Sprite's pivot point relative to its graphic rectangle.**** (\[float]\(https\://learn.microsoft.com/dotnet/api/system.single)): The number of pixels in the Sprite that correspond to one unit in world space.**** (\[uint]\(https\://learn.microsoft.com/dotnet/api/system.uint32)): The amount by which the Sprite mesh should be expanded outwards.**** (\[SpriteMeshType]\(/engine/6000.0/script-reference/unityengine/spritemeshtype)): The type of mesh that is generated for the Sprite.**** (\[Vector4]\(/engine/6000.0/script-reference/unityengine/vector4)): The border sizes of the Sprite (X=left, Y=bottom, Z=right, W=top).**** (\[bool]\(https\://learn.microsoft.com/dotnet/api/system.boolean)): Whether to generate a default physics shape for the Sprite.**** (\[SecondarySpriteTexture\[]]\(/engine/6000.0/script-reference/unityengine/secondaryspritetexture)): The Secondary Texture properties to be used by the created Sprite.

### Returns

| Type                                                            | Description |
| --------------------------------------------------------------- | ----------- |
| [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) |             |

### Remarks

[Sprite.Create](/engine/6000.0/script-reference/unityengine/sprite/create.md) creates a new [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) which can be used in game applications. A Texture needs to be loaded and assigned to [Sprite.Create](/engine/6000.0/script-reference/unityengine/sprite/create.md) in order to control how the new [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) will look. In the script example below a new Sprite is displayed when the button is pressed.  The new Sprite is created in Start.

The second argument rect defines the sub-texture used. The rect argument is defined in pixels of the Texture.  A Rect(50.0f, 10.0f, 200.0f, 140.0f) would create a left to right range from 50.0f to 50.0f + 200.0f = 250.0f.  The bottom to top range would be 10.0f to 10.0f + 140.0f = 150.0f. The third argument pivot determines what becomes the center of the [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md).  This is a Vector2 relative to the rect where Vector2(0.0f, 0.0f) is the bottom left and Vector2(1.0f, 1.0f) is the top right.  The [Sprite.pixelsPerUnit](/engine/6000.0/script-reference/unityengine/sprite/pixelsperunit.md) value controls the size of the Sprite.  Reducing this below 100 pixels per world increases the size of the Sprite.  The extrude value defines the number of pixels which surround the Sprite. This is useful if the [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) is included in an atlas. meshType selects whether FullRect or Tight is used. Finally border determines the slicing of the Sprite and is usually used to define Sprite tiling behaviour. The values are in pixel units.

Additional Resources: [SpriteRenderer](/engine/6000.0/script-reference/unityengine/spriterenderer.md) class.

```csharp
// Create a Sprite at startup.
// Assign a Texture to the Sprite when the button is pressed.

using UnityEngine;

public class SpriteCreate : MonoBehaviour
{
    public Texture2D tex;
    private Sprite mySprite;
    private SpriteRenderer sr;

    void Awake()
    {
        sr = gameObject.AddComponent<SpriteRenderer>() as SpriteRenderer;
        sr.color = new Color(0.9f, 0.9f, 0.9f, 1.0f);

        transform.position = new Vector3(1.5f, 1.5f, 0.0f);
    }

    void Start()
    {
        mySprite = Sprite.Create(tex, new Rect(0.0f, 0.0f, tex.width, tex.height), new Vector2(0.5f, 0.5f), 100.0f);
    }

    void OnGUI()
    {
        if (GUI.Button(new Rect(10, 10, 100, 30), "Add sprite"))
        {
            sr.sprite = mySprite;
        }
    }
}
```

The following code example shows how to create a Sprite at startup with Secondary Texture properties.

```csharp
using UnityEngine;

// Create a Sprite at startup with Secondary Textures properties

public class ExampleClass : MonoBehaviour
{
    void Start()
    {
        var texture = new Texture2D(64, 64);
        var secondaryTexture1 = new Texture2D(64, 64);
        var secondaryTexture2 = new Texture2D(64, 64);
        var secondaryTexture3 = new Texture2D(64, 64);
        var secondarySpriteTexture = new[]
        {
            new SecondarySpriteTexture()
            {
                name = "_SecondaryTexture1",
                texture = secondaryTexture1
            },
            new SecondarySpriteTexture()
            {
                name = "_SecondaryTexture2",
                texture = secondaryTexture2
            },
            new SecondarySpriteTexture()
            {
                name = "_SecondaryTexture3",
                texture = secondaryTexture3
            }
        };

        var sprite = Sprite.Create(texture, new Rect(0, 0, texture.width, texture.height), Vector2.zero, 100, 0, SpriteMeshType.FullRect, Vector4.zero, false, secondarySpriteTexture);
        int spriteSecondaryTextureCount = sprite.GetSecondaryTextureCount();
    }
}
```

## Create(Texture2D, Rect, Vector2, float, uint, SpriteMeshType, Vector4)

Create a new Sprite object.

```csharp
public static Sprite Create(Texture2D texture, Rect rect, Vector2 pivot, float pixelsPerUnit, uint extrude, SpriteMeshType meshType, Vector4 border)
```

### Parameters

**** (\[Texture2D]\(/engine/6000.0/script-reference/unityengine/texture2d)): The Texture to obtain the Sprite graphic from.**** (\[Rect]\(/engine/6000.0/script-reference/unityengine/rect)): The rectangular section of the Texture to use for the Sprite.**** (\[Vector2]\(/engine/6000.0/script-reference/unityengine/vector2)): The Sprite's pivot point relative to its graphic rectangle.**** (\[float]\(https\://learn.microsoft.com/dotnet/api/system.single)): The number of pixels in the Sprite that correspond to one unit in world space.**** (\[uint]\(https\://learn.microsoft.com/dotnet/api/system.uint32)): The amount by which the Sprite mesh should be expanded outwards.**** (\[SpriteMeshType]\(/engine/6000.0/script-reference/unityengine/spritemeshtype)): The type of mesh that is generated for the Sprite.**** (\[Vector4]\(/engine/6000.0/script-reference/unityengine/vector4)): The border sizes of the Sprite (X=left, Y=bottom, Z=right, W=top).

### Returns

| Type                                                            | Description |
| --------------------------------------------------------------- | ----------- |
| [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) |             |

### Remarks

[Sprite.Create](/engine/6000.0/script-reference/unityengine/sprite/create.md) creates a new [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) which can be used in game applications. A Texture needs to be loaded and assigned to [Sprite.Create](/engine/6000.0/script-reference/unityengine/sprite/create.md) in order to control how the new [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) will look. In the script example below a new Sprite is displayed when the button is pressed.  The new Sprite is created in Start.

The second argument rect defines the sub-texture used. The rect argument is defined in pixels of the Texture.  A Rect(50.0f, 10.0f, 200.0f, 140.0f) would create a left to right range from 50.0f to 50.0f + 200.0f = 250.0f.  The bottom to top range would be 10.0f to 10.0f + 140.0f = 150.0f. The third argument pivot determines what becomes the center of the [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md).  This is a Vector2 relative to the rect where Vector2(0.0f, 0.0f) is the bottom left and Vector2(1.0f, 1.0f) is the top right.  The [Sprite.pixelsPerUnit](/engine/6000.0/script-reference/unityengine/sprite/pixelsperunit.md) value controls the size of the Sprite.  Reducing this below 100 pixels per world increases the size of the Sprite.  The extrude value defines the number of pixels which surround the Sprite. This is useful if the [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) is included in an atlas. meshType selects whether FullRect or Tight is used. Finally border determines the slicing of the Sprite and is usually used to define Sprite tiling behaviour. The values are in pixel units.

Additional Resources: [SpriteRenderer](/engine/6000.0/script-reference/unityengine/spriterenderer.md) class.

```csharp
// Create a Sprite at startup.
// Assign a Texture to the Sprite when the button is pressed.

using UnityEngine;

public class SpriteCreate : MonoBehaviour
{
    public Texture2D tex;
    private Sprite mySprite;
    private SpriteRenderer sr;

    void Awake()
    {
        sr = gameObject.AddComponent<SpriteRenderer>() as SpriteRenderer;
        sr.color = new Color(0.9f, 0.9f, 0.9f, 1.0f);

        transform.position = new Vector3(1.5f, 1.5f, 0.0f);
    }

    void Start()
    {
        mySprite = Sprite.Create(tex, new Rect(0.0f, 0.0f, tex.width, tex.height), new Vector2(0.5f, 0.5f), 100.0f);
    }

    void OnGUI()
    {
        if (GUI.Button(new Rect(10, 10, 100, 30), "Add sprite"))
        {
            sr.sprite = mySprite;
        }
    }
}
```

The following code example shows how to create a Sprite at startup with Secondary Texture properties.

```csharp
using UnityEngine;

// Create a Sprite at startup with Secondary Textures properties

public class ExampleClass : MonoBehaviour
{
    void Start()
    {
        var texture = new Texture2D(64, 64);
        var secondaryTexture1 = new Texture2D(64, 64);
        var secondaryTexture2 = new Texture2D(64, 64);
        var secondaryTexture3 = new Texture2D(64, 64);
        var secondarySpriteTexture = new[]
        {
            new SecondarySpriteTexture()
            {
                name = "_SecondaryTexture1",
                texture = secondaryTexture1
            },
            new SecondarySpriteTexture()
            {
                name = "_SecondaryTexture2",
                texture = secondaryTexture2
            },
            new SecondarySpriteTexture()
            {
                name = "_SecondaryTexture3",
                texture = secondaryTexture3
            }
        };

        var sprite = Sprite.Create(texture, new Rect(0, 0, texture.width, texture.height), Vector2.zero, 100, 0, SpriteMeshType.FullRect, Vector4.zero, false, secondarySpriteTexture);
        int spriteSecondaryTextureCount = sprite.GetSecondaryTextureCount();
    }
}
```

## Create(Texture2D, Rect, Vector2, float, uint, SpriteMeshType)

Create a new Sprite object.

```csharp
public static Sprite Create(Texture2D texture, Rect rect, Vector2 pivot, float pixelsPerUnit, uint extrude, SpriteMeshType meshType)
```

### Parameters

**** (\[Texture2D]\(/engine/6000.0/script-reference/unityengine/texture2d)): The Texture to obtain the Sprite graphic from.**** (\[Rect]\(/engine/6000.0/script-reference/unityengine/rect)): The rectangular section of the Texture to use for the Sprite.**** (\[Vector2]\(/engine/6000.0/script-reference/unityengine/vector2)): The Sprite's pivot point relative to its graphic rectangle.**** (\[float]\(https\://learn.microsoft.com/dotnet/api/system.single)): The number of pixels in the Sprite that correspond to one unit in world space.**** (\[uint]\(https\://learn.microsoft.com/dotnet/api/system.uint32)): The amount by which the Sprite mesh should be expanded outwards.**** (\[SpriteMeshType]\(/engine/6000.0/script-reference/unityengine/spritemeshtype)): The type of mesh that is generated for the Sprite.

### Returns

| Type                                                            | Description |
| --------------------------------------------------------------- | ----------- |
| [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) |             |

### Remarks

[Sprite.Create](/engine/6000.0/script-reference/unityengine/sprite/create.md) creates a new [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) which can be used in game applications. A Texture needs to be loaded and assigned to [Sprite.Create](/engine/6000.0/script-reference/unityengine/sprite/create.md) in order to control how the new [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) will look. In the script example below a new Sprite is displayed when the button is pressed.  The new Sprite is created in Start.

The second argument rect defines the sub-texture used. The rect argument is defined in pixels of the Texture.  A Rect(50.0f, 10.0f, 200.0f, 140.0f) would create a left to right range from 50.0f to 50.0f + 200.0f = 250.0f.  The bottom to top range would be 10.0f to 10.0f + 140.0f = 150.0f. The third argument pivot determines what becomes the center of the [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md).  This is a Vector2 relative to the rect where Vector2(0.0f, 0.0f) is the bottom left and Vector2(1.0f, 1.0f) is the top right.  The [Sprite.pixelsPerUnit](/engine/6000.0/script-reference/unityengine/sprite/pixelsperunit.md) value controls the size of the Sprite.  Reducing this below 100 pixels per world increases the size of the Sprite.  The extrude value defines the number of pixels which surround the Sprite. This is useful if the [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) is included in an atlas. meshType selects whether FullRect or Tight is used. Finally border determines the slicing of the Sprite and is usually used to define Sprite tiling behaviour. The values are in pixel units.

Additional Resources: [SpriteRenderer](/engine/6000.0/script-reference/unityengine/spriterenderer.md) class.

```csharp
// Create a Sprite at startup.
// Assign a Texture to the Sprite when the button is pressed.

using UnityEngine;

public class SpriteCreate : MonoBehaviour
{
    public Texture2D tex;
    private Sprite mySprite;
    private SpriteRenderer sr;

    void Awake()
    {
        sr = gameObject.AddComponent<SpriteRenderer>() as SpriteRenderer;
        sr.color = new Color(0.9f, 0.9f, 0.9f, 1.0f);

        transform.position = new Vector3(1.5f, 1.5f, 0.0f);
    }

    void Start()
    {
        mySprite = Sprite.Create(tex, new Rect(0.0f, 0.0f, tex.width, tex.height), new Vector2(0.5f, 0.5f), 100.0f);
    }

    void OnGUI()
    {
        if (GUI.Button(new Rect(10, 10, 100, 30), "Add sprite"))
        {
            sr.sprite = mySprite;
        }
    }
}
```

The following code example shows how to create a Sprite at startup with Secondary Texture properties.

```csharp
using UnityEngine;

// Create a Sprite at startup with Secondary Textures properties

public class ExampleClass : MonoBehaviour
{
    void Start()
    {
        var texture = new Texture2D(64, 64);
        var secondaryTexture1 = new Texture2D(64, 64);
        var secondaryTexture2 = new Texture2D(64, 64);
        var secondaryTexture3 = new Texture2D(64, 64);
        var secondarySpriteTexture = new[]
        {
            new SecondarySpriteTexture()
            {
                name = "_SecondaryTexture1",
                texture = secondaryTexture1
            },
            new SecondarySpriteTexture()
            {
                name = "_SecondaryTexture2",
                texture = secondaryTexture2
            },
            new SecondarySpriteTexture()
            {
                name = "_SecondaryTexture3",
                texture = secondaryTexture3
            }
        };

        var sprite = Sprite.Create(texture, new Rect(0, 0, texture.width, texture.height), Vector2.zero, 100, 0, SpriteMeshType.FullRect, Vector4.zero, false, secondarySpriteTexture);
        int spriteSecondaryTextureCount = sprite.GetSecondaryTextureCount();
    }
}
```

## Create(Texture2D, Rect, Vector2, float, uint)

Create a new Sprite object.

```csharp
public static Sprite Create(Texture2D texture, Rect rect, Vector2 pivot, float pixelsPerUnit, uint extrude)
```

### Parameters

**** (\[Texture2D]\(/engine/6000.0/script-reference/unityengine/texture2d)): The Texture to obtain the Sprite graphic from.**** (\[Rect]\(/engine/6000.0/script-reference/unityengine/rect)): The rectangular section of the Texture to use for the Sprite.**** (\[Vector2]\(/engine/6000.0/script-reference/unityengine/vector2)): The Sprite's pivot point relative to its graphic rectangle.**** (\[float]\(https\://learn.microsoft.com/dotnet/api/system.single)): The number of pixels in the Sprite that correspond to one unit in world space.**** (\[uint]\(https\://learn.microsoft.com/dotnet/api/system.uint32)): The amount by which the Sprite mesh should be expanded outwards.

### Returns

| Type                                                            | Description |
| --------------------------------------------------------------- | ----------- |
| [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) |             |

### Remarks

[Sprite.Create](/engine/6000.0/script-reference/unityengine/sprite/create.md) creates a new [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) which can be used in game applications. A Texture needs to be loaded and assigned to [Sprite.Create](/engine/6000.0/script-reference/unityengine/sprite/create.md) in order to control how the new [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) will look. In the script example below a new Sprite is displayed when the button is pressed.  The new Sprite is created in Start.

The second argument rect defines the sub-texture used. The rect argument is defined in pixels of the Texture.  A Rect(50.0f, 10.0f, 200.0f, 140.0f) would create a left to right range from 50.0f to 50.0f + 200.0f = 250.0f.  The bottom to top range would be 10.0f to 10.0f + 140.0f = 150.0f. The third argument pivot determines what becomes the center of the [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md).  This is a Vector2 relative to the rect where Vector2(0.0f, 0.0f) is the bottom left and Vector2(1.0f, 1.0f) is the top right.  The [Sprite.pixelsPerUnit](/engine/6000.0/script-reference/unityengine/sprite/pixelsperunit.md) value controls the size of the Sprite.  Reducing this below 100 pixels per world increases the size of the Sprite.  The extrude value defines the number of pixels which surround the Sprite. This is useful if the [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) is included in an atlas. meshType selects whether FullRect or Tight is used. Finally border determines the slicing of the Sprite and is usually used to define Sprite tiling behaviour. The values are in pixel units.

Additional Resources: [SpriteRenderer](/engine/6000.0/script-reference/unityengine/spriterenderer.md) class.

```csharp
// Create a Sprite at startup.
// Assign a Texture to the Sprite when the button is pressed.

using UnityEngine;

public class SpriteCreate : MonoBehaviour
{
    public Texture2D tex;
    private Sprite mySprite;
    private SpriteRenderer sr;

    void Awake()
    {
        sr = gameObject.AddComponent<SpriteRenderer>() as SpriteRenderer;
        sr.color = new Color(0.9f, 0.9f, 0.9f, 1.0f);

        transform.position = new Vector3(1.5f, 1.5f, 0.0f);
    }

    void Start()
    {
        mySprite = Sprite.Create(tex, new Rect(0.0f, 0.0f, tex.width, tex.height), new Vector2(0.5f, 0.5f), 100.0f);
    }

    void OnGUI()
    {
        if (GUI.Button(new Rect(10, 10, 100, 30), "Add sprite"))
        {
            sr.sprite = mySprite;
        }
    }
}
```

The following code example shows how to create a Sprite at startup with Secondary Texture properties.

```csharp
using UnityEngine;

// Create a Sprite at startup with Secondary Textures properties

public class ExampleClass : MonoBehaviour
{
    void Start()
    {
        var texture = new Texture2D(64, 64);
        var secondaryTexture1 = new Texture2D(64, 64);
        var secondaryTexture2 = new Texture2D(64, 64);
        var secondaryTexture3 = new Texture2D(64, 64);
        var secondarySpriteTexture = new[]
        {
            new SecondarySpriteTexture()
            {
                name = "_SecondaryTexture1",
                texture = secondaryTexture1
            },
            new SecondarySpriteTexture()
            {
                name = "_SecondaryTexture2",
                texture = secondaryTexture2
            },
            new SecondarySpriteTexture()
            {
                name = "_SecondaryTexture3",
                texture = secondaryTexture3
            }
        };

        var sprite = Sprite.Create(texture, new Rect(0, 0, texture.width, texture.height), Vector2.zero, 100, 0, SpriteMeshType.FullRect, Vector4.zero, false, secondarySpriteTexture);
        int spriteSecondaryTextureCount = sprite.GetSecondaryTextureCount();
    }
}
```

## Create(Texture2D, Rect, Vector2, float)

Create a new Sprite object.

```csharp
public static Sprite Create(Texture2D texture, Rect rect, Vector2 pivot, float pixelsPerUnit)
```

### Parameters

**** (\[Texture2D]\(/engine/6000.0/script-reference/unityengine/texture2d)): The Texture to obtain the Sprite graphic from.**** (\[Rect]\(/engine/6000.0/script-reference/unityengine/rect)): The rectangular section of the Texture to use for the Sprite.**** (\[Vector2]\(/engine/6000.0/script-reference/unityengine/vector2)): The Sprite's pivot point relative to its graphic rectangle.**** (\[float]\(https\://learn.microsoft.com/dotnet/api/system.single)): The number of pixels in the Sprite that correspond to one unit in world space.

### Returns

| Type                                                            | Description |
| --------------------------------------------------------------- | ----------- |
| [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) |             |

### Remarks

[Sprite.Create](/engine/6000.0/script-reference/unityengine/sprite/create.md) creates a new [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) which can be used in game applications. A Texture needs to be loaded and assigned to [Sprite.Create](/engine/6000.0/script-reference/unityengine/sprite/create.md) in order to control how the new [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) will look. In the script example below a new Sprite is displayed when the button is pressed.  The new Sprite is created in Start.

The second argument rect defines the sub-texture used. The rect argument is defined in pixels of the Texture.  A Rect(50.0f, 10.0f, 200.0f, 140.0f) would create a left to right range from 50.0f to 50.0f + 200.0f = 250.0f.  The bottom to top range would be 10.0f to 10.0f + 140.0f = 150.0f. The third argument pivot determines what becomes the center of the [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md).  This is a Vector2 relative to the rect where Vector2(0.0f, 0.0f) is the bottom left and Vector2(1.0f, 1.0f) is the top right.  The [Sprite.pixelsPerUnit](/engine/6000.0/script-reference/unityengine/sprite/pixelsperunit.md) value controls the size of the Sprite.  Reducing this below 100 pixels per world increases the size of the Sprite.  The extrude value defines the number of pixels which surround the Sprite. This is useful if the [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) is included in an atlas. meshType selects whether FullRect or Tight is used. Finally border determines the slicing of the Sprite and is usually used to define Sprite tiling behaviour. The values are in pixel units.

Additional Resources: [SpriteRenderer](/engine/6000.0/script-reference/unityengine/spriterenderer.md) class.

```csharp
// Create a Sprite at startup.
// Assign a Texture to the Sprite when the button is pressed.

using UnityEngine;

public class SpriteCreate : MonoBehaviour
{
    public Texture2D tex;
    private Sprite mySprite;
    private SpriteRenderer sr;

    void Awake()
    {
        sr = gameObject.AddComponent<SpriteRenderer>() as SpriteRenderer;
        sr.color = new Color(0.9f, 0.9f, 0.9f, 1.0f);

        transform.position = new Vector3(1.5f, 1.5f, 0.0f);
    }

    void Start()
    {
        mySprite = Sprite.Create(tex, new Rect(0.0f, 0.0f, tex.width, tex.height), new Vector2(0.5f, 0.5f), 100.0f);
    }

    void OnGUI()
    {
        if (GUI.Button(new Rect(10, 10, 100, 30), "Add sprite"))
        {
            sr.sprite = mySprite;
        }
    }
}
```

The following code example shows how to create a Sprite at startup with Secondary Texture properties.

```csharp
using UnityEngine;

// Create a Sprite at startup with Secondary Textures properties

public class ExampleClass : MonoBehaviour
{
    void Start()
    {
        var texture = new Texture2D(64, 64);
        var secondaryTexture1 = new Texture2D(64, 64);
        var secondaryTexture2 = new Texture2D(64, 64);
        var secondaryTexture3 = new Texture2D(64, 64);
        var secondarySpriteTexture = new[]
        {
            new SecondarySpriteTexture()
            {
                name = "_SecondaryTexture1",
                texture = secondaryTexture1
            },
            new SecondarySpriteTexture()
            {
                name = "_SecondaryTexture2",
                texture = secondaryTexture2
            },
            new SecondarySpriteTexture()
            {
                name = "_SecondaryTexture3",
                texture = secondaryTexture3
            }
        };

        var sprite = Sprite.Create(texture, new Rect(0, 0, texture.width, texture.height), Vector2.zero, 100, 0, SpriteMeshType.FullRect, Vector4.zero, false, secondarySpriteTexture);
        int spriteSecondaryTextureCount = sprite.GetSecondaryTextureCount();
    }
}
```

## Create(Texture2D, Rect, Vector2)

Create a new Sprite object.

```csharp
public static Sprite Create(Texture2D texture, Rect rect, Vector2 pivot)
```

### Parameters

**** (\[Texture2D]\(/engine/6000.0/script-reference/unityengine/texture2d)): The Texture to obtain the Sprite graphic from.**** (\[Rect]\(/engine/6000.0/script-reference/unityengine/rect)): The rectangular section of the Texture to use for the Sprite.**** (\[Vector2]\(/engine/6000.0/script-reference/unityengine/vector2)): The Sprite's pivot point relative to its graphic rectangle.

### Returns

| Type                                                            | Description |
| --------------------------------------------------------------- | ----------- |
| [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) |             |

### Remarks

[Sprite.Create](/engine/6000.0/script-reference/unityengine/sprite/create.md) creates a new [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) which can be used in game applications. A Texture needs to be loaded and assigned to [Sprite.Create](/engine/6000.0/script-reference/unityengine/sprite/create.md) in order to control how the new [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) will look. In the script example below a new Sprite is displayed when the button is pressed.  The new Sprite is created in Start.

The second argument rect defines the sub-texture used. The rect argument is defined in pixels of the Texture.  A Rect(50.0f, 10.0f, 200.0f, 140.0f) would create a left to right range from 50.0f to 50.0f + 200.0f = 250.0f.  The bottom to top range would be 10.0f to 10.0f + 140.0f = 150.0f. The third argument pivot determines what becomes the center of the [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md).  This is a Vector2 relative to the rect where Vector2(0.0f, 0.0f) is the bottom left and Vector2(1.0f, 1.0f) is the top right.  The [Sprite.pixelsPerUnit](/engine/6000.0/script-reference/unityengine/sprite/pixelsperunit.md) value controls the size of the Sprite.  Reducing this below 100 pixels per world increases the size of the Sprite.  The extrude value defines the number of pixels which surround the Sprite. This is useful if the [Sprite](/engine/6000.0/script-reference/unityengine/sprite.md) is included in an atlas. meshType selects whether FullRect or Tight is used. Finally border determines the slicing of the Sprite and is usually used to define Sprite tiling behaviour. The values are in pixel units.

Additional Resources: [SpriteRenderer](/engine/6000.0/script-reference/unityengine/spriterenderer.md) class.

```csharp
// Create a Sprite at startup.
// Assign a Texture to the Sprite when the button is pressed.

using UnityEngine;

public class SpriteCreate : MonoBehaviour
{
    public Texture2D tex;
    private Sprite mySprite;
    private SpriteRenderer sr;

    void Awake()
    {
        sr = gameObject.AddComponent<SpriteRenderer>() as SpriteRenderer;
        sr.color = new Color(0.9f, 0.9f, 0.9f, 1.0f);

        transform.position = new Vector3(1.5f, 1.5f, 0.0f);
    }

    void Start()
    {
        mySprite = Sprite.Create(tex, new Rect(0.0f, 0.0f, tex.width, tex.height), new Vector2(0.5f, 0.5f), 100.0f);
    }

    void OnGUI()
    {
        if (GUI.Button(new Rect(10, 10, 100, 30), "Add sprite"))
        {
            sr.sprite = mySprite;
        }
    }
}
```

The following code example shows how to create a Sprite at startup with Secondary Texture properties.

```csharp
using UnityEngine;

// Create a Sprite at startup with Secondary Textures properties

public class ExampleClass : MonoBehaviour
{
    void Start()
    {
        var texture = new Texture2D(64, 64);
        var secondaryTexture1 = new Texture2D(64, 64);
        var secondaryTexture2 = new Texture2D(64, 64);
        var secondaryTexture3 = new Texture2D(64, 64);
        var secondarySpriteTexture = new[]
        {
            new SecondarySpriteTexture()
            {
                name = "_SecondaryTexture1",
                texture = secondaryTexture1
            },
            new SecondarySpriteTexture()
            {
                name = "_SecondaryTexture2",
                texture = secondaryTexture2
            },
            new SecondarySpriteTexture()
            {
                name = "_SecondaryTexture3",
                texture = secondaryTexture3
            }
        };

        var sprite = Sprite.Create(texture, new Rect(0, 0, texture.width, texture.height), Vector2.zero, 100, 0, SpriteMeshType.FullRect, Vector4.zero, false, secondarySpriteTexture);
        int spriteSecondaryTextureCount = sprite.GetSecondaryTextureCount();
    }
}
```