<!--
{
  "availability" : [
    "iOS: 17.0.0 -",
    "iPadOS: 17.0.0 -",
    "macCatalyst: 17.0.0 -",
    "macOS: 14.0.0 -",
    "tvOS: 26.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "ShaderGraph-Docs",
  "identifier" : "/documentation/ShaderGraph/2D-Procedural/Split-Vertical",
  "metadataVersion" : "0.1.0",
  "role" : "ShaderGraph Node",
  "symbol" : {
    "kind" : "ShaderGraph Node",
    "modules" : [
      "ShaderGraph"
    ],
    "preciseIdentifier" : "Shader_ND_splittb_float"
  },
  "title" : "Split Vertical"
}
-->

# Split Vertical

A top-to-bottom split matte, split at a specified V value.

## Parameter Types

**Split Vertical (float):**

|Input                |Type    |
                |---------------------|--------|
                |`Top`                |Float   |
                |`Bottom`             |Float   |
                |`Center`             |Float   |
                |`Texture Coordinates`|Vector2f|

|Output|Type |
                |------|-----|
                |`Out` |Float|

**Split Vertical (vector4h):**

|Input                |Type    |
                |---------------------|--------|
                |`Top`                |Vector4h|
                |`Bottom`             |Vector4h|
                |`Center`             |Float   |
                |`Texture Coordinates`|Vector2f|

|Output|Type    |
                |------|--------|
                |`Out` |Vector4h|

**Split Vertical (vector4f):**

|Input                |Type    |
                |---------------------|--------|
                |`Top`                |Vector4f|
                |`Bottom`             |Vector4f|
                |`Center`             |Float   |
                |`Texture Coordinates`|Vector2f|

|Output|Type    |
                |------|--------|
                |`Out` |Vector4f|

**Split Vertical (half):**

|Input                |Type    |
                |---------------------|--------|
                |`Top`                |Half    |
                |`Bottom`             |Half    |
                |`Center`             |Float   |
                |`Texture Coordinates`|Vector2f|

|Output|Type|
                |------|----|
                |`Out` |Half|

**Split Vertical (vector2h):**

|Input                |Type    |
                |---------------------|--------|
                |`Top`                |Vector2h|
                |`Bottom`             |Vector2h|
                |`Center`             |Float   |
                |`Texture Coordinates`|Vector2f|

|Output|Type    |
                |------|--------|
                |`Out` |Vector2h|

**Split Vertical (color4f):**

|Input                |Type         |
                |---------------------|-------------|
                |`Top`                |Color4<Float>|
                |`Bottom`             |Color4<Float>|
                |`Center`             |Float        |
                |`Texture Coordinates`|Vector2f     |

|Output|Type         |
                |------|-------------|
                |`Out` |Color4<Float>|

**Split Vertical (vector2f):**

|Input                |Type    |
                |---------------------|--------|
                |`Top`                |Vector2f|
                |`Bottom`             |Vector2f|
                |`Center`             |Float   |
                |`Texture Coordinates`|Vector2f|

|Output|Type    |
                |------|--------|
                |`Out` |Vector2f|

**Split Vertical (vector3h):**

|Input                |Type    |
                |---------------------|--------|
                |`Top`                |Vector3h|
                |`Bottom`             |Vector3h|
                |`Center`             |Float   |
                |`Texture Coordinates`|Vector2f|

|Output|Type    |
                |------|--------|
                |`Out` |Vector3h|

**Split Vertical (color3f):**

|Input                |Type         |
                |---------------------|-------------|
                |`Top`                |Color3<Float>|
                |`Bottom`             |Color3<Float>|
                |`Center`             |Float        |
                |`Texture Coordinates`|Vector2f     |

|Output|Type         |
                |------|-------------|
                |`Out` |Color3<Float>|

**Split Vertical (vector3f):**

|Input                |Type    |
                |---------------------|--------|
                |`Top`                |Vector3f|
                |`Bottom`             |Vector3f|
                |`Center`             |Float   |
                |`Texture Coordinates`|Vector2f|

|Output|Type    |
                |------|--------|
                |`Out` |Vector3f|

## Parameter description

- `Top`: The value of the left side of the split.
- `Bottom`: The value of the right side of the split.
- `Center`: The *V* value at which the output is split. Everything above this value will be equal to the `Top` input; everything below this value will be equal to the `Bottom` input. This parameter ranges between `0` and `1`.
- `Texture Coordinates`: The 2D coordinate at which the data is read in order to map the texture onto a surface. The default uses the current *UV* coordinates, in which *U* is the horizontal axis and *V* is the vertical axis.

## Discussion

This node creates two distinct regions along the vertical axis. The value of the `Center` input determines the regions. A value of `0` establishes the center at the top-most, position causing the output to always be equal to the `Top` input. A value of `1` establishes the center at the bottom-most position.
Below is a an example of a simple node graph that uses `Split Vertical` to create a split color:

![](images/ShaderGraph-Docs/SplitVerticalGraph.png)

By editing the center value, you change the texture to show a larger top or bottom region.
The image below shows the resulting textures:

![](images/ShaderGraph-Docs/SplitVerticalMaterial1.png)


![](images/ShaderGraph-Docs/SplitVerticalMaterial2.png)


![](images/ShaderGraph-Docs/SplitVerticalMaterial3.png)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)