SaveSnapshot(f$[, mode, fmt, table])
modeargument specifies the area to be grabbed. This can be
#SNAPWINDOW, which means that the Hollywood window will be grabbed (with borders),
#SNAPDISPLAY, which means that only the display's contents will be grabbed or
#SNAPDESKTOP, which means that the complete host screen will be grabbed. The
fmtargument specifies the desired output format for the file (defaults to
#IMGFMT_BMPwhich will save a 24-bit BMP picture).
Starting with Hollywood 2.5, you can also pass
#IMGFMT_PNG as the format.
SaveSnapshot() will then save the snapshot as a PNG picture.
Starting with Hollywood 4.0, you can also pass
#IMGFMT_JPEG as the format.
SaveSnapshot() will then save the brush as a JPEG picture. The
tag in the optional table argument allows you to specify the quality
level for the JPEG image (valid values are 0 to 100 where 100 is the best
Starting with Hollywood 4.5, you can also pass
as format. If you use
#IMGFMT_GIF, the snapshot will be saved as a GIF
image. Because GIF images are always palette based, you can use the
Dither tags of the optional table argument to specify the
number of palette entries to allocate for the image and whether or not
dithering shall be applied. If you choose
#IMGFMT_ILBM, the snapshot will
always be saved as a true color (24 bit) ILBM image.
The optional table argument allows you to configure further parameters:
Trueto enable dithering. This tag is only handled when the destination format is palette-based. Defaults to
Falsewhich means no dithering.
Here is an overview that shows which formats support which tags:
Please note that technically it is also possible to create palette-based
BMP, PNG, and ILBM images. However, Hollywood currently does not support
this and will always create true color (24 bit) images for these formats.
This is why you cannot use the
Colors tags for these
#IMGFMT_ILBM(V4.0) (defaults to
SaveSnapshot("Snap.bmp")Saves a snapshot of the Hollywood window to "Snap.bmp".