marvin.ImageExporter.molToDataUrl(String source, String imageType, JavaScriptObject optionalSettings)String

Creates image data stream from the given molecule source.

Parameters:

source - molecule source in MDL molfile or null to apply an empty molecule
imageType - output image data stream MIME type (default value is "image/png").

optionalSettings - JavaScript object that describes display settings. The object contains key - value pairs.

Key	Type	Values	Default value	Notes
"carbonLabelVisible"	Boolean	{true, false}	false	does not apply in "BALLSTICK" displaymode
"chiralFlagVisible"	Boolean	{true, false}	true	-
"valenceErrorVisible"	Boolean	{true, false}	true	-
"lonePairsVisible"	Boolean	{true, false}	false	-
"atomIndicesVisible"	Boolean	{true, false}	false	-
"atomMapsVisible"	Boolean	{true, false}	true	-
"cpkColoring"	Boolean	{true, false}	true	-
"displayMode"	String	{"WIREFRAME", "BALLSTICK", "STICK", "SPACEFILL"}	"WIREFRAME"	-
"implicitHydrogen"	String	{"ALL", "OFF", "HETERO", "TERMINAL_AND_HETERO"}	"TERMINAL_AND_HETERO"	If "carbonLabelVisible" value is true, "HETERO" and "TERMINAL_AND_HETERO" values will be considered as "ALL".
"backgroundColor"	String	css color	-	do not set this to leave it transparent (png) or white
"zoomMode"	String	{"fit", "autoshrink"}	"fit"	"fit" will expand every molecule to the given size, "autoshrink" scales down large molecules only.
"width"	Number	positive integer	200	-
"height"	Number	positive integer	200	-

E.g.:

 {
 'carbonLabelVisible' : false,
 'atomMapsVisible' : true,
 'chiralFlagVisible' : true,
 'valenceErrorVisible' : true,
 'lonePairsVisible' : false,
 'implicitHydrogen' : "TERMINAL_AND_HETERO",
 'displayMode' : "WIREFRAME",
 'backgroundColor' : "#ff00ff",
 'width' : 300,
 'height' : 350
 }

Returns: image stream encoded as an image data URL if image width/height is greater than zero

marvin.ImageExporter.mrvToDataUrl(String source, String imageType, JavaScriptObject optionalSettings)String

Creates image data stream from the given molecule source.

Parameters:

source - molecule source in MRV or null to apply an empty molecule
imagType - output image data stream MIME type (default value is "image/png").

optionalSettings - JavaScript object that describes display settings. The object contains key - value pairs.

Key	Type	Values	Default value	Notes
"carbonLabelVisible"	Boolean	{true, false}	false	does not apply in "BALLSTICK" displaymode
"chiralFlagVisible"	Boolean	{true, false}	true	-
"valenceErrorVisible"	Boolean	{true, false}	true	-
"lonePairsVisible"	Boolean	{true, false}	false	-
"atomIndicesVisible"	Boolean	{true, false}	false	-
"atomMapsVisible"	Boolean	{true, false}	true	-
"cpkColoring"	Boolean	{true, false}	true	-
"displayMode"	String	{"WIREFRAME", "BALLSTICK", "STICK", "SPACEFILL"}	"WIREFRAME"	-
"implicitHydrogen"	String	{"ALL", "OFF", "HETERO", "TERMINAL_AND_HETERO"}	"TERMINAL_AND_HETERO"	If "carbonLabelVisible" value is true, "HETERO" and "TERMINAL_AND_HETERO" values will be considered as "ALL".
"backgroundColor"	String	css color	-	do not set this to leave it transparent (png) or white
"zoomMode"	String	{"fit", "autoshrink"}	"fit"	"fit" will expand every molecule to the given size, "autoshrink" scales down large molecules only.
"width"	Number	positive integer	200	-
"height"	Number	positive integer	200	-

E.g.:

 {
 "carbonLabelVisible" : false,
 "atomMapsVisible" : true,
 "chiralFlagVisible" : true,
 "valenceErrorVisible" : true,
 "lonePairsVisible" : false,
 "implicitHydrogen" : "TERMINAL_AND_HETERO",
 "displayMode" : "WIREFRAME",
 "backgroundColor" : "#ff00ff",
 "zoomMode" : autoshrink,
 "width" : 300,
 "height" : 350
 }

Returns: image stream encoded as an image data URL if image width/height is greater than zero

Classes

marvin.Sketch

marvin.Sketch()

Creates a new editor widget and inserts it into the body of the current page.

marvin.Sketch(String id)

Creates a new editor widget and inserts it into the specified DOM element.

Parameters:

id - the ID of the DOM element whose child will be the editor widget.

getDisplaySettings()JavaScriptObject

Retrieves the current display settings of the editor wrapped into a JavaScript object.

Returns: map of display setting is wrapped into a JavaScript object.

