Attributes by Name

NI-IMAQ for IEEE 1394 Cameras Function

Attributes by Name

The following table, sorted by attribute name, describes the attributes you can use with the attribute functions.

Attribute Name Attribute Code Type Description
Absolute Auto Exposure IMG1394_ATTR_ABSOLUTE_AUTO_EXPOSURE 0x102 Double Sets/gets reference level used by the camera to automatically control the exposure level. The value is represented relative to 0 EV.
Absolute Brightness IMG1394_ATTR_ABSOLUTE_BRIGHTNESS 0x101 Double Sets/gets the black level of the image. The value is represented as a percentage.
Absolute Focus IMG1394_ATTR_ABSOLUTE_FOCUS 0x10C Double Controls the lens focus. The value is represented as meters (m).
Absolute Frame Rate IMG1394_ATTR_ABSOLUTE_FRAME_RATE 0x208 Double Sets/gets the frame rate priority within the current video mode. Absolute value in fps.
Absolute Gain IMG1394_ATTR_ABSOLUTE_GAIN 0x10A Double Controls the camera circuit gain. The value is represented relative to 0 decibels (dB).
Absolute Gamma IMG1394_ATTR_ABSOLUTE_GAMMA 0x108 Double Defines the function between incoming light level and output image level.
Absolute Hue IMG1394_ATTR_ABSOLUTE_HUE 0x106 Double Sets/gets the color phase of the image. The value is represented to 0 degrees.
Absolute Iris IMG1394_ATTR_ABSOLUTE_IRIS 0x10B Double Controls the mechanical lens iris. The value is represented as F number.
Absolute Optical Filter IMG1394_ATTR_ABSOLUTE_OPTICAL_FILTER 0x112 Double Changes the optical filter of camera lens functions.
Absolute Pan IMG1394_ATTR_ABSOLUTE_PAN 0x110 Double Controls the camera pan. The value is represented relative to 0.
Absolute Saturation IMG1394_ATTR_ABSOLUTE_SATURATION 0x107 Double Sets/gets the color saturation of the image. The value is represented relative to 100%.
Absolute Sharpness IMG1394_ATTR_ABSOLUTE_SHARPNESS 0x103 Double Sets/gets the sharpness of the image.
Absolute Shutter IMG1394_ATTR_ABSOLUTE_SHUTTER 0x109 Double Sets/gets the integration time of the incoming light. The value is represented in seconds.
Absolute Temperature IMG1394_ATTR_ABSOLUTE_TEMPERATURE 0x10D Double Gets the temperature inside the camera and/or control temperature.
Absolute Tilt IMG1394_ATTR_ABSOLUTE_TILT 0x111 Double Controls the camera tilt. The value is represented relative to 0.
Absolute Trigger Delay IMG1394_ATTR_ABSOLUTE_TRIGGER_DELAY 0x207 Double Sets/gets the internal delay between the incoming external trigger and the start of frame exposure. Absolute value in milliseconds.
Absolute White Balance IMG1394_ATTR_ABSOLUTE_WHITE_BALANCE 0x104 Double Sets/gets the adjustment of the white color of the image. The value is represented as Kelvin (K).
Absolute Zoom IMG1394_ATTR_ABSOLUTE_ZOOM 0x10F Double Controls the lens zoom. The value is represented relative to 1, which is on the wide end.
Acquisition in Progress Indicator IMG1394_ATTR_ACQ_IN_PROGRESS 0x125 int Read only. Gets the current state of the acquisition. TRUE if acquiring; otherwise FALSE.
Auto Exposure IMG1394_ATTR_AUTO_EXPOSURE 0x02 int Sets/gets reference level used by the camera to automatically control the exposure level. If set to Off, the exposure is controlled by the Gain, Iris, and/or Shutter attributes.
Available Bayer Pattern IMG1394_ATTR_COLOR_FILTER_INQ 0x209 int Read only. Gets the recommended Bayer pattern to use.
Base Address IMG1394_ATTR_BASE_ADDRESS 0x21D int Read only. Returns the base address of the camera command registers.
Bayer Gain (Blue) IMG1394_ATTR_COLOR_FILTER_GAIN_B 0x20D Double Sets/gets the white balance gain for the blue component of the Bayer conversion.
Bayer Gain (Green) IMG1394_ATTR_COLOR_FILTER_GAIN_G 0x20C Double Sets/gets the white balance gain for the green component of the Bayer conversion.
Bayer Gain (Red) IMG1394_ATTR_COLOR_FILTER_GAIN_R 0x20B Double Sets/gets the white balance gain for the red component of the Bayer conversion.
Bits Per Pixel IMG1394_ATTR_BITS_PER_PIXEL 0x12C int Sets/gets the actual bits per pixel. For 16-bit components, this represents the actual bit depth (10-, 12-, 14-, or 16-bit).
Brightness IMG1394_ATTR_BRIGHTNESS 0x01 int Sets/gets the black level of the image.
BufferNumber IMG1394_ATTR_LAST_TRANSFERRED_BUFFER_NUM 0x123 int Read only. Gets the last cumulative buffer number transferred.
Bus Transfer Speed IMG1394_ATTR_FORMAT7_SPEED 0x121 int Sets/gets the bus transfer speed for the acquisition. This attribute is read-only if the camera does not support Partial Image Size Format (Format 7).
Bytes per Pixel IMG1394_ATTR_BYTES_PER_PIXEL 0x28 int Read only. Get the number of bytes used for each pixel.
Camera Model Number IMG1394_ATTR_MODEL_ID 0x16 string Read only. Returns the model number.
Camera Serial Number IMG1394_ATTR_SERIAL_NO 0x15 string Read only. Return the serial number.
Current Bayer Pattern IMG1394_ATTR_COLOR_FILTER 0x20A int Sets/gets the Bayer pattern to use. The following values are possible:

