SVG.animateMotion.ps1
|
function SVG.animateMotion { <# .Synopsis Creates SVG animateMotion elements .Description The SVG **`<animateMotion>`** element provides a way to define how an element moves along a motion path. > **Note:** To reuse an existing path, it will be necessary to use an `mpath` element inside the `<animateMotion>` element instead of the `path` attribute. .Link https://pssvg.start-automating.com/SVG.animateMotion .Link https://developer.mozilla.org/en-US/web/svg/element/animatemotion/ .Link Write-SVG #> [Reflection.AssemblyMetadata('SVG.ElementName', 'animateMotion')] [CmdletBinding(PositionalBinding=$false)] param( # The Contents of the animateMotion element [Parameter(Position=0,ValueFromPipelineByPropertyName)] [Alias('InputObject','Text', 'InnerText', 'Contents')] $Content, # A dictionary containing data. This data will be embedded in data- attributes. [Collections.IDictionary] [Parameter(ValueFromPipelineByPropertyName)] $Data, # This attribute indicate, in the range \[0,1], how far is the object along the path for each keyTimes associated values. [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','keyPoints')] [Reflection.AssemblyMetaData('SVG.Value', '{{cssxref("number")}} [; {{cssxref("number")}}]* ;?')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $KeyPoints, # This attribute defines the path of the motion, using the same syntax as the d attribute. [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','path')] [Reflection.AssemblyMetaData('SVG.Value', '<path-data>')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $Path, # This attribute defines a rotation applied to the element animated along a path, usually to make it pointing in the direction of the animation. [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','rotate')] [Reflection.AssemblyMetaData('SVG.Value', 'auto | auto-reverse | {{cssxref("number")}}')] [ValidatePattern('(?>auto|auto-reverse|\d+)')] [Reflection.AssemblyMetaData('SVG.Default value', '0')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $Rotate, # The **`href`** attribute defines a link to a resource as a reference [URL](https://developer.mozilla.org/en-US/docs/Web/SVG/Content_type#url). The exact meaning of that link depends on the context of each element using it. # # > **Note:** Specifications before SVG 2 defined an xlink:href attribute, which is now rendered obsolete by the `href` attribute. If you need to support earlier browser versions, the deprecated `xlink:href` attribute can be used as a fallback in addition to the `href` attribute, e.g. `<use href="some-id" xlink:href="some-id x="5" y="5" />`. # # [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','href')] [Reflection.AssemblyMetaData('SVG.Value', '<url>')] [Reflection.AssemblyMetaData('SVG.Animatable', 'True')] $Href, # The **`attributeType`** attribute specifies the namespace in which the target attribute and its associated values are defined. # # [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','attributeType')] [Reflection.AssemblyMetaData('SVG.Deprecated',$true)] [Reflection.AssemblyMetaData('SVG.Value', 'CSS | XML | auto')] [ValidateSet('CSS','XML','auto')] [Reflection.AssemblyMetaData('SVG.Default value', 'auto')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $AttributeType, # The **`attributeName`** attribute indicates the name of the CSS property or attribute of the target element that is going to be changed during an animation. # # [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','attributeName')] [Reflection.AssemblyMetaData('SVG.Value', '<name>')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $AttributeName, # The **`begin`** attribute defines when an animation should begin or when an element should be discarded. # # The attribute value is a semicolon separated list of values. The interpretation of a list of start times is detailed in the SMIL specification in ["Evaluation of begin and end time lists"](https://developer.mozilla.orghttps://www.w3.org/TR/2001/REC-smil-animation-20010904/#Timing-EvaluationOfBeginEndTimeLists). Each individual value can be one of the following : `<offset-value>`, `<syncbase-value>`, `<event-value>`, `<repeat-value>`, `<accessKey-value>`, `<wallclock-sync-value>` or the keyword `indefinite`. # # [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','begin')] [Reflection.AssemblyMetaData('SVG.Value', '<begin-value-list>')] [Reflection.AssemblyMetaData('SVG.Default value', '0s')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $Begin, # The **`dur`** attribute indicates the simple duration of an animation. # # [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','dur')] [Reflection.AssemblyMetaData('SVG.Value', '<clock-value> | media | indefinite')] [Reflection.AssemblyMetaData('SVG.Default value', 'indefinite')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $Dur, # The **`end`** attribute defines an end value for the animation that can constrain the active duration. # # [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','end')] [Reflection.AssemblyMetaData('SVG.Value', '<end-value-list>')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $End, # The **`min`** attribute specifies the minimum value of the active animation duration. # # [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','min')] [Reflection.AssemblyMetaData('SVG.Value', '<clock-value>')] [Reflection.AssemblyMetaData('SVG.Default value', '0')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $Min, # The **`max`** attribute specifies the maximum value of the active animation duration. # # [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','max')] [Reflection.AssemblyMetaData('SVG.Value', '<clock-value>')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $Max, # The **`restart`** attribute specifies whether or not an animation can restart. # # [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','restart')] [Reflection.AssemblyMetaData('SVG.Value', 'always | whenNotActive | never')] [ValidateSet('always','whenNotActive','never')] [Reflection.AssemblyMetaData('SVG.Default value', 'always')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $Restart, # The **`repeatCount`** attribute indicates the number of times an animation will take place. # # [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','repeatCount')] [Reflection.AssemblyMetaData('SVG.Value', '{{cssxref("number")}} | indefinite')] [ValidatePattern('(?>indefinite|\d+)')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $RepeatCount, # The **`repeatDur`** attribute specifies the total duration for repeating an animation. # # [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','repeatDur')] [Reflection.AssemblyMetaData('SVG.Value', '<clock-value> | indefinite')] [Reflection.AssemblyMetaData('SVG.Default values', 'None')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $RepeatDur, # The **`fill`** attribute has two different meanings. For shapes and text it's a presentation attribute that defines the color (_or any SVG paint servers like gradients or patterns_) used to paint the element; for animation it defines the final state of the animation. # # [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','fill')] [Reflection.AssemblyMetaData('SVG.Value', '<paint>')] [Reflection.AssemblyMetaData('SVG.Default value', 'black')] [Reflection.AssemblyMetaData('SVG.Animatable', 'True')] $Fill, # The **`calcMode`** attribute specifies the interpolation mode for the animation. # # The default mode is `linear`, however if the attribute does not support linear interpolation (e.g. for strings), the `calcMode` attribute is ignored and discrete interpolation is used. # # [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','calcMode')] [Reflection.AssemblyMetaData('SVG.Value', 'discrete | linear | paced | spline')] [ValidateSet('discrete','linear','paced','spline')] [Reflection.AssemblyMetaData('SVG.Default value', 'linear')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $CalcMode, # The `values` attribute has different meanings, depending upon the context where it's used, either it defines a sequence of values used over the course of an animation, or it's a list of numbers for a color matrix, which is interpreted differently depending on the type of color change to be performed. # # [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','values')] [Reflection.AssemblyMetaData('SVG.Value', '<list-of-values>')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $Values, # The **`keyTimes`** attribute represents a list of time values used to control the pacing of the animation. # # Each time in the list corresponds to a value in the values attribute list, and defines when the value is used in the animation. Each time value in the `keyTimes` list is specified as a floating point value between 0 and 1 (inclusive), representing a proportional offset into the duration of the animation element. # # [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','keyTimes')] [Reflection.AssemblyMetaData('SVG.Value', '{{cssxref("number")}} [ ; {{cssxref("number")}} ]* ;?')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $KeyTimes, # The **`keySplines`** attribute defines a set of [Bézier curve](https://developer.mozilla.org/en-US/docs/Glossary/Bezier_curve) control points associated with the keyTimes list, defining a cubic Bézier function that controls interval pacing. # # This attribute is ignored unless the calcMode attribute is set to `spline`. # # If there are any errors in the keySplines specification (bad values, too many or too few values), the animation will not occur. # # [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','keySplines')] [Reflection.AssemblyMetaData('SVG.Value', '<control-point> [ ;<control-point> ]* ;?')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $KeySplines, # The **`from`** attribute indicates the initial value of the attribute that will be modified during the animation. # # When used with the to attribute, the animation will change the modified attribute from the `from` value to the `to` value. When used with the by attribute, the animation will change the attribute relatively from the `from` value by the value specified in `by`. # # [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','from')] [Reflection.AssemblyMetaData('SVG.Value', 'See below')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $From, # The **`to`** attribute indicates the final value of the attribute that will be modified during the animation. # # The value of the attribute will change between the from attribute value and this value. # # [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','to')] [Reflection.AssemblyMetaData('SVG.Value', '<value>')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $To, # The **`by`** attribute specifies a relative offset value for an attribute that will be modified during an animation. # # The starting value for the attribute is either indicated by specifying it as value for the attribute given in the attributeName or the from attribute. # # [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','by')] [Reflection.AssemblyMetaData('SVG.Value', 'See below')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $By, # The **`additive`** attribute controls whether or not an animation is additive. # # It is frequently useful to define animation as an offset or delta to an attribute's value, rather than as absolute values. # # [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','additive')] [Reflection.AssemblyMetaData('SVG.Value', 'replace | sum')] [ValidateSet('replace','sum')] [Reflection.AssemblyMetaData('SVG.Default value', 'replace')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $Additive, # The **`accumulate`** attribute controls whether or not an animation is cumulative. # # It is frequently useful for repeated animations to build upon the previous results, accumulating with each iteration. This attribute said to the animation if the value is added to the previous animated attribute's value on each iteration. # # [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','accumulate')] [Reflection.AssemblyMetaData('SVG.Value', 'none | sum')] [ValidateSet('none','sum')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $Accumulate, # The **`id`** attribute assigns a unique name to an element. # # You can use this attribute with any SVG element. [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','id')] [Reflection.AssemblyMetaData('SVG.Value', '<id>')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $Id, # The **`lang`** attribute specifies the primary language used in contents and attributes containing text content of particular elements. # # There is also an xml:lang attribute (with namespace). If both of them are defined, the one with namespace is used and the one without is ignored. # # In SVG 1.1 there was a `lang` attribute defined with a different meaning and only applying to glyph elements. That attribute specified a list of languages according to {{RFC(5646, "Tags for Identifying Languages (also known as BCP 47)")}}. The glyph was meant to be used if the `xml:lang` attribute exactly matched one of the languages given in the value of this parameter, or if the `xml:lang` attribute exactly equaled a prefix of one of the languages given in the value of this parameter such that the first tag character following the prefix was "-". # # You can use this attribute with any SVG element. [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','lang')] [Reflection.AssemblyMetaData('SVG.Value', '<language-tag>')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $Lang, # The **`tabindex`** attribute allows you to control whether an element is focusable and to define the relative order of the element for the purposes of sequential focus navigation. # # You can use this attribute with any SVG element. [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','tabindex')] [Reflection.AssemblyMetaData('SVG.Value', 'valid integer')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $Tabindex, # The **`xml:base`** attribute specifies a base IRI other than the base IRI of the document or external entity. # # You can use this attribute with any SVG element. [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','xml:base')] [Reflection.AssemblyMetaData('SVG.Deprecated',$true)] [Reflection.AssemblyMetaData('SVG.Value', '<iri>')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $XmlBase, # The **`xml:lang`** attribute specifies the primary language used in contents and attributes containing text content of particular elements. # # It is a universal attribute allowed in all XML dialects to mark up the natural human language that an element contains. # # There is also a lang attribute (without namespace). If both of them are defined, the one with namespace is used and the one without is ignored. # # You can use this attribute with any SVG element. [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','xml:lang')] [Reflection.AssemblyMetaData('SVG.Deprecated',$true)] [Reflection.AssemblyMetaData('SVG.Value', '<language-tag>')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $XmlLang, # SVG supports the built-in XML **`xml:space`** attribute to handle whitespace characters inside elements. Child elements inside an element may also have an `xml:space` attribute that overrides the parent's one. # # > **Note:** Instead of using the `xml:space` attribute, use the {{cssxref("white-space")}} CSS property. # # This attribute influences how browsers parse text content and therefore changes the way the DOM is built. Therefore, changing this attribute's value through the DOM API may have no effect. # # You can use this attribute with any SVG element. [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','xml:space')] [Reflection.AssemblyMetaData('SVG.Deprecated',$true)] [Reflection.AssemblyMetaData('SVG.Value', 'default | preserve')] [ValidateSet('default','preserve')] [Reflection.AssemblyMetaData('SVG.Default value', 'default')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $XmlSpace, # « [SVG Attribute reference home](https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute) # # Assigns a class name or set of class names to an element. You may assign the same class name or names to any number of elements, however, multiple class names must be separated by whitespace characters. # # An element's class name serves two key roles: # # - As a style sheet selector, for when an author assigns style information to a set of elements. # - For general use by the browser. # # You can use this class to style SVG content using CSS. [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','class')] [Reflection.AssemblyMetaData('SVG.Categories', 'None')] [Reflection.AssemblyMetaData('SVG.Value', '<list-of-class-names>')] [Reflection.AssemblyMetaData('SVG.Animatable', 'True')] [Reflection.AssemblyMetaData('SVG.Normative document', 'SVG 1.1 (2nd Edition): The class attribute')] $Class, # The **`style`** attribute allows to style an element using CSS declarations. It functions identically to [the `style` attribute in HTML](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/style). # # You can use this attribute with any SVG element. [Parameter(ValueFromPipelineByPropertyName)] [Reflection.AssemblyMetaData('SVG.AttributeName','style')] [Reflection.AssemblyMetaData('SVG.Value', '<style>')] [Reflection.AssemblyMetaData('SVG.Animatable', 'False')] $Style ) process { $paramCopy = [Ordered]@{} + $PSBoundParameters $myCmd = $MyInvocation.MyCommand $inputObject = $_ $elementName = foreach ($myAttr in $myCmd.ScriptBlock.Attributes) { if ($myAttr.Key -eq 'SVG.ElementName') { $myAttr.Value break } } if (-not $elementName) { return } $writeSvgSplat = @{ ElementName = $elementName Attribute = $paramCopy } if ($content) { $writeSvgSplat.Content = $content } if ($OutputPath) { $writeSvgSplat.OutputPath = $OutputPath } if ($data) { $writeSvgSplat.Data = $data } Write-SVG @writeSvgSplat } } |