.. highlightlang:: us

.. index:: MarkerCreate

.. _markercreate:

MarkerCreate
============

.. us.tag  MarkerCreate ENGLISH Changed427

Creates a symbol to mark data points of a dataset.

.. function::  hMarker = MarkerCreate()
    hMarker = MarkerCreate(hMarkerOther)
    hMarker = MarkerCreate(nStyle, rsSize, rvEdgeColorRGB, rvFillColorRGB, rsEdgeWidth)

.. us.return

**Return Value**

*hMarker*  is the handle of the marker symbol.

.. us.params

**Parameters**

.. uparam:: nStyle

   *nStyle* is one of the following values:

   .. list-table::
      :header-rows: 1

      * - Value
        - Meaning
      * - (0) MS_PLUS
        - Plus sign
      * - (1) MS_CROSS
        - Cross
      * - (2) MS_SIMPLESTAR
        - Star
      * - (3) MS_CIRCLE
        - Circle
      * - (4) MS_RECTANGLE
        - Rectangle
      * - (5) MS_DIAMOND
        - Diamond
      * - (6) MS_TRIANGLE
        - Triangle
      * - (7) MS_TRIANGLE1
        - Triangle turned 90 degrees
      * - (8) MS_TRIANGLE2
        - Triangle turned 180 degrees
      * - (9) MS_TRIANGLE3
        - Triangle turned 270 degrees
      * - (10) MS_HOURGLASS
        - Hourglass (2 triangles)
      * - (11) MS_HOURGLASS1
        - Hourglass turned 90 degrees
      * - (12) MS_STAR
        - Star
      * - (13) MS_CIRCLEDOT
        - Circle with dot
      * - (14) MS_CIRCLEPLUS
        - Circle with Plus sign
      * - (15) MS_CIRCLECROSS
        - Circle with cross
      * - (16) MS_RECTDOT
        - Rectangle with dot
      * - (17) MS_RECTPLUS
        - Rectangle with plus sign
      * - (18) MS_RECTCROSS
        - Rectangle with cross
      * - (19) MS_NULL
        - Invisible Marker
      * - (20) MS_DOT
        - Smallest plotable point

.. uparam:: rsSize

   *rsSize* is the size of the symbol in
   centimeters.

.. uparam:: rvEdgeColorRGB

   *rvEdgeColorRGB* is a vector with 3 elements that sets the the symbol edge
   color:

   .. list-table::
      :header-rows: 1

      * - Value
        - Meaning
      * - rvEdgeColorRGB[1]
        - Red (0 to 255)
      * - rvEdgeColorRGB[2]
        - Green (0 to 255)
      * - rvEdgeColorRGB[3]
        - Blue (0 to 255)

.. uparam:: rvFillColorRGB

   *rvFillColorRGB* is a vector with 3 elements that sets the the symbol fill
   color:

   .. list-table::
      :header-rows: 1

      * - Value
        - Meaning
      * - rvFillColorRGB[1]
        - Red (0 to 255)
      * - rvFillColorRGB[2]
        - Green (0 to 255)
      * - rvFillColorRGB[3]
        - Blue (0 to 255)

.. uparam:: rsEdgeWidth

   *rsEdgeWidth* is the edge width of the symbol in steps of 0.1 mm.

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Description
   * - 4.2.7
     - Function can be invoked with one parameter (copy constructor).

.. seealso::
   :ref:`overview-marker`,
   :ref:`MarkerDestroy`,
   :ref:`XYSetMarker`,
   :ref:`XYZSetMarker`,
   :ref:`ObjCopy`

:sub:`id-751959`