The Touch.radiusX, Touch.radiusY, and Touch.rotationAngle describe the area of contact between the user and the screen, the touch area. This can be helpful when dealing with imprecise pointing devices such as fingers. These values are set to describe an ellipse that as closely as possible matches the entire area of contact (such as the user's fingertip).
Returns a unique identifier for this Touch object. A given touch point (say, by a finger) will have the same identifier for the duration of its movement around the surface. This lets you ensure that you're tracking the same touch all the time.
Returns the Element on which the touch point started when it was first placed on the surface, even if the touch point has since moved outside the interactive area of that element or even been removed from the document.
The touch utility shall change the modification times, access times, or both of files. The modification time shall beequivalent to the value of the st_mtime member of the stat structure for a file, as described in the SystemInterfaces volume of IEEE Std 1003.1-2001; the access time shall be equivalent to the value of st_atime.
The time used can be specified by the -t time option-argument, the corresponding time fields of the filereferenced by the -r ref_file option-argument, or the date_time operand, as specified in the followingsections. If none of these are specified, touch shall use the current time (the value returned by the equivalent of the time() function defined in the System Interfaces volume ofIEEE Std 1003.1-2001).
The resulting time shall be affected by the value of the TZ environment variable. If the resulting time value precedesthe Epoch, touch shall exit immediately with an error status. The range of valid times past the Epoch isimplementation-defined, but it shall extend to at least the time 0 hours, 0 minutes, 0 seconds, January 1, 2038, CoordinatedUniversal Time. Some implementations may not be able to represent dates beyond January 18, 2038, because they use signed intas a time holder.
Although the -t time option-argument specifies values in 1969, the access time and modification time fields aredefined in terms of seconds since the Epoch (00:00:00 on 1 January 1970 UTC). Therefore, depending on the value of TZ whentouch is run, there is never more than a few valid hours in 1969 and there need not be any valid times in 1969.
The functionality of touch is described almost entirely through references to functions in the System Interfaces volumeof IEEE Std 1003.1-2001. In this way, there is no duplication of effort required for describing such side effects as therelationship of user IDs to the user database, permissions, and so on.
There are some significant differences between the touch utility in this volume of IEEE Std 1003.1-2001 andthose in System V and BSD systems. They are upwards-compatible for historical applications from both implementations:
In System V, an ambiguity exists when a pathname that is a decimal number leads the operands; it is treated as a time value. InBSD, no time value is allowed; files may only be touched to the current time. The -t time constructsolves these problems for future conforming applications (note that the -t option is not historical practice).
The -r option was added because several comments requested this capability. This option was named -f in an earlyproposal, but was changed because the -f option is used in the BSD version of touch with a different meaning.
At least one historical implementation of touch incremented the exit code if -c was specified and the file did notexist. This volume of IEEE Std 1003.1-2001 requires exit status zero if no errors occur.
The Touch Events specification defines a set of low-level events that represent one or more points of contact with a touch-sensitive surface, and changes of those points with respect to the surface and any DOM elements displayed upon it (e.g. for touch screens) or associated with it (e.g. for drawing tablets without displays). It also addresses pen-tablet devices, such as drawing tablets, with consideration toward stylus capabilities.
User Agents that run on terminals which provide touch input to use web applications typically use interpreted mouse events to allow users to access interactive web applications. However, these interpreted events, being normalized data based on the physical touch input, tend to have limitations on delivering the intended user experience. Additionally, it is not possible to handle concurrent input regardless of device capability, due to constraints of mouse events: both system level limitations and legacy compatibility.
For the touchstart event this must be a list of the touch points that just became active with the current event. For the touchmove event this must be a list of the touch points that have moved since the last event. For the touchend and touchcancel events this must be a list of the touch points that have just been removed from the surface.
User agents should ensure that all Touch objects available from a given TouchEvent are all associated to the same document that the TouchEvent was dispatched to. To implement this, user agents should maintain a notion of the current touch-active document. On first touch, this is set to the target document where the touch was created. When all active touch points are released, the touch-active document is cleared. All TouchEvents are dispatched to the current touch-active document, and each Touch object it contains refers only to DOM elements (and co-ordinates) in that document. If a touch starts entirely outside the currently touch-active document, then it is ignored entirely.
This example demonstrates the utility and relations between the touches and targetTouches members defined in the TouchEvent interface. The following code will generate different output based on the number of touch points on the touchable element and the document:
This example demonstrates the utility of changedTouches and it's relation with the other TouchList members of the TouchEvent interface. The code is a example which triggers whenever a touch point is removed from the defined touchable element:
If the preventDefault method is called on this event, it should prevent any default actions caused by any touch events associated with the same active touch point, including mouse events or scrolling.
A user agent must dispatch this event type to indicate when the user removes a touch point from the touch surface, also including cases where the touch point physically leaves the touch surface, such as being dragged off of the screen.
The target of this event must be the same Element on which the touch point started when it was first placed on the surface, even if the touch point has since moved outside the interactive area of the target element.
If the preventDefault method is called on the first touchmove event of an active touch point, it should prevent any default action caused by any touchmove event associated with the same active touch point, such as scrolling.
A user agent must dispatch this event type to indicate when a touch point has been disrupted in an implementation-specific manner, such as a synchronous event or action originating from the UA canceling the touch, or the touch point leaving the document window into a non-document area which is capable of handling user interactions. (e.g. The UA's native user interface, plug-ins) A user agent may also dispatch this event type when the user places more touch points on the touch surface than the device or implementation is configured to store, in which case the earliest Touch object in the TouchList should be removed.
The user agent may dispatch both touch events and mouse events [DOM-LEVEL-2-EVENTS] in response to the same user input. If the user agent dispatches both touch events and mouse events in response to a single user action, then the touchstart event type must be dispatched before any mouse event types for that action. If the preventDefault method of touchstart or touchmove is called, the user agent should not dispatch any mouse event that would be a consequential result of the the prevented touch event.
If the user agent intreprets a sequence of touch events as a click, then it should dispatch mousemove, mousedown, mouseup, and click events (in that order) at the location of the touchend event for the corresponding touch input. If the contents of the document have changed during processing of the touch events, then the user agent may dispatch the mouse events to a different target than the touch events.
df19127ead