レンズ歪み

LensDistortionノード(NukeXそしてNuke Studioのみ)グリッド検出または手動ライン検出のいずれかにより、特定の画像のレンズ歪みを推定します。その後、ワープを使用して、歪みを追加または削除したり、STMapでSTMapを生成したりできます。 motion他の場所で使用するためのチャネル。

注意:  分析を実行する必要がありますNukeXまたはNuke Studio、しかし、あなたはで結果を使用することができますNuke

入力とコントロール

接続タイプ

接続名

関数

入力

ソース

ワープする画像シーケンス。

Control (UI)

Knob (Scripting)

Default Value

関数

LensDistortion Tab

Local GPU

gpuName

N/A

次の場合にレンダリングに使用されるGPUを表示しますUse GPU if available有効になっています。ローカルGPUディスプレイNot availableいつ:

Use CPUとして選択されますdefault blink deviceの中にPreferences

システムに適切なGPUが見つかりませんでした。

GPUに十分な空きメモリがない場合など、選択したGPUで処理するためのコンテキストを作成できませんでした。

可能な場合は、別のGPUを選択して、 Preferencesおよびから代替を選択するdefault blink device落ちる。

注意:  別のGPUを選択するには再起動が必要ですNuke変更が有効になる前。

Use GPU if available

useGPUIfAvailable

enabled

有効にすると、レンダリングがLocal GPU CPUではなく、使用可能な場合は指定されます。

注意:  ローカルGPUなしでこのオプションを有効にすると、GPUが利用可能なマシンでスクリプトが開かれるたびに、スクリプトがGPUで実行されます。
コマンドラインからレンダリングしたい場合もこれを選択する必要があります--gpuオプション。

見るWindowsMac OS XおよびmacOS 、またはLinux NukeがサポートするGPUの詳細については。

Model Preset

distortionModelPreset

NukeX Classic

使用する歪みモデルを設定し、追加または削除しますDistortion Parameter選択したプリセットに応じたコントロール:

NukeX Classic -の旧バージョンの歪みモデルを使用Nuke

CaraVR Radial, Degree 3 -CaraVRに適した歪みモデルを使用します。

3DEqualizer -3DEに適したいくつかの歪みモデルを提供します。

Custom -歪みモデルをゼロからカスタマイズできます。

Lens Type

lens

Spherical

シーケンスの撮影に使用されるレンズタイプを設定します。

Spherical

Anamorphic

Anamorphic Parameters - These controls are only displayed when the Lens Type control is set to Anamorphic.

Squeeze

anamorphicSqueeze

1

再スケーリングに使用されるアナモルフィックスクイーズを設定しますxの係数Distortion Parameters

Twist

anamorphicTwist

0

度単位で測定されたレンズのねじれを補正します。

Scale x,y

anamorphicScale

1,1

レンズの呼吸、焦点を変更するときの焦点距離のわずかな変化を補正します。

Distortion Parameters - these controls are dependent on the distortion Model Preset applied.

Denominator s

distortionDenominator0

0

歪みモデルの対称係数の分母係数を設定します。

これらのコントロールは、上の同じ名前のコントロールにリンクされていますAdvancedタブ。

distortionDenominator1

0

Centre

centre

0,0

歪みの中心の位置を設定します。

Output

Mode

output

Undistort

ノードからの出力のタイプを設定します。

STMap -歪みのないSTMapと再歪みのあるSTMapの両方をmotionチャンネル。使用forward歪みのないチャネルとbackward再歪曲用のチャンネル。他の入力チャンネルは出力に直接コピーされます。このモードでは、ソース画像の上にオーバーレイグリッドを表示できます。

Undistort -ビューアで入力を直接歪ませないため、歪んでいないオーバーレイグリッドを視覚化できます。

Redistort -ビューアで入力を直接歪ませ、再歪んだオーバーレイグリッドを視覚化できるようにします。

Use Fisheye

useFisheye

enabled

有効にすると、レンズ投影は魚眼レンズをゆがめるときに歪みの一部と見なされます。

無効にすると、 Nuke歪まない場合は歪みのない「理想的な」魚眼レンズをレンダリングし、再歪曲する場合は魚眼画像に歪みを適用します。

注意:  このコントロールは以下には影響しませんRectilinearレンズ。

Filter

filter

Cubic