Key Type Values Default value Notes

"carbonLabelVisible" Boolean {true, false} false does not apply in "BALLSTICK" displaymode

"chiralFlagVisible" Boolean {true, false} true -

"atomIndicesVisible" Boolean {true, false} false -

"atomMapsVisible" Boolean {true, false} true -

"cpkColoring" Boolean {true, false} true -

"valenceErrorVisible" Boolean {true, false} true -

"lonePairsVisible" Boolean {true, false} false -

"displayMode" String {"WIREFRAME", "BALLSTICK", "STICK", "SPACEFILL"} "WIREFRAME" -

"implicitHydrogen" String {"ALL", "OFF", "HETERO", "TERMINAL_AND_HETERO"} "TERMINAL_AND_HETERO" If "carbonLabelVisible" value is true, "HETERO" and "TERMINAL_AND_HETERO" values will be considered as "ALL".

"backgroundColor" String css color - custom non-transparent color

E.g.:

 {
  "carbonLabelVisible" : false,
  "atomIndicesVisible" : false,
  "atomMapsVisible" : true,
  "chiralFlagVisible"  : true,
  "valenceErrorVisible"  : true,
  "lonePairsVisible" : false,
  "cpkColoring" : true,
  "implicitHydrogen" : "TERMINAL_AND_HETERO",
  "displayMode" : "WIREFRAME",
  "backgroundColor" : "#ffffff"
 }

setDisplaySettings(JavaScriptObject jso)

Applies a map of settings for the editor. Check the return value of the getDisplaySettings() function to look up the full display settings map.

Parameters:

jso - map of display setting is wrapped into a JavaScript object.

Key	Type	Values	Default value	Notes
"carbonLabelVisible"	Boolean	{true, false}	false	does not apply in "BALLSTICK" displaymode
"chiralFlagVisible"	Boolean	{true, false}	true	-
"atomIndicesVisible"	Boolean	{true, false}	false	-
"atomMapsVisible"	Boolean	{true, false}	true	-
"cpkColoring"	Boolean	{true, false}	true	-
"valenceErrorVisible"	Boolean	{true, false}	true	-
"lonePairsVisible"	Boolean	{true, false}	false	-
"displayMode"	String	{"WIREFRAME", "BALLSTICK", "STICK", "SPACEFILL"}	"WIREFRAME"	-
"implicitHydrogen"	String	{"ALL", "OFF", "HETERO", "TERMINAL_AND_HETERO"}	"TERMINAL_AND_HETERO"	If "carbonLabelVisible" value is true, "HETERO" and "TERMINAL_AND_HETERO" values will be considered as "ALL".
"backgroundColor"	String	css color	-	-
"defaultTool"	String	{"rectangleSelection", "lassoSelection"}	"rectangleSelection"	set default tool
"toolbars"	String	{"standard", "education", "reaction", "markush", "search", "reporting"}	"standard"	to render toolbars by the given predefined layout
"copyasmrv"	Boolean	{true, false}	false	To prefer MRV instead of MDL molfile format at copy

E.g.:

 {
  "carbonLabelVisible" : false,
  "atomIndicesVisible" : false,
  "atomMapsVisible" : true,
  "chiralFlagVisible"  : true,
  "valenceErrorVisible"  : true,
  "lonePairsVisible" : false,
  "cpkColoring" : true,
  "implicitHydrogen" : "TERMINAL_AND_HETERO",
  "displayMode" : "WIREFRAME",
  "backgroundColor" : "#ffffff",
  "defaultTool" : "lassoSelection",
  "toolbars": "standard"
 }

clear()

Remove the canvas content.

isEmpty()boolean

Determines whether the canvas is empty or not.

Returns: True if nothing on the canvas, else false.

pasteStructure(String format, String source)JavaScriptObject

Returns a Promise object to paste a molecule source. If the paste operation is successful, the new structure will be added to the old one at the center of the current viewport. See also: importStructure(String,String).

Parameters:

format - the input format getSupportedFormats() or null to recognize the format automatically.
source - the molecule source

Returns: the Promise object

getSupportedFormats()JavaScriptObject

Returns an object which describes the available import and export formats with the following properties: "importFormats", "exportFormats". The number of the available formats depend on whether the default webservices are set or not.

Returns: the JavaScript object.

setServices(JavaScriptObject jso)

Sets up services for the editor. See the webservices.js for the list of supported services.

Parameters:

jso - map of services wrapped into a JavaScript object

 {
 "clean2dws" : <url of Clean2D webservice>
 "molconvertws" : <url of MolConvert webservice>
 "stereoinfows" : <url of CIP Stereo Info webservice>
 "reactionconvertws" : <url of Reaction converter webservice>
 "hydrogenizews" : <url of hydrogenize webservice>
 "automapperws" : <url of auto mapper webservice>
 }

