PDF-link

#ifndef MUPDF_FITZ_LINK_H
#define MUPDF_FITZ_LINK_H

#include “mupdf/fitz/system.h”
#include “mupdf/fitz/context.h”
#include “mupdf/fitz/geometry.h”

/**
fz_link is a list of interactive links on a page.

There is no relation between the order of the links in the
list and the order they appear on the page. The list of links
for a given page can be obtained from fz_load_links.

A link is reference counted. Dropping a reference to a link is
done by calling fz_drop_link.

rect: The hot zone. The area that can be clicked in
untransformed coordinates.

uri: Link destinations come in two forms: internal and external.
Internal links refer to other pages in the same document.
External links are URLs to other documents.

next: A pointer to the next link on the same page.

fz_link 是页面上的交互式链接列表。

链接的顺序之间没有关系
列表以及它们出现在页面上的顺序。 链接列表
可以从 fz_load_links 获得给定页面。

链接是引用计数的。 删除对链接的引用是
通过调用 fz_drop_link 完成。

rect：热区。 可以点击的区域
未变换的坐标。

uri：链接目的地有两种形式：内部和外部。
内部链接是指同一文档中的其他页面。
外部链接是指向其他文档的 URL。

next：指向同一页面下一个链接的指针。

*/
typedef struct fz_link
{
int refs;
struct fz_link *next;
fz_rect rect;
char *uri;
} fz_link;

/**
Create a new link record.

next is set to NULL with the expectation that the caller will
handle the linked list setup.

Internal function.
创建一个新的链接记录。

next 设置为 NULL，期望调用者将
处理链表设置。

内部功能。

*/
fz_link *fz_new_link(fz_context *ctx, fz_rect bbox, const char *uri);

/**
Increment the reference count for a link. The same pointer is
returned.

Never throws exceptions.
增加链接的引用计数。 返回相同的指针。

从不抛出异常。

*/
fz_link *fz_keep_link(fz_context *ctx, fz_link *link);

/**
Decrement the reference count for a link. When the reference
count reaches zero, the link is destroyed.

When a link is freed, the reference for any linked link (next)
is dropped too, thus an entire linked list of fz_link's can be
freed by just dropping the head.

减少链接的引用计数。 当参考
计数达到零，链接被破坏。

释放链接时，任何链接链接的引用（下一个）
也被删除，因此 fz_link 的整个链表可以是
只需放下头就可以解脱。

*/
void fz_drop_link(fz_context *ctx, fz_link *link);

/**
Query whether a link is external to a document (determined by
uri containing a ‘:’, intended to match with ‘😕/’ which
separates the scheme from the scheme specific parts in URIs).
查询链接是否在文档外部（由
uri 包含一个 ‘:’，旨在与 ‘😕/’ 匹配
将方案与 URI 中的方案特定部分分开）。
*/
int fz_is_external_link(fz_context *ctx, const char *uri);