نام (NAME)

gdal-raster-nodata-to-alpha - جایگزینی مقدار(های) nodata با یک باند آلفا

افزوده‌شده در نگارش 3.12.

خلاصه دستور (SYNOPSIS)

کاربرد: gdal raster nodata-to-alpha [OPTIONS] <INPUT> <OUTPUT>
جایگزینی مقدار(های) nodata با یک باند آلفا.
آرگومان‌های موضعی:
  -i, --input <INPUT>                                  مجموعه‌داده‌های رستر ورودی [الزامی] [در خط‌لوله‌ها موجود نیست]
  -o, --output <OUTPUT>                                مجموعه‌داده رستر خروجی [الزامی] [در خط‌لوله‌ها موجود نیست]
گزینه‌های عمومی:
  -h, --help                                           نمایش پیام راهنما و خروج
  --json-usage                                         نمایش نحوه استفاده در قالب سند JSON و خروج
  --config <KEY>=<VALUE>                               گزینه پیکربندی [می‌تواند تکرار شود]
  -q, --quiet                                          حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در خط‌لوله‌ها موجود نیست]
گزینه‌ها:
  -f, --of, --format, --output-format <OUTPUT-FORMAT>  قالب خروجی (مقدار "GDALG" مجاز است) [در خط‌لوله‌ها موجود نیست]
  --co, --creation-option <KEY>=<VALUE>                گزینه ساخت [می‌تواند تکرار شود] [در خط‌لوله‌ها موجود نیست]
  --overwrite                                          تعیین مجاز بودن بازنویسی مجموعه‌داده خروجی موجود [در خط‌لوله‌ها موجود نیست]
                                                       مانعة‌الجمع با --append
  --append                                             الحاق به‌عنوان یک زیرمجموعه‌داده به خروجی موجود [در خط‌لوله‌ها موجود نیست]
                                                       مانعة‌الجمع با --overwrite
  --nodata <NODATA>                                    بازنویسی مقدار nodata در باند(های) ورودی (مقدار عددی، 'nan'، 'inf'، '-inf') [می‌تواند تکرار شود]
گزینه‌های پیشرفته:
  --if, --input-format <INPUT-FORMAT>                  قالب‌های ورودی [می‌تواند تکرار شود] [در خط‌لوله‌ها موجود نیست]
  --oo, --open-option <KEY>=<VALUE>                    گزینه‌های باز کردن [می‌تواند تکرار شود] [در خط‌لوله‌ها موجود نیست]

توضیحات (DESCRIPTION)

دستور gdal raster nodata-to-alpha بر اساس فراداده مقدار nodata تنظیم‌شده روی باندهای مجموعه‌داده ورودی، یک باند آلفا اضافه می‌کند.

اگر مقدار صریح nodata در مجموعه‌داده ورودی وجود نداشته باشد، می‌توان آن را با گزینه --nodata اضافه کرد.

اگر مجموعه‌داده ورودی فاقد مقدار nodata باشد و گزینه --nodata نیز مشخص نشده باشد، این برنامه هیچ عملیاتی انجام نمی‌دهد (no-op) و استفاده از آن کاملاً بی‌خطر است.

خروجی GDALG (مجموعه‌داده در لحظه / جریانی) (GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET))

این برنامه از سریال‌سازی خط فرمان به‌صورت یک فایل JSON با استفاده از قالب خروجی GDALG پشتیبانی می‌کند. سپس می‌توان فایل حاصل را به‌عنوان یک مجموعه‌داده رستر با استفاده از درایور GDALG: GDAL Streamed Algorithm باز کرد و خط‌لوله مشخص‌شده را به‌صورت در لحظه (on-the-fly) / جریانی اعمال نمود.

گزینه‌های ویژه برنامه (PROGRAM-SPECIFIC OPTIONS)

--nodata <NODATA>: بازنویسی مقدار nodata باند(های) ورودی (مقدار عددی، 'nan'، 'inf'، '-inf'). می‌توان یک مقدار، یا به تعداد باندهای ورودی مقدار مشخص کرد. هنگامی که چند مقدار مشخص شود، یک پیکسل تنها در صورتی نامعتبر در نظر گرفته می‌شود که در تمام باندها با مقادیر nodata مطابقت داشته باشد.

گزینه‌های استاندارد (STANDARD OPTIONS)

--co, --creation-option <NAME>=<VALUE>

بسیاری از قالب‌ها یک یا چند گزینه ساخت اختیاری دارند که می‌توان از آن‌ها برای کنترل جزئیات فایل ایجادشده استفاده کرد. به‌عنوان مثال، درایور GeoTIFF از گزینه‌های ساخت برای کنترل فشرده‌سازی و این‌که آیا فایل باید کاشی‌بندی (tiled) شود یا خیر، پشتیبانی می‌کند.

می‌تواند تکرار شود.

گزینه‌های ساخت موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده اصلاً هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با استفاده از گزینه خط فرمان --formats مشاهده کرد، اما مستندات مربوط به همان قالب، منبع اصلی اطلاعات درباره گزینه‌های ساخت درایور است. برای گزینه‌های ساخت مجاز هر قالب، به مستندات اختصاصی در Raster drivers مراجعه کنید.

-f, --of, --format, --output-format <OUTPUT-FORMAT>: تعیین قالب رستر خروجی مورد استفاده. مقادیر مجاز را می‌توان با دستور زیر به دست آورد: gdal --formats | grep raster | grep rw | sort

--ot, --datatype, --output-data-type <OUTPUT-DATA-TYPE>: نوع داده خروجی از میان Byte، Int8، UInt16، Int16، UInt32، Int32، UInt64، Int64، CInt16، CInt32، Float32، Float64، CFloat32، CFloat64.

وضعیت خروج (EXIT STATUS)

این برنامه در صورت موفقیت کد وضعیت ۰ و در صورت بروز خطا کدی غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به‌صورت هشدار صادر می‌شوند، به‌عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند).

مثال‌ها (EXAMPLES)

مثال ۱

$ gdal raster nodata-to-alpha input_with_nodata.tif output_with_alpha_band.tif

نویسندگان (AUTHORS)

Even Rouault <even.rouault@spatialys.com>

کپی‌رایت و تکثیر (COPYRIGHT)

1998-2026