G'MIC - GREYC's Magic for Image Computing: A Full-Featured Open-Source Framework for Image Processing
Banner Institutions GREYC CNRS ENSICAEN UNICAEN

A Full-Featured Open-Source Framework for Image Processing



Latest stable version: 4.0.4 (2026/08/19)

Reference
Table of Contents  ▸  List of Commands  ▸  Reptorian's Commands  ▸  rep_form_pixel◀  rep_objvolumefilt    |    rep_thorn_fractal  ▶

rep_form_pixel

Arguments:

  • form_id,form_quad_lx!=0,form_quad_ly!=0,_form_ratio[%]!=0,_angle, 0<=_reflect_dir<=2,_sublevel,_tile_boundary={ 0=periodic | 1=mirror_x | 2=mirror_y | 3=mirror_xy },_image_boundary={ 0=neumann | 1=periodic | 2=mirror},_abs_zconvf>=0,_zconv_boundary={0=periodic | 1= mirror},_interpolation={ 0=nearest | 1=average | 2=grid | 3=linear | 4=bicubic | 5=lanczos},cs_mode={ 0=rgb | 1=ryb | 2=cmyk | 3=hcy | 4=hsi | 5=hsl | 6=hsv | 7=lab | 8=lch },_fit_tile={ 0=squash_to_fit | 1=resize_to_fit },_kdol={ 0=new_dim | 1=new_layer_new_dim | 2=new_layer | 3=new_layer_old_dim },shape_option_1..._shape_option_n

Description:

_form_id refers to the id or name of shape. circle is a valid form id, and any integer number that is 0-24 inclusive is a form id. You can also use image as an argument, so you can use any arbitrary shapes.

_form_quad_lx refers to the size of the tile in pixel form. It cannot be 0 unless you want to use _form_quad_ly variable to define the tile width.
_form_quad_ly refers to the size of the tile in pixel form. It cannot be 0 unless you want to use _form_quad_lx variable to define it tile height.
_form_ratio refers to the how much the shape fills each tile.
_angle refers to the rotation of shapes per tile
_reflect_dir refers to the mirroring of each shape. 1,2 means the mirroring is applied.
_sublevel refers to the initial size of the shape to be scaled down to fit tiles.
_tile_boundary refers to how the tiles are repeated within the canvas
_image_boundary refers to how the pixels are treated when out-of-range of original canvas before generating tiles
_abs_zconvf defines the contrast level of each tiles using z-convolution within a small color tile reference 3D image.
_zconv_boundary defines how out-of-range value within z-convolution kernet are treated.
_interpolation refers to the interpolation of the scaling of shapes to fit each tile. See gmic h resize _interpolation.
_cs_mode refers to the color processing space that form_pixel filter utilize.
_fit_tile is a parameter used for whether to fit tile into specified tile width and height or to use stretch resize =method.
_kdol can be used to resize the generated result to original dimension and/or to create new layer on top of existing image.
_shape_option are used to define the behavior of shapes when available.
 
-- form_id --
string | shape_name_id | shape_options
 
[image] ---- image_as_shape
0  - australia
1  - barbedwire
2  - circle
3  - crosshair
4  - cupid
5  - diamond
6  - dragon ------ dragon_recursion>=0,-360<=dragon_curve_rotation_angle>=360
7  - dragonfly
8  - fern - size>=0,density[%]>=0,ang,0<=opacity<=1,type={ 0=Black Spleenwort | 1=Marsh }
9  - flip
10 - gear  ------- teeth>0,0<height<=100,0<=offset_teeth=100,0<ratio<=100
11 - gumleaf
12 - heart
13 - information
14 - kookaburra
15 - mail
16 - mapleleaf
17 - paint_splat
18 - paw
19 - phone
20 - polygon  ------- vertices>0
21 - rooster
22 - shopping_cart
23 - snowflake  ------- 1<=recursion<=6
24 - star  ------- branches>3,thickness[%]
 
-- end of form_id --
 
Note: _shape_option_1 can be empty. n refers to corresponding shape option.
 
Author: Reptorian.

Examples of use:

• Example #1

sp landscape +rep_form_pixel star,20,,90%,45,0,1,1,2,75%,0,5,2,0,0

Command: sp landscape +rep_form_pixel star,20,,90%,45,0,1,1,2,75%,0,5,2,0,0
Command: sp landscape +rep_form_pixel star,20,,90%,45,0,1,1,2,75%,0,5,2,0,0

• Example #2

sp dog +rep_form_pixel star,15,,80%,20,0,100%,1,0,250%

Command: sp dog +rep_form_pixel star,15,,80%,20,0,100%,1,0,250%
Command: sp dog +rep_form_pixel star,15,,80%,20,0,100%,1,0,250%
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.