ChemDoodle Web Components | Installation

Installation > Change Log

10.0.0

March 19, 2024

Executive Summary

Version 10.0.0 of the ChemDoodle Web Components adds new features and modernizes much of the library. We include a new ReactJS plugin, more reaction features, new UIs icons, improved input event support, and more. jQuery has been removed from the core library.

Additions

We now provide a ReactJS plugin for the ChemDoodle Web Components, named react-chemdoodle, in collaboration with Melanie Burger. Please see this tutorial page for more information.
jQuery has been removed from the core ChemDoodle Web Components library. In 2009, when the ChemDoodle Web Components was first released, jQuery was an essential library for compatibility in the various browsers. Today, all browsers strictly support ECMAScript, and include many of the features jQuery facilitated. Therefore, it is no longer necessary and the entire core ChemDoodle Web Components library is written in vanilla JavaScript without jQuery. jQuery is still included in the UIs package, as we use jQuery UI for the interface elements. jQuery and jQuery UI are secure and embedded in the UIs package, so as not to cause issues with any applications the ChemDoodle Web Components is embedded with. jQuery UI is aging though, and we are looking into a more lightweight interfaces replacement for the UIs package.
The jQuery mousewheel library has been completely removed as it is no longer necessary.
All UIs icons have been updated to match the desktop software.
The full sketcher now recognizes RXN file input when using the open function.
SketcherCanvas and EditorCanvas3D toolbar managers now keep track of whether they have been written or not.
Added ChemDoodle JSON support for reactants and products defined to arrows (Line objects).
Added support for the input and output of atom mapping numbers in ChemDoodle JSON. Please note these values may be ignored on input as the ChemDoodle Web Components has algorithms for uniquely generating them from AtomMapping objects.
Added a "contextmenu" event to the _Canvas class, listening to when the browser would open a context menu over a component. We have added an input event testing section to the input events tutorial page.

Fixes

Corrected issue outputting elements with clips defined to SVG images.
Fixed label "for" link errors caused by the enhanced stereochemistry popup in the sketcher.
Removed the workaround for a Safari bond line rendering bug that has been fixed in Safari.
Fixed the "touchhold" event.

9.5.0

March 19, 2024

Executive Summary

Version 9.5.0 of the ChemDoodle Web Components introduces a handful of new helpful features. Several issues are also corrected.

Additions

Persistent IDs are now assigned to molecule objects output in ChemDoodle JSON. This is useful for a number of cases. Please see the ChemDoodle JSON documentation for more information.
In the full sketcher, if you are using the save button with no services and there is no selection, an alert now reminds the user to first select a structure.
You may now instruct the library to create 3D components with the WebGL context option preserveDrawingBuffer defined. This is done by setting the static ChemDoodle._Canvas3D.PRESERVE_DRAWING_BUFFER boolean. This must be set before initializing any 3D component. By default, it is false, but by setting it to true, you will be able to use the ChemDoodle Web Components API to create PNG images of the WebGL canvas. Keep in mind, by enabling this functionality, performance may be negatively impacted.
The png and svg packages now include a download() function for automatically downloading the image created. Please see the Image Export page for more information.
The png and svg packages now throw appropriate errors if the image cannot be created from the canvas.
New functions have been added to iChemLabs cloud services. Several cloud functions have been made more advanced with additional features. Please see the iChemLabs Cloud Services page for more information.
1. The IUPAC Naming demo now includes both a traditional name and the Attempted Preferred IUPAC Name: IUPAC Naming
2. The stereochemistry demo now includes templates and examples for projection analysis: Stereochemistry
3. Added a new demo for elemental analysis calculations: Elemental Analysis
4. Added a new demo for advanced SMILES input and output, including several options: SMILES

Fixes

Safari recently introduced an issue where bonds and other strokes appear improperly (i.e. additional lines in bond rendering). A workaround has been included to avoid this issue while the Safari developers work on a correction.
A new implementation of the ChemDoodle.io.png.open() function is provided for the data type URL to be compliant with browser security rules.
Fixed error when initializing the EditorCanvas3D component while setting the useServices option set to false, the toolbar did not setup properly.
Fixed problem initializing EditorCanvas3D components after the DOM is closed.
NMR calls via Cloud services have been made much more efficient.

9.4.0

January 02, 2022

Executive Summary

Version 9.4 incorporates a new component, the StoichiometryTable, for a fully chemically aware and self-calculating stoichiometry form in HTML5 interfaces. This component is not <canvas> based, but works just like other ChemDoodle Web Components.. See the Stoichiometry Table tutorial page for more information.

9.3.0

October 17, 2021

Executive Summary

Version 9.3 is a feature update to the ChemDoodle Web Components library. Included are the ability to define and input/output enhanced stereochemistry definitions as well as MOL v3000 support. New demos include chemical image recovery, ADA and WCAG compliance, stoichiometry tables, and Wiswesser Line Notation parsing.

Additions

Enhanced Stereochemistry. You may now define enhanced stereochemistry for chemical structures, using or and & modifiers. All stereocenters are absolute (abs) by default. You may manually define group numbers for more advanced stereochemistry queries. Enhanced stereochmistry definitions are read and written from ChemDoodle JSON and MDL CT files (v3000 only). Please see the sketcher demo for more information.
Added a class (ChemDoodle.structures.Reaction) for defining a reaction and separating molecules into reactants and products based on an arrow object.
The sketcher's isotope popover now displays over the atom you are editing instead of from the top of the sketcher.
Added MOL v3000 support, with enhanced stereochemistry support. You will set the version property of the ChemDoodle.io.MOLInterpreter class to true to output v3000 instead of v2000. Input will automatically detect version and parse accordingly.
Added a new demo to demonstrate our chemical image recovery algorithms (also known as optical structure recognition): Chemical Image Recovery
Here are features to aid in ADA and WCAG compliance: ADA & WCAG Accessibility Compliance
Added a new demo to demonstrate our fully chemically aware and auto-calculating stoichiometry tables.
Check out the legacy Wiswesser Line Notation with this new demo: Wiswesser Line Notation (WLN)

Fixes

Isotope popover now works properly on mobile devices.
Improved isotope number spacing with respect to atom labels.
Corrected the display of implicit hydrogen overrides on metal atoms.

9.2.0

March 06, 2021

Executive Summary

Version 9.2 is a feature update to the ChemDoodle Web Components library. Included are new features in the 2D sketcher improving user friendliness and adding more chemistry information. New demos include calculating molecule properties and Wiswesser Line Notation parsing, as well as name to structure support in our IUPAC naming demo. A couple shapes have been refactored, and those changes should be understood before updating if you use them.

Additions

Custom cursors have now been implemented for all of the sketcher states, to give better feedback to users when using the 2D sketcher to draw figures. The default sketcher cursor is now a crosshair, which is optimal for drawing chemical structures. See the CursorManager class for more information.
Coordinate covalent (dative) bonds are now supported in the ChemDoodle Web Components and may be drawn in the 2D sketcher.
The 2D sketcher now includes a new tool for editing isotope mass values to individual atoms.
We have added support to the IUPAC Naming demo to also recreate chemical structures from IUPAC names through our Cloud services. This is in addition to structure to name. Our name to structure algorithms use OPSIN.
You can now calculate molecule properties using a new demo created to show off the Cloud services which calculates many dozens of important descriptors. Draw your structure and have properties calculated from the drawing. See it in action using the Calculate Molecule Properties demo.
If you are interested in the history of cheminformatics, you can now recreate chemical drawings from Wiswesser Line Notation (WLN) codes using Cloud services. Give it a try using the Wiswesser Line Notation (WLN) demo, where we go over support for the latest v3.2 protocol and provide many examples.
Centering scenes in 3D components now modify a new parameter _Canvas3D.contentCenter, allowing us to relocate the camera instead of modifying the scene data.
The 3D editor open popup will now load both structures and shapes.
The iChemLabs.readIUPACName() function has been improved to return a set of molecules, instead of just a single molecule. If multiple molecules are present, they will be organized into a row.

Fixes

Fixed an error which prevented the sketcher's lasso tool from selecting content on mobile devices when no selection was present.
Fixed bug where zero order bond tools incremented bond types in the sketcher.
Fixed 3D canvas centering issue which ignored z-coordinates.
The DynamicBracket class has been refactored into the RepeatUnit class, to make it consistent with the desktop software. The ChemDoodle JSON protocol has been adjusted accordingly, but "DynamicBracket" will still be acceptable input.
The UnitCell class has seen a major refactor and now is initialized based on lengths and angles and an optional offset, instead of end points. For more information, see the ChemDoodle JSON and 3D Shapes documents.
The ChemDoodleWeb-libs.js file (which was removed in previous versions of the ChemDoodle Web Components) reference has been removed from the samples in the downloads.

9.1.0

February 17, 2020

Executive Summary

Version 9.1 is a follow-up revision, fixing a few minor issues found and adding in the maximumCommonSubstructure Cloud call.

Additions

A new Cloud call is now available, maximumCommonSubstructure(), for finding both the connected and disconnected MCS between two structures. The Automatic Structure Grading demo exemplifies how this algorithm can be useful to a number of applications.

Fixes

Fixed the zoom direction for the Transform3D canvas on mobile devices when using a pinch gesture.
Fixed bug where the help buttons in the UIs were not working.
Corrected the zoom in and zoom out button directions in the EditorCanvas3D.

