ImageMagick 範例 --
影像轉換

  magick -size 50x50 xc:black -fill white -draw 'circle 25,25 20,10' \
          shade_circle_mask.gif
  magick shade_circle_mask.gif            -shade 120x45  shade_blur_0.gif
  magick shade_circle_mask.gif -blur 0x1  -shade 120x45  shade_blur_1.gif
  magick shade_circle_mask.gif -blur 0x2  -shade 120x45  shade_blur_2.gif
  magick shade_circle_mask.gif -blur 0x3  -shade 120x45  shade_blur_3.gif
  magick shade_circle_mask.gif -blur 0x4  -shade 120x45  shade_blur_4.gif
  magick shade_circle_mask.gif -blur 0x5  -shade 120x45  shade_blur_5.gif

magick shade_blur_3.gif -normalize shade_blur_3n.gif

magick shade_blur_3n.gif shade_circle_mask.gif \ -alpha Off -compose CopyOpacity -composite shade_blur_3n_mask.png

  magick -size 50x50 xc:black -fill white -draw 'circle 25,25 20,10' \
          -blur 0x2  -shade 120x30           shade_30.png
  magick shade_30.png   -gravity center -crop 1x1+0+0 txt:-

  magick -size 50x50 xc:black -fill white -draw 'circle 25,25 20,10' \
          -blur 0x2  -shade 120x30 -normalize   shade_30_norm.png
  magick shade_30_norm.png   -gravity center -crop 1x1+0+0 txt:-

  magick -size 50x50 xc:black -fill white -draw 'circle 25,25 20,10' \
          -blur 0x2  -shade 120x21.78 -normalize   shade_21_norm.png
  magick shade_21_norm.png   -gravity center -crop 1x1+0+0 txt:-

magick -size 50x50 xc:black -fill white -draw 'circle 25,25 20,10' \ \( +clone -blur 0x2 -shade 120x21.78 -normalize \) \ +swap -alpha Off -compose CopyOpacity -composite shade_tint_0.png magick shade_tint_0.png -fill grey50 -colorize 10% shade_tint_10.png magick shade_tint_0.png -fill grey50 -colorize 30% shade_tint_30.png magick shade_tint_0.png -fill grey50 -colorize 50% shade_tint_50.png magick shade_tint_0.png -fill grey50 -colorize 80% shade_tint_80.png

線性著色高光的​​替代方法是使用 S 形非線性對比 來降低其整體效果，同時保留高光的​​極端亮/暗點。這應該為高光效果提供更「自然」的外觀，並且可以使高光更亮，就好像表面更具反射性一樣。但是，為了使此技術更有效，我們需要確保陰影結果中沒有純白色和黑色。這可以通過首先使用「0%」的「-contrast-stretch」而不是「-normalize」來實現，並且像我們上面所做的那樣，將結果去標準化一點。這似乎只是增加了生成高光疊加圖像的複雜性，但強調高光中的亮點使額外的處理變得值得。例如...正如您所看到的，整體高光強度降低了，但反射光產生的亮點仍然保持亮度，只是尺寸減小了。結果是形狀具有更自然的「閃亮」外觀。這種技術的唯一缺點是也會產生陰影「斑點」，儘管這通常不太明顯。最後，我們可以將「高光點」與一般的 高光 降低相結合，以產生一組高度可配置的 高光 疊加生成器控件...

magick -size 50x50 xc:black -fill white -draw 'circle 25,25 20,10' \ \( +clone -blur 0x4 -shade 120x21.78 -contrast-stretch 0% \ +sigmoidal-contrast 7x50% -fill grey50 -colorize 10% \) \ +swap -alpha Off -compose CopyOpacity -composite shade_overlay.png

總之，上面的例子有四個獨立的控件...

「blur」：對形狀邊緣進行圓角處理 (0.001=斜面 2=平滑 10=圓角)

「shade」：光線來自的方向 (120=左上方 60=右上方)

"sigmoidal" : 表面反射控制亮點 (1=平坦 5=良好 10=反射)

"colorize" : 亮點的整體對比度 (0%=明亮 10%=良好 50%=昏暗)

請注意，雖然以上範例已塑造成原始的「圓形」，但透明度應該在套用「覆蓋」合成「之後」才恢復，而不是之前。此外，如果您打算在相同形狀上重複使用一個亮點（在執行任何旋轉之後），您可以為您打算使用的每個形狀預先生成亮點覆蓋，並儲存結果以供多次重複使用。在 IM 討論區 中，從平面來源影像產生 3D DVD 封面就是重複使用陰影覆蓋的例子。我也強烈建議您試驗上述技巧，因為它們是讓您的平面形狀影像看起來更逼真的關鍵。如果您想出其他亮點的構想，請告訴我。

FUTURE:
   Color Tinting the Overlay image
   Overlay Alpha Composition with an Image

使用黎明陰影高光

在上面的「遮罩陰影影像」中，我們展示了「正午」或「正午」陰影影像（使用「90」的「仰角」）對於遮罩以及「-shade」產生的效果的位置和範圍非常有用。但是，形狀的水平或「黎明」陰影影像（使用「0」的「仰角」）也非常有用。例如，它可以用作白色或黑色影像的遮罩，以在形狀上產生單獨的亮點和陰影效果。這也可以用於確保形狀獲得大致相等的亮區和暗區（甚至是不相等的數量），因為我以完全可控的方式分別產生它們。

FUTURE: more detail here

請參閱第一個 進階 3D 標誌 以獲取使用此技巧的範例。

---

使用 FX，DIY 影像運算子

影像清單運算子「-fx」是一個通用的 DIY 運算子，它不屬於任何特定類別的 IM 運算子，因為它可以用於建立幾乎任何影像操作。這些頁面中介紹了它的使用方法，但在此我們將專門探討它的功能以及如何使用它們。這個指令的功能非常強大，它可以

• 建立畫布、漸層、數學色彩映射。
• 在影像和通道之間移動顏色值。
• 以幾乎任何可以想像的方式調整影像顏色。
• 平移、翻轉、鏡像、旋轉、縮放、剪切和一般扭曲影像。
• 合併或合成多個影像。
• 以奇特的方式平鋪影像。
• 捲積或合併相鄰像素。
• 產生影像度量或「指紋」。
• 以不尋常的方式比較影像。

