Digitize video using DirectX (Windows)
Digitizes video from any DirectX-compatible video digitizer, and decompresses the signal into a Jitter matrix. It 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
Jitter Generators
bang, messages in
TEXT_HERE
bang, messages in
TEXT_HERE
(matrix) out
TEXT_HERE
dumpout
TEXT_HERE
char
Open the video settings dialog
Opens the standard video digitizer settings dialog box.
Open the sound settings dialog
Opens the standard sound digitizer settings dialog box.
Stop grabbing to disk
Stops grabbing to disk.
Restore digitizer image defaults
Restores digitizer image control defaults.
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.
Open a grab component
Opens a sequence grab component. A component must be explicitly opened before the jit.dx.grab object will began digitizing.
Close an open grab component
Closes an open sequence grab component. The component is automatically closed when the object is freed.
Start grabbing to disk
Starts grabbing to disk. If no filename argument is supplied, a file dialog box will open.
The default FPS is 30. frames/sec.
Report video digitizers
Reports the list of available video digitizers from the object's right outlet, preceded by the word vdevlist.
Report video input devices
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 sound digitizers
Reports the list of available sound digitizers from the object's right outlet, preceded by the word snddevlist.
Report sound input devices
Reports the list of available inputs for the current sound digitizer from the object's right outlet, preceded by the word sndinputlist. Note that the digitizer must be open in order for this method to function.
Report the available digitizer formats
Reports the list of available digitizer formats from the object's right outlet, preceded by the word formatlist. Note that the digitizer must be open in order for this method to function.
Video backlight compensation
The video digitizer backlight compensation setting (default = digitizer-specific)
0 = off
1 = on
Sound bit depth
The sound digitizer bit depth (default = digitizer-specific)
8 = digitize sound at 8-bit resolution
16 = digitize sound at 16-bit resolution
Video brightness level
The video digitizer brightness level (default = digitizer-specific)
Sound digitizer channel
The sound channel selection (default = digitizer-specific)
1 = digitize sound in mono
2 = digitize sound in stereo
Video color enable
The video digitizer colorenable setting (default = digitizer-specific)
0 = off
1 = on
Output color encoding
The output matrix's color encoding (default = argb)
argb = ARGB (alpha, red, green, blue) colormode
uyvy = UYVY (YUV 4:2:2 packed) colormode
TEXT_HERE
TEXT_HERE
TEXT_HERE
TEXT_HERE
Video contrast level
The video digitizer contrast level (default = digitizer-specific)
Dropped frame reporting
Dropped frames reporting flag (default = 0 (disabled))
When this flag is set, the message dropped will be sent from the rightmost outlet of the jit.dx.grab object, followed by the number of dropped frames, whenever frame-dropping is detected.
Output matrix rectangle
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 format selection
The video digitizer format selection (default = digitizer-specific)
Video gain
The video digitizer gain (default = digitizer-specific)
Note that the jit.qt.grab object has an attribute called gain which controls audio, rather than video gain.
Video gamma
The video digitizer gamma (default = digitizer-specific)
Video hue adjustment
The video digitizer hue adjustment (default = digitizer-specific)
Video input
The current video digitizer input (default = digitizer-specific)
Image interpolation
Image interpolation flag (default = 0)
Preferred capture resolution
Preferred capture resolution for the digitizer (default = digitizer-specific)
If a resolution is specified, an attempt is made to configure the digitizer to capture at that resolution.
Sound sample rate
Sound digitizer sample rate (default = digitizer-specific)
44100 = 44.1 kHz
48000 = 48.0 kHz
(other rates may be available, but are digitizer-specific)
Video saturation
Video digitizer saturation level (default = digitizer-specific)
Video sharpness
Video digitizer sharpness level (default = digitizer-specific)
Sound digitizer device
The current sound digitizer (default = 0)
Digitizer source rectangle
Source rect from digitizer frame (default = 0 0 (matrix width) (matrix height))
Unique frame filter
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.dx.grab object will not respond to the bang.
Use destination rectangle
Destination rect flag (default = 0) When the flag is set, the dstrect attributes are used when copying an input matrix to the internal matrix.
Use source rectangle
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 device
The current video digitizer (default = 0)
Video white balance
The video digitizer white balance (color temperature) (default = digitizer-specific)
Audio track write flag
Audio track write flag (default = 0) When the flag is set, an audio track is written when grabbing images to disk.
Video track write flag
Video track write flag (default = 1) When the flag is set, a video track is written when grabbing images to disk.
MACINTOSH USERS: The jit.dx.grab object uses DirectX, and is Windows-only. Please refer to the jit.qt.grab object.