Syntax
Create Object As Isogram
From fromtable
[ Into { Table intotable } ]
[ Data column = expression [ , column = expression... ] ]
Connection connection_handle
[ Distance dist1 [[ Brush ... ] [ Pen ... ]]
[ , dist2 [ Brush ... ] [ Pen ... ]]
[ , distN [ Brush ... ] [ Pen ... ] [ ,...]
Units dist_unit ]
[ Time time1 [[ Brush ... ] [ Pen ... ]]
[ , time2 [ Brush ... ] [ Pen ... ]]
[ , timeN [ Brush ... ] [ Pen ... ]] [ ,...]
Units time_unit ] connection_handle is a number expression returned from the Open Connection statement referencing the connection to be used.
dist1, dist2, distN are numeric expressions representing distances for the Isograms expressed in dist_units.
Brush is a valid Brush clause to specify fill style.
Pen is a valid Pen clause to specify a line style.
dist_unit is a valid unit of distance (for example, "km" for kilometers). See Set Distance Units statement for a complete list of possible values.
time1, time2, timeN are numeric values representing times for Isograms expressed in time_units.
time_unit is a string representing valid unit of time. Valid choices are: "hr", "min", or "sec".
Description
If the Create Object statement performs an Isogram operation, you must pass a connection_handle that corresponds to an open connection created with an Open Connection statement. You must specify a Distance clause or a Time clause to create the size of the Isogram desired. The Distance clause can contain one or more distance expressions with an optional brush and/or pen for each one. If you do not specify a Brush clause or Pen clause the current brush and pen is used. No matter how many Distance instances you specify a single Units string must be provided to indicate the units in which the distances are expressed.
By specifying a Time clause, you can create regions based on time, with each one having an optional Brush clause and/or Pen clause. If you do not specify a Brush clause or Pen clause the current brush and pen is used. No matter how many Time instances you specify a single Units string must be provided to indicate the units in which the times are expressed. The maximum amount of values allowed is 50. Each value creates a separate band that can be either specific times or specific distances. Larger values take substantially longer to create. Many items factor into the equation, but in general, using the Set Connection Isogram statement with MajorRoadsOnly specified, results in a much quicker response compared to using the entire road network. MapBasic only allows distances of 35 miles with MajorRoadsOnly Off and 280 miles with MajorRoadsOnly On. similarly, the maximum time is 0.5 hours with MajorRoadsOnly Off and 4 hours with MajorRoadsOnly On.
See Also:
Buffer() function, ConvexHull() function, Objects Combine statement, Objects Erase statement, Objects Intersect statement, Open Connection statement