Phytec eGrabber-4plus Hardware Manual Download

Page: 179 / 206

Driver Software



PHYTEC Meßtechnik GmbH 2004 L-608e_4

169

Setting of the color saturation

void Set_Saturation(unsigned short nDevNo,

unsigned short nSat_U,
unsignedshort nSat_V);

nSat_U: Saturation of the U-color portion (0..511, Default = 254)
nSat_V: Saturation of the V-color portion (0..511, Default = 180)

Reading the content of the registers for color saturation

unsigned short Get_Sat_U(unsigned short nDevNo);
unsigned short Get_Sat_V(unsigned short nDevNo);

return value: value of the actual U- or V-color saturation resp.

Correction of the hue (NTSC only)

void Set_Hue(unsigned short nDevNo, short nHue);

nHue: hue, phase position of the color signal (-128..127)

Reading the content of the registers for hue

short Get_Hue(unsigned short nDevNo);

return value: value of the phase position of the color signal

De/activation of the luma-low-pass-filter

void Set_LDec(unsigned short nDevNo,

unsigned short nOn,
unsigned short nHFilt);

nOn:

1 = Luma decimation on
0 = Luma decimation off

nHFilt:0

0 = automatic filter selection
1 = CIF filter
2 = QCIF filter
3 = ICON filter

Summary of Contents for eGrabber-4plus

Page 1: ...A product of a PHYTEC Technology Holding company eGrabber 4plus Hardware Manual Edition June 2004 ...

Page 2: ...TEC Meßtechnik GmbH offers no guarantee nor accepts any liability for damages arising from the improper usage or improper installation of the hardware or software PHYTEC Meßtechnik GmbH further reserves the right to alter the layout and or design of the hardware without prior notification and accepts no liability for doing so Copyright 2004 PHYTEC Meßtechnik GmbH D 55129 Mainz Rights including tho...

Page 3: ...e Input Voltage 25 1 10 2 Output Supply Voltage 26 1 10 3 Supply Voltage Options 28 1 11 Device Selector 30 1 12 Notes on CE Conformance and Immunity Against Interference 31 2 Installation of the Grabber Card 33 2 1 Installing the Grabber Card 33 2 2 Supply Voltage 35 2 3 Installing the Driver 37 2 3 1 Additional Drivers Optional 41 2 4 Installing the Demo Program 42 3 Connecting Video Sources 43 ...

Page 4: ...ements 86 5 2 2 Installation of the VxD Driver Windows 95 87 5 2 3 Application of the Device Driver for Windows NT4 0 90 5 2 4 Application of the Device Driver for Windows 98 TM and Windows 2000 93 5 2 5 Application of the DLL 94 5 2 6 Application of the Windows 95 98TM Windows NT4 0TM Windows 2000TM DLL 95 5 2 7 Programming under Delphi 96 5 2 8 Description of the DLL in Existing Functions 98 5 3...

Page 5: ...12 Connecting the Supply Voltage Output X302 26 Figure 13 JP301 5 V on PC 104 Bus Connector 28 Figure 14 JP301 12 V on PC 104 Bus Connector 28 Figure 15 Connector Field X301 29 Figure 16 Jumper Settings of the Device Selector JP201 30 Figure 17 Jumper Settings JP201 Slot Selection 33 Figure 18 Pin Out of the Supply Voltage Input 35 Figure 19 Supply Voltage Output 36 Figure 20 PHYTEC Installation M...

Page 6: ...igure 40 Fields and Frames 77 Figure 41 Moving Objects Cause Comb Effects 77 Figure 42 Pixel and Control Data Flow Overview 82 Figure 43 Directory for Window Driver s New Image 85 Figure 44 Windows 95 Registry New Image 88 Figure 45 Adding a VxD Entry New Image 88 Figure 46 Configuration of the VxD New Image 89 Figure 47 Windows NT Registration Editor 91 Figure 48 Entering a Device Driver New Imag...

Page 7: ... 5 I O Pin Connections on Pin Header Rows X3 and X6 16 Table 6 Connecting the I C interface to Pin Header Rows X3 X6 18 Table 7 Pin Assignment for the Option Port 19 Table 8 Supply Voltage Output 20 Table 9 Options for the Supply Voltage Output X3 Pin 25 20 Table 10 Allowed Input Voltages EPC 032 X2 25 Table 11 Pinout of Socket X303 27 Table 12 Required Memory Space of One Pixel for the Different ...

Page 8: ...eGrabber 4plus PHYTEC Meßtechnik GmbH 2004 L 608e_4 ...

Page 9: ...Part 1 Installation and Start Up PHYTEC Meßtechnik GmbH 2004 L 608e_4 Part 1 Installation and Start Up ...

Page 10: ...eGrabber 4plus PHYTEC Meßtechnik GmbH 2004 L 608e_4 ...

Page 11: ...s Refer to the documentation included with the eGrabber 4plus to see which model you have This will enable you to achieve optimal settings for your Framegrabber card The eGrabber 4plus includes the following upon delivery eGrabber 4plus board in PC 104 plus format Installation CD with m Demo software Windows 95 98 ME XP NT4 0 and Windows 2000 m Driver library for DOS with DOS4GW m Driver software ...

Page 12: ...MB to BNC connector cable for connection of a color camera with BNC plug length aprox 2 m Order number WK023 S Video connector cable for connection of a color camera with a 4 pin Mini DIN plug S Video output length aprox 2 m Order number WK051 Replacement fuse 2A T TR5 power supply receptacle F1 Order number KF012 Figure 1 Accessory Cables ...

Page 13: ...0 mA digitizing taken from the PCI bus Inputs 3 or 9 depending on the model see section 1 5 1 Composite video inputs 75 Ω 1 Vss 1 S Video input 75 Ω 0 7 Vss 0 3 Vss Video Format PAL B G H I NTSC M or corresponding CCIR monochrome format Synchronization Composite sync or sync to Y signal external synchronization is not possible Data Format 16 Mio colors RGB32 RGB24 YcrCb 4 2 2 YcrCb 4 1 1 64 000 co...

Page 14: ... 20 ms Full frame 40 ms Image transfer to the main memory in real time Bus master transfer Used Resources 4 kByte main memory register field INTA Image control Gamma correction selectable Brightness 50 Contrast 0 235 Color saturation U 0 201 V 0 283 Hue 90 only with NTSC Image Storage 630 Byte FIFO on board Real time storage in the PC main memory Even odd field memory separated or Common full fram...

Page 15: ...put Low Voltage VIL 0 5 V 0 5 V Output High Voltage VOH 5 V 25 V Output Low Voltage VOL 0 V 1 4 V Input Low Current IIL 700 uA Input High Current IIH 70 uA Output HiZ Current IOZ 500 uA Output On Current IOON 800 mA Switching frequency fIO 200 Hz 1 I2 C interface Master Parameter Symbol Min Max Transmission rate 1 fI2C 99 2 kHz 396 8 kHz Input High Voltage VIH 3 5 V 5 V Input Low Voltage VIL 0 5 V...

Page 16: ...put Level 22 W max Shut down electronic TTL Signal Connectors 2 SMB Sockets X1 Composite Channel 1 X2 Composite Channel 2 26 pin male connector Composite channel 1 3 EPC 032 X1 channels 1 9 S Video chroma signal luma on Composite 9 1 I C interface 1 supply voltage output 1 5 A max 1 I 0 connector transistor operated Mini DIN socket X4 1 S Video input Male Connector 2x10 X6 GPIO Port 12 x TTL I O 1...

Page 17: ...agraph Models EPC 032 and EPC 032 X1 X2 supplemental Supply Voltage Socket X300 PC Floppy socket connector 3 5 for connection of supply voltage 8 28 VDC when using the 12 V output 15 28 V 3 pin removable screw clamp X302 Supply voltage output 5 V 2 A 12 V 1 A 8 pin male connector X303 optional Supply voltage for Jumptec MOPS CPU card removable Socket Connector X301 optional Shutdown connector for ...

Page 18: ...o the access time specified for the PCI master slot The effective transfer rate must be re oufficient to handle the volume of the image data otherwise information might be lost The eGrabber 4plus is intended for use in PC 104 plus systems The eGrabber 4plus has to be plugged into a master PCI slot When assembling the PC 104 plus system and installing the housing applicable CE norms must be taken i...

Page 19: ...s occupies a region of 4 kBytes in the main memory of the PC for the local registers The addressing region is automatically specified by the PCI BIOS and no hardware wiring jumper setting is required Only the position of the card in the PC 104 plus system has to be set with the help of Jumper JP201 see section 2 1 Up to three eGrabber 4plus can be installed in a single system Several eGrabber 4plu...

Page 20: ... operational status Since the Grabber is only a single function device only the interrupt line INTA of the PCI bus can be used To this PCI bus interrupt an interrupt of the PC is allocated via the BIOS so that the program can react to this event The source of the interrupt can be determined from the interrupt status register of the Grabber Caution Since several boards can trigger the same interrup...

Page 21: ...e Grabber s connectors is intended only as a technical reference A detailed description of the start up of corresponding connections and connector cables can be found in section 2 The contents of section 1 5 are not relevant during the initial start up ü present on all modules þ only X2 models Figure 2 eGrabber 4plus Connectors ...

Page 22: ...end out to the 26 pin header row X3 ê Caution It is not possible to use both connector options simultaneously Version EPC 032 X1 EPC 032 X1 X2 The Grabber makes available nine composite inputs Channels 1 and 2 extend to the SMB sockets å and All nine channels extend out to the 26 pin header connector X3 ê Caution It is not possible to use both connector options simultaneously In addition to the co...

Page 23: ...ow X3 ê Socket Function Pin Function X1 å Composite 1 1 Composite 1 X2 Composite 2 2 Signal Ground 3 Composite 2 4 Signal Ground 5 Composite 3 6 Signal Ground 7 8 9 10 11 12 13 14 15 16 17 S Video LUMA 18 19 S Video CHROMA 20 Signal Ground 21 I2 C Bus SDA 22 I2 C Bus SCL 23 Signal Ground 24 Signal Ground 25 Pwr Supply out 26 I O Pin Table 2 Pin Assignments of the SMB Sockets and Pin Header Rows Mo...

Page 24: ... 11 Composite 6 12 Signal Ground 13 Composite 7 14 Signal Ground 15 Composite 8 16 Signal Ground 17 Composite 9 and S Video LUMA 18 Signal Ground 19 S Video CHROMA 20 Signal Ground 21 I2 C Bus SDA 22 I2 C Bus SCL 23 Signal Ground 24 Signal Ground 25 Pwr Supply out 26 I O Pin Table 3 Pin Assignments of the SMB Sockets and Pin Header Rows Models EPC 032 X1 EPC 032 X1 X2 PHYTEC offers connector cable...

Page 25: ...using an S Video cable An S Video camera can be connected the 26 pin socket connector X3 ê The S Video chromatic signal is connected to Pin 19 One of the composite inputs is used to feed in the S Video luma signal brightness for models with 9 channels this is channel 9 for models with 3 channels it is channel 3 On all models this signal extends to Pin 17 on X3 If you choose to procure your own cor...

Page 26: ...input can be called from the program and is not connected to any special functions When using the function as output the user program is able to convey control signals to other devices The Output can be set or cleared by the program I O Pin Functions Input An external voltage against Ground can be connected to the I O pin If the voltage is between 0 V and 5 V then the program receives a 0 If the v...

Page 27: ... the program sets the pin to logic 0 then the transistor is disabled and thus there is no connection between pin 26 or Pin 15 and Ground In order to use the output an external power supply in the range of 5 V and 28 V is required It is also possible to use the power supply pin pin 25 of X3 for power supply Figure 3 and Figure 4 depict two possible connections a Connection from the Grabbers power s...

Page 28: ...devices must have an I C interface operating in Slave mode The I C interface is available at pin header row X3 and is also available on the internal pin header row of the Option Port X6 also see section 1 8 It is possible to connect multiple I C devices to the bus but these devices must be distinguished by their device addresses Table 6 shows the relevant pin assignment of the pin header rows Pin ...

Page 29: ...ser The signals are routed to a connector with 10 x 2 pins The connector is denoted as X6 ô Figure 5 shows the assignment of the pins Note The current drawn out of pin 1 5V may not exceed 100 mA Figure 5 Pin Formation of the Option Port Option Port X6 pin function pin function pin function 1 5V out 8 I O 6 15 I O Pin 2 I O0 9 I O 7 16 I O Clk 3 I O1 10 I O 8 17 I C SCL 4 I O2 11 I O 9 18 I C SDA 5...

Page 30: ...Ground 25 Supply Voltage Table 8 Supply Voltage Output With the removable jumper JP301 you can select between different supply voltage options Please note that some options are only possible with certain Grabber types Overview of Options Model Supplying X3 25 Jumper JP301 EPC 032 and EPC 032 X1 EPC 032 and EPC 032 X2 Input Voltage X300 l l 12 V from PCI Bus l 5 V from PCI Bus l 12 V form integr ad...

Page 31: ...or protection against reverse polarity along with a circuit breaker SI301 2 A Caution In this configuration the voltage at Pin 25 corresponds to the voltage of the power supply device Take this into consideration when connecting external units to this pin Under no circumstances should the voltage connected to socket X300 exceed 28 V The current draw must not exceed 1 5 A The output is protected by...

Page 32: ... The expressed maximum current draw of 500 mA should not be exceeded Note This option functions only if the PC 104 System is connected to a supply voltage of 12 V Power supply from the PCI Bus with 5 V Figure 8 Jumper Setting JP301 The 5 V voltage which is carried over the PC 104 plus plug to the Grabber card is connected to Pins X3 25 This setting is not a option if you have a Grabber card with a...

Page 33: ... have a Grabber version with an integrated power supply and the input voltage at X300 amounts to more than 15 VDC Power supply from the integrated power supply with 5 V versions EPC 032 X2 EPC 032 X1 X2 version Figure 10 Jumper Setting JP301 A regulated voltage of 5 V from the internal supply is connected to pins X3 25 Note This option is only available if you have a Grabber version with an integr...

Page 34: ...r supply allows for the operation of the Grabber and other components of the PC 104 System with an unregulated direct current for example from a car battery In many applications this renders the insertion of a special voltage supply card unnecessary The eGrabber 4plus can make two output voltages available 5 V max 2 A 12 V max 1A Note The power supply is only present on the following models l EPC ...

Page 35: ...t voltages with high levels of interference especially if power spikes occur an additional interference filter is required The input voltage is connected to the socked connector X300 ò The socked connector corresponds to the supply voltage connector from the 3 5 floppy disk drives Figure 11 shows the pin out of the supply voltage input Figure 11 Connecting the Supply Voltage Input X300 The Grabber...

Page 36: ...bber is not fed directly by the supply voltage rather over the bus connector of the PC 104 System It is also possible to connect peripheral devices floppy disc drives hard drives etc to socket X302 For hard drives and similar components it is important to be careful that the beginning start up current during a power up does not exceed the maximum allowed output current In this case the supplies su...

Page 37: ...connectors the supply voltage can be delivered without connector cables simply by linking the cards together The socket X303 is designed especially to fit the aforementioned CPU card and delivers all required voltages For additional information refer to the handbook of the MOPS CPU card Important Test exactly whether the pin out of the supply voltage connector on your CPU card matches the pinout o...

Page 38: ...t recommended since the connection via a specially configured socket is optimized by the CPU cards manufacturers JP 301 must be jumpered as follows in order to connect the adapter output with the corresponding pins of the PC 104 Bus connector Figure 13 JP301 5 V on PC 104 Bus Connector Figure 14 JP301 12 V on PC 104 Bus Connector Note Connection of the 12 V output with the PC 104 Bus connector is ...

Page 39: ... be accomplished via a switch on the connector field X301 or with a TTL signal Figure 15 Connector Field X301 The power supply is shut off when X301 Pin1 is connected to GND In addition to this both of the X301 pins can be connected to one another for example via a switch A controller signal can be connected to X301 1 as well over which an adapter can be switched on and off ...

Page 40: ... sometimes as Device ID No two cards in a PCI System are allowed to be set at the same position The system will most often not boot at all in such cases As a rule PC 104plus CPU Cards have up to four positions available Find out which positions your CPU Card makes available The position required for the eGrabber 4plus must have master capability Check which positions are used by other PCI Expansio...

Page 41: ... various Ground connection possibilities for adaptation to different operating conditions Three of the four connector sockets are in contact with GND The GND potential of the Grabber card can be connected with the Ground of the CPU card the housing or PE using a cable connection or conducting bolts By using synthetic conducting bolts it is possible to isolate the Ground potential This may be desir...

Page 42: ...le in industrial areas and using long feed lines additional precautions have to be taken to suppress interference Long video cables or mounting the components for image processing into plants and machines can cause the exposition to balancing currents which have to be eliminated from the input of the eGrabber 4plus by appropriate arrangements PHYTEC does not assume any liability for damages that o...

Page 43: ...h caution 2 1 Installing the Grabber Card Caution The PC 104plus System must be isolated from the supply voltage Please ensure that the device does not have any power supplied to it The specifications instruct you to install the card on the virtual positions slots or Device ID 1 4 Select one of these positions be sure however that it is a position with master capability in some systems not all sys...

Page 44: ...d into the slot can damage the mother board as well as the card Ensure that the Grabber card is inserted into the right PCI slot Lign up the golden contact strips with the PCI slot s receptacle Some resistance will be encountered as the contact strips spreads apart the contact springs Make sure that no mechanical or electrical contact exists between components on neighboring cards Especially due t...

Page 45: ...tor Therefore no special power supply board is required The power supply for the camera at pin header row X3 can also occur over the Framegrabber card Additional information on this subject can be found in section 1 9 The Grabber models EPC 032 X2 and EPC 032 X1 X2 each have a separate supply voltage adapter which is capable of supplying the entire PC 104 System with power The power supply is comp...

Page 46: ...ages are not redirected to the Grabber or distributed over the PC 104 connector Therefore all components that are to be supplied with voltage have to be connected to X302 in standard configuration Additional information on the integrated supply voltage is available in section 1 9 Figure 19 Supply Voltage Output Note The voltage to socket X300 must not exceed 28 V The current draw is limited to 1 5...

Page 47: ...computer s BIOS should recognize the card automatically Many BIOS versions will briefly show a list of the located PCI devices The eGrabber 4plus appears twice in this list as Multimedia Device Two possibilities exist now 1 Either the operating system recognizes the card and searches for the driver or 2 the operating system does not automatically recognize the card i e Windows NT and the user must...

Page 48: ...ch and in the window that will appear select the CD ROM drive Change the path to pciGrab4 driver win95_98 Confirm by selecting OK A list appears on the CD which names the found drivers Select PHYTEC PCI Grabber from the list Now the driver should be automatically installed from the CD to the computer In the window that will appear next confirm a Restart of the computer After start up the computer ...

Page 49: ... appear select State a Position Now place the PHYTEC Vision Utilities CD into the CD ROM drive Select Search and in the window that will appear select the CD ROM drive Change the path to pciGrab4 driver win2K_98 Confirm by selecting OK A list appears naming the drivers found on the CD Select PHYTEC PCI Grabber from the list The CD will automatically install the driver onto the computer Now the dri...

Page 50: ...r Windows NT In the window that will appear select the PCI Grabber and then select Install drivers and WindowsNT4 0 After following the directions from the installation program the necessary drivers will automatically be installed In the window that will appear confirm a Restart of the computer Now the computer should function normally after start up of the operating system The driver has now been...

Page 51: ... a scanner device For additional information on the Twain driver please refer to the User s Manual on the graphic program that is being used The LabView driver works with the measurement and automation programs from National Instruments IMAQ package is required For more information on the program or the driver please refer to the LabView s User s Manual If installation of these drivers are desired...

Page 52: ...rogram Place the PHYTEC Vision Utilities CD into the CD ROM drive The CD ROM drive must be selected and the program start exe found in the CD s main directory must be started Select the PCI bus grabber from the installation menu that will appear see Figure 20 Click on Install Windows demo software Figure 20 PHYTEC Installation Menu Follow the installation instructions and the demo program will be ...

Page 53: ... model both 3 composite and one S Video EPC 032 X1 EPC 032 X1 X2 or 9 composite and one S Video source EPC 032 EPC 032 X2 can be connected to the Grabber Changing channels occurs via software or via the included demo program Figure 21 Overview of the eGrabber 4plus Connectors The composite inputs are located on the SMB Sockets å and on the 26 pin header row X3 ê A camera can be connected to a supp...

Page 54: ...e pictured cables can be ordered from PHYTEC The illustration of the cables includes a brief cable description and the PHYTEC order number see the Figure 22 Figure 22 Video Connector Cables Description and PHYTEC Order Number Refer to the instructions to your video source in order to check for connector compatibility The following section briefly describes the above depicted cables ...

Page 55: ... It is possible to connect the composite outputs BNC plug with a video source using a BNC plug Note If the composite sources contain a cinch socket then a cinch BNC adapter 75 Ω must be used The end with the SMB plug is inserted into the Grabber socket å or In order to display an image the correct channel must be selected in the user s software and in the demo program It is possible for the includ...

Page 56: ...eGrabber 4plus 46 PHYTEC Meßtechnik GmbH 2004 L 608e_4 ...

Page 57: ...talled see section 2 The demo program can be found under START Programs Phytec pciGrabber4plus Grab4PCI After this program has been started an empty program window will appear with menu options see Figure 23 Figure 23 Overview of the Demo Program Next a moving live image from the camera should be displayed Please ensure that a video camera or another source is connected to the Grabber and that an ...

Page 58: ...e_4 Click on the Image button and the following pull down menu will appear see Figure 24 Figure 24 Menu Option Image In order to configure the parameters of the image to be grabbed select the Image Settings command from the pull down menu see Figure 25 ...

Page 59: ...or To display the image on the monitor the following requirements must be met It is important to select the proper video input for the Grabber In the Channel selection field fill in the type of video source composite S VHS and the input channel that is being used The input channels can either be manually entered or automatically searched for In order to use the automatic search click on the Search...

Page 60: ...or in monochrome The remaining entries under Image selection can retain their pre configured values Exit the menu by clicking OK Now select the Live Image command from the Image pull down menu A live image from the selected video source will now be displayed in a new window see Figure 26 Figure 26 Live Image from the Video Source ...

Page 61: ...bar of the main window The value represents the number of images that are generated per second in the live window The value is dependant on the size of the image and the capacity of the computer because the digitized image must be transmitted from the computer s RAM to the graphic card to eventually show up on the screen Note Despite the processor s capacity the Grabber always stores image data in...

Page 62: ...program The Image Settings menu see Figure 27 contains parameters that influence image generation and depiction Figure 27 Image Setting Menu The parameters can be configured before a live image is displayed although parameters cannot be configured while live images are displayed The section entitled Channel Selection offers parameters for video source types and channel selection ...

Page 63: ...ist for connecting a source to the Grabber Over the Mini DIN plug or over the pin header row X3 ê Select S VHS MINIDIN for the Mini DIN plug or S VHS COMBI for the header row X3 ê Note Only one S Video connection possibility can be implemented at any given time The user can choose to display an image in color when using a color video source or monochrome by using the color and monochrome buttons I...

Page 64: ... field is to be displayed then checkmark the Image Window box The Window Size does not distort the image geometry because it is not a scaled section rather then a cut out section Note Please note that scaling and cutting section processing is run in real time in the Grabber The Grabber stores the image as it is displayed on the monitor This is very beneficial because the CPU is not needed for this...

Page 65: ...nce the image is only represented by 228 rows excluding the invisible rows that precede and succeed the image as well as test and data rows A total of approximately 576 from 625 rows remain visible Digitizing a field is time efficient compare 20 ms for a field image to 40 ms for both fields full frame If the same field i e the first needs to be digitized repeatedly there is a pause of 20 ms betwee...

Page 66: ...n then the full frame is automatically selected The field aligned button doubles the number of displayed fields per second This eliminates the 20 ms pause between the digitization of fields Optically frames the image contents shifts a half line up and down when consecutively displaying both fields This occurs because the two fields cannot be interlaced to form a full frame When configuring field a...

Page 67: ...ally be activated if the resolution is smaller then 360 Pixel and otherwise deactivated Window Position can be used to determine the position of the image window contained in the above mentioned image section The values represent the position of the upper left hand corner In order to center the image in the TV screen check mark the box next to center The parameter moves around cut out the section ...

Page 68: ...tness conrast color saturation and color tone The values are transferred immediately to the Grabber so that the effects of justification can be seen and judged immediately in the live image The Brightness slider can be used to adjust brightness levels to meet environmental conditions The Contast slider can be used to adjust the image contrast as needed For the adjustment of the color saturation tw...

Page 69: ...ance at the camera or video source if possible 4 3 Additional Functions Under Image Using the Single Image entry a snapshot is taken and displayed on the screen In this mode the Grabber only performs one digitization The parameter Image Settings defines the image Using the parameter Live Image a live image can be displayed on the monitor Image settings also defines the image in this mode Snapshots...

Page 70: ...or a combination of them can be overlaid in the image 4 5 Basic Parameters Basic parameters pertaining to the Grabber and arithmetic operations can be found in the Options pull down menu Basic Settings contains the following menu Figure 31 Basic Settings Menu Multiple eGrabber 4plus units can be operated in a PC 104 System Select the appropriate number in the Grabber selection field If there is on...

Page 71: ...on Grabber model denotes the eGrabber 4plus Color System configures the color system to be used with the Grabber PAL is mainly used in Europe and NTSC is used in the USA While operating with live images these parameters cannot be changed Addition Settings and Type Casting Settings are described with Add Live Images and Arithmetics later on in this manual All of these entries can be found under the...

Page 72: ...ray or color values of an image The relative Frequency of the corresponding intensity values are represented by brightness as well as the intensity see Figure 32 Figure 32 Histogram The X axis includes the values between 0 and 255 Using the check boxes in the histogram window the curves of gray values or the separate color values can be turned on off Caution A histogram can only be created from a ...

Page 73: ...els for the color values of pixels embedded in the center of the image A small crosshair that appears in live image indicates the center of the image The RGB model displays the color values for red green and blue as pointers and number values on the intensity bar The YCrCb model displays color values as color bars and in a coordinate system Thus color fading and changing can be observed over an ex...

