CwGetBitmapInfo

Syntax:

call CwGetBitmapInfo path, stem

        ("stem" is the name of a stem variable in which the results are
         stored.  There are 2 fields of the stem that are set.)

        path            (string) The path to the bitmap file.

        stem.width      (numeric) The actual width (in pixels) of the
                        bitmap as stored in the file.

        stem.height     (numeric) The actual height (in pixels) of the
                        bitmap as stored in the file.

Description:

This function returns information about a bitmap. The bitmap is identified by its filename. However, it must be loaded into memory for this function to work. Thus, the ideal way to obtain a bitmap name is to extract the "Image" property of an existing bitmap object.

Example:

/* Restore a bitmap to its correct aspect ratio.*/
bm = CwGetSelectedObject()
t = CwGetProperty(bm, "tool type")

if t \= "Bitmap" then do
        say "Must select a bitmap."
        exit
        end

bt = CwGetTool(bm)
bmp = CwGetProperty(bt,"image")

call CwGetBitmapInfo bmp, 'bminfo'
r = bminfo.width / bminfo.height

call CwGetPosition bm, bmdim
nheight = bmdim.width/r
call CwSetPosition bm, bmdim.x, bmdim.y, bmdim.width, ,
        nheight, bmdim.rotation, bmdim.xshear

Functions by NAME

Index

Functions by PURPOSE