Updated the API docs for all except:

- SkiaSharp.SK3dView
 - SkiaSharp.SKMask
This commit is contained in:
Matthew Leibowitz 2017-02-01 23:30:34 +04:00
Родитель 4ab6cb00f7
Коммит 21306d6267
12 изменённых файлов: 187 добавлений и 112 удалений

Просмотреть файл

@ -14,8 +14,23 @@
</Interface>
</Interfaces>
<Docs>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<summary>Convenience class used to automatically free the image data for a mask in a using statement.</summary>
<remarks>
<para>This class can be used in a using statement to automatically free the image data of a mask by virtue of having the <see cref="M:SkiaSharp.SKAutoMaskFreeImage.Dispose" /> method.</para>
<para></para>
<example>
<code lang="C#"><![CDATA[// some buffer
byte[] buffer = ...;
// create the mask, allocating the image
var mask = SKMask.Create(buffer, bounds, rowBytes, format);
using (new SKAutoMaskFreeImage(mask.Image)) {
// use the mask
// automatically release the image data
}]]></code>
</example>
</remarks>
</Docs>
<Members>
<Member MemberName=".ctor">
@ -29,9 +44,11 @@
<Parameter Name="maskImage" Type="System.IntPtr" />
</Parameters>
<Docs>
<param name="maskImage">To be added.</param>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<param name="maskImage">The image to free.</param>
<summary>Create a new instance of <see cref="T:SkiaSharp.SKAutoMaskFreeImage" /> with the specified image to free.</summary>
<remarks>
<para></para>
</remarks>
</Docs>
</Member>
<Member MemberName="Dispose">
@ -46,8 +63,10 @@
</ReturnValue>
<Parameters />
<Docs>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<summary>Disposes the object, releasing the image data.</summary>
<remarks>
<para></para>
</remarks>
</Docs>
</Member>
</Members>

Просмотреть файл

@ -1135,10 +1135,10 @@
<Parameter Name="mask" Type="SkiaSharp.SKMask" />
</Parameters>
<Docs>
<param name="mask">To be added.</param>
<summary>To be added.</summary>
<returns>To be added.</returns>
<remarks>To be added.</remarks>
<param name="mask">The mask to install.</param>
<summary>Installs the specified masks pixels into the bitmap.</summary>
<returns>Returns true on success, or false on failure. If there was an error, the bitmap will be set to empty.</returns>
<remarks>The caller must ensure that the specified mask pixels are valid for the lifetime of the created bitmap.</remarks>
</Docs>
</Member>
<Member MemberName="InstallPixels">

Просмотреть файл