Page 74: ...he color bars are generated from hardware and not the demo program The number of bars displayed depends on size of the chosen image All color bars are displayed with a horizontal resolution of aprox 515 pixels Arithmetic Operations on Static Images The Arithmetics menu option provides some simple arithmetic operations on static images see Figure 31 For example images can be added subtracted multip...

Page 75: ...t option a constant can be added to each pixel changes brightness or can be multiplied with each pixel changes contrast All arithmetic operations are normalized This is important if the result is expected to be outside of the displayed range of values Each color channel has a range from 0 to 255 On principle values greater than 255 are set to 255 and pixels with values less than 0 are set to 0 Thi...

Page 76: ...ages or to reduce the resolution of moving objects in comparison to the background After the addition process the resulting picture is normalized so that the original brightness is retained The length of the process depends on the number of images that were added and the capability of the computer The operation s status is displayed as a percentage in the lower section of the window Caution In ord...

Page 77: ...he port can be wired to pin header row X3 or over the Grabber s Option Port X6 see section 1 6 If Output active is selected then the port pin acts as an output The Set I O Port switch can be used to activate the output ON connection against Ground or deactivate the output HI Z high impedance Selecting Input active allows the user to test the I O Input Port The simulated red light indicates if the ...

Page 78: ...he PHYTEC framegrabber cards pciGrabber 4plus and eGrabber 4plus with Linux is easy because these cards are supported by the standard framegrabber driver bttv The pciGrabber 4plus has an own card definition in the bttv driver If your bttv driver version does not contain this card definition please upgrade to a newer bttv version The PHYTEC cards are included in version 0 7 107 or higer Current ver...

Page 79: ...tor 108 EPC 032 X1 Mini DIN plug 109 EPC 032 X1 Combi connector and the corresponding X2 models Hints The selection of the card number also defines whether the Mini DIN or the Combi Connector is used as the s video input In difference to the driver for Microsoft Windows this selection cannot be done during runtime but only by the card number selection This is because the bbtv driver does not suppo...

Page 80: ...eGrabber 4plus 70 PHYTEC Meßtechnik GmbH 2004 L 608e_4 ...

Page 81: ...Part 2 Programmer s Manual PHYTEC Meßtechnik GmbH 2004 L 608e_4 71 Part 2 Programmer s Manual ...

Page 82: ...eGrabber 4plus 72 PHYTEC Meßtechnik GmbH 2004 L 608e_4 ...

Page 83: ...the digitization Software drivers for different operating systems are available In this manual drivers for l Windows 95 98 ME XP l Windows NT 4 0 l Windows 2000 l DOS are explained Note In order to obtain the newest information regarding the driver and the availability of additional drivers please read readme txt This file can be found on the installation CD The next section describes the technica...

Page 84: ...D converter digitizes this signal All image sources can be used which provide a color video signal corresponding to the CCIR standard PAL B D G H I NTSC M Caution In Germany image sources generally provide PAL signals In this manual we assume that PAL signal sources are used Via the S VIDEO input luma and chroma signal can be supplied separately for example from a S Video camera or S VHS videore c...

Page 85: ...uces the data formats which are provided by the eGrabber 4plus Via a datamultiplexer the required format is selected and stored in the 630 Byte FIFO memory The FIFO is an interface to the following PCI bus interface which is responsible for the data transfer through the PCI bus The image data are transferred by DMA to the main memory of the PC For each field a separate DMA channel is used The tran...

Page 86: ...uitry in PC Graphic Memory via software Besides various retrace and blanking lines the videosignal contains lines for control and data purposes and lines for videotext information which restricts the actual image size to two fields of 288 lines Figure 39 Interlaced Image Example with 9 Lines Each field is built up within 20msec One field provides already the whole image but the vertical resolution...

Page 87: ... reduced to the half Therefore the first line of the second field contains only the half line Figure 40 Fields and Frames For fast moving objects it might happen that the time between the digitization of the first and second field is so long that meanwhile the objects have moved some distance and both fields don t match anymore which will cause some remarkable blurring For this reason quite often ...

Page 88: ... Y bandwidth of the PAL B G H I system is 5 MHz and the bandwidth of the chroma signal is 1 5 MHz The chroma signal is also denoted as U V signal for PAL standard or Q I signal for the NTSC standard V and I signal define the reddish colors whereas the U and Q signal define the bluish violet colors Altogether we speak from the Cr Cb signal chroma red chroma blue With the triplet Y Cr Cb the brightn...

Page 89: ...oring pixel The color is transferred and stored only at the half resolution of the brightness Since the bandwidth of the color information is already reduced by the TV system this procedure does not mean a real restriction This data format is denoted asYCrCb4 2 2 The first pixel of each line delivers Y1 Cr1 2 the second Y2 Cb1 2 etc Caution For the correct recognition of the color information of a...

Page 90: ...he data transfer or for time intervals the PCI bus is not available to the Grabber that means some other devices become master are bypassed by a FIFO memory This allows only a short time span to bypass the blocked bus since otherwise an overflow might occur and portions of the image are lost The bus is controlled by the parameter Maximum_Latency and Minimum_Grant of the PCI board If required this ...

Page 91: ...or image size and data format selection the user program applies the function set_image of the driver The driver starts two actions first the image size is set in the VideoScaler by values in the local registers of the Grabber via the PCI bus This implies that the eGrabber 4plus creates the correct image size and the data flow has the correct format and provides the appropriate synchrony signals I...

Page 92: ...s address region is reserved by the user program e g the definition of arrays The regions might be defined as shown in figure 42 as two separate regions one for the odd and one for the even field or only one region which is provided for the whole frame of the eGrabber 4plus The different options are selected by a parameter in the set_image function which influences the creation of the RISC program...

Page 93: ...ning of the desired half image This additional time might arise from waiting for the appropriate field For example if an even field is demanded but the camera has just started scanning an even field so it is necessary to wait until this field and the next following odd field are finished In the worst case a delay of 40msec two fields can be expected Now the demanded field can be digitized which wi...

Page 94: ...ially in scenes that have been moved Now we consider the case of digitizing a whole frame in one memory region Here the same effect might occur but in some different fashion After 20 msec digitization the information for an odd field is completely available and therefore all odd lines are defined but the even lines are not defined During the following 20 msec the data for the even field are receiv...

Page 95: ...and stored to the hard disk The structure of the file directory is similar to Figure 43 The window on the left hand side displays path names These path names can be edited during installation in order to create user specific names for the system The libraries and include files to be compiled are located in the labeled subdirectories Figure 43 Directory for Window Driver s New Image ...

Page 96: ...iver and corresponding DLLs must be copied into the Windows main directory in order to implement the eGrabber 4plus in a Window s operating system In addition the system driver must be registered into the registry table Phytec s installation program automatically copies the device driver and DLLs and registers the system driver Therefore all the requirements for operation are fulfilled Creating co...

Page 97: ... The access will be executed via the DLL You might use the installation CD to deliver the Window s 95 driver with your own application The path on the CD is PCIGRAB4 DRIVER WIN95_98 You can copy these files onto a disk and distribute them with your application Alternatively you can create your own installation routine To do this the following points must be processed The VxD driver must be introdu...

Page 98: ...mbH 2004 L 608e_4 Figure 44 Windows 95 Registry New Image Extend the key group VxD with Grab4PCI by selecting the menu Edit New Key create a new key and assign the name Grab4PCI as shown in Figure 45 Figure 45 Adding a VxD Entry New Image ...

Page 99: ...l result must look like Figure 46 Figure 46 Configuration of the VxD New Image l Since Windows 95 accepts the values of the registry table only after a reboot you must start the system again Caution During de installation of the user program the VxD driver should be removed The driver has to be erased from the registry table and cleared from the system directory The VxD driver requires for the eGr...

Page 100: ...D in the PCIGRAB4 DRIVER WINNT40 directory The files stored in this directory can be copied to a disk and run with user applications The user also has the option to create an installation program specific to user needs When creating this program please take note of the following points The driver must enter the Windows NT4 0 system into the register This can be done in the following manner The PCI...

Page 101: ...menu and a new key will be created Name this new key pciGrabber4 as shown in Figure 48 Figure 48 Entering a Device Driver New Image Now configure the new key group and mark the entry with pciGrabber4 as shown in Figure 48 Select the DWORD value command from the Edit New pull down menu A new entry named New Value 1 will be created within the pciGrabber key ...

Page 102: ...s DWORD entry select DWORD value from the Edit New pull down menu and enter a value of 1 for ErrorControl The end result should look similar to Figure 49 Figure 49 Configuring the Driver New Image After restarting the computer the driver is automatically loaded when starting Windows NT Caution The device driver must also be removed when uninstalling user programs Erase the entry from the Registry ...

Page 103: ...device driver allocates physical memory for storing images The driver also allows access to the eGrabber 4plus register Reserving memory space is only possible with a device driver under the Windows98 2000 operating systems The driver also transforms linear memory addresses into physical memory addresses User programs do not have direct communication with the driver instead access is provided by D...