當然，其中許多技巧已經是 IM 的一部分，可以產生更快、更靈活的結果。但是，如果它不是內建的，「-fx」允許您產生自己的所需操作版本。事實上，我和其他人經常使用它來建立稍後會內建到 IM 核心程式庫中的新操作原型。例如，請參閱 DIY 新有序抖動替換，其中我使用「-fx」開發了「-ordered-dither」運算子的修訂版本。該運算子本質上允許您對一個或多個影像執行自由格式的數學運算。如需此指令的官方摘要，請參閱 ImageMagick 網站 上的 FX，特效影像運算子。

FX 基本用法

這個命令接受一個圖像序列作為輸入，您可以輸入任意數量的圖像，通常是一或兩張。它會將所有輸入圖像替換為第一張圖像的副本，並根據「-fx」函數的結果進行修改。也就是說，第一張圖像中的任何中繼資料都將保留在「-fx」運算式的結果中。為了便於數學運算，所有提供的顏色值都被標準化為 0.0 到 1.0 的範圍。結果預計也在此範圍內。這包括透明度或 Alpha 色板，範圍從 0.0（表示完全透明）到 1.0（表示完全不透明）。這些值代表「Alpha 透明度」，實際上是 IM 內部儲存透明度的相反值（作為消光值）。然而，這種形式在數學上更正確，也更容易使用。「-channel」設定定義了第一張（也稱為「第零張」或「u」）圖像中的哪些色板將被「-fx」運算式的結果替換。預設情況下，這僅限於原始圖像的顏色色板（「RGB」）。除非更改「-channel」設定以包含 Alpha（「A」）色板，否則該圖像中的任何現有透明度都不會被修改。運算式會針對每個像素執行一次，也會針對正在處理的像素中的每個顏色色板執行一次。此外，由於運算式每次執行時都會重新解析，因此複雜的運算式在處理大型圖像時可能會花費一些時間。例如，在這裡我們定義了一個黑色圖像，但將藍色色板設定為半亮，以形成「海軍藍」顏色。

magick -size 64x64 xc:black -channel blue -fx '1/2' fx_navy.gif

在這裡，我們採用一個黑白漸層，然後將藍色和綠色色板設定為零，使其變成黑紅漸層。

magick -size 64x64 gradient:black-white \ -channel blue,green -fx '0' fx_red.gif

為了使「-channel」設定更像「-fx」運算式，它將接受字母「RGBA」的任意組合來指定運算式要限制其作用的色板。 這意味著要將「-fx」的輸出限制為僅藍色和綠色色板，您現在可以使用「-channel BG」而不是更長的「-channel blue,green」。

雖然我們不使用 "-fx" 也能產生以上範例，但它能套用在現有影像上，使其成為強大的影像運算符。 實際上，此函數可以讀取和使用記憶體中目前影像序列中任何影像的任何像素或特定顏色。 第一張「零」影像被賦予特殊名稱 "u"。 第二張影像為 "v"。 記憶體中的其他影像可以使用索引來參考。 因此，"u[3]" 是目前影像序列中的第四張影像，而 "u[-1]" 是序列中的最後一張影像。 這是與影像列表運算符相同的索引方案，因此您應該不會感到陌生。 如果沒有給出其他限定詞，則使用的顏色值與指定影像中使用的顏色相同。 也就是說，除非您明確說明要使用紅色，否則它將使用該指令當時正在處理的顏色通道的顏色值。 也就是說，它會在處理藍色通道時套用藍色值的運算式。 除非另有說明，否則它會處理每個 RGB 顏色值（由預設的 "-channel" 設定設定），適用於影像中的每一個像素。 也就是 3*w*h 個計算，它會根據給定的運算式修改影像中的所有值。 例如，這裡我們採用 IM 內建的 "rose:" 影像，並將所有像素值乘以 50%。

magick rose: -fx 'u*1.5' fx_rose_brighten.gif

在上述範例中，每個紅色、綠色和藍色值分別乘以 1.5。 如果結果值超出 0 到 1 的範圍，它將被限制在適當的界限（在這種情況下為 1.0），除非您使用預設的HDRI 版本的 ImageMagick。 在數學顏色調整和直方圖曲線中探討了許多其他用於重新著色影像的 "-fx" 公式。 由於我們也可以參考目前影像序列中的任何影像，作為修改第一張影像的運算式的一部分，因此我們可以按照我們想要的任何方式合併兩個甚至更多影像。 在這裡，我們透過將藍色通道從黑色-藍色漸層（旋轉）複製到我們上面生成的黑色-紅色漸層中來生成黑色-紅色-藍色色表影像。

當然，我們可以直接使用通道複製合成方法，這樣會快很多。 但這不是重點。 反之亦然。 幾乎所有 IM 影像操作都可以用等效的 FX 函數來代替。

現在，上面第二張影像僅用作來源影像。 真正發生的是 "-fx" 首先建立第一張影像的副本。 然後，它根據公式修改該影像，並使用給定的所有其他影像。 最後，它會丟棄所有輸入影像，將它們替換為第一張影像的修改副本。 您也可以根據影像中每個像素的位置來計算值。 值 'i,j' 是正在處理的像素的當前位置，而 'w,h' 則表示影像的大小（第一張影像，除非給定了特定的影像限定詞）。 例如，這裡我們生成一個DIY 漸層影像。

magick rose: -channel G -fx 'sin(pi*i/w)' -separate fx_sine_gradient.gif

或者使用 'i,j' 位置值的更複雜的東西。 magick -size 80x80 xc: -channel G -fx 'sin((i-w/2)*(j-h/2)/w)/2+.5'\ -separate fx_2d_gradient.gif

在生成灰階漸層時，您可以讓 -fx 運算子速度提高約 3 倍，只需讓它只處理一個顏色通道，例如上述範例中的「G」或綠色通道。然後，可以分離此通道以產生最終的灰階影像。這可以大幅提升速度，尤其是在使用非常複雜的「-fx」公式時。如需更多 FX 生成的漸層，請參閱範例 自訂漸層。 您可以使用位置資訊，透過「p{x,y}」語法從來源影像中查找特定像素。例如，您可以輕鬆建立自己的「鏡像」類型函式（例如「-flop」影像運算子），它會將每個像素替換為原始來源「鏡像」位置的顏色值。

magick rose: -fx 'p{w-i-1,j}' fx_rose_mirror.gif

這種「影像扭曲」類型透過以影像形式建立 扭曲影像映射 或其他類型的值查找表而變得更加強大。在 DIY 抖動模式和臨界值映射 中提供了執行此操作的範例，其中 FX 用於將特定顏色替換為其他影像中的圖案。 現在，FX 表達式產生的最終影像大小與給定的第一個影像相同，因此若要產生更大的影像，您需要將第一個影像設定為所需的大小。在此類情況下，第二個影像（甚至第三個影像）可以用作顏色來源（因此在下一個範例中使用 交換）。例如，這裡我們調整了玫瑰影像的大小（使用 插值縮放或調整大小）以產生更大的影像。

magick rose: -size 120x80 xc: +swap \ -fx 'v.p{ (i+.5)*v.w/w-.5, (j+.5)*v.h/h-.5 }' \ fx_scaled.png

請注意像素查找是如何執行的，它看起來可能很複雜，但這是縮放（扭曲）影像的正確方法。基本上，添加到表達式的所有額外的「0.5」值都是為了在用於輸入座標「i,j」的 像素座標 和位置查找「v.p{...}」之間正確地進行轉換，而實際的數學計算（縮放）則需要更數學上正確的 影像座標。以上實際上是任何形式的 影像扭曲 所使用的確切方法。您可以透過開啟 詳細扭曲摘要 來查看大多數扭曲的 FX 等效項。這會報告大多數影像扭曲的 FX 等效項，作為一種雙重檢查扭曲是否按預期執行的途徑。使用 FX DIY 運算子 進行影像扭曲，顯示了此運算子的強大功能。如果不是因為這個運算子，我懷疑許多新的操作，例如扭曲、稀疏顏色或有序抖動，是否會被添加到 ImageMagick 核心庫中。這裡有一個更簡單的例子，交換了玫瑰影像的紅色和藍色通道。看看您是否能弄清楚它是如何工作的。

magick rose: \( +clone -channel R -fx B \) \ +swap -channel B -fx v.R fx_rb_swap.gif

一種更快、更好的方法是使用「-separate」和「-combine」）。請參閱 組合 RGB 通道影像。或者，您也可以使用「-color-matrix」更快地完成同樣的事情。 您看到這裡的趨勢了嗎？

做為預設的「-channel」設定，它將「-fx」運算子的輸出限制為僅限於三個色彩通道。這表示如果您想影響 Alpha 或透明度通道，則必須透過變更通道設定來明確指定它。例如，讓我們透過將所有 Alpha 通道值設定為一半來製作半透明的「rose:」影像。

magick rose: -alpha set -channel A -fx '0.5' fx_rose_trans.png

請注意，為了使上述操作正常運作，我需要確保「rose:」實際上有一個 Alpha 通道，以便「-fx」可以使用。我使用Alpha 通道控制運算子來做到這一點。「-fx」運算子能夠操控影像的 RGBA 通道，這使得它非常適合操控通道和遮罩。
從 IM 6.2.10 開始，您可以將變數賦值添加到「-fx」運算式中，這允許您降低某些運算式的複雜性，否則這些運算式基本上是不可能實現的。例如，我在這裡根據與特定點（賦值給變數「xx」和「yy」）的距離建立漸層。如果不使用變數，這個公式可能會變得非常難以閱讀。

magick -size 100x100 xc: -channel G \ -fx 'xx=i-w/2; yy=j-h/2; rr=hypot(xx,yy); (.5-rr/70)*1.2+.5' \ -separate fx_radial_gradient.png

由於「-fx」使用的簡單詞法分析處理，變數名稱只能包含字母，並且不能包含數字。此外，由於許多單個字母用於訪問影像資訊的內部變數，因此建議變數名稱至少包含兩個字母。因此，我使用「xx」和「yy」而不是僅使用「x」或「y」。

「-fx」函數「rr=hypot(xx,yy)」已添加到 IM v6.3.6 中，以加速非常常用的運算式「rr=sqrt(xx*xx+yy*yy)」。 當然，如果您需要距離的平方，則應避免使用「hypot()」函數及其隱含的 sqrt() 函數。

有關一些非常複雜的運算式的更多範例，請參閱更複雜的 DIY 漸層，如果沒有多個敘述賦值，這將是不可能實現的。透視變形的 FX 形式也是如此。從 IM 版本 6.3.0-1 開始，「-fx」運算式的複雜性開始需要外部檔案，因此現在可以使用標準的「@filename」從檔案中讀取運算式。

echo "u*2" | magick rose: -fx "@-" fx_file.png

這也意味著您可以使用更複雜的腳本來為特定作業生成特定的 FX 運算式。在內部，檔案只是被讀入字串並像往常一樣被解釋。對「-fx」很重要的其他設定是「-virtual-pixel」和「-interpolate」。虛擬像素設定允許您設定當查找座標超出輸入影像涵蓋的區域時應返回的顏色或影像結果。這允許您設定邊緣效果（例如模糊），以及在更大的區域上平鋪影像。插值設定允許您指定當查找座標（浮點值）落在輸入影像中像素的整數座標之間時，IM 應如何混合相鄰像素的顏色。有關更多資訊，請參閱插值像素查找。

在不同時間添加了一些其他函數 IM v6.3.6：hypot() IM v6.7.3-4：while()、not()、guass()、squish()

FX 除錯

「debug(expr)」本質上是一種在每次計算 FX 表達式時列印浮點數值的方法。這反過來提供了一種除錯表達式的方法。但是，您可以使用三元 if-else 表達式來限制「debug()」的輸出。例如，這將列印內建「rose:」圖像中像素 10,10 的浮點顏色值。通過使用「NULL:」圖像處理器，實際的圖像結果將被忽略。

magick rose: -fx 'i==10&&j==10?debug(u):1; u' null:

請記住，輸出是在標準錯誤輸出上，而不是標準輸出上，這樣您就可以在命令管道中使用它，而不會出現問題。請注意 FX 表達式是如何執行三次的，每個通道一次，僅針對那一個像素。將其乘以像素數，您可以想像如果「debug()」不限於一個像素，即使對於這個小圖像，輸出的長度也會有多長。

類似 FX 的內建操作

-fx 運算符代表一種開發 ImageMagick 中以前不存在的新圖像處理函數的方法。用戶進行此類開發的結果是允許 ImageMagick 擴展新的函數和方法，例如 顏色查找表（「-clut」）。然而，一般來說，一旦使用「-fx」穩定了一種新方法，該表達式就會轉換為更快的內建操作，通常作為一組類似運算符的一部分添加。這些包括以下通用圖像運算符及其方法...

-evaluate	直接像素、顏色值、通道修改函數。 （請參閱下面的 Evaluate）。
-function	更複雜的像素、顏色值、通道修改函數。 （請參閱下面的 Function）。
-evaluate-sequence	以數學方式合併多圖像序列。 （請參閱下面的 Evaluate-Sequence）。
-sparse-color	通用圖像重新著色運算符。 （請參閱 稀疏顏色漸變）。
-compose	通用多圖像組合和疊加方法。 （請參閱 Alpha 合成）。
-distort	使用反向像素映射的通用圖像扭曲運算符。 （請參閱 Distort 運算符）。
-morphology	通用區域效應卷積/形態學函數。 （請參閱 Morphology 運算符 和 Convolve 運算符）。

當人們開發新型圖像操作時，他們通常首先使用「-fx」運算符對其進行原型設計。當他們完成該「方法」後，就會將其轉換為 ImageMagick 核心庫中新的超快速內建運算符。歡迎用戶貢獻他們自己的「-fx」表達式（或其他定義的函數），他們認為這些表達式將成為 IM 的有用補充，但尚未被其他圖像運算符覆蓋，如果它們可以由上述其中一個通用運算符處理，則添加它們應該相當容易。例如，我自己需要一個「如果顏色相似則遮罩」類型的操作來比較兩個圖像。這已被添加為新的「-compose」方法「ChangeMask」。這反過來又允許我為 GIF 動畫添加更複雜的 透明度優化。如果「-fx」的速度和複雜性開始成為問題，那麼最好轉向 API 腳本語言，例如 PerlMagick。使用 PerlMagick 的示例「pixel_fx.pl」是該 API 發行版的一部分。

FX 表達式作為格式和註釋轉義

從 IM 版本 6.2.10 開始，您現在可以在「-format」和「-annotate」參數所使用的圖像屬性轉義字串中使用FX 表達式。轉義序列「%[fx:...]」會被替換為一個浮點值，並針對目前圖像序列中的每個圖像計算一次。然而，FX 表達式在處理過程中會稍微修改。具體來說...

• 目前的像素座標「i」、「j」固定為值 0，因此單獨一個圖像變數只會返回像素 0,0 的值，除非使用「p{}」索引。
• 除非選擇了顏色通道，否則只會返回紅色通道值。
• 預設圖像參考「s」設定為目前正在註釋或識別的圖像。
• 索引「t」返回「s」所參考圖像的索引。

在 IM v6.6.8-6 之前，「t」圖像索引和「n」圖像總數的 FX 表達式值都已損壞，並且對於所有圖像分別只返回 0 和 1 的值。等效的百分比轉義符「%p」和「%n」也是如此。

例如，這裡我使用每個圖像左上角的顏色「-annotate」每個圖像。

magick -size 150x25 xc:DarkRed xc:Green xc:Blue \ -fill white -gravity center \ -annotate 0 '%[fx:t] / %[fx:n] : %[fx:r],%[fx:g],%[fx:b]' \ annotate_fx_%d.gif

請注意，由於「r」實際上等於「s.p{0,0}.r」，因此寫入的文字對於每個圖像都不同。「g」和「b」顏色通道值也是如此。當然，每一個都返回一個介於 0.0 到 1.0 之間的標準化值。為了更容易輸出特定像素顏色值，在 IM v6.3.0 中還添加了「%[pixel:...]」轉義符。此運算符會針對每個圖像中的每個通道調用一次給定的 FX 表達式，並將返回的值格式化為 IM 可以處理為顏色參數的顏色。您可以使用「-format」和「identify」命令直接輸出結果。

magick identify -format '%[fx:atan(1)*4]' null:

這將以數學方式計算並返回 PI 的值，儘管此值可作為內建變數「pi」使用。您可以產生亂數。例如，要產生介於 -5 到 10 之間（含）的整數。這裡我使用「info:」來等效於「magick identify」命令。

magick xc: -format '%[fx:int(rand()*16)-5]' info:

如需更多方法，請參閱識別替代方案：文字輸出選項。另請參閱帶圓角的邊框，它使用FX 表達式根據圖像寬度和高度資訊產生繪製字串。您可以使用 FX 公式計算圖像位置，甚至可以使用其他圖像的大小和位置進行定位（請參閱增量計算位置）。您還可以在檔名百分比轉義符中使用FX 轉義符來根據計算值產生新檔案。如需範例，請參閱拼貼裁剪中的最後一個範例。
以上所有內容基本上都會針對目前圖像序列中的每個圖像運行「-format」，因此任何包含FX 表達式的內容都會運行一次。「-print」運算符的工作方式與「-identify」非常相似，只是它只會運行一次，並且可以訪問目前圖像序列中的所有圖像。與上述不同的是，使用此運算符，您可以使用「u[{i}]」來訪問任何圖像的值。
Fx 表達式可以應用於其他色彩空間中的圖像，因此我可以例如找出三種不同顏色的「色調」值（在「紅色」通道中）。

magick xc:red xc:green xc:blue -colorspace HSL \ -format '%[fx: s.r ]\n' info:

您也可以使用 IM 進行一些直接的色彩數學運算，例如找出「gold」、「yellow」和「khaki」的平均顏色。

magick xc: -format '%[pixel:(gold+yellow+khaki)/3]' info:

雖然這顯示了與三種來源顏色相比的顏色樣貌...

magick xc:gold xc:yellow xc:khaki +append \ \( xc: -fx '(gold+yellow+khaki)/3' \) \ -scale 90x30\! -append fx_hues.png

您也可以使用「-print」來列印資訊。這只會對整個影像序列套用一次。這表示您可以使用此運算子來計算涉及多個影像的更複雜的「%[fx:...]」運算式。

從其他影像存取資料

然而，使用 FX 跳脫運算式有一個嚴重的問題。當您在建立影像時，IM 無法直接存取目前影像序列中的其他影像。這在典型的影像建立過程中通常並非必要，因為新的影像通常不依賴於先前的記憶體內影像。基本上，如果您想收集與您正在繪製的影像不同的影像中特定像素的顏色（如上所述），或者正在建立新的影像，則 IM 核心函數沒有直接連結到所需的資訊。例如，如果您嘗試使用內建「rose:」影像像素 12,26（藍色像素）的顏色建立標籤，則直接方法將會失敗！

magick rose: label:'%[pixel:p{12,26}]' -delete 0 label_fx_direct.gif

嗯，玫瑰影像實際上不包含任何黑色像素，因此上述結果是錯誤的。解決此問題的方法是提取所需的資訊並將其儲存到全域 IM 中繼資料中。這會傳遞到程式庫核心中的所有子常式，包括用於影像建立的子常式。

magick rose: -set option:mylabel '%[pixel:u.p{12,26}]' -delete 0 \ label:'%[mylabel]' label_fx_indirect.gif

這並不直觀，但我們現在得到了正確的結果。特殊的「option:」標籤告訴「-set」選項，您希望將給定的設定儲存為全域 Artifact，而不是作為影像「屬性」或「屬性」字串，就像「-define」一樣。然而，「-set」形式允許您在設定 Artifact 時展開 百分比跳脫，而「-define」則不允許。當「label:」運算子展開其百分比跳脫時，會先將給定的「鍵」作為每個影像的「屬性」或「特性」來尋找，但如果找不到任何內容，則會在全域 Artifact 設定中尋找「鍵」。因此，即使在建立 Artifact 時該影像已不存在，也會使用我們從先前影像建立的全域「artifact」。基本上，「Artifact」設定在「magick」命令的生命週期內是全域的，因此可用於將資訊從一個影像傳遞到另一個影像。對於程式化的 API，可以避免這種情況，因為您可以直接從影像讀取所需的資料並自行產生標籤字串，而不需要 IM 以如此複雜的方式儲存該資訊。

---

評估和函數、自由形式通道修飾符

因為 FX 運算子 是一個解譯的運算式處理器，所以添加了「-evaluate」運算子，讓您可以更快地進行簡單的影像修改。後來在 IM v6.4.8-8 中添加了一個更複雜的「-function」運算子，以便在複雜的影像調整中提供更大的靈活性。這兩個運算子以及其他 影像級別調整運算子（例如「-negate」、「-level」）可能最適用於在套用灰階影像之前對其進行微調。特別是在用於 背景移除、高光和陰影疊加 以及 影像地圖 的產生和微調的灰階影像中。

Evaluate，簡單的數學運算

「-evaluate」運算子基本上是「-fx」運算子的快速但非常簡單的版本（實際上比它加入 IM 早了幾個月）。然而，它僅限於使用單一使用者提供的常數進行一個簡單的操作。您可以使用以下方法找出已內建到 evaluate 中的函數這包括針對常數值的典型數學函數「add」、「subtract」、「multiply」和「divide」。與 -fx 運算子不同，這些值不會標準化到 0 到 1 的範圍，而是保留圖像的實際顏色值。因此，在 Q8 IM 中減去 50 的值（請參閱品質和深度）將導致較大的減法，但對於 Q16 版本的 IM，這只是一個幾乎難以察覺的微小變化。但是，如果您在參數中添加「%」，則該參數將代表最大顏色值的百分比（稱為「QuantumRange」，等於（「2quality-1」）。這意味著您可以通過適當使用百分比來使您的「-evaluate」參數與 IM 品質等級無關。 例如，要將圖像中的所有顏色值替換為 50% 的灰色非常簡單快捷，使用「Set」

magick rose: -evaluate set 50% rose_set_gray.gif

「-evaluate」運算子還包括典型的數學函數「add」、「subtract」、「multiply」和「divide」。 例如，要將圖像的對比度減半，您可以將其「divide」（除以）「2」，然後「add」（加上）「25%」以將其重新置中於完美灰色。

magick rose: -evaluate divide 2 -evaluate add 25% rose_de-constrast.gif

這比直接使用「-fx」運算子和「u/2+.25」快幾個數量級。因此，如果可能的話，您應該優先使用此運算子而不是「-fx」。「-evaluate」的主要問題是所有結果都被裁剪到 0 到「QuantumRange」的限制（除非您使用的是HDRI 版本的 ImageMagick），因為每個修改後的值都會保存回圖像數據中。這意味著在任何單個「-evaluate」操作之後，這些值可能會被「QuantumRange」裁剪。 因此，如果您嘗試直接應用對比度增強函數（相當於「-fx '2*u-.25' 」），您將無法獲得正確的結果，因為加倍的值將在進行減法之前被裁剪。

magick rose: -evaluate multiply 2 -evaluate subtract 25% \ rose_contrast.gif

首先，「multiply」（乘法）會將所有較大的顏色值裁剪為最大值，然後「subtract」（減法）會裁剪較低的值。結果是上界被錯誤地裁剪，產生了黑暗和顏色失真的結果。 直接的解決方案是先「subtract」（減去）適當的常數（對下界進行最終但正確的裁剪），然後再進行乘法，有效地使用等效公式「(u-.125)*2」

magick rose: -evaluate subtract 12.5% -evaluate multiply 2 \ rose_contrast2.gif

然而，針對這個「裁切」問題，有很多替代方案。第一個合乎邏輯的是更新的 多項式函數方法（見下文）。其他替代方案還包括使用 色階調整運算子，甚至是 依顏色調整色階，只需指定要延伸的原始顏色值，即可填滿整個顏色範圍。基本上，在使用多個 "-evaluate" 方法時，請注意顏色值的裁切問題。
"-evaluate" 運算子和 "-fx"（以及大多數其他低階 IM 運算子）一樣，會受到 "-channel" 的影響。這讓您可以將圖像的 Alpha 透明度與色彩通道分開控制。是的，和 "-fx" 一樣，透明度被視為「Alpha 值」而不是「遮罩」值。例如，若要將圖像設定為 50% 透明度，作為 溶解 類型操作的一部分。

magick rose: -alpha set -channel A -evaluate divide 2 rose_transparent.png

結果會產生半透明圖像，這表示顯示時，您看到的一半顏色是網頁的背景顏色。因此，顯示的圖像會朝著背景顏色變暗。我還經常發現，在將各種通道分離成單獨的圖像以用於特定目的之前，在個別顏色通道上使用 "-evaluate" 通常更容易（請參閱 分離通道）。例如，我在這裡使用它來執行快速但不尋常的灰階化形式。基本上，我將每個通道乘以適當的數量，然後將這些通道分離並加總在一起，以產生使用特定顏色比率進行灰階化的圖像。

magick test.png -channel R -evaluate multiply .2 \ -channel G -evaluate multiply .5 \ -channel B -evaluate multiply .3 \ -channel RGB -separate -background black -compose plus -flatten gray_253.png

Evaluate 數學函數

在 Evaluate 中，還包含一組特殊用途的數學函數。實作這些函數通常是為了使用標準化顏色值（範圍從 0 到 1），而輸出也會再次標準化，以符合圖像的完整顏色範圍。Sigmoidal 對比 函數也是此類數學函數擬合的範例。

冪次方

例如，「Pow」函數（新增於 IM v6.4.1-9）使用標準化顏色值，並允許使用者修改圖像亮度。它完全等同於 pow() C 函數（在 0 到 1 的範圍內使用標準化顏色值）

    value = pow(value, constant) 

因此，若要建立「拋物線」漸層，您可以使用參數「2」。或者使用「0.5」值來建立「平方根」漸層。例如...

下方的三張圖像顯示了產生的漸層的輪廓，包括圖形和原始圖像本身。這讓我們更容易看出一個漸層圖像是如何被修改成另一個漸層圖像的。它是使用 IM 範例中 腳本 目錄下的腳本「im_profile」，透過 Gnuplot 圖形繪製程式產生的。

這實際上等同於 Gamma 調整 運算子，但參數是反向的。例如，「-gamma 2」運算相當於「-evaluate pow 0.5」或「平方根」運算函數。同樣地，「-gamma 0.5」等同於使用「-evaluate pow 2」進行平方運算。透過執行一些特殊的漸層操作，您可以使用此方法將線性漸層變更為複雜的圓弧。

magick -size 20x300 gradient: -rotate 90 \ -evaluate Pow 2 -negate -evaluate Pow 0.5 \ -flop \( +clone -flop \) +append eval_circle_arc.png

對於想要弄清楚這一點的人來說，上面第二行相當於FX 表達式 'sqrt(1-u^2)'。這會生成單個四分之一圓弧，然後將其翻轉，並附加在一起，以生成半圓弧。它也比使用FX 表達式快得多，即使它需要更多單獨（更小）的步驟。另請參閱更進階的多項式函數。

對數

「Log」函數（IM v6.4.2-1 中新增）也適用於標準化值（加上 1.0 以避免無限大），給定的常數用作對數基數。因此，實際公式（使用標準化值）為...

    value = log(value*constant+1.0)/log(constant+1.0) 

舉例來說...

magick gradient.png -evaluate Log 10 eval_log.png

這看起來可能與之前的Pow 評估方法非常相似，但並不完全相同。「Log」在接近「0」時會產生明顯的斜率，而「Pow」會產生垂直斜率。該值控制斜率。對數函數也與指數函數密切相關，指數函數目前僅作為S 形對比度調整運算符實現。這包含了您在上述對數曲線中可以看到的相同斜率特徵。這解釋了為什麼「-sigmoidal-contrast」是增強涉及低光照條件的圖像的比Gamma 調整或「冪次方」曲線更好的技術。

正弦和餘弦

從 IM v6.4.8-8 開始，添加了「sin」和「cos」方法。這些方法採用圖像中給定的值並將其標準化為角度，因此整個範圍將覆蓋一個完整的角度圓。結果給予 50% 的偏差並縮放以再次適合正常的數值範圍。常數用作值的乘數（以及角度），因此「N」表示函數將在整個值範圍內繞圓「N」次。具體來說，它將這些函數（使用標準化值）定義為...

   value = 0.5 * sin( constant*value*2*PI ) + 0.5
   value = 0.5 * cos( constant*value*2*PI ) + 0.5 

從本質上講，這些函數的作用是將圖像值（通常是灰度值）重新映射到正弦/餘弦曲線中。例如，這裡我採用漸變圖像並使用這些評估方法對其進行修改。現在，由於常數參數是角度乘數，因此賦予評估方法的值將在圖像內的整個漸變上創建那麼多個峰值。

magick gradient.png -evaluate cos 5 -negate eval_cos_5.png

這非常適合許多任務，從產生漣漪或分散效應到產生看起來像漣漪的位移曲線。通過使用「0.5」的乘數常數，您可以簡單地將線性漸變變成正弦曲線漸變，它仍然具有與原始漸變相同的斜率。通過否定結果，您可以確保漸變也正確傾斜。

magick gradient.png -evaluate cos 0.5 -negate eval_cos.5.png

這對於生成用於重疊照片的平滑漸變非常有用。然而，最後這兩種「-evaluate」方法很少使用，因為它們已被更通用的正弦函數（見下文）所取代，後者提供了更多控制選項，超出了簡單頻率選項。

---

Function，多參數 Evaluate

以上波形產生器被證明是非常有用的，特別是與 扭曲影像映射 一起使用時。但是我們發現需要對函數進行更精細的控制，需要多個參數。因此，在 IM v6.4.8-9 中添加了「-function」運算符。基本上，「-function」是「-evaluate」的多參數形式。但是，與 評估運算符 不同，這些運算符（如數學運算符）的所有上述函數僅作用於圖像的標準化通道值（0.0 到 1.0 範圍），這在多數情況下使它們更易於使用。

多項式函數

「polynomial」方法將接受任意數量的值，並根據給定的精確表達式修改圖像中的顏色值，其速度比 FX 運算符 快得多。每個值將用作從最高階到最低階的係數，以產生具有給定項數的多項式。例如，參數「4,-4,1」將生成等效於「-fx」表達式「 4*u^2 - 4*u + 1 」的多項式表達式。如果您了解高中數學，那麼您應該知道，這個多項式函數會在輸入（「u」）顏色範圍 0.0 到 1.0 上產生一條拋物線，從 1.0 到 0.0 然後回到 1.0。也就是說，它會使黑色和白色變成「白色」，並使完美的灰色變成「黑色」。

magick gradient.png -function Polynomial 4,-4,1 func_parabola.png

您甚至可以製作更複雜的漸變，例如四次多項式，它是使用一組「級別控制點」生成 曲線級別調整 的結果。這通常用於調整圖像的顏色以賦予其各種陰影效果。

magick gradient.png -function Polynomial '-25, 53, -36, 8.3, 0.2' \ func_quartic.png

當然，也可以進行簡單的線性修改，就像您使用 級別運算符 時一樣...

magick gradient.png -function Polynomial '4, -1.5' func_linear.png

但是請注意，您不能使用「Polynomial」來執行完整的 閾值 運算，因為這樣做需要無限的係數，儘管您可以非常接近。單個值自然只是一個常數，並且會導致直接賦值該值。換句話說，它就像「-evaluate Set 」方法一樣，在這種情況下為 33% 的灰度值。

magick gradient.png -function Polynomial 0.33 func_constant.png

通過將「Polynomial」與其他數學函數組合，您可以創建更複雜的漸變修改。例如，通過取多項式的平方根，我可以在線性漸變上創建一個真正的圓弧。等效的「-fx」表達式為「sqrt( -4*u^2 + 4*u + 0 )」...

magick gradient.png -function Polynomial -4,4,0 -evaluate Pow 0.5 \ func_circle_arc.png

另請參閱 Pow 評估方法 以獲取上述方法的替代方法。

正弦函數

「Sinusoid」函數方法是「-evaluate」方法「sin」和「cos」的更高級版本，實際上可以複製這些函數，但您可以更好地控制它如何修改圖像中的顏色值。並使用以下公式實現...

  value = ampl * sin(2*PI( freq*value + phase/360 ) ) + bias

這看起來可能很複雜，但它確保了該函數易於使用。只需要第一個值「頻率」（其工作原理與上述完全相同），所有其他參數都是可選的。默認情況下，它將生成一條正弦曲線。

magick gradient.png -function Sinusoid 1 func_sine.png

通過添加一個以度為單位的「相位」參數，您可以指定曲線的起始角度。允許您將默認的正弦曲線變成餘弦曲線。

magick gradient.png -function Sinusoid 1,90 func_cosine.png

通過調整「頻率」和「相位」，我可以直接將線性漸變變成平滑的正弦漸變，從黑色到白色（沿正弦曲線從最小值到最大值）。有關不太直接的方法，請參閱 評估餘弦方法。

magick gradient.png -function Sinusoid 0.5,-90 func_sine_grad.png

接下來的兩個可選值「amplitude」和「bias」控制著正弦曲線的尺度和中心線。例如，我在這裡建立一個在白色和灰色之間震盪的波浪（負餘弦曲線）（值介於 0.75 ±0.25 或 0.5 到 1.0 之間），開始和結束都是白色。

magick gradient.png -function Sinusoid 5,90,.25,.75 func_sine_bias.png

請小心使用這些最後的參數，因為它們很容易導致波形超出色彩值範圍的界限，從而被裁剪（除非您使用的是 HDRI 版本的 ImageMagick）。

反正弦函數

反反正弦函數「Arcsin」已添加到 IM v6.5.3-0 中。這是一條特殊的曲線，用於生成 圓柱位移貼圖。其參數為...並使用以下公式實現...

  value = range/PI * asin(2/width*( value - center ) ) + bias

預設值（如果未定義）「1, 0.5, 1, 0.5」確保函數居中，以便涵蓋從 0,0 到 1,1 的整個色彩範圍。

magick gradient.png -function Arcsin 1 func_arcsin.png

將結果曲線的「寬度」減半，您將得到...

magick gradient.png -function Arcsin 0.5 func_arcsin_width.png

「中心」將讓您根據輸入灰度值重新定位曲線。

magick gradient.png -function Arcsin 0.4,0.7 func_arcsin_center.png

「範圍」參數允許減少色彩值的輸出範圍，「偏移」將調整該範圍的中心。

magick gradient.png -function Arcsin 0.5,0.5,0.5,0.5 func_arcsin_range.png

請注意如何處理函數導致的無效值。這允許在位移中使用函數時更好地控制，並提供清理它們的方法。使用的實際值是「偏移 ±範圍/2」，如您所料。請注意，如果「寬度」或「範圍」為負數，則函數的斜率將因該負值而翻轉。

magick gradient.png -function Arcsin -1 func_arcsin_neg.png

反正切函數

「Arctan」方法已添加到 IM v6.5.3-1 中。其參數為...並使用以下公式實現...

  value = range/PI * atan(slope*PI*( value - center ) ) + bias

如您所見，它與「Arcsin」函數幾乎完全相同，只做了一點小改動以使其更有用。它甚至具有相同的預設值集（如果未定義）「1, 0.5, 1.0, 0.5」。這意味著如果您指定斜率值為「1.0」，則直方圖變化的斜率將在純灰色周圍產生 1:1 的變化（無縮放），同時使白色和黑色變為更灰的值。例如

magick gradient.png -function Arctan 1 func_arctan.png

也就是說，漸變的中間部分實際上保持不變，只有黑色和白色兩端變得不那麼對比。隨著曲線的「斜率」變大，中心的漸變將變得更強（在中間更壓縮）。

magick gradient.png -function Arctan 10 func_arctan_10.png

這在許多方面都與 Sigmoidal 對比度色彩修改運算符非常相似。但是，「Arctan」函數永遠不會真正達到純黑色和白色的輸出範圍限制。它會接近這些限制，但永遠不會越過它們。與前面的函數（和 Sigmoidal 對比度）類似，第二個參數將調整曲線相對於輸入漸變值的位置。

magick gradient.png -function Arctan 10,.7 func_arctan_center.png

最後兩個參數「範圍」將讓您調整將生成的值的輸出範圍。例如，通過稍微擴展此值，您可以確保它完全覆蓋所有可能值的範圍。

magick gradient.png -function Arctan 5,0.7,1.2 func_arctan_range.png

但是，如果您真的想以這種方式生成曲線來修改圖像的整體對比度，則更典型的方法是使用 Sigmoidal 對比度運算符，它是為此目的而設計的。「Arctan」漸變函數的更典型用途是創建一條曲線，該曲線將非常快地接近特定值，但不會超過該值。「範圍」和「偏移」參數控制著這些限制值。例如，此曲線將修改圖像中的漸變，以在輸入灰度級 0.7 周圍產生非常清晰的閾值，但值在 0.5 和 1.0 的範圍限制之間變化

magick gradient.png -function Arctan 15,0.7,0.5,0.75 func_arctan_typ.png

這是 Sigmoidal 對比度無法生成的。

---

漸變圖像的數學運算

現在，上述函數為漸變圖像提供了一些非常基本的變換。但是，如果您想對兩個或多個漸變圖像進行一些數學運算，那該怎麼辦呢？也就是說，使用另一個圖像的漸變來修改一個漸變。為此，您需要使用特殊的數學合成方法（例如“加法”和“除法”）。然而，在我們開始之前，我想給你一個警告。如果您的漸變圖像是純灰階圖像，沒有 alpha 通道，則可以直接使用數學合成方法。但是，如果您想將這些方法限制在特定的通道，或者將其應用於 alpha（透明度）通道，則需要確保設置了適當的“-channel”設置，並且沒有特殊的“Sync”通道標誌。有關詳細資訊，請參閱使用圖像合成進行圖像數學運算。通常，使用數學合成方法並不難。當您擁有的漸變也包含“偏差”時，就會出現複雜情況。也就是說，漸變應該在“50% 灰色”處表示“零”值，並且涵蓋從 -1（黑色）到 +1（白色）的範圍。此類圖像通常用於失真圖像映射。因此，對“偏差漸變”執行數學運算是真正的問題，我們將在此處更具體地研究這個問題。

衰減偏差漸變

例如，在這裡我想創建一個正弦波，但它開始時很小，然後振幅變大。這稱為“衰減”偏差漸變。或者換句話說，將偏差漸變乘以另一個絕對漸變。這也是 AM 無線電中的“調幅”的工作原理！所以首先我們需要一個正弦波，我們可以簡單地從線性漸變生成它……現在要衰減它，我們使用乘法 alpha 合成將正弦波與線性漸變相乘……但是，要在例如水波紋、位移貼圖中使用它，波浪必須保持以完美灰色為中心。為此，我們需要為原始圖像添加偏差。這恰好是我們用來乘以原始圖像的函數，取反並除以二……因此，我們得到了一個線性衰減的正弦波漸變，適用於位移貼圖。