9.0.0

February 09, 2020

Executive Summary

Version 9 is a major update to the ChemDoodle Web Components library. There has been a complete refactor of the library to ES6 best standards. The sketcher and editor UIs have been improved with SVG button icons. New Cloud features include advanced CIP stereochemistry support, reaction equation balancing, and stereochemistry enforcement in mechanism matching. The ChemDoodle Web Components website has been recreated to be responsive, much easier to read, and support high-DPI displays for clarity.

Additions

The entire library has been refactored for ES6 best practices. Most importantly, we now use let variable declarations instead of var. The strStartsWith() function in the Extensions package has been removed. UI buttons now define input types. Legacy IE support (and Google Chrome Frame) has been dropped. IE11 is still fully supported using certain internal polyfills, but we recommend IE users switch to Microsoft Edge.
The 2D sketcher now uses SVGs for icons instead of PNGs, so they are crisp and clear on all devices at all resolutions, matching the graphics from the components.
The internal jQuery library has been updated to version 2.2.4.
The VisualSpecifications class has been refactored to Styles to match the change in our desktop software, and also require less typing from developers. The Canvas.specs parameter is now Canvas.styles. The ChemDoodle.default_ specs have been replaced by a ChemDoodle.DEFAULT_STYLES Styles class object. See the Styles tutorial for more information.
You can now resolve advanced CIP stereochemistry configurations using Cloud services. Our CIP libraries are fast and accurate and support both chiral and double bond centers. See it in action using the Resolve CIP Stereochemistry demo.
You can now balance both drawn reactions and typed equations using Cloud services. Our balancing algorithms can handle any input that can be balanced using a proprietary algorithm. See it in action using the Balance Reaction demo.
We have added support to the Mechanism Matching demo to show stereochemical configuration enforcement in matching through our Cloud services.
You can now easily create transparent ChemDoodle Web Components by setting the backgroundColor style to 'transparent'. This works for both 2D and 3D components. See this Transparent Backgrounds tutorial for more information.
A proprietary feature has been added where if a text string is input with a space, then it will be rendered as typed, left aligned, instead of chemically formatted.

Fixes

Adding lone labels would sometimes be impeded by dragging and moving the document, this is made easier by giving a 3 pixel leeway in dragging gestures before cancelling a lone atom placement.
Corrected the rendering of the wavy bond type.
Restored interactivity of the ChemDoodle Web Components on iPads using iOS 13+.
Reversed the Canvas3D and PerspectiveCanvas scroll directions to make them more intuitive.
Fixed issues with loading optimized PDB files from Cloud services.
Fixed issue with UIs where the initial button selection would autofocus causing the webpage to load scrolled to the button.
Defined the button and table sizes for UIs so that they are not as vulnerable to external CSS.
Fixed error in highlighing of the help button in EditorCanvas3D.
Fixed watermark rendering for EditorCanvas3D on high DPI devices.
Fixed issue where initializing a component over an existing canvas with defined size did not properly respond to screen DPI.

8.0.0

July 03, 2017

Executive Summary

Version 8 is the largest update to the ChemDoodle Web Components library to date. The sketcher has seen significant work, with new drawing tools (rings, chains, templates, atom label tool, more). Condensed labels with abbreviations are now supported, for advanced chemistry. New 2D shapes include dynamic brackets, atom mappings and variable attachment points, while molecular surfaces (vdW, SAS, Connolly) can now be generated and rendered in 3D components. The shader system used by the 3D components has been dramatically improved for much faster performance (and new improvements added like gamma correction) and a deferred shader has been implemented to provide advanced graphics techniques like outlining, software antialiasing and screen space ambient occlusion. Shadows can now be rendered in 3D scenes. The entire website has also been improved, with new advanced tutorials for working with the sketcher to listen to user changes, or show off an advanced in browser sketcher interface that mimics the desktop software, for instance. SVG can now be exported from the ChemDoodle Web Components in addition to PNG. A new iChemLabs Cloud service allows developers to match entire mechanisms for educational eBooks and advanced reaction databases. There is a lot in this update, please see the links below for more information.

Additions

The sketcher has been significantly developed. A new requireStartingAtom option allows you to disable to starting atom requirement while sketching. A new resizable option enables the user to resize the sketcher canvas. A new floatDrawTools option uses a floating toolbar for the drawing tools, just like the desktop software. Several new tools have been added, including an arbitrary ring size and arbitrary chain size tool. An atom label tool has been added with a text input field (like in the desktop software) to enter custom atom labels, including advanced condensed labels; space will open the text field by keyboard while the return or enter key will close it or repeat the last typed label for a hovered atom. Templates can now be added in the same manner as the desktop software using the new Templates widget; you can modify and add to the template library. The MolGrabber widget now allows the loading of any content (multiple molecules and shapes) and will insert the content in its entirety to the canvas. The MolGrabber widget will now also alert you if you press the Load button before the Show button. New buttons are available for centering the content in the sketcher as well as for horizontal and vertical flipping. The Open dialog now slides down from the toolbar as a Popover. The lasso tool and selections now use a dashed line just like in the desktop software. When using the labels tools in the sketcher, the periodic table canvas now selects oxygen by default and will revert back to label mode of the currently selected element if chosen from the toolbar. Silicon has been added to the default labels group. Placing unsaturated rings (like benzene) now better lay out double bonds to avoid overvalencing atoms. Hovering bonds are now more responsive, especially for elongated bonds. Pushers now can be set by clicking and then clicking again, no drag necessary.
A new UIs component has been added, called Popover. A Popover is modal and can slide in from other components or appear in its own component for user input.
Added mobile support for the UIs interface elements. For example, previously dialogs couldn't be moved on mobile devices, now they can.
Complex labels can now be handled, with the required additional tools for parsing, formatting and rendering. With this feature, your chemical structures can contain advanced chemical labels consisting of element symbols, abbreviations (a dictionary controlled by you) and numbers and parenthesis for multiplicities. The labels are automatically formatted chemically and oriented based on least interference with surrounding bonds. Some examples include COOH, CO₂Me, N₃, CH₂(CH₂)₄OH, C₃H₇O, Tosyl, myAbbreviation, and more. Use this to create concise publication quality figures directly in your websites.
Added a wavy bond type.
New shapes have been included. New 2D shapes include dynamic brackets for repeating groups, atom mappings for reactions and variable attachment points (VAPs). New 3D shapes include molecular surfaces. The ChemDoodle JSON specification has been updated to support these shapes.
Molecular surfaces can now be generated and rendered for sets of atoms in 3D. Supported types include van der Waals, solvent accessible and solvent excluded (also known as a Connolly surface). You can control resolutions for all and the probe radius for solvent based surfaces. Rendering styles include 'Dots', 'Mesh' and 'Solid' and all colors, transparency, etc. can be controlled through visual specifications.
The shader system for the 3D components has been redone. Several improvements in the Phong shader allow us to render higher quality graphics with lower quality meshes, leading to significant performance improvements across the entire 3D ChemDoodle Web Components.
A deferred shader system has been developed allowing the implementation of advanced shader procedures for generating graphics. Currently implemented are outlining, screen space ambient occlusion (SSAO) and software antialiasing (FXAA). SSAO in particular is very powerful as it allows us to simulate how much ambient light is accessible to objects in crowded spaces, allowing us to shade the scene in a more accurate manner. This works on all geometries, but the feature can really be shown off in space filling all-atom models of large macromolecules.
Shadows can now be rendered in 3D scenes. You can control the intensity of the shadows with the shadow_intensity_3D visual specification.
Gamma correction has been implemented for brighter, more color accurate rendering controlled by the gammaCorrection_3D visual specification.
The VisualSpecifications class now provides a copy() function for creating style sheet copies.
Added a new bond visual specification for absolute saturation widths: bonds_useAbsoluteSaturationWidths_2D.
Bonds now split colors based on their substituent atom colors, with the bonds_splitColor visual specification. The bonds_useJMOLColors and bonds_usePYMOLColors specifications have been removed. Use the corresponding atom specifications instead.
Made wedge width an absolute value in line with desktop software with a default value of 6.
Components now center 2D content much more pleasantly by calculating bounds of atom labels in addition to coordinates and using a constant internal padding.
The preview, hover, select and error colors are now controlled by visual specifications.
A new iChemLabs Cloud call, mechanismMatch(), is now provided to match mechanisms. You can see it in action here.
Updated van der Waals radii data.
Added the rest of the new elements as defined by IUPAC.
Updated the library to use some newer standardized HTML5 functions, removing the polyfills from the ChemDoodle.extensions package.
The PNG package has been refactored to provide both an open() function for loading the PNG into a new window and a string() method for creating a string object of the PNG content.
A new SVG package has been added to create Scalable Vector Graphics data from the ChemDoodle Web Components, similar to the PNG package for bitmap graphics.
Minor graphical improvements for the UIs decorations.
Updated jQuery to version 2.2.4. Updated jQuery mousewheel to version 3.1.13.
Updated the entire website. Added more advanced tutorials: Image Export, Initializing Components after Closing the DOM, Sketcher: Application Window, Sketcher: Listening to User Changes.

Fixes

