User Tools

Site Tools


ITGIS_SymbolList.Prepare method

DK11 for ActiveX | TatukGIS_XDK11.ITGIS_SymbolList.Prepare | Methods

Prepare a new symbol.

Available also on: Delphi | .NET | Java.


// C#
public ITGIS_SymbolAbstract Prepare(
  WideString _name
' VisualBasic
Public Function Prepare(
  ByVal _name As WideString
) As ITGIS_SymbolAbstract
// Oxygene
  function Prepare(
    _name : WideString
  ) : ITGIS_SymbolAbstract;


Name Type Description
_name WideString name of the symbol; see comment for TGIS_SymbolFont.Create and TGIS_SymbolPicture.Create and TGIS_SymbolLine.Create


Type Description
ITGIS_SymbolAbstract symbol object


If the symbol exists in memory, then pointer to the existing symbol will be returned.

To display symbols properly check the following:

  1. Make certain that LineSymbolGap=0.
  2. Test your CGM symbol in our sample CGM viewer to confirm that it does not have an embedded border.
  3. The symbol used to create the line should start at (0,0), which will be a rotation point.
  4. During rendering such a line formed with a repetitive symbol is generalized so that any sub-line will match the symbol width. To smoothen such line generalization, try composing the line with narrower symbols or applying a smaller LineWidth.


      l1.Params.Marker.Symbol = SymbolList.Prepare( 'C:\Test.cgm' )
      l1.Params.Marker.Symbol = SymbolList.Prepare( 'C:\Test.cgm', CGMstream )
      l2.Params.Marker.Symbol = SymbolList.Prepare( 'C:\Test.wmf' )
      l3.Params.Marker.Symbol = SymbolList.Prepare('Arial:A:bold:italic:underline')
      l4.Params.Marker.Symbol = SymbolList.Prepare('Arial:65')
      l4.Params.Line.Symbol   = SymbolList.Prepare('<2+1+1>')
      l4.Params.Line.Symbol   = SymbolList.Prepare('test.PNG', PNGstream )


2020/05/28 09:05

Page Tools