.\"
.\" OpenSlide, a library for reading whole slide image files
.\"
.\" Copyright (c) 2007-2012 Carnegie Mellon University
.\" Copyright (c) 2023      Benjamin Gilbert
.\" All rights reserved.
.\"
.\" OpenSlide is free software: you can redistribute it and/or modify
.\" it under the terms of the GNU Lesser General Public License as
.\" published by the Free Software Foundation, version 2.1.
.\"
.\" OpenSlide is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU Lesser General Public License for more details.
.\"
.\" You should have received a copy of the GNU Lesser General Public
.\" License along with OpenSlide. If not, see
.\" <http://www.gnu.org/licenses>.
.\"


.\" See man-pages(7) for formatting conventions.


.TH SLIDETOOL 1 2023-07-27 "OpenSlide 4.0.1" "User Commands"

.mso www.tmac

.SH "نام (NAME)"
slidetool \- بازیابی داده‌ها از تصاویر کامل اسلاید (WSI)

.SH "خلاصه دستور (SYNOPSIS)"
.BR "slidetool " [ \-\-help "] [" \-\-version ]
.br
.B slidetool assoc icc read
.IR "file name" " [" output-file ]
.br
.B slidetool assoc list
.IR file ...
.br
.B slidetool assoc read
.IR "file name" " [" output-file ]
.br
.B slidetool prop get
.IR "property file" ...
.br
.BR "slidetool prop list" " [" \-\-names ]
.IR file ...
.br
.B slidetool region icc read
.IR file " [" output-file ]
.br
.B slidetool region read
.IR "file x y level width height" " [" output-file ]
.br
.B slidetool slide open
.IR file ...
.br
.B slidetool slide quickhash1
.IR file ...
.br
.B slidetool slide vendor
.IR file ...

.SH "توضیحات (DESCRIPTION)"
دستور
.B slidetool
از OpenSlide برای بازیابی داده‌ها از تصاویر کامل اسلاید (whole slide images) استفاده می‌کند،
که به عنوان فایل‌های اسلاید مجازی نیز شناخته می‌شوند.

.SS slidetool assoc icc read
نوشتن نمایه رنگی ICC مربوط به تصویر وابسته در
.I output-file
در صورت تعیین، و در غیر این صورت در خروجی استاندارد.
اگر هیچ نمایه رنگی ICC در دسترس نباشد، با شکست مواجه می‌شود.

.SS slidetool assoc list
فهرست کردن تصاویر وابسته برای یک یا چند اسلاید.
تصاویر وابسته، تصاویر کوچک غیرهرمی هستند که شامل
اطلاعات تکمیلی درباره اسلاید، مانند برچسب آن می‌باشند.

.SS slidetool assoc read
نوشتن تصویر وابسته با نام مشخص‌شده در
.I name
در قالب یک تصویر PNG.
اگر
.I output-file
مشخص نشود، تصویر در خروجی استاندارد نوشته خواهد شد.

.SS slidetool prop get
چاپ مقدار یک مشخصه OpenSlide برای یک یا چند اسلاید.
مشخصه‌ها تکه‌های مجزای متاداده متنی درباره اسلاید هستند.
مشخصه‌هایی با پیشوند
.I openslide.
توسط OpenSlide تعریف می‌شوند؛
سایر موارد توسط قالب اختصاصی اسلاید تعریف می‌گردند.

.SS slidetool prop list
چاپ تمامی مشخصه‌های OpenSlide برای یک یا چند اسلاید.

.SS slidetool region icc read
نوشتن نمایه رنگی ICC اسلاید در
.I output-file
در صورت تعیین، و در غیر این صورت در خروجی استاندارد.
اگر هیچ نمایه رنگی ICC در دسترس نباشد، با شکست مواجه می‌شود.

.SS slidetool region read
نوشتن ناحیه‌ای از سطح
.I level
تعیین‌شده از اسلاید در قالب تصویر PNG.
.I x
و
.I y
مختصات پیکسلی در سطح 0 (بالاترین سطح وضوح اسلاید) هستند.
.I width
و
.I height
ابعاد پیکسلی در
.IR level
تعیین‌شده می‌باشند.
اگر
.I output-file
مشخص نشود، تصویر در خروجی استاندارد نوشته خواهد شد.

ابعاد هر سطح از اسلاید را می‌توان با
.BR "slidetool prop list"
به دست آورد.

.SS slidetool slide open
بررسی اینکه آیا OpenSlide می‌تواند یک یا چند فایل اسلاید را باز کند یا خیر.

.SS slidetool slide quickhash1
چاپ مقادیر مجموع مقابله‌ای
.I quickhash-1
در OpenSlide برای یک یا چند اسلاید، در قالبی مشابه
.BR sha256sum (1).
.PP
.I quickhash-1
یک هش غیررمزنگاری ۲۵۶ بیتی از زیرمجموعه‌ای از داده‌های اسلاید است.
این هش به طور یکتا یک اسلاید خاص را مشخص می‌کند،
اما نمی‌توان از آن برای تشخیص خرابی یا دستکاری در فایل اسلاید استفاده کرد.
.PP
.I quickhash-1
برای تمامی فایل‌های اسلاید پشتیبانی‌شده توسط OpenSlide تعریف نشده است.
اگر اسلایدی فاقد
.IR quickhash-1
باشد، عبارت "No quickhash\-1 available" چاپ خواهد شد.

.SS slidetool slide vendor
گزارش نام تولیدکننده (vendor) شناسایی‌شده توسط OpenSlide برای یک یا چند فایل اسلاید.

.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-\-help
نمایش خلاصه راهنمای استفاده.

.TP
.B \-\-names
برای
.BR "slidetool prop list" ,
صرف‌نظر کردن از مقادیر مشخصه‌ها.

.TP
.B \-\-version
نمایش اطلاعات نسخه و حق نشر.

.SH "وضعیت خروج (EXIT STATUS)"
دستور
.B slidetool
در صورت موفقیت مقدار 0، در صورت عدم امکان خواندن فایل اسلاید مقدار 1،
یا در صورت نامعتبر بودن آرگومان‌ها مقدار 2 را برمی‌گرداند.

.SH "حق نشر (COPYRIGHT)"
Copyright \(co 2007-2026 Carnegie Mellon University and others
.PP
پروژه OpenSlide نرم‌افزار آزاد است: می‌توانید آن را تحت شرایط
.URL http://gnu.org/licenses/lgpl-2.1.html "GNU Lesser General Public License، نسخه 2.1"
بازتوزیع کرده یا تغییر دهید.
.PP
نرم‌افزار OpenSlide بدون هیچ‌گونه ضمانتی، تا حد مجاز طبق قانون، ارائه می‌شود.
برای جزئیات بیشتر به GNU Lesser General Public License مراجعه کنید.

.SH "همچنین ببینید (SEE ALSO)"
.BR openslide\-quickhash1sum (1),
.BR openslide\-show\-properties (1),
.BR openslide\-write\-png (1),
.BR sha256sum (1)