Academic Company Events NI Developer Zone Support Solutions Products & Services Contact NI MyNI
3 ratings:
 3 out of 5     Rate this Document

IMAQVIEW3D Does Not Exist in the CVI or the C++ Interfaces

Primary Software: LabWindows/CVI Add-ons>>Vision Development Module
Primary Software Version: 5.0
Primary Software Fixed Version: N/A
Secondary Software:

Problem: The function imaqView3D does not exist in the CVI or C++ interfaces for IMAQ Vision 5.0.

Solution: The function does exist in the driver dynamic link library (DLL) and the import information is present in the interface library. This means that we still have access to the function, but we do not have a prototype or a function panel in CVI.

To make the call we must first prototype the function. We should add the following line to the source code:

int __stdcall imaqView3D (Image* dest, Image* source, const View3DOptions);

The first two parameters are the destination image and the source image. The View3DOptions structure is defined in nivision.h and has the following definition:

typedef struct View3DOptions_struct {
int sizeReduction;
int maxHeight;
Direction3D direction;
float alpha;
float beta;
int border;
int background;
Plane3D plane;
} View3DOptions;

The parameters are defined as follows:

sizeReduction: a factor applied to the source image to calculate the final dimensions of the 3D view image. This factor is a divisor that is applied to the source image when determining the final height and width of the 3D view image. A factor of 1 uses all of the pixels of the source image when determining the 3D view image. A factor of 2 uses every other line and every other column of the pixels of the source image to determine the 3D view image.

maxHeight: defines the maximum height of a pixel from the image source that is drawn in 3D. This value is mapped from a maximum of 255 (from the source image) in relation to the baseline in the 3D view. A value of 255, therefore, gives a one-to-one correspondence between the intensity value in the source image and the display in 3D view. The default value of 64 results in a four-fold reduction between the original intensity value of the pixel in the source image and the final displayed 3D image.

Direction3D: defines the viewing orientation shown for the 3D view. The following four viewing angles are possible:
    IMAQ_3D_NW
    IMAQ_3D_SW
    IMAQ_3D_SW
    IMAQ_3D_NE
alpha: defines the angle between the horizontal and the baseline. The value can be between 0° and 45°.

beta: defines the angle between the horizontal and the second baseline. The value can be between 0° and 45°.

border: defines the border size in the 3D view.

background: defines the background color for the 3D view.

plane: specifies the view to display if the image is complex. The following four possible planes can be visualized from a complex image:
    IMAQ_3D_REAL = 0,
    IMAQ_3D_IMAGINARY = 1,
    IMAQ_3D_MAGNITUDE = 2,
    IMAQ_3D_PHASE


Related Links:

Attachments:





Report Date: 05/01/2000
Last Updated: 10/18/2002
Document ID: 1X0F44NE

Your Feedback! poor Poor  |  Excellent excellent   Yes No
 Document Quality? 
 Answered Your Question? 
  1 2 3 4 5
Please Contact NI for all product and support inquiries.submit