Skip to main content Link Search Menu Expand Document (external link)
Hidale.com Docs

@colormap attribute

🔌dp.kinect dp.kinect2 dp.kinect3 dp.oak
signature
colormap {INT | off | argb | uyvy | rgb | rgba}
values
0 or off
no color output default
1 or argb
color bt.601 ordered (alpha red green blue)
3 or uyvy
color uyvy for Max (technically YCbCr)
4 or rgb
color bt.601 ordered (red green blue)
5 or rgba
color bt.601 ordered (red green blue alpha)
examples
@colormap 1
@colormap rgb

Color image output in choice of pixel format on the second outlet.

Values 4 or rgb and 5 or rgba are often useful when sending color information to OpenGL. This pixel format, resolution @colormapres, and @colortype together define the memory layout of color data.

When banding or flickering is seen, try the @powerfreq filter.

📝 Plugin versions v1.3.20210429 and newer support using value names like rgb and argb.

📝 Kinect v1 hardware does not have enough USB bandwidth to output color and infrared data at the same time.

Poor color quality with Cycling74 Max

⚠️ All known versions of Max 5, 6, 7, and 8 incorrectly process and display all image data. Max will slightly shift tint, color, saturation, and brightness. The shifts accumulate. These shifts may not be important or visible depending on your specific use.

Details of the problems are within private conversations with Max developers. The problems are due to incorrect and inconsistent formulas in Max’s codebase that are used for both rgb and uyvy manipulation, uyvy to/from rgb conversion, and colorspace transformation. In addition, there is no single shared rgb colorspace for jitter matrices and no metadata that labels jitter matrices with their colorspace. Without this metadata or a single shared colorspace, no processing or display of image data can be consistently high-fidelity. This is a technically difficult topic area; Cycling74 declines to fix the problems. Workarounds are very difficult and require custom-written Max plugins, shaders, and new visual display components (e.g. jit.window, jit.pwindow). https://cycling74.com/forums/yuv-bugs-fixed-in-max-8-corrupts-tint-color-saturation-and-brightness