1.13.2 Send methods

bitmap ->geometry: x=[int], y=[int], width=[int], height=[int]

Just moves the bitmap. In the current implementation bitmaps cannot be scaled.

bitmap ->image: image

Associate an image with a bitmap. Sets the width and height of the bitmap to the width and height of the image. If the image has bitmap<->access both and bitmap<->bitmap @nil, the bitmap<->bitmap variable of the image is filled with the bitmap. Subsequent changes to the image are forwarded to the bitmap.

See also

image-bitmap

bitmap ->initialise: image=[image]

Create a bitmap for the given image object. The bitmap will be given the same graphical<-width and graphical<-height as the image.

Note that images are automatically converted from names (see image->initialise). Thus, the following displays XPCE's icon on a picture window:

?- send(new(P, picture), open),
   send(P, display,
            bitmap('16x16/pce.xpm'), point(25, 25)).

By default, image objects are cached (i.e. remain in memory). If you have many or large ones, please study image->initialise and image->load.

bitmap ->load: file, path=[char_array]

Load file in the associated image. XPCE searches for the file in the path described by the last argument. The default path is image.path.

Backward compatibility only. New code should manipulate the image directly.

Defaults: The default search path is determined by the resource bitmap.path. Its system defined value is

.:~/lib/bitmaps:$PCEHOME/bitmaps:/usr/include/X11/bitmaps

Diagnostics: Fails silently on bad format or non-existing file.

See also

bitmap->save