IMG1394_COLOR_FILTER_NONE

IMG1394_COLOR_FILTER_GBGB_RGRG

IMG1394_COLOR_FILTER_GRGR_BGBG

IMG1394_COLOR_FILTER_BGBG_GRGR

IMG1394_COLOR_FILTER_RGRG_GBGB
Downshift 16-bit Images IMG1394_ATTR_SHIFT_PIXEL_BITS 0x127 int Sets/gets the flag to downshift the multibyte pixel data for 16-bit component acquisitions.
Focus IMG1394_ATTR_FOCUS 0x0C int Controls the lens focus.
FrameCount IMG1394_ATTR_FRAME_COUNT 0x124 int Read only. Gets the number of transferred frames.
Frame Interval IMG1394_ATTR_FRAME_INTERVAL 0x29 int Read only. Gets the expected duration, in milliseconds, of a frame acquisition.
Frame Rate IMG1394_ATTR_FRAME_RATE 0x206 int Sets/gets the frame rate priority within the current video mode.
Gain IMG1394_ATTR_GAIN 0x0A int Controls the camera circuit gain.
Gamma IMG1394_ATTR_GAMMA 0x08 int Defines the function between incoming light level and output image level.
Hue IMG1394_ATTR_HUE 0x06 int Sets/gets the color phase of the image.
Ignore First Frame IMG1394_ATTR_IGNORE_FIRST_FRAME 0x126 int Sets/gets the flag to ignore the first frame when starting an acquisition.
Image Height IMG1394_ATTR_IMAGE_HEIGHT 0x27 int Read only. Gets the height of the acquisition window.
Image Representation IMG1394_ATTR_IMAGE_REP 0x1A int Read only. Gets the image representation for the acquisition. The following values are possible:

IMG1394_IMAGEREP_DEFAULT

IMG1394_IMAGEREP_RAW

IMG1394_IMAGEREP_MONO8

IMG1394_IMAGEREP_MONO16

IMG1394_IMAGEREP_RGB32

