Digitize video from an external source Use the jit.grab object to digitize video from any video digitizer and decompress the signal into a Jitter matrix. On OSX, QuickTime is used; on Windows, DirectX is used. jit.grab also offers a grab-to-disk mode. Although numerous parameters for control are offered, not all features are supported by all digitizers. Cycling '74 Jitter camera bang, messages in TEXT_HERE bang, messages in TEXT_HERE out TEXT_HERE dumpout TEXT_HERE char Adapt output matrix dimensions to native device dimensions. Adapt output matrix dimensions to native device dimensions. Enabled by default if no dim specified. Enable automatic matrix output. Enable automatic matrix output when bound to jit.world. Color encoding for output matrix The output matrix's color encoding (default = argb) ARGB (alpha, red, green, blue) colormode UYVY (YUV 4:2:2 packed) colormode Render context name A render context name, used when output_texture is enabled. The portion of the output matrix used for decompressing media to the internal matrix. (default = 0 0 (matrix width) The portion of the output matrix used for decompressing media to the internal matrix. (default = 0 0 (matrix width) (matrix height))
The proportions of the rectangle are expressed in the form left top right bottom. All values are relative to the top left corner of the viewing area of the output matrix. Video engine backend. Video engine backend. This argument can only be set in the max box. If not specified, it is determined by the Video Engine Max preference. As of this writing, possible values include avf (Mac only), qt, and viddll. Video digitizer frame rate The video digitizer frame rate (default = digitizer-specific).
The digitizer has to be closed and re-opened before changes to framerate take effect. Frame reporting flag Frame reporting flag (default = 0)
When enabled, the message framecalc will be sent from the rightmost outlet of the jit.grab object as each frame is processed, followed by the number of milliseconds spent doing so. Current video digitizer input The current video digitizer input (default = digitizer-specific) Image interpolation flag Image interpolation flag (default = 0) Enable OpenGL texture output Enable OpenGL texture output (default = 0). When enabled an OpenGL texture is output instead of a Jitter matrix. The object's drawto attribute must be set to a valid gl context. An RGBA texture is output using the movie's native dimensions. When enabled, the following attributes have no effect:
adapt
colormode
dim
dstrect
srcrect
usedstrect
usesrcrect Source rect from digitizer frame Source rect from digitizer frame (default = 0 0 (matrix width) (matrix height)) Output texture name Output texture name, when output_texture is enabled. Unique frame filter flag Unique frame filter flag (default = 0 (disabled))
When the flag is set, only new frames from the digitizer are output when the object receives a bang. If no new frame has been received from the digitizer, the jit.grab object will not respond to the bang. Destination rect flag Destination rect flag (default = 0) When the flag is set, the dstrect attributes are used when copying an input matrix to the internal matrix. Source rect flag Source rect flag (default = 0) When the flag is set, the srcrect attributes are used when copying an input matrix to the internal matrix. Current video digitizer The current video digitizer (default = 0) Format TEXT_HERE Close an open sequence grab component Closes an open sequence grab component. The component is automatically closed when the object is freed. Export the current frame as an image file Export the current frame as an image file with the name specified by the first argument. The second argument sets the file type (default = png). Available file types are png, tiff, and jpeg.
You can use the Max Preferences to specify a default image resolution for png image types. Report all video digitizer inputs Reports the list of available inputs to the video digitizer from the object's right outlet, preceded by the word inputlist. Note that the digitizer must be open in order for this method to function. Report all available video digitizers Reports the list of available video digitizers from the object's right outlet, preceded by the word vdevlist. Open a sequence grab component Opens a sequence grab component. A component must be explicitly opened before the jit.grab object will began digitizing. TEXT_HERE TEXT_HERE