@ -23,9 +23,9 @@
<para></para>
<para>This includes a reference to the device itself, and a stack of matrix/clip values. For any given draw call (e.g. drawRect), the geometry of the object being drawn is transformed by the concatenation of all the matrices in the stack. The transformed geometry is clipped by the intersection of all of the clips in the stack.</para>
<para></para>
<para>While the Canvas holds the state of the drawing device, the state (style) of the object being drawn is held by the Paint, which is provided as a parameter to each of the draw() methods. The Paint holds attributes such as color, typeface, the text size, the stroke width, the shader (for example, gradients, patterns), etc.</para>
<para>While the canvas holds the state of the drawing device, the state (style) of the object being drawn is held by the Paint, which is provided as a parameter to each of the draw() methods. The Paint holds attributes such as color, typeface, the text size, the stroke width, the shader (for example, gradients, patterns), etc.</para>
<para></para>
<para>The SkCanvas is returned when accessing the <see cref="P:SkiaSharp.SKSurface.Canvas" /> property of a surface.</para>
<para>The SKCanvas is returned when accessing the <see cref="P:SkiaSharp.SKSurface.Canvas" /> property of a surface.</para>
<para>Transformations</para>
<para>The <see cref="T:SkiaSharp.SKCanvas" /> supports a number of 2D transformations.   Unlike other 2D graphic systems like CoreGraphics or Cairo, SKCanvas extends the transformations to include perspectives.   </para>
<para>You can use the <see cref="M:SkiaSharp.SKCanvas.Scale" />, <see cref="M:SkiaSharp.SKCanvas.Skew" />, <see cref="M:SkiaSharp.SKCanvas.Translate" />, <see cref="M:SkiaSharp.SKCanvas.RotateDegrees" />, <see cref="M:SkiaSharp.SKCanvas.RotateRadians" /> to perform some of the most common 2D transformations.   </para>
@ -448,11 +448,14 @@
<Parameter Name="value" Type="SkiaSharp.SKData" />
</Parameters>
<Docs>
<param name="rect">To be added.</param>
<param name="key">To be added.</param>
<param name="value">To be added.</param>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<param name="rect">The bounds of the annotation.</param>
<param name="key">The name of the annotation.</param>
<param name="value">The blob of data to attach to the annotation.</param>
<summary>Send an key/value pair "annotation" to the canvas.</summary>
<remarks>
<para>The caller still retains its ownership of the data (if any).</para>
<para>Note: on may canvas types, this information is ignored, but some canvases (e.g. recording a picture or drawing to a PDF document) will pass on this information.</para>
</remarks>
</Docs>
</Member>
<Member MemberName="DrawBitmap">
@ -978,10 +981,13 @@
<Parameter Name="value" Type="SkiaSharp.SKData" />
</Parameters>
<Docs>
<param name="rect">To be added.</param>
<param name="value">To be added.</param>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<param name="rect">The bounds of the annotation.</param>
<param name="value">The data that specifies the name of the links destination.</param>
<summary>Annotates the canvas by making the specified rectangle link to a named destination (see <see cref="M:SkiaSharp.SKCanvas.DrawNamedDestinationAnnotation" />).</summary>
<remarks>
<para>The caller is responsible for managing its ownership of the data.</para>
<para>If the backend of this canvas does not support annotations, this call is safely ignored.</para>
</remarks>
</Docs>
</Member>
<Member MemberName="DrawLinkDestinationAnnotation">
@ -999,11 +1005,11 @@
<Parameter Name="value" Type="System.String" />
</Parameters>
<Docs>
<param name="rect">To be added.</param>
<param name="value">To be added.</param>
<summary>To be added.</summary>
<returns>To be added.</returns>
<remarks>To be added.</remarks>
<param name="rect">The bounds of the annotation.</param>
<param name="value">The name of the links destination.</param>
<summary>Annotates the canvas by making the specified rectangle link to a named destination (see <see cref="M:SkiaSharp.SKCanvas.DrawNamedDestinationAnnotation" />).</summary>
<returns>Returns the actual data object that was attached to the canvas.</returns>
<remarks>If the backend of this canvas does not support annotations, this call is safely ignored.</remarks>
</Docs>
</Member>
<Member MemberName="DrawNamedDestinationAnnotation">
@ -1021,10 +1027,13 @@
<Parameter Name="value" Type="SkiaSharp.SKData" />
</Parameters>
<Docs>
<param name="point">To be added.</param>
<param name="value">To be added.</param>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<param name="point">The location of the destination.</param>
<param name="value">The data that specifies the name of the destination.</param>
<summary>Annotates the canvas by associating a name with the specified point (see <see cref="M:SkiaSharp.SKCanvas.DrawLinkDestinationAnnotation" />).</summary>
<remarks>
<para>The caller is responsible for managing its ownership of the data.</para>
<para>If the backend of this canvas does not support annotations, this call is safely ignored.</para>
</remarks>
</Docs>
</Member>
<Member MemberName="DrawNamedDestinationAnnotation">
@ -1042,11 +1051,11 @@
<Parameter Name="value" Type="System.String" />
</Parameters>
<Docs>
<param name="point">To be added.</param>
<param name="value">To be added.</param>
<summary>To be added.</summary>
<returns>To be added.</returns>
<remarks>To be added.</remarks>
<param name="point">The location of the destination.</param>
<param name="value">The name of the destination.</param>
<summary>Annotates the canvas by associating a name with the specified point (see <see cref="M:SkiaSharp.SKCanvas.DrawLinkDestinationAnnotation" />).</summary>
<returns>Returns the actual data object that was attached to the canvas.</returns>
<remarks>If the backend of this canvas does not support annotations, this call is safely ignored.</remarks>
</Docs>
</Member>
<Member MemberName="DrawOval">
@ -1744,10 +1753,13 @@
<Parameter Name="value" Type="SkiaSharp.SKData" />
</Parameters>
<Docs>
<param name="rect">To be added.</param>
<param name="value">To be added.</param>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<param name="rect">The bounds of the annotation.</param>
<param name="value">The data that specifies the URL.</param>
<summary>Annotates the canvas by associating the specified URL with the specified rectangle (in local coordinates, just like <see cref="M:SkiaSharp.SKCanvas.DrawRect" />).</summary>
<remarks>
<para>The caller is responsible for managing its ownership of the data.</para>
<para>If the backend of this canvas does not support annotations, this call is safely ignored.</para>
</remarks>
</Docs>
</Member>
<Member MemberName="DrawUrlAnnotation">
@ -1765,11 +1777,11 @@
<Parameter Name="value" Type="System.String" />
</Parameters>
<Docs>
<param name="rect">To be added.</param>
<param name="value">To be added.</param>
<summary>To be added.</summary>
<returns>To be added.</returns>
<remarks>To be added.</remarks>
<param name="rect">The bounds of the annotation.</param>
<param name="value">The URL.</param>
<summary>Annotates the canvas by associating the specified URL with the specified rectangle (in local coordinates, just like <see cref="M:SkiaSharp.SKCanvas.DrawRect" />).</summary>
<returns>Returns the actual data object that was attached to the canvas.</returns>
<remarks>If the backend of this canvas does not support annotations, this call is safely ignored.</remarks>
</Docs>
</Member>
<Member MemberName="Flush">

Просмотреть файл

@ -85,10 +85,12 @@
<Parameter Name="length" Type="System.UInt64" />
</Parameters>
<Docs>
<param name="bytes">To be added.</param>
<param name="length">To be added.</param>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<param name="bytes">The array of bytes that will be copied.</param>
<param name="length">The size of the buffer to create.</param>
<summary>Creates an <see cref="T:SkiaSharp.SKData" /> by copying the provided byte array for the specified size.</summary>
<remarks>
<para />
</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">

Просмотреть файл

@ -193,12 +193,12 @@
<Parameter Name="dpi" Type="System.Single" />
</Parameters>
<Docs>
<param name="stream">To be added.</param>
<param name="metadata">To be added.</param>
<param name="dpi">To be added.</param>
<summary>To be added.</summary>
<returns>To be added.</returns>
<remarks>To be added.</remarks>
<param name="stream">The stream to write to.</param>
<param name="metadata">The document metadata to include.</param>
<param name="dpi">The DPI (pixels-per-inch) at which features without native PDF support will be rasterized.</param>
<summary>Create a PDF-backed document with the specified metadata, writing the results into a stream.</summary>
<returns>Returns the new PDF-backed document.</returns>
<remarks>PDF pages are sized in point units. 1 pt == 1/72 inch == 127/360 mm.</remarks>
</Docs>
</Member>
<Member MemberName="DefaultRasterDpi">

Просмотреть файл

@ -10,8 +10,10 @@
</Base>
<Interfaces />
<Docs>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<summary>Optional metadata to be passed into the PDF factory function.</summary>
<remarks>
<para />
</remarks>
</Docs>
<Members>
<Member MemberName="Author">
@ -25,9 +27,13 @@
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>The name of the person who created the document.</summary>
<value>
<para />
</value>
<remarks>
<para />
</remarks>
</Docs>
</Member>
<Member MemberName="Creation">
@ -41,9 +47,13 @@
<ReturnType>System.Nullable&lt;System.DateTime&gt;</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>The date and time the document was created.</summary>
<value>
<para />
</value>
<remarks>
<para />
</remarks>
</Docs>
</Member>
<Member MemberName="Creator">
@ -57,9 +67,13 @@
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>The name of the product that created the original document, if the document was converted to PDF from another format.</summary>
<value>
<para />
</value>
<remarks>
<para />
</remarks>
</Docs>
</Member>
<Member MemberName="Keywords">
@ -73,9 +87,13 @@
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>Comma-separated keywords associated with the document.</summary>
<value>
<para />
</value>
<remarks>
<para />
</remarks>
</Docs>
</Member>
<Member MemberName="Modified">
@ -89,9 +107,13 @@
<ReturnType>System.Nullable&lt;System.DateTime&gt;</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>The date and time the document was most recently modified.</summary>
<value>
<para />
</value>
<remarks>
<para />
</remarks>
</Docs>
</Member>
<Member MemberName="Producer">
@ -105,9 +127,11 @@
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>The product that is converting this document to PDF.</summary>
<value>
<para />
</value>
<remarks>Leave empty to get the default, correct value.</remarks>
</Docs>
</Member>
<Member MemberName="Subject">
@ -121,9 +145,13 @@
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>The subject of the document.</summary>
<value>
<para />
</value>
<remarks>
<para />
</remarks>
</Docs>
</Member>
<Member MemberName="Title">
@ -137,9 +165,13 @@
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>The documents title.</summary>
<value>
<para />
</value>
<remarks>
<para />
</remarks>
</Docs>
</Member>
</Members>

Просмотреть файл

