View source for @...SAY...BITMAP

==Purpose==
Display a bitmap image


==Syntax==
@<expN1>,<expN2> SAY <expC> BITMAP

[CENTER]

[ISOMETRIC | STRETCH]

[SIZE <expN3>,<expN4>]


==See Also==
[[@...GET]], [[@...SAY]], [[SET COMPATIBLE]], [[SET FILETYPE]]


==Description==
The FoxPro compatible @...SAY...BITMAP command is used to display images in Recital Mirage applications.  The top left hand corner of the image is displayed at row <expN1>, column <expN2>.  The name of the file to be displayed is specified in the character expression <expC>.  The supported file formats are GIF and JPG.

====CENTER====
If the CENTER keyword is specified, the image is centered in the limits specified in the SIZE clause.

====ISOMETRIC | STRETCH====
The ISOMETRIC and STRETCH keywords can be used to determine the display behavior when the image dimensions and the SIZE dimensions do not match.  If ISOMETRIC is specified, the image is scaled using its original proportions.  If STRETCH is specified, the image is stretched to fit and the original proportions are not maintained.  If the SIZE dimensions are smaller than the image size and neither ISOMETRIC nor STRETCH is specified, the image is clipped to fit.

====SIZE <expN3>,<expN4>====
The size clause can be included to specify the display size of the image.  If the SIZE clause is omitted, the image is displayed at its default size.  The height of the image is specified in <expN3> and the width in <expN4>.  Both the height and the width are specified as multiples of the current font size.


==Example==
<code lang="recital">
@5,0 say "Image:           "
@6,0 say "recital.jpg" bitmap;
  size 6,12
</code>


==Products==
Recital Mirage
[[Category:Documentation]]
[[Category:Commands]]
[[Category:Input Output]]
[[Category:Input Output Commands]]