IMG1394_IMAGEREP_RGB64
Image Width IMG1394_ATTR_IMAGE_WIDTH 0x26 int Read only. Gets the width of the acquisition window.
Iris IMG1394_ATTR_IRIS 0x0B int Controls the mechanical lens iris.
Max Bus Transfer Speed IMG1394_ATTR_FORMAT7_MAX_SPEED 0x20E int Read only. Gets the maximum bus transfer speed for the acquisition. Valid only if the camera supports Partial Image Size Format (Format 7).
Model Name IMG1394_ATTR_MODEL_NAME 0x14 string Read only. Returns the model name as a NULL-terminated string. You need to pass a pointer to a user-allocated buffer that is large enough to hold the string returned by the camera.
Nonstandard Bytes Per Packet IMG1394_ATTR_FORMAT7_BYTES_PER_PACKET 0x2A int Sets/gets the number of bytes transmitted per isochronous IEEE 1394 serial packet. Valid only if the camera supports Partial Image Size Format (Format 7).
Nonstandard Color Coding IMG1394_ATTR_FORMAT7_COLORCODING 0x25 int Sets/gets the color coding used for the current video format/mode. This attribute is read-only if the camera does not support Partial Image Size Format (Format 7). The following values are possible:

IMG1394_COLORID_DEFAULT

IMG1394_COLORID_MONO8

IMG1394_COLORID_YUV411

IMG1394_COLORID_YUV422

IMG1394_COLORID_YUV444

IMG1394_COLORID_RGB8

IMG1394_COLORID_MONO16

IMG1394_COLORID_RGB16

IMG1394_COLORID_SIGNED_MONO16

IMG1394_COLORID_SIGNED_RGB16

IMG1394_COLORID_RAW8

