OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

cgmopen-members message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Subject: draft pic behavior fixes


CGM Open Members --

Have a close look at this.  It is the implementation of the cleanup for 
picture behavior, linkURI, etc.

Let's set a deadline:  comments to Dave (Release 2 editor), cc: to members, 
by Wednesday, 4th April.

Okay?

-Lofton.
Title: Editing Specs for fixing Picture Behavior

Fixing 3.1.2.2, Picture Behaviors

The language in 3.1.2.2 is a mess -- it is both incomplete and unclear. It is easiest to replace the section. Here is proposed replacement for the section.

====== proposed new text for 3.1.2.2 =======

[LHcomment: Dave, coordinate this with the other existing editorial fixes for this section. Also, be careful about fonts -- I see I have some unintended font changes here. No time to fix.]

Picture behaviors describe to the viewer how to display the picture, which is the target of a hyperlink. Picture behaviors are based on the syntax and semantics of "Frame Target Names" defined in the HTML 4.0 Specification.

The reserved names listed below describe the various picture behaviors. All other Picture Behavior values shall be valid Frame Target Names as described in the HTML 4.0 specification. Frame Target Names must begin with an alphabetic character (a-zA-Z).

In what follows, the following conventions apply:

  • "viewer" refers collectively to a browser and/or a CGM viewer (e.g., plugin). The logical result is described, not the method of achieving the result (which in general will require action by browser or viewer or both.)
  • "content" refers to either source or destination or a link, and is either a picture (CGM) or a document (HTML), depending upon the formulation of the particular link.

The following Picture Behavior values, except for _replace, are defined per HTML 4.0:

_blank
The viewer should load the designated picture or document in a new, unnamed window.
_self
The viewer should load the picture or document in the same frame as the one containing the CGM picture that refers to this target.
_parent
The viewer should load the picture or document into the immediate FRAMESET parent of the current frame in which the current picture is displayed. This value is equivalent to "_self" if the current frame has no parent.
_replace
The viewer should replace the current CGM picture by the designated CGM picture in the same rectangular area in the same frame as the picture which refers to this target. Applicable only to CGM-to-CGM links (i.e., this is not defined in HTML 4.0), this is the default behavior for such links.
_top
The viewer should load the picture or document into the full, original window (thus canceling all other frames). This value is equivalent to _self if the current frame has no parent.

If the picture behavior value is any valid name string other than the above reserved names, (it begins with an alphabetic character (a-zA-Z)), remove the existing content (picture or document) from the frame whose name matches the string and display the specified content in the specified frame. If no frame exists by the specified name, the viewer shall load the designated content (picture or document) in a new window with the specified name.

In the case that a link is HTML to CGM, the picture behavior should not be included in any fragment specification. Rather, the effect should be achieved with HTML TARGET attribute on the link specification in the HTML, per the specifications in the HTML 4.0 Recommendation. CGM viewers shall ignore picture behavior specifications in URI fragments which are part of links from non-CGM content.

