.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "NEARBLACK" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
nearblack \- تبدیل حاشیه‌های تقریباً سیاه یا سفید به سیاه یا سفید خالص
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Usage: nearblack [\-\-help] [\-\-long\-usage] [\-\-help\-general]
                 [\-of <output_format>] [\-\-quiet] [\-co <NAME>=<VALUE>]...
                 [\-o <output_file>]
                 [[\-white]|[\-color <c1,c2,c3...cn>]...]
                 [\-nb <non_black_pixels>] [\-near <dist>] [\-setalpha] [\-setmask]
                 [\-alg floodfill|twopasses]
                 <input_file>
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
این ابزار یک تصویر را پیمایش کرده و تلاش می‌کند تمام پیکسل‌هایی را که تقریباً یا دقیقاً سیاه، سفید یا یک یا چند رنگ سفارشی در اطراف حاشیه (طوقه) تصویر هستند، به سیاه یا سفید تبدیل کند. این کار معمولاً برای «اصلاح» عکس‌های هوایی فشرده‌شده با اتلاف استفاده می‌شود تا بتوان پیکسل‌های رنگی حاشیه را هنگام موزاییک‌سازی شفاف در نظر گرفت. اگر هیچ‌یک از باندهای آلفا یا ماسک تعیین نشده باشند، فرمت خروجی باید از فشرده‌سازی بدون اتلاف استفاده کند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
معادل در رابط خط فرمان جدید \(dqgdal\(dq:
.sp
دستور \fI\%gdal raster clean\-collar\fP را ببینید.
.UNINDENT
.UNINDENT
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \-\-help
نمایش این پیام راهنما و خروج.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-general
نمایش پیام خلاصه نحوه استفاده برای گزینه‌های عمومی خط فرمان GDAL و خروج.
.UNINDENT
.INDENT 0.0
.TP
.B \-q, \-\-quiet
عدم نمایش پیام‌های پیشرفت و سایر خروجی‌های غیرخطا.
.UNINDENT
.INDENT 0.0
.TP
.B \-o <outfile>
نام فایل خروجی که باید ایجاد شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-of <format>
انتخاب فرمت خروجی.
در صورت عدم تعیین، فرمت از روی پسوند حدس زده می‌شود.
از نام کوتاه فرمت استفاده کنید (برای مثال GTiff برای GeoTIFF).
.UNINDENT
.INDENT 0.0
.TP
.B \-co <NAME>=<VALUE>
ارسال یک گزینه ساخت (creation option) به درایور فرمت خروجی. چندین گزینه
\fI\%\-co\fP را می‌توان مشخص کرد. برای گزینه‌های مجاز ساخت در هر فرمت، مستندات اختصاصی فرمت در \fI\%Raster drivers\fP را ببینید.
.sp
تنها هنگام ایجاد یک فایل جدید معتبر است.
.UNINDENT
.INDENT 0.0
.TP
.B \-white
جستجو برای پیکسل‌های تقریباً سفید (255) به جای پیکسل‌های تقریباً سیاه.
.UNINDENT
.INDENT 0.0
.TP
.B \-color <c1>,<c2>,<c3>...<cn>
جستجو برای پیکسل‌های نزدیک به رنگ مشخص‌شده. می‌تواند چندین بار تعیین شود.
هنگامی که \-color مشخص شود، پیکسل‌هایی که به عنوان حاشیه در نظر گرفته شوند روی 0 تنظیم می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-near <dist>
مشخص می‌کند که مقادیر پیکسل چقدر می‌توانند از سیاه، سفید یا رنگ‌های سفارشی فاصله داشته باشند و همچنان نزدیک به سیاه، سفید یا رنگ سفارشی در نظر گرفته شوند. مقدار پیش‌فرض 15 است.
.UNINDENT
.INDENT 0.0
.TP
.B \-nb <non_black_pixels>
تعداد پیکسل‌های متوالی غیرسیاه که می‌توان قبل از صرف‌نظر کردن از جستجو به سمت داخل با آن‌ها مواجه شد. مقدار پیش‌فرض 2 است.
.UNINDENT
.INDENT 0.0
.TP
.B \-setalpha
اگر فایل خروجی مشخص شده باشد و فایل ورودی ۳ باند داشته باشد، یک باند آلفا اضافه می‌کند؛
یا اگر فایل خروجی مشخص شده باشد و فایل ورودی ۴ باند داشته باشد، باند آلفای فایل خروجی را تنظیم می‌کند؛
یا اگر فایل ورودی ۴ باند داشته باشد و فایل خروجی مشخص نشده باشد، باند آلفای فایل ورودی را تنظیم می‌کند.
باند آلفا در حاشیه تصویر روی 0 و در سایر نقاط روی 255 تنظیم می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-setmask
یک باند ماسک به فایل خروجی اضافه می‌کند؛
یا اگر فایل ورودی هنوز باند ماسک نداشته باشد و فایل خروجی مشخص نشده باشد، یک باند ماسک به فایل ورودی اضافه می‌کند.
باند ماسک در حاشیه تصویر روی 0 و در سایر نقاط روی 255 تنظیم می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-alg twopasses|floodfill
افزوده شده در نسخه 3.8.
.sp
انتخاب الگوریتم مورد استفاده.
.sp
گزینه \fBtwopasses\fP از یک گذر بالا به پایین و سپس یک گذر پایین به بالا استفاده می‌کند.
این تنها الگوریتمی است که قبل از نسخه GDAL 3.8 پیاده‌سازی شده بود. ممکن است در نواحی مقعر بخش‌هایی را نادیده بگیرد.
الگوریتم، تصویر را در هر مرحله یک خط پویش پردازش می‌کند. یک پویش به سمت «داخل» از هر طرف انجام می‌شود و پیکسل‌ها را تا زمانی که حداقل با تعداد \(dqnon_black_pixels\(dq پیکسل با فاصله خاکستری بیش از \(dqdist\(dq از سیاه، سفید یا رنگ‌های سفارشی مواجه شود روی سیاه یا سفید تنظیم می‌کند و در آن نقطه پویش متوقف می‌شود. پیکسل‌های تقریباً سیاه، سفید یا رنگ‌های سفارشی روی سیاه یا سفید تنظیم می‌شوند. الگوریتم همچنین از بالا به پایین و از پایین به بالا پویش می‌کند تا فرورفتگی‌ها را در بالا یا پایین شناسایی کند.
.sp
گزینه \fBfloodfill\fP (افزوده شده در GDAL 3.8) از الگوریتم \X'tty: link https://en.wikipedia.org/wiki/Flood_fill#Span_filling'\fI\%Flood Fill\fP\X'tty: link'
استفاده می‌کند و با نواحی مقعر به خوبی کار خواهد کرد. این روش نیاز به ایجاد یک مجموعه داده موقت دارد و نسبت به \fBtwopasses\fP کندتر است. هنگامی که یک مقدار غیرصفر برای \fI\%\-nb\fP استفاده شود، \fBtwopasses\fP در واقع به عنوان مرحله اولیه \fBfloodfill\fP فراخوانی می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B <infile>
فایل ورودی. هر فرمت پشتیبانی‌شده توسط GDAL، با هر تعداد باند، معمولاً باندهای بایتی 8 بیتی.
.UNINDENT
.sp
تمام پردازش‌ها به صورت ۸ بیتی (بایتی) انجام می‌شود.
.sp
اگر فایل خروجی تعیین نشود، نتایج پردازش‌شده در فایل ورودی بازنویسی خواهند شد؛ بنابراین فایل ورودی باید از قابلیت به‌روزرسانی (update) پشتیبانی کند.
.SH "کد وضعیت بازگشتی (RETURN STATUS CODE)"
.sp
برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیر صفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار اعلام می‌شوند، اجرای موفقیت‌آمیز در نظر گرفته می‌شوند).
.SH "رابط برنامه‌نویسی سی (C API)"
.sp
این ابزار همچنین از طریق زبان C با تابع \fI\%GDALNearblack()\fP قابل فراخوانی است.
.SH "نویسندگان (AUTHORS)"
Frank Warmerdam <warmerdam@pobox.com>
.SH "حق نشر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.