いつModeに設定されていますUndistortまたはRedistort、ピクセルを元の位置から新しい位置にリマップするときに使用する画像リサンプリングフィルターを設定します。これにより、特にフレームの高コントラスト領域(ピクセルがフィルター処理されず、元の値を保持している場合、非常にエイリアスのあるエッジまたはぎざぎざのエッジが表示される)で、画質の問題を回避できます。

Impulse -再マップされたピクセルは元の値を保持します。

Cubic -再マップされたピクセルは、いくつかのスムージングを受け取ります。

Keys -再マップされたピクセルは、いくらかのスムージングに加えて、わずかなシャープニングを受け取ります(曲線の負の-y部分で示されるように)。

Simon -再マップされたピクセルは、ある程度のスムージングと中程度のシャープネスを受け取ります(曲線の負の-y部分で示されるように)。

Rifman -再マップされたピクセルは、ある程度の平滑化に加えて、大幅な鮮鋭化を受け取ります(曲線の負の-y部分で示されるように)。

Mitchell -再マップされたピクセルは、ある程度のスムージングに加えて、ピクセル化を隠すためのぼかしを受け取ります。

Parzen -再マップされたピクセルは、すべてのフィルターの最大の平滑化を受け取ります。

Notch -再マップされたピクセルは、フラットスムージングを受け取ります(モアレパターンを隠す傾向があります)。

Lanczos4Lanczos6、そしてSinc4 -再マップされたピクセルは、縮小に役立つシャープニングを受け取ります。Lanczos4最小限のシャープネスを提供し、 Sinc4最も。

BBox

bboxType

Auto

境界ボックスの計算方法を設定します。

Auto -境界ボックスは自動的に設定されるため、境界が画像よりもはるかに大きい場合、パフォーマンスが低下する可能性があります。

Input -境界ボックスは、入力画像と同じサイズに設定されます。

Manual -outputBBoxコントロールを使用して、境界を手動で設定できます。

outputBBox

dependent on Compositing environment Project Settings

When BBox is set to Manual, adjust the BBox by entering values in the x, y, r, and t controls.

You can also use the crop widget in the Viewer to adjust the BBox.

Output Format

 

outputFormatType

Input

出力形式を設定します。

Input -出力形式は入力形式と同じです。

Format -出力形式は形式のドロップダウンで制御されます。

BBox -出力形式は境界ボックスと同じです。

format

dependent on Compositing environment Project Settings

Sets the output format to use when Output Format is set to Format.

Distortion Scaling

 

distortionScalingType

Scale to Input Format

再スケーリングモードを設定します。

Scale to Input Format -入力形式を使用して、出力の歪みを調整します。

Format -選択した形式を使用して出力をスケーリングします。

outputFormat

dependent on Compositing environment Project Settings

Sets the format to use to reformat the image when Distortion Scaling is set to Format.

Analysis Tab

Grid Detect

Detect

detect

N/A

クリックして、選択した検出方法を、キャリブレーショングリッドショットのすべてのキーフレームで実行します。

グリッド検出は、機能検出と機能リンクで構成されます。以下を使用して、1ステップで実行できます。 Grids手動で修正できるように、2つのステップに分割されています。

をご覧くださいGrid Detection検出パラメーターの変更に関する詳細情報のコントロール。

N/A

detectionFrameType

Current Frame

によって処理されるフレームの数を設定しますDetectボタン:

Current Frame -現在のフレームのグリッドのみを検出します。

Every N Frames -現在のフレームとその後のNフレームごとにグリッドを検出します。Nは右側のコントロールで指定されます。
Nのデフォルト値は5フレーム。

Preview

preview

disabled

有効にすることができますPreviewをクリックすると、LensDistortionノードが見つけそうな機能を表示するコントロールDetectボタン。

でコントロールを調整できますSettings結果を改善するためのドロップダウンをクリックしてからDetect

Settings

Number of Features

numFeatures

5000

検出される機能の最大数を設定します。

増やすことができますNumber of Featuresグリッドが特徴点で完全に覆われていない場合。

Patch Size

patchSize

9

機能の再ローカリゼーションのパッチサイズを設定します。

増やしてみてくださいPatch Sizeフィーチャが一貫してサドルポイントに配置されていない場合。

Feature Separation

featureSeparation

15

相互に関連するフィーチャーの分布を設定します。

この値は、グリッドの正方形要素のスケールを反映する必要があります。

Detection Threshold

detectionThreshold

100

機能が自動的に拒否される検出しきい値を設定します。

値を増やして、グリッド上にないポイントなどの弱いフィーチャを拒否できます。

Feature Linking

Angle Threshold

angleThreshold

8

隣接フィーチャをリンクするときの角度許容値を設定します。

隣接するフィーチャ間に欠落しているリンクが多すぎる場合は、この値を増やしてみてください。

値が大きいとリンク処理にあいまいさが生じる可能性があるため、 Angle Thresholdグリッドの最適なカバレッジを取得します。

Distance Threshold

distanceThreshold

30

隣接リンクをマージするときに許容される距離許容値を設定します。

増やすことができますDistance Threshold検出後に欠落している特徴点を回復します。

Peak Threshold

peakThreshold

20

リンク方向を検出するときのピーク許容値を設定します。

減らすことができますPeak Thresholdグリッド画像に十分なコントラストが含まれていない場合、機能のリンクを改善します。

Editing and Drawing

lineDrawingModeSelectAll

N/A

クリックして、汎用選択ツールを有効にします。

lineDrawingModeSelectFeatures

N/A

クリックして機能選択ツールを有効にします。

lineDrawingModeSelectLines

N/A

クリックして、行選択ツールを有効にします。

lineDrawingModeAddFeatures

N/A

クリックして、機能追加ツールを有効にします。

lineDrawingModeRemoveFeatures

N/A

クリックして、機能の削除ツールを有効にします。

lineDrawingModeAddLines

N/A

クリックして、線描画ツールを有効にします。

Solve

Keys

N/A

1

現在のキーフレーム番号を表示します。

N/A

1

Displays the total number of keyframes.

N/A

N/A

クリックして前のキーフレームにジャンプします。

N/A

N/A

クリックして次のキーフレームにジャンプします。

N/A

N/A

クリックして、シーケンスの現在のフレームにキーフレームを追加します。

N/A

N/A

クリックして、シーケンスの現在のフレームのキーフレームを削除します。

N/A

N/A

クリックすると、シーケンス内のすべてのキーフレームが削除されます。

Solve

solveDistortion

N/A

クリックして、検出されたグリッドを使用して歪みモデルパラメーターを推定します。

ソルバーは、歪んだリンクを直線にワープしようとします。

注意:  歪みモデルを解くには、少なくとも歪みモデルのパラメータと同じ数の機能リンクが必要です。Detectメソッドで十分なリンクが見つからない場合は、キーフレームを追加するか、検出パラメーターを調整してください。

Reject

deleteOutliers

N/A

クリックして、残留エラーがエラー外にあるリンクを拒否しますThreshold

オーバーレイで赤く描かれた外れ値を削除して、クリックすることができますSolveワープを改善することで結果を改善します。

リンクを選択してを押して、手動でリンクを削除することもできますDeleteまたはBackspaceキーボードショートカット。ホールディングCtrl/Cmdリンクを削除すると、選択したリンクのみが保持されます。

Reset

resetDistortion

 

歪みパラメータをリセットし、状態を解決します。削除された機能とリンクは復元されません。

Solve Error

solveError

0

二乗平均平方根(RMS)解決エラーをピクセル単位で表示します。

これは、解析の品質を測定するために使用できます。各リンクの理想的な直線への平均偏差として計算されます。リンクの上にマウスを移動して、個々の残留エラーを表示します。

Threshold

errorThreshold

10

外れ値拒否のエラーしきい値を設定します。

値を小さくすると、近似が得られますが、過剰適合のリスクがあります。異常値が多すぎると、選択した歪みモデルに問題がある可能性があります。

Overlay

Show

overlayType

All

オーバーレイに表示するものを選択します。

None -オーバーレイを無効にします。

Features -検出された特徴点のみを表示します。このモードでは、機能のみが編集可能です。機能を削除しても、関連するリンクは削除されません。

Links -特徴点間のリンクのみを表示します。このモードではリンクのみが編集可能です。リンクを削除しても、接続する機能は削除されません。

All -特徴点とリンクの両方を表示します。このオプションを選択すると、両方のタイプを同時に編集できます。

Advanced Tab

Fisheye

Projection Model

projection

None (Rectilinear)

投影タイプを設定しますNone (Rectilnear)またはFisheyeFisheyeいくつかのサブタイプを提供します:

Stereographic

Equidistant

Equisolid

Orthographic

Focal Length

focal

9

カメラの焦点距離(mm)を設定します。

Sensor Size x,y

sensorSize

36,24

カメラセンサーのサイズ(mm)を設定します。

Beam Splitter

Enable

enableBeamSplitter

disabled

有効にすると、 DirectionそしてBendingビームスプリッターを使用して作成された画像を管理するためのコントロールが有効になります。

Direction

beamSplitterDirection

0

ビームスプリッターの円筒方向と曲げを制御します。

Bending

beamSplitterBending

0

Distortion

Type

distortionModelType

Radial Standard

ディストーションモデルタイプを設定しますが、 Preset必要に応じて選択を変更します。

Radial Standard

Radial Asymmetric

Radial-Tangential (結合または非結合)

Order

distortionOrder

0,2

放射状歪みの有理多項式関数の次数を設定します。

最初の項は分子の順序を制御し、2番目の項は分母の順序を制御します。

注意:  デフォルト値(0、2)はレガシーに対応しますNukeXモデル。

Exponent

distortionExponent

2,2

放射状歪み多項式の基本指数を設定します。

最初の項は分子の指数を制御し、2番目の項は分母の指数を制御します。

注意:  分母の2の基本指数は、古典に対応しますNukeXモデル。

Direction

distortionModelDirection

Forward

歪みモデルの方向を設定します。

Forward -直接推定されますが、画像レンダリングのために反転する必要があります。

NukeX Classicモデルはの例ですForwardモデル。

Backward -その逆を使用して推定されますが、画像レンダリングに直接使用できます。モデルの反転は正確なプロセスではなく、近似により情報が失われる可能性があります。

CaraVR Radialモデルはの例ですBackwardモデル。

Normalisation

normalisationType

Maximum

焦点距離と歪みパラメーターの正規化方法を設定します。

Width

Height

Diagonal

Maximum

Distort in Fisheye Space

distortInFisheyeSpace

enabled (if a fisheye Projection Model is selected)

ときProject Modelに設定されていますFisheye、このコントロールは、魚眼または直線空間の歪みを除去または適用するかどうか、つまりレンズを「デフィッシング」する前または後に決定します。

Equation x

distortionModelDisplayX

xu = xd / (1 + k0 * rd^2 + k1 * rd^4)

歪みモデル方程式の表示。

凡例:(xd、yd)は歪んだデカルト座標、(rd、phid)は歪んだ極座標、(xu、yu)は歪んでいないデカルト座標、(ru、phiu)は歪んでいない極座標、k-値は歪み係数です。座標系は、歪みの中心を基準にしています。

Equation y

distortionModelDisplayY

yu = yd / (1 + k0 * rd^2 + k1 * rd^4)

歪みモデル方程式の表示。

凡例:(xd、yd)は歪んだデカルト座標、(rd、phid)は歪んだ極座標、(xu、yu)は歪んでいないデカルト座標、(ru、phiu)は歪んでいない極座標、k-値は歪み係数です。座標系は、歪みの中心を基準にしています。

The denominator and numerator controls are dependent on the distortion Model Preset applied on the LenDistortion tab.

Denominator s

distortionDenominator0Link

0

歪みモデルの対称係数の分母係数を設定します。

これらのコントロールは、上の同じ名前のコントロールにリンクされていますLenDistortionタブ。

distortionDenominator1Link

0

Numerator s

distortionNumerator0

0

歪みモデルの対称係数の分子係数を設定します。

これらのコントロールは、上の同じ名前のコントロールにリンクされていますLensDistortionタブ。

distortionNumerator1

0

Centre

centreLink

0,0

歪みの中心の位置を設定します。

このコントロールは、上の同じ名前のコントロールにリンクされていますLenDistortionタブ。

Python Tab (These controls are for Python callbacks and can be used to have Python functions automatically called when various events happen in Nuke.)

before render

beforeRender

none

これらの関数は、でレンダリングを開始する前に実行されますexecute()。例外がスローされると、レンダリングは中止されます。

before each frame

beforeFrameRender

none

これらの関数は、個々のフレームのレンダリングを開始する前に実行されます。例外がスローされると、レンダリングは中止されます。

after each frame

afterFrameRender

none

これらの関数は、各フレームのレンダリングが終了した後に実行されます。レンダリングが中止された場合、それらは呼び出されません。例外がスローされると、レンダリングは中止されます。

after render

afterRender

none

これらの関数は、すべてのフレームのレンダリングが終了した後に実行されます。エラーがスローされると、レンダリングは中止されます。

render progress

renderProgress

none

これらの関数はレンダリング中に実行され、進行状況または失敗を判断します。

ステップバイステップガイド

レンズの歪みを扱う