hmCal_Area To Picture File

hmCal_Area To Picture File (area;path;format) -> Error

Parameter          Type             Description
area               Longint      ->  hmCal area
path               Text         ->  Path or empty string for default
format             Longint      ->  picture format
Error              Longint      <-  Error code

Description

The command hmCal_Area To Picture File writes a picture file on the hard disk. The area can be both on the screen indicated area, and with hmCal_New Offscreen Area created area. Scrollbars are not drawn in the picture.

The parameter path defines the location of the picture file. If you pass an empty string, the picture is written to the application folder. The standard filename ist "hmCal".

hmCal supports following native picture formats:

1 = jpg
2 = png
3 = bmp
4 = gif
5 = tiff
6 = pdf (only on macintosh)
7 = SVG

You can also use the predefinied Constants.

You can define your own size of the picture by using the selectors hmCal_prop_PrintingWidth and hmCal_prop_PrintingHeight with the command hmCal_SET AREA PROPERTY.

Example

The following example saves the hmCal area to the hard disk:

C_LONGINT($vl_error)

$vl_error:=hmCal_Area To Picture File(hmCal;"MACINTOSH HD:hmCal.jpg";hmCal_picture_jpg)