Corrected several places in the API where the VisualSpecifications object was not being correctly passed.
Fixed bug where rendering atoms as circles in 2D components would not properly use defined colors.
Fixed a bug in the calculation of bond retractions from atom labels.
Fixed bug where lone carbon atoms would not show labels when attributed.
All ambient colors for 3D scenes have been changed to black.
Fixed protein render issue where end of the ribbon mesh doesn't close.
Fixed several minor issues in drawing molecules.
Fixed a number of issues with the UIs where mobile gestures would also execute tap events.
Standardized sketcher hover distance to 10.
Fixed issue in sketcher where the shapes only lasso fails on the first drag if nothing is automatically selected.
Fixed sketcher bug where shapes were still rendered as hovered after they were removed from the figure with a delete and undo.
Resolved issue where atom and bond query dialogs were incorrectly checking their own ids, instead of the sketcher id when loading after the DOM is closed.
Fixed bug where resending keydown/keyup last point calls to drag would change the state's last point cache.
Corrected the UIs help buttons to work on all mobile devices.
Fixed UIs bug where clicking on option in button drop down should select the main button.
Changing a state in the UIs and selecting a button from a drop down now absorbs the correct button.
Corrected problem where the touchmove event was not being properly recognized on some Android devices.
Fixed error in bond line output for MOL files in the MOLInterpreter class.
Removed iChemLabs mods to the JCAMP format.
Removed the iChemLabs.useHTTPS() function, as it is now HTTPS only.
Fixed issue with the feature_detection.supportsTouch() function, where sometimes a non-boolean value could be returned.
Centering in 2D canvases is now based on a constant internal padding, instead of a relative one.
Source code modules now include an undefined declaration.
Moved jsBezier library from math package to lib package.

7.0.2

November 12, 2015
This is a bug fix update that resolves a few test cases due to our change to SSL/HTTPS. A bug was fixed that lead to crashes when using the iChemLabs services queue. Half bond types in the sketcher are now incremented correctly. Fixed an issue where nucleic acids were not rendered correctly with the latest cloud server.

7.0.1

September 11, 2015
This is a bug fix update that resolves an ID conflict in the query sketcher. The samples in the download have also been fixed.

7.0.0

January 31, 2015

Executive Summary

This is a major update to the ChemDoodle Web Components with new additions to the 3D features, most notably Pipe and Plank models for proteins and support for high DPI displays, such as the Apple Retina display. Also included are new iChemLabs cloud services and the introduction of our query system to the sketcher and API. Please note there are some API changes to how unit cells are handled from CIF files and other minor changes to visual specifications.

Additions

Added Pipe and Plank models for proteins.
High DPI support is now provided for WebGL based ChemDoodle Web Components on high DPI devices, like the Apple Retina display. High DPI support for the 2D components is already provided.
Queries for atoms and bonds can now be defined in the SketcherCanvas. In the SketcherCanvas constructor, you will have to send in a true value to the includeQuery parameter.
Added new iChemLabs cloud service: iChemLabs.getSimilarityMeasure(). This function takes two input molecule and returns a similarity measure based on the proprietary iChemLabs path fingerprint and the Dice similarity coefficient.
Added new iChemLabs cloud service: iChemLabs.isSupergraphIsomorphism(). This function works in the reverse of the iChemLabs.isSubgraphIsomorphism() function.
iChemLabs.isGraphIsomorphism(), iChemLabs.isSubgraphIsomorphism() and iChemLabs.isSupergraphIsomorphism() will all take query structures as arrows. You can now check for advanced structure features, such as stereochemistry and attributes like charge.
The JCAMPIntpereter class will now read in molecule data if presented.
The JCAMPIntpereter class will now read in structure-peak correlation data if presented.
A new JCAMPInterpeter.makeStructureSpectrumSet() function is provided to build canvases that show off structure/spectrum correlations.
Unit cells in 3D scenes are now explicit shapes instead of a property of the input molecule. They conform to the shape visual specifications, and the crystallography visual specifications have been removed. They can now be stored and transfered through ChemDoodle JSON.
The shapes_lineWidth_2D visual specification has been renamed to shapes_lineWidth and now affects shapes in both 2D and 3D.
The HydrogenDeducer.removeHydrogens() function now takes an additional parameter: removeStereo. If removeStereo is not set to true, then hydrogens connected with wedge bonds are retained.

Fixes

The EXP and EXP2 algorithms for 3D fogging have been fixed and now work correctly.
Measurements in 3D now adhere to the shapes_lineWidth specification.
Atoms in 3D renderings now will render the altLabel correctly if it is set for the atom and labels are showing.
Atom rgroup and any parameters have been removed. They have been superseded by the new Query objects.
Fixed discrepancy where bondLength_2D specification was not correctly named in the VisualSpecification instances, mostly affecting the sketcher.
Fixed JCAMPInterpeter issue where comment lines could cause parsing problems.
Fixed spectrum rendering issue where segments of the spectrum could be drawn outside of the graph view.
Fixed spectrum rendering error when no segments were visible.
Spectrum axis tick marks are now capped correctly to look best.
Fixed crash where WebGL views would corrupt with more than 2 touches down on Android devices.
3D ChemDoodle Web Components now resize correctly.
Fixed problem where rotation gestures were throwing errors on some mobile devices.
Fixed minor syntax and textual issues.

6.0.1

June 02, 2014

Executive Summary

This is a bugfix update to the ChemDoodle Web Components, fixing all the issues brought to our attention.

Fixes

WebGL based components now work in IE11.
iChemLabs Cloud services now work based on a queue, so all requests will proceed in the order requested, and you will no longer see a message to wait for the previous request to finish.
Added a iChemLabs.useHTTPS() function for websites that want only to use HTTPS.
Optimize zone now provides better placement when drawing triple bonds or higher.
Optimize zone now avoids placing substituents inside of rings.
Removed code calling jQuery.browser which was removed in jQuery 1.9. This code is only helpful for detecting when to use Google Chrome Frame. Note that Google Chrome Frame support (and therefore support in IE6-8) will be removed soon.
Fixed issue where clicking on the help button in some browsers would lock the component into a drag gesture.
Fixed bug where rendering atoms in 2D surrounded with a circle would error out.
Improved and simplified shaders.
Picking in 3D is now object aware, and will exclude objects if not selectable. So picking atoms for measurements is now much more responsive.
Fixed issue where measurements were not working in the Editor3D canvas on Android.
Help button now works in the Editor3DCanvas on Android.
Measurement values now render with a forward z-index of 1 Ångstrom to be placed on top of any objects in the immediate vacinity.
Minor syntax and lexical fixes.

6.0.0

February 01, 2014

Executive Summary

This is a major update to the ChemDoodle Web Components. Included is a 3D Editor UI that parities the 2D Sketcher for 3D graphics. Many new WebGL features including picking, highlighting and measurements (distances, angles and torsions). Other new features include Lewis Dot Structure rendering and CML IO. This update includes some major refactors, such as the renaming of the sketcher files and packages and inclusion of the external libraries internal to the ChemDoodle scope, so pay careful attention when upgrading.

Additions

A new EditorCanvas3D canvas which is the 3D component allowing you to interact with and alter chemical data as the 2D Sketcher does in 2D.
New measurement renderings in 3D canvases including Distances, Angles and Torsions.
Gestures are now fully supported on mobile devices for 3D canvases. You can use touches, drags and pinches to control the molecule and assign interactivity to 3D canvases on mobile devices.
The external libs (jQuery, jQuey UI, jQuery plugins, glMatrix) are now included into the ChemDoodle scope. This offers several advantages, including eliminating all library conflicts, reducing the number of files required to be installed, and controls the versions used by ChemDoodle. You can now inlcude these libraries yourself at any version and not worry about conflicts. To use the libraries inside of ChemDoodle, call them from the ChemDoodle.lib closure.
New amino acid coloring options for Rainbow and Acidity. Nucleic acids can also be rendered in Rainbow style.
A new atoms_HBlack_2D specification, which is true by default, states that hydrogens are always rendered in black on 2D canvases regardless of the other specifications. This helps make sure hydrogens appear correctly when both 2D and 3D canvases are contained on the same page and you are using a coloring scheme.
The text and basic renderers for WebGL canvases have been merged into a single shader.
We have added access to our cloud services through HTTPS as well as HTTP to suit your needs.
Lewis Dot Structure style bonds can now be rendered.
Added a new cloud call function, ChemDoodle.iChemLabs.createLewisDot() that generates a Lewis Dot Structure from a molecule data structure with 90° angles and the correct number of lone pairs to satisfy the octet rule.
Added shortcuts to the sketcher for setting wedge bonds (7 sets a protruding bond while 8 sets a recessed bond).
Added 0, 0.5 and 1.5 bond order renderings in WebGL canvases.
A new CMLInterpreter class to read and write CML.
Added a second compass type that displays through the origin.
Minor code enhancements.

Fixes

Fixed issue where in some cases where the implicit hydrogens were not rendered to the right of the atom label, the charge still offset believing so.
Fixed bug where PeriodicTableCanvas cells could not be selected on mobile devices.
Fixed bug where the help button and logo would not update correctly if the sketcher was resized.
Fixed minor issue where a return key press in some sketcher dialogs would execute button actions.
Fixed bug where the light direction was not properly copied when VisualSpecification objects were created.
Fixed issue where red merging preview circles did not appear when placing rings.
Spectra now render segments with only 1 point in the spectrum space for more complete looking spectra.
Animations now use requestAnimationFrame().
Minor bug fixes.

