Reference

 Table of Contents  ▸  List of Commands  ▸  Geometry Manipulation  ▸  split ◀  sort    |    split_tiles  ▶

# split

Built-in command

## Arguments:

• { x | y | z | c }...{ x | y | z | c },_split_mode    or
• keep_splitting_values={ + | - },_{ x | y | z | c }...{ x | y | z | c },value1,_value2,...    or
• (no arg)

## Description:

Split selected images along specified axes, or regarding to a sequence of scalar values

(optionally along specified axes too).

(equivalent to shortcut command s).

split_mode can be { 0=split according to constant values | >0=split in N parts | <0=split in parts of size -N }.

split_mode=-1.

## Examples of use:

### • Example #1

\$ gmic image.jpg split c

Command: image.jpg split c
Command: image.jpg split c
Command: image.jpg split c

### • Example #2

\$ gmic image.jpg split y,3

Command: image.jpg split y,3
Command: image.jpg split y,3
Command: image.jpg split y,3

### • Example #3

\$ gmic image.jpg split x,-128

Command: image.jpg split x,-128
Command: image.jpg split x,-128
Command: image.jpg split x,-128
Command: image.jpg split x,-128
Command: image.jpg split x,-128

### • Example #4

\$ gmic 1,20,1,1,"1,2,3,4" +split -,2,3 append[1--1] y

Command: 1,20,1,1,"1,2,3,4" +split -,2,3 append[1--1] y
Command: 1,20,1,1,"1,2,3,4" +split -,2,3 append[1--1] y

### • Example #5

\$ gmic (1,2,2,3,3,3,4,4,4,4) +split x,0 append[1--1] y

Command: (1,2,2,3,3,3,4,4,4,4) +split x,0 append[1--1] y
Command: (1,2,2,3,3,3,4,4,4,4) +split x,0 append[1--1] y