Custom Bitmap File - MapBasic - 2023

MapInfo MapBasic Reference

Product type
Software
Portfolio
Locate
Product family
MapInfo
Product
MapInfo > MapBasic
Version
2023
Language
English
Product name
MapBasic
Title
MapInfo MapBasic Reference
First publish date
1985
Last updated
2023-09-12
Published on
2023-09-12T16:32:32.686312

Syntax

Symbol( filename, color, size, customstyle )

filename is a string up to 31 characters long, representing the name of a bitmap file. The file must be in the CustSymb directory.

color is an integer RGB color value; see RGB() function.

size is an integer point size, from 1 to 48.

customstyle is an integer code controlling color and background attributes. See table below.

Description

When you specify a custom symbol, the customstyle argument controls background, color, and display size settings, as described in the following table.

customstyle value Symbol Style
0 The Show Background, the Apply Color, and the Display at Actual Size settings are off; the symbol appears in its default state at the point size specified by the size parameter. White pixels in the bitmap are displayed as transparent, allowing whatever is behind the symbol to show through.
1 The Show Background setting is on; white pixels in the bitmap are opaque.
2 The Apply Color setting is on; non-white pixels in the bitmap are replaced with the symbol's color setting.
3 Both Show Background and Apply Color are on.
4 The Display at Actual Size setting is on; the bitmap image is rendered at its native width and height in pixels.
5 The Show Background and Display at Actual Size settings are on.
7 The Show Background, the Apply Color, and the Display at Actual Size settings are on.