PICFILL

PICFILL

Defines a region and fills it with an image

Category: Image

Syntax
Commands Used with PICFILL
Details
Example

Syntax

region-id=PICFILL(graphenv-id,type,ulr,ulc,lrr,lrc, source,<command<,arguments>>);

rc

contains the return code for the operation:

0	indicates that an error condition occurred.
>0	is the number identifying the region that was just defined.

Type: Numeric

graphenv-id

contains the graphics environment identifier that was returned by PICOPEN.

Type: Numeric

type

is the type of item to be displayed: IMAGE, GRSEG, or BITMAP.

Type: Character

ulr

is the upper left row of the screen area in which to display the image or graphics segment.

Type: Numeric

ulc

is the upper left column of the screen area in which to display the image or graphics segment.

Type: Numeric

lrr

is the lower right row of the screen area in which to display the image or graphics segment.

Type: Numeric

lrc

is the lower right column of the screen area in which to display the image or graphics segment.

Type: Numeric

source

specifies the location of the image.

For type BITMAP, specify the numeric value of a bitmap in a host-dependent resource file.

For type GRAPH, specify the four-level name of the graphic segment to be displayed.

For type IMAGE, specify either the name of an external file to be loaded or the path string from the LNAMEMK function.

Type: Numeric or Character

commands

lists commands that are used with type IMAGE to manipulate the image before displaying it. Valid commands are listed in Commands Used with PICFILL.

Type: Character

arguments

are arguments for the specified command.

Type: Numeric

Commands Used with PICFILL

For detailed information about these commands, see Commands Used with the IMGCTRL, IMGOP and PICFILL Functions .

CROP: crops the selected image.
DITHER: dithers an image to a color map.
DITHER_BW: dithers the selected image to a monochrome black and white image.
EXECLIST: executes a list of commands.
GAMMA: applies a gamma value to the selected image.
MAP_COLORS: maps colors to the closest color in the selected color map.
MIRROR: mirrors an image.
NEGATE: changes the image to a negative.
QUANTIZE: reduces the number of colors used for an image.
ROTATE: rotates an image clockwise by 90, 180, or 270 degrees.
SCALE: scales an image.

Details

PICFILL performs two functions:

It defines the four corners of the region in which the image is to be displayed.
It fills the region with the specified image.

If you specify a command, the PICFILL manipulates the image before displaying it.

Example

Display an image when the window opens:

init:
   imgfile=lnamemk(2,location,file);
   region_id=picfill(graphenv_id,"IMAGE",
                     15,12,40,78,imgfile);
return;

Chapter Contents
Previous
Next
Top of Page