SMParser

A simple command line tool to control the Screen Machine from the Terminal.

Command Summary

ask <question>							- Prompts user with question (useful for scripts)
board <boardnum>						- Choose board 					
brightness <0-63>						- Brightness of overlay
chromainstensity <-50 - +50>			- Input signal chroma intensity
clear 									- Removes all clips
contrast <0-63>							- Contrast of overlay
display <name>							- Display file name in overlay
fields <odd|even|both>					- Number of fields display
gain <red|green|blue>  <0-63>			- Red/Green/Blue color of overlay
hue <0-255>								- Hue of input
info									- Print out general info of board settings
input <black|red|yellow|svhs>			- Select input
log <filename>							- Log commands to a file 
										 (log without arguments turns logging off)
lumaintensity <-50 - +50>				- Input signal luma intensity
mixer <on|off>							- Overlay mixed/not mixed 
move <x> <y> /							- Change position of overlay
open <0-3>								- Initialize board
prefilter <on|off>						- Turn prefiltering on or off
quit									- Quit parser
read <name>								- Grab and image and save it as name
remove <clipnum>						- Remove clip with number clipnum
saturation<0-63>						- Saturation of overlay
say <text>								- Prints text (useful for scripts)
setclip <x> <y> <width> <height> <num>  - Mask out a region (x,y,w,h) from
										  overlay and assign it number (num)
sharpness <0-63>						- Sharpness of overlay
size <width> <height> 					- Sizes window to width,height
start 									- Set overlay to live
stop									- Set overlay to still
system <pal|secam|ntsc>					- Choose input video system
vframe <x> <y> <width> <height>  		- Set the video frame (Region of 
										  input signal that is digitized)
video <on|off> 							- Turn overlay on or off
window <x> <y> <width> <height>			- Set size and position of overlay
zoom  <x> <y> <width> <height> 			- Specify a zoom frame ( in % of video res)
										  i.e range of x,y,width and height is <0-100>

Setup

pll <0-800>
xoff <0-256>
yoff  <0-256>



Arguments

on = 1
off = 0

Numeric arguments can be specified relative to set value. For example a
move +10 -10 would move the current window +10 in the x direction and -10 in the y, where as
move 10 10 would move the window to the 10,10 position.


Image aquisitition & display

Images can be aquired using the read command. When issued a single image is digitized and stored in the specified file. This image is in the FLM file format as a YUV Mode 6 image. The size of the image is determined by the size of the overlay, although it can never exceed the size of the digitized image in the SM's memory (Set by video frame). This means that for PAL with just even or odd fields the maximum size is 736X280 and both fields 736X560. 
The FLM images can be converted into TIFF images using the flm2tiff conversion program.

It is also possible to display images in 24bit color using the overlay of the SM. The display command can display any FLM image file with YUV Mode 6 data. To avoid unecessary scaling of the image it sugested that the window frame is adjusted to the size of the image or some ration thereof.
To obtain a FLM image file with YUV Mode 6 data use the tiff2flm converion program.

