General Attributes

DEVICE_NAME

This attribute sets the path name of the o1k (SunVideo Plus) device. You must set this attribute using the xil_device_create(3) and xil_device_set_value(3) functions prior to creating the device image.

Access: set/get Type: char * Default: "/dev/o1k0"

PORT_V

This attribute defines which of the three ports will capture the video signal.

0	S_VIDEO port
1	Composite Video #1 port
2	Composite Video #2 port

Access: set/get Type: int Default: 1

PORT

This attribute is a string interface to set the port.

S VIDEO	S_VIDEO port
COMPOSITE VIDEO 1	Composite Video #1 port
COMPOSITE VIDEO 2	Composite Video #2 port

Access: set/get Type: char * * Default: "COMPOSITE VIDEO 1"

FORMAT_V

This attribute returns 0 if the format is unknown, 1 if capturing from PAL, and 2 if capturing from NTSC. See "Video Ports, Formats, and Auto Format Detection" on page 72 for more information.

Access: get Type: int

FORMAT

This attribute returns the video format being captured (NTSC, PAL, or UNKNOWN). See "Video Ports, Formats, and Auto Format Detection" on page 72 for more information.

Access: get Type: char *

IMAGE_SKIP

This attribute sets and returns the number of images to skip between captures. You can use the IMAGE_SKIP attribute to pace the flow of images. For example, an application that supports security cameras could use the attribute to provide images at 30-second intervals.

Another example is to use IMAGE_SKIP when you want to limit the frame rate to match a particular network bandwidth. To capture NTSC frames at a rate of approximately 10 fps, you would set the IMAGE_SKIP attribute to 2. This causes the SunVideo Plus card to capture every third frame.

Access: set/get Type: intDefault: 0

MAX_BUFFERS

This attribute sets and returns the maximum number of compressed frames that the XIL SunVideo Plus driver will hold while waiting for an application to retrieve via a compress call. The value must be in the range between 1 and 10. See the figure below. The value is clipped to provide the number of buffers that fit in the available memory.

Figure 5-1 Maximum Number of Buffers

Access: set/get Type: integerDefault: 2

NUM_BUFFERS

This attribute returns an integer that specifies the actual number of buffers that can be used to hold compressed frames. The NUM_BUFFERS value is less than or equal to the value of the MAX_BUFFERS attribute.

The NUM_BUFFERS attribute returns a valid value after the first capture (or capture/compress) operation has been performed.

Access: set Type: integer

FULL_BUFFERS

This attribute returns an integer that specifies the current number of buffers that contain valid data. The FULL_BUFFERS attribute returns a valid value after the first capture (or capture/compress) has been performed.

Access: get Type: integer

FLUSH_BUFFERS

If the FLUSH_BUFFERS attribute is set, then all saved buffers are flushed before the next image is captured. After the operation completes, the value of FULL_BUFFERS is set to zero. The input value of the set attribute call is ignored.

Access: set Type: void