@ -10,8 +10,8 @@
</Base>
<Interfaces />
<Docs>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<summary>Wraps a <see cref="T:System.IO.Stream" /> into a <see cref="T:SkiaSharp.SKWStream" /> (a writable Skia stream)</summary>
<remarks />
</Docs>
<Members>
<Member MemberName=".ctor">
@ -25,9 +25,9 @@
<Parameter Name="managedStream" Type="System.IO.Stream" />
</Parameters>
<Docs>
<param name="managedStream">To be added.</param>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<param name="managedStream">The managed stream.</param>
<summary>Creates a new writable stream from a <see cref="T:System.IO.Stream" />.</summary>
<remarks>The underlying stream is not disposed when this object is disposed.</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
@ -42,10 +42,12 @@
<Parameter Name="disposeManagedStream" Type="System.Boolean" />
</Parameters>
<Docs>
<param name="managedStream">To be added.</param>
<param name="disposeManagedStream">To be added.</param>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<param name="managedStream">The managed stream.</param>
<param name="disposeManagedStream">If this is set to <see langword="true" />, the provided <see langword="managedStream" /> will be disposed when this instance is disposed.</param>
<summary>Creates a new writable stream from a <see cref="T:System.IO.Stream" />.</summary>
<remarks>
<para />
</remarks>
</Docs>
</Member>
<Member MemberName="Dispose">

Просмотреть файл

@ -9,8 +9,10 @@
<BaseTypeName>System.Enum</BaseTypeName>
</Base>
<Docs>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<summary>Formats that indicate the memory format of the underlying image data of a <see cref="T:SkiaSharp.SKMask" />.</summary>
<remarks>
<para></para>
</remarks>
</Docs>
<Members>
<Member MemberName="A8">
@ -24,7 +26,7 @@
<ReturnType>SkiaSharp.SKMaskFormat</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<summary>8-bits per pixel mask (e.g. antialiasing)</summary>
</Docs>
</Member>
<Member MemberName="Argb32">
@ -38,7 +40,7 @@
<ReturnType>SkiaSharp.SKMaskFormat</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<summary>Premultiplied color</summary>
</Docs>
</Member>
<Member MemberName="BW">
@ -52,7 +54,7 @@
<ReturnType>SkiaSharp.SKMaskFormat</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<summary>1-bit per pixel mask (e.g. monochrome)</summary>
</Docs>
</Member>
<Member MemberName="Lcd16">
@ -66,7 +68,7 @@
<ReturnType>SkiaSharp.SKMaskFormat</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<summary>565 alpha for r/g/b</summary>
</Docs>
</Member>
<Member MemberName="ThreeD">
@ -80,7 +82,7 @@
<ReturnType>SkiaSharp.SKMaskFormat</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<summary>3 8-bit per pixel planes: alpha, mul, add</summary>
</Docs>
</Member>
</Members>

Просмотреть файл

@ -52,7 +52,7 @@
<ReturnType>SkiaSharp.SKStrokeJoin</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<summary>Connect path segments with a sharp join.</summary>
</Docs>
</Member>
<Member MemberName="Mitter">

Просмотреть файл

@ -10,8 +10,8 @@
</Base>
<Interfaces />
<Docs>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<summary>A specialized <see cref="T:SkiaSharp.SKCanvas" /> which generates SVG commands from its draw calls.</summary>
<remarks>The canvas may buffer some drawing calls, so the output is not guaranteed to be valid or complete until the canvas instance is deleted.</remarks>
</Docs>
<Members>
<Member MemberName="Create">
@ -29,11 +29,11 @@
<Parameter Name="writer" Type="SkiaSharp.SKXmlWriter" />
</Parameters>
<Docs>
<param name="bounds">To be added.</param>
<param name="writer">To be added.</param>
<summary>To be added.</summary>
<returns>To be added.</returns>
<remarks>To be added.</remarks>
<param name="bounds">The initial SVG viewport (viewBox attribute on the root SVG element).</param>
<param name="writer">The writer to recieve the XML data.</param>
<summary>Creates a new instance of <see cref="T:SkiaSharp.SKSvgCanvas" /> which writes to the specified XML writer.</summary>
<returns>Returns the new canvas.</returns>
<remarks>Ownership of the XML writer is not transfered to the canvas, but it must stay valid during the lifetime of the returned canvas.</remarks>
</Docs>
</Member>
</Members>

Просмотреть файл

@ -10,8 +10,10 @@
</Base>
<Interfaces />
<Docs>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<summary>A stream-based XML writer.</summary>
<remarks>
<para></para>
</remarks>
</Docs>
<Members>
<Member MemberName=".ctor">
@ -25,9 +27,11 @@
<Parameter Name="stream" Type="SkiaSharp.SKWStream" />
</Parameters>
<Docs>
<param name="stream">To be added.</param>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<param name="stream">The stream to write the XML to.</param>
<summary>Creates a new instance of <see cref="T:SkiaSharp.SKXmlStreamWriter" /> which writes to the provided stream.</summary>
<remarks>
<para></para>
</remarks>
</Docs>
</Member>
<Member MemberName="Dispose">

Просмотреть файл

@ -10,8 +10,10 @@
</Base>
<Interfaces />
<Docs>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<summary>An abstract, XML writer.</summary>
<remarks>
<para></para>
</remarks>
</Docs>
<Members />
</Type>