Provide additional information on the grammar and semantics for animEffect element’s filter and prLst attributes
Provide this information.
Part 4, 4.6.3
te
Proposed Disposition of DIS 29500 Comment ECMA-0068 (Modified: 2008-01-04) Agreed; these attributes of the animEffect element should be more thoroughly documented. The following changes will be made to Part 4, §4.6.3, page 3,075, line 6: Attributes Description filter (Filter) This attribute specifies the named transitions for the effect. It allows specifying multiple down-level transition types to use. The runtime will try to use the first type listed and if that one is not supported, will try the next until it either finds one it supports or there are no more in the list. The syntax used for the filter attribute value is as follows: "type(subtype);type(subtype)". Subtype may be a string value such as "fromLeft" or a numerical value depending on the type specified. This attribute specifies the animation types and subtypes to be used for the effect. Multiple animations are allowed to be listed so that in the event that a superseding animation (leftmost) cannot be rendered, a fallback animation is available. That is, the rendering application will parse the list from left to right until a supported animation is found. The syntax used for the filter attribute value is as follows: "type(subtype);type(subtype)". Subtype may be a string value such as "fromLeft" or a numerical value depending on the type specified. Reserved Types(subtypes): Value Description blinds(horizontal) blinds(vertical) Attributes Description box(in) box(out) checkerboard(across) checkerboard(down) circle diamond dissolve fade slide(fromTop) slide(fromBottom) slide(fromLeft) Attributes Description slide(fromRight) plus(in) plus(out) barn(inVertical) barn(inHorizontal) barn(outVertical) barn(outHorizontal) randomBars(horizontal) randomBars(vertical) strips(downLeft) strips(upLeft) Attributes Description strips(downRight) strips(upRight) wedge wheel(1) wheel(2) wheel(3) wheel(4) wheel(8) wipe(right) wipe(left) wipe(down) Attributes Description wipe(up) [Note: The renderings shown above are for example purposes only. Exact rendering of any animation is determined by the rendering application. As such, the same animation can have many variations, depending on the implementation. More detail for each rendering above can be found in transition, Part 4, §4.4.1.46. end note] [Example: Consider the following animation effect: <p:animEffect transition="in" filter="blinds(horizontal);blinds(vertical)"> <p:cBhvr> <p:cTn id="7" dur="500"/> <p:tgtEl> <p:spTgtspid="5"/> </p:tgtEl> </p:cBhvr> </p:animEffect> There are two animation filters shown in this example. The first is the blinds (horizontal), which the rendering application is to use as the primary animation effect. If, however, the rendering application does not support this animation, the blinds (vertical) animation will be used. In this example there are only two animation filters listed, a primary and a fallback, but it is possible to list multiple fallback filters using the syntax defined above. end example] The possible values for this attribute are defined by the XML Schema string datatype. prLst (Property List) This attribute describes a list of properties that coincide with the effect specified in the filter attribute. These properties can be set by providing a name:value pairs in a semicolon-separated list. When multiple types are listed in the filter attribute, the runtime will attempt to apply each property value even though some may not apply to it. This attribute specifies a list of properties that coincide with the effect specified. Although there are many types allowed for animations, this attribute allows the setting of specific property settings in order to describe an even wider variety of animation types. The syntax used for the prLst attribute value is as follows: “name:value;name:value”. When multiple types are listed in the filter attribute, the rendering application will attempt to apply each property value even though Attributes Description some may not apply to it. Reserved Names(values): · opacity (float values of 0.0 - 1.0) [Example: Consider the following animation effect: <p:animEffect filter="image" prLst="opacity: 0.5"> <p:cBhvr rctx="IE"> <p:cTn id="7" dur="indefinite"/> <p:tgtEl> <p:spTgtspid="3"/> </p:tgtEl> </p:cBhvr> </p:animEffect> The animation filter specified is an image filter type that has a specific property called opacity set to a value of 0.5. end example] The possible values for this attribute are defined by the XML Schema string datatype.
