Alacron FAST-UXGA, Техническое руководство по продукту

Страница: 17 / 28

17 of 28
id(1) float Zoom;
This variable controls how the images are displayed on the controls surface. When set to 1.0
the pixels of the image are display as pixels on the screen, this is some time called 1:1 viewing.
If set to less than one a larger piece of the image is displayed (zoom out). If set larger than one
a small portion of the image is displayed (zoom in).
id(2) long XOrigin;
This property controls which pixel is displayed in the upper left corner of the OCX display
surface. Large values display pixels to the right.
id(3) long YOrigin;
This property controls which line is displayed at the top of the OCX display surface. Larger
values move down the image.
id(4) boolean RedEnable;
If the image is color, and the RedEnable is true, then the first plane of the image is displayed. If
it is false the first plane is not displayed. For non-RGB formats for example YUV 4:4:4 this
refers to the Y part of the image. All images are converted from their native format to RGB
when input to the control. Typically no color space conversion is done.
id(5) boolean BluEnable;
If the image is color, and the BlueEnable is true, then the last plane of the image is displayed. If
it is false the last plane is not displayed. For non-RGB formats for example YUV 4:4:4 this
refers to the V part of the image. All images are converted from their native format to RGB
when input to the control. Typically no color space conversion is done.
id(6) boolean GrnEnable;
If the image is color, and the GrnEnable is true, then the middle plane of the image is
displayed. If it is false the middle plane is not displayed. For non-RGB formats for example YUV
4:4:4 this refers to the U part of the image. All images are converted from their native format to
RGB when input to the control. Typically no color space conversion is done.
id(7) boolean AutoZoomAndPan;
This flag controls whether the use of the control can pan and zoom the control view with the
mouse and the shift key.
Normally the mouse just moves the cursor over the image. If the shift key is held down (either
one), the image will pan. The panning area is the central portion of the display area, and is
scaled so you can pan of the whole image without double dragging.
id(14) boolean Rotated;
This flag allows one to rotate the image 90 degrees, before displaying.
id(18) readonly] float Compression;
This property is set to the compression level of a JPEG image if one
is passed to the control.
ALPICTURE M
ETHODS
id(8) Update(long* Image, short Shift);
This method is used to provide a pointer to the image structure containing the image. The shift
factor is applied to the pixel planes before display. The image structure is defined below. A long
pointer is used to avoid complexity in the IDL of little benefit. As the pointer is being passed into
the control, this method can not be used across processes. The Update API is canned by the
Create API and is typically not used by a user. The Update method assumes that the image
surface has already been setup in memory to match the display characteristics of the display
mode in effect.
id(9) Create(long* Image, short Shift);
This method is used to provide a pointer to the image structure containing the image. The shift
factor is applied to the pixel planes before display. The image structure is defined below. A long
pointer is used to avoid complexity in the IDL of little benefit. As the pointer is being passed into