5.2.3

September 09, 2013

Executive Summary

This minor update addresses some bugs.

Additions

Fixes

Force font size on sketcher toolbars to avoid issues where the toolbars were stretching with some CSS clashes.
MOLInterpreter now correctly handles aromatic bonds on write.
Changed "v2000" to "V2000" in MOLfile output.
Modified front culling in WebGL to not cut off segments that extrude forward in the perspective.
Fixed WebGL shader issue that caused the shaders to fail to compile in the latest versions of Chrome.
Fixed bug in shader failure alerts.

5.2.2

June 10, 2013

Executive Summary

This minor update provides some improvements and bug fixes.

Additions

The compass in WebGL scenes will now display labels for the axes.
Added an option for back face culling in WebGL scenes, which improves performance. This is enabled by default.

Fixes

Updated jQuery mousewheel to fix Firefox behavior.
JSONInterpreter now handles bond orders of 0.
Lone pairs and radicals will now better space themselves around atom geometries with evenly distributed bonds.
Fixed issue where text would not render in WebGL scenes in Safari.
Fixed bug where some elements would not show labels in WebGL scenes when turned on.
Moved VisualSpecifications.getFontString() to ChemDoodle.extensions.getFontString().
Mobile support is now enabled only for supported mobile OSs. This also avoids the issue where the mobile controls overrode the keyboard and mouse controls on hybrid PCs.
Double click no longer centers in the Full Sketcher, which was very sensitive.
Fixed Full Sketcher issue where starting carbon atoms could be created on top of each other.

5.2.1

April 23, 2013
This update is just to fix a projection issue in 3D canvases introduced by update 5.2.

5.2.0

April 17, 2013

Executive Summary

This update enhances the sketcher, adds IUPAC naming calls, and adds some new 3D features, as well as fixing several bugs.

Additions

Added a Bond Forming Pusher to the 2D shapes (a modification of the other pushers). A new button has been added to the sketcher to draw these.
More integration with ChemDoodle desktop. You can now paste ChemDoodle JSON into the skether's open window. The next update to ChemDoodle desktop will allow the copy/paste of ChemDoodle JSON. Added two new helper functions to the ChemDoodle global, ChemDoodle.readJSON() and ChemDoodle.writeJSON() to help quickly interact with ChemDoodle JSON.
Significant improvements to complex 2D graphics. Charges are now always displayed at the top-right of labels. Bonds will avoid overlapping charges. Bonds will avoid overlapping mass numbers. Implicit hydrogens now avoid mass numbers and charges. Radicals and electron pairs now avoid implicit hydrogens.
Significant improvement to pusher graphics. Pushers will now be drawn to minimize their overlap with other features and they now appear simpler, yet still beautiful. Several choices are used to determine the best arrow to render.
Added generateIUPACName() to the iChemLabs Cloud Services to generate the IUPAC Name for the input molecule.
Added version() to the iChemLabs Cloud Services to get information from the cloud servlet that is being contacted (this is very helpful for debugging).
Added Empirical Formula, Rotatable Bond count, Total Electron count, vdW Volume and Complexity to the sketcher calculator function. More descriptors can be access through iChemLabs Cloud Services.
When using the label tools in the sketcher, you can now press and drag to sprout an atom to that label. Simply clicking on the atom or releasing the mouse above the atom will still change that atom's label.
Added fogging algorithms to 3D canvases, including linear, exp and exp^2. These features are controlled by visual specifications and will add some graphical flair to the 3D canvases.
Added a compass object for rendering at the bottom-left in 3D canvases. Several visual specifications have been added to control the compass.
Added a new visual specification, atoms_showAttributedCarbons_2D, which is true by default, and specifies whether carbon labels are to be shown if radicals or electron pairs are associated with it.
Pushers no longer draw electron pairs.
A molecule's bond array is no longer required in ChemDoodle JSON, you can leave it out and the molecule is assumed to have no bonds.

Fixes

Fixed Copier object, which now uses the JSONInterpreter to ensure a complete copy.
Fixed issues where loading content with null or undefined values could cause errors.
Fixed rendering issue where radicals were not shown if the atom's label was hidden.
Adding radicals now correctly affects the implicit hydrogen count.
Fixed sketcher issue where using keyboard shortcuts to add rings to bonds wouldn't work.
Fixed sketcher issue where initiating a dragging action in the sketcher and leaving the canvas bounds would cause issues.
Fixed bug where the eraser tool could erase bonds in the Single Molecule sketcher that would create disjoint structures and not erase atoms or ring bonds.
Fixed bug where deleting lassoed content would sometimes skip some pushers.
Fixed sketcher issue where the calculations units were shown as question marks.
Fixed issue where the rotation and translation matrices for Canvas3D were incorrectly shared.
Drop down toolbars for the sketcher now close all other open drop down toolbars when they are expanded.

5.1.0

February 24, 2013

Executive Summary

This update introduces several new features in the sketcher and continues to improve performance. Labels can now be rendered in WebGL scenes and further WebGL features will continue to be added over the course of the next couple updates.

Additions

Added Brackets. Brackets can be placed around groups of objects and annotated with charge, multiple and repeat counts. This is great for drawing reactions, polymers and polyatomic ions, among other things.
Labels can now be displayed in WebGL scenes. We are starting off with the basics of just labeling elements and residues. You can control them with the atoms_displayLabels_3D visual specification. There are other visual specifications that can also be defined to alter how the labels are rendered. See VisualSpecifications for more information.
Bonds are now formed when drawing to another atom, no matter how far away it is, regardless of the modifier keys pressed.
New bond types have been added to the sketcher and to the library. These include the resonance bond (1.5), half bond (0.5) and zero/ionic/hydrogen bond (0).
Bounds class now handles 3D coordinates.
Added both resonance and equilibrium arrows.
Text can now be added to reaction arrows by defining strings to the Line.topText and Line.bottomText variables.
Pushers can now be hovered so they can be deleted like other regular shapes.
Internal improvements to the code to change all closure based classes to prototype based classes. Also improved naming conventions for defining prototype classes. This makes object creation much faster and reduces the source size.
Removed all uneccessary return true; statements at the end of function constructors.
Removed all instances of jQuery.inArray(). It was a confusing function and now is replaced by the proper Javascript Array.indexOf().
Layouts have been removed. They are no longer necessary as reactions can be fully rendered in a single component using shapes.

Fixes

Pushers now improve their angling. They will avoid overlapping bonds if possible, and they will always point up towards the bottom of a carbonyl.
Pushers no longer render starting electrons if they originate from a bond.
Fixed sketcher issue where changing a carbon dot to another element kept it as a dot. It now correctly switches to the label of the new element.
Fixed full sketcher bug where shapes couldn't be hovered by the eraser tool.
Fixed full sketcher bug where cleaned molecules would also be centered. The molecules location is now preserved through the clean function.
Fixed single molecule sketcher bug where the move tool didn't function.
Added check to sketcher to clear the hover on mouseout in case the mouse moved quickly out of the sketcher window.
Hydrogens are now only added implicitly to elements in the other non-metals and halogens group.

5.0.0

December 16, 2012

Executive Summary

ChemDoodle Web Components 5 is a massive update. The most notable addition is a Full Sketcher, for drawing multiple molecules, shapes and figures, in addition to the Single Molecule Sketcher already provided. iChemLabs Cloud services and the ChemDoodle JSON format have been updated and drastically improved. The entire codebase has been reoptimized and cleaned, doubling the performance in desktop browsers and more than quadrupling the performance in mobile browsers. All Canvases now handle managing multiple molecules and shapes. Many new additions have been added and dozens of bug fixes have been implemented. We will be unrolling our new proprietary options over the next month, but of course, everything is available for free today under the GPL license!

New Features

A Full Molecule sketcher is now provided for drawing much more complex chemical figures. Multiple molecules and shapes can be drawn with a lasso tool and new shortcuts. Modeled fully off of the ChemDoodle desktop software. This is initialized from the same SketcherCanvas class, which now takes options in its constructor. The sketcher now includes icons embedded as data URIs, no need to manage these files separately anymore.
Canvases now manage multiple molecules. New functions have been added to the _Canvas class for molecules. For updaters, please note that the _Canvas.molecule parameter no longer exists.
Canvases now manage shapes. New functions have been added to the _Canvas class for shapes. Shapes include reaction arrows and electron pushing arrows. More shapes to come!
Formalized the native ChemDoodle Web Components format, ChemDoodle JSON, which now handles all chemical objects and shapes.
iChemLabs Cloud services have been simplified and now take options in all functions for much more controllable functionality.
Graphical bounds calculation is now much more accurate.
Added support for RXN files.
Android support for multitouch gestures!
Fixed issues where ChemDoodle Web Components sometimes could not be initialized after the document was closed.
Significant code optimizations, improving speed more than 2x in desktop browsers and more than 4x in mobile browsers. For updaters, please note that the ChemDoodle Web Components no longer makes use of Javascript null, the ChemDoodle Web Components now only recognizes Javascript undefined. All modules now enforce strict mode.
Updated jQuery to version 1.8.3, jQuery mousewheel to 3.0.6, glMatrix to 1.3.7, and jQuery UI to 1.9.2. For updaters, please make note of library name changes.
Updated the tutorial, the API now documents everything and all documentation is thorough.
Fixed dozens of bugs.
And so much more. For technical support in updating to the latest and greatest ChemDoodle Web Components, please view our support options.

4.7.0

May 06, 2012

Executive Summary

This significant update improves performance and graphics for both 2D and 3D components. PDB file reading has been optimized on the Javascript side, and you can now control the resolution of protein and nucleic meshes, leading to significantly faster loading. Two new spectrum components have been added, OverlayCanvas which draws several spectra in the same domain, and SeekerCanvas which shows plot coordinate information.

Additions

Improved the rendering of bonds adjacent to atom labels. The graphics are now significantly better. The visual specification, bonds_atomLabelBuffer_2D, is no longer a percentage of the bond length, but is now the buffer between atom labels and bond ends in pixels.
You can now control the resolution of PDB meshes with the visual specifications: proteins_verticalResolution, proteins_horizontalResolution, and nucleics_verticalResolution. The are set to high quality models by default, for low quality models, set all these values to 3. This improvement is so significant, that even huge PDB files, such as 3CC2 with nearly 100 thousands atoms, will have meshes generated by the ChemDoodle Web Components in a few seconds. The PDB demo has been updated to use low quality meshes for large structures.
A new spectrum component, OverlayCanvas, will overlay several spectra in the same domain. You can see the tutorial page for this component here.
A new spectrum component, SeekerCanvas, will display plot coordinate information based on input events. You can see the tutorial page for this component here.
The Spectrum class has a new function, getInternalCoordinates(), that will convert screen coordinates to spectrum coordinates.
The Spectrum class has a new function, getClosestPlotInternalCoordinates(), that will convert screen coordinates to the closest plot coordinates.
Added getInverseTransformedY() function to the spectrum class.
PDBInterpreter now adheres to CONECT records, and will only deduce HETATM bonds if no CONECT records are present.
PDBInterpreter bond deduction is now much faster for residue bonds. PDBInterpreter has a new parameter, deduceResidueBonds, to determine if residue bonds should be found. This is false by default.

Fixes

Significantly improved the rendering efficiency of 2D components. This is most noticeable on mobile devices.
Fixed major bug that caused Apple Safari to crash on Mac OS X Lion when large spectra were rendered.
Nucleotide backbone meshes are now segmented to avoid exceeding the WebGL index buffer size.
Fixed slits that appeared on some large ribbon models.

4.6.2

April 17, 2012

Executive Summary

This is a bugfix update to the components, bringing 1 new feature, a package to help load files from your server via url (as opposed to a server side script like PHP).

Additions

There is a new file package, ChemDoodle.io.file, with a function, content(). This content function will retrieve the content of a file given a URL for use with the ChemDoodle Web Components. This function works via AJAX and is an alternative to using server side scripts to print file contents to the HTML page. Note that this function is asynchronous and the download will occur separately from the rest of the page, but it is more convenient for those that do not have access to a server side script, or for when an application needs an asynchronous load.

Fixes

PDB optimization is now significantly faster.
Fixed issue where a drawn bond in 2D would overfill the entire canvas if the start and end coordinates are identical.
Fix several CIF parsing issues. CIF parser now respects bonds if present.
A few code and performance improvements.

4.6.1

April 02, 2012

Executive Summary

This minor update provides a number of fixes and improvements. Of significant note are a new resize function, new mobile events, a greatly improved CIF parser, that should now handle any CIF file, and the fixing of a bug that affected the rendering of very long protein ribbons.

Additions

Added a resize function, Canvas.resize(w, h), that will efficiently and quickly resize a Canvas at any time.
The width/height ratio for WebGL Canvases are now automatically determined. The corresponding visual specification will now act as an override if set.
Added a tap event to Canvases, Canvas.tap(). This event is a mobile event, and is fired when a user presses down and releases within a quarter of a second. This event will forward its action to the click event if tap is not set.
Added a touchhold event to Canvases, Canvas.touchhold(). This event is a mobile event, and is fired when the user presses down and keeps the finger down without moving it for 1 second.

Fixes

The CIF parser has been thoroughly improved and should now handle any CIF file presented.
Fixed major bug where very long protein chains would produce a WebGL mesh with more vertices than allowed currently by WebGL vertex buffers, resulting in nonsense rendering. All protein chains will now render correctly, regardless of length.
Zooming is now supported by Canvas3D in scenes with orthographic projections.
The iChemLabs function, getSMILES(), will now automatically kekulize input.
Added a defualt alt tag to the <canvas> constructor.

4.6.0

January 27, 2012

Executive Summary

This update provides Lewis Dot Structure rendering in 2D components, a new MovieCanvas3D component to play molecule movies, an XYZ file reader and several other minor additions and fixes.

Additions

Lewis Dot Structures can now be rendered in 2D components. This is achieved by setting the Atom.numLonePair variable for atoms. The sketcher now contains tools for adding and removing lone pairs.
A new component, MovieCanvas3D, will play molecule movies, given a set of Molecule data structures that represent the frames of the animation. You can control the speed of the animation, and several playback modes are provided. You can see the tutorial page for this component here.
Added an XYZInterpreter class to read molecule data from XYZ files.
The PyMOL color set for atoms is now provided in the ELEMENT array, and can be used with visual specifications identically to using the Jmol color set.
Updated glMatrix to version 1.2.3.

Fixes

Scaling 3D scenes is now more consistent as the scaling magnitude is now a function of the dimensions of the displayed structure.
Eliminated the notch that could be seen in between bonds in some cases when the "Line" representation was being used.
"Line" representation can now be used with residue visual specifications in PDB files.
Fixed bug where charges were not shown on carbons without shown labels.
Fixed issue where Atom.altLabel could not be set to the number 0.
Lone atoms represented as dots will now correctly display their label when the atoms_showAllCarbons specification is true.
Fixed bug where pinch gestures on the sketcher on mobile devices were throwing errors.
Fixed bug where help icon was nonfunctional on mobile devices if the scale of the sketcher was not 1.
Minor code improvements and optimizations.

4.5.0

January 06, 2012

Executive Summary

This update provides a few fixes and additions to the 2D components and several new features for the 3D components, including more coloring options for proteins, protein backbone rendering, star geometries, primitive line rendering, and the groundworks for our surfaces system, with dot and solid molecular surfaces.

Additions

Molecular surfaces can now be displayed. Currently only very basic surfaces can be rendered. The new ChemDoodle.informatics.MolecularSurfaceGenerator class will generate surfaces given parameters for the atomic radii set to use, probe diameter and the resolution of the surface mesh. Visual specifications for surfaces are provided. Currently, only the "Dot" and "Solid" styles are provided. A "Mesh" style, as well as transparency, gradient coloring options, and the handling of Cube files will be provided in future releases.
Added a new variable to the Atom class, altLabel, which does not need to be chemically significant and will be displayed instead of the element symbol for that atom. It will adhere to the same visual specifications that the element symbol adheres to.
Primitive lines can now be rendered for bonds. A new 3D representation "Line" is provided.
Alpha carbon backbones can now be displayed for proteins. You can control the thickness and color with visual specifications.
A new visual specification, macro_colorByChain, will color a PDB file by chain by iterating through HSL colorspace.
A new visual specification, proteins_usePolarityColors, will color amino acids in a PDB file by polarity.
Star geometries can now be rendered for non-bonded atoms. This is useful for rendering ions/metals and for displaying water oxygens in crowded PDB files. Enable it with the visual specification, atoms_nonBondedAsStars_3D.
A new visual specification, atoms_displayAllCarbonLabels_2D, to render all carbon labels. This is useful for rendering Lewis dot structures.

Fixes

Fixed bug that prevented multiple SketcherCanvas instances from being declared on the same page
Fixed bug where the help button on the SketcherCanvas did not function on mobile devices.
Fixed bug with the SketcherCanvas where toolbars would appear cutoff on the sides of the screen if the sketcher was to close to the edges of the page.
Added support for pixel ratios in WebGL canvases.

4.4.2

December 01, 2011

Executive Summary

This minor update provides a few improvements.

Fixes

Mobile events are now only linked on mobile devices, while mouse and keyboard events are only linked on non-mobile devices. This fixes the issue where mobile browsers that simulate mouse events would be double calling component functions.
Removed old if statements in WebGL shaders.
Changed highp declaration in fragment shader to mediump to better support mobile devices.
Atom symbols in MOLfile output are now left-aligned.

4.4.1

November 14, 2011

Executive Summary

This minor update provides a few improvements.

Additions

When bonds are colored by Jmol colors, they can now be rendered with a color split, instead of a smooth gradient. By default, the color will be split; the color style can be set to a gradient by changing the bonds_colorGradient visual specification to true.
Added a new iChemLabs function, getMoleculeFromContent(), which will return a Molecule data structure from an input string, given a format that ChemDoodle supports.
Updated glMatrix to version 1.0.1.

Fixes

Fixed issue where drop down buttons for the sketcher would not update the first time their function is changed.
The JCAMPInterpreter will now recognize shift offsets.

4.4.0

September 28, 2011

Executive Summary

This significant update provides new WebGL features, CIF file interpretation, 3D graphics for nucleic acids, a handful of new iChemLabs services and general improvements.

Additions

Advanced support for the features in PDB files. HETATM atoms are now displayed by default, as they usually describe ligands. Protein and nucleic acid atoms will be hidden by default, and can be shown with a visual specification. You can also control a cutoff distance from ligand atoms to show residue atoms. Water molecules can be shown and hidden with a visual specification.
New 3D graphics for nucleic acids. Tubes represent the phosphate backbone with platforms representing the bases.
Protein ribbons now have thicknesses and this can be controled with a visual specification.
Crystallographic Information Files can now be read with the new CIFInterpreter class. See this page for more details.
Unit cells can now be rendered for relevant data, and will be automatically rendered for CIF data. The unit cell color and line width can be set with visual specifications.
Added new iChemLabs services.
1. kekulize() - provided with an input Molecule, this function will kekulize either the entire single bond system, or just the resonance bonds into a valid kekule structure where pi delocalization is maximized; the kekulized copy structure will be returned as a parameter to the callback function
2. isGraphIsomorphism() - this function will determine if the arrow molecule is a graph isomorphism of the target molecule, with the boolean value being returned as a parameter to the callback function
3. isSubgraphIsomorphism() - this function will determine if the arrow molecule is a subgraph isomorphism of the target molecule, with the boolean value being returned as a parameter to the callback function
4. readIUPACName() - given an IUPAC name, the corresponding molecule will be returned as a parameter to the callback function
5. generateImage() - generates an image file of the input Molecule in any of the chemical formats that ChemDoodle understands (specified by the ext parameter); returns a link to the callback function that is the url of the file on our server that can then be downloaded
6. getZeoliteFromIZA() - given an IZA code, the read zeolite, in a Molecule data structure, will be returned as a parameter to the callback function; the three number parameters are the supercell dimensions, and if not specified, will default to 1
Visual specifications can now be set to individual atoms, bonds or groups, for total control over graphical rendering. See this page for more details.
Canvases now take into account the device pixel ratio for absolutely crisp graphics on mobile devices that support densely packed pixels. In other words, the Retina display on the iPhone 4 is now supported as well as various Android devices that have high resolution screens.
Added a new class, Splitter, to split a Molecule data structure composed of multiple discrete structures, into individual Molecule data structures.
A new feature detection function, ChemDoodle.featureDetection.supports_gesture(), to determine if the browser supports multitouch and gestures.
iChemLabs services are asynchronous by default; they can now be forced synchronous, by setting the ChemDoodle.iChemLabs.asynchronous variable to false.
Orthographic projections for WebGL canvases can now be set with visual specifications.
The calculator for the sketcher now lists more descriptors.
The calculator for the sketcher now displays units for calculations.

Fixes

Renamed the "ribbon" visual specifications to more closely match the standards by which the other specifications are named. Make sure to update these names in your programs.
MOLInterpreter no longer multiplies the y coordinate by -1, as necessary for 2D files, if the multiplier is 1, so stereocenters in 3D files remain correct.
Added shader debug alerts for program linking.
Removed all double quotes in Javascript source, replacing them with single quotes to remain consistent throughout the source code.
WebGL code cleaning and optimizing.

4.3.1

August 18, 2011

Executive Summary

This minor version update fixes a few bugs.

Additions

A new package ChemDoodle.io.PNG, for generating png images from Canvases.
Added 2D rendering support for hashed and wavy bonds.
Now packaged with jQuery 1.6.

Fixes

Minor optimizations.
Spectrum x-axis now intelligently lays out tick labels so they don't overlap.
Spectrum y-axis grids are now displayed even if the y-axis is hidden.
Fixed issue for Safari on Mac OS X Lion where group buttons for the sketcher would open their tray behind the sketching canvas.

4.3.0

April 28, 2011

Executive Summary

This update introduces a new component, the Periodic Table Canvas, which displays an interactive and customizable periodic table of elements. Minor bug fixes are also provided.

Additions

A new component, the Periodic Table Canvas is introduced. This component displays a periodic table of elements. The graphics are fully customizable and you can attach input events to the component. The most immediate use of this component is as the element chooser in the 2D sketcher. The tutorial page on this component can be found here.
Components may now be constructed on <canvas> elements already constructed in the DOM. Just set the id of the <canvas> element to a value to be used in the component constructor, and that <canvas> will become the component instead of a new one being generated.

Fixes

Fixed issue where improperly formatted, non-official, PDB files using the ATOM record caused issues.
Fixed issue where name values were not being properly interpreted in some PDB files.
Fixed issue where elements with no published vdW radii caused rendering issues when vdW radii were used. The default value of 1Å is now used if no published value is provided. These values may always be set in the ChemDoodle.ELEMENT array.
Fixed issue where starting a mobile gesture did not clear a ring preview for the sketcher.
Fixed uncought bug when trying to load a null molecule into the sketcher.

4.2.2

March 13, 2011

Executive Summary

This minor update provides full support for Microsoft Internet Explorer 9. Additionally, a few features are improved and a few bugs are fixed. The performance of the 3D components in Google Chrome has been further optimized and is now very fast for even the largest 3D scenes.

Additions

Microsoft Internet Explorer 9 is now fully supported. Try the sketcher!
iChemLabs services now work in IE9 and Opera. Try any of the non-WebGL demos in any browser, and it should work.
Improved the rendering of wedge bonds for 2D components.
Added two new visual specifications, atoms_font_bold_2D and atoms_font_italic_2D, which will control whether atom labels are drawn with bold and italic styles.
Added more robust color support for 3D components. Colors for visual specifications can now be specified in HEX, RGB, or by named color.

Fixes

Fixed issue where element types with 2 or 3 length symbols were not being properly read from PDB files.
Improved WebGL performance to be very efficient in Google Chrome.

4.2.1

March 08, 2011

Executive Summary

The minor update brings several WebGL optimizations to improve performance in Google Chrome. The glMatrix library is updated to version 0.9.5.

4.2.0

February 24, 2011

Executive Summary

This update provides significant new WebGL features. The PDBInterpreter class will now parse residue data and generate ribbon models for WebGL scenes. Support is provided for both proteins and nucleic acid based macromolecules. Many options are provided, such as cartoon based graphics and different residue color sets. Additional WebGL features include higher bond order rendering and efficiency improvements. The mobile touch event and gesture system has been upgraded to support more advanced gestures, such as multiple-taps and multiple-touch drags.

Additions

The PDBInterpreter class will now parse residue data from files and generate ribbons for rendering. The ribbons can be continuous or cartoonized. Both "Amino" and "Shapely" residue color sets are provided. All colors for ribbons and cartoon models can be customized. Both the front and back colors of ribbons can be customized.
Added a new static HashMap, ChemDoodle.RESIDUE, that contains Residue data structures and associated information.
Added a new function, ChemDoodle.iChemLabs.getOptimizedPDBStructure(), that will use iChemLabs services to download and parse a PDB file by id and return optimized structure and ribbon data. Using this function is magnitudes faster than printing the PDB file to a variable and parsing in Javascript.
Added new VisualSpecifications.bonds_showBondOrders_3D, that when set to true, will render higher order bond orders in WebGL scenes. The higher order bonds will always orient themselves to face the camera.
Added new VisualSpecifications.atoms_vdwMultiplier_3D specification, that will multiply to the van der Waals radius in WebGL scenes when vdW radii are used.
Added higher level mobile gesture, _Canvas.multitouchmove, that will notify a Canvas when multiple fingers are moving.
Added higher level mobile gesture, _Canvas.dbltap, that will notify a Canvas when a finger double-taps. If this is not implemented, an event is sent to the dblclick handler, if available.
All ChemDoodle.iChemLabs calls now accept an optional parameter function, called errorback, that will be automatically called if any errors or warnings are thrown using iChemLabs services.

Fixes

Fixed issue for the PerspectiveCanvas, on mobile devices, where the y-axis scale would initially jump when doing a pinch gesture to scale the spectrum.
Double tapping a PerspectiveCanvas on mobile devices will now reset its view.
Two finger sliding on a PerspectiveCanvas on mobile devices will translate the spectrum view.
The sketcher, on mobile devices, now reverses single-tap events if multiple fingers are detected.
Fixed issue where plus and minus keys were not being recognized in Firefox/Opera.
All Array appends based on "array[array.length] =" have been changed to array.push().
Improved WebGL Ball and Stick rendering.
Improved WebGL rendering efficiency.
The default multiplier for reading PDB files is now 1.

4.1.0

February 10, 2011

Executive Summary

This update brings significant improvements to the Spectrum canvas. Interpretation of JCAMP files has been perfected. Additionally, interfacing with iChemLabs services is now much cleaner, with proper warning messages when XHR2 is not supported. XHR2 support for Firefox 3 is now provided, so iChemLabs services now work in all browsers except Opera.

Additions

