new StructFragment2DRenderer(chemObj, drawBridge, renderConfigs, parent)
Class to render for Kekule.StructureFragment.
The class will use Kekule.Render.ChemCtab2DRenderer or Kekule.Render.Formula2DRenderer to draw actual structure.
Parameters:
| Name | Type | Description |
|---|---|---|
chemObj |
Kekule.ChemObject | Object to be drawn. |
drawBridge |
Object | A object that implements the actual draw job. |
renderConfigs |
Object | Global configuration for rendering. This property should be an instance of Kekule.Render.Render2DConfigs. //@param {Int} moleculeDisplayType Display type of molecule of current ctab. |
parent |
Kekule.ObjectEx | Parent object of this renderer, usually another renderer or an instance of Kekule.Render.ChemObjPainter, or null. //@property {Int} moleculeDisplayType Display type of molecule. |
Extends
Methods
-
beginUpdateRenderer()
-
Call this method before a series of rendered element updating job (for instance, call update method) to avoid unnecessary redraw.
- Inherited From:
- Source:
-
canMeasureText(context) → {Bool}
-
Indicate whether current render and context can measure text dimension before drawing it. HTML Canvas is a typical environment of this type.
Parameters:
Name Type Description contextObject - Inherited From:
- Source:
Returns:
- Type
- Bool
-
canModifyGraphic(context) → {Bool}
-
Whether current renderer can modify elements drawn on context.
Parameters:
Name Type Description contextObject - Inherited From:
- Source:
Returns:
- Type
- Bool
-
clear(context) → {Bool}
-
Clear whole chemObj on context.
Parameters:
Name Type Description contextObject - Inherited From:
- Source:
Returns:
Whether the actual clear job is done.- Type
- Bool
-
doClear(context) → {Bool}
-
Do actual job of clear. This function should return true after actual work done. Otherwise false should be returned.
Parameters:
Name Type Description contextObject - Inherited From:
- Source:
Returns:
- Type
- Bool
-
draw(context, baseCoord, options) → {Object}
-
Draw an instance of ChemObject to context. The actual job is done in doDraw method. Descendants should override doDraw.
Parameters:
Name Type Description contextObject Context to be drawn, such as Canvas, SVG, VML and so on. baseCoordHash Base coord to draw this object, can be null to use coord of chemObj itself. This coord is based on context. optionsHash Draw options, such as draw rectangle, draw style, zoom and so on. Different renderer may requires different option params. In options hash object, there may be one special array field: partialDrawObjs. If this field is set, then only chem objects in this array will be actually drawn. - Inherited From:
- Source:
Returns:
Drawn element on context (such as SVG) or null on direct context (such as canvas).- Type
- Object
-
endUpdateRenderer()
-
Call this method after a series of rendered element updateing job, notify the renderer to redraw the context.
- Inherited From:
- Source:
-
estimateObjBox(context, options, allowCoordBorrow) → {Hash}
-
Estimate the bound box around current chemObj (in chem coord system).
Parameters:
Name Type Description contextObject optionsObject allowCoordBorrowBool - Inherited From:
- Source:
Returns:
A 2D or 3D box, in chemObj's coord system.- Type
- Hash
-
generateTransformParams(context, baseCoord, drawOptions, objBox) → {Hash}
-
Calculate the coordinate transform options from drawOptions. Descendants can override this method. Note that unit length and zoom is not take into consideration in this method.
Parameters:
Name Type Description contextObject baseCoordHash drawOptionsHash objBoxHash - Inherited From:
- Source:
Returns:
- Type
- Hash
-
getAutoBaseCoord(drawOptions) → {Hash}
-
Auto calculate draw context coord by coord of chem obj. When no baseCoord is provided in draw method, this result may be used instead.
Parameters:
Name Type Description drawOptionsHash - Inherited From:
- Source:
Returns:
- Type
- Hash
-
getAutoScaleRefDrawLength() → {Float}
-
Returns the standard draw length for calculation of autoScale. Usually this is the draw length of bond. Descendants can override this method to use another length.
- Inherited From:
- Source:
Returns:
- Type
- Float
-
getAutoScaleRefObjLength() → {Float}
-
Returns the reference length in object to calculate autoscale.
- Inherited From:
- Source:
Returns:
- Type
- Float
-
getCoordMode() → {Int}
-
Report coord mode of this renderer.
- Inherited From:
- Source:
Returns:
Value from Kekule.CoordMode.- Type
- Int
-
getFinalTransformParams(context, transformParams) → {Hash}
-
Calculate the final params for translation. Zoom and unit length are taken into consideration.
Parameters:
Name Type Description contextObject transformParamsHash - Inherited From:
- Source:
Returns:
- Type
- Hash
-
getRenderCache() → {Hash}
-
Returns draw params (center coord, options, matrix...) on last draw process on context.
- Inherited From:
- Source:
Returns:
- Type
- Hash
-
isRootRenderer()
-
Check if current renderer is the topmost one (without parent renderer, but maybe has parent painter).
- Inherited From:
- Source:
-
isUpdatingRenderer() → {Bool}
-
Check if beginUpdateRenderer is called and endUpdateRenderer is not called yet.
- Inherited From:
- Source:
Returns:
- Type
- Bool
-
prepareTransformParams(context, baseCoord, drawOptions) → {Hash}
-
Prepare 2D transform params from baseCoord and drawOptions. If drawOptions.transformParams already set, this method will do nothing.
Parameters:
Name Type Description contextObject baseCoordHash drawOptionsHash - Inherited From:
- Source:
Returns:
- Type
- Hash
-
redraw(context)
-
Redraw previous object on context with same draw options. Should not be called before draw.
Parameters:
Name Type Description contextObject - Inherited From:
- Source:
-
removeDrawnElem(context, elem)
-
Remove an element in context.
Parameters:
Name Type Description contextObject elemObject - Inherited From:
- Source:
-
transformContextCoordToScreen(context, coord) → {Hash}
-
Transform a context based coord to screen based one (usually in pixel).
Parameters:
Name Type Description contextObject coordHash - Inherited From:
- Source:
Returns:
- Type
- Hash
-
transformScreenCoordToContext(context, coord) → {Hash}
-
Transform a screen based coord to context based one. Note that only 2D renderer can map screen coord back.
Parameters:
Name Type Description contextObject coordHash - Inherited From:
- Source:
Returns:
- Type
- Hash
-
update(context, updatedObjDetails, updateType) → {Bool}
-
Update a child object inside chemObj. Must be called after draw.
Parameters:
Name Type Description contextObject updatedObjDetailsVariant Object detail containing field {obj, propNames} or array of details. updateTypeInt Value from Kekule.Render.ObjectUpdateType - Inherited From:
- Source:
Returns:
- Type
- Bool
-
updateEx(updateInfos) → {Bool}
-
Do a update job according to info provided by updateItems. Must be called after draw.
Parameters:
Name Type Description updateInfosArray Each item has format: {context, items: [{updateType, updatedObjDetails: [{obj, propNames}]}]} - Inherited From:
- Source:
Returns:
- Type
- Bool
Events
-
clear
-
Invoked when whole chem object (molecule, reaction...) is cleared from context. event param of it has two fields: {context, obj} NOTE: this event is not well implemented and may be buggy.
- Inherited From:
- Source:
-
draw
-
Invoked when whole chem object (molecule, reaction...) is drawn in context. event param of it has two fields: {context, obj}
- Inherited From:
- Source:
-
prepareDrawing
-
Invoked when whole chem object (molecule, reaction...) is prepared to be drawn in context. event param of it has two fields: {context, obj}
- Inherited From:
- Source:
-
updateBasicDrawObject
-
Invoked when a basic object (node, connector, glyph...) is drawn, updated or removed. event param of it has fields: {obj, parentObj, boundInfo, updateType} where boundInfo provides the bound box information of this object on context. It has the following fields: { context: drawing context object obj: drawn object parentObj: parent of drawn object boundInfo: a hash containing info of bound, including fields: { shapeType: value from Kekule.Render.MetaShapeType or Kekule.Render.Meta3DShapeType. coords: [Array of coords] } updateType: add, modify or remove } boundInfo may also be a array for complex situation (such as multicenter bond): [boundInfo1, boundInfo2, boundInfo3...]. Note that in removed event, boundInfo may be null.
- Inherited From:
- Source: