Pamcut User Manual(1)

الاسم
pamcut - اختيار منطقة مستطيلة من صورة PAM أو PBM أو PGM أو PPM

موجز

pamcut

[-left رقم_العمود]

[-right رقم_العمود]

[-top رقم_الصف]

[-bottom رقم_الصف]

[-width الأعمدة]

[-height الصفوف]

[-pad]

[-cropleft عدد_الأعمدة]

[-cropright عدد_الأعمدة]

[-croptop عدد_الصفوف]

[-cropbottom عدد_الصفوف]

[-reportonly]

[-verbose]

[اليسار الأعلى العرض الارتفاع]

[pnmfile]

تُقبل أدنى الاختصارات الفريدة للخيارات. يمكنك استخدام شرطتين بدلاً من شرطة واحدة للإشارة إلى الخيارات. يمكنك استخدام مسافة بيضاء بدلاً من علامة التساوي لفصل اسم الخيار عن قيمته.

الوصف

هذا البرنامج جزء من Netpbm(1) .

يقرأ pamcut صورة PAM أو PBM أو PGM أو PPM كدخل ويستخرج المستطيل المحدد، وينتج نفس نوع الصورة كخرج.

يمكنك تحديد المستطيل المراد قصه والاحتفاظ به أو تحديد الحواف المراد قصها وتجاهلها، أو مزيج من ذلك.

لطلب قص الحواف، استخدم الخيارات -cropleft و-cropright و-croptop و-cropbottom للإشارة إلى عدد الصفوف أو الأعمدة المراد تجاهلها.

على سبيل المثال، -cropleft=50 -cropright=200 يعني تجاهل أقصى 50 عمودًا يسارًا و200 عمودًا يمينًا.

لتحديد المستطيل المراد الاحتفاظ به، استخدم الخيارات -left و-right و-top و-bottom و-width و-height و-pad.

على سبيل المثال، -left=50 -right=200 يعني الاحتفاظ بـ 151 عمودًا بين العمودين 50 و200 شاملين.

يمكنك كتابة أي مزيج من الخيارات. ما لم يُحدد يُؤخذ بقيمه المبدئية. تميل تلك القيم المبدئية إلى القص الأدنى وإلى قص الحواف اليمنى والسفلية، ومع -pad إلى الحشو الأدنى والحشو على اليمين والأسفل. يُعد الإفراط في التحديد خطأً، أي تحديد الثلاثة -left و-right و-width معًا، أو -top و-bottom و-height معًا، أو right بالإضافة إلى -cropright.

هناك طريقة أقدم لتحديد المستطيل المراد الاحتفاظ به: الوسائط الموضعية. كانت الوسائط هي الطريقة الوحيدة المتاحة قبل يوليو 2000، ولكن لا ينبغي استخدامها في التطبيقات الجديدة. الخيارات أسهل في التذكر والقراءة، وأكثر تعبيرًا، وتسمح باستخدام القيم المبدئية.

إذا استُخدمت الخيارات والوسائط معًا، فسيُخلط التحديدان بطريقة غير محددة.

لاستخدام الوسائط، حدد جميع الوسائط الأربعة اليسار والأعلى والعرض والارتفاع. اليسار والأعلى لهما نفس تأثير تحديدهما كوسيطة للخيار -left أو -top على التوالي. العرض والارتفاع لهما نفس تأثير تحديدهما كوسيطة للخيار -width أو -height على التوالي، عندما يكونان موجبين. أما إذا لم يكونا موجبين، فلهما نفس تأثير تحديد قيمة أقل بواحد كوسيطة للخيار -right أو -bottom على التوالي. (مثال: width = 0 يجعل القص يمتد حتى الحافة اليمنى). قبل يوليو 2000، لم تكن الأرقام السالبة مسموحة لـ العرض والارتفاع.

يكون الدخل من الدخل القياسي إذا لم تحدد ملف الدخل pnmfile.

المخرجات إلى المخرج القياسي.

يعمل pamcut على تيار متعدد الصور. يقطع كل صورة في التيار بشكل مستقل وينتج مخرج تيار متعدد الصور. قبل إصدارة Netpbm 10.32 (مارس 2006)، كانت تتجاهل جميع الصور باستثناء الصورة الأولى في التيار.

إذا كنت تقسم صورة واحدة إلى عدة صور بنفس الحجم، فإن pamdice أسرع وأسهل من تشغيل pamcut عدة مرات.

pamcomp مفيد أيضًا لقص وحشو صورة إلى حجم معين. تُنشأ صورة خلفية بأبعاد الإطار المطلوبة وتُغطى الصورة الهدف عليها.

الخيارات

بالإضافة إلى الخيارات المشتركة بين جميع البرامج القائمة على libnetpbm (أبرزها -quiet، انظر
 الخيارات المشتركة index.html#commonoptions )، يتعرف pamcut على خيارات سطر الأوامر التالية:

-left=رقم_العمود
    رقم العمود الموجود في أقصى اليسار ليكون في المخرجات. الأعمدة الواقعة يسار هذا تُقص. إذا كان رقمًا غير سالب، فإنه يشير إلى أعمدة مرقمة من 0 على اليسار، وتزداد نحو اليمين. إذا كان سالبًا، فإنه يشير إلى أعمدة مرقمة -1 على اليمين، وتتناقص نحو اليسار.

-right=رقم_العمود
    رقم العمود الموجود في أقصى اليمين ليكون في المخرجات، مرقم بنفس طريقة -left. الأعمدة الواقعة يمين هذا تُقص.

-top=رقم_الصف
    رقم الصف الموجود في أعلى الصفوف ليكون في المخرجات. الصفوف الواقعة فوق هذا تُقص. إذا كان رقمًا غير سالب، فإنه يشير إلى صفوف مرقمة من 0 في الأعلى، وتزداد نحو الأسفل. إذا كان سالبًا، فإنه يشير إلى صفوف مرقمة -1 في الأسفل، وتتناقص نحو الأعلى.

-bottom=رقم_الصف
    رقم الصف الموجود في أسفل الصفوف ليكون في المخرجات، مرقم بنفس طريقة -top. الصفوف الواقعة أسفل هذا تُقص.

-width=الأعمدة
    عدد الأعمدة في المخرجات. يجب أن يكون موجبًا.

-height=الصفوف
    عدد الصفوف في المخرجات. يجب أن يكون موجبًا.

-cropleft

-cropright

-croptop

-cropbottom
    تحدد هذه الخيارات عدد الصفوف أو الأعمدة المراد قصها من الحواف اليسرى أو اليمنى أو العلوية أو السفلية، على التوالي.

    يجب ألا تكون القيمة سالبة.

    كانت هذه الخيارات جديدة في إصدارة Netpbm 10.85 (ديسمبر 2018). قبل ذلك، كان يمكن تحقيق نفس النتيجة باستخدام -left و top وقيم سالبة لـ -right و -bottom. تذكر طرح واحد في الحالة الأخيرة؛ على سبيل المثال، المكافئ لـ -cropright=1 هو -right=-2.

-pad
    إذا لم يكن المستطيل الذي حددته يقع بالكامل داخل صورة الدخل، فسيفشل pamcut ما لم تحدد أيضًا -pad. في هذه الحالة، يُحشى المخرج باللون الأسود حتى الحواف التي تحددها. يمكنك استخدام هذا الخيار إذا كنت بحاجة إلى صورة بأبعاد معينة ولديك صورة بأبعاد عشوائية.

    يضيف pnmpad أيضًا حدودًا إلى الصورة، ولكنك تحدد عرضها مباشرة.

    يؤدي pamcomp شكلاً أكثر عمومية من هذا الحشو. تُنشأ صورة خلفية بأبعاد الإطار وتُغطى الصورة الهدف عليها. يمكنك استخدام خيارات لجعل الصورة الهدف في مركز الإطار أو مقابل أي حافة، وجعل الحشو بأي لون (لون الحشو هو لون صورة الخلفية).

-reportonly
      يؤدي هذا إلى قيام pamcut بكتابة وصف لعملية القص التي كان سيجريها
      إلى المخرج القياسي بدلاً من إنتاج صورة مخرجة. انظر

    أدناه (#reportonly) لوصف هذا المخرج وطرق
      استخدامه.

    هذا الوصف هو سطر واحد من النص، يحتوي على 8 أرقام عشرية للبكسلات،
      تفصل بينها مسافات:

•   رقم عمود القص الأيسر

•   رقم عمود القص الأيمن

•   رقم صف القص العلوي

•   رقم صف القص السفلي

•   عرض صورة الدخل

•   ارتفاع صورة الدخل

•   عرض صورة الخرج

•   ارتفاع صورة الخرج

    رقم عمود القص الأيسر هو رقم العمود في صورة الدخل لأقصى عمود يسار في صورة الخرج. بالنسبة للقص الأيمن، فهو لأقصى عمود يمين في الخرج. القص العلوي والسفلي مماثلان لذلك.

    يمكن أن تكون أرقام الأعمدة والصفوف سالبة إذا حُدد -pad وكان pamcut سيضيف حشوًا. وبالمثل، يمكن أن تكون خارج الحافة اليمنى والسفلية لصورة الدخل.

    مثال:

          10 109 -1 98 150 80 100 100

    كان هذا الخيار جديدًا في إصدارة Netpbm 11.06 (مارس 2024).

-verbose
    يطبع معلومات عن المعالجة في المخرج القياسي للأخطاء.

انظر أيضًا
pnmcrop(1) , pamdice(1) , pamcomp(1) , pnmpad(1) , pamcat(1) , pgmslice(1) , pnm(1)

التاريخ

اشتُق pamcut من pnmcut في إصدارة Netpbm 9.20 (مايو 2001). وكان أول برنامج Netpbm وُائم مع تنسيق PAM الجديد ومكتبة البرمجة.

كان السلف pnmcut أحد أقدم الأدوات في حزمة Netpbm.

المؤلف

حقوق النشر (C) لعام 1989 محفوظة لـ Jef Poskanzer.

مصدر المستند
أُنشئت صفحة الدليل هذه بواسطة أداة Netpbm المسماة 'makeman' من مصدر HTML. التوثيق الرئيسي موجود في

    http://netpbm.sourceforge.net/doc/pamcut.html

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.