G'MIC - GREYC's Magic for Image Computing: A Full-Featured Open-Source Framework for Image Processing

A Full-Featured Open-Source Framework for Image Processing

Home
News
Download
Resources
- Technical Reference
- Scripting Tutorial
- Video Tutorials
- Wiki Pages
- Image Gallery
- Color Presets
- Using libgmic
- G'MIC Online
Community
- Discussion Forum (Pixls.us)
- GimpChat
- IRC
Report Issue

Latest stable version: 3.5.5 Current pre-release: 3.6.0 (2025/07/24)

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[%],_max_parts>0 or
keep_splitting_values={ +:Increasing | -:Decreasing },_{ 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).

(equivalent to shortcut command s).

Argument split_mode determines how the split is done. It can be :

0: Split image according to consecutive constant values;

N (where N is a positive integer): Split image into N homogeneous parts;

-N[%] (where N is a positive integer): Split image as blocks of size N(opt. specified as a percentage of the image dimension).

When specified, max_parts defines a limit in the number of resulting images.

Default values:

N=-1.

Examples of use:

• Example #1

image.jpg split c

Command: image.jpg split c

Command: image.jpg split c

Command: image.jpg split c

• Example #2

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

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

image.jpg split x,-30%,2

Command: image.jpg split x,-30%,2

Command: image.jpg split x,-30%,2

• Example #5

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 #6

(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

G'MIC - GREYC's Magic for Image Computing: A Full-Featured Open-Source Framework for Image Processing

G'MIC is an open-source software distributed under the CeCILL free software licenses (LGPL-like and/or
GPL-compatible). Copyrights (C) Since July 2008, David Tschumperlé - GREYC UMR CNRS 6072, Image Team.