Cut

(Obsolete)

Description: This statement allows a HALO™ type .CUT, or .PCX type file or to be placed on the screen with the scaling and location set by the parameters.

Returns: Nothing

Usage: Steady State

Format: Cut(X, Y, Width, Height, Reserved, File)

Parameters: X { numeric } { required } { no default: }

Any numeric expression giving the X screen coordinate of the left side of the image.

Y { numeric } { required } { no default: }

Any numeric expression giving the Y screen coordinate of the bottom edge of the image.

Width { numeric } { required } { no default: }

Any numeric expression giving the width of the image as it is to appear on the screen. The image will be scaled appropriately. The units of the Width are in X screen coordinates. If Width is 0, the actual width on the screen will be the unscaled width contained in the .CUT file.

Height { numeric } { required } { no default: }

Any numeric expression giving the height of the image as it is to appear on the screen. The image will be scaled appropriately. The units of the Height are in Y screen coordinates. If Height is 0, the actual height on the screen will be the unscaled height contained in the .CUT file.

Reserved { numeric } { required } { no default: }

Reserved for future use. Set to 0.

File { text } { required } { no default: }

A text expression giving the file name for the .CUT or .PCX file. The full name must be specified including the path name if it is not in the default directory. To specify a constant file name, enclose the name in double quotes. The default extension is .CUT, which may be overridden by specifying an alternative. If the file name is prefixed with a period, the path will be to the directory in which the module is contained.

Comments: This statement has been superseded by the GUIBitmap function and is maintained for backwards compatibility only.

This statement allows a great deal of flexibility for the changing of images based upon variables. It can be used to place an en tire background image on the screen. This statement is device independent. A similar image will appear on any supported monitor regardless of color capabilities or resolution. The image will look smaller in higher resolution modes unless the image is scaled using the height and width parameters (because the same number of pixels are displayed, but the number of screen pixels is greater). Scaling distorts the image and is not recommended.

Note: Cut does not affect the color palette settings, so colors may appear differently than shown in Dr. Halo™ (or any other paint package used to draw the image). Use the Palette statement to adjust color palette settings.

Example:

Cut(200, 300 { X, Y coordinates of lower left corner },

0, 0, 0 { No scaling or rotation },

Cond(Open, "OPENGATE", "SHUTGATE"))

{ Change image based on gate position });

This shows how to display a changing image. In this example, one of two images is displayed by changing the name of the image file. Partial images may be saved from Dr. Halo™ using the "floppy disk" icon.