Some more documentation work.

This commit is contained in:
Jürg Lehni 2015-12-27 20:04:26 +01:00
parent 8967193bb9
commit d67796f655

View file

@ -13,9 +13,9 @@
/** /**
* @name PathItem * @name PathItem
* *
* @class The PathItem class is the base for any items that describe paths * @class The PathItem class is the base for any items that describe paths and
* and offer standardised methods for drawing and path manipulation, such as * offer standardised methods for drawing and path manipulation, such as
* {@link Path} and {@link CompoundPath}. * {@link Path} and {@link CompoundPath}.
* *
* @extends Item * @extends Item
*/ */
@ -33,10 +33,10 @@ var PathItem = Item.extend(/** @lends PathItem# */{
* *
* @param {PathItem} path the other item to find the intersections with * @param {PathItem} path the other item to find the intersections with
* @param {Function} [include] a callback function that can be used to * @param {Function} [include] a callback function that can be used to
* filter out undesired locations right while they are collected. * filter out undesired locations right while they are collected. When
* When defined, it shall return {@true to include a location}. * defined, it shall return {@true to include a location}.
* @return {CurveLocation[]} the locations of all intersection between the * @return {CurveLocation[]} the locations of all intersection between the
* paths * paths
* @see #getCrossings(path) * @see #getCrossings(path)
* @example {@paperscript} // Finding the intersections between two paths * @example {@paperscript} // Finding the intersections between two paths
* var path = new Path.Rectangle(new Point(30, 25), new Size(50, 50)); * var path = new Path.Rectangle(new Point(30, 25), new Size(50, 50));
@ -147,7 +147,7 @@ var PathItem = Item.extend(/** @lends PathItem# */{
* *
* @param {PathItem} path the other item to find the crossings with * @param {PathItem} path the other item to find the crossings with
* @param {Boolean} includeOverlaps whether to also count overlaps as * @param {Boolean} includeOverlaps whether to also count overlaps as
* crossings * crossings
* @see #getIntersections(path) * @see #getIntersections(path)
*/ */
getCrossings: function(path, includeOverlaps) { getCrossings: function(path, includeOverlaps) {
@ -504,7 +504,7 @@ var PathItem = Item.extend(/** @lends PathItem# */{
* @function * @function
* @param {Point} to the point where the arc should end * @param {Point} to the point where the arc should end
* @param {Boolean} [clockwise=true] specifies whether the arc should be * @param {Boolean} [clockwise=true] specifies whether the arc should be
* drawn in clockwise direction * drawn in clockwise direction
* *
* @example {@paperscript} * @example {@paperscript}
* var path = new Path(); * var path = new Path();
@ -546,13 +546,13 @@ var PathItem = Item.extend(/** @lends PathItem# */{
// DOCS: PathItem#arcTo(to, radius, rotation, clockwise, large) // DOCS: PathItem#arcTo(to, radius, rotation, clockwise, large)
/** /**
* Closes the path. When closed, Paper.js connects the first and * Closes the path. When closed, Paper.js connects the first and last
* last segment of the path with an additional curve. * segment of the path with an additional curve.
* *
* @name PathItem#closePath * @name PathItem#closePath
* @function * @function
* @param {Boolean} join controls whether the method should attempt to merge * @param {Boolean} join controls whether the method should attempt to merge
* the first segment with the last if they lie in the same location * the first segment with the last if they lie in the same location
* @see Path#closed * @see Path#closed
*/ */
@ -560,8 +560,8 @@ var PathItem = Item.extend(/** @lends PathItem# */{
* {@grouptitle Relative Drawing Commands} * {@grouptitle Relative Drawing Commands}
* *
* If called on a {@link CompoundPath}, a new {@link Path} is created as a * If called on a {@link CompoundPath}, a new {@link Path} is created as a
* child and a point is added as its first segment relative to the * child and a point is added as its first segment relative to the position
* position of the last segment of the current path. * of the last segment of the current path.
* *
* @name PathItem#moveBy * @name PathItem#moveBy
* @function * @function
@ -574,7 +574,7 @@ var PathItem = Item.extend(/** @lends PathItem# */{
* @name PathItem#lineBy * @name PathItem#lineBy
* @function * @function
* @param {Point} to the vector which is added to the position of the last * @param {Point} to the vector which is added to the position of the last
* segment of the path, to get to the position of the new segment * segment of the path, to get to the position of the new segment
* *
* @example {@paperscript} * @example {@paperscript}
* var path = new Path(); * var path = new Path();