org.openscience.cdk.renderer

Class ReactionSetRenderer

java.lang.Object

org.openscience.cdk.renderer.AbstractRenderer<IReactionSet>

org.openscience.cdk.renderer.ReactionSetRenderer

All Implemented Interfaces:

IRenderer<IReactionSet>

public class ReactionSetRenderer
extends AbstractRenderer<IReactionSet>
implements IRenderer<IReactionSet>

A general renderer for IChemModels, IReactions, and IAtomContainers. The chem object is converted into a 'diagram' made up of IRenderingElements. It takes an IDrawVisitor to do the drawing of the generated diagram. Various display properties can be set using the RendererModel.

This class has several usage patterns. For just painting fit-to-screen do:

   renderer.paintMolecule(molecule, visitor, drawArea)
 

for painting at a scale determined by the bond length in the RendererModel:

   if (moleculeIsNew) {
     renderer.setup(molecule, drawArea);
   }
   Rectangle diagramSize = renderer.paintMolecule(molecule, visitor);
   // ...update scroll bars here
 

to paint at full screen size, but not resize with each change:

   if (moleculeIsNew) {
     renderer.setScale(molecule);
     Rectangle diagramBounds = renderer.calculateDiagramBounds(molecule);
     renderer.setZoomToFit(diagramBounds, drawArea);
     renderer.paintMolecule(molecule, visitor);
   } else {
     Rectangle diagramSize = renderer.paintMolecule(molecule, visitor);
   // ...update scroll bars here
   }
 

finally, if you are scrolling, and have not changed the diagram:

   renderer.repaint(visitor)
 

will just repaint the previously generated diagram, at the same scale.

There are two sets of methods for painting IChemObjects - those that take a Rectangle that represents the desired draw area, and those that return a Rectangle that represents the actual draw area. The first are intended for drawing molecules fitted to the screen (where 'screen' means any drawing area) while the second type of method are for drawing bonds at the length defined by the RendererModel parameter bondLength.

There are two numbers used to transform the model so that it fits on screen. The first is scale, which is used to map model coordinates to screen coordinates. The second is zoom which is used to, well, zoom the on screen coordinates. If the diagram is fit-to-screen, then the ratio of the bounds when drawn using bondLength and the bounds of the screen is used as the zoom.

So, if the bond length on screen is set to 40, and the average bond length of the model is 2 (unitless, but roughly Ångstrom scale) then the scale will be 20. If the model is 10 units wide, then the diagram drawn at 100% zoom will be 10 * 20 = 200 in width on screen. If the screen is 400 pixels wide, then fitting it to the screen will make the zoom 200%. Since the zoom is just a floating point number, 100% = 1 and 200% = 2.

Author:

maclean

Source code:

master

Belongs to CDK module:

renderextra

Field Summary

Fields inherited from class org.openscience.cdk.renderer.AbstractRenderer

cachedDiagram, drawCenter, fontManager, generators, modelCenter, rendererModel, transform

Constructor Summary

Constructors

Modifier	Constructor and Description
	ReactionSetRenderer(List<IGenerator<IAtomContainer>> generators, IFontManager fontManager) A renderer that generates diagrams using the specified generators and manages fonts with the supplied font manager.
	ReactionSetRenderer(List<IGenerator<IAtomContainer>> generators, List<IGenerator<IReaction>> reactionGenerators, IFontManager fontManager) A renderer that generates diagrams using the specified generators for IAtomContainers and IReactionSets and manages fonts with the supplied font manager.
	ReactionSetRenderer(RendererModel rendererModel, List<IGenerator<IAtomContainer>> generators, IFontManager fontManager)
protected	ReactionSetRenderer(RendererModel rendererModel, List<IGenerator<IAtomContainer>> generators, List<IGenerator<IReaction>> reactionGenerators, IFontManager fontManager)

Method Summary

Modifier and Type	Method and Description
Rectangle	calculateDiagramBounds(IReactionSet reactionSet) Given a IChemObject, calculates the bounding rectangle in screen space.
double	calculateScaleForBondLength(double modelBondLength) Given a bond length for a model, calculate the scale that will transform this length to the on screen bond length in RendererModel.
List<IGenerator<IReactionSet>>	getGenerators() Returns a List of IGenerators for this renderer.
Rectangle	paint(IReactionSet reactionSet, IDrawVisitor drawVisitor) Paint an IChemObject.
void	paint(IReactionSet reactionSet, IDrawVisitor drawVisitor, Rectangle2D bounds, boolean resetCenter) Paint a set of reactions.
void	setScale(IReactionSet reactionSet) Set the scale for an IReactionSet.
void	setup(IReactionSet reactionSet, Rectangle screen) Setup the transformations necessary to draw this Reaction Set.