IMG1394_COLORID_RAW16
Nonstandard Height IMG1394_ATTR_FORMAT7_HEIGHT 0x24 int Sets/gets the height of the acquisition window. Valid only if the camera supports Partial Image Size Format (Format 7).
Nonstandard Left Offset IMG1394_ATTR_FORMAT7_LEFT 0x21 int Sets/gets the left edge of the acquisition window. Valid only if the camera supports Partial Image Size Format (Format 7).
Nonstandard Max Bytes Per Packet IMG1394_ATTR_FORMAT7_MAX_BYTES_PER_PACKET 0x12A int Read only. Gets the maximum number of bytes per packet. When defining the data transfer size, the size must not exceed this value. Valid only if the camera supports Partial Image Size Format (Format 7).
Nonstandard Top Offset IMG1394_ATTR_FORMAT7_TOP 0x22 int Sets/gets the top edge of the acquisition window. Valid only if the camera supports Partial Image Size Format (Format 7).
Nonstandard Unit Bytes Per Packet IMG1394_ATTR_FORMAT7_UNIT_BYTES_PER_PACKET 0x129 int Read only. Gets the minimum number of bytes per packet. When defining the data transfer size, the size must be a multiple of this value. Valid only if the camera supports Partial Image Size Format (Format 7).
Nonstandard Unit Height IMG1394_ATTR_FORMAT7_UNIT_HEIGHT 0x1D int Read only. Gets the height of the unit. Valid only if the camera supports Partial Image Size Format (Format 7). When defining a region of interest in Format 7, the height of the region must be a multiple of Unit Height.
Nonstandard Unit Width IMG1394_ATTR_FORMAT7_UNIT_WIDTH 0x1C int Read only. Gets the width of the unit. Valid only if the camera supports Partial Image Size Format (Format 7). When defining a region of interest in Format 7, the width of the region must be a multiple of Unit Width.
Nonstandard Width IMG1394_ATTR_FORMAT7_WIDTH 0x23 int Sets/gets the width of the acquisition window. Valid only if the camera supports partial scan mode.
Number of Lost Buffers IMG1394_ATTR_LOST_BUFFER_NB 0x20 int Read only. Gets the number of lost buffers during an acquisition session.
Optical Filter IMG1394_ATTR_OPTICAL_FILTER 0x12 int Changes the optical filter of camera lens function.
Packets Per Image IMG1394_ATTR_FORMAT7_PACKETS_PER_IMAGE 0x21B int Read only. Gets the number of packets transferred per image.
Pan IMG1394_ATTR_PAN 0x10 int Controls the camera pan.
ROI Height IMG1394_ATTR_ROI_HEIGHT 0x11E int Sets/gets the height of the region of interest. The region of interest must be a subset of the acquisition window.
ROI Left IMG1394_ATTR_ROI_LEFT 0x11B int Sets/gets the left edge of the region of interest. The region of interest must be a subset of the acquisition window.
ROI Top IMG1394_ATTR_ROI_TOP 0x11C int Sets/gets the top edge of the region of interest. The region of interest must be a subset of the acquisition window.
ROI Width IMG1394_ATTR_ROI_WIDTH 0x11D int Sets/gets the width of the region of interest. The region of interest must be a subset of the acquisition window.
Saturation IMG1394_ATTR_SATURATION 0x07 int Sets/gets the color saturation of the image.
Sharpness IMG1394_ATTR_SHARPNESS 0x03 int Sets/gets the sharpness of the image.
Shutter IMG1394_ATTR_SHUTTER 0x09 int Sets/gets the integration time of the incoming light.
Swap 16-bit Images Bytes IMG1394_ATTR_SWAP_PIXEL_BYTES 0x128 int Sets/gets the flag to swap the endianness of 16-bit cameras. Swap the pixel bytes if the camera returns little endian data.
Temperature IMG1394_ATTR_TEMPERATURE 0x0D int Gets the temperature inside the camera and/or control temperature.
Tilt IMG1394_ATTR_TILT 0x11 int Controls the camera tilt.
Time Out IMG1394_ATTR_TIMEOUT 0x1B int Sets/gets the timeout value used to abort an acquisition when the image transfer could not be done within the delay.
Trigger Delay IMG1394_ATTR_TRIGGER_DELAY 0x202 int Sets/gets the internal delay between the incoming external trigger and the start of frame exposure.
Unique ID Low IMG1394_ATTR_UNIQUE_ID_LOW 0x1E int Read only. Returns the low part of the 64-bit unique node ID of the 1394 camera associated with this session.
Unique ID High IMG1394_ATTR_UNIQUE_ID_HIGH 0x1F int Read only. Returns the high part of the 64-bit unique node ID of the 1394 camera associated with this session.
Vendor Name IMG1394_ATTR_VENDOR_NAME 0x13 string Read only. Returns the vendor name as a NULL-terminated string. You need to pass a pointer to a user-allocated buffer that is large enough to hold the string returned by the camera.
Video Format IMG1394_ATTR_VIDEO_FORMAT 0x17 int Sets/gets the video format; must be a value between 0 and 7. Use imaq1394GetVideoModes to get the format supported by the camera.
Video Frame Rate IMG1394_ATTR_VIDEO_FRAME_RATE 0x19 int Sets/gets the video frame rate; must be a value between 0 and 7. Use imaq1394GetVideoModes to get the frame rate supported by the camera.
Video Mode IMG1394_ATTR_VIDEO_MODE 0x18 int Sets/gets the video mode; must be a value between 0 and 7. Use imaq1394GetVideoModes to get the mode supported by the camera.
White Balance U IMG1394_ATTR_WHITE_BALANCE_U_B 0x04 int Sets/gets the adjustment of the U component of the white color of the image.
White Balance V IMG1394_ATTR_WHITE_BALANCE_V_R 0x05 int Sets/gets the adjustment of the V component of the white color of the image.
White Shading Compensation (Blue) IMG1394_ATTR_WHITE_SHADING_B 0x205 int Sets/gets the white shading compensation for the blue component of the image.
White Shading Compensation (Green) IMG1394_ATTR_WHITE_SHADING_G 0x204 int Sets/gets the white shading compensation for the green component of the image.
White Shading Compensation (Red) IMG1394_ATTR_WHITE_SHADING_R 0x203 int Sets/gets the white shading compensation for the red component of the image.
Zoom IMG1394_ATTR_ZOOM 0x0F int Controls the lens zoom.