PureData CEAMMC web documentation
PureData CEAMMC library web documentation
Distribution download
index :: base
bitmap
aliases: [ceammc/bitmap]
binary image (2D bit matrix)
available since version: 0.9.8
arguments:
-
W bitmap width in pixels, see @w
type: int -
H bitmap height in pixels, see @h
type: int
methods:
- arc
draw arc
parameters:-
X x coord
type: int
required: True -
Y y coord
type: int
required: True -
D diameter
type: int
required: True -
START start angle. 0 - top
type: int
units: deg
required: True -
LEN arc length, counter-clockwise
type: int
units: deg
required: True -
[CENTER=0] if 1: set coordinate of the arc center, not the top-left corner
type: bool
-
- circle
draw circle
parameters:-
X x coord
type: int
required: True -
Y y coord
type: int
required: True -
D diameter
type: int
required: True -
[CENTER=0] if 1: set coordinate of the circle center, not the top-left corner
type: bool
-
-
clear clear bitmap (set all pixels to 0)
- column
draw column
parameters:-
COL column
type: int
required: True -
H column height, can be negative(!), to draw in opposite direction
type: int
required: True -
DY y offset
type: int
required: True
-
- ellipse
draw ellipse
parameters:-
X x coord
type: int
required: True -
Y y coord
type: int
required: True -
W width
type: int
required: True -
H height
type: int
required: True -
[CENTER=0] if 1: set coordinate of the ellipse center, not the top-left corner
type: bool
-
- fill
set all pixels to value
parameters:- [V=0] value
type: int
- [V=0] value
- fill_color
set fill color
parameters:- [COLOR] fill color (0, 1 or -1 if no color)
type: int
- [COLOR] fill color (0, 1 or -1 if no color)
- font
set font
parameters:- NAME font name
type: symbol
required: True
- NAME font name
-
get list output content as list
-
get matrix output bitmap content as: [matrix NROWS NCOLS DATA…( message
- get submatrix
output submatrix bitmap content as: [matrix NROWS NCOLS DATA…( message
parameters:-
NROWS matrix number of rows
type: int
required: True -
NCOLS matrix number of columns
type: int
required: True -
AT_ROW row position
type: int
required: True -
AT_COL columns position
type: int
required: True
-
- hshift
horizontal shift (rotate)
parameters:- V number of pixels to shift
type: int
required: True
- V number of pixels to shift
-
invert invert all pixel values
- line
draw line
parameters:-
X0 x0 coord
type: int
required: True -
Y0 y0 coord
type: int
required: True -
X1 x1 coord
type: int
required: True -
Y1 y1 coord
type: int
required: True
-
- load
load image to bitmap
parameters:-
FILE image path, relative, or absolute
type: symbol
required: True -
[SCALE=1] image scale
type: float
-
- mirror
mirror bitmap
parameters:- AXIS mirror axis
type: symbol
required: True
- AXIS mirror axis
- pixel
set pixel
parameters:-
X x coord
type: int
required: True -
Y y coord
type: int
required: True -
[VAL=1] new pixel value
type: bool
-
- rect
draw rect
parameters:-
X x coord
type: int
required: True -
Y y coord
type: int
required: True -
W width
type: int
required: True -
H height
type: int
required: True -
[CENTER=0] if 1: set coordinate of the rect center, not the top-left corner
type: bool
-
- row
draw draw
parameters:-
ROW row
type: int
required: True -
W row width, can be negative(!), to draw in opposite right to left
type: int
required: True -
DX x offset
type: int
required: True
-
- save
save bitmap to PNG file
parameters:- [PATH] file name, absolute, or relative
type: symbol
- [PATH] file name, absolute, or relative
- sector
draw sector
parameters:-
X x coord
type: int
required: True -
Y y coord
type: int
required: True -
D diameter
type: int
required: True -
START start angle. 0 - top
type: int
units: deg
required: True -
LEN arc length, counter-clockwise
type: int
units: deg
required: True -
[CENTER=0] if 1: set coordinate of the sector center, not the top-left corner
type: bool
-
- set list
set bitmap content from list
parameters:- DATA list of 0 and 1
type: list
required: True
- DATA list of 0 and 1
- set matrix
set matrix data
parameters:-
NROWS matrix number of rows
type: int
required: True -
NCOLS matrix number of columns
type: int
required: True -
DATA data
type: list
required: True
-
- set matrix_at
set matrix data at specified position
parameters:-
NROWS matrix number of rows
type: int
required: True -
NCOLS matrix number of columns
type: int
required: True -
AT_ROW row position
type: int
required: True -
AT_COL columns position
type: int
required: True -
DATA data
type: list
required: True
-
- stroke_color
set stroke color
parameters:- [COLOR] stroke color (0 or 1)
type: int
- [COLOR] stroke color (0 or 1)
- stroke_width
set stroke width
parameters:- W new width
type: int
required: True
- W new width
- text
draw text
parameters:-
X left x-coord
type: int
required: True -
Y bottom y-coord
type: int
required: True -
TXT text
type: symbol
required: True
-
- text_color
set text color
parameters:- [COLOR] fill color (0, 1 or -1 if no color)
type: int
- [COLOR] fill color (0, 1 or -1 if no color)
- triangle
draw triangle
parameters:-
X0 x0 coord
type: int
required: True -
Y0 y0 coord
type: int
required: True -
X1 x1 coord
type: int
required: True -
Y1 y1 coord
type: int
required: True -
X2 x2 coord
type: int
required: True -
Y2 y2 coord
type: int
required: True
-
-
view opens bitmap view window
- vshift
vertical shift
parameters:- V number of pixels to shift
type: int
required: True
- V number of pixels to shift
properties:
-
@h (initonly) Get/set bitmap height in pixels
type: int
range: 1..256
default: 8 -
@w (initonly) Get/set bitmap width in pixels
type: int
range: 1..256
default: 8
inlets:
- output as list
type: control
outlets:
- output
type: control
keywords:
See also: [ui.matrix]
Authors: Serge Poltavsky
License: GPL3 or later