The Math command is used by GetMath when extracting math from a canvas.  It packages a math expression up into a record where it can be saved alongside other information relevant to the context of the canvas application, such as the id, position, and annotation.

It can also be useful to use the Math command when constructing a canvas that will later be deployed to Maple Learn, especially when a non-default property is needed to change the behavior and/or look of the math in the Maple Learn canvas.

When constructing a canvas expressions are passed through the Math command as a preprocessing step.  This includes the DataFrame data structure, which is translated into a data-table in the Maple Learn environment.   See Canvas,ElementsAndLayout for a complete list of elements.

When the position option is given, the math will be located at those [x,y] pixel coordinates on the canvas.

When the annotation option is given, the math will have a text message beside it on the canvas.

When the attributes option is used, those attributes will be added to the MathML <math> tag.  Some such attributes can control the behavior and/or display of the expression when dispatched to Maple Learn via the ShareCanvas command.  Most often these attributes are ignored by ShowCanvas.  See the examples section for some examples of properties that are recognized.

When unwrap=true it is expected that the given input expression is a list, and should be extracted as the contents of the list.  This allows the math to be extracted to a sequence.

The background option can be set to a string or ColorTools:-Color object, and specifies the background color of the given math.

The color option can be set to a string or ColorTools:-Color object, and specifies the color of the given math.

The border option can be set to true in order for ShowCanvas to put a box border around the given expression.

The custom option puts a custom attribute on the math expression that is useful when using GetMath in a script to find a particular math expression.

The istext option indicates that this math expression should be considered as text (it will still render as Math, but the Maple Learn interface will put it in a group-text box).

Setting readonly=true option will prevent editing this expression in the Maple Learn interface.

Setting result=false will prevent display and calculation of the result value in the Maple Learn interface.

Setting slider=false will prevent display of a slider when the given expression is an assignment of the form `&coloneq`(name,value)

Setting plot=false will exclude this expression from the shared plot in the Maple Learn interface.

Setting prefix=string, will prepend the given MathML string fragment to the expression

Setting suffix=string, will append the given MathML string fragment to the expression

Setting template=true, will cause an expression given as a list of math and MathML string fragments to be concatenated together

$\mathrm{with}\left(\mathrm{DocumentTools}:-\mathrm{Canvas}\right)\&colon;$

$m≔\mathrm{Math}\left(x+y\right)$