Added new iChemLabs services functions, simulate1HNMR(), simulate13CNMR() and simulateMassParentPeak(), to simulate various spectroscopic methods in Javascript.
The JCAMPInterpreter class now has a boolean parameter, convertHZ2PPm, which, when true, will automatically convert spectra in HZ to PPM when read.
Added a new gesture to the PerspectiveCanvas, shift+drag, which slides the spectrum.
Added a new option to the Spectrum class which allows for autoscaling the y-axis when zoomed in.
Added a new Spectrum function, alertMetadata(), which will pop up an alert displaying the header information of the corresponding JCAMP file.
Added new functionality to the Spectrum class, to render spectrum metadata at the top left corner of its plot. This list display is completely customizable.
Integrations now ignore any y-values less that 1% of the maximum y-value in the spectrum. This parameter is tunable.
Setting an unsymmetrical bond (wedge, double in ring) bond type twice in the SketcherCanvas will flip the bond.
An error message is now displayed when contacting iChemLabs services and XHR2 is not supported.
Added iChemLabs services support to Firefox 3; now iChemLabs services are supported in all recent browsers, except Opera.
The ChemDoodle.featureDetection.supports_xhr2() function is now local and no longer requires iChemLabs services.
The ChemDoodle Web Components qUnit testing suite is now provided in the download.
Updated jQuery to version 1.5.

Fixes

The spectrum y-axis now scales in place.
Fixed issue where the JCAMPInterpreter was rounding peak table values.
Integration lines now remain static when the y-axis is scaled.
Fixed issue where performance would degrade when zooming in on a spectrum.
Fixed bug where a crash would occur when zooming in close on an integration line.
Spectrum x-axis ticks are now more sensitive for better display of information.
Fixed issue where the JCAMPInterpreter class was incorrectly handling x-sequence checks.
JCAMPInterpreter now correctly handles y-value checks.
JCAMPInterpreter now reads in JCAMP peak tables that are missing semicolon delimiters.
The help button in the SketcherCanvas component is now clickable regardless of the current Canvas scale.
Implicit hydrogen counts are now properly accounted for based on charge and valence.
Fixed bug where setting the same bond multiple times caused multiple actions to be pushed to the history stack in the SketcherCanvas.
Fixed bug where the multiplier to the ChemDoodle.readPDB() shortcut was being ignored.
Scrolling sensitivity is increased by a factor of 10 to account for upcomming browser changes.
Minor improvements to the WebGL rendering code.
Removed dead code.
Added semicolons after local function objects to avoid possible issues in the future.

4.0.0

January 12, 2011

Executive Summary

This massive update brings a new full-featured sketching component for desktop and mobile devices, full access to the ChemDoodle desktop API through AJAX, improved animations, further optimized and smaller Javascript, new and improved packaging to reduce polluting the global Javascript namespace, and a polished touch event and mobile gesture framework. Some aspects of the API have changed slightly, so be sure to refer to the new API page.

Additions

A new full-featured sketching component, SketcherCanvas, has replaced the DoodleCanvas component. This component is completely customizable, from the buttons and canvas theme, to the way structures are rendered. This is the most professional and advanced web based sketcher available, with or without plugins. It is completely free and open-source.
The ChemDoodle Web Components library now has full access to the entire ChemDoodle desktop API through AJAX XMLHttpRequest Level 2 to our server. Now you can use the ChemDoodle Web Components library to manipulate SMILES, read and write ChemDoodle and ChemDraw files, simulate NMR, generate descriptors and much more.
The ChemDoodle Web Components library has been rewritten using closures. This optimizes the code for faster performance, and allows the code to be minified smaller. Also, only the ChemDoodle variable is now placed into the global Javascript namespace, so no conflicts should occur with other libraries. All functions in the ChemDoodle Web Components library can be accessed through the ChemDoodle variable. This means that the API has changed a bit. All code is now organized into packages that can be easily used and extended.
Added a complete and thorough tutorial to introduce users to using the ChemDoodle Web Components library. It covers everything from using the ChemDoodle object, to creating complex animations, to generating SMILES strings.
The animations framework has been improved. The framework now keeps track of time between repaint calls, for very smooth and consistent animations across all devices. The default timeout now specifies framerates of 30fps. The abstract nextFrame() function now takes a delta parameter to notify the update of how much time has ellapsed since the last call.
Calls to WebGL have been updated in anticipation for the official launch of the technology.
The WebGL warning has been removed, and WebGL canvases now just render that WebGL is unavailable if they cannot perform.
Double-clicking on the TransformCanvas component now centers the structure.
The touch event and mobile gesture framework has been improved to better handle mobile devices.
A new function has been added to retrieve the version of the current source, ChemDoodle.getVersion().
Added a new specification for molecular data in JSON for optimized storage and handling of chemical information.

Fixes

Charges are now placed in more aethetic positions.
Fixed bug where bonds referenced past rings, even after they were destroyed.
Fixed a rare issue where some mouse events were being doubly called.
Multi-word font names are now handled properly.
Removed Hanser ring detection.
Fixed bug where wedge bonds did not color according to JMol colors when the corresponding specification was set.
Changed key event access from keyCode to which.
Removed unnecessary semicolons after loops.

3.5.1

November 28, 2010

Executive Summary

This is a minor update, adding the ability to render isotope mass values as well as providing a few bug fixes and improvements.

Additions

Isotope mass values are now displayed in the appropriate position next to atom labels. This value is defined by the Atom.mass variable. By default it is -1; the attribute will be rendered if this variable is set to a positive value. The Element class now holds an additional variable, Element.mass, which defines the integer value for the mass of the most abundant isotope of the element. The MDLInterpreter class now reads and writes isotope mass values.

Fixes

Changed all calls to jQuery from $. to jQuery. to avoid conflicts with other 3rd party libraries that may be in use.
Updated font selections on the overview pages to better suit macs and mobile devices.
Removed redundant parseInt calls in MDLInterpreter.
Removed unneccessary variable declarations.
Updated the calculation of mobile event locations in accordance with the iOS 4.2 update.
Fixed issue where a mobile touch event would be registered after a gesture, causing irregular behavior in components on mobile devices.
Added a fallback message to the canvas tags to be displayed if the browser in use does not support HTML5/Canvas. This should be an exceedingly rare occurance now.
Updated jQuery to version 1.4.4. No changes were required.
jQuery plugins in the ChemDoodleWeb-libs.js file are now labelled clearly. If you need to remove jQuery from the libs file, make sure to retain the plugins as those are still required for ChemDoodle Web Components to operate properly.

3.5.0

August 15, 2010

Executive Summary

Components for spectra and reactions have been added. The entire library has been optimized to significantly improve performance across browsers and to minimize size, including the removal of several external libraries. 3D ChemDoodle Web Components have also been optimized and updated to reflect recent retrospective changes to the development browsers.

Additions

Spectrum graphics are now provided. Added SpectrumCanvas as a child of Canvas for rendering spectra. There are currently two children, ObserverCanvas, which displays a static image of a spectrum, and PerspectiveCanvas which allows for interaction with a spectrum. Spectrum graphics are completely customizable and grids and integration lines can be shown.
Added JCAMPInterpreter that reads JCAMP-DX spectra for the spectrum Canvases. All compressed JCAMP-DX data formats are read. Additional spectrum descriptors are also read, such as title, units, etc.
Reactions graphics are now provided. Added a new component, Layout, which defines how multiple, related Canvases are displayed relative to each other. Currently, there is only a single Layout, SimpleReactionLayout that shows reactants and products with plus symbols in the appropriate places, as well as a reaction arrow and condition text. All decorations for Layouts are customizable.
Charges are now rendered on molecules. Charges are now read and written by MDLInterpreter. The Doodler now manipulates charges using the + and - keys while an atom is hovered.
Optimized the ChemDoodle Web Component library for faster loads, interpretation and runtimes.
Hidden Carbons (those connecting two and only two bonds of the same bond order that are parallel to each other) will now have their labels drawn. The VisualSpecifications.atoms_showHiddenCarbons_2D boolean variable now controls this setting. It is true by default.
Added more ring perception algorithms. All ring perception classes are now children of the RingFinder class which contains methods for reducing molecule graphs to improve perception runtimes. Ring perception classes include HanserRingFinder, EulerFacetRingFinder and SSSRFinder. ChemDoodle Web Components now use a more efficient means to calculate rings, rather than just using the Hanser method, leading to much faster page loads.
Added Molecule.scaleToAverageBondLength() and Molecule.getAverageBondLength() to help in standardizing input from various sources of chemical files.
Added Molecule.getBonds(Atom a) as a helper file to return an array of the Bonds connected to the input Atom. Removed the Molecule.getBondNumber(Atom a) function as it is now redundant. Changed the Molecule.getCoordinationNumber(Atom a) function to Molecule.getCoordinationNumber(Array bonds) to be more efficient with the added getBonds method.
Added Bond.getLength() and Bond.getLength3D() helper methods.
Added a new Counter class that is the parent for objects that calculate integer descriptors for molecules. Both FrerejacqueNumberCounter and NumberOfMoleculesCounter have been added.
Setting VisualSpecifications.backgroundColor to null will now allow you to show transparent components.
Added middlemousedown, middleclick and middlemouseup events to the Canvas class.
File Loader now displays a message if the input file does not contain chemical or compatible data.
The latest version of jQuery, 1.4.2, has been integrated.
Removed the antiquated BrowserDetect external library. Replaced with simpler internal source.
The Sylvester and glUtils external libraries have been replaced with the smaller and more efficient glMatrix library.

Fixes

