CITIZEN Android Label Print SDK
—
Programming Manual
64
2.3.6 drawBitmap method
Syntax
1)
int drawBitmap (String filePath, int rotation, int width, int height, int x, int y)
2)
int drawBitmap (String filePath, int rotation, int width, int height, int x, int y,
int resolution, int measurementUnit)
Parameters
Parameter
[IN/OUT] Description
Setting range
filePath
[IN]
Path to a local graphic file
rotation
[IN]
Direction of rotation
CLS_RT_NORMAL: No rotation
CLS_RT_RIGHT90: Rotate CW 90
CLS_RT_ROTATE180: Rotate CW 180
CLS_RT_LEFT90: Rotate CCW 90
width
[IN]
Drawing width [Pixel]
height
[IN]
Drawing height [Pixel]
x
[IN]
X-coordinate
0000-9999
* The origin is at bottom-left.(0, 0)
y
[IN]
Y-coordinate
resolution
[IN]
Resolution [dpi]
CLS_PRT_RES_203(203dpi)
CLS_PRT_RES_300(300dpi)
* 203 dpi by default.
measurementUnit [IN]
Printer Metric / Inch setting
CLS_UNIT_MILLI
CLS_UNIT_INCH
* CLS_UNIT_INCH by default.
Description
Draws a graphic image stored in the local computer, with specifying options such as rotation, size and
coordinates.
What this method does internally is to store a graphic image into the printer and to print the stored
graphic image. This doesn't check the availability or validity of the stored file. When specifying
image rotation, it is necessary to specify the resolution and unit selection settings according to the
printer for reference position correction.
Supported graphic file formats are BMP/GIF/EXIF/JPG/PNG/TIFF.
The graphic will be resized based on the width/height parameters with keeping the aspect ratio and
taking the maximum available size to fit.
Example: The sizes will be "200x50" in the case below.
Original sizes: 400x100 pixels
Width parameter: 200
Height parameter: 200
When 0 is set to either width or height, the sizes will be calculated based on another (non-zero)
parameter. When both parameters are zero, the original sizes will be used.
Example
：
The sizes will be "800x200" in the case below.
Original sizes: 400x100 pixels
Width parameter: 0
Height parameter: 200
Return value
Returns CLS_SUCCESS(0) on success, an error code otherwise. See "
" for the error
codes.
