Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The MAP object corresponds to the Map system object.

The MAP object sends the events presented in the table.   Procedure The procedure is started when the corresponding event appears. Format of events procedure for the map:

Code Block
OnEvent("MAP", "_id_","_event_" [,"_parameters_"])

occurs.

EventDescription
LAYER_ACTIVATEDLayer activation. This event is received when a Layer layer is selected on the Map. The layer ID is put into the obj_id<> parameter .has the ID of the activated layer
ACTIVATE_OBJECT

Object activation. The event is received when an object is selected (activated by mouse click) on the

map

Map.

Parameters:

  1. obj_type
<>  object type
obj_id <>  object ID
  1. <>—object type
  2. user_id<>—user ID
  3. module<>—module name, for the Map—map.run
  4. date<>—date when the event occurred
  5. time<>—time when the event occurred
  6. slave_id<>—computer network name
  7. obj_id <>object ID
  8. layer<>—Map layer ID
  9. fraction<>—millisecond when the event occurred
  10. owner<>—user who activated the object
  11. type_of_display
<> 
  1. <>—object display type
;
  1. , possible values:
      IMAGE 
        1. IMAGEimage
        2. IMAGE_AND_
      INDICATOR 
        1. INDICATORimage and indicator
        2. TEXT
      – 
        1. text
      LINE 
        1. LINEline
      POLYGON 
        1. POLYGONpolygon
      ELIPSIS 
        1. ELIPSISellipse
      TITLE 
        1. TITLEthe name of the object

    Operator format to describe actions with the map:

    ...

    OBJDBLCLKThe event is received when you double click an object on the Map. Contains the same parameters as ACTIVATE_OBJECT

    The list of commands and parameters for the the MAP object is given presented in the table.

    upper-. upper-....__Net ..

    Command

    Parameters

    Description

    SET_TOPMOST – set TOPMOST—Set topmost

    -

    -

    SET_NOTOPMOST – cancel —Cancel topmost

    -

    -

    HIDE_OBJECT – OBJECTHide/show object icon on the map

    objtype<>

    Object IDtype. Can be left emptyblank.   If the object type is not set, then objects of all types are hidden/shown.

    objid<>

    Object ID. Can be left emptyblank.  If If the object ID is not set, then all objects of the specified type are hidden/shown.

    hide<>

    0 objects are shown on the map.

    1 objects are hidden on the map.

    SET_OBJECT_GEOMETRY – set GEOMETRY—Set object location on the map





    objtype<>

    Object type.

    objid<>

    Object ID.

    x<>

    New coordinate of the top left corner of the object icon on the map layer in pixels along the X axis .in pixels

    y<>

    New coordinate of the top left corner of the object icon on the map layer in pixels along the Y axis .in pixels

    exclude_children<>

    By default, when using the SET_OBJECT_GEOMETRY reaction, when moving the object icons, the names of these objects (child objects) also move. If you pass the exclude_children <1> parameter in the reaction, then the object is moved separately from the children, that is, without its name.their names

    INSCRIBE – inscribe —Inscribe to window--
    SHOW_MINIMAP – show MINIMAP—Show a minimapx<>The coordinate of the top left corner of the minimap along the X axis in pixels
    y<>The coordinate of the top left corner of the minimap along the Y axis in pixels
    w<>Width of the minimap in pixels
    h<>Height of the minimap in pixels
    monitor<>Monitor ID
    slave_id<>Computer network name
    SET_ZOOM - set —Change the Map scale.zoom<>Map scale ratio

    Example. Hide Camera 10 on Map 1 on Macro 10.

    ...

    ACTIVATE_OBJECT—Activate object on the Mapobj_type<>Object type
    obj_id<>Object ID
    layer<>Map layer ID. If the parameter is set, the script will work on the specified layer. If the parameter is not set, the scrip will work on the current layer
    DRAW_ARROW—Draw a track of movement between objects

    first_obj_type<>Type of the object from which a track will be made
    first_obj_id<>ID of the object from which a track will be made
    second_obj_type<>Type of the object to which a track will be made
    second_obj_id<>ID of the object to which a track will be made
    obj_id<>ID of the created track
    title_text<>

    Text that will be displayed next to the track. \n is used for line break.

    Additional optional parameters:

    • title_text_alignshift of the text. 0text is displayed in the center, 1at the beginning of the track, 2at the end of the track
    • title_text_sizesize of the text
    • title_shift_by_yshift down of the text (may be needed when using title_text_size). Default is 40 pixels
    • title_text_colorcolor of the text in Decimal format
    • title_text_fontfont of the text

    Example:

    title_text<Object is moving\nto the exit>,title_text_align<1>,title_shift_by_y<60>,title_text_color<16711935>,title_text_size<18>,title_text_font<Algerian>

    ERASE_ARROW—Erase a track of movement between objectsobj_id<>ID of the track that must be erased. If you don't specify the parameter, all tracks will be erased

    Features of the DRAW_ARROW command execution:

    1. When executing the command, a track will be displayed on each layer of the Map as arrows Image Added between the objects.
    2. If the objects are located on the same layer, the arrow is drawn directly between the specified objects. If the objects are located on different layers, the arrow is drawn by the shortest path.
    3. You can limit the depth of searching for connections between layers to make a track with the DrowArrowSearchDepth key, see Registry keys reference guide.
    4. If 
      1. it isn't possible to make a track,
      2. one of the objects doesn't exist,
      3. it is possible to make a track, but the arrows cannot be displayed,

    then the icon Image Added will be displayed on the first object, and the icon Image Added will be displayed on the second object.

    ...