Updated READMEs in Graphics group

Bobrovsky · Bobrovsky · commit 2ed51f3bd183 · 2024-10-19T19:21:57.000+06:00
diff --git a/Samples/Graphics/BlendModes/README.md b/Samples/Graphics/BlendModes/README.md
@@ -1,4 +1,11 @@
-# Blend modes
-This sample shows how to customize a way in which semi-transparent objects will blend on a canvas.
+# Set up blend modes in PDF using C# and VB.NET
 
-You can use PdfCanvas.BlendMode property to customize how semi-transparent objects (text, images and so on) will blend on a canvas. There is a set of predefined blend modes, please take a look at PdfBlendMode enumeration.
+This sample shows how to customize a way in which semi-transparent objects will blend on a canvas using [Docotic.Pdf library](https://bitmiracle.com/pdf-library/).
+
+## Description
+
+You can use the [PdfCanvas.BlendMode](https://api.docotic.com/pdfcanvas-blendmode) property to customize how semi-transparent objects like text, images and so on will blend on a canvas. For the set of predefined blend modes, check the [PdfBlendMode enumeration](https://api.docotic.com/pdfblendmode).
+
+## See also
+* [Get free time-limited license key](https://bitmiracle.com/pdf-library/download)
+* [Using semi-transparent colors in C# and VB.NET](/Samples/Graphics/Transparency) sample
diff --git a/Samples/Graphics/Clipping/README.md b/Samples/Graphics/Clipping/README.md
@@ -1,6 +1,13 @@
-# Clipping
-This sample shows how to use current graphics path as a clip region of a canvas.
+# Set up clipping on a PDF canvas in C# and VB.NET
 
-After a graphics path is constructed, you can set it as a clip region of a canvas using PdfCanvas.SetClip method. After a clip region is set, you can fill or stroke it. You can also just continue drawing on a canvas.
+This sample shows how to use the current graphics path as a clip region of a canvas.
 
-When a clip region is set on a canvas, any part of a drawn object (including text and images) that lay outside the clip region will not be visible.
+## Description
+
+[Docotic.Pdf library](https://bitmiracle.com/pdf-library/) provides methods to add vector graphics like lines, curves, and shapes to [graphics path](/Samples/Graphics/Paths). You can set the current graphics path as a clip region of a canvas using the [PdfCanvas.SetClip](https://api.docotic.com/pdfcanvas-setclip) method. 
+
+Once you set a clip region, you can fill or stroke it. You can also just continue drawing on a canvas. When a canvas has a clip region, any part of a graphics, text and images that lay outside the clip region will not be visible.
+
+## See also
+* [Get free time-limited license key](https://bitmiracle.com/pdf-library/download)
+* [Construct graphics paths in C# and VB.NET](/Samples/Graphics/Paths) sample
diff --git a/Samples/Graphics/ColorProfiles/README.md b/Samples/Graphics/ColorProfiles/README.md
@@ -1,4 +1,12 @@
-# Color profiles
-This sample shows how to load an ICC profile and then create and use a color with that color profile.
+# Using color profiles in C# and VB.NET
 
-In addition to device-dependent colors Docotic.Pdf library can also use colors with associated color profiles. To use color profiles, first add a color profile to your document using PdfDocument.AddColorProfile method and then use the returned PdfColorProfile object as a parameter when creating a color.
+This sample shows how to load an ICC profile in a PDF document and then use this color profile to specify a color.
+
+## Description
+
+Besides device-dependent colors, [Docotic.Pdf library](https://bitmiracle.com/pdf-library/) can use colors with associated color profiles. To use color profiles, first add a color profile to your document using one of the [PdfDocument.AddColorProfile](https://api.docotic.com/pdfdocument-addcolorprofile) methods and then use the returned [PdfColorProfile](https://api.docotic.com/pdfcolorprofile) object as a parameter when creating a color.
+
+## See also
+* [Get free time-limited license key](https://bitmiracle.com/pdf-library/download)
+* [Setting canvas colors in C# and VB.NET](/Samples/Graphics/Colors) sample
+* [Using semi-transparent colors in C# and VB.NET](/Samples/Graphics/Transparency) sample
diff --git a/Samples/Graphics/Colors/README.md b/Samples/Graphics/Colors/README.md
@@ -1,6 +1,17 @@
-# Colors
-This sample shows how to use colors.
+# Setting canvas colors in C# and VB.NET
 
-Docotic.Pdf library supports Gray, RGB and CMYK colors. Corresponding classes are PdfGrayColor, PdfRgbColor and PdfCmykColor.
+This sample shows how to use colors on a PDF page canvas.
 
-Use PdfCanvas.Pen.Color and PdfCanvas.Brush.Color properties to set color of a pen or a brush to be used on canvas. Pens are used to stroke lines, brushes are used to fill areas and shapes.
+## Description
+
+[Docotic.Pdf library](https://bitmiracle.com/pdf-library/) supports Gray, RGB and CMYK device-dependent colors. Corresponding classes are [PdfGrayColor](https://api.docotic.com/pdfgraycolor), [PdfRgbColor](https://api.docotic.com/pdfrgbcolor) and [PdfCmykColor](https://api.docotic.com/pdfcmykcolor).
+
+You can change the color of a [canvas pen](https://api.docotic.com/pdfcanvas-pen) to specify the color for strokes. Use the [PdfPen.Color property](https://api.docotic.com/pdfpen-color) for this. 
+
+There is also a [brush](https://api.docotic.com/pdfcanvas-brush) that is used to fill areas and shapes. You can change the brush color using the [PdfBrush.Color property](https://api.docotic.com/pdfbrush-color).
+
+## See also
+* [Get free time-limited license key](https://bitmiracle.com/pdf-library/download)
+* [Using color profiles in C# and VB.NET](/Samples/Graphics/ColorProfiles) sample
+* [Using semi-transparent colors in C# and VB.NET](/Samples/Graphics/Transparency) sample
+* [Stroke and fill PDF canvas with patterns in C# and VB.NET](/Samples/Graphics/Patterns) sample
diff --git a/Samples/Graphics/ExtractPaths/README.md b/Samples/Graphics/ExtractPaths/README.md
@@ -1,4 +1,13 @@
-# Extract paths
-This sample shows how to extract vector paths from a page and copy them to a new document.
+# Extract paths from PDF in C# and VB.NET
 
-Use PdfPath objects in PdfPage.GetObjects() resulting collection to extract vector paths. A path consists of one or more disconnected subpaths. Each subpath comprises a sequence of connected segments.
+This sample shows how to extract vector paths from a page and copy them to a new document using [Docotic.Pdf library](https://bitmiracle.com/pdf-library/).
+
+## Description
+
+Use one of the [PdfPage.GetObjects](https://api.docotic.com/pdfpage-getobjects) methods to get the collection of page objects. Then enumerate the collection and use objects of the [PdfPath type](https://api.docotic.com/pdfpath) to extract vector paths.
+
+A path is a one or more disconnected sub-paths. Each sub-path comprises a sequence of connected segments.
+
+## See also
+* [Get free time-limited license key](https://bitmiracle.com/pdf-library/download)
+* [Vector graphics](https://bitmiracle.com/pdf-library/edit/#graphics)
diff --git a/Samples/Graphics/GraphicsState/README.md b/Samples/Graphics/GraphicsState/README.md
@@ -1,6 +1,13 @@
-# Graphics state
-This sample shows how to save and restore graphics state using PdfCanvas.SaveState and PdfCanvas.RestoreState methods.
+# Working with graphics state in C# and VB.NET
 
-PdfCanvas maintains a set of properties, such as pen, brush, current positions for text and graphics, font, e.t.c. This set of properties is called graphics state.
+This sample shows how to save and restore graphics state using [PdfCanvas.SaveState](https://api.docotic.com/pdfcanvas-savestate) and [PdfCanvas.RestoreState](https://api.docotic.com/pdfcanvas-restorestate) methods.
 
-Current graphics state can be saved and previously saved state can be restored. Use PdfCanvas.SaveState() method to save current graphics state and PdfCanvas.RestoreState() method to restore last saved graphics state.
+## Description
+
+Every [PDF canvas](https://api.docotic.com/pdfcanvas) maintains a set of properties, such as pen, brush, current positions for text and graphics, font, e.t.c. This set of properties is called graphics state.
+
+Using [Docotic.Pdf library](https://bitmiracle.com/pdf-library/) you can save the current graphics state. Later, you can restore the previously saved state. Restoring the saved state is the only way to remove clipping, for example.
+
+## See also
+* [Get free time-limited license key](https://bitmiracle.com/pdf-library/download)
+* [Set up clipping on a PDF canvas in C# and VB.NET](/Samples/Graphics/Clipping) sample
diff --git a/Samples/Graphics/LinesAndCurves/README.md b/Samples/Graphics/LinesAndCurves/README.md
@@ -1,6 +1,13 @@
-# Lines and Curves
-This sample shows how to draw straight lines and cubic Bezier curves.
+# Draw lines and curves in C# and VB.NET
 
-All drawing in a PDF document is done using methods and properties of PdfCanvas class. You can access it using Canvas property of PdfPage, PdfWatermark or PdfPattern classes.
+This sample shows how to draw straight lines and cubic Bezier curves on PDF canvas using [Docotic.Pdf library](https://bitmiracle.com/pdf-library/).
 
-There is a plenty of methods that draw lines, curves and shapes. All such methods have names that start with "Draw" (e.g. DrawLineTo method). All kinds of lines are drawn using current pen (PdfCanvas.Pen property).
+## Description
+
+To draw anything in a PDF document, use the methods and properties of the [PdfCanvas](https://api.docotic.com/pdfcanvas) class. You can access a canvas using the `Canvas` property of [PdfPage](https://api.docotic.com/pdfpage), [PdfXObject](https://api.docotic.com/pdfxobject), or [PdfTilingPattern](https://api.docotic.com/pdftilingpattern) classes.
+
+There are plenty of methods that draw lines, curves and shapes. All these methods have names that start with `Draw` (e.g. `DrawLineTo` method). The [current pen](https://api.docotic.com/pdfcanvas-pen) is used to draw all kinds of lines.
+
+## See also
+* [Get free time-limited license key](https://bitmiracle.com/pdf-library/download)
+* [Setting canvas colors in C# and VB.NET](/Samples/Graphics/Colors) sample
diff --git a/Samples/Graphics/Paths/README.md b/Samples/Graphics/Paths/README.md
@@ -1,6 +1,14 @@
-# Paths
-This sample shows how to construct and use graphics path.
+# Construct graphics paths in C# and VB.NET
 
-Graphics path is a series of connected lines and curves. You can construct a graphics path using methods of PdfCanvas class with names that start with "Append" (e.g. AppendLineTo, AppendRectangle). All those methods do not place any marks on a canvas. Instead, they add corresponding shapes to the current graphics path.
+This sample shows how to construct and use graphics paths on PDF canvas using Docotic.Pdf library.
 
-When a graphics path is constructed, you can fill, stroke or reset it. You can also use constructed path as a clip region of a canvas.
+## Description 
+
+Graphics path is a series of connected lines and curves. You can construct a graphics path using methods of the [PdfCanvas](https://api.docotic.com/pdfcanvas) class with names that start with `Append` (e.g. `AppendLineTo`, `AppendRectangle`). All those methods do not place any marks on a canvas. Instead, they add corresponding shapes to the current graphics path.
+
+You can fill, stroke, or reset the constructed graphics path. You can also use the constructed path as a clip region of a canvas.
+
+## See also
+* [Get free time-limited license key](https://bitmiracle.com/pdf-library/download)
+* [Working with graphics state in C# and VB.NET](/Samples/Graphics/GraphicsState) sample
+* [Set up clipping on a PDF canvas in C# and VB.NET](/Samples/Graphics/Clipping) sample
diff --git a/Samples/Graphics/Patterns/README.md b/Samples/Graphics/Patterns/README.md
@@ -1,8 +1,16 @@
-# Patterns
-This sample shows how to use colored and uncolored tiling patterns.
+# Stroke and fill PDF canvas with patterns in C# and VB.NET
+
+This sample shows how to use colored and uncolored tiling patterns on a PDF canvas. The code uses [Docotic.Pdf library](https://bitmiracle.com/pdf-library/) API.
+
+## Description
 
 A tiling pattern consists of a small graphical figure called a pattern cell. Painting with the pattern replicates the cell at fixed horizontal and vertical intervals to fill an area. A colored pattern specifies the colors used to paint the pattern cell. An uncolored pattern does not specify any color information. Instead, the entire pattern cell is painted with a separately specified color each time the pattern is used.
 
-PdfTilingPattern class is used for both kinds of tiling patterns. You can add a pattern to your document using PdfDocument.AddColoredPattern or PdfDocument.AddUncoloredPattern method.
+The [PdfTilingPattern](https://api.docotic.com/pdftilingpattern) class is used for both kinds of tiling patterns. You can add a pattern to your document using the [PdfDocument.AddColoredPattern](https://api.docotic.com/pdfdocument-addcoloredpattern) or the [PdfDocument.AddUncoloredPattern](https://api.docotic.com/pdfdocument-adduncoloredpattern) method.
+
+For any pattern added to a document, construct its appearance by drawing on the pattern canvas. When done constructing the pattern, use it to stroke lines and shapes and/or to fill areas on a canvas. Use the [Pattern property of a pen](https://api.docotic.com/pdfpen-pattern) to set up the pattern for stroking lines and shapes. Set the pattern object to the [Pattern property of a brush](https://api.docotic.com/pdfbrush-pattern) to use the pattern for filling areas.
 
-After a pattern is added to your document you should construct its appearance by drawing on a pattern canvas. When pattern is constructed, you can use it to stroke lines and shapes and/or to fill areas on a canvas. Use PdfCanvas.Pen.Pattern property to stroke lines and shapes or PdfCanvas.Brush.Pattern property to fill areas with a pattern.
+## See also
+* [Get free time-limited license key](https://bitmiracle.com/pdf-library/download)
+* [Setting canvas colors in C# and VB.NET](/Samples/Graphics/Colors) sample
+* [Using color profiles in C# and VB.NET](/Samples/Graphics/ColorProfiles) sample
diff --git a/Samples/Graphics/RemovePaths/README.md b/Samples/Graphics/RemovePaths/README.md
@@ -3,7 +3,7 @@ This sample shows how to remove vector paths drawn on a PDF page using [Docotic.
 
 ## Description
 
-Use the [PdfPage.RemovePaths](https://bitmiracle.com/pdf-library/api/pdfpage-removepaths) method to remove all or specific vector paths from a PDF page. You can filter paths by color, shape, drawing mode, or other parameters.
+Use the [PdfPage.RemovePaths](https://api.docotic.com/pdfpage-removepaths) method to remove all or specific vector paths from a PDF page. You can filter paths by color, shape, drawing mode, or other parameters.
 
 ## See also
 * [Get free time-limited license key](https://bitmiracle.com/pdf-library/download)
diff --git a/Samples/Graphics/Shapes/README.md b/Samples/Graphics/Shapes/README.md
@@ -1,2 +1,12 @@
-# Shapes
-This sample shows how to draw geometrical shapes, such as circles, ellipses, rectangles and rounded rectangles using PdfCanvas class.
+# Draw shapes on PDF canvas in C# and VB.NET
+
+This sample shows how to draw geometrical shapes, such as circles, ellipses, rectangles and rounded rectangles using [Docotic.Pdf library](https://bitmiracle.com/pdf-library/).
+
+## Description
+
+To draw shapes, use these methods of the PdfCanvas class: [DrawCircle](https://api.docotic.com/pdfcanvas-drawcircle), [DrawEllipse](https://api.docotic.com/pdfcanvas-drawellipse), [DrawPie](https://api.docotic.com/pdfcanvas-drawpie), [DrawRectangle](https://api.docotic.com/pdfcanvas-drawrectangle), and [DrawRoundedRectangle](https://api.docotic.com/pdfcanvas-drawroundedrectangle).
+
+## See also
+* [Get free time-limited license key](https://bitmiracle.com/pdf-library/download)
+* [Setting canvas colors in C# and VB.NET](/Samples/Graphics/Colors) sample
+* [Draw lines and curves in C# and VB.NET](/Samples/Graphics/LinesAndCurves) sample
diff --git a/Samples/Graphics/Transparency/README.md b/Samples/Graphics/Transparency/README.md
@@ -1,4 +1,12 @@
-# Transparency
-This sample shows how to draw on a canvas using semi-transparent colors.
+# Using semi-transparent colors in C# and VB.NET
 
-Use PdfCanvas.Pen.Opacity and/or PdfCanvas.Brush.Opacity properties to make current pen or brush color semi-transparent. Opacity value ranges from 0 (fully transparent) to 100 (fully opaque).
+This sample shows how to use [Docotic.Pdf library](https://bitmiracle.com/pdf-library/) to draw on a PDF canvas using semi-transparent colors.
+
+## Description
+
+You can use semi-transparent colors for both canvas [pen](https://api.docotic.com/pdfcanvas-pen) and [brush](https://api.docotic.com/pdfcanvas-brush). Use the [PdfPen.Opacity](https://api.docotic.com/pdfpen-opacity) and the [PdfBrush.Opacity](https://api.docotic.com/pdfbrush-opacity) property to make current pen or brush color semi-transparent. Opacity value ranges from 0 (fully transparent) to 100 (fully opaque).
+
+## See also
+* [Get free time-limited license key](https://bitmiracle.com/pdf-library/download)
+* [Setting canvas colors in C# and VB.NET](/Samples/Graphics/Colors) sample
+* [Using color profiles in C# and VB.NET](/Samples/Graphics/ColorProfiles) sample
