#
Rendering Extension

###### Identifier:

org.eclipse.debug.core.memoryRenderings

###### Since:

Eclipse 3.0

###### Description:

This in an internal extension point that allows plugins to define renderings for memory blocks. This extension point is being released for internal use only in Eclipse 3.0, and may become public API in a future release. A rendering is a UI representation of a memory block. In addition to the HEX representation created by default in the Memory View, a memory block can be presented in other formats. For example, the raw data of a memory block can be rendered in to text and displayed as ASCII strings. The data can also be rendered into numerical values and displayed as integer or decimal numbers. This extension point allows plugins to define renderings suitable for their needs. They can also define their own rendering views to display the renderings they define.

###### Configuration Markup:

<!ELEMENT extension (rendering* | default_renderings* | rendering_binding*)>

<!ATTLIST extension

point CDATA #REQUIRED

id CDATA #IMPLIED

name CDATA #IMPLIED>

- point - a fully qualified identifier of the target extension point
- id - an optional identifier of the extension instance
- name - an optional name of the extension instance

<!ELEMENT rendering ((rendering_property*))>

<!ATTLIST rendering

renderingId CDATA #REQUIRED

name CDATA #REQUIRED

renderingFactory CDATA #IMPLIED>

This element defines a rendering. A rendering is comprised of an id, a name, optionally, a rendering factory, and a list of rendering properties.

- renderingId - Required unique identifier for the rendering.
- name - Required name of the rendering
- renderingFactory - Optional field for specifying a class that implements IRenderingFactory. IRenderingFactory is for creating an IMemoryRendering object. If this field is not defined, then a default rendering factory will be used. MemoryRendering will be created and stored in the memory rendering manager.

<!ELEMENT rendering_property EMPTY>

<!ATTLIST rendering_property

renderingId CDATA #REQUIRED

name CDATA #REQUIRED

value CDATA #REQUIRED>

For specifying rendering specific properties.

- renderingId - Rendering this property belongs to. The rendering must be defined before the property.
- name - Name of the property
- value - Value of this property

<!ELEMENT default_renderings EMPTY>

<!ATTLIST default_renderings

memoryBlockClass CDATA #REQUIRED

renderingIds CDATA #REQUIRED>

Default renderings to create when an object of "memoryBlockClass" is created.

- memoryBlockClass - Name of the memory block class.
- renderingIds - List of renderings to be created when a memory block of type "memboryBlockClass" is created. Sepcify rendering ids and delimit them with comma. The rendering will not be added if its rendering id is not one of the listed valid renderings specified in rendering_binding.

<!ELEMENT rendering_binding EMPTY>

<!ATTLIST rendering_binding

memoryBlockClass CDATA #REQUIRED

renderingIds CDATA #REQUIRED>

Binds a memory block with a list of renderings. Allows plugins to define a list of valid renderings for their memory blocks.

- memoryBlockClass - Class name of the memory block to bind the renderings to.
- renderingIds - List of renderings valid for the memory block. Delimit rendering ids with comma.

###### API Information:

[Enter API information here.]

###### Supplied Implementation:

[Enter information about supplied implementation of this extension point.]

Copyright (c) 2004 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made available under the terms of the Common Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/cpl-v10.html