$m≔\mathrm{Record}\left(\mathrm{plot}=\mathrm{true}\&comma;\mathrm{container}=''group''\&comma;\mathrm{position}=\mathrm{undefined}\&comma;\mathrm{custom}=''''\&comma;\mathrm{dependency}=\left(\right)\&comma;\mathrm{result}=\mathrm{true}\&comma;\mathrm{xmlns}=''http://www.w3.org/1998/Math/MathML''\&comma;\mathrm{gridpos}=\left(\right)\&comma;\mathrm{mathml}=''$ x\&plus;y$''\&comma;\mathrm{groupnum}=\mathrm{-1}\&comma;\mathrm{math}=x+y\&comma;\mathrm{hascursor}=\mathrm{false}\&comma;\mathrm{type}=''math''\&comma;\mathrm{box}=''''\&comma;\mathrm{border}=\mathrm{false}\&comma;\mathrm{istext}=\mathrm{false}\&comma;\mathrm{annotation}=''''\&comma;\mathrm{id}=36893628093449377916\&comma;\mathrm{readonly}=\mathrm{false}\right)$

$m:-\mathrm{math}$

$x+y$

$m:-\mathrm{mathml}$

$''$ x\&plus;y$''$

$\mathrm{m2}≔\mathrm{Math}\left(x\left[2\right]+y\left[2\right]\&comma;\mathrm{position}=\left[600\&comma;100\right]\right)\&colon;$

$\mathrm{ShowCanvas}\left(\mathrm{NewCanvas}\left(\left[\mathrm{m2}\right]\right)\right)$

$\mathrm{m3}≔\mathrm{Math}\left(x\left[3\right]+y\left[3\right]\&comma;\mathrm{annotation}=''Example\; 3''\right)\&colon;$

$\mathrm{ShowCanvas}\left(\mathrm{NewCanvas}\left(\left[\mathrm{m3}\right]\right)\right)$

$\mathrm{m4}≔\mathrm{Math}\left(\mathrm{`\%+`}\left(1\&comma;1\right)=\mathrm{Typesetting}:-\mathrm{mspace}\left(\right)\&comma;\mathrm{readonly}=\mathrm{true}\right)\&colon;$

$\mathrm{ShowCanvas}\left(\mathrm{NewCanvas}\left(\left[\mathrm{m4}\right]\right)\right)$

$\mathrm{m5}≔\mathrm{Math}\left(''$ \frac{}{2}$''\right)\&colon;$

$\mathrm{ShowCanvas}\left(\mathrm{NewCanvas}\left(\left[\mathrm{m5}\right]\right)\right)$

$\mathrm{cv6}≔\mathrm{NewCanvas}\left(\left[\mathrm{Group}\left(\left[\mathrm{Text}\left(''Math\; Attributes:''\right)\&comma;\mathrm{Math}\left(\mathrm{`\%+`}\left(x\&comma;1\&comma;1\right)\right)\&comma;\mathrm{Math}\left(\mathrm{`\%+`}\left(x\&comma;1\&comma;1\right)\&comma;\mathrm{readonly}=\mathrm{true}\&comma;\mathrm{annotation}=''Read-only''\right)\&comma;\mathrm{Math}\left(\mathrm{`\%+`}\left(x\&comma;1\&comma;1\right)\&comma;\mathrm{result}=\mathrm{false}\&comma;\mathrm{annotation}=''Turn\; off\; computation\; result''\right)\&comma;\mathrm{Math}\left(\mathrm{`\%+`}\left(x\&comma;1\right)\&comma;\mathrm{plot}=\mathrm{false}\&comma;\mathrm{annotation}=''Don\text{'}t\; plot''\right)\&comma;\mathrm{Math}\left(\mathrm{`\%+`}\left(x\&comma;1\right)\&comma;\mathrm{istext}=\mathrm{true}\&comma;\mathrm{annotation}=''Text''\right)\&comma;\mathrm{Math}\left(\mathrm{`\%+`}\left(x\&comma;1\right)\&comma;\mathrm{background}=''red''\&comma;\mathrm{annotation}=''Background\; color''\right)\&comma;\mathrm{Math}\left(\mathrm{`\%+`}\left(x\&comma;1\right)\&comma;\mathrm{color}=''green''\&comma;\mathrm{annotation}=''Font\; color''\right)\right]\right)\right]\right)\&colon;$

$\mathrm{ShareCanvas}\left(\mathrm{cv6}\right)$

$\mathrm{url}≔''https://learn.maplesoft.com/\#/?d=OULPGFDHIFNKDLJJGGMKJKNOARBJLHGRPOOKHKCQHPMFKMOTBFEHCUBUCQFNOGKSAMDOCUEFGMAJMQELFLEQEGOMETNULHFSCUGU''\&colon;$

$\mathrm{cv}≔\mathrm{GetCanvas}\left(\mathrm{url}\right)\&colon;$

$M≔\mathrm{GetMath}\left(\mathrm{cv}\right)\&colon;$

$M\left[3\right]:-\mathrm{math}$

$M\left[3\right]:-\mathrm{id}$

$M\left[3\right]:-\mathrm{annotation}$

$M\left[3\right]:-\mathrm{position}$

The DocumentTools[Canvas][Math] command was introduced in Maple 2021.

For more information on Maple 2021 changes, see Updates in Maple 2021.

The DocumentTools[Canvas][Math] command was updated in Maple 2022.

The unwrap, background, color, border, custom, istext, readonly, result, slider and plot options were introduced in Maple 2022.

For more information on Maple 2022 changes, see Updates in Maple 2022.