addButton(JavaScriptObject jso, function() )

Appends a new button to the specified toolbar and binds its onClick event with the given function.

Parameters:

jso - attributes of button is wrapped into a JavaScript object. E.g.:

 {
  "name": "customButton", // JS String
  "image-url": "images/custom-button.png" // JS String
  "toolbar": "W" // JS String: "W" as West, "E" as East, "N" as North, "S" as South toolbar
 }

addTemplate(JavaScriptObject jso)

Append a new button to the template toolbar with the specified template structure.

Parameters:

jso - a JavaScript object that describes the template. It has to contains the following properties:

Name	Type	Description
structure	String	MRV source of the template structure
name	String	title of the template button (optional, auto generated)
icon	String	24x24 pixel size icon for the button as base64 encoded data image (optional, auto generated)

E.g.:

{
 "structure": "<cml><MDocument><MChemicalStruct><molecule molID=\"m1\"><atomArray><atom id=\"a1\" elementType=\"C\" x2=\"-12.5625\" y2=\"6.539048685882614\"/><atom id=\"a2\" elementType=\"C\" x2=\"-13.808366329017026\" y2=\"5.633832087370612\"/><atom id=\"a3\" elementType=\"C\" x2=\"-13.332503911629807\" y2=\"4.169284647450719\"/><atom id=\"a4\" elementType=\"C\" x2=\"-11.792496088370193\" y2=\"4.169284647450719\"/><atom id=\"a5\" elementType=\"C\" x2=\"-11.316633670982972\" y2=\"5.633832087370612\"/></atomArray><bondArray><bond atomRefs2=\"a1 a2\" order=\"1\"/><bond atomRefs2=\"a1 a5\" order=\"1\"/><bond atomRefs2=\"a2 a3\" order=\"1\"/><bond atomRefs2=\"a3 a4\" order=\"1\"/><bond atomRefs2=\"a4 a5\" order=\"1\"/></bondArray></molecule></MChemicalStruct></MDocument></cml>",
 "name": "CycloPentane",
 "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAABBElEQVRIie3UK08DQRiF4UdW1q4CfgISW7kSRYIrihBEJQkKi0OiCKJQSVAEtRJD0CgkqYGAIhjEzCYFlr1Mi+ubfMlezpyZPd/ssGTBHOPwP4z7uME9HnCNbFHmG3jCSbzv4TQ+G8xrfoBX5BXvcjziKMV4DQXu4nWT7rZB940tTDFqqe9F7RTbTeJLIdv1tquZYRDHXtSt5B0rCeYlq3iLXpWcYW+OCXajx5/kQtNSKTRs3Z7QrH6CeYZnNfGUTKTF1BhPyaZwLHSlUP1D/iIlpgwfWsRTMsFOhwmGuOqg7xxTIfSgNX28YF/4kp81nKkRPiXsvHOMhZ1RV2M1x8OSRr4A1pQ2FuhcylgAAAAASUVORK5CYII="
 }

getSelection()JavaScriptObject

Returns the indexes of the selected atoms and bonds. Atoms are indexed from 1.

Returns: JavaScript object with indices of selected atoms and bonds. E.g.:

 {
   "atoms" : "1,2,3",
   "bonds" : "1-2,2-3"
 }

setSelection(JavaScriptObject jso)

Selects bonds and atoms of the specified indices (assuming the indices start from 1). Bonds are identified by their atoms' indices (separate indices with '-').

Parameters:

selection - JavaScript object that describes atoms and bonds to select. E.g.:
```
 {
   "atoms" : "1,2,3",
   "bonds" : "1-2,2-3"
 }
 
```

on(String eventType, function() )

Attaches an event handler function for the specified event to the editor. Supported events:

"molchange": molecule change events
"selectionchange": selection change events
"undo": events when undo is performed
"redo": events when redo is performed

Parameters:

type - the event type ("molchange" or "selectionchange")
callback - this function is performed after the specified event is invoked.

off(String eventType, function() )

Removes one or more event handlers for the specified event to the editor.

Parameters:

type - the event type (accept same types as on(String,function()))
callback - the reference of a previously attached event handler function to remove or null to remove all event handlers for the specified event.

exportStructure(String format, JavaScriptObject options)JavaScriptObject

Returns a Promise object to access the molecule source.

Parameters:

format - the output molecule format getSupportedFormats().
options - an object that describes further options for export (not used yet).

Returns: the Promise object

importStructure(String format, JavaScriptObject source)JavaScriptObject

Returns a Promise object to import a molecule source. If the import operation is successful, the old structure will be replaced by the new one. See also: pasteStructure(String,String).

Parameters:

format - the input format getSupportedFormats() or null to recognize the format automatically.
source - the molecule source

Returns: the Promise object

Marvin JS API Reference

Table of Contents

Static functions

Classes

marvin.Sketch