當然，您可以使用一個命令完成整個過程，並且它也不必是簡單的線性衰減。例如，在這裡我使用負餘弦波而不是線性漸變來衰減高頻正弦波。

從 IM v6.5.4-3 開始，現在可以使用特殊的數學合成方法在一個合成方法中完成上述所有步驟。基本上通過認識到衰減運算是公式 Sc*Dc-.5*Sc+.5 或參數“1,-.5,0,.5”。

magick math_sine.png math_cosine_peak.png \ -compose Mathematics -set option:compose:args 1,-.5,0,.5 \ -composite math_attenuate.png

也可以通過首先使用多項式函數調整衰減漸變，然後使用排除合成運算符合併圖像來實現相同的結果。

magick math_sine.png \( math_cosine_peak.png -function polynomial -.5,.5 \) \ -compose Exclusion -composite math_poly_excl.png

乘以偏置漸層

但如果兩個函數都有偏差，因此完美的灰色表示零，而黑色和白色表示 -1 到 +1 的範圍呢？ 這有點複雜，因為您不能僅僅將它們相乘並期望它出來正確，因為乘法可能包含負值。 這需要一些注意，以確保您最終不會剪掉值並在生成的圖像中獲得正確的曲線反轉。 訣竅是將乘法分解為多個步驟。 也就是說   A × B   也可以寫成   A × abs(B) × sign(B)。 通過這樣做，您可以避免乘以負值，這在普通漸變圖像中無法存儲。 因此，我們需要做的就是採用其中一個偏差漸變並將其分成兩部分，以便可以將它們適當地應用於另一個漸變。 有偏差漸變的“sign()”，或獲取哪些部分為負的蒙版，可以使用 臨界值 在偏差級別的漸變上提取。 您可以稍後使用 合成差異 有選擇地否定另一個漸變，使用該臨界值圖像。 有偏差漸變的“abs()”可以使用 曝光 輕鬆提取，然後否定並加倍（使用 級別）以獲得從 0.0 到 1.0 的漸變絕對值。 由於我們還需要偏差偏移作為乘法的一部分（根據上面的 衰減），因此您可以直接使用否定和半比例的曝光輸出，然後再將其轉換為漸變絕對值。 讓我們將一個漸變變成這三個組成部分。現在我們有了其中一個漸變圖像的這三個部分，我們可以將它們與另一個漸變合併。 為此，我們乘以絕對值，重新添加偏差，然後否定應該變為負數的部分。這就是兩個偏差漸變圖像的完美乘積！ 這裡又是全部合而為一...最後要注意的是，與 衰減 不同，這種有偏差漸變的乘法是可交換的。 也就是說，交換輸入圖像不會影響最終結果。 由於上述等同於公式 2*Sc*Dc-Sc-Dc+1，從 IM v6.5.4-3 開始，您可以使用參數“數學”將上述複雜步驟實現為單個“數學”合成方法 "2,-1,-1,1"。

magick math_sine.png math_cosine_peak.png \ -compose Mathematics -set option:compose:args 2,-1,-1,1 \ -composite math_bias_multiply.png

也就是說，比沒有這種參數化合成方法所需的十幾個步驟更容易、更快的方法。 碰巧的是，當我看到那個公式時，我意識到這恰好是“排除”合成方法的否定。 奇怪但真實。 因此，以下內容也將生成相同的零偏差倍數。

magick math_sine.png math_cosine_peak.png \ -compose exclusion -composite -negate math_excl_neg.png

新增偏置漸層

隨著“數學”合成方法的出現，添加偏差漸變也相對容易。 等效的 FX 公式是“u+v-0.5”或合成參數“0,1,1,-.5”。 例如，以下是我手動生成的 傅立葉變換示例，需要添加 3 個偏置正弦曲線和一個恆定直流值。請注意，在上面我如何使用帶有“-background”設置的“-flatten”運算符來實現多圖像合成。 或者在這種情況下是所有給定圖像加上背景常數的“偏差和”。

頻率調變

通過將函數直接應用於另一個函數的輸出，您不會產生簡單的結果。 原因是所有這些數學函數都應用於單個像素的漸變“值”，而不是針對漸變中像素的 x 值。 例如....

magick gradient.png -evaluate sin 0.5 -normalize \ -evaluate cos 8 math_cos_var.png

這會產生一個非常複雜的函數，它實際上等同於：換句話說，這是一個變頻，其中頻率隨著第一個正弦曲線的梯度而變化。基本上，原始圖像中梯度變化越快，峰值之間的距離就越小。然而，峰值的高度（振幅）不會改變。這實際上就是「頻率調變」的工作原理，一個看似簡單的函數產生了非常複雜的結果。

---

Miscellaneous Image Transformation Techniques.

These have not been exampled yet, but are some basic IM developed transforms
that may provide useful.  If you have an interesting effect please contribute.

   pixelize an image
      resize an image down 10 then scale the image 10 to produce blocks
      of roughly averaged color.
      For example...
         magick input.jpg -resize 10% -sample 1000% output.jpg

  De-skew slightly rotated images

    -deskew {threshold}
       straighten an image. A threshold of 40% works for most images.

    Use -set option:deskew:auto-crop {width} to auto crop the image. The set
    argument is the pixel width of the image background (e.g 40).

    Programmically we auto crop by running a median filter across the image
    to eliminate salt-n-pepper noise.  Next we get the image bounds of the
    median filter image with a fuzz factor (e.g. -fuzz 5%).  Finally we
    crop the original image by the bounds.  The code looks like this:

      median_image=MedianFilterImage(image,0.0,exception);
      geometry=GetImageBoundingBox(median_image,exception);
      median_image-DestoryImage(median_image);

      print("  Auto-crop geometry: %lux%lu%+ld%+ld",
                geometry.width,geometry.height, geometry.x,geometry.y);
      crop_image=CropImage(rotate_image,&geometry,exception);

    See Trimming 'Noisy' Images

  Segmentation
    look at scripts
       divide_vert
       segment_image
    for some simple scripts I wrote to segment well defined images into
    smaller parts.   I hope to get simple segmentation functions like this
    into the core library, to allow for things like automatic sub-division of
    GIF animations, and seperating images and diagrams from scanned documents.

---