Note: API v1.0 is currently an experimental preview. The stable version v0.9 should be used in production. API v1.0 will be stabilized in December, 2017.
Added methods to all calculators for moving through or clearing the undo/redo history.
Added a GraphingCalculator.getExpressions method that returns an array of expression states.
Added a listValue observable property to helper expressions that evaluate to lists.
Added a GraphingCalculator.asyncScreenshot method that takes screenshots asynchronously for increased flexibility when needed.
The deprecated singleVariableSolutions constructor option has been removed. The graphing calculator no longer displays solutions to single variable equations in the expression list.
File Size (gzipped): 417kb
imageUploadCallback constructor option to allow custom storage of user-uploaded images. See image uploads for details.pasteGraphLink constructor optionpasteTableData constructor optioncalculator.setExpressiontrace constructor optionlinks constructor option to allow disabling external links in notes and folders, as well as links to help documentation in the expressions list for certain situations (like regressions with negative R2 values or plotted expressions with unresolved detail)secret property via calculator.setExpression. Secret expressions will be graphed (if applicable), but will not appear in the expressions list.graphReset observable event.'change' observable event to the BasicCalculators that fires any time the persisted state would change. It functions in the same way as for the graphing calculator.GraphingCalculator.setExpression.Desmos.Styles object that contains valid drawing styles.singleVariableSolutions constructor option default to false, and deprecated the option. It will be removed in future API versions.GraphingCalculator and BasicCalculator instances to unbind listeners and free resources.GraphingCalculator.getState by eliding default settings and expression properties. In many cases, this reduces the size of saved states by more than 50%.autosize constructor option to control automatic resizing behavior. Because this option is enabled by default, it is no longer required to call .resize() when updating the calculator's dimensions.File Size (gzipped): 384kb
Desmos.Calculator constructor renamed to Desmos.GraphingCalculator. Desmos.Calculator will be retained as a legacy alias indefinitely for backwards compatibility.calculator.setGraphSettings in favor of calculator.updateSettings. calculator.updateSettings is now available as part of all three calculators.calculator.graphSettings observable property to calculator.settings. calculator.graphSettings will be retained as a legacy alias for backwards compatibility.lang URL parameter in the API script src. The language of a calculator instance can be set and updated using the calculator.updateSettings function.colors constructor option. Colors of existing states can be optionally remapped by passing the {remapColors: true} option to calculator.setState.calculator.setState and calculator.setBlank now clear the undo/redo history by default. To preserve the history after either operation, pass in an additional argument of {allowUndo: true}.calculator.setDefaultState method to allow replacing the “Delete All” button with a “Reset” button that sets a custom default state instead of the blank state.focusFirstExpression method to all calculators to allow focusing the first expression.{preserveAxisNumbers: true} option to calculator.screenshot.degreeMode constructor option to allow initializing the angle mode of a scientific or graphing calculator.unobserve method.fontSize property to updateSettings.images, folders, and notes constructor options to allow optionaly disabling images, folders, and notes.restrictedFunctions constructor option to the graphing calculator that removes certain functionality that may not be allowed in some testing environments.qwertyKeyboard constructor option to the graphing and scientific calculators that allow changing the QWERTY keyboard to an alphabetical layout to comply with requirements of certain testing environments.dragMode property within Calculator.setExpression.(1,2) can now be made draggable by long-pressing their expression icon and selecting a drag mode.1/0 evaluates to undefined instead of Infinity.π/2.File Size (gzipped): 467kb
change event to the calculator that can be used to determine when a user's work should be persisted.{administerSecretFolders: true} option, users will be allowed to create secret folders and see their contents. When loaded into a calculator with {administerSecretFolders: false} (the default), secret folders are hidden from users, but their contents are still graphed, and any functions or variables defined in secret folders can still be used. This workflow is useful for creating activities that ask students to describe the properties of unknown functions.solutions constructor option has been split into separate pointsOfInterest and singleVariableSolutions options.| Name | v0.6 | v0.7 |
|---|---|---|
| Colors.RED | #c0504d | #c74440 |
| Colors.BLUE | #4f81bd | #2d70b3 |
| Colors.GREEN | #9bbb59 | #388c46 |
| Colors.PURPLE | #8064a2 | #6042a6 |
| Colors.ORANGE | #f79646 | #fa7e19 |
| Colors.BLACK | #000000 | #000000 |
File Size (gzipped): 679kb
targetPixelRatio option to calculator.screenshot, which is useful for producing oversampled images that display well on high pixel density (“retina”) screens. Defaults to 1. Previous versions of the API behaved as if this option was instead set to window.devicePixelRatio, which meant that if the client was on a retina device, screenshots would actually have dimensions twice as large as specified.Desmos.Colors.next method. Desmos.Colors is now just a list of the 6 hexidecimal colors that we use for graphs in the calculator.x^4 + y^4 < 1.File Size (gzipped): 693kb
calculator.setExpression by passing an expression object with type: 'table' and a columns property.sliderBounds and domain expression properties.calculator.mathToPixels and calculator.pixelsToMath, and observable property calculator.graphpaperBounds for being notified when the math or pixel coordinates of the graphpaper boundaries change.calculator.setMathBounds as a replacement for calculator.setViewport to be consistent with calculator.graphpaperBounds.mathCoordinates. Note that the argument to calculator.setMathBounds is an object with top, bottom, left, and right properties, whereas the argument to calculator.setViewport was an array with 4 elements. calculator.setViewport is still available for backwards compatibility, but may be deprecated in a future version.calculator.setGraphSettings and observe these properties through calculator.graphSettings.calculator.removeSelected method, and the calculator.isAnyExpressionSelected observable property. Note that these methods are likely to be superseded by richer ways of manipulating (possibly multiple) selected expressions in the future.calculator.focusedMathQuill observable property. This property gives access to the currently focused mathquill object when there is one, allowing direct use of the Mathquill API. Note that we are currently using the dev branch of Mathquill, which we expect will become master before API v0.5 is stabilized.id expression property became optional. calculator.setExpression({latex: 'y=x'}) is now a valid way to create a line, but note that it is not currently possible to manipulate an expression through the API after it is created unless an id is specified.total, length, mean, median, quantile, mad, stdev, var, cov, and corr.File Size (gzipped): 407kb
border constructor option. We will now draw a gray border around the calculator by default, unless this option is set to false.menus constructor option. Use settingsMenu and expressionsTopbar instead.calculator.removeExpressionFile Size (gzipped): 378kb
Graphpaper to Calculator.apiKey url parameter.options argument to Calculator constructor with the following options (all true/false):
keypadgraphpaperexpressionsexpressionsCollapsedmenuszoomButtonssolutionslockViewportremoveExpressionremoveExpressionsscreenshotgetStatesetStatesetBlankCalculator.HelperExpression.0 = f(x, y).