[LH comment: I used "should" instead of "shall", because this is a requirement on the HTML content, and it doesn't seem that we should put conformance requirements on HTML content.]

The following table summarizes the rules for other link types, CGM-to-HTML and CGM-to-CGM:

[LHcomment: note for "target", I have *not* used Dieter's suggested text for "no matching frame". I have instead used the standard semantic from HTML 4.0 -- why should we deviate? Comments?]

Picture behaviors and different source-to-destination types.
 

CGM-to-HTML

CGM-to-CGM
_blank The viewer shall load the designated document in a new, unnamed window. The viewer shall load the designated picture in a new, unnamed window.
_self The viewer shall load the document in the same frame as the one containing the CGM picture that refers to this target. This is the default for CGM-to-HTML links. The viewer shall load the picture in the same frame as the one containing the CGM picture that refers to this target.
_parent The viewer shall load the document into the immediate FRAMESET parent of the current frame in which the current picture is displayed. This value is equivalent to "_self" if the current frame has no parent.

The viewer shall load the picture into the immediate FRAMESET parent of the current frame in which the current picture is displayed. This value is equivalent to "_self" if the current frame has no parent.

_replace Not applicable. Default to_self. The viewer shall replace the current picture by the designated picture in the same rectangular area in the same frame or window as the picture which refers to this target. This is the default behavior for CGM-to-CGM links.
_top The viewer shall load the document into the full, original window (thus canceling all other frames). This value is equivalent to _self if the current frame has no parent. The viewer shall load the picture into the full, original window (thus canceling all other frames). This value is equivalent to _self if the current frame has no parent.
target The viewer shall load the document into the frame identified by "target". If no matching frame can be found, the viewer shall load the designated content document in a new window with the specified name. The viewer shall load the picture into the frame identified by "target". If no matching frame can be found, the viewer shall load the designated content document in a new window with the specified name.

Figures 3.1 and 3.2 below give examples of _self and _replace.

[...etc...the pictures go here...]

====== proposed fix for 3.2.2.3 =======

[LHcomment: Dave, coordinate this with some other existing editorial fixes for this section.]

Replace the last 4 paragraphs as follows:

The destination of a link is specified by a Uniform Resource Identifier, or URI. Any valid URL under the specifications of RFC1738 and RFC1808 is a valid value of this parameter. This specification does not constrain the syntax or semantics of a URI in a linkURI that identifies a resource that is not a CGM file (for example, an HTML or XML document).

The Behavior string defines picture behavior associated with the link. The values and meanings are as defined in 3.1.2.2. In cases that the destination is not CGM media type, the 3rd parameter, Behavior, shall be used if picture behavior is to be specified for the link (there is no other option). The Behavior string may also be used for links to CGM media types, and is the preferred method.

In the case that the URI points to CGM media type, the picture behavior may be encoded within the optional fragment identifier in conjunction with the URI structure, per section 3.1.1, "Addressing Pictures and Objects". This form is deprecated, and may be removed in a future edition of this profile. For specifying picture behavior, particular WebCGM linkURI instances shall use either the Behavior string (preferred), or the picture behavior specification embedded in the fragment, but not both.

====== proposed fix for 3.1.3 examples =======

3.1.3.2 Example 1

Change $$new_window to _blank.

LHcomment: as Dieter pointed out, the example could look different if we deprecate pic behavior in fragment, as we are doing. Rather than rework it completely, I suggest:

Replace the paragraph with:

"When used as the value of the URI attribute in a object in a CGM file, this URI retrieves engine.cgm cgm file from the cgmopen.org web site and displays the picture named "top" in a new window, highlighting the object with an id of "cyl-hd-t". The existing display remains. The entire picture is displayed, regardless of the existence of a view context for the object "cyl-hd-t". Note that inclusion of the picture behavior, "_blank", in the URI fragment is not the preferred formulation for this link/behavior combination (see 3.2.2.3). The preferred form would place the string "_blank" into the 3rd parameter of the linkURI APS attribute, and the first parameter would be:

http://cgmopen.org/webcgm/engine.cgm#pictid(top).id(cyl-hd-t,highlight) "

3.1.3.3 Example 2

The first sentence of the description should be changed as follows: "When used as the URL in an OBJECT element in HTML, this example displays the CGM inside a rectangle defined by the width and height parameters of the OBJECT tag, displaying the whole of "top" with the pump highlighted.

3.1.3.4 Example 3

Replace the paragraph with:

"When used as the value of the URI attribute in a object in a CGM file, this URI retrieves the engine.cgm CGM file from the cgmopen.org web site and displays the fifth picture in the metafile in the frame named "topframe", highlighting the object with an id of "dist-i". The view context (if present) attribute for the object "dist-i" is used to determine the rectangular portion of the picture to display in the frame. Note, as in example 1, that inclusion of the picture behavior, "topframe", in the URI fragment is not the preferred formulation for this link/behavior combination (see 3.2.2.3). The preferred form would place the string "topframe" into the 3rd parameter of the linkURI APS attribute, and the first parameter would be:

http://cgmopen.org/webcgm/engine.cgm#pictseqno(5).id(dist-i,view_context)"

Example 4

Replace the paragraph with:

"When used as the value of the URI attribute in a object in a CGM file, this URI retrieves the engine.cgm CGM file from the cgmopen.org web site and displays the second picture in the metafile in the frame named "topframe" Note, as in example 1 and 3, that inclusion of the picture behavior, "topframe", in the URI fragment is not the preferred formulation for this link/behavior combination (see 3.2.2.3). The preferred form would place the string "topframe" into the 3rd parameter of the linkURI APS attribute, and the first parameter would be:

http://cgmopen.org/webcgm/engine.cgm#pictseqno(2) "

.


*******************
Lofton Henderson
1919 Fourteenth St., #604
Boulder, CO   80302

Phone:  303-449-8728
Email:  lofton@rockynet.com
*******************


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Powered by eList eXpress LLC