Changed the default framerate of animations to 20fps to greatly improve performance.
Fixed a bug in the pre-handling of mobile events where coordinates were offset.
Fixed issue where the default mobile actions for events were overridden even if the event was not supported.
Fixed several issues in Opera, and the browser is now fairly well supported.
Fixed bug where unsaturated terminal atoms would incorrectly stack Hydrogens vertically.
Replaced the right-click and drag jQuery extensions with simpler and more reliable internal source. This fixes a number of inconsistencies in mouse gestures for some browsers.
Removed unneeded source to make the library smaller and Google Closure is now used instead of Yahoo YUI to minimize and optimize the source.
Modifier keys now call the Doodler to repaint for immediate visual feedback.
Fixed issue where the bond highlight in the Doodler sometimes drew a full circle in Google Chrome.
The quaternion rotations option for Transformer Canvases has been removed. The trackball external library has been removed.
ChemDoodle Web Components will no longer hang when loading highly embedded ring systems.
Fixed boundary conditions in Hydrogen label stacking to prefer horizontal layouts.
Fixed issue where some rings were not discovered if the Molecule object's graph was disjoint.
Fixed issue where empty message did not appear in Firefox.
Stopped automatic firing of the File Loader action when loaded in Firefox.
3D ChemDoodle Web Components have been updated to reflect the recent retrospective changes to the browsers.
3D ChemDoodle Web Components now use the correct recent WebGL typed arrays.

3.1.0

July 23, 2010

Executive Summary

Major additions in this release are the rendering of implicit hydrogens in 2D components and an advanced framework for handling touch events and gestures from mobile devices. iPhone OS and Android are now fully supported!

Additions

The ChemDoodle Web Component framework for handling touch events and gestures from mobile devices (notably iPhone OS and Android) has been completed. The Canvas class now has 6 new optional abstract methods: touchstart, touchmove, touchend, gesturestart, gesturechange and gestureend.

Users can interact with ChemDoodle Web Components through a desktop browser using a keyboard and mouse or through a mobile browser using touch events and gestures. For desktop browsers, implement the mouse and keyboard event listeners to perform actions. On mobile devices, the touch events and gestures will be closely mapped to the most equivalent mouse and keyboard event handlers. This is perfect for simple applications as the drag, mousedown and mouseup events are closely matched to touch events. However, hovering is something that is not possible on mobile devices, so mousemove handlers will never be called. Additionally, gestures like pinching have no mouse equivalent.

To rectify this, write event handlers for any of the touch or gesture events to have mobile device interactions forwarded to more appropriate methods. If those mobile gesture handlers are implemented, the Canvas class will forward the corresponding events to them instead of to the mapped mouse and keyboard events. This way, you can implement all of the handlers for your single component and it will perform suitably on both desktop and mobile browsers!
Implicit hydrogens are now rendered in 2D components for all atoms with visible labels. This specification is controlled by the VisualSpecifications' atoms_implicitHydrogens_2D variable which is true by default. The numbers in hydrogen labels will be properly subscripted and the hydrogens will stack depending on the orientations of bonds from the concerned atom.
To correspond with the rendering of implicit hydrogens, a new VisualSpecifications variable, atoms_displayTerminalCarbonLabels_2D, has been added that will show carbon labels for terminal carbons. Combined with the atoms_implicitHydrogens_2D specification, methyl groups can be nicely displayed. This specification is false by default.
Animations for Rotators and Rotator3Ds can now be toggled by double clicking on them.

Fixes

The zoom scale for Transformer components can no longer become a negative value, which caused molecules to invert.
The element selecting algorithm performed when setting atom labels in the Doodler component has been greatly improved to mirror how ChemDoodle works.

3.0.0

February 06, 2010

Executive Summary

This release introduces 3D components based on WebGL technology to provide hardware accelerated 3D graphics in web browsers. The 3D components are in an alpha state due to the fact that the standard browsers do not yet support WebGL; they are fairly stable in the development browsers. Several prebuilt components are provided. Several visual representations are built in. An advanced Phong shader has been implemented in javascript/GLSL to provide quality graphics. A few minor issues with the 2D components have been fixed.

Additions

New 3D components have been included: Viewer3D, Rotator3D, Transformer3D and MolGrabber3D. Their implementation and functionality is very similar to their 2D analogues. The API has been updated for these new components.

Fixes

Fixed small issue where short bond lengths were not clearing bond overlaps.
Expanded the atomic data system to better match our ElementalData database. A new Element class has been added for storing elemental data, and an array of Elements is now provided in the ELEMENT hash array where the element symbol is the lookup key.
Added more links and updated the browser compatibility list.

2.5.0

October 08, 2009

Executive Summary

This release stabilizes the API and provides in-depth extendable functionality for creating your own custom components. The API has seen some major changes (it has been significantly improved), so make sure to review it before upgrading. jQuery has been introduced to standardize the handling of user input events, simplifying the Canvas class. Two new components have been introduced: Slideshow and Hyperlink. In addition, our test driven development suite is now exposed on the site using a modified version of QUnit. ChemDoodle Web Components 2.5 works on all major browsers, including Microsoft Internet Explorer, Mozilla Firefox, Apple Safari and Google Chrome/Chromium. Yahoo YUI Compressor is now used to minify the libs for even faster page loads.

Additions

A new Slideshow component has been added for displaying multiple molecules, one at a time, with transitions in between.
A new Hyperlink component has been added to provide basic button-like interaction with visitors. This component is completely customizable, view the components page to see some nice examples. They can redirect users to urls or execute functions on click.
The API for handling user input events has been changed significantly, all canvases are now extendable, and there is a new class called AnimatorCanvas to provide an extendable framework for producing animated components. The RotatorCanvas.startRotation() and RotatorCanvas.stopRotation() functions have been replaced with AnimatorCanvas.startAnimation() and AnimatorCanvas.stopAnimation() respectively. The API provided on the web is now much more thorough, better formatted, and is linked for easy navigation.
The jQuery library is now used by the Canvas class to standardize the handling of user input events.
Our test driven development suite is now exposed on the site using a modified version of QUnit.
Images are now supported. You can set background images for the components, and hover images for the Hyperlinks. Images override the backgroundColor visual specification.
Support for Google Chrome Frame has been implemented. The ChemDoodle Web Components now work beautifully on Microsoft Internet Explorer.
Bond stereochemistry is now possible. You can specify protruding and recessed single bonds as well as ambiguous double bonds. They are drawn as solid and dashed wedges and a crossing double bond.
New visual specifications added: atom label buffer, wedge thickness, hash width, hash spacing.
Added another algorithm to the TransformCanvas for standard x and y axis 3D rotation. This is the default, as there seems to be an issue with quaternion rotations, where some mouse directions are reversed. To enable quaternion rotations, set the TransformCanvas.useQuaternions boolean to true.
A new MolGrabberCanvas function, setSearchTerm(), has been added to preset a term to be queried on page load.
Google Chromium added to the list of supported Linux browsers, and it works very, very well with the ChemDoodle Web Components.
Yahoo YUI Compressor is now used to minify the the libs for even faster page loads.
Added more links to the Community Resources section. If you have discussed or used the ChemDoodle Web Components, let us know and we will add a link to you as well.

Fixes

Fixed issue where strokeStyle was not being set when drawing atoms as circles, leading to unexpected graphical effects when specifying bonds_JMOLColors to true. The strokeStyle is now set to 'black'.

2.1.0

September 14, 2009

Executive Summary

This release adds new functionality and fixes some minor issues. For a nice demo of the enhanced ChemDoodle Web Components, visit web.chemdoodle.com/pdb.php.

Additions

Sample PHP code for querying the RCSB Protein Data Bank has been added.
The ability to read PDB files has been added, along with a new Angstroms per bond length visual specification.
Both atoms and bonds within a molecule can now be sorted by z coordinates.
Covalent bonds can now be calculated based on covalent radii.
Added new functions for manipulating 3D coordinates between atoms.
New visual specifications for contrasting bond overlaps.
A function to remove Hydrogens and their bonds.
Added a function to copy structures.
The API has been completed.

Fixes

When reading MOLFiles, the y coordinate is now flipped so that structures appear right side up on the inverted canvas.
MOLFile output is now centered first.
Fixed minor bug that mishandled null content sent to writeMOL(content).
Fixed bug where strokeStyle was bring set for atom circle width instead of the correct lineWidth property.
Submit button names no longer cause conflicts.

2.0.0

August 16, 2009
Initial public release.

1.0.0

June 15, 2009
Initial internal release.

Interfaces

Education

Cheminformatics

Molecular Modeling

Games

File I/O

Basics

2D Structure Canvases

3D Structure Canvases

Spectrum Canvases

Other Canvases

Advanced

Non-Canvas Components

Installation > Change Log

10.0.0

Executive Summary

Additions

Fixes

9.5.0

Executive Summary

Additions

Fixes

9.4.0

Executive Summary

9.3.0

Executive Summary

Additions

Fixes

9.2.0

Executive Summary

Additions

Fixes

9.1.0

Executive Summary

Additions

Fixes

9.0.0

Executive Summary

Additions

Fixes

8.0.0

Executive Summary

Additions

Fixes

7.0.2

7.0.1

7.0.0

Executive Summary

Additions

Fixes

6.0.1

Executive Summary

Fixes

6.0.0

Executive Summary

Additions

Fixes

5.2.3

Executive Summary

Additions

Fixes

5.2.2

Executive Summary

Additions

Fixes

5.2.1

5.2.0

Executive Summary

Additions

Fixes

5.1.0

Executive Summary

Additions

Fixes

5.0.0

Executive Summary

New Features

4.7.0

Executive Summary

Additions