This shows you the differences between two versions of the page.
— |
descriptor [2014/09/16 14:26] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ===== The <descriptor> Element ===== | ||
+ | ==== Definition and Usage ==== | ||
+ | |||
+ | The [[descriptor|<descriptor>]] element defines the initial values for properties of | ||
+ | [[media|<media>]] elements. These initial values are defined in attributes of | ||
+ | the element, or in child [[descriptorparam|<descriptorParam>]] elements. | ||
+ | |||
+ | ==== Syntax ==== | ||
+ | ^ Element ^ Attributes ^ Content ^ Parent ^ | ||
+ | | [[descriptor|<descriptor>]] | __//id//__, //player//, //explicitDur//, //region//, //freeze//, //moveLeft//, //moveRight//, //moveUp//, //moveDown//, //focusIndex//, //focusBorderColor//, //focusBorderWidth//, //focusBorderTransparency//, //focusSrc//, //focusSelSrc//, //selBorderColor//, //transIn//, //transOut// | ([[descriptorparam|<descriptorParam>]])* | [[descriptorbase|<descriptorBase>]] | | ||
+ | ==== Attributes ==== | ||
+ | |||
+ | ^ Name ^ Value ^ Description ^ | ||
+ | | //id// | It may receive any string value that begins with a letter or an underscore and that only contains letters, digits, <".">, and <"_">. | The //id// attribute uniquely identifies the element within a document. | | ||
+ | | //player// | String. If not specified, the player is determined by the object type, defined by the type attribute of the [[media|<media>]] element, or is inferred by the file extension used in the //src// attribute of the [[media|<media>]] element. | Identifies the presentation tool to be used. | | ||
+ | | //explicitDur// | <html><p></html>The //delay// attribute is be specified according with one of the following syntax:<html></p></html><html><ol></html><html><li class="level1"><div class="li"></html><"<nowiki>Hours:Minutes:Seconds.Fraction</nowiki>">, where "Hours" is an integer in the [0,23] interval, "Minutes" is an integer in the [0,59] interval, "Seconds" is an integer in the 0,59 interval, and "Fraction" is a positive integer,<html></div></li></html><html><li class="level1"><div class="li"></html>Seconds<"s">, where "Seconds" is a positive real number.<html></div></li></html><html></ol></html><html><p></html>For continuous media, the default value shall be set to the natural duration, otherwise it must be set to nil.<html></p></html> | Gives the duration of an object. | | ||
+ | | //region// | IDREF. | The //region// attribute identifies a [[region|<region>]] element used to initialize the left, right, top, bottom, height, width, and zIndex properties of the [[media|<media>]] element that refers to the [[descriptor|<descriptor>]] element. | | ||
+ | | //freeze// | <html><p></html>"true" or "false".<html></p></html><html><p></html>The default value is "false".<html></p></html> | The //freeze// attribute defines what will happen with an object at the end of its presentation, if the end content is frozen ("true") or not ("false"). | | ||
+ | | //moveLeft// | Positive integer. | The //moveLeft// attribute specifies a value equal to the //focusIndex// value associated to an element to which the focus should be applied when the "left-arrow" key is pressed. | | ||
+ | | //moveRight// | Positive integer. | The //moveRight// attribute specifies a value equal to the //focusIndex// value associated to an element to which the focus should be applied when the "right-arrow" key is pressed. | | ||
+ | | //moveUp// | Positive integer. | The //moveUp// attribute specifies a value equal to the //focusIndex// value associated to an element to which the focus should be applied when the "up-arrow" key is pressed. | | ||
+ | | //moveDown// | Positive integer. | The //moveDown// attribute specifies a value equal to the //focusIndex// value associated to an element to which the focus should be applied when the "down-arrow" key is pressed. | | ||
+ | | //focusIndex// | Positive integer | The //focusIndex// attribute specifies an index for the [[media|<media>]] element to which the focus may be applied. When the corresponding property is not defined, the object is considered as if no focus could be set. | | ||
+ | | //focusBorderColor// | <html><p></html>"white", "black", "silver", "gray", "red", "maroon", "fuchsia", "purple", "lime", "green", "yellow", "olive", "blue", "navy", "aqua", or "teal".<html></p></html><html><p></html>The default value is given by the "default.focusBorderColor" property of the //settings// object.<html></p></html> | Defines the color to decorate the screen region where the object on focus is being presented, before it is selected. | | ||
+ | | //focusBorderWidth// | <html><p></html>Integer.<html></p></html><html><p></html>The default value is defined by the "default.focusBorderWidth" property of the //settings// object.<html></p></html> | Width, in pixels, applied to the border of an element in focus. | | ||
+ | | //focusBorderTransparency// | <html><p></html>A real number in the [0,1] interval, or a real number in the [0,100] interval ending with the character <"%"> (e.g. "30%").<html></p></html><html><p></html>The default value is defined by the "default.focusTransparency" property of the //settings// object.<html></p></html> | Transparency applied to the border of an element in focus, with 1 or 100% meaning full transparency and 0 or 0% meaning no transparency. | | ||
+ | | //focusSrc// | <html><p></html>The following are valid values:<html></p></html><html><ul></html><html><li class="level1"><div class="li"></html><"<nowiki>file:///file_path/#fragment_identifier</nowiki>"> -- for local files,<html></div></li></html><html><li class="level1"><div class="li"></html><"<nowiki>http://server_identifier/file_path/#fragment_identifier</nowiki>"> -- for remote files downloaded using the HTTP protocol,<html></div></li></html><html><li class="level1"><div class="li"></html><"<nowiki>https://server_identifier/file_path/#fragment_identifier</nowiki>"> -- for remote files downloaded using the HTTPS protocol,<html></div></li></html><html><li class="level1"><div class="li"></html><"<nowiki>rtsp://server_identifier/file_path/#fragment_identifier</nowiki>"> -- for streams downloaded using the RTSP protocol,<html></div></li></html><html><li class="level1"><div class="li"></html><"<nowiki>rtp://server_identifier/file_path/#fragment_identifier</nowiki>"> -- for streams downloaded using the RTP protocol,<html></div></li></html><html><li class="level1"><div class="li"></html><"<nowiki>ncl-mirror://media_element_identifier</nowiki>"> -- for a content flow identical to the one in presentation by another [[media|<media>]] element,<html></div></li></html><html><li class="level1"><div class="li"></html><"<nowiki>sbtvd-ts:</nowiki>"> or <"<nowiki>isdb-ts:</nowiki>"> or <"<nowiki>ts://program_number.component_tag</nowiki>"> -- for elementary streams received from the transport stream.<html></div></li></html><html></ul></html><html><p></html>For //src// attribute whose value identifies the <"sbtvd-ts">, <"isdb-ts">, or <"ts"> scheme, the "program_number.component_tag", can be substituted by the following reserved words:<html></p></html><html><ul></html><html><li class="level1"><div class="li"></html>"video" -- corresponding to the primary video ES being presented on the video plan,<html></div></li></html><html><li class="level1"><div class="li"></html>"audio" -- corresponding to the primary audio ES,<html></div></li></html><html><li class="level1"><div class="li"></html>"text" -- corresponding to the primary text ES,<html></div></li></html><html><li class="level1"><div class="li"></html>"video(i)" -- corresponding to the //i//-th smaller video ES "component_tag" listed in the PMT of the tuned services,<html></div></li></html><html><li class="level1"><div class="li"></html>"audio(i)" -- corresponding to the //i//-th smaller audio ES "component_tag" listed in the PMT of the tuned services, or<html></div></li></html><html><li class="level1"><div class="li"></html>"text(i)" -- corresponding to the //i//-th smaller text ES "component_tag" listed in the PMT of the tuned services.<html></div></li></html><html></ul></html> | The //focusSrc// attribute can specify an alternative media source to be presented, instead of the current presentation, if an element receives the focus. This attribute follows the same rules of the //src// attribute of the [[media|<media>]] element. | | ||
+ | | //focusSelSrc// | Same as for //focusSrc//. | When an element on focus is selected, by pressing the activation ("SELECT" or "ENTER") key, the //focusSelSrc// property can specify an alternative media source to be presented, instead of the current presentation. This attribute follows the same rules of the //src// attribute of the [[media|<media>]] element. | | ||
+ | | //selBorderColor// | <html><p></html>"white", "black", "silver", "gray", "red", "maroon", "fuchsia", "purple", "lime", "green", "yellow", "olive", "blue", "navy", "aqua", or "teal".<html></p></html><html><p></html>The default value is given by the "default.selBorderColor" property of the //settings// object.<html></p></html> | Defines the color to decorate the screen region where the object on focus is being presented, after it is selected. | | ||
+ | | //transIn// | Semicolon-separated list of IDREFs. | The //transIn// attribute is a semicolon-separated list of [[transition|<transition>]] element identifiers. | | ||
+ | | //transOut// | Semicolon-separated list of IDREFs. | The //transOut// attribute is a semicolon-separated list of [[transition|<transition>]] element identifiers. | | ||
+ | |||
+ | |||
+ | |||