Page 2
Data Translation, Inc. Information furnished by Data Translation, Inc. is believed to be accurate and reliable; however, no responsibility is assumed by Data Translation, Inc. for its use; nor for any infringements of patents or other rights of third parties which may result from its use.
Page 3
Changes or modifications to this equipment not expressly approved by Data Translation could void your authority to operate the equipment under Part 15 of the FCC Rules. Note: This product was FCC-Certified under test conditions that included use of shielded cables and connectors between system components.
What You Should Learn from this Manual This manual provides detailed information about the features of the DT3157 board and the DT3157 Device Driver to allow you to access the board’s capabilities using software. It is organized as follows: •...
About this Manual • Chapter “Troubleshooting,” describes the processes you must follow to program the DT3157 board using the DT-Open Layers Frame Grabber SDK and DT3157 SDK Extensions. • Chapter “Troubleshooting,” provides information that you can use to resolve problems with the board and the device driver, should they occur.
• DT3157 Getting Started Manual (UM-18308), included on the Imaging OMNI CD provided with the DT3157 board, describes how to set up, install, and wire signals to the DT3157 board, how to install the DT3157 software and DT3157 Device Driver, and how to verify the operation of the board.
Page 12
Additionally, it may be helpful to read other material in order to gain a better understanding of image processing concepts, algorithms, and their applications. Data Translation's Technical Support Department recommends the following resources for understanding image processing concepts, processing, and coding: Baxes, Gregory A.
Page 13
About this Manual Gonzalez, Rafael C., and Paul Wintz. Digital Image Processing. Menlo Park, CA: Addison-Wesley, 1987. Explains major image processing concepts and mathematical concepts involved in digital image manipulation, including FFT processing, filtering operations, geometric functions, histograms, and linear equalization. Held, Gilbert.
Page 14
About this Manual Pratt, William K. Digital Image Processing. Somerset, NJ: John Wiley & Sons, Inc., 1991. Detailed text on image processing, including morphological processing, feature extraction, image segmentation, and shape analysis. Reid, Christopher E. and Thomas B. Passin. Signal Processing in C. Somerset, NJ: John Wiley &...
Watkinson, John. The Art of Digital Video. Stoneham, MA: Focal Press, 1990. Provides an in-depth description of digital video fundamentals. Where to Get Help Should you run into problems installing or using the DT3157 board, our Technical Support Department is available to provide technical assistance. Refer to Chapter 5 for more information.
Chapter 1 Features The DT3157 frame grabber accepts video from digital input sources, and uses the host system's system memory to store images and the host system's display controller to display images. It is suitable for both image analysis and machine vision applications.
• DT3157 Device Driver − This software is provided on the Imaging OMNI CD, which is shipped with the board. You must install this device driver to use a DT3157 board with any of the supported software packages or utilities. Refer to the DT3157 Getting Started Manual for information on installing the device driver.
• EP-299 cable − The EP299 cable is for use with Kodak (and similar) digital cameras. The cable provides connection between the DT3157 and the camera’s 68-pin, D-shell connector. It also has a BNC connector at the camera end for connecting an external trigger, and a 9-pin, RS-232 connector at the board end for connecting other signals.
Principles of Operation Video Input Signals ........Sync Signals.
Page 22
Chapter 2 This chapter describes the features of the DT3157 board from a functional point-of-view. To aid the discussions in this chapter, refer to the block diagram of the DT3157, shown in Figure RS-422 Input Switch Input (8-16 Bits) Matrix...
• External trigger (described on page 10). Video Formats The DT3157 acquires digital images using the RS-422 format. The RS-422 interface consists of 19 differential receivers and five differential drivers. The RS-422 input functional block diagram is shown in Figure...
Enable Figure 2: RS-422 Interface Videos Input Channels The DT3157 board can accept 8-, 10-, 12-, 14-, or 16-bit monochrome video from one RS-422 differential digital input (single-channel mode) or 8-bit monochrome video from two RS-422 differential digital inputs (dual-channel mode).
(including the active pixels and blank pixels) by the length of the horizontal line (in time). Pixels are available to the DT3157 frame grabber board in increments of PixelPeriod, which is equal to 1 /pixel clock frequency.
By default, an external pixel clock is selected. External Trigger The DT3157 frame grabber provides pin 21 (External Trigger In) on connector J1 for connecting an external trigger input. Using an external trigger, you can synchronize frame acquisitions with external events.
Principles of Operation Input Look-Up Table An input look-up table (ILUT) allows you to change the value of an incoming pixel. When the ILUT gets an input pixel value, it retrieves the digital value of each 8-, 10-, 12-, 14-, or 16-bit pixel from the ILUT and passes the output value to the frame (region of interest).
Typically, the camera generates the sync signals, and the board locks to them. If this is not appropriate for your application, you can use Sync Master mode to set up the DT3157 board to generate the sync signals to drive one or more digital cameras, if desired. The video signal from the camera is then captured as usual, using the syncs generated by the board as the sync basis.
Page 29
Principles of Operation You can enable or disable Sync Master mode through software. When Sync Master mode is enabled, the horizontal sync output signals are output on pin 27 (Line Enable Out+) and pin 61 (Line Enable Out− ) of connector J1;...
• Horizontal sync search position − Defines the pixel location within a line at which the DT3157 board begins to search for the horizontal sync. The default value is 95.0% of the total pixels per...
Page 31
The default value is 50.0% of the total lines per field. • Vertical sync insert position − Defines the line location within a field at which the DT3157 board inserts a vertical sync if a vertical sync is not detected. The default value for the horizontal insert position is 115% of the total lines per field.
In addition to the sync output signals discussed on page 12, the DT3157 board generates the following output signals for controlling digital cameras: • RS-422 Pixel Clock Output Signals − Pixel Clock Out+ (pin 28) and Pixel Clock Out− (pin 62) on connector J1 are internally generated pixel clock signals that are output to the digital camera.
You can calculate the total lines per field as follows: horizontal frequency (kHz) Total lines per field ---------------------------------------------------------------- - vertical frequency (Hz) You can use software to define the total video area for the DT3157 frame grabber board. Table 1 lists the settings you can program.
Because the DT3157 deals with noninterlaced frames, this setting is also the Total Lines per Frame. Active Video Area The active video area floats in the total video area. The active video area is defined as that part of the incoming signal that contains valid video data (not blanking or sync information).
Note: The figure in this section represents an analog signal for illustration purposes. Your camera digitizes the signal and presents the digitized version of the signal to the DT3157 board. Note that the frame is an area that you establish within the active video area.
Table 2 lists the horizontal input settings you can program on the DT3157 board. Table 2: Horizontal Input Settings for DT3157 Nominal Setting Description Range...
Page 37
Note: The illustrations in this section represent an analog signal for illustration purposes. Your camera digitizes the signal and presents the digitized version of the signal to the DT3157 board. Note that the frame is an area that you establish within the active video area.
Chapter 2 Table 3: Vertical Input Settings for DT3157 Nominal Setting Description Range Values First Active Line The position of the first active 0 to 4095 lines video signal within the noninterlaced frame, as a line offset from the beginning of the vertical sync.
The width of the frame is the number of pixels per line of video. The height of the frame is the number of lines per field. Table 4 shows the settings you can program on DT3157 board to define the frame. Figure 6 illustrates these relationships.
Page 40
Chapter 2 Table 4: Frame Settings for the DT3157 Board Nominal Setting Description Range Values Frame Left The first pixel in the region 0 to 4095 pixels of interest, relative to the first active pixel, to capture. Frame Width The number of pixels per Single Channel: line of video to capture.
Figure 6: Spatial Relationship of Video Signal Types of Frames The DT3157 board can acquire noninterlaced frames only. The video signal is defined as a single field (or frame), where the start of each frame is identified by the falling edge of the vertical sync.
Chapter 2 Scaling Frames When using single-channel mode only, you can scale images by discarding pixels, lines, or both in software. This feature is useful if you want to reduce the size of an image. You provide the scale factor for the horizontal direction (range between pixels in the horizontal direction) and the vertical direction (range between lines in the vertical direction) separately.
Principles of Operation Frame Storage Mode The DT3157 board is capable of acquiring images with pixel sizes of 8, 10, 12, 14, and 16 bits. Any image with a pixel depth of greater than 8 bits requires two bytes of storage; the valid pixel data is stored right-justified within those two bytes.
Chapter 2 Passthru Modes In a passthru operation, the DT3157 board continuously captures and displays video data until you stop the operation. Typically, you use passthru to view images (in as close to real time as possible for the configuration and passthru method chosen) for the purpose of focusing or positioning the camera.
Principles of Operation Bitmap passthru mode requires a frame buffer in device memory into which the image is captured. Once the image is captured, functions in Windows perform bit copies of the image data to display memory. Functions in Windows handle obstructions to the passthru window by automatically clipping the passthru image to the visible client window region.
Chapter 2 Note: The passthru source origin can be set to start on any pixel, but due to a hardware limitation, the board must transfer a width of 8 pixels for a single channel and 32 pixels for dual channels after any scaling has been calculated.
Principles of Operation Passthru LUT It is assumed that the data passed to display memory is 8 bits/pixel. By default, passthru operations load the Windows system palette with 128 grayscale RGB values for display and use the default passthru LUT of 256 monotonically increasing grayscales. Using software, you can modify the 256-position passthru LUT so that false coloring is used.
DT3157 Device Driver Capabilities Because the Frame Grabber SDK is intended to be used with all DT-Open Layers frame grabbers, the DT3157 may not support all of the Frame Grabber SDK capabilities or may support the Frame Grabber SDK capabilities differently from other boards.
Page 53
Supported Device Driver Capabilities For capabilities Refer to the table that apply to ... starting on ... Overlay page 50 Memory page 51 Acquisition page 52 Digital I/O page 54 Note: If your code is intended to be compatible with various Data Translation products, use the query functions to determine that the capability is supported by the installed board, prior to execution.
Page 54
Chapter 3 Table 5: General Device Capabilities for the DT3157 Device Driver Capability DT3157 Support OlImgQueryDeviceCaps Device Signature OLC_IMG_DC_OL_SIGNATURE Ox44544F4C Device ID OLC_IMG_DC_DEVICE_ID 0x2B Device Name OLC_IMG_DC_DEVICE_NAME “DT3157” Device Type OLC_IMG_DC_OL_DEVICE_TYPE Monochrome Frame Grabber OLC_IMG_DEV_MONO_FRAME_GRABBER Color Frame Grabber OLC_IMG_DEV_COLOR_FRAME_GRABBER Sections Supported...
Page 55
Supported Device Driver Capabilities Table 5: General Device Capabilities for the DT3157 Device Driver (cont.) Capability DT3157 Support Dt3157QueryDigitalCameraType Camera type DT3157_DIGCAM_16BIT_INPUT 16 bits/pixel DT3157_DIGCAM_14BIT_INPUT 14 bits/pixel DT3157_DIGCAM_12BIT_INPUT 12 bits/pixel DT3157_DIGCAM_10BIT_INPUT 10 bits/pixel DT3157_DIGCAM_8BIT_SINGLE_CHANNEL_INPUT 8 bits/pixel DT3157_DIGCAM_8BIT_DUAL_CHANNEL_INPUT 8 bits/pixel (two...
Page 56
Chapter 3 Table 6: Input/Output Signal Capabilities for the DT3157 Device Driver (cont.) Capability DT3157 Support Supports Programmable A/D Query OLC_FG_IC_DOES_QUERY_PROG_A2D Voltage Range of Black Level, in µV OLC_FG_IC_BLACK_LEVEL_LIMITS Voltage Range of White Level, in µV OLC_FG_IC_WHITE_LEVEL_LIMITS Supports Programmable Pixel Clock...
Page 57
Supported Device Driver Capabilities Table 6: Input/Output Signal Capabilities for the DT3157 Device Driver (cont.) Capability DT3157 Support Multiple Trigger Modes OLC_FG_IC_MULT_TRIGGER_MODE_LIMITS Trigger Starts Multiple Frame Acquisition OLC_FG_MODE_START Trigger Starts Each Frame Acquisition OLC_FG_MODE_EACH Number of LUTs OLC_FG_ILUT_COUNT Maximum Index Number Allowed in each ILUT...
Page 58
Chapter 3 Table 7: Sync Signal Capabilities for the DT3157 Device Driver Capability DT3157 Support OlFgQueryInputCaps Supports Input Video Selection OLC_FG_IC_DOES_VIDEO_SELECT Supports Input Video Selection Query OLC_FG_IC_DOES_QUERY_VIDEO_SELECT Video Types OLC_FG_IC_VIDEO_TYPE_LIMITS Supports Composite Video Source OLC_FG_VID_COMPOSITE Supports Variable Scan Video Source...
Page 60
Chapter 3 Table 8: Active Video Area Capabilities for the DT3157 Device Driver DT3157 Support Capability Single Channel Dual Channel OlFgQueryInputCaps Supports Defining of Active Video Area OLC_FG_IC_DOES_ACTIVE_VIDEO Supports Active Video Area Query OLC_FG_IC_DOES_QUERY_ACTIVE_VIDEO Yes Range of Back Porch Start Position...
Page 61
Video controls are not supported due to the nature of digital video. b. The value for 8-bit, single-channel operations is 8. c. Because it operates in noninterlaced mode, the DT3157 is not field-based. The Total Lines per Field Control parameter represents total lines per frame.
Page 62
Chapter 3 Table 9: Frame Capabilities for the DT3157 Device Driver DT3157 Support Capability Single Channel Dual Channel OlFgQueryInputCaps Supports Frame Selection OLC_FG_IC_DOES_FRAME_SELECT Supports Frame Selection Query OLC_FG_IC_DOES_QUERY_FRAME_ SELECT Range of Frame Top Control OLC_FG_IC_FRAME_TOP_LIMITS min: 0 max: 4095 nominal: 0...
Page 63
Supported Device Driver Capabilities Table 9: Frame Capabilities for the DT3157 Device Driver (cont.) DT3157 Support Capability Single Channel Dual Channel Range Between Lines (Scale factor - vertical) OLC_FG_IC_FRAME_VINC_LIMITS min: 1 min: 1 max: 16 max: 1 nominal: 1 nominal: 1...
Page 64
Chapter 3 Table 10: Passthru Capabilities for the DT3157 Device Driver DT3157 Support Capability Single Channel Dual Channel OlFgQueryPassthruCaps Supports Passthru Section OLC_FG_PC_DOES_PASSTHRU Passthru Modes OLC_FG_PC_PASSTHRU_MODE_LIMITS Supports Sync Bitmap OLC_FG_PASSTHRU_SYNC_BITMAP Supports Async Bitmap OLC_FG_PASSTHRU_ASYNC_BITMAP Supports Sync Direct OLC_FG_PASSTHRU_SYNC_DIRECT Supports Async Direct...
Page 65
Supported Device Driver Capabilities Table 10: Passthru Capabilities for the DT3157 Device Driver (cont.) DT3157 Support Capability Single Channel Dual Channel Passthru Scaling OLC_FG_PC_DOES_SCALING Range of Legal Values for Height OLC_FG_PC_SCALE_HEIGHT_LIMITS min: 1 min: 2 max: 4096 max: 4096 nominal: 480...
Page 66
Chapter 3 Table 11: Overlay Capabilities for the DT3157 Device Driver Capability DT3157 Support OlFgQueryDDICaps Passthru with DDI OLC_FG_DDI_FAST_PASSTHRU Overlay support OLC_FG_DDI_OVERLAYS Translucent overlay capability OLC_FG_DDI_TRANSLUCENT_OVERLAYS Color overlay capability OLC_FG_DDI_COLOR_OVERLAY Multiple overlay surface capability OLC_FG_DDI_MULTIPLE_SURFACES Color keying (filtering) OLC_FG_DDI_COLOR_KEY_CONTROL Add overlay to image...
Page 67
Supported Device Driver Capabilities Table 12: Memory Capabilities for the DT3157 Device Driver Capability DT3157 Support OlFgQueryMemoryCaps Memory Types OLC_FG_MC_MEMORY_TYPES Volatile Memory OLC_FG_MEM_VOLATILE Nonvolatile Memory OLC_FG_MEM_NON_VOLATILE Number of Volatile Buffer Handles Device memory size OLC_FG_MC_VOL_COUNT divided by the maximum number of pixels in the...
Page 68
Chapter 3 Table 13: Acquisition Capabilities for the DT3157 Device Driver Capability DT3157 Support OlFgQueryInputCaps Acquisition Types OLC_FG_IC_SINGLE_FRAME_OPS -Single Frame to Host (sync) Supports Full Frame Acquisition OLC_FG_ACQ_FRAME Supports Subframe Acquisition OLC_FG_ACQ_SUBFRAME Supports Frame-to-Fit Acquisition OLC_FG_ACQ_FRAME_TO_FIT -Single Frame to Device (sync)
Page 69
Supported Device Driver Capabilities Table 13: Acquisition Capabilities for the DT3157 Device Driver (cont.) Capability DT3157 Support Acquisition Types (cont.) OLC_FG_IC_MULT_FRAME_OPS -Multiple Frames to Host (sync) Supports Full Frame Acquisition OLC_FG_ACQ_FRAME Supports Subframe Acquisition OLC_FG_ACQ_SUBFRAME Supports Frame-to-Fit Acquisition OLC_FG_ACQ_FRAME_TO_FIT -Multiple Frames to Device (sync)
Page 70
Digital I/O Configuration 0 to 255 a. The DT3157 supports eight digital I/O lines, each of which can be configured for input or output. Use the Dt3157QueryDigitalIOConfiguration function to determine the configuration of the digital I/O lines. Use the Dt3157QueryDigitalIO function to read from the digital input lines.
Supported Device Driver Capabilities Initialized Control Values Table 15 lists the default control values after opening or initializing the DT3157 Device Driver. Table 15: Default Control Values for the DT3157 Control Name Value OLC_FG_CTL_INPUT_FILTER OLC_FG_CTL_BLACK_LEVEL OLC_FG_CTL_WHITE_LEVEL OLC_FG_CTL_VIDEO_TYPE OLC_FG_VID_VARSCAN OLC_FG_CTL_CSYNC_SOURCE OLC_FG_CTL_CSYNC_THRESH...
Page 72
Chapter 3 Table 15: Default Control Values for the DT3157 (cont.) Control Name Value OLC_FG_CTL_ILUT Camera Type 8-bit, single 82 µs Exposure Duration Exposure Pulse Polarity 0 (logic high) Digital I/O Mask Sync Master Controls Horizontal Frequency 15,750 Hz Vertical Frequency...
Page 74
Chapter 4 The following flowcharts show the steps required to perform imaging operations using DT-Open Layers. For illustration purposes, the functions in the Frame Grabber SDK are shown; however, the concepts apply to all DT-Open Layers software. Many steps represent several substeps; if you are unfamiliar with the detailed operations involved with any one step, refer to the indicated page for detailed information.
Select input channel 0 (the default). OlFgSetInputVideoSource. Set the standard controls for the input source (see page 71). Set the DT3157 controls for the input source (see page 75). Write new values into the Input LUT Values range from 0 to 65,535.
Page 76
Chapter 4 Single-Frame Acquisition (cont.) Continued from previous page. Acquire to Perform an Allocate a user buffer with host asynchronous GlobalAlloc() using the GPTR flag. memory? acquire? Acquire the frame to host memory with OlFgAsyncAcquireFrameToHost. Acquire the frame to device memory with OlFgAsyncAcquireFrameToDevice.
Page 77
Programming Flowcharts Single-Frame Acquisition (cont.) Continued from previous page. Perform a Acquire to Allocate user buffer with GlobalAlloc() synchronous host using the GPTR flag. acquire? memory? Acquire the frame with OlFgAcquireFrameToHost. Acquire the frame to device memory with OlFgAcquireFrameToDevice. Process the acquired image (see page 76).
Select input channel 0 (the default). OlFgSetInputVideoSource. Set the standard controls for the input source (see page 71). Set the DT3157 controls for the input source (see page 75). Write new values into the Input LUT Values range from 0 to 65,535.
Page 79
Programming Flowcharts Multiple-Frame Acquisition (cont.) Continued from previous page. Create frame buffers with OlFgAllocateBuiltInFrame. Perform an Acquire frames to device memory with asynchronous OlFgAsyncAcquireMultipleToDevice. acquire? Check the status of the operation with OlFgAsyncAcquireJobDone. Acquire frames synchronously to device memory with OlFgAcquireMultipleToDevice.
Page 80
Chapter 4 Multiple-Frame Acquisition (cont.) Continued from previous page. Read the digital input lines with Dt3157QueryDigitalIO. Write to the digital output lines with Dt3157SetDigitalIO. Release each frame buffer with OlFgDestroyFrame. Close the device using OlImgCloseDevice.
Select input channel 0 (the default). OlFgSetInputVideoSource. Set the standard controls for the input source (see page 71). Set the DT3157 controls for the input source (see page 75). Write new values into the Input LUT Values range from 0 to 65,535.
Page 82
Chapter 4 Passthru without Overlays (cont.) Continued from previous page. The default height is 480; the default width Scale passthru image with is 640. OlFgSetPassthruScaling. Start the passthru operation (see page 79). Values range from 0 to 255. Change the passthru LUT (see page 80).
Programming Flowcharts Passthru with Overlays Open the device and get the device ID with OlImgOpenDevice. Set the timeout period with OlImgSetTimeoutPeriod. Choose an input source with Select input channel 0 (the default). OlFgSetInputVideoSource. Set the standard controls for the input source (see page 71).
Page 84
Chapter 4 Passthru with Overlays (cont.) Continued from previous page. Scale passthru image with The default height is 480; the default width is 640. OlFgSetPassthruScaling. Create a surface for each overlay with OlFgCreateSurface. Get a surface DC with OlFgGetSurfaceDC. Draw an image on the surface with standard GDI functions.
Page 85
Programming Flowcharts Passthru with Overlays (cont.) Continued from previous page. Enable overlay before Set up and enable overlays passthru (see page 82). starts? Start a passthru operation (see page 79). Start a passthru operation (see page 79). Set up and enable overlays (see page 82).
Page 86
Chapter 4 Passthru with Overlays (cont.) Continued from previous page. Stop asynchronous passthru with OlFgStopAsyncPassthru; stop synchronous passthru with a mouse or keyboard event. Disable overlays with OlFgEnableOverlays. Read the digital input lines with Dt3157QueryDigitalIO. Write to the digital output lines with Dt3157SetDigitalIO.
Page 87
Programming Flowcharts Set the Standard Controls for the Input Source Set the video type with Use the key OLC_FG_CTL_VIDEO_TYPE to select a variable-scan video input. OlFgSetInputControlValue. Use the key OLC_FG_CTL_VARSCAN_FLAGS Set the sync transitions with to select horizontal and vertical sync transitions. OlFgSetInputControlValue.
Page 88
Chapter 4 Set the Standard Controls for the Input Source (cont). Continued from previous page. Use the key OLC_FG_CTL_FIRST_ACTIVE_ Set the first active pixel with PIXEL to set the first active pixel on the line. The default OlFgSetInputControlValue. is 4. Use the key OLC_FG_CTL_ACTIVE_PIXEL_COUNT to set the number of pixels per line in the active video area.
Page 89
Programming Flowcharts Set the Standard Controls for the Input Source (cont). Continued from previous page. Use the key OLC_FG_CTL_FRAME_TOP to set the Set the top of the frame with first line of video, relative to the active video area, to OlFgSetInputControlValue.
Page 90
Chapter 4 Set the Standard Controls for the Input Source (cont). Continued from previous page. For single-channel mode, use the key Set the horizontal frame increment OLC_FG_CTL_HOR_FRAME_INC to set the with OlFgSetInputControlValue. horizontal scale factor. For dual-channel mode, this value must be 1. The default is 1. For single-channel mode, use the key Set the vertical frame increment OLC_FG_CTL_VER_FRAME_INC to set the...
Page 91
Programming Flowcharts Set the DT3157-Specific Controls Specify the camera type with The default is 8-bit, single channel. Dt3157SetDigitalCameraType. Reset the camera with Dt3157ResetCamera. Using Disable Sync Master mode with Sync Master Dt3157EnableSyncMasterMode. mode? Set the Sync Master control values with Dt3157SetSyncMasterControlValue.
Page 92
Chapter 4 Process the Acquired Image Read From/to data from a rectangular frame buffer Copy pixel data to a frame region in in device buffer with frame memory? OlFgCopyFrameRect. buffer? From a Copy pixel data contiguously rectangular to a user buffer with region to a OlFgReadFrameRect.
Page 93
Programming Flowcharts Process the Acquired Image (cont.) Continued from previous page. From/to Write data a rectangular to frame buffer Copy pixel data to a frame buffer region in in device with OlFgCopyFrameRect. frame memory? buffer? From a Write pixel data to a rectangular user buffer to region in a frame buffer with a rectangular...
Page 94
Chapter 4 Process the Acquired Image (cont.) Continued from previous page. image to Map the frame to application’s virtual application address space with OlFgMapFrame. memory? Manipulate/process image using your own functions. Unmap the frame buffer with OlFgUnmapFrame. Return to main flowchart.
Page 95
Programming Flowcharts Start the Passthru Operation Mode Get a single frame ID with OlFgAllocateBuiltInFrame. Perform an asynchronous Start the passthru with bitmap OlFgStartAsyncPassthruBitmap. passthru? Start the passthru with OlFgStartSyncPassthruBitmap.
Page 96
Chapter 4 Change the Passthru LUT Load monochrome Load default grayscale values with values in OlFgLoadDefaultPassthruLUT. passthru LUT? Load Load RGBTRIPLE values with color values OlFgLoadPassthruLUT. in passthru LUT? Extend Add colors to palette with passthru OlFgExtendPassthruPalette. palette?
Page 97
Programming Flowcharts Take a Snapshot Create a frame buffer with OlFgAllocateBuiltInFrame. Acquire the image with OlFgPassthruSnapShot. Add overlay Add overlay to the snapshot with OlFgAddOverlayToFrame. snapshot? Process the acquired image (see page 76).
Page 98
Chapter 4 Set up and Enable Overlays Set the visible surface with OlFgSetVisibleSurface. Set the source keying color with OlFgSetOverlayColorKey. Toggle the overlay’s translucence with OlFgSetTranslucentOverlay. Enable overlays with OlFgEnableOverlays.
Page 99
Programming Flowcharts Execute an Overlay Animation Sequence Get a handle to a WIN32[event] synchronization object with OlFgGetPassthruSyncEvent. Get a surface DC to surface #1 with OlFgGetSurfaceDC. Draw an image on surface #1 with standard GDI functions. Release the surface #1 DC with OlFgReleaseSurfaceDC.
Chapter 5 General Checklist Should you experience problems using the DT3157 board, please follow these steps: Read all the documentation provided for your product. Make sure that you have added any “Read This First” information to your manual and that you have used this information.
Page 103
Symptom Possible Cause Possible Solution Board does not The board is Check that the slot in which your DT3157 respond. incorrectly aligned in board is located is a PCI slot and that the a PCI expansion slot. board is correctly seated in the slot; see the instructions in the DT3157 Getting Started Manual.
Page 104
DT3157 Getting Started Manual. Computer does Board is not seated Check that the slot in which your DT3157 not boot. properly. board is located is a PCI slot, that the board is correctly seated in the slot, and that the board is secured in the slot with a screw;...
Page 105
Possible Cause Possible Solution System lockup. Board is not seated Check that the slot in which your DT3157 properly. board is located is a PCI slot, that the board is correctly seated in the slot, and that the board is secured in the slot with a screw;...
Refer to the Data Translation Support Policy located at the end of this manual for a list of services included and excluded in our standard support offering.
Page 107
If you are located outside the USA, call your local distributor. The name and telephone number of you nearest distributor are provided in your Data Translation catalog. If you are leaving a message to request a support call, please include the following information: •...
Page 108
Address: _________________________________________________________________________ ________________________________________________________________________________ Data Translation hardware product(s): __________________________________________________ serial number: _________________________________________________________________ configuration: _________________________________________________________________ Data Translation device driver - SPO number: ___________ ________________________________ _______________________________________________ version: _________________________ Data Translation software - SPO number:_______________ ________________________________ serial number: ________________________________ version:__________________________ PC make/model: ___________________________________________________________________ operating system: _____________________________ version:__________________________...
Troubleshooting E-Mail and Fax Support You can also get technical support by e-mailing or faxing the Technical Support Department: • E-mail: You can reach Technical Support at the following address: tsupport@datx.com Ensure that you provide the following minimum information: − Your name, −...
Chapter 5 If Your Board Needs Factory Service If your board must be returned to Data Translation, perform the following steps: Record the board’s serial number, then contact the Customer Service Department at (508) 481-3700 (if you are in the USA) and obtain a Return Material Authorization (RMA).
Page 112
− HIGH Level Output Voltage 2.4 V − LOW Level Output Voltage 0.5 V Table 18 lists the DT3157 board’s digital input electrical specifications for signals DIG_IO0 to DIG_IO7. Table 18: Digital Input Electrical Specifications Symbol Parameter Minimum Maximum Input HIGH Level 2.0 V...
Page 113
Specifications Table 19 lists the DT3157 board’s differential output electrical specifications for signals Frame Enable Out, Line Enable Out, Pixel Clock Out, and Expose. Table 19: Differential Output Electrical Specifications Symbol Parameter Minimum Maximum − − HIGH Level Output Current 20 mA −...
Page 114
Appendix A Table 21 lists the power, physical, and environmental specifications. Table 21: Power, Physical, and Environmental Specifications Features Specifications Power (+5 V) 1.8 A (typical) Dimensions 6.875” (L) x 4.2” (H) (not including faceplate and connectors) Weight 6.4 ounces (181.4 grams) Operating Temperature Range 0 to 50°...
Page 116
Appendix B The video input connector, J1, on the DT3157 is a SCSI-II 68-pin, subminiature 'D' shell connector that accepts the digital input signals using cables from Data Translation or cables that you design. Figure 7 illustrates the J1 connector pin orientation.
Page 118
Appendix B Table 22: J1 Connector Pin Assignments (cont.) Signal Name Signal Name − Reset Out (+) Reset Out ( − Frame Enable Out (+) Frame Enable Out ( − Frame Enable In (+) Frame Enable In ( − Line Enable In (+) Line Enable In ( −...
Adding a Board to the Device Driver Configuration after System Startup To add a new board to the DT3157 Device Driver configuration after system startup, perform the following steps: If you have not already done so, install the additional board in...
Page 121
When the system restarts, the driver configuration dialog box appears. 14. Click OK, then click OK. 15. Click Add New to add a DT3157 board to the configuration. The DT3157 Installation dialog box appears for the new board. 16. Enter a board name (alias), which can be any name you choose, then click Add.
Actual Memory Size text box when you restart your system. 20. Click Done. The DT3157 Device Driver Configuration dialog box is redisplayed; you can see the name of the board you just added. 21. Click Close to end the DT3157 configuration.
Page 123
Click Use this Media Control device, then click Settings. The DT3157 Device Driver Configuration dialog box appears. Select the name of the DT3157 board that you want to modify. Click Modify to modify the board. The DT3157 Configuration dialog box appears.
For proper operation, it is very important that you restart Windows. Uninstalling the Device Driver Generally, you will always require the DT3157 Device Driver. However, if you are no longer using the DT3157 board with the supported software, you can uninstall the DT3157 Device Driver from the system.
114). Adding a Board to the Device Driver Configuration To add a board to the DT3157 Device Driver configuration, perform the following steps: If you have not already done so, install the additional board in your computer following the instructions in the DT3157 Getting Started Manual, then power up your computer and any attached peripherals.
Page 126
Click Disable the device, then click Finish. Open the Control Panel. Double-click Sounds and Multimedia. Click the Hardware tab. 10. Click DT3157 MACH Series Frame Grabber, then click Properties. 11. Click the Properties tab. 12. Double-click Multimedia Drivers. 13. Click DT3157 MACH Series Frame Grabber, then click Properties.
22. Click Restart Now to restart your system. Modifying a Board in the Device Driver Configuration To modify the board settings in the DT3157 Device Driver configuration, perform the following steps: Open the Control Panel. Double-click Sounds and Multimedia.
Page 128
Actual Memory Size text box when you restart your system. 13. Click Done. The DT3157 Device Driver Configuration dialog box reappears with the name of the board you just modified. 14. Click Close.
Click Settings. Select the name of the board that you want to remove, then click Remove. 10. Repeat step 9 until all the DT3157 boards you want to remove are removed. 11. Click Close. The Drivers dialog box appears. The DT3157 Device Driver is still installed in the system, but the board has been removed.
Generally, you will always require the DT3157 Device Driver. However, if you are no longer using the DT3157 board with the supported software, you can uninstall the DT3157 Device Driver from the system by performing the following steps: Open the Control Panel.
120). Adding a Board to the Device Driver Configuration To add a board to the DT3157 Device Driver configuration, perform the following steps: If you have not already done so, install the additional board in your computer following the instructions in the DT3157 Getting Started Manual, then power up your computer and any attached peripherals.
Page 132
16. Click Add New to add a DT3157 board to the configuration. The DT3157 Installation dialog box appears for the new board. 17. Enter any unique name (or alias) for the DT3157 board, then click Add. Only one alias per installed board is allowed.
Actual Memory Size text box when you restart your system. 21. Click Done. The DT3157 Configuration dialog box is redisplayed; you can see the name of the board you just added. 22. Click Close to finish.
Page 134
Actual Memory Size text box when you restart your system. 14. Click Done. The DT3157 Device Driver Configuration dialog box reappears with the name of the board you just modified. 15. Click Close.
Click Settings. 10. Select the name of the board that you want to remove, then click Remove. 11. Repeat step 10 until all the DT3157 boards you want to remove are removed. 12. Click Close. The Drivers dialog box appears. The DT3157 Device Driver is still installed in the system, but the board has been removed.
Generally, you will always require the DT3157 Device Driver. However, if you are no longer using the DT3157 board with the supported software, you can uninstall the DT3157 Device Driver from the system by performing the following steps: Open the Control Panel.
DT3157 specific input source active video area active video query setting for the input source adding a board to the driver conventions used configuration...
Page 138
Index Windows Me procedures Windows XP procedures e-mail support DT3157_DIGCAM_10BIT_INPUT EP-299 cable DT3157_DIGCAM_12BIT_INPUT EP-300 cable DT3157_DIGCAM_14BIT_INPUT EP-301 cable DT3157_DIGCAM_16BIT_INPUT external clock DT3157_DIGCAM_8BIT_DUAL_ external pixel clock CHANNEL_INPUT external trigger DT3157_DIGCAM_8BIT_SINGLE_ CHANNEL_INPUT DT3157_SYNC_CTL_HORIZ_FREQ factory service DT3157_SYNC_CTL_HPULSE_ false coloring WIDTH fax support DT3157_SYNC_CTL_PHASE first active line DT3157_SYNC_CTL_VERT_FREQ first active pixel...
Page 139
Index help lines horizontal first active frequency number per field sync pulse width range between sync signal total per field horizontal video signal look-up table host memory input passthru ILUTs index number maximum passthru LUT value maximum value memory image processing device input look-up tables host...
Page 140
Index number of OLC_FG_CTL_VSYNC_INSERT_POS digital input lines digital output lines OLC_FG_CTL_VSYNC_SEARCH_ OLC_FG_DDI_COLOR_KEY_ CONTROL OLC_FG_ACQ_FRAME OLC_FG_DDI_COLOR_OVERLAY OLC_FG_CLOCK_EXTERNAL OLC_FG_DDI_FAST_PASSTHRU OLC_FG_CLOCK_INTERNAL OLC_FG_DDI_MULTIPLE_ OLC_FG_CTL_ACTIVE_LINE_ SURFACES COUNT OLC_FG_DDI_OVERLAYS OLC_FG_CTL_ACTIVE_PIXEL_ OLC_FG_DDI_PASSTHRU_SYNC_ COUNT EVENT OLC_FG_CTL_CLOCK_FREQ OLC_FG_DDI_TRANSLUCENT_ OLC_FG_CTL_CLOCK_SOURCE OVERLAYS OLC_FG_CTL_FIRST_ACTIVE_LINE OLC_FG_FRM_NON_INTERLACED OLC_FG_CTL_FIRST_ACTIVE_ OLC_FG_IC_ACTIVE_HEIGHT_ PIXEL LIMITS OLC_FG_CTL_FRAME_HEIGHT OLC_FG_IC_ACTIVE_LINE_LIMITS OLC_FG_CTL_FRAME_LEFT OLC_FG_CTL_FRAME_TOP OLC_FG_IC_ACTIVE_PIXEL_LIMITS OLC_FG_CTL_FRAME_WIDTH...
Page 143
Index OlFgStopAsyncPassthru modifying value OlFgUnmapFrame number per line OlFgWriteContiguousPixels per frame OlFgWriteFrameRect range between OlFgWriteInputLUT total number per line OlFgWritePixelList total per line OlImgCloseDevice pixel clock OlImgOpenDevice external OlImgQueryDeviceCaps internal OlImgQueryInputCaps pixel clock query programming flow diagrams OlImgSetTimeoutPeriod multiple frame acquisition passthru with overlays origin, source passthru without overlays...
Page 144
Index service and support procedure sync signals setting the input controls sync source single frame acquisitions synchronous acquisition to device, asynchronous synchronous bitmap passthru to device, synchronous to host, asynchronous to host, synchronous technical support source origin e-mail x values y limits telephone specifications...
Page 145
Index uninstalling the device driver Windows Me variable scan video source adding a board to the driver variable Sync Sentinel type configuration VCRs modifying a board in the driver vertical configuration frequency uninstalling the device driver sync pulse width Windows XP sync signal adding a board to the driver video signal...
Page 147
CUSTOMER SERVICE POLICY charge, any defective component part of such products. a. Data Translation, Inc. will repair or replace, at its option, any faulty item within ten days after receipt EFFECTIVE PERIOD OF WARRANTY of said part regardless of its warranty status.
Page 149
Data Translation, Inc. (Data Translation) offers used with the Licensed Processors: support upon the following terms and conditions at prices published by Data Translation from time to (a) problem reporting, tracing and monitoring by time. Current price information is available from internet electronic mail;...
Page 150
Data Translation's by either party upon thirty (30) days prior written then current rates (Specialized Application Support notice to the other party.
Page 151
Data Translation. Pursuant to Section 2.4 of the Agreement, the Support Fee will also be adjusted in accordance with Data Translation's then current fee schedule as additional Licensed Processors are added. Support Fees do not include travel and living...