Methods inherited from class org.openscience.cdk.renderer.AbstractRenderer

calculateScreenBounds, convertToDiagramBounds, generateDiagram, getBounds, getDrawCenter, getModelCenter, getRenderer2DModel, paint, repaint, setDrawCenter, setModelCenter, setup, setupTransformNatural, setupTransformToFit, setZoom, setZoomToFit, shift, shiftDrawCenter, toModelCoordinates, toScreenCoordinates

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.openscience.cdk.renderer.IRenderer

generateDiagram, getRenderer2DModel, setZoom, shiftDrawCenter, toModelCoordinates, toScreenCoordinates

Constructor Detail

ReactionSetRenderer

public ReactionSetRenderer(List<IGenerator<IAtomContainer>> generators,
                           IFontManager fontManager)

A renderer that generates diagrams using the specified generators and manages fonts with the supplied font manager.

Parameters:

generators - a list of classes that implement the IGenerator interface

fontManager - a class that manages mappings between zoom and font sizes

ReactionSetRenderer

public ReactionSetRenderer(RendererModel rendererModel,
                           List<IGenerator<IAtomContainer>> generators,
                           IFontManager fontManager)

ReactionSetRenderer

public ReactionSetRenderer(List<IGenerator<IAtomContainer>> generators,
                           List<IGenerator<IReaction>> reactionGenerators,
                           IFontManager fontManager)

A renderer that generates diagrams using the specified generators for IAtomContainers and IReactionSets and manages fonts with the supplied font manager.

Parameters:

generators - a list of classes that implement the IGenerator interface

reactionGenerators - a list of classes that implement the IGenerator interface

fontManager - a class that manages mappings between zoom and font sizes

ReactionSetRenderer

protected ReactionSetRenderer(RendererModel rendererModel,
                              List<IGenerator<IAtomContainer>> generators,
                              List<IGenerator<IReaction>> reactionGenerators,
                              IFontManager fontManager)

Method Detail

setup

public void setup(IReactionSet reactionSet,
                  Rectangle screen)

Setup the transformations necessary to draw this Reaction Set.

Specified by:

setup in interface IRenderer<IReactionSet>

Parameters:

reactionSet -

screen -

setScale

public void setScale(IReactionSet reactionSet)

Set the scale for an IReactionSet. It calculates the average bond length of the model and calculates the multiplication factor to transform this to the bond length that is set in the RendererModel.

Specified by:

setScale in interface IRenderer<IReactionSet>

Parameters:

reactionSet -

paint

public Rectangle paint(IReactionSet reactionSet,
                       IDrawVisitor drawVisitor)

Paint an IChemObject.

Specified by:

paint in interface IRenderer<IReactionSet>

Parameters:

reactionSet - the chem object to paint

drawVisitor - the class that visits the generated elements

Returns:

the rectangular area where was drawn

paint

public void paint(IReactionSet reactionSet,
                  IDrawVisitor drawVisitor,
                  Rectangle2D bounds,
                  boolean resetCenter)

Paint a set of reactions.

Specified by:

paint in interface IRenderer<IReactionSet>

Parameters:

reactionSet - the reaction to paint

drawVisitor - the visitor that does the drawing

bounds - the bounds on the screen

resetCenter - if true, set the draw center to be the center of bounds

calculateDiagramBounds

public Rectangle calculateDiagramBounds(IReactionSet reactionSet)

Given a IChemObject, calculates the bounding rectangle in screen space.

Specified by:

calculateDiagramBounds in interface IRenderer<IReactionSet>

Parameters:

reactionSet - the IChemObject to draw.

Returns:

a rectangle in screen space.

calculateScaleForBondLength

public double calculateScaleForBondLength(double modelBondLength)

Given a bond length for a model, calculate the scale that will transform this length to the on screen bond length in RendererModel.

Specified by:

calculateScaleForBondLength in class AbstractRenderer<IReactionSet>

Parameters:

modelBondLength - the wanted model bond length in screen length

Returns:

returns the scale that causes the drawn bond lengths in pixels to match the given model bond length

getGenerators

public List<IGenerator<IReactionSet>> getGenerators()

Returns a List of IGenerators for this renderer.

Specified by:

getGenerators in interface IRenderer<IReactionSet>

Returns:

the list of generators for this renderer.