User Tools

Site Tools


api:dk11:activex:tatukgis_xdk11.itgis_symbollist.prepare_2_widestring__stream

Table of Contents

ITGIS_SymbolList.Prepare_2 method

DK11 for ActiveX | TatukGIS_XDK11.ITGIS_SymbolList.Prepare_2 | Methods

Prepare a new symbol.

Available also on: Delphi | Java.

Syntax

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

Parameters

Name Type Description
_name WideString name of the symbol; see comment for TGIS_SymbolFont.Create and TGIS_SymbolPicture.Create and TGIS_SymbolLine.Create
_stream _stream graphics stream for bitmap, for non\-file symbols

Result

Type Description
ITGIS_SymbolAbstract symbol object

Remarks

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.

Example

      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/08 23:16

Page Tools