Purpose
Combines a number of points into a single object. All points have the same symbol. The Multipoint object displays in the Browser as a single record. You can issue this statement from the MapBasic window in MapInfo Pro.
Syntax
Create Multipoint
[ Into { Window window_id | Variable var_name } ]
[ num_points ]
( x1, y1 ) ( x2, y2 ) [ ... ]
[ Symbol... ]window_id is a window identifier.
var_name is the name of an existing object variable.
num_points is the number of points inside Multipoint object.
x y specifies the location of the point.
The Symbol clause specifies a symbol style.
Currently MapInfo Pro uses the following four different syntaxes to define a symbol used for points:
Syntax 2 (MapInfo Pro's 3.0 Symbol Syntax)
Symbol ( shape, color, size )shape is an integer, 31 or larger, specifying which character to use from MapInfo Pro's standard symbol set. MapInfo 3.0 symbols refers to the symbol set that was originally published with MapInfo for Windows 3.0 and has been maintained in subsequent versions of MapInfo Pro. To create an invisible symbol, use 31. The standard set of symbols includes symbols 31 through 67, but the user can customize the symbol set by using the Symbol application.
color is an integer RGB color value; see RGB() function.
size is an integer point size, from 1 to 48.
Syntax 3 (TrueType Font Syntax)
Symbol ( shape, color, size, fontname, fontstyle, rotation )shape is an integer, 31 or larger, specifying which character to use from a TrueType font. To create an invisible symbol, use 31.
color is an integer RGB color value; see RGB() function.
size is an integer point size, from 1 to 48.
fontname is a string representing a TrueType font name (for example, "Wingdings").
fontstyle is an integer code controlling attributes such as bold.
rotation is a floating-point number representing a rotation angle, in degrees.
Syntax 4 (Custom Bitmap File 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 (unless a Reload Symbols statement has been used to specify a different 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.
Syntax 5
Symbol symbol_expr symbol_expr is a Symbol expression, which can either be the name of a Symbol variable, or a function call that returns a Symbol value, for example, the MakeSymbol() function.
Example
Create Multipoint 7 (0,0) (1,1) (2,2) (3,4) (-1,1) (3,-2) (4,3)See Also: