 |
This document is archived and information here might be outdated. Recommended version. |
IDynamicGlyphFactory2 Interface (ArcObjects .NET 10.6 SDK)
|
This document is archived and information here might be outdated. Recommended version. |
Provides access to create dynamic glyphs.
This interface is new at ArcGIS 9.3. It supersedes IDynamicGlyphFactory.
Use the dynamic glyph factory singleton object in order to create and delete dynamic glyphs. The dynamic glyphs can be used with the Dynamic Symbols in order to render Dynamic Items.
| Name | Description | |
|---|---|---|
 |
CreateDynamicGlyph | Creates a dynamic glyph from a symbol. |
|
CreateDynamicGlyphFromBitmap | Create a dynamic glyph from a bitmap handle. |
|
CreateDynamicGlyphFromFile | Creates a dynamic glyph from a file. |
|
DeleteDynamicGlyph | Deletes the dynamic glyph's resource. |
 |
DynamicGlyph | Retrieves a dynamic glyph from a glyph group. |
|
GetCreatedDynamicGlyphSize | Indicates the texture size of the created dynamic glyph. |
|
Init | Initialize the dynamic glyph factory. |
|
LoadDynamicGlyphsGroup | Loads a dynamic glyph group from files. |
|
SetCreatedDynamicGlyphSize | Indicates the texture size of the created dynamic glyph. |
|
UnloadDynamicGlyphsGroup | Unloads a dynamic glyph group, and any corresponding resources. |
| Interfaces | Description |
|---|---|
| IDynamicGlyphFactory | Provides access to create dynamic glyphs. |
| CoClasses and Classes | Description |
|---|---|
| DynamicDisplay (esriCarto) | Dynamic display class, used by the dynamic map. |
| DynamicGlyphFactory (esriCarto) | Dynamic glyph factory class. |
Dynamic Glyph Factory:
The Dynamic Glyph Factory is a singleton object; therefore you can always co-create it in order to use it to create and delete dynamic glyphs. With Respect to performance, it is preferable to create the dynamic glyphs in the context of the IDynamicLayer’s DrawDynamicLayer method, in the esriDDPImmediate draw phase, or in the context of the IDynamicMapEvents BeforeDynamicDraw or AfterDynamicDraw method, while casting the passed in IDynamicDisplay interface to IDynamicGlyphFactory.
When co-creating the DynamicGlyphFactory singleton in a DotNet application, use the Activator class instead of using the new keyword:
Type t=Type.GetTypeFromProgID("esriCarto.DynamicGlyphFactory");
System.Object dynamicGlyphFactoryObject=Activator.CreateInstance(t);
IDynamicGlyphFactory2 dynamicGlyphFactory=dynamicGlyphFactoryObject as IDynamicGlyphFactory2;
See also: System.__ComObject and casting to strongly typed RCWs
Glyph Groups:
A Dynamic Glyphs Group is a container that holds multiple glyphs. It is composed of a bitmap and a database that holds information about the group and the elements (glyphs and glyphs’ items) in the group. The image is a mosaic of sub-images of icons (marker glyphs), lines (line glyphs), and groups of characters (each group composes a text glyph).
The bitmap holds color information (Red, Green, Blue, and Alpha values) for each pixel. The bitmap can be loaded from two file images - one that holds the RGB values, and a second one that holds the ALPHA values, or from a single file image that holds RGBA values.
The Glyphs Group database is loaded from an XML file. This XML file holds general information about the group, and specific location and size information for each of the items and elements of the group.
A new Glyphs Group can be loaded using the IDynamicGlyphFactory.LoadDynamicGlyphsGroup method.
Glyphs Group ID 1 is reserved to be the default Glyphs Group, and supplies a default set of Dynamic Glyphs.