diff --git a/App/Common/FilePath.cs b/App/Common/FilePath.cs
index a024a15..961755b 100644
--- a/App/Common/FilePath.cs
+++ b/App/Common/FilePath.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.IO;
diff --git a/App/Model/ColorSpaces/CIELab.cs b/App/Model/ColorSpaces/CIELab.cs
index f669b89..61a101e 100644
--- a/App/Model/ColorSpaces/CIELab.cs
+++ b/App/Model/ColorSpaces/CIELab.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
using System.ComponentModel;
namespace Devcorp.Controls.Design
diff --git a/App/Model/ColorSpaces/CIEXYZ.cs b/App/Model/ColorSpaces/CIEXYZ.cs
index 1560f3d..f343a66 100644
--- a/App/Model/ColorSpaces/CIEXYZ.cs
+++ b/App/Model/ColorSpaces/CIEXYZ.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
using System.ComponentModel;
namespace Devcorp.Controls.Design
diff --git a/App/Model/ColorSpaces/CMYK.cs b/App/Model/ColorSpaces/CMYK.cs
index 14142ec..272b55e 100644
--- a/App/Model/ColorSpaces/CMYK.cs
+++ b/App/Model/ColorSpaces/CMYK.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
namespace Devcorp.Controls.Design
{
diff --git a/App/Model/ColorSpaces/ColorSpaceHelper.cs b/App/Model/ColorSpaces/ColorSpaceHelper.cs
index ce3f104..d239d2e 100644
--- a/App/Model/ColorSpaces/ColorSpaceHelper.cs
+++ b/App/Model/ColorSpaces/ColorSpaceHelper.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
using System.Drawing;
using System.Drawing.Imaging;
using System.Text;
@@ -774,26 +774,26 @@ namespace Devcorp.Controls.Design
#region CMYK convert
///
- /// ɫΪ 01תΪ RGB ɫ
+ /// 将四色分量（必须为 0～1）转换为 RGB 颜色。
///
- ///
- ///
- ///
- ///
- /// ɫ
+ /// 青
+ /// 紫
+ /// 黄
+ /// 黑
+ /// 颜色。
public static Color CMYKtoColor (float c, float m, float y, float k)
{
return CMYKtoColor((double)c, (double)m, (double)y, (double)k);
}
///
- /// ɫΪ 01תΪ RGB ɫ
+ /// 将四色分量（必须为 0～1）转换为 RGB 颜色。
///
- ///
- ///
- ///
- ///
- /// ɫ
+ /// 青
+ /// 紫
+ /// 黄
+ /// 黑
+ /// 颜色。
public static Color CMYKtoColor (double c, double m, double y, double k)
{
return CMYKtoColor(new CMYK(c,m,y,k));
diff --git a/App/Model/ColorSpaces/HSB.cs b/App/Model/ColorSpaces/HSB.cs
index 19a75a5..71971d1 100644
--- a/App/Model/ColorSpaces/HSB.cs
+++ b/App/Model/ColorSpaces/HSB.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
using System.ComponentModel;
namespace Devcorp.Controls.Design
diff --git a/App/Model/ColorSpaces/HSL.cs b/App/Model/ColorSpaces/HSL.cs
index 5aa670c..e46f936 100644
--- a/App/Model/ColorSpaces/HSL.cs
+++ b/App/Model/ColorSpaces/HSL.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
using System.ComponentModel;
namespace Devcorp.Controls.Design
diff --git a/App/Model/ColorSpaces/RGB.cs b/App/Model/ColorSpaces/RGB.cs
index 52bd246..eb0789d 100644
--- a/App/Model/ColorSpaces/RGB.cs
+++ b/App/Model/ColorSpaces/RGB.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
using System.ComponentModel;
namespace Devcorp.Controls.Design
diff --git a/App/Model/ColorSpaces/YUV.cs b/App/Model/ColorSpaces/YUV.cs
index 7af8aae..94eb116 100644
--- a/App/Model/ColorSpaces/YUV.cs
+++ b/App/Model/ColorSpaces/YUV.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
namespace Devcorp.Controls.Design
{
diff --git a/App/Processor/Imaging/WuQuantize.c b/App/Processor/Imaging/WuQuantize.c
index ff38fa2..af7e61d 100644
--- a/App/Processor/Imaging/WuQuantize.c
+++ b/App/Processor/Imaging/WuQuantize.c
@@ -1,4 +1,4 @@
-Having received many constructive comments and bug reports about my previous
+Having received many constructive comments and bug reports about my previous
C implementation of my color quantizer (Graphics Gems vol. II, p. 126-133),
I am posting the following second version of my program (hopefully 100%
healthy) as a reply to all those who are interested in the problem.
diff --git a/App/Processor/Mupdf/MuPage.cs b/App/Processor/Mupdf/MuPage.cs
index 285baa5..0e45104 100644
--- a/App/Processor/Mupdf/MuPage.cs
+++ b/App/Processor/Mupdf/MuPage.cs
@@ -1,32 +1,32 @@
-using System;
+using System;
using System.Drawing;
namespace MuPdfSharp
{
public sealed class MuPage : IDisposable
{
- #region йԴԱ
+ #region 非托管资源成员
private ContextHandle _context;
private DocumentHandle _document;
private PageHandle _page;
private DisplayListHandle _displayList;
#endregion
- #region йԴԱ
+ #region 托管资源成员
static readonly ImageRendererOptions __defaultOptions = new ImageRendererOptions ();
MuCookie _cookie;
MuTextPage _TextPage;
bool _flattened;
- /// ȡǰҳҳ롣
+ /// 获取当前页面的页码。
public int PageNumber { get; private set; }
- /// ȡǰҳijߴ磨½Ϊ0,0ȡҳֵеԭʼʹ ԡ
+ /// 获取当前页面的尺寸（左下角坐标置为“0,0”）。如需获取页面字典中的原始可视区域，请使用 属性。
public Rectangle Bound {
get {
return NativeMethods.BoundPage (_context, _page);
}
}
- /// ȡǰҳ꼰ߴ硣
+ /// 获取当前页面可视区域的坐标及尺寸。
public Rectangle VisualBound => Matrix.Identity.RotateTo(Rotation).Transform(VisualBox);
public Rectangle ArtBox => LookupPageBox("ArtBox");
@@ -70,46 +70,46 @@ namespace MuPdfSharp
}
catch (AccessViolationException) {
_page.DisposeHandle ();
- throw new MuPdfException ("ص " + pageNumber + " ҳ");
+ throw new MuPdfException ("无法加载第 " + pageNumber + " 页。");
}
}
/////
- ///// ȡָı
+ ///// 获取指定区域的文本。
/////
- /////
- ///// ڵı
+ ///// 区域。
+ ///// 区域内的文本。
//public string GetSelection (Rectangle selection) {
// return Interop.DecodeUtf8String (NativeMethods.CopySelection (_context, GetTextPage (), selection));
//}
/////
- ///// ȡָı
+ ///// 获取指定区域的文本。
/////
- /////
- ///// ڵı
+ ///// 区域。
+ ///// 区域内的文本。
//public List HighlightSelection (Rectangle selection) {
// var l =
// return Interop.DecodeUtf8String (NativeMethods.HighlightSelection (_context, _page, selection));
//}
///
- /// ʹĬϵȾҳ档
+ /// 使用默认的配置渲染页面。
///
- /// ҳĿȡ
- /// ҳĸ߶ȡ
- /// Ⱦɵ
+ /// 页面的宽度。
+ /// 页面的高度。
+ /// 渲染后生成的 。
public FreeImageAPI.FreeImageBitmap RenderPage (int width, int height) {
return RenderPage (width, height, __defaultOptions);
}
///
- /// ʹָȾҳ档
+ /// 使用指定的配置渲染页面。
///
- /// ҳĿȡ
- /// ҳĸ߶ȡ
- /// Ⱦѡ
- /// Ⱦɵ
+ /// 页面的宽度。
+ /// 页面的高度。
+ /// 渲染选项。
+ /// 渲染后生成的 。
public FreeImageAPI.FreeImageBitmap RenderPage (int width, int height, ImageRendererOptions options) {
using (var pix = InternalRenderPage (width, height, options)) {
if (pix != null) {
@@ -120,12 +120,12 @@ namespace MuPdfSharp
}
///
- /// ʹָȾҳ档
+ /// 使用指定的配置渲染页面。
///
- /// ҳĿȡ
- /// ҳĸ߶ȡ
- /// Ⱦѡ
- /// Ⱦɵ
+ /// 页面的宽度。
+ /// 页面的高度。
+ /// 渲染选项。
+ /// 渲染后生成的 。
public Bitmap RenderBitmapPage (int width, int height, ImageRendererOptions options) {
using (var pix = InternalRenderPage (width, height, options)) {
if (pix != null) {
@@ -156,7 +156,7 @@ namespace MuPdfSharp
//}
}
if (_cookie.ErrorCount > 0) {
- System.Diagnostics.Debug.WriteLine("ڵ " + PageNumber + " ҳ " + _cookie.ErrorCount + " ");
+ System.Diagnostics.Debug.WriteLine("在第 " + PageNumber + " 页有 " + _cookie.ErrorCount + " 个错误。");
}
return _displayList;
}
@@ -225,7 +225,7 @@ namespace MuPdfSharp
}
catch (AccessViolationException) {
pix.DisposeHandle ();
- throw new MuPdfException ("Ⱦҳ棺" + PageNumber);
+ throw new MuPdfException ("无法渲染页面：" + PageNumber);
}
}
@@ -276,9 +276,9 @@ namespace MuPdfSharp
}
///
- /// ȡҳݵʵʸǷΧ
+ /// 获取页面内容的实际覆盖范围。
///
- /// ҳݵС
+ /// 包含页面内容的最小 。
public Rectangle GetContentBoundary () {
var b = Bound;
var o = b;
@@ -292,25 +292,25 @@ namespace MuPdfSharp
return o;
}
catch (AccessViolationException) {
- throw new MuPdfException ("ȡҳݱ߿" + PageNumber);
+ throw new MuPdfException ("无法获取页面内容边框：" + PageNumber);
}
}
}
- #region ʵ IDisposable ӿڵԺͷ
+ #region 实现 IDisposable 接口的属性和方法
private bool disposed;
public void Dispose () {
Dispose (true);
- GC.SuppressFinalize (this); //
+ GC.SuppressFinalize (this); // 抑制析构函数
}
- /// ͷ MuPdfPage ռõԴ
- /// ǷֶͷйԴ
+ /// 释放由 MuPdfPage 占用的资源。
+ /// 是否手动释放托管资源。
[System.Diagnostics.CodeAnalysis.SuppressMessage ("Microsoft.Usage", "CA2213:DisposableFieldsShouldBeDisposed", MessageId = "_page")]
void Dispose (bool disposing) {
if (!disposed) {
if (disposing) {
- #region ͷйԴ
+ #region 释放托管资源
if (_TextPage != null) {
_TextPage.Dispose();
}
@@ -318,8 +318,8 @@ namespace MuPdfSharp
#endregion
}
- #region ͷŷйԴ
- // עﲻ̰߳ȫ
+ #region 释放非托管资源
+ // 注意这里不是线程安全的
//int retry = 0;
//_cookie.CancelAsync ();
//while (_cookie.IsRunning && ++retry < 10) {
@@ -333,8 +333,8 @@ namespace MuPdfSharp
disposed = true;
}
- // ֻδ Dispose ʱ
- // вṩ
+ // 析构函数只在未调用 Dispose 方法时调用
+ // 派生类中不必再提供析构函数
~MuPage () {
Dispose (false);
}
diff --git a/App/Processor/Mupdf/PageLabelCollection.cs b/App/Processor/Mupdf/PageLabelCollection.cs
index ea4d7f8..abf04cc 100644
--- a/App/Processor/Mupdf/PageLabelCollection.cs
+++ b/App/Processor/Mupdf/PageLabelCollection.cs
@@ -1,4 +1,4 @@
-using System;
+using System;
using System.Collections.Generic;
using System.Diagnostics;
@@ -32,9 +32,9 @@ namespace MuPdfSharp
}
///
- /// ҳǩ缯дͬҳҳǩȽɵıǩɾµҳǩ
+ /// 添加页码标签。如集合中存在相同页码的页码标签，则先将旧的标签删除，再添加新的页码标签。
///
- /// Ҫӵҳǩ
+ /// 需要添加的页码标签。
public void Add (PageLabel label) {
Remove (label);
_labels.Add (label);
@@ -42,10 +42,10 @@ namespace MuPdfSharp
}
///
- /// ݴҳ룬صǰҳǩϸʽɵҳ롣
+ /// 根据传入的页码，返回当前页码标签集合格式化后生成的页码。
///
- /// ҳ롣
- /// ʽҳı
+ /// 绝对页码。
+ /// 格式化后的页码文本。
public string Format (int pageNumber) {
var l = _labels.Count;
if (l == 0) {
@@ -75,10 +75,10 @@ namespace MuPdfSharp
}
///
- /// ؼǷ ͬʼҳҳǩ
+ /// 返回集合中是否包含具有与 相同起始页码的页码标签。
///
- /// Ҫʼҳҳǩ
- /// ͬҳҳǩ true false
+ /// 需要检查起始页码的页码标签。
+ /// 如包含相同页码的页码标签，返回 true，否则返回 false。
public bool Contains (PageLabel item) {
for (int i = _labels.Count - 1; i >= 0; i--) {
if (_labels[i].FromPageNumber == item.FromPageNumber) {
@@ -101,10 +101,10 @@ namespace MuPdfSharp
}
///
- /// ɾо ͬʼҳҳǩ
+ /// 删除集合中具有与 相同起始页码的页码标签。
///
- /// Ҫɾҳǩ
- /// ͬҳҳǩ true false
+ /// 需要删除的页码标签。
+ /// 如包含相同页码的页码标签，返回 true，否则返回 false。
public bool Remove (PageLabel item) {
for (int i = _labels.Count - 1; i >= 0; i--) {
if (_labels[i].FromPageNumber == item.FromPageNumber) {
diff --git a/授权协议.txt b/授权协议.txt
index 418aa30..d5a8013 100644
--- a/授权协议.txt
+++ b/授权协议.txt
@@ -1,4 +1,4 @@
-《PDF 补丁丁（PDFPatcher）》软件最终用户授权协议
+《PDF 补丁丁（PDFPatcher）》软件最终用户授权协议
--------------------------------------------------------------------------------
diff --git a/更新历史.txt b/更新历史.txt
index adcdd7e..63100d9 100644
--- a/更新历史.txt
+++ b/更新历史.txt
@@ -1,4 +1,4 @@
-1.0.0.0 2021年12月23日
+1.0.0.0 2021年12月23日
新增功能：
第一个开放源代码版本。
修改了授权协议。