Page 104: ...t be available in the Windows system directory during program runtime In addition to GR4CDLL DLL the following DLLs are necessary for operation MSVCRT DLL CTL3D32 DLL MFC42 DLL Windows provides various API functions to dynamically link the DLL Load Library is used to load the DLL and a handle is subsequently returned for the DLL The API function GetProcAddress provides starting addresses for vario...

Page 105: ...ition of the function pointer WORD PASCAL lpfn_GetError void Use GetProcAddress to obtain the relationship between the function pointer and the DLL Example lpfn_GetError WORD PASCAL void GetProcAddress handle Get_Error The function can now be called with WORD Errorstatus Errorstatus lpfn_GetError Caution Check the value of the function pointer return value from GetProcAddress to be sure that it 0 ...

Page 106: ...t the called function frees the stack region which was used for the pa rameter function Grab4_Get_Error word stdcall external gr4cdll dll name Get_Error function Grab4_Max_Device_Number word stdcall external gr4cdll dll name Max_Device_Number function Grab4_Data_Present nDevNo word word stdcall external gr4cdll dll name Data_Present function Grab4_GetPictureBufferAddress nDevNo word dwBitsSize Car...

Page 107: ...vpos nEhsize nEvsize nEppl nElines nEColformat word nColsystem word nInterlaced word nSingleShot word stdcall external gr4cdll dll name Set_Image const NTSC_M word 0 PAL_BDGHI word 1 SECAM word 2 PAL_M word 3 PAL_N word 4 AUTO word 5 RGB32 word 0 RGB24 word 1 RGB16 word 2 RGB15 word 3 YUY2 word 4 BtYUV word 5 Y8 word 6 RGB8 word 7 implementation DLL Functions end ...

Page 108: ...ts capabilities Routines that configure the Grabber configures for the grabbing process Functions from this group configure the Grabber to the connected image source camera These functions also determine the appearance of the grabbed picture as an end result in memory image size color format etc The user should determine whether each function is needed and which parameters are necessary These func...

Page 109: ...ver versions Although depending on driver model differences will occur In order to simplify the porting process the following symbols are used Ø Calling functions are the same under DOS and Windows Please ensure that the operating system s variable types are distinguishable ä This function is specific to Windows DOS This function is specific to DOS Caution In all the following routines the paramet...

Page 110: ... older driver version for the eGrabber 2 are denoted with a star Please take note of the functions with a when adding new features from the eGrabber 4plus to existing applications Most functions are compatible with the eGrabber 2 although some functions may not be used due to non compliance with hardware requirements In any case the new driver version should be used with new applications Compatibi...

Page 111: ...valid address 11 write access denied Each execution of a diver function should be checked if it was successful For this purpose there is the function Get_Error Immediately after the execution of the function the internal error variable of the driver is set to the actual status This variable is available to the user program via the function Get_Error so that a reaction to this error message can occ...

Page 112: ...number for the Grab4CDLL HighWord Major_Version_Number LowWord Minor_Version_Number The version number for the Grabber DLL can be obtained using these return values This function is only for the Windows DLL and not for DOS Note Test the version number and ensure that when using the eGrabber 4plus the Major_Version_Number is larger than or equal to 5 ...

Page 113: ...the driver Those are converted internally into device numbers nDevNo Each eGrabber 4plus card in the system is assigned a unique device number during generation of the Grabber class It can not be predicted for certain which number is assigned to which card since this depends on the topology of the bus and the function of the BIOS In order to drive the different eGrabber 4plus independently by the ...

Page 114: ...e wInfoType specifies which Grabber feature will be called return value Value of the specified feature This functions delivers information on the hardware in order to ensure optimal adaptation of the applications to the Grabber This function can also be used to define the number of input channels that the Grabber will support and the channel selection dialog can conduct a field test The properties...

Page 115: ... can be found in the Header file Ø å Read Grabber Name as a Text String WORD Read_OrderCode WORD nDevNo unsigned char sCodeString DWORD dwSizeOfString sCodeString Pointer points to a declared string 25 Bytes min The function writes the Grabber name into this string dwSizeOfString Size of the reserved array return value Error Code This function allows the Grabber s description to be read in clear t...

Page 116: ...PC 032 eGrabber 2 EPC 032 or a related product is called up then the error code 6 and the string EPC 032 or compatible is returned Ø Grabber setting to the required color system void Set_Color_System WORD nDevNo WORD nColSys nColSys Code for color system With the function Set_Color_System the Grabber is configured for the color system used Clock frequency and input registers of the video processor...

Page 117: ...s finished Ø Configuring the Composite Mode Composite Inputs void Set_Composite WORD nDevNo Calling this routine switches the Grabber onto the composite mode The chroma ADC is subsequently switched off and the luma notch filter is activated This mode must be configured when the composite signals are to be digitized The composite mode must be selected for all standard cameras black and white or col...

Page 118: ... Set_S_Video activates the chroma ADC The excessive luma notch filter in the luma path is deactivated creating a sharper image Set_S_Video also automatically connects the input channel to the S Video input S Video sources are color cameras that have a special output in order to separate brightness and color signals These cameras can be connected to a Grabber with the cable Caution The S Video sour...

Page 119: ...MBI is returned If a signal has not been found at either of the sockets then the Grabber is configured to the Mini DIN socket and the return value is NO_SIGNAL Note If there is no connection of an S Video source but there is a composite source available at channel 3 EPC 032 or channel 9 EPC 032 X1 then the Grabber is configured to the Combi socket using the AUTO function Then the image from the co...

Page 120: ...9 are allowed This function is not compatible with the eGrabber 2 EPC 032 and eGrabber 2 EPC 031 Note Configuring the input channels is not necessary when using S Video sources The function Set_S_VideoEx switches the channels automatically Caution When switching input channels stop inhibit times are to be taken care of until an image for the new channel has been digitized For the following reasons...

Page 121: ...t 2 9 input 3 Ø Selection of the luma notch filter for black white operation void Set_BW WORD nDevNo WORD nOn nOn 0 composite signal at the input activate luma notch filter 1 b w signal at the input deactivate luma notch filter If a black white camera is connected to the Grabber a luma notch filter is not necessary which avoids disturbing color moiré from the brightness signal Cross Color Effect T...

Page 122: ...field the option Non Interlace should be selected in order to reduce artifacts from the motion When displaying only fields a 20 ms recess usually occurs between the two digitization events This is because the other field cannot be displayed due to the field rastering delay In the Field Aligned mode the second field is internally moved over by a half row so that the frame can fit onto the first fie...

Page 123: ...vailable In this case the overflow bit of the A D converter is monitored If an overflow occurs automatically the A D reference voltage is increased which causes an increase of the input voltage range In general operating the eGrabber 4plus with a non adaptive power regulator will suffice In applications where the regulator can have damaging effects on the adaptive AGC this is the case when working...

Page 124: ...effect by testing if the color burst is present and if necessary deactivates the color evaluation It might be desirable to digitize a color signal with a weak color carrier and the recognition of the color carrier is not practicable so that only gray values are digitized With nCKill 0 the color killer is turned off so that the image is digitized with color but it might have some color noise For th...

Page 125: ...50 or 60 NTSC digitized images per second video standard With the help of this function it can be determined how many images of the 50 or 60 images are dropped during digitization The other two parameters give instructions of the kind of omissions The parameter nAlign aligns the start of the decimation with an even or odd field The parameter TDecField defines whether decimation is by fields or fra...

Page 126: ... means the lowest image memory address contains the upper left corner of the image The image is flipped vertically before it is stored in the image memory The lowest image memory address contains the lower left corner of the image This might be useful if image date are processed in BMP format Important The setting of the vertical image orientation with FlipPicture must be done before the Set_Image...

Page 127: ...ure X direction ppl pixel per line nOlines required number of lines of the odd video picture nOColformat required color format RGB32 RGB24 RGB16 RGB15 Y8 YCrCb 4 2 2 YCrCb 4 1 1 nEhpos nEvpos position of the left upper corner of the even picture section of the video picture hpos horizontal vpos vertical nEhsize size of the even picture section in X direction nEvsize size of the even picture sectio...

Page 128: ...prefix E even image or an O odd image Parameter without those letters are valid for both fields For both fields different sizes can be stated They might be stored in different memory regions and can be processed in different ways In Interlaced Mode both fields are interlaced and are stored in a common memory region and have a maximum resolution of 720 x 576 pixels PAL or 640 x 480 pixels NTSC resp...

Page 129: ...tion is done in interlaced mode if the high resolution is required or you can reduce the resolution to ppl 360 lines 288 and the resolution will be proportional with 360 x 288 pixels Note For stereometric work or automatization applications a correct proportional resolution is not always required as long as the distortion is taken into consideration in the algorithm So the complete field resolutio...

Page 130: ... field was digitized If the section defined by hsize and vsize is smaller than the size of the area determined by ppl and lines the window can be moved in the digitized image with the parameter hpos and vpos For hpos 0 and vpos 0 the window is positioned in the upper left corner of the digitized image Figure 50 Scaling and Cropping ...

Page 131: ...ize 200 ppl 202 admissible all pixels are in the image hpos 100 hsize 100 ppl 200 admissible hpos 100 hsize 200 ppl 300 admissible hpos 300 hsize 300 ppl 800 not admissible image has more pixels than the TV standard provides correspondingly in Y direction l All parameters in horizontal direction must have even values ppl 123 is not admissible ppl 124 is admissible l If all parameters which influen...

Page 132: ...quadratic size of 256 x 256 pixels The result is hsize 256 vsize 256 c Positioning It is advisable to center the section of the image In x direction only 256 pixels of 360 pixels are displayed in the window At the edge 360 256 104 pixels remain which are divided in equal parts to both sides which result in 52 pixels on both sides hpos is the size of the left edge so hpos 52 Correspondingly in Y di...

Page 133: ...section Corresponding to the size of the window we set hsize 120 vsize 100 c Positioning With the parameter hpos and vpos the window section can be shifted 180 120 60 pixels in X direction and 144 100 44 pixels in Y direction Full Frame Digitization A 700 x 500 image should be delivered with resolution and proportions that correspond to a TV image a Resolution and Scaling For digitization a frame ...

Page 134: ...two half frames in the vertical direction nOvsize nEvsize 500 Pixel 250 c Positioning It is useful to center the image In the X direction only 700 of the 720 pixels are displayed in the window Thus a border of 720 700 20 pixels exists The 20 pixels are evenly distributed on both sides i e 10 pixels on the right and 10 pixels on the left hpos is the size of the left hand border therefore hpos 10 nO...

Page 135: ...or the blue color 8 bit the second Byte the green and the third Byte the red color information The highest Byte contains no information and is used only to obtain a whole double word for one pixel After each double word a new pixel begins see Figure 52 that related information have same hatching The alignment of double words might have the advantage that fast access commands could be used The numb...

Page 136: ...responds to the angle of the pointer the saturation is presented by the absolute value of the vector This format is applied for graphic cards with YcrCb systems with separate processing of brightness and color value which is very compact for the storage of images in memories é YUY2 This format corresponds to the format YCrCb 4 2 2 In one double word the information of two pixels is found Y0 and Y1...

Page 137: ...Driver Software PHYTEC Meßtechnik GmbH 2004 L 608e_4 127 Figure 52 Color Format of the eGrabber 4plus ...

Page 138: ...e in the memory Therefore it is required to reserve a region in the main memory of sufficient size The Windows driver reserves an image memory space in which the image is placed How much memory will be used This will be calculated from the size of the image number of pixels and the required number of Bytes per pixel color resolution Memory requirements per field hsize vsize pixel size Byte The val...

Page 139: ...ly digitized information are stored in the memory in real time 50 fields per sec In field mode nInterlaced 0 the information is stored to one memory region 20 ms then the other region another 20 ms alternatingly This means that each field memory region is not accessed from the Grabber at least for 20 msec For frame mode nInterlaced 1 the Grabber stores continuously to the common memory 20 msec the...

Page 140: ...gures how the image is recorded Grabbing is not started with this function but with the instruction Start_Grabber see description below Ø ê Start grabbing void Start_Grabber WORD nDevNo The function Start_Grabber starts grabbing with the device specified by nDevNo The result will be digitization with the beginning of the next available image If continuous grabbing was selected then one image after...

Page 141: ... the next complete even field will be digitized The delay from the start instruction to digitizing will be 40 msec b At the input an odd field is applied The even field following the odd field will be digitized Maximum delay time 20 msec 2 An odd field is required to be digitized a At the input an even field is applied Since the driver evaluates even fields first the rest of the incomplete even fi...

Page 142: ...of data will be cancelled immediately and the image might be incomplete see Figure 49 Caution Stop_Grabber must be called even for digitization in single shot mode nSingleShot 1 in Set_Image when operation is finished automatically The Grabber is locked in standby mode until Stop_Grabber is called Thereafter a new single shot can be taken with Start_Grabber ...

Page 143: ... odd image Figure 53 Return Values of Data_Present For continuous grabbing this indicates when the content of the corresponding memory region is occupied completely with a new image Each alteration of the status 0 to 1 and 1 to 0 indicates that a new field was recorded Bits 2 and 3 are set to 1 as soon as an even or odd image was completely recorded Those bits are used in case only one image shoul...

Page 144: ...L 608e_4 Caution Please pay attention to evaluate the correct bits which correspond to the actual mode since otherwise your program might access the data during the wrong time interval Figure 54 Timing Diagram of the Return Parameter of data_present ...

Page 145: ...mory the Grabber stores the data of the digitized image with the following structure a Only even or only odd fields are digitized the parameters of the dimension of the other field are zero Õ The digitized field is placed at the beginning of the memory region of the image b Even and odd fields are digitized nInterlaced 0 Õ The even field is placed at the beginning of the memory region Adjacent to ...

Page 146: ...ges when the standard routine for the driver is being used If both Grabbers are in the digitization process then image data stored in the buffer will be over written This limitation does not exist for drivers under all the other operating systems ä ê Activate Interrupt DWORD ActivateFieldInterrupt WORD nDevNo HANDLE hEvent HANDLE Pointer to an Event Monitoring the progress of image digitizing can ...

Page 147: ...ivateFieldInterrupt should therefore be called only when the grabber is not running It might be advisabe to call ResetEvent after that to reset any older active signals which might have been created in the meantime To determine which field had been digitized the DataPresent function should be called immediately after the event had been signaled In case of continuos digitization this is done by eva...

Page 148: ...If the returnvalue is 2 a source is applied Interference at the input can cause a wrong indication The returnvalue 3 indicates a stable videosignal which stems with high probability from an image source This value is generated in case the horizontal synchronizing pulse is found within 1 clock of the expected position This must be given for 32 lines in sequence Vice versa the HLOCK status will be n...

Page 149: ...ber of digitized half frames The result is a Byte value and the counter jumps from 255 to 0 void Reset_CaptureCounter WORD nDevNo Calling this routine sets the half frame counter back to zero Ø Setting the brightness of the image void Set_Brightness WORD nDevNo short nBright nBright brightness of the image 128 127 This function specifies the value in the register for the brightness in the video pr...

Page 150: ...ntrast WORD nDevNo WORD nContr nContr contrast 0 511 This function specifies the contrast of the image The contrast is a constant factor which is multiplied in the video processor corresponding to the scaling with the brightness of the pixel The factor has a range of 0 to 236 57 nContr contrast 2 1598 1 Ø Reading the contrast setting WORD Get_Contrast WORD nDevNo return value actual contrast value...

Page 151: ...ulated for both color portions Usually the relation of the values nSat_U and nSat_V are equal The control of the difference between the U and V portion allows the elimination of color cast which might stem from unbalanced color cameras The resulting effect will be a change of the color of the image nSat_U U saturation 2 5400 1 0 201 18 nSat_V V saturation 2 1396 1 0 238 83 Ø Reading the content of...

Page 152: ...phase position of the color signal For PAL this value is insignificant since phase errors are automatically compensated One LSB corresponds to a correction of the phase angle of 0 7 therefor the color signal can be varied in the range of 89 3 to 90 This value must be set to 0 to ensure proper functioning of the color decoder under PAL Ø Reading the content of the registers for hue short Get_Hue WO...

Page 153: ...into the luma path With the parameter nHFilt the used filter is adapted to the size of the image The function automatic filter selection adapts the filter setting to the size of the image see also Set_image In addition the filter can be adjusted manually to one of the standard formats CIF whole frame QCIF 1 4 whole frame and ICON 1 8 whole frame Default luma low pass is turned off Ø De Activation ...

Page 154: ...th this function the output format of the brightness and color value can be adapted to the application The parameter nRange determines the range of values for the brightness permissible gray values l nRange 0 corresponds to the standard range of values specified in CCIR 601 The range of values for the brightness is restricted to the values 16 to 253 where Y 16 corresponds to black The range of val...

Page 155: ... work as input or output set which output pins have low or high level and determine what level is applied to the input pins With the help of the function Set_GPIO_Direction each pin of the port can be configured as input or output For this purpose the lower 12 bits of the parameter nDirection are evaluated If a bit is set to 1 the corresponding port is configured as output A 0 results in a configu...

Page 156: ...ith these functions it is possible to read and write to components that are connected to the I C interface Instructions on how to connect components or devices to the I C Bus can be found in section 1 7 Caution The I C EEPROM found on the Grabber card is protected against accidental writing Therefore access to the device address space 0xA0 to 0xA3 is not allowed In order to obtain access to the in...

Page 157: ...ed area of the EEPROM mounted on the Grabber BYTE I2C_WriteByte WORD nDevNo BYTE b ChipAddress BYTE bSubAddress BYTE bData bChipAddress Device address of the I C device on the bus bSubAddress Internal memory address of the I C device bData Byte written into the specified address return value SUCCESS NOACK INVALID_ADDRESS WRITE_FAILED Writes a Byte into the memory space of a specified I C device Th...

Page 158: ... variable return value error code SUCCESS NOACK Reads a Byte value from the EEPROM Specified by calling the memory address that is to be read The result is returned in a Byte variable form that must be pre defined The function returns an error code as a return value see I C_ReadByte BYTE I2C_WriteEEProm WORD nDevNo BYTE bSubAddres BYTE bData bSubAddress memory address written to 0x00 0xFB bData Da...

Page 159: ...O WORD nDevNo BYTE bData bData Control value 0 CLOSE 1 HI Z This function controls the switch output of the port pin The output pin s transistor operates as a switch against Ground If the control value is set to 0 the switch is closed and current is supplied to the I O pin If the control value is set to 1 then the transistor is disabled high ohm switch opened For more information on the technical ...

Page 160: ...e voltage ranges please refer to the specificati ns in section 1 2 Caution In order to use the I O pin as input the transistor must be disabled HI Z Ø Direct reading and writing from to registers WORD Read_Local_Dword WORD nDevNo WORD nRegister_Number DWORD lContent nRegister_Number number of the register lContent contents of the registers WORD Write_Local_DWord WORD nDevNo WORD nRegister_Number D...

Page 161: ...d more information on the registers of the eGrabber 4plus please contact the PHYTEC Support Caution For the existing configuration some registers of the eGrabber 4plus must be configured with special values in order to guarantee the proper operation of the board Please check before each alteration the exact signification of the changed register bits and the effect PHYTEC is not responsible for any...

Page 162: ... has no influence Usually high addresses are utilized above the RAM region which require special addressing mechanisms Caution In order to utilize the DOS driver the DOS Extender DOS 4GW has to be installed Programs which drive the eGrabber 4plus under DOS via the driver routines have to be designed in such a way that they can operate with DOS 4GW DOS 4GW from Rational Systems is a DOS Extender wh...

Page 163: ...mmend the setting of the option 80386 Register Based Calling For the programming of the driver the compiler Watcom C C from Powersoft version 10 6 was used This compiler allows the 32 bit programming and the linking of DOS 4GW The driver is delivered as library LIB file and can be linked with all compilers which support the used format The header files H are included in the user program They provi...

Page 164: ...res for the grabbing process Functions from this group configure the Grabber to the connected image source camera These functions also determine how the grabbed picture will appear as an end result in memory image size color format etc The user should determine whether each function is needed and which parameters are necessary These functions are also called up several times during processing of a...

Page 165: ...ction is DOS specific Caution In all of the following descriptions for routines the parameter nDevNo is used This parameter identifies the desired eGrabber 4plus when multiple Grabbers are installed in the system The number of installed Grabbers can be determined by the function Max_Device_Number Compatibility to the eGrabber 2 The driver is downwards compatible with the eGrabber 2 EPC 032 and EPC...

Page 166: ...nd 2 bad register number 3 initialization failed 4 Grabber not found 5 unknown parameter value Ø å Determination of the number of available eGrabber 4plus unsigned short Max_Device_Number return value number of the eGrabber 4plus found Ø å Initialization of the Grabber and driver activation after power up void Initialize unsigned short nDevNo ...

Page 167: ...ed char sCodeString unsigned long dwSizeOfString sCodeString pointer to a string variable must be defined previously 25 ytes min The function will write the grabber name into this string variable dwSizeOfString size of the string array return value error code Ø Grabber setting to the required color system void Set_Color_System unsigned short nDevNo unsigned short nColSys nColSys code for TV color ...

Page 168: ...ion return value MINIDIN Stored from Mini DIN socket COMBI Stored from Combi socket NO_SIGNAL signal not found AUTO mode NOT_SUPPORTED eGrabber 2 and COMBI configu ration Ø Configuring the Input Channel void Set_ChannelEx unsigned short nDevNo unsigned short nChannel nChannel Input channel to be configured 1 9 1 3 Ø Selection of the luma notch filter for black white operation void Set_BW unsigned ...

Page 169: ...rlace 1 Interlace Ø De Activation of the AGC void Set_AGC unsigned short nDevNo unsigned short nCAGC unsigned short nAGC unsigned short nCrush nCAGC 0 Chroma AGC off 1 Chroma AGC on nAGC 0 AGC on 1 AGC off nCrush 0 none adaptive AGC 1 adaptive AGC Ø De Activation of the color killer void Set_CKill unsigned short nDevNo unsigned short nCKill nCKill 0 color killer off 1 color killer on ...

Page 170: ...s frames to be dropped out DOS Setting the size and scaling of the image void Set_Image unsigned short nDevNo unsigned short nOhpos unsigned short nOvpos unsigned short nOhsize unsigned short nOvsize unsigned short nOppl unsigned short nOlines unsigned short nOColformat unsigned char pOImgBuf unsigned short nEhpos unsigned short nEvpos unsigned short nEhsize unsigned short nEvsize unsigned short n...

Page 171: ...picture in X direction pixel per line nElines required number of lines of the even video picture nEColformat required color format RGB32 RGB24 RGB16 RGB15 Y8 YCrCb 4 2 2 YCrCb 4 1 1 pEImgBuf address of the even image memory nColSystem code for color system see Set_Color_System nInterlace 0 Non Interlace 1 Interlace 2 Field Aligned nSingleShot 0 continuous digitization 1 one single image is grabbed...

Page 172: ...t size This is achieved by utilization of the well known instructions for the allocation of memory for example malloc How much memory will be used This will be calculated from the size of the image number of pixels and the required number of Bytes per pixel color resolution Memory requirements per field hsize vsize pixel size Byte The value pixel size can be depicted from Table 12 For the format Y...

Page 173: ... the parameter pEImgBuf Note This region must contain both fields so that the region must be twice in size of one field The odd parameter pOImgBuf is not used in the interlaced mode nInterlaced 1 If only one field even or odd should be digitized the pointer of the field which is not digitized is set to NULL Therefore if only one even field is required you have to set pOImgBuf NULL Finally the type...

Page 174: ...nization in a 20 ms cycle for image actualization nSingleShot 1 has the effect that only one digitization takes place Two fields are taken one odd one even or one whole frame The user can record the images and with repeated starts new data are stored in the memory This mode of operation is recommended in case only occasionally images are digitized and no real time application is required In any ca...

Page 175: ...or Status The eGrabber 4plus can generate an interrupt if the end of a half image is recognized at the video input If a digitalization procedure is active then it can be determined with the aid of the interrupt and without polling see Data_Present when this procedure is finished A digitalization procedure can only be complete at the end of a half image which is signaled by the interrupt However an...

Page 176: ...nerated as soon as a video signal is connected to the preset video input The interrupts occur in 20 ms intervals Unusually strong interference in the input signal as well as switching input channels can also generate an interrupt The interrupt function should only be switched on during an active digitalization procedure in other words in the space between Start_Grabber and Stop_Grabber The eGrabbe...

Page 177: ...lag In order to do this the function Reset_Interrupt has to be called up from the interrupt handling routine Ø ê Number of Digitized Images The eGrabber 4plus allows the user to count the number of digitized images The following two functions are available for this purpose These functions are not compatible with the eGrabber 2 unsigned char Get_CaptureCounter unsigned short nDevNo Return value Num...

Page 178: ...of the image void Set_Brightness unsigned short nDevNo short nBright nBright brightness 128 127 Ø Reading the brightness setting short Get_Brightness unsigned short nDevNo return value Content of the register holding the value for brightness in the video processor Ø Setting the contrast void Set_Contrast unsigned short nDevNo unsigned short nContr nContr contrast 0 511 Ø Reading the contrast setti...

Page 179: ... Get_Sat_V unsigned short nDevNo return value value of the actual U or V color saturation resp Ø Correction of the hue NTSC only void Set_Hue unsigned short nDevNo short nHue nHue hue phase position of the color signal 128 127 Ø Reading the content of the registers for hue short Get_Hue unsigned short nDevNo return value value of the phase position of the color signal Ø De activation of the luma l...

Page 180: ...ed 1 8 all brightness values 8 are interpreted as 0 2 16 all brightness values 16 are interpreted as 0 3 32all brightness values 32 are interpreted as 0 Ø Reading Writing data via the GPIO port The following three functions control the GPIO port part of the user connector void Set_GPIO_Direction unsigned short nDevNo unsigned short nDirection nDirection can have values between 0 and 4095 void Set_...

Page 181: ...ddress unsigned char bByteRead bChipAddress Device address of the I C device connected to the bus bSubAddress Internal memory address for the I C device bByteRead Pointer points to the Byte variable The result is written in the Byte variable return value SUCCESS NOACK INVALID_ADDRESS unsigned char I2C_WriteByte unsigned short nDevNo unsigned char bChipAddress unsigned char bSubAddress unsigned cha...

Page 182: ...ons are not compatible unsigned char I2C_ReadEEProm unsigned short nDevNo unsigned char bSubAddress unsigned char bByteRead bSubAddress memory address to be read 0x00 0xFF bByteRead Pointer points to a Byte variable The result is written into the Byte variable return value error code SUCCESS NOACK unsigned char I2C_WriteEEProm unsigned short nDevNo unsigned char bSubAddress unsigned char bData bSu...

Page 183: ...e 0 CLOSE 1 HI Z unsigned char Read_Ext_IO unsigned short nDevNo nDevNo device number return value logical level of the I O pin Ø Direct access to the grabber registers The following functions allow direct access to the registers of the video input controller short Read_Local_DWord unsigned short nDevNo unsigned short nRegister_Number unsigned long lContent nRegister_Number register addressNummer ...

Page 184: ... image is 256 x 256 pixels and should be stored as RGB color picture using the RGB24 format RGB24 requires 3 Byte per pixel So we need 256 256 3 Byte for one image The operation of the Grabber starts with the identification to check if a Grabber is available Max_Device_Number delivers the number of Grabber boards installed in the system If the number 0 no Grabber board is available in the computer...

Page 185: ...e upper left corner of the TV picture Caution 0 0 will leave the values unchanged which were set before As demanded in the problem we now define the number of pixels required for the resulting image of 256 x 256 The field delivered from the source will be digitized with the complete size of the format with the ratio 4 3 Therefore the size of the image will be set to 344 x 258 A maximum of 360 x 28...

Page 186: ... order to mask the third bit bit 2 This is the S_EVEN bit see Figure 49 This bit will be set after the even image is stored completely in the memory Since only this information is interesting to us the other status bits are masked out The delay time in the loop prevents that the status is permanently inquired which might be disturbing for the data transfer on the PCI Bus After the end of the digit...

Page 187: ...l and delay 100 Wait until synchronized Grabber Set_Image 1 Grabber number 0 0 All ODD parameters are 0 0 negligible and 0 0 therefore 0 are set to 0 NULL Pointer to ODD image NULL no ODD image 1 1 upper left corner of the EVEN image 256 256 Size of the image section 344 258 Size of the image RGB24 Color information RGB24 image pEWert Pointer to EVEN image memory PAL_BDGHI Color system 0 Interlace...

Page 188: ...eGrabber 4plus 178 PHYTEC Meßtechnik GmbH 2004 L 608e_4 ...

Page 189: ...ot used rather the driver is linked as a library for the compiler in user programs In order to ensure that the eGrabber 4plus operates with these programs a new driver library must be linked This means that the program must be newly compiled There are no changes for user specific program code The software interfaces for the driver library under the eGrabber 4plus and the eGrabber 2 are also compat...

Page 190: ...tical to those of the eGrabber 2 and you can power it with the same power adapter In order to make it easier for you to remove the pins those pis that are compatible with the eGrabber 2 have a white border around them One of the main differences between the eGrabber 4plus and the eGrabber 2 is that the SMB Sockets P3 and P4 have been removed Previously it was possible to feed in an S Video signal ...

Page 191: ...n for V3 0 If software has been developed for the eGrabber 4 that is still used in conjunction with older driver versions before Version 3 0 please read the following notes The Window s DLL was expanded with the function GetVersionNumber If a non valid function pointer is returned with GetProcAddress then a newer version of GR4CDLL DLL is required Set_Image Function In previous versions the hpos a...

Page 192: ...eGrabber 4plus 182 PHYTEC Meßtechnik GmbH 2004 L 608e_4 ...

Page 193: ...ot connected to a video source Usually a blue image is shown Please check if the correct input channel is selected m The digitized image shows streaks and stripes l It might be a Moiré effect caused by the color signal Check if the luma notch filter is enabled l The cable to the camera might be defect check shielding l A ground loop might be existent by an additional ground con nection between PC ...

Page 194: ...atus l Was the resolution reduction concerning to time used m The image has no contrast too bright too dark l Check the setting of brightness contrast etc l If necessary activate the AGC m The image skips or the fields are mismatched l The time delay during switching the channels was too short m The image appears without color with the wrong format l Is the appropriate color system selected l Was ...

Page 195: ...t for a correct Hue setting the U and V component must be identical in respect to their percentage value But the values of the registers are different m During continuous grabbing the image jumps one line up down l The parity of the field is neglected Pay attention in order to demand always the same field The memory region for the even and odd image should not be the same Note The mismatch is actu...

Page 196: ...tion with true colors for a resolution of 640 x 480 pixels the standard VGA Modus is not sufficient m In frame mode using continuous monitoring a shadow effect is recognized despite the Grabber digitizing two complementary fields in real time l The effect is due to the slow speed of the host PC displaying the image The update at the screen is not fast enough even through the images are found digit...

Page 197: ...Is the circuit breaker SI301 functioning l Has a short circuit overload occurred adapter shuts off l Was the adapter switched off over connector X301 For operation X301 must be open or Pin 1 has to be on HIGH level If necessary as a test remove one of the connectors from X301 m The green LED for 12 V does not illuminate and the 12 V output voltage is not present The 5 V supply voltage functions l ...

Page 198: ...apter The overload protection then automatically reduces the output voltage in order to prevent damage to the adapter l If you wish to direct the voltage into the system over the PC 104 headers you have to configure the jumper field JP301 in a corresponding manner see section 1 10 3 l If you use a Jumptec MOPS CPU Card you may have to populate the socket connector X302 in order to supply the CPU c...

Page 199: ...y adding resistance to WKH GHYLFH V VXSSO YROWDJH WR m The displayed image is disturbed by horizontal stripes which might show parts of the preceding image For moving objects hori zontal lag effect occur l The Grabber is not able to transfer the image data in real time via the PCI bus since other cards on the bus stress the bus too much or the bus configuration of the BIOS is not correct l The Gra...

Page 200: ...can respond and parameters can be written or read or be changed This is an advantage for example if the channel selection should be changed and the time span could be used as lead time so that the analogue signal is recognized correctly by the Grabber Under DOS the programmer can define a separate memory region for each Grabber Here parallel processing is possible However it must be considered tha...

Page 201: ...omposite sources 45 Connectors 6 Contrast 58 Cross Hairs Blending In Out 60 D Data Format 3 Delivery 1 Demo program Image Settings 52 Demo Program Channel Selection 52 Image Resolution 53 Image Selection 53 Installation 42 Operations 47 Demo Programing Normalizing 65 Developing environments 84 Device driver WIN 98 ME 39 Win NT 4 0 40 Win95 38 Device ID 30 Digitalization Foundations 82 DLL 92 Drive...

Page 202: ... I2C_Set_BR_Mode 144 I2C_WriteByte 145 I2C_WriteEEProm 146 LumaControl 142 Max_Device_Number 101 Read_Ext_IO 148 Read_GrabberInfo 102 Read_Local_DWord 148 Read_OrderCode 103 Reset_CaputerCounter 137 Set_AGC 111 Set_Brightness 137 Set_BW 109 Set_ChannelEx 108 Set_CKill 112 Set_Color_System 104 Set_ColorBars 141 Set_Composite 105 Set_Contrast 138 Set_Ext_IO 147 Set_GPIO_Data 143 Set_GPIO_Direction 1...

Page 203: ...mpatability 175 PCI Socket 33 PHYTEC Vision Tools Drivers and Demos 38 Pinout 11 port pin 147 Ports 5 Power Supply 3 Power Supply from the Camera Compaibility 177 R Reducing Noise Levels 66 Replacement fuse 2 S Similar television technology 54 Single Image 59 Slot 30 Slot Number 30 Snapshot 59 Snapshots 59 Storing Images Demo Program 68 Storing Images Under DOS 160 Storing Parameters 146 Supply Vo...

Page 204: ...eGrabber 4plus 194 PHYTEC Meßtechnik GmbH 2004 L 608e_4 ...

Page 205: ...Grabber 4plus Document number L 608e_4 June 2004 How would you improve this manual Did you find any mistakes in this manual page Submitted by Customer number Name Company Address Return to PHYTEC Technologie Holding AG Postfach 100403 D 55135 Mainz Germany Fax 49 6131 9221 33 ...

Page 206: ...Published by PHYTEC Meßtechnik GmbH 2004 Ordering No L 608e_4 Printed in Germany ...

Search results

Summary of Contents for eGrabber-4plus

Reviews:

Related manuals for eGrabber-4plus

Brands by name

Popular brands

Phytec eGrabber-4plus, Hardware Manual

Search results

Summary of Contents for eGrabber-4plus

Reviews:

Related manuals for eGrabber-4